v2.6.19

agno-agi/agnov2.6.19Jun 23, 2026by kausmeows

AI Summary

This release introduces checkpointing capabilities for tools and a new StudioTool for dynamic composition. It also includes improvements to Gemini, PII detection, and Vector DBs.

Key Highlights

  • Added tool batch-level checkpointing and unified /continue functionality for regenerating and forking runs
  • Introduced StudioTool for dynamic agent, team, and workflow composition
  • Gemini interactions are now lazily imported to reduce dependencies
  • PII Guardrail custom_patterns now accepts raw regex strings
  • ClickHouse and Pinecone now report supported search types

New Features

  • Tool batch-level checkpointing
  • Unified /continue for regenerate and forking
  • StudioTool for dynamic composition

Full Release Notes

# Changelog

## New Features:

- **Checkpointing:** Added tool batch level checkpointing and unified `/continue` for regenerate and forking a run. Also added support for forking sessions. See [cookbooks](https://github.com/agno-agi/agno/tree/main/cookbook/02_agents/18_checkpointing).
- Add a new toolkit `StudioTool` for dynamic agent, team , workflow composition.

## Improvements:

- **Gemini**: `GeminiInteractions` is now lazily imported, so Gemini no longer requires `google-genai 2.0.`
- **PII Guardrail:** `custom_patterns` now accepts raw regex strings.
- **Vector DBs**: ClickHouse and Pinecone now report their supported search types via `get_supported_search_types()`

## Bug Fixes:

- **FileTools**: Return forward-slash paths from FileTools and related file tools on all platforms.
- **Team Cancellation**: Async team delegation now uses the async cancellation check.
- **AccuracyEval**: Fixed empty results to return `None` scores.
- **Gemini**: Guidance retries now respect `retry_with_guidance_limit` after a retryable error.
- **Serialization**: Non-ASCII text is now preserved instead of being escaped.
- **Files**: Text files now reload correctly from session history.
- **Teams**: Nested team post-hook events no longer leak into response content.
- **Run Events**: Streaming content events no longer drop the `image` field.
- **OpenAILike**: Avoid `Chat` suffix for OpenAILike providers.
- **SentenceTransformerReranker**: Allow supplied cross encoder.
- **HackerNews**: Read user ID from the correct API field.

## What's Changed
* fix(hackernews): read user id from the correct API field by @devYRPauli in https://github.com/agno-agi/agno/pull/8422
* [fix] Allow supplied SentenceTransformerReranker cross encoder by @YankhangSIT in https://github.com/agno-agi/agno/pull/8415
* fix: avoid Chat suffix for OpenAILike providers by @mattholy in https://github.com/agno-agi/agno/pull/8428
* fix: validation by @kausmeows in https://github.com/agno-agi/agno/pull/8493
* fix: support google-genai 2.9.0 in GeminiInteractions by @ysolanky in https://github.com/agno-agi/agno/pull/8488
* feat: introduce StudioTool for dynamic agent, team , workflow composition by @Ayush0054 in https://github.com/agno-agi/agno/pull/7575
* [chore] Fix typos: guardails → guardrails in agent and team _run.py by @yaosongding in https://github.com/agno-agi/agno/pull/8504
* [fix] emit POSIX paths from FileTools search and listing methods by @Shiv1909 in https://github.com/agno-agi/agno/pull/7526
* fix: await async cancellation check in async delegate paths by @kepler in https://github.com/agno-agi/agno/pull/8489
* [fix] make GeminiInteractions import lazy to avoid forcing google-genai>=2.0.0 by @raywcm in https://github.com/agno-agi/agno/pull/8429
* [fix] AccuracyResult stat fields default to None to prevent AttributeError by @octo-patch in https://github.com/agno-agi/agno/pull/7674
* [fix] prevent unicode escaping in knowledge serialization using ensure_ascii=False by @harsh21234i in https://github.com/agno-agi/agno/pull/7041
* fix: guidance-retry limit bypassed when plain retry precedes RetryableModelProviderError by @devteamaegis in https://github.com/agno-agi/agno/pull/8094
* fix: auto-compile raw regex strings in PIIDetectionGuardrail.custom_patterns by @VANDRANKI in https://github.com/agno-agi/agno/pull/7775
* fix: Validate base64 and preserve text file content by @VirusDumb in https://github.com/agno-agi/agno/pull/8459
* fix: add PostHookStartedEvent and PostHookCompletedEvent to TeamRunOutputEvent Union (#8351) by @raywcm in https://github.com/agno-agi/agno/pull/8358
* fix: report supported search types for clickhouse and pineconedb by @SalimELMARDI in https://github.com/agno-agi/agno/pull/6907
* fix: serialize the singular image field in BaseRunOutputEvent.to_dict() by @ly-wang19 in https://github.com/agno-agi/agno/pull/8524
* feat: run checkpointing + unified /continue by @ashpreetbedi in https://github.com/agno-agi/agno/pull/8092
* chore: Release v2.6.19 by @kausmeows in https://github.com/agno-agi/agno/pull/8531

## New Contributors
* @devYRPauli made their first contribution in https://github.com/agno-agi/agno/pull/8422
* @YankhangSIT made their first contribution in https://github.com/agno-agi/agno/pull/8415
* @yaosongding made their first contribution in https://github.com/agno-agi/agno/pull/8504
* @raywcm made their first contribution in https://github.com/agno-agi/agno/pull/8429
* @ly-wang19 made their first contribution in https://github.com/agno-agi/agno/pull/8524

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