v2.6.20

# Changelog

## New Features:

- **ClickhouseDB for Traces:** Added support for ClickHouse for high-volume trace ingest and OLAP scans. See docs.
- **Scavio Search Toolkit**: New search toolkit integration with Scavio.

## Improvements:

- **OpenAI**: Citations from web-search responses are now surfaced on `response.citations` for `OpenAIChat` and `OpenAILike` providers.
- **AgentOS**: Support `FastAPI >= 0.137` so `get_routes()` lists every route.
- **LiteLLM**: Support native structured outputs and JSON schema outputs (enable per provider with `supports_native_structured_outputs` or `supports_json_schema_outputs`).
- **Google Toolkits Auth Refactor**: Unified auth base class for Google toolkits.
- **AgentOS**: Updated to not limit `quick_prompts` to 3 per agent/team/workflow.

## Bug Fixes:

- **MCP**: Preserve `_meta` and `structuredContent` from MCP tool results on `ToolResult.metadata`.
- **Tool-Result Compression:** Fixed token miscount for tools with numeric enum params, so compression triggers at the right time.
- **Workflow**: Isolate `step_id` across concurrent runs while keeping it stable across pause/continue in HITL runs.
- **Tools**: `Toolkit` and `Searxng` no longer reuse a mutable default list across instances.
- **Traces**: Use canonical conditions key when scoping trace filters for scoped users.
- Reddit: Write actions are now scoped to the configured allowed subreddits.
- MoviePy: Generated outputs are written atomically to avoid partial files.
- **OpenAI**: Fixed `OpenAIResponses` to support Chat Completions–style `json_schema` output schemas.


## What's Changed
* cookbook: add remote agent as team member examples by @Mustafa-Esoofally in https://github.com/agno-agi/agno/pull/8248
* fix: Fixes a data-loss bug by @abhi10691 in https://github.com/agno-agi/agno/pull/7659
* feat: refactor Google toolkits with unified auth base class by @Mustafa-Esoofally in https://github.com/agno-agi/agno/pull/8267
* refactor: split agui/utils.py into focused modules by @Himanshu040604 in https://github.com/agno-agi/agno/pull/8364
* fix: preserve structuredContent from MCP CallToolResult by @weiguangli-io in https://github.com/agno-agi/agno/pull/7715
* [fix] Add support for citations in OpenAI chat responses by @MSNP1381 in https://github.com/agno-agi/agno/pull/5885
* feat: Add checkpointing demo for AgentOS by @anuragts in https://github.com/agno-agi/agno/pull/8549
* fix: render numeric enums as numeric literal unions in token type formatting by @Osamaali313 in https://github.com/agno-agi/agno/pull/8554
* fix: guard path-less routes in OS resync and regenerate step_id on workflow deep_copy by @ysolanky in https://github.com/agno-agi/agno/pull/8465
* fix: use canonical conditions key when scoping trace filters for scoped users by @sannya-singal in https://github.com/agno-agi/agno/pull/8564
* fix: Pass response_format to LiteLLM completion for structured outputs by @dee-walia20 in https://github.com/agno-agi/agno/pull/5881
* [test] make function cache path test cross-platform by @Fishbone23333 in https://github.com/agno-agi/agno/pull/8326
* [fix] Write MoviePy outputs atomically by @fengjikui in https://github.com/agno-agi/agno/pull/8537
* fix: scope reddit writes to allowed subreddits by @fengjikui in https://github.com/agno-agi/agno/pull/8539
* fix: quick prompt cap removal by @mishramonalisha76 in https://github.com/agno-agi/agno/pull/8577
* fix: replace mutable default argument in Toolkit.__init__ by @xlyoung in https://github.com/agno-agi/agno/pull/8253
* refactor: consolidate MCP ToolResult metadata into a single field by @harshsinha03 in https://github.com/agno-agi/agno/pull/8580
* fix: replace EOL claude-sonnet-4-0 with claude-sonnet-4-5 and harden flaky knowledge tests by @sannya-singal in https://github.com/agno-agi/agno/pull/8581
* [feat] Add Scavio search toolkit by @scavio-ai in https://github.com/agno-agi/agno/pull/8508
* feat: clickhouse db for traces by @kausmeows in https://github.com/agno-agi/agno/pull/7799
* chore: Release v2.6.20 by @harshsinha03 in https://github.com/agno-agi/agno/pull/8576

## New Contributors
* @weiguangli-io made their first contribution in https://github.com/agno-agi/agno/pull/7715
* @Osamaali313 made their first contribution in https://github.com/agno-agi/agno/pull/8554
* @dee-walia20 made their first contribution in https://github.com/agno-agi/agno/pull/5881
* @Fishbone23333 made their first contribution in https://github.com/agno-agi/agno/pull/8326
* @xlyoung made their first contribution in https://github.com/agno-agi/agno/pull/8253
* @scavio-ai made their first contribution in https://github.com/agno-agi/agno/pull/8508

**Full Changelog**: https://github.com/agno-agi/agno/compare/v2.6.19...v2.6.20