Support OpenAILikeEmbeddings custom http client - PR #599 by @pcastellazzi

Support Gemini citations when streaming

Support mistral image content block for base64 format - Fix #596

Introducing the Regex validation rule for structured output:

namespace App\Neuron\Output;

use NeuronAI\StructuredOutput\Validation\Rules\Regex;

class Coupon
{
    #[Regex('/^[A-Z]{2}\d{4}$/')]
    public string $code;
}

Check it out in the documentation: https://docs.neuron-ai.dev/agent/structured-output#regex

improve doc-block in agent class

• Ensure ToolResultMessage uses indexed tools array - PR #594 by @Tinywan

Make Gemini baseUri customizable

Make zai url customizable - PR #589 by @rafaelchavesfreitas

Deprecate the InspectorObserver, use the new observer from the Inspector PHP package - Inspector/Neuron/InspectorObserver

https://docs.inspector.dev/guides/neuron-ai

Fix MeilisearchVectorStore - PR #590 by @bytestream

Fix AGUIAdapter event format

Collect Cached Input Tokens, Reasoning Tokens across providers - PR #572 by @mattmilesi

• Support nullable for Enum validation rule in structured output - PR #587 by @bytestream

• Fix Gemini structured output collision with DTO properties named "$type" - by @ilvalerione

• Fix AzureOpenAI usl format

• Fix typo in README - by @meichuanyi
• Extend NeuronException in HttpException - by @bytestream
• Set response in HttpException when available - by @bytestream
• Restore original parameters in AI Providers after structured output - by @ilvalerione

• Make the LogObserver easy to extends - PR #582 by @bytestream
• Docker configuration for local development and test

Fix Qdrant async ops

Improve streaming performance for Guzzle and Amp stream adapters

Improve streaming performance for Guzzle and Amp stream adapters

Improve streaming performance

Fix tracking request ID on MCP tool call

HttpClient & MCP Transport - Security & Performance Fixes

Security

• Fixed: Null pointer dereference in HttpException::networkError()
• Fixed: SSRF via MCP server endpoint redirect in SseHttpTransport
• Fixed: CRLF header injection in SseHttpTransport::buildHeaderString()
• Fixed: Unvalidated URIs in HttpRequest

Performance

• Fixed: Guzzle Client recreated on every request
• Fixed: Amp HTTP Client rebuilt on every request
• Optimized: Byte-by-byte readLine() in stream adapters

Reliability

• Fixed: Unbounded SSE buffer in SseHttpTransport
• Fixed: Missing timeouts in AmpHttpClient multipart path
• Removed: Dead catch block in AmpStream::readLine()

Optimize and secure RAG components (Vector similarity, text splitters)

• Improve MCP components lifecycle - PR #575 by @tw2066
• restrict to read permission on github actions

Fix tool array in ToolCallMessage

More efficient tool search with fuzzy and tokenized keywords

Tool search inject system prompt to ensure the agent behave as expected

Introducing Tool Search

By default every time the provider is invoked all tools are loaded and transmitted to the backend LLM. Complex production agents connected to email, calendar, drive, CRM, and and multiple MCP servers can easily reach hundreds of tools, each carrying its name, description, parameter schema, and usage hints.

This release introduces the global middleware ToolSearchMiddleware that you can attach to your agent:

class MyAgent extends Agennt
{
    ...
    
    /**
     * Define the global middleware.
     */
    protected function globalMiddleware(): array
    {
        return [
            new ToolSearchMiddleware([
                MyCustomTool::make(),
                ...CalculatorToolkit::make()->tools()
                ...MCPConnector::make([...])->tools()
            ]),
        ];
    }
    
    /**
     * Provide core tools to the agent.
     */
    protected function tools(): array
    {
        return [
            // A list of core tools that the model always has available
            TavilySearchTool::make(...),
        ];
    }
}

Here is the full documentation: https://docs.neuron-ai.dev/agent/middleware#tool-search

