v3.1.7

# Changelog

## Improvements:

- **OS Manager Tool Limits**: `OSManager` takes `tool_call_limit` (default `8`, per coordinator run, including delegations) and `member_tool_call_limit` (default `24`, per specialist invocation). Explanations stay scoped to the question and grounded in the Agno docs. Set either limit to `None` to restore unlimited tool use, as before. See [cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/05_agent_os/29_manager/README.md).
- **Cartesia Default Model**: `CartesiaTools` now defaults to `sonic-3.6`. Cartesia sunsets the `sonic-2` snapshots, the previous default, on October 20, 2026.

## Bug Fixes:

- **Company Routines**: Editing a Product's `metadata` no longer unlinks its Routines. `SchedulerTools` and Studio can no longer delete, enable, disable or rewrite Company-managed schedules. OS Manager sends Routine and Product work to Product Manager. Under user isolation, Routines with no owner run again, and refresh archives only the caller's finished work.
- **Postgres Metrics**: `calculate_metrics()` works past the driver's query parameter limit (32,765 sessions on asyncpg, 65,533 on psycopg). On `AsyncPostgresDb`, a failed refresh now returns an error instead of a 200 with empty metrics.
- **v3 Migration on Postgres**: The sessions-to-runs migration streams rows through a server-side cursor. Memory is bounded by one batch, so large `sessions` tables no longer run out of memory.
- **Sandbox Checkpoints with Virtualenvs**: A workspace containing a Python virtualenv no longer fails checkpoint capture on its absolute interpreter links. A checkpoint that fails because of the workspace files now ends the run with a non-retryable error and releases the session, which previously stayed stuck in `finalizing`.
- **S3 Checkpoint Cancellation**: Cancelling `S3CheckpointStore.aopen_archive` no longer leaves the downloaded copy in scratch, and the cached-object digest check runs off the event loop.

## What's Changed
* fix: Move Cartesia's default TTS model to Sonic 3.6 by @jiangjiang248 in https://github.com/agno-agi/agno/pull/10750
* fix: stream the v3 sessions-to-runs migration on Postgres instead of loading it all into memory by @Himanshu040604 in https://github.com/agno-agi/agno/pull/11183
* fix: checkpoint virtualenv links and release sessions whose files cannot be checkpointed by @ysolanky in https://github.com/agno-agi/agno/pull/11191
* fix: bound OS Manager tool use and ground explanations by @ashpreetbedi in https://github.com/agno-agi/agno/pull/11175
* fix: compute Postgres metrics past the driver query parameter limit by @sannya-singal in https://github.com/agno-agi/agno/pull/11182
* fix: remove S3 checkpoint copies when an async open is cancelled by @ysolanky in https://github.com/agno-agi/agno/pull/11194
* fix: keep Company Routines linked, routed and owned consistently by @ysolanky in https://github.com/agno-agi/agno/pull/11184
* chore: Release v3.1.7 by @kausmeows in https://github.com/agno-agi/agno/pull/11174


**Full Changelog**: https://github.com/agno-agi/agno/compare/v3.1.6...v3.1.7