CrewAI

What's Changed Features Bump Flow canary on release Add URLReadTool for reading arbitrary URLs Add app metadata to platform action tools Unify scaffolding under crewai create <resource> Bug Fixes Clarify conversational route/handler name collision errors Documentation Update scaffold AGENTS.md for unified create CLI Breaking Changes None Contributors @Vidit-Ostwal , @joaomdmoura , @lorenzejay , @lucasgomide , @theCyberTech

What's Changed Features Track interception-hook dispatches in telemetry Add project_id to link OSS usage to an enterprise account Surface AMP in AGENTS.md and detect coding agents in telemetry Add IBM Db2 search tool Bug Fixes Clear CodeQL incomplete URL substring sanitization alerts Bump aiohttp and cryptography to clear six GHSA advisories Report the real CEL error for failures inside map literals Correctly skip code CI for docs-only PRs Documentation Snapshot and changelog for v1.15.10 Contributors @PawanThakurIBM , @Vidit-Ostwal , @gabemilani , @joaomdmoura , @lorenzejay , @lucasgomide , @...

What's Changed Features Collect skill usage events Documentation Remove migrated AMP documentation Update security reporting guidelines Snapshot and changelog for v1.15.9 Contributors @gvieira , @joaomdmoura , @theCyberTech

What's Changed Features Surface tool failures instead of reporting them as success Emit FlowFailedEvent when a flow execution fails Implement progressive disclosure for skills Documentation Update snapshot and changelog for v1.15.8 Contributors @github-actions[bot], @joaomdmoura , @lorenzejay , @lucasgomide

What's Changed Features Add WaitTool for pausing on long-running jobs. Bug Fixes Fix FileWriterTool writes and address rough edges in file tool. Mark E2B_API_KEY as a required env var for E2B tools. Documentation Refresh model availability guidance. Contributors @github-actions[bot], @joaomdmoura , @lucasgomide , @oalami , @thiagomoretto

What's Changed Bug Fixes Fix detection of Anthropic preview tool-use blocks. Preserve strict tool schema property names. Dispatch execution_end hook on failed crew and flow executions. Handle async get_agent in load_agent_from_repository. Fix dependency resolution issues. Documentation Snapshot and changelog for v1.15.5. Contributors @alex-clawd , @iris-clawd , @lorenzejay , @lucasgomide , @theCyberTech , @vinibrsl

What's Changed Features Authenticate skill registry downloads Documentation Update snapshot and changelog for v1.15.4 Contributors @vinibrsl

What's Changed Features Add organization ID parameter to PlusAPI client. Add step interception points and rework execution hooks documentation around @on . Wire execution-boundary interception points. Add generic interception-hook dispatcher. Run declarative flows on the TUI (headless terminal fallback). Improve custom OpenAI URLs. Bug Fixes Fix null repository agent attributes. Fix after_llm_call hooks to prevent breaking native tool execution. Stop double-appending the turn reply when a handler trims history. Make tool-result caching opt-in instead of on by default. Stop rewriting the author...

What's Changed Bug Fixes Fix synchronization of kickoff-completed event with OUTPUT hook result Documentation Update snapshot and changelog for v1.15.3a1 Dependency Updates Bump setuptools to 0.83.0 to address PYSEC-2026-3447 Contributors @lucasgomide , @vinibrsl

What's Changed Features Add organization ID parameter to PlusAPI client Add step interception points and rework execution hooks documentation around @on Wire execution-boundary interception points Add generic interception-hook dispatcher Run declarative flows on the TUI (headless terminal fallback) Bug Fixes Sync kickoff-completed event with OUTPUT hook result Fix null repository agent attributes Ensure after_llm_call hooks do not break native tool execution Avoid double-append of the turn reply when a handler trims history Make tool-result caching opt-in instead of on by default Stop rewritin...

What's Changed Features Promote Skills Repository out of experimental status Documentation Add Flows in Studio documentation Contributors @jessemiller , @joaomdmoura , @vinibrsl

