installResolver(); } /** * forParticipant() and continue() return a clone, and a closure bound in the * constructor keeps pointing at the original, whose conversation is always * null. Re-binding on clone is what makes the resolver follow the instance * that actually has the conversation. */ public function __clone(): void { $this->installResolver(); } /** * The conversation does not exist when instructions are first built, but it * does by the time a tool runs. Handing the workspace a resolver rather than * an id closes that window: without it, anything created on the very first * turn is written against no conversation and silently orphaned. */ private function installResolver(): void { $this->workspace->resolveIdUsing(fn (): ?string => $this->currentConversation()); } public function instructions(): Stringable|string { $this->syncWorkspace(); return $this->instructions->build(); } /** @return list */ public function tools(): iterable { $this->syncWorkspace(); return $this->registry->resolve(); } public function workspace(): Workspace { return $this->workspace; } /** * Keep the workspace pointed at whichever conversation is running. * * Continuing an older conversation replaces the id outright; the resolver * only fills a blank one, so a rebind still has to be explicit. */ private function syncWorkspace(): void { $conversationId = $this->currentConversation(); if ($conversationId && $conversationId !== $this->workspace->id()) { $this->workspace->bindTo($conversationId); } } }