Changelog

New Features

• Team Execution Modes: Introduced TeamMode enum with four execution modes:
  • coordinate (default): Supervisor pattern where the leader picks members, crafts tasks, and synthesizes responses
  • route: Router pattern where the leader routes to a specialist and returns their response directly
  • broadcast: Broadcast pattern where the leader delegates the same task to all members simultaneously
  • tasks: Autonomous task-based execution where the leader decomposes goals into a shared task list
• Human-in-the-Loop (HITL) for Teams: Improved RunRequirement system for paused runs with better support for:
  • Tool confirmation flows
  • User input collection with schema validation
  • External tool execution
• Approval System: New @approval decorator for human approval workflows:
  • @approval(type="required"): Blocking approval that pauses the run until resolved via approvals API
  • @approval(type="audit"): Non-blocking audit trail for compliance/logging
  • Persistent approval records with status tracking (pending, approved, rejected, expired, cancelled)
  • Approvals API for listing, inspecting, and resolving approvals
• Scheduler: Cron-based scheduling for agents, teams, and workflows with retry, timeout, and timezone support.
• LearningMachine for Teams: Added support for LearningMachine for persistent learning.
• Callable Factories for Tools, Knowledge, and Members: Tools, knowledge, and team members can now be defined as callable factories that are resolved at runtime with access to RunContext. Supports caching via cache_callables and custom cache keys for session-scoped resolution.
• Infra: Adds support for AWS EFS
• Knowledge Isolation: Added isolate_vector_search flag to Knowledge class. When enabled, documents are tagged with linked_to metadata during insert and searches filter by this tag, allowing multiple Knowledge instances to share the same vector database while maintaining isolated search results. Defaults to False for backwards compatibility with existing data.

Improvements

• Agent/Team Refactor: Major internal refactor of Agent and Team classes for cleaner separation of concerns.

Bug Fixes:

• LanceDb Cloud: Fixed search() to stop reopening the table; use .to_list() instead of .to_pandas() in vector/hybrid/keyword search.
• Primary key constraint: Fixed sessions, component_configs and component_links table to use primary key instead of _unique_constraints.

Breaking Changes

• store_history_messages now defaults to False: History messages are no longer stored by default. This reduces unnecessary storage overhead, improves privacy by not persisting conversation history unless explicitly needed, and gives better control over storage costs. If you rely on stored history, set store_history_messages=True explicitly.
• Knowledge Uniqueness: Knowledge instances now require a unique combination of database, table, and knowledge name. Multiple Knowledge instances cannot share the same table without distinct names to prevent data conflicts.

What's Changed

• chore: update AgentOS description by @ashpreetbedi in #6225
• fix: explicitly show none in skills system prompt by @uzaxirr in #6311
• chore: add Conductor notes to agent docs by @ashpreetbedi in #6323
• [fix] Use JSON serialization instead of str() for workflow run_input by @salimhamed in #6318
• fix: LanceDB cloud integration by @willemcdejongh in #6337
• fix: handle text file formats correctly in document messages by @Mustafa-Esoofally in #6329
• feat: Add EFS volume and mount point support for AWS apps by @Mustafa-Esoofally in #6251
• feat: enhance SlackTools and add file handling to interface by @Mustafa-Esoofally in #6306
• feat: AgentOS select Knowledge by name by @willemcdejongh in #6287
• fix: Update quickstart knowledge instance name by @willemcdejongh in #6408
• fix: add primary key constraints to SQLite component tables by @ysolanky in #6395
• fix: add stub classes for JWT imports when PyJWT is not installed by @ysolanky in #6476
• [feat] v2.5 Phase 1 — Agent/Team refactor and baseline by @ashpreetbedi in #6429
• V2.5 phase2 r by @ashpreetbedi in #6506
• V2.5 phase3 rb by @ashpreetbedi in #6511
• V2.5 phase4 rb by @ashpreetbedi in #6514
• V2.5 phase5 rebase by @ashpreetbedi in #6515
• fix: resolve ruff lint errors by @ysolanky in #6517
• fix: resolve scheduler property setter conflict in AgentOS by @ashpreetbedi in #6520
• feat: Add isolate_vector_search flag for backwards-compatible knowledge isolation by @willemcdejongh in #6519
• fix: align scheduler tests with current API by @ysolanky in #6525
• refactor: update approvals endpoint to use paginated response model by @Ayush0054 in #6526
• fix: resolve ruff and mypy validation errors by @ashpreetbedi in #6518
• [fix] AgentOS: remove unused scheduler property and fix double MCP lifespan by @ashpreetbedi in #6522
• fix: restore missing v2.5 fields in SqliteDb/PostgresDb from_dict by @Mustafa-Esoofally in #6531
• feat: Release 2.5.0 by @kausmeows in #6501

New Contributors

• @salimhamed made their first contribution in #6318

Full Changelog: v2.4.8...v2.5.0