What's Changed Features Pull latest LLM models dynamically in the crew wizard. Support inline skill definitions. Add generated Flow Definition authoring skill. Support templated Flow action inputs. Add text helper for flow CEL prompts. Add text helper to flow skill example. Implement message setup and feedback handling in AgentExecutor. Add repository agents to flow definitions. Define stream frame protocol for flows. Type tool and app in CrewDefinition. Repoint template commands to crewAIInc-fde org. Bug Fixes Key model-catalog cache by exact API key, shorten TTL, and skip Ollama. Unify crewa...

What's Changed Features Add aiobotocore to the bedrock extra Document flow agent options Add text helper to flow skill example Add text helper for flow CEL prompts Add streaming docs to the navigation Bug Fixes Reject self-listening flow methods Documentation Update snapshot and changelog for v1.15.2a1 Squeeze AGENTS.md file Contributors @akaKuruma , @github-code-quality[bot], @lorenzejay , @vinibrsl

What's Changed Features Repoint template commands to crewAIInc-fde org Support inline skill definitions Define stream frame protocol for flows Add type tool and app in CrewDefinition Add generated Flow Definition authoring skill Bug Fixes Cut docs version navigation from Edge to prevent new pages from being dropped Documentation Document Cost Limit rule type in Agent Control Plane Drop CREWAI_LOG_FORMAT references from Datadog guide Contributors @danielfsbarreto , @joaomdmoura , @lorenzejay , @lucasgomide , @vinibrsl

What's Changed Features Initialize Git repositories for generated projects ( #6364 ) Require explicit CrewAI project definitions ( #6358 ) Open deployment page after CLI deploy ( #6343 ) Bug Fixes Fix deployment page link ID resolution ( #6365 ) Fix JSON crew template rendering ( #6359 ) Fix JSON crew version pin ( #6342 ) Fix SSRF redirect bypass in scraping fetches ( #6331 ) Documentation Improve open source positioning in README ( #6363 ) Improve coding agent setup call-to-action ( #6344 ) Add snapshot and changelog for version 1.15.1a1 ( #6362 ) Contributors @joaomdmoura , @lorenzejay , @o...

What's Changed Features Support conversational flows in the CLI TUI. Bug Fixes Fix symlink path traversal in skill archive extraction. Validate declarative flow definition paths. Documentation Update snapshot and changelog for v1.14.8a3. Contributors @lorenzejay , @theCyberTech , @vinibrsl

What's Changed Features Make declarative refs work across flows and crews ( #6326 ) Bug Fixes Fix JSON schema flow state kickoff inputs ( #6325 ) Documentation Nest One Card per Step under Crew Studio and drop rollout banner (AGE-107) ( #6317 ) Update snapshot and changelog for v1.14.8a4 ( #6319 ) Refactoring Remove StateProxy from flow state access ( #6327 ) Contributors @jessemiller , @vinibrsl

What's Changed Features Track conversational flow turn usage in telemetry Support conversational flows in the CLI TUI Add unified declarative flow loading Add declarative Flow CLI support Add optional if expression to each.do steps Add single agent action to Flow definitions Add crew actions to FlowDefinition Add inline crew definition loading Add each composite action to FlowDefinition Implement DMN mode support in crew creation and execution Bug Fixes Fix owner-only permissions enforcement on credential files Fix JSON schema flow state kickoff inputs Fix symlink path traversal in skill archi...

What's Changed Features Track TUI button telemetry Require explicit CrewAI project definitions Open deployment page after CLI deploy Bug Fixes Fix JSON crew template rendering Fix JSON crew version pin Fix SSRF redirect bypass in scraping fetches Documentation Improve coding agent setup CTA Snapshot and changelog for v1.15.0 Contributors @joaomdmoura , @lorenzejay , @theCyberTech , @vinibrsl