• Fix OpenSearch vector store
• Add gemoni models that support structured output with tool calls - PR #576 by @tecbay

Added new Gemini models with support for structured output with tools

support reasoning content in Deepseek and Alibaba providers - PR #573 - by @tw2066

fix Gemini function call with custom tools - PR #574 by @marceloandrader

Custom Tool Call Tracking for Max Runs - PR #566 by @tryvin

class MyCustomTool extends Tool implements HasRunKey
{
    ...

    public function getRunKey(): string
    {
        return $this->name . ':' . json_encode($this->inputs);
    }
}

New Vector Stores

• MariaDBVectorStore: https://docs.neuron-ai.dev/rag/vector-store#mariadb
• WeaviateVectorStore: https://docs.neuron-ai.dev/rag/vector-store#weaviate

Add Alibaba dash scope model platform provider - PR #560 by @tw2066

Improve the Workflow Executor design

Introducing Parallel Branches

This release introduce the ability of the workflow component to run parallel branches: https://docs.neuron-ai.dev/workflow/loops-and-branches#parallel-branches

When you want to call the execution of multiple branches in parallel, you need to return the special event ParallelEvent from your node.

use NeuronAI\Workflow\Events\ParallelEvent;

class DocumentProcessing extends Node
{
    public function __invoke(StartEvent $event, WorkflowState $state): ParallelEvent
    {
        // Node logic here...
	
        // Finally return a ParallelEvent
        return new ParallelEvent([
            'text' => new TextProcessEvent(),
            'image' => new ImageProcessEvent(),
        ]);
    }
}

Several improvements and fixes to the AWS Bedrock provider - PR #562 by @vitaliiivanovspryker

Make Http clients implementations ready for extension - Fix #557 #558

• Fix Typesense vector store - #552
• Fix OpenAI Responses message mapper - Fix #556 merging PR #559 by @iztok

Fix Tavily search tool - PR #561 by @AlexTr

Fix #554

Fix tool content deserialization in chat history - Fix #550 Add options argument to GuzzleHttpClient - Fix #551

Improve components serialization to better support workflow interruption - PR #543 by @tryvin

Merged:

• PR #546 by @plusemon
• PR #540 by @viicslen
• PR #534 by @saithink

Fix #544 - get schema in SQL Tools

• Support Anthropic image as a file ID
• Fix Ollama usage reporting when streaming

Fix Mistral token usage reporting

fix eloquent chat history

• New Cohere embeddings provider
• Support OpenSearch 3.6.0 or higher

• Fix error handler in case MissingCallbackParameter
• Improve chat history trim for better performance

Chat History improvements

In the process of fixing a bug ( #523 ) we worked on a more efficient algorithm to manage the cut of the message history if it goes out of the context window. The intent was to minimize the context loss when cutting.

The context window cut must be considered the last resort to prevent fatal errors with provider APIs. Before reaching the limit of the context window you should use summarization to compact the context into a single message as a new starting point.

In order to handle all edge cases, the internal trimmer can identify a cutting point slightly less aggressive than the initially identified. To make sure the agent conversation stays in the limit, you should configure the context window limit in the agent chat history with a margin of 5%-10% from the actual limit of the underlying model.

If your model works with a 200K context window, you should instantiate your chat history with 190K for example.

Evaluation improvements

We introduced a couple of built-in rules for Ai as a judge assertions:

https://docs.neuron-ai.dev/agent/evaluation#ai-as-a-judge

Evaluation score tracking

Support Anthropic prompt cache

PR #482 by @hudhaifas

class MyAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Anthropic(
            key: 'ANTHROPIC_KEY',
            model: 'ANTHROPIC_MODEL'
        )->systemPromptBlocks([
            ['type' => 'text', 'text' => 'Static instructions...', 'cache_control' => ['type' => 'ephemeral']],
            ['type' => 'text', 'text' => 'Dynamic context...']
        ]);
    }
}