python/v1.52.0

[github-actions[bot]]

python/v1.52.0

Auto-drafted from commits in python/v1.51.0..python/v1.52.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(model-routing): add ModelRouter and accept it via Agent(model=) (feat(model-routing): add ModelRouter and accept it via Agent(model=) #3474) (26770e1)
• feat(catalog): add strands-github-storage integration (feat(catalog): add strands-github-storage integration #3750) (7f19592)
• feat(storage-py): add top level storage (feat(storage-py): add top level storage #3743) (0b296c3)
• feat(middleware): add AgentStreamStage with middleware-initiated interrupts (feat(middleware): add AgentStreamStage with middleware-initiated interrupts #3594) (792afbd)
• feat(ts): support appending to notebooks (feat(ts): support appending to notebooks #3459) (1a06dff)

🐛 Fixes

• fix(streaming): log warning when tool input JSON is malformed (fix(streaming): log warning when tool input JSON is malformed #2054) (2e11e73)
• fix(bedrock/py): retry incompatible tool-result turns (fix(bedrock/py): retry incompatible tool-result turns #3622) (1114e8b)
• fix(ts): abort in-flight Bedrock requests on cancellation (fix(ts): abort in-flight Bedrock requests on cancellation #3337) (2c6c531)
• fix(site): keep root lockfile bumps out of the other language's changelog (fix(site): keep root lockfile bumps out of the other language's changelog #3717) (d73ed03)
• fix(test): Move count_tokens fixture to gemini-3.1-flash-lite (fix(test): move count_tokens fixture to gemini-3.1-flash-lite #3763) (93b6774)
• fix(models/gemini): emit thought signature as its own reasoning delta (fix(models/gemini): emit thought signature as its own reasoning delta #3306) (9a020b7)
• fix(openai): send tool-result documents as file_data, not file_url (fix(openai): send tool-result documents as file_data, not file_url #3674) (20ecff5)
• fix(context-offloader): report retrieval failures as tool errors (fix(context-offloader): report retrieval failures as tool errors #3680) (d723329)
• fix(conversation): trim at complete tool pairs (fix(conversation): trim at complete tool pairs #3447) (13990f0)
• fix(test): move count_tokens fixture off retired gemini-2.0-flash (fix(test): move count_tokens fixture off retired gemini-2.0-flash #3755) (86b98f6)
• fix(vended-tools): keep the pre-rename name on the deprecated bash aliases (fix(vended-tools): keep the pre-rename name on the deprecated bash aliases #3751) (679665f)
• fix(bidi): update bidi google-genai version floor (fix(bidi): update bidi google-genai version floor #3740) (5f357ae)
• fix(bedrock): honor a cache point placed in the last user message (fix(bedrock): honor a cache point placed in the last user message #3677) (d69941a)
• fix(openai): send document content as file_data on the Responses API (fix(openai): send document content as file_data on the Responses API #3576) (ff73bd9)
• fix(deps): bump @aws-sdk/core to 3.977.6 to fix NumericValue metadata regression (fix(deps): bump @aws-sdk/core to 3.977.6 to fix NumericValue metadata regression #3709) (f621b82)

♻️ Refactoring

• refactor(site): consolidate src/utils into src/util (refactor(site): consolidate src/utils into src/util #3777) (6ff1d97)
• refactor(vended-tools): treat bash as its own deprecated tool (refactor(vended-tools): treat bash as its own deprecated tool #3756) (e4d57c1)

📚 Documentation

• docs(community): add Neo4j Agent Memory session manager (docs(community): add Neo4j Agent Memory session manager #3757) (ea1027a)
• docs(community): add Zep memory integration (docs(community): add Zep memory integration #3742) (bf275c7)
• docs: add prescriptive guidance for keeping cognitive complexity low (docs: add prescriptive guidance for keeping cognitive complexity low #3741) (cc7597c)
• docs: add business KPI best practice to metrics page (docs: add business KPI best practice to metrics page #3720) (ae44fe9)
• docs(changelog): sync strands-agents/evals backfill (docs(changelog): sync strands-agents/evals backfill #3715) (11ad636)
• docs(changelog): sync strands-agents/harness-sdk typescript/v1.12.0 (docs(changelog): sync strands-agents/harness-sdk typescript/v1.12.0 #3716) (c4c35e1)
• docs(changelog): sync strands-agents/harness-sdk python/v1.51.0 (docs(changelog): sync strands-agents/harness-sdk python/v1.51.0 #3712) (f175b57)
• docs: add estimateUtilization documentation (docs: add estimateUtilization documentation #3679) (a181423)

✅ Tests

• test(models): retry inconclusive Mantle routing probes (test(models): retry inconclusive Mantle routing probes #3747) (9eaaff4)

👷 CI

• ci(docs): bump markdown-it from 14.3.0 to 15.0.0 in /site (ci(docs): bump markdown-it from 14.3.0 to 15.0.0 in /site #3605) (243f779)
• ci(docs): bump js-yaml from 4.3.0 to 4.3.1 in /site in the npm_and_yarn group across 1 directory (ci(docs): bump js-yaml from 4.3.0 to 4.3.1 in /site in the npm_and_yarn group across 1 directory #3782) (d4129c3)
• ci(docs): bump the npm_and_yarn group across 1 directory with 2 updates (ci(docs): bump the npm_and_yarn group across 1 directory with 2 updates #3670) (b487b9a)
• ci(docs-preview): link catalog and standalone page changes in the preview comment (ci(docs-preview): link catalog and standalone page changes in the preview comment #3774) (c2df950)
• ci(release): post release notes to the announcements discussion board (ci(release): post release notes to the announcements discussion board #3707) (cf4a68a)
• ci(docs): bump astro from 7.1.6 to 7.2.0 in /site (ci(docs): bump astro from 7.1.6 to 7.2.0 in /site #3732) (d77c163)
• ci(docs): bump @astrojs/starlight from 0.41.6 to 0.41.7 in /site (ci(docs): bump @astrojs/starlight from 0.41.6 to 0.41.7 in /site #3731) (80817ee)
• ci(docs): bump vite from 8.2.0 to 8.2.1 in /site (ci(docs): bump vite from 8.2.0 to 8.2.1 in /site #3733) (96c7350)
• ci: bump dorny/paths-filter from 4.0.2 to 4.0.3 (ci: bump dorny/paths-filter from 4.0.2 to 4.0.3 #3729) (f2a8cb4)
• ci: bump actions/download-artifact from 6.0.0 to 8.0.1 (ci: bump actions/download-artifact from 6.0.0 to 8.0.1 #3703) (d43a213)
• ci(typescript): bump fast-uri from 3.1.4 to 3.1.5 (ci(typescript): bump fast-uri from 3.1.4 to 3.1.5 #3618) (397176b)
• ci: bump actions/setup-python from 6.3.0 to 7.0.0 (ci: bump actions/setup-python from 6.3.0 to 7.0.0 #3701) (fa45554)
• ci(typescript): bump @hono/node-server from 1.19.14 to 2.1.0 (ci(typescript): bump @hono/node-server from 1.19.14 to 2.1.0 #3669) (14d2759)
• ci: bump actions/upload-artifact from 6.0.0 to 7.0.1 (ci: bump actions/upload-artifact from 6.0.0 to 7.0.1 #3702) (8d10f4b)

🔧 Chores

• chore(site): refresh catalog stats (chore(site): refresh catalog stats #3728) (e69f8f2)
• chore: skipped mcp otel instrumentation for mcp v2 (chore: skipped mcp otel instrumentation for mcp v2 #3611) (dbc97c7)

🔖 Other

• Docs: Update the "Best Practice" to Align with the Agentic AI Lens Recommendations (docs: update the "Best Practice" to Align with the Agentic AI Lens Recommendations #3483) (8d212f2)

---

This discussion was created from the release python/v1.52.0.