What's Changed Features Add unified declarative flow loading Improve crewai run startup UX Consolidate crewai run and crewai flow kickoff Keep flow method progress visible for nested crews Add declarative Flow CLI support Allow @router() as start method of a flow Add typed output schemas for CrewAI tools Bug Fixes Pin opentelemetry to ~=1.42.0 Documentation Add "One Card per Step" Studio page Contributors @jessemiller , @joaomdmoura , @lucasgomide , @vinibrsl

What's Changed Features Add optional if expression to each.do steps Bug Fixes Fix JSON crew issues Documentation Update snapshot and changelog for v1.14.8a Contributors @joaomdmoura , @vinibrsl

What's Changed Features Add single agent action to Flow definitions Validate flow CEL expressions at definition load time Documentation Add Datadog integration guide with importable operations dashboard Update snapshot and changelog for v1.14.8a1 Contributors @joaomdmoura , @lucasgomide , @vinibrsl

What's Changed Features Add script/code block action to FlowDefinition Add crew actions to FlowDefinition Add each composite action to FlowDefinition Implement DMN mode support in crew creation and execution Enhance memory reset functionality and JSON crew handling Add expressions to FlowDefinition actions Implement Flow definition run tools without Python code Drive human feedback from the flow definition Wire config and persistence from FlowDefinition into the runtime Add experimental crewai run --definition for flows Support ZIP deployment fallback and JSON crew project env runs Introduce J...

What's Changed Bug Fixes Gate restore on a flag to prevent live snapshots from replaying as resume Documentation Update changelog and version for v1.14.7rc1 Contributors @greysonlalonde

What's Changed Features Add pluggable default backends for memory, knowledge, rag, and flow. Surface real finish_reason, sampling params, and response.id on LLM events. Type DSL triggers as route-aware decorators. Add chat API for conversational flows. Make locking backend overridable. Build FlowDefinition from Flow DSL metadata. Add native Snowflake Cortex LLM provider. Add crew trained agents file support. Bug Fixes Fix checkpoint to rebuild custom BaseLLM as concrete LLM on restore. Gate restore on a flag to prevent live snapshots from replaying as resume. Scope runtime state per run to bou...

What's Changed Features Add reset_runtime_state to release accumulated bus state Handle supporting both custom prompts Decouple conversation logic from runtime and add a conversational_definition Bug Fixes Fix scope of runtime state per run to bound growth and isolate concurrent runs Fix telemetry setup on crewai-login Fix respect for suppress_flow_events for method-execution events Documentation Update OpenTelemetry images Update documentation to reflect new state of OpenTelemetry collector Update changelog and version for v1.14.7a4 Refactoring Simplify flow condition evaluation to be statele...

What's Changed Features Migrate @listen/ @router runtime to read from FlowDefinition Add pluggable default backends for memory, knowledge, rag, and flow Documentation Update changelog and version for v1.14.7a3 Contributors @greysonlalonde , @mattatcha , @vinibrsl

What's Changed Bug Fixes Fix exposure of ask_for_human_input on experimental AgentExecutor Resolve pip-audit CVEs for aiohttp , docling , docling-core , and pip Refactoring Migrate @start to read from FlowDefinition Documentation Update changelog and version for v1.14.7a2 Contributors @greysonlalonde , @lorenzejay , @vinibrsl

What's Changed Features Add crew trained agents file support Add native Snowflake Cortex LLM provider Add Databricks integration guide Add Snowflake integration guide Bug Fixes Fix CLI by restoring [project.scripts] in crewai package for UV tool install Resolve file input reliability issues Fix incomplete tool result histories in Snowflake Claude Handle stringified tool calls for Snowflake Claude Re-arm multi-source or_ listeners across router-driven cycles Performance Improve crewai import speed by lazy-loading docling imports Refactoring Split flow.py into DSL, definition, and runtime Contri...

What's Changed Features Enhance StdioTransport to prevent environment variable leakage Enhance planning configuration and observation handling Declare env_vars on DatabricksQueryTool Add Agent Control Plane docs Bug Fixes Fix structured output leaks in tool-calling loops Drop unroundtrippable callbacks and adapter state in checkpoint Serialize type[BaseModel] fields as JSON schema in checkpoint Avoid orphan task_started on resume scope restore Allow AgentExecutor to restore from checkpoint Correct mongodb typo to pymongo in package_dependencies Documentation Add ACP (Beta) docs navigation bloc...

What's Changed Features Enhance StdioTransport to prevent environment variable leakage Enhance planning configuration and observation handling Declare env_vars on DatabricksQueryTool Add Agent Control Plane documentation Bug Fixes Fix structured output leaks in tool-calling loops Drop unroundtrippable callbacks and adapter state in checkpointing Serialize type[BaseModel] fields as JSON schema in checkpointing Avoid orphan task_started on resume scope restore Allow AgentExecutor to restore from checkpoint Correct MongoDB typo to pymongo in package dependencies Documentation Restructure checkpoi...

What's Changed Features Add Skills Repository with registry, cache, CLI, and SDK integration Generate categorized release notes for enterprise Bug Fixes Harden RuntimeState serialization across entity fields Bump idna to 3.15 to address security issue GHSA-65pc-fj4g-8rjx Remove {" "} JSX expressions breaking render Documentation Update changelog and version for v1.14.5 Contributors @akaKuruma , @alex-clawd , @greysonlalonde

What's Changed Features Deprecate CrewAgentExecutor , default Crew agents to AgentExecutor Improve Daytona sandbox tools Add restore_from_state_id kickoff parameter Add highlights to ExaSearchTool , rename from EXASearchTool Bug Fixes Fix memory leak in git.py by using cached_property Surface streamed tool calls when available_functions is absent Ensure skills loading events for traces Correct status endpoint path from /{kickoff_id}/status to /status/{kickoff_id} Restore missing code block in pt-BR first-flow guide Prevent result_as_answer from returning hook-block or error messages as final a...

What's Changed Documentation Update changelog and version for v1.14.5a6 Breaking Changes Deprecate function_calling_llm field Contributors @greysonlalonde , @heitorado

What's Changed Bug Fixes Fix streamed tool calls when available_functions is absent Bump langsmith dependency to version >=0.8.0 to address GHSA-3644-q5cj-c5c7 Resolve untranslated code block placeholders in Brazilian Portuguese documentation Documentation Add documentation for TavilyGetResearch Update changelog and version for v1.14.5a5 Contributors @greysonlalonde , @heitorado , @iris-clawd , @lorenzejay , @manisrinivasan2k1

What's Changed Features Deprecate CrewAgentExecutor, default Crew agents to AgentExecutor Improve Daytona sandbox tools Bug Fixes Fix missing code block in pt-BR first-flow guide Log HITL pre-review and distillation failures, add learn_strict Patch urllib3 for security vulnerabilities Patch gitpython and langchain-core; ignore unpatched paramiko CVE Refresh all published workspace packages on uv lock/sync Documentation Add migration guide for inputs.id to restoreFromStateId Add OSS upgrade and crew-to-flow migration guide Update changelog and version for v1.14.5a4 Contributors @akaKuruma , @gr...

What's Changed Features Update LLM listings Bug Fixes Fix dependency issue by moving textual to crewai-cli and adding certifi Documentation Update changelog and version for v1.14.5a3 Contributors @cgoeppinger , @greysonlalonde

What's Changed Bug Fixes Fix status endpoint path from /{kickoff_id}/status to /status/{kickoff_id} Bump gitpython dependency to version >=3.1.47 for security compliance Refactoring Extract CLI into standalone crewai-cli package Documentation Update changelog and version for v1.14.5a2 Contributors @greysonlalonde , @iris-clawd

What's Changed Bug Fixes Fix task output restoration in finally block Include thoughts_token_count in completion tokens Preserve task outputs across async batch flush Forward kwargs to loader calls in CrewAIRagAdapter Prevent result_as_answer from returning hook-block message as final answer Prevent result_as_answer from returning error as final answer Use acall for output conversion in async paths Prevent shared LLM stop words mutation across agents Handle BaseModel input in convert_to_model Documentation Document additional environment variables Update changelog and version for v1.14.5a1 Con...

What's Changed Features Add restore_from_state_id kickoff parameter Add highlights to ExaSearchTool and rename from EXASearchTool Bug Fixes Fix missing crewai pin sites in release flow Ensure skills loading events for traces Documentation Update changelog and version for v1.14.4 Contributors @akaKuruma , @github-actions[bot], @greysonlalonde , @lorenzejay , @theishangoswami

What's Changed Features Add support for custom persistence key in @persist Add Responses API support for Azure OpenAI provider Forward credential_scopes to Azure AI Inference client Add Vertex AI workload identity setup guide Add Tavily Research and get Research Add You.com MCP tools for search, research, and content extraction Bug Fixes Fix fall through when JSON regex match isn't valid JSON Fix to preserve tool_calls when response also contains text Fix to forward base_url and api_key to instructor.from_provider Fix to warn and return empty when native MCP server returns no tools Fix to use ...

What's Changed Bug Fixes Fix crew chat description helpers against LLM failures. Reset messages and iterations between invocations in executor. Forward trained-agents file through replay and test in CLI. Honor custom trained-agents file at inference in agent. Bind task-only agents to crew to ensure multimodal input_files reach the LLM. Serialize guardrail callables as null for JSON checkpointing. Rename force_final_answer in agent_executor to avoid self-referential router. Bump litellm for SSTI fix and ignore unfixable pip CVE. Documentation Add E2B Sandbox Tools page. Add Daytona sandbox tool...

What's Changed feat(flow): support custom persistence key in @persist by @lucasgomide in #5649 fix(llm): use validated messages variable in non-streaming handlers by @greysonlalonde in #5655 feat(azure): add Responses API support for Azure OpenAI provider by @kunalk16 in #5201 fix(mcp): warn and return empty when native MCP server returns no tools by @greysonlalonde in #5657 fix(instructor): forward base_url and api_key to instructor.from_provider by @greysonlalonde in #5658 feat(azure): forward credential_scopes to Azure AI Inference client by @mattatcha in #5661 New Contributors @kunalk16 ma...

What's Changed Features Add lifecycle events for checkpoint operations Add support for e2b Fall back to DefaultAzureCredential when no API key is provided in Azure integration Add Bedrock V4 support Add Daytona sandbox tools for enhanced functionality Add checkpoint and fork support to standalone agents Bug Fixes Fix execution_id to be separate from state.id Resolve replay of recorded method events on checkpoint resume Fix serialization of initial_state class references as JSON schema Preserve metadata-only agent skills Propagate implicit @crewbase names to crew events Merge execution metadata...

What's Changed Features Add support for e2b Implement fallback to DefaultAzureCredential when no API key is provided Bug Fixes Upgrade lxml to >=6.1.0 to address security issue GHSA-vfmq-68hx-4jfw Documentation Remove pricing FAQ from build-with-ai page across all locales Performance Improve cold start time by ~29% through lazy-loading of MCP SDK and event types Contributors @alex-clawd , @github-advanced-security[bot], @greysonlalonde , @iris-clawd , @lorenzejay , @mattatcha

What's Changed Features Add support for bedrock V4 Add Daytona sandbox tools for enhanced functionality Add 'Build with AI' page — AI-native docs for coding agents Add Build with AI to Get Started navigation and page files for all languages (en, ko, pt-BR, ar) Bug Fixes Fix propagation of implicit @crewbase names to crew events Resolve issue with duplicate batch initialization in execution metadata merge Fix serialization of Task class-reference fields for checkpointing Handle BaseModel result in guardrail retry loop Bump python-dotenv to version >=1.2.2 for security compliance Documentatio...