Strands Agents Files

typescript/v1.12.0

Auto-drafted from commits in typescript/v1.11.2..typescript/v1.12.0, grouped by conventional-commit type. Edit on the release page after publish if you want a polished writeup; the canonical release notes live on the website.

🚀 Features

• feat(middleware): add AgentStreamStage and AgentStreamContext types (#3635) (38980ed4f)
• feat(storage-ts): accept storage as optional top-level Agent parameter (#3660) (dcf09bb93)
• feat(model): add estimateUtilization method to Model base class (#3641) (c84b618a3)
• feat(docs): add hitl classifier documentation (#3630) (86980c497)
• feat: add snapshot session manager to python (#3283) (a059fb91b)
• feat(ts): detect repetitive swarm handoffs (#3461) (a92cb5e01)
• feat(site): community integration catalog with search, filtering, and curated backfill (#3416) (2f907793a)
• feat(hitl-py): add classifier option for LLM-driven risk classification (#3575) (69ed9f320)
• feat: support Tool Choice for Gemini in Python (#3551) (0ab31d7c1)
• feat: add context window limits for Claude 5 and GPT-5.6 families (#3629) (c93666c64)
• feat(context-offloader): add should_offload callback for selective offloading (#3267) (6a925de6c)
• feat(ts): add MCP tool filtering and name prefixes (#3415) (bf94c6701)
• feat(multiagent): add str support for MultiAgentResult and NodeResult (#1998) (8b1f53724)
• feat(interventions-ts): add llm as judge tool risk classifier to hitl (#3566) (55c68b7a5)
• feat(bidi): add telemetry and metrics (#3282) (c0776c008)
• feat(python): add BeforeToolsEvent and AfterToolsEvent batch hooks (#3508) (fd1b985b1)
• feat(a2a): support the interrupt round trip over A2A (#3486) (aae087d6d)

🐛 Fixes

• fix(deps): bump @aws-sdk/core to 3.977.6 to fix NumericValue metadata regression (#3709) (f621b82c9)
• fix(ci): label fork PRs by verifying the artifact's claim against the PR head (#3705) (d8d366cd8)
• fix(mantel):mantle base path routing (#3691) (7766a2397)
• fix(catalog): point strands-stigmer docsUrl at stigmer.network (#3668) (c9f19f641)
• fix(site): reject redundant languages in astro frontmatter (#3678) (1fe9bb3f1)
• fix(swarm): correct crash-restart resume for handoff and completed swarms (#3391) (7741ecd28)
• fix(bedrock-kb): resolve a default region for the store's clients so it works in cloud envs (#3583) (56cc3d3bd)
• fix(mcp): index document content on hydration with thread safety (#3502) (6c1e56c6c)
• fix(telemetry): record gen_ai.tool.call.arguments/result on execute_tool spans (#3550) (cd98383d9)
• fix: preserve interrupt state across cancelled resumes and middleware re-reads (#3615) (587efb391)
• fix(python): count usage from hook-retried model calls (#3627) (762253c76)
• fix(bedrock): skip guardContent wrap for unsupported image formats (#3607) (527ad68a4)
• fix(session): validate snapshot scope (#3593) (b070786e7)
• fix(ci): exclude bootstrap tools from MCP audit (#3565) (a8ead9484)
• fix(mcp): pin mcp dependency below v2.0.0 (#3524) (8e6b33f4b)
• fix(context-offloader): refresh eviction cycle on retrieve for unified Storage backends (#3487) (b3643bedf)

⚡ Performance

• perf(mcp): hydrate search snippets concurrently (#3435) (fe4cbb948)

♻️ Refactoring

• refactor(vended-tools): mark make_bash with typing_extensions.deprecated (#3595) (3cddf74ff)
• refactor(vended-tools)!: rename sandbox-routed bash tool to shell (#3574) (d50de52db)

📚 Documentation

• docs: add estimateUtilization documentation (#3679) (a181423a1)
• docs(labs): remove archived robots-sim, add four active Labs projects (#3694) (f766cd681)
• docs: extend the comment rule to require to-the-point, non-inferable content (#3676) (734a259af)
• docs(community): add Stigmer AWS method contracts tool (#3636) (a70bbc016)
• docs: remove redundant language support banners (#3637) (ad3e6feb4)
• docs: add Welt community integration page (#3281) (23541039f)
• docs(shell): clarify security boundary (#3616) (a76f3842f)
• docs: TypeScript examples for hook retry and appState typed state (#3201) (a26560176)
• docs(openai): document TypeScript custom clients (#3570) (526692f53)
• docs(streaming): document throttle delay event (#3443) (43d7a6b06)
• docs: mark agentic context management mode as experimental (#3553) (4433e9a39)
• docs: add Crusoe as a community model provider (#3225) (af3540137)
• docs(labs): update Strands Robots page to current Robot() API (#3529) (3345895b7)
• docs(site): document trusted message history across agent input paths (#3467) (59bf1ed66)
• docs(changelog): sync strands-agents/harness-sdk typescript/v1.11.2 (#3510) (b84840ba5)
• docs(changelog): sync strands-agents/harness-sdk python/v1.50.2 (#3509) (e08c9d7d1)

✅ Tests

• test(mcp): wait for the retained task, not the log line (#3537) (d7b36d001)
• test(mcp): guard against uncapped dependency resolution (#3592) (7b4d8308e)

👷 CI

• ci: bump actions/download-artifact from 6.0.0 to 8.0.1 (#3703) (d43a213bd)
• ci(typescript): bump fast-uri from 3.1.4 to 3.1.5 (#3618) (397176b71)
• ci: bump actions/setup-python from 6.3.0 to 7.0.0 (#3701) (fa45554df)
• ci(typescript): bump @hono/node-server from 1.19.14 to 2.1.0 (#3669) (14d275994)
• ci: bump actions/upload-artifact from 6.0.0 to 7.0.1 (#3702) (8d10f4b8b)
• ci: label PRs by cognitive complexity, stop counting tests toward size (#3634) (77c0eb559)
• ci(typescript): bump @hono/node-server and @modelcontextprotocol/sdk (#3596) (a10881c71)
• ci(docs): bump the npm_and_yarn group across 1 directory with 3 updates (#3597) (231d3577b)
• ci(typescript): bump @aws-sdk/client-bedrock-runtime from 3.1095.0 to 3.1097.0 in the production-minor group across 1 directory (#3625) (c591e4f0b)
• ci(typescript): bump ip-address from 10.2.0 to 10.4.0 (#3619) (b0089355b)
• ci(deps): bump the npm_and_yarn group across 1 directory with 1 update (#3620) (b2383b910)
• ci(typescript): bump hono from 4.12.32 to 4.13.0 (#3643) (70e91166f)
• ci(python): update litellm requirement from <=1.93.0,>=1.75.9 to >=1.75.9,<=1.95.0 in /strands-py (#3649) (06bef2d70)
• ci(docs): bump @astrojs/starlight from 0.41.5 to 0.41.6 in /site (#3626) (4f869c4f6)
• ci(docs): bump acorn from 8.17.0 to 8.18.0 in /site (#3514) (cb5b86141)
• ci(typescript): bump @aws-sdk/client-bedrock-runtime from 3.1078.0 to 3.1095.0 in the production-minor group across 1 directory (#3174) (cd8178efc)
• ci(docs): bump vite from 8.1.5 to 8.2.0 in /site (#3604) (198fd15b4)
• ci(python): update litellm requirement from <=1.91.1,>=1.75.9 to >=1.75.9,<=1.93.0 in /strands-py (#3587) (bee5e9d9c)
• ci(docs): bump @modelcontextprotocol/sdk from 1.29.0 to 1.30.0 in /site (#3515) (ded38d9ed)
• ci(typescript): bump fast-uri from 3.1.2 to 3.1.4 (#3405) (3aaf74b6c)
• ci(typescript): bump postcss from 8.5.15 to 8.5.25 (#3543) (cfc882572)
• ci(docs): bump astro from 7.1.3 to 7.1.6 in /site (#3555) (cf9b002f2)
• ci(deps-dev): bump the npm_and_yarn group across 4 directories with 1 update (#3470) (a8c4ed3bd)
• ci(docs): bump svgo from 4.0.1 to 4.0.2 in /site in the npm_and_yarn group across 1 directory (#3404) (f4a8f9f50)
• ci(docs): bump node-html-parser from 9.0.0 to 9.0.1 in /site (#3556) (8818cc64b)
• ci(python): bump cedarpy from 4.8.6 to 4.8.7 in /strands-py (#3214) (f383c11ab)
• ci(docs): bump @astrojs/starlight from 0.41.4 to 0.41.5 in /site (#3540) (2b84dfa59)

🔧 Chores

• chore: remove reference to agent builder after archival (#3581) (1937b4ae0)
• chore: update design doc template to uncover key information early (#3532) (f2482f419)

🔖 Other

• Docs: Update the "Best Practice" to Align with the Agentic AI Lens Recommendations (#3483) (8d212f29a)
• Docs: clarify local metrics and telemetry export (#3418) (62ea2750d)