AgentOrchestrator

Agentic tool-use loop: alternates between asking an {@see LlmService} for the next step and executing any tool calls it requests via {@see McpClientService}, until the LLM returns a final response or {@see self::$maxSteps} is reached.

public function __construct(Milpa\AiGateway\LlmService $llm, Milpa\AiGateway\McpClientService $mcpClient, int $maxSteps = 20, ?Psr\Log\LoggerInterface $logger = null, ?Milpa\ToolRuntime\Rendering\RendererRegistry $rendererRegistry = null):

Parameters

public function getLastToolResult(): ?Milpa\ToolRuntime\ToolResult

Get the last ToolResult from tool execution. Used by ProcessTelegramMessageJob to build keyboard from metadata.

public function setToolContext(Milpa\ToolRuntime\Contracts\ToolContext $ctx): self

Set the tool context for channel-specific rendering.

Parameters

public function run(string $prompt, string $systemPrompt = 'You are a helpful assistant.', array $history = [], ?callable $onStep = null): string

Run the agent orchestrator loop.

Parameters