Changelog New Features Live progress & cancellation for page sync: Knowledge.stream_sync_pages() / astream_sync_pages() yield typed PageSyncProgress snapshots plus one terminal SyncReport, and sync_pages / async_sync_pages accept an on_progress observer. A workflow function step can now yield StepProgress(content=..., data=...) before its StepOutput, emitted as a native StepProgressEvent under the…
New Features User Management / Authorization (RBAC): a new agno.os.authz package adds role-based access control to AgentOS — a role store, scope policy, audit log, user directory and an admin router, with pluggable authorization engines (a native engine plus a fine-grained fga engine). Scopes and auth middleware were extended to enforce it. AgentOS Filesystem: a new agno.fs filesystem (DbFileSyste…
Changelog New Features: Knowledge Retrieval Pipeline: Knowledge.search() now runs a knowledge level retrieval pipeline that can widen the candidate pool before a reranker reorders it, so rerankers no longer need to be implemented per vector db. MMR Reranker: Added MMRReranker (Maximal Marginal Relevance) as a retrieval strategy that balances relevance against diversity so near-duplicate chunks do…
Changelog New Features: Azure OpenAI Responses: Added AzureOpenAIResponses to use the Responses API with Azure OpenAI deployments. See cookbook. Elasticsearch: Added Elasticsearch vector database with vector, keyword and hybrid search. See cookbook. DocumentationMarkdown: Added a transform for Knowledge.sync_pages that converts Mintlify and Fumadocs components into plain Markdown. See cookbook. Im…
What's Changed fix: clean startup logs and initialize durable queue storage by @ashpreetbedi in #10071 fix: preserve Control Plane access with public surfaces by @ashpreetbedi in #10074 Release: v3.0.9 by @ashpreetbedi in #10076 Full Changelog: v3.0.8...v3.0.9
Changelog New Features Complete page reads: Knowledge.read_full_page and aread_full_page return an entire published page from one bounded SQL read and read-only snapshot. Both support revision pinning, character limits and deadlines. Oversized pages return None; missing or changed pages retain typed errors. Calls share the existing eight-slot page-read worker pool. (feat: add bounded full-page rea…
Changelog New Features Page storage in agno.knowledge.page. Knowledge atomically publishes catalog metadata, filesystem text and vectors, preserves previous revisions when a refresh fails, and exposes bounded sync and async setup, source synchronization, search, read, list and grep APIs. Installed through the new agno[pages] extra. (#9963) Knowledge(page_search=PageSearchConfig(...)) provides type…
Changelog New Features Stateless MCP serving. MCPConfig(stateless=True) serves /mcp without session tracking, so any replica can answer any request and a multi-instance deployment needs no session affinity. Costs server-initiated notifications and SSE resumability, so it stays off by default. See cookbook. MCPTools(protocol_mode=...) selects which MCP protocol era to negotiate. Defaults to "legacy…
Changelog Breaking Changes Embedding failures are surfaced, not masked. Ingestion now reports embedding failures instead of returning success. Content that previously showed completed may now show failed or partial — those ingests were always incomplete, they were only reported as successful. The ContentStatus enum in the API (/openapi.json) gains partial, changing from ["processing","completed","…
⚠️ Breaking release. A database migration is required before v3.0 serves traffic. Read the v3 Migration Guide first, and see the full v3.0 Changelog for every change. New Features Tool result offloading: Agent(offload_tool_results=True) / Team(...) writes any tool result over 16,000 chars to AgentFS and leaves a short envelope (preview, size, result_id) in the message; the agent gets read_result /…
Changelog Behavior Changes KnowledgeManagementTools constructor flags renamed, ingest_path now opt-in: the 2.x-style enable_ingest / enable_remove flags are replaced by flags named after the tools they register — ingest_url, ingest_path, ingest_text, remove_content (the old names are no longer recognised and are ignored if passed). ingest_path defaults to off: it reads any path the server process…
Changelog New Features Per-page website ingestion: loading a website into a knowledge base now lands one content row per page, with each row's id equal to the content_id its vectors carry, so pages can be listed, refreshed, and deleted individually. The parent row becomes the site row — named after the host, aggregating status ("9 of 10 pages loaded; failed: …"), and cascading deletes to every pag…
Changelog Behavior Changes Run metadata precedence: metadata now resolves as component, then session, then call-site on Agent, Team, and Workflow, so a metadata= passed to run() wins over agent.metadata where the component value previously won. A run no longer assigns session metadata back onto the shared component, so code that read agent.metadata after a run to observe session values now sees th…
Changelog Improvements Faster agent runs with many tools: Tool schemas are now derived once and cached across runs, cutting per-run overhead for agents that carry large toolkits. (#9771) Faster long conversations: Session history is loaded incrementally per turn, so response time stays flat as a conversation grows instead of scaling with its length. (#9775) PubMed request timeout: PubmedTools now…
What's Changed test: stop three suites reading state they do not control by @ashpreetbedi in #9736 fix: state the team leader's delegation rule as need, not as a comparison with itself by @ashpreetbedi in #9737 fix: refuse dispatch cycles and bound dispatch depth in the Studio dispatch tools by @ashpreetbedi in #9745 fix: end a no-task tasks run by answering, and forbid joined member ids on nested…
What's Changed feat: run SqliteDb in WAL journal mode and restore the durable benchmark row by @ashpreetbedi in #9707 cookbook: install pydantic-ai-slim in the perf environment by @ashpreetbedi in #9706 chore: v3.0 release readiness - put the database suites under CI and fix the gates that never ran by @ashpreetbedi in #9712 feat: add MiniMax video generation tools by @octo-patch in #9529 fix: sto…
What's Changed fix: keep a workflow session's runs to its own runs by @harshsinha03 in #9634 fix: point invalid-schema table errors at the migration path by @ysolanky in #9631 fix: cache resolved tables in SQL adapters to avoid per-query existence checks by @kausmeows in #9623 fix: install a usable Postgres driver with the postgres and dev extras by @ashpreetbedi in #9635 fix: workflow event seria…
What's Changed chore: remove deprecated enable_user_memories, search_session_history, num_history_sessions and num_past_session_runs params by @sannya-singal in #7834 feat: evals user-isolation by @harshsinha03 in #8262 chore: remove v3.0.0 evals migration by @harshsinha03 in #8448 refactor: drop flat HITL kwargs in favor of human_review=HumanReview(...) by @sannya-singal in #8354 feat: consolidat…
Changelog New Features StudioRunnerTools: New identity-aware dispatch toolkit (agno.tools.studio_runner.StudioRunnerTools) that splits execution out of StudioTools. Any component (team lead, router) can mount it to discover and run Studio-built agents/teams/workflows without getting the Studio's create/edit/delete surface. run_* tools thread the caller's user_id into the sub-run so per-user state…
No content.
Changelog New Features AdvisorTools: Added AdvisorTools for asking advisor models for feedback. OpenRouteService Toolkit: Added OpenRouteService toolkit for accurate routing. StudioTools: Added component-aware schedule tools and history parameters. FileSystemTools: Allow overriding the FileSystemTools toolkit name. Bug Fixes Persisted Components: Fixed toolkit-qualified tool rehydration for persis…
Changelog New Features Smallest AI: Added SmallestTools, a text-to-speech toolkit for Smallest AI with text_to_speech (returns audio as a ToolResult artifact, optionally saved to disk) and get_voices. Supports the lightning_v3.1 and lightning_v3.1_pro models. AgentOS: Added GET /metrics/refresh/status to observe background metrics refreshes: Reports idle, running, completed or failed with started_…
New Features AgentOS Tools: Added AgentOSTools to report on AgentOS usage, latency, failures, schedules, evals, components, and pending approvals. Improvements Traces: Added latency and error stats grouped by agent, team, workflow, or endpoint, plus tool and model call stats. Implemented for PostgresDb and SqliteDb. Moonshot: Default changed to kimi-k3. Added use_thinking to toggle thinking mode.…
What's Changed fix: serialize nested executor requirements by @pratikm778 in #9162 fix: accept null path args in skill script/reference tools by @alec-drw in #9096 feat: add TrustedRouter as an OpenAILike model class by @jperla in #9100 feat: revamp entity memory for the second brain by @ashpreetbedi in #9177 chore: Release v2.8.4 by @ashpreetbedi in #9184 New Contributors @jperla made their first…
What's Changed cookbook: number the filesystem cookbook as 13_filesystem by @ashpreetbedi in #9156 fix: FileSystem tools carry no instructions; the developer composes them by @ashpreetbedi in #9172 cookbook: add examples - three agents you run and serve by @ashpreetbedi in #9170 chore: Release v2.8.3 by @ashpreetbedi in #9173 Full Changelog: v2.8.2...v2.8.3
New Features FileSystem (durable agent filesystem): A net-new state primitive — agents get a private, persistent filesystem with pluggable DB/local backends and fail-closed per-user namespace isolation. See cookbooks. Improvements Cookbooks: Rewrote the AgentOS cookbook (284 → 132 files, 24 lessons) and overhauled the agent quickstart for Gemini 3.6 Flash. What's Changed cookbook: overhaul agent q…
Changelog New Features: TwelveLabsTools: Added support for Marengo video embeddings. See docs. Slack: respond_to_other_agents flag for peer-agent communication. Improvements: Learning Stores: extraction_tool_call_limit to prevent infinite loops. Context Providers: stream_sub_agent_events supported across all providers. Bug Fixes: File Tools: list_files now exposes its optional directory parameter…
Changelog New Features agno.scorer — Turn a run into a number: CodeScorer: wraps any callable (bool | float | Score; typed-field comparison under output_schema recommended) JudgeScorer: LLM judge with the model always an explicit choice and numeric verdicts normalized to exact endpoints ((score - 1) / 9) ToolCallScorer: checks tool executions deterministically (refused, errored, or HITL-rejected c…
Changelog New Features: Superserve Tools: Added SuperserveTools to run agent-generated code and manage files in Superserve, a Firecracker-based sandbox platform for long-running agents. See docs. Plivo Tools: Added PlivoTools to send SMS, make voice calls, and look up phone numbers with Plivo. See docs. The Context Company: Added an observability integration to trace agent runs with The Context Co…
Changelog New Features: Valkey: Added ValkeyDb as a fast in-memory database for agents, teams, and workflows. See Docs Added a ValkeyDB vector store with vector and keyword search. See Docs Redmine Tools: Added RedmineTools to manage issues, comments, and time logs in Redmine, an open source project management tool. TokenLab: Added TokenLab as a new OpenAI-compatible model provider. Improvements:…