NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1276 most downloaded on Packagist
PHP library for building agentic applications.
Latest stable
v0.15.0
Last release 27 days ago
26 Oct 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 16 of 16 stable releases
Nothing withdrawn
no release was ever pulled
11 months old
17 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
feature #2812 Move the message store bridges to the Agent component and deprecate Chat (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.15.0...v1.0.0-BETA1)
MessageBag::latestAs() (@chr-hertel)minor #2753 Bump version constraints to 0.15 (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.14.1...v0.15.0)
asObject() for static analysis (@chr-hertel)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Execution::asObject(), asserting the structured output is an instance of that class and letting static analysis infer it as the return typeProgress::STAGE_MODEL_REQUEST, Progress::STAGE_DELTA, Progress::STAGE_TOOL_CALL and Progress::STAGE_HANDOFF constants for the stage names this package itself reports, used internally wherever a stage was matched or constructed with a raw stringbug #2609 Keep the final result's own metadata over the tool call rounds (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.14.0...v0.14.1)
minor #2599 Bump version to 0.14 and sync demo Mate skills (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.13.0...v0.14.0)
Execution::cancel() to stop an active execution and cancel its active HTTP responseMultiAgent and SpeechAgent now forward the Progress updates of the executions they delegate to, and MultiAgent reports its routing as a Progress update of the handoff stage carrying the orchestrator's MultiAgent\Handoff\Decision as payloadBridge\SimilaritySearch\SimilaritySearch::getUsedDocuments() returns Store\Document\VectorDocumentInterface[] instead of Store\Document\VectorDocument[], following the retriever it reads fromStopwatch to Toolbox\TraceableToolbox and TraceableAgent, timing each tool execution and the consumption of each agent executionExecution\Execution::isStreamed()Toolbox\FiberToolExecutor to run tool calls concurrently through PHP Fibers, together with a Toolbox\SuspendableTrait for cooperative toolsToolbox\AbstractToolbox holding the shared part of executing a tool call - looking the tool up, the tool call events and the error handling - so a toolbox in front of a remote tool protocol only implements how a call is turned into a valueToolbox\ChainToolbox offering the tools of several toolboxes to one agent#[MapToolArguments] to map a flat tool-call payload onto a single DTO parameter while exposing the DTO properties as the tool schema rootminor #2460 Bump Version Constraints for v0.13.0 (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.12.0...v0.13.0)
ValidateToolCallArgumentsListener now also validates scalar and array tool parameters carrying a #[Schema] attribute (pattern, minLength/maxLength, minimum/maximum/exclusiveMinimum/exclusiveMaximum, multipleOf, minItems/maxItems, uniqueItems, enum, const), not only object parameters validated through Symfony Validator constraintsToolbox\AgentProcessor; tool calling is now driven by the Agent itself, configured with the toolbox, toolExecutor, maxToolCalls, excludeToolMessages, includeSources and eventDispatcher constructor argumentsToolbox\ToolExecutorInterface and its default SequentialToolExecutor implementation, making the execution of the requested tool calls replaceableSystemPromptInputProcessor now accepts and preserves a TemplateAgentInterface::call() to return a lazy, iterable Execution that is also the ResultInterface it produces — read it eagerly (getContent(), getResult()), iterate it to observe every model request, tool call and streamed delta as a Progress update, or register onProgress()/onResult() callbacksToolbox\StreamListener; streamed rounds are consumed by the agent itself and their deltas are reported as Progress updates of the delta stage, surfaced by the streamed execution's getContent()asText(), asObject(), asBinary(), asFile(), asDataUri(), asToolCalls(), asStream(), asTextStream(), asStreamedObject() and asPartialJsonStream() to Execution, narrowing the produced result or its streamed deltas like DeferredResult doesminor #2358 Prepare version constraints for release of v0.12.0 (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.11.0...v0.12.0)
AgentInterface::call() to accept string|MessageBag|UserMessage and rename its first parameter from $messages to $inputinput key of TraceableAgent::getCalls() entries, which was previously named messages, to carry the untouched inputAgent::call() support for plain strings and single UserMessage objects, e.g. $agent->call('Hello world')minor #2320 Prepare version constraints for release of v0.11.0 (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.10.0...v0.11.0)
metadata support for tools to allow attaching custom datagetMetadata() to getDefinition() on the tool call events (ToolCallRequested, ToolCallArgumentsResolved, ToolCallSucceeded, ToolCallFailed), since it returns the tool definition and the "metadata" name is now used for the tool's classificationfeature #2179 Default maxToolCalls to 50 in AgentProcessor (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.9.0...v0.10.0)
SystemPromptInputProcessor::getSystemPrompt() to read the configured system prompt without reflectionmaxToolCalls parameter of AgentProcessor from null (unbounded) to 50. Pass null explicitly to restore the previous unbounded behaviour.bug #2089 Avoid empty streamed assistant message on tool calls (@chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.8.0...v0.9.0)
feature #1557 Add support for DiscriminatorMap on single polymorphic interface parameters (@aszenz)
Changelog (https://github.com/symfony/ai-agent/compare/v0.7.0...v0.8.0)
MultiPartResult (@valtzu)SimilaritySearch::$usedDocuments to private; use getUsedDocuments() insteadpublic array $calls to private array $calls in TraceableAgent and TraceableToolbox - use getCalls() insteadStaticMemoryProvider constructor from variadic string ...$memory to array $memoryToolCallsExecuted constructor from variadic ToolResult ...$toolResults to array $toolResultsfeature #943 Introduce Speech support (@Guikingone, @chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.6.0...v0.7.0)
Speech support (@Guikingone, @chr-hertel)symfony/validator (@valtzu)RetrieverInterface and add customizable prompt template (@OskarStark)TraceableAgent and TraceableToolbox profiler decorators moved from AI BundleSimilaritySearch to use RetrieverInterface instead of VectorizerInterface and StoreInterface$promptTemplate parameter to SimilaritySearch constructorAbstractToolFactory in favor of standalone ReflectionToolFactory and MemoryToolFactoryToolFactoryInterface::getTool() signature from string $reference to object|string $referenceToolCallRequested event dispatched before tool executionStreamListener to use DeltaEvent and TextDelta instead of ChunkEvent and raw stringsStreamListener to react to ToolCallComplete instead of ToolCallResultValidateToolCallArgumentsListener to validate tool call arguments with symfony/validator componentSpeechAgent decorator for speech-to-text and text-to-speech capabilitiesfeature #1683 Make JSON schema generation extensible (v2) (@valtzu)
Changelog (https://github.com/symfony/ai-agent/compare/v0.5.0...v0.6.0)
Changelog (https://github.com/symfony/ai-agent/compare/v0.4.0...v0.5.0) * no significant changes
Changelog (https://github.com/symfony/ai-agent/compare/v0.4.0...v0.5.0)
bug #1607 Keep lazy iterator alive (chr-hertel)
Changelog (https://github.com/symfony/ai-agent/compare/v0.3.3...v0.4.0)
HasSourcesTrait to Subagent (janssensglenn)metadata to AssistantMessage (janssensglenn)Symfony\AI\Agent\Toolbox\Tool\Agent to Symfony\AI\Agent\Toolbox\Tool\SubagentkeepToolMessages to excludeToolMessages and default behaviour to preserve tool messagesMetaDataAwareTrait to MockResponse, the metadata will also be set on the returned TextResult when calling the toResult functionHasSourcesTrait to Symfony\AI\Agent\Toolbox\Tool\Subagent[BC BREAK] Drop toolboxes StreamResult in favor of StreamListener on top of Platform's StreamResult
StreamResult in favor of StreamListener on top of Platform's StreamResultSourceMap to SourceCollection, its methods from getSources() to all() and addSource() to add()ToolResult::__construct() now expects SourceCollection instead of array<int, Source>maxToolCalls parameter to AgentProcessor to limit tool calling iterations and prevent infinite loopsCountable and IteratorAggregate implementations to SourceCollection[BC BREAK] Switch MemoryInputProcessor to use iterable instead of variadic arguments
MemoryInputProcessor to use iterable instead of variadic arguments* Add the component
One column per month.