AgentZ

ZIO wrapper for Agent.

Lifts every Result[AgentState] return value into ZIO[Any, LLMError, AgentState]. The underlying blocking Agent methods are shifted to ZIO's blocking thread pool and run interruptibly: interrupting the fiber interrupts the running agent loop.

Intentionally a thin wrapper: run does not expose handoffs, and continueConversation does not expose contextWindowConfig; the underlying Agent defaults apply. Tracing, debug logging and the trace log path are still available through the context parameter. Use Agent directly (inside ZIO.attemptBlockingInterrupt) when you need handoffs or context-window pruning.

Tool calls are not a failure of the effect: Agent hands a call with invalid arguments back to the model as a structured error tool result and the run continues. The experimental schema-validated AgentTool contract and the graph runtime (org.llm4s.agent.graph) are not wrapped here.