python/v1.52.0

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=) (#3474) (26770e1)
• feat(catalog): add strands-github-storage integration (#3750) (7f19592)
• feat(storage-py): add top level storage (#3743) (0b296c3)
• feat(middleware): add AgentStreamStage with middleware-initiated interrupts (#3594) (792afbd)
• feat(ts): support appending to notebooks (#3459) (1a06dff)

🐛 Fixes

• fix(streaming): log warning when tool input JSON is malformed (#2054) (2e11e73)
• fix(bedrock/py): retry incompatible tool-result turns (#3622) (1114e8b)
• fix(ts): abort in-flight Bedrock requests on cancellation (#3337) (2c6c531)
• 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 (#3763) (93b6774)
• 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 (#3674) (20ecff5)
• fix(context-offloader): report retrieval failures as tool errors (#3680) (d723329)
• fix(conversation): trim at complete tool pairs (#3447) (13990f0)
• 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 (#3751) (679665f)
• fix(bidi): update bidi google-genai version floor (#3740) (5f357ae)
• 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 (#3576) (ff73bd9)
• 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 (#3777) (6ff1d97)
• refactor(vended-tools): treat bash as its own deprecated tool (#3756) (e4d57c1)

📚 Documentation

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

✅ Tests

• 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 (#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 (#3782) (d4129c3)
• 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 (#3774) (c2df950)
• 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 (#3732) (d77c163)
• 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 (#3733) (96c7350)
• 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 (#3703) (d43a213)
• 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 (#3701) (fa45554)
• 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 (#3702) (8d10f4b)

🔧 Chores

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

🔖 Other

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