zidane 2.0.1 → 2.1.1

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   defineSkill
-} from "./chunk-LVC7NQUZ.js";
+} from "./chunk-HJUB63VE.js";
 import {
   toolResultToText
 } from "./chunk-MYWDHD7C.js";
@@ -9,11 +9,11 @@ import {
   cerebras,
   openai,
   openrouter
-} from "./chunk-FRNFVKWW.js";
+} from "./chunk-CDRXC7A7.js";
 import {
   defineHarness,
   noTools
-} from "./chunk-OVQ4N64O.js";
+} from "./chunk-VUVLOTEY.js";
 import {
   createAgent,
   createInteractionTool,
@@ -23,7 +23,7 @@ import {
   createSpawnTool,
   glob,
   spawn
-} from "./chunk-PASFWG7S.js";
+} from "./chunk-AWDWJ2YJ.js";
 import {
   IMPLICITLY_ALLOWED_SKILL_TOOLS,
   buildCatalog,
@@ -42,25 +42,25 @@ import {
   validateSkillName,
   writeSkillToDisk,
   writeSkillsToDisk
-} from "./chunk-BCXXXJ3G.js";
+} from "./chunk-DCYJYM3E.js";
 import {
   createDockerContext,
   createProcessContext,
   createSandboxContext
-} from "./chunk-SZA4FKW5.js";
+} from "./chunk-2EQT4EHD.js";
 import {
   connectMcpServers,
   normalizeMcpBlocks,
   normalizeMcpServers,
   resultToString
-} from "./chunk-PJUUYBKF.js";
+} from "./chunk-IJORSHFI.js";
 import {
   createFileMapStore,
   createMemoryStore,
   createRemoteStore,
   createSession,
   loadSession
-} from "./chunk-VG2E6YK3.js";
+} from "./chunk-PMCQOMV4.js";
 import {
   OpenAICompatHttpError,
   autoDetectAndConvert,
@@ -71,7 +71,7 @@ import {
   openaiCompat,
   toAnthropic,
   toOpenAI
-} from "./chunk-LN4LLLHA.js";
+} from "./chunk-S3FCOMRI.js";
 import {
   AgentAbortedError,
   AgentContextExceededError,
@@ -80,7 +80,7 @@ import {
   CONTEXT_EXCEEDED_MESSAGE_PATTERNS,
   matchesContextExceeded,
   toTypedError
-} from "./chunk-7JTBBZ2U.js";
+} from "./chunk-LNN5UTS2.js";
 
 // src/tracing.ts
 function createTracingHooks(options) {

package/dist/mcp.d.ts

@@ -1,4 +1,4 @@
 import 'hookable';
-export { M as McpConnection, q as McpServerConfig, at as connectMcpServers, aG as normalizeMcpBlocks, aH as normalizeMcpServers, aL as resultToString } from './agent-D-ZFMbSd.js';
+export { M as McpConnection, q as McpServerConfig, at as connectMcpServers, aG as normalizeMcpBlocks, aH as normalizeMcpServers, aL as resultToString } from './agent-DFkSTVKm.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import './types-BpvTmawk.js';

package/dist/mcp.js

@@ -3,7 +3,7 @@ import {
   normalizeMcpBlocks,
   normalizeMcpServers,
   resultToString
-} from "./chunk-PJUUYBKF.js";
+} from "./chunk-IJORSHFI.js";
 export {
   connectMcpServers,
   normalizeMcpBlocks,

package/dist/providers.d.ts

@@ -1,4 +1,4 @@
-export { j as AnthropicParams, k as CerebrasParams, ai as OpenAICompatAuthHeader, aj as OpenAICompatHttpError, ak as OpenAICompatParams, s as OpenAIParams, t as OpenRouterParams, x as Provider, y as ProviderCapabilities, V as StreamCallbacks, X as StreamOptions, Z as ToolCall, a3 as ToolResult, a7 as ToolSpec, a9 as TurnResult, ap as anthropic, ar as cerebras, as as classifyOpenAICompatError, aE as mapOAIFinishReason, aI as openai, aJ as openaiCompat, aK as openrouter } from './agent-D-ZFMbSd.js';
+export { j as AnthropicParams, k as CerebrasParams, ai as OpenAICompatAuthHeader, aj as OpenAICompatHttpError, ak as OpenAICompatParams, s as OpenAIParams, t as OpenRouterParams, x as Provider, y as ProviderCapabilities, V as StreamCallbacks, X as StreamOptions, Z as ToolCall, a3 as ToolResult, a7 as ToolSpec, a9 as TurnResult, ap as anthropic, ar as cerebras, as as classifyOpenAICompatError, aE as mapOAIFinishReason, aI as openai, aJ as openaiCompat, aK as openrouter } from './agent-DFkSTVKm.js';
 import 'hookable';
 import './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/providers.js

@@ -3,14 +3,14 @@ import {
   cerebras,
   openai,
   openrouter
-} from "./chunk-FRNFVKWW.js";
+} from "./chunk-CDRXC7A7.js";
 import {
   OpenAICompatHttpError,
   classifyOpenAICompatError,
   mapOAIFinishReason,
   openaiCompat
-} from "./chunk-LN4LLLHA.js";
-import "./chunk-7JTBBZ2U.js";
+} from "./chunk-S3FCOMRI.js";
+import "./chunk-LNN5UTS2.js";
 export {
   OpenAICompatHttpError,
   anthropic,

package/dist/session/sqlite.d.ts

@@ -1,4 +1,4 @@
-import { K as SessionStore } from '../agent-D-ZFMbSd.js';
+import { K as SessionStore } from '../agent-DFkSTVKm.js';
 import 'hookable';
 import '../types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-export { o as CreateSessionOptions, ag as FileMapAdapter, ah as FileMapStoreOptions, R as RemoteStoreOptions, S as Session, B as SessionContentBlock, D as SessionData, G as SessionMessage, J as SessionRun, K as SessionStore, L as SessionTurn, aq as autoDetectAndConvert, av as createFileMapStore, aw as createMemoryStore, ax as createRemoteStore, ay as createSession, aB as fromAnthropic, aC as fromOpenAI, aD as loadSession, aM as toAnthropic, aN as toOpenAI } from './agent-D-ZFMbSd.js';
+export { o as CreateSessionOptions, ag as FileMapAdapter, ah as FileMapStoreOptions, R as RemoteStoreOptions, S as Session, B as SessionContentBlock, D as SessionData, G as SessionMessage, J as SessionRun, K as SessionStore, L as SessionTurn, aq as autoDetectAndConvert, av as createFileMapStore, aw as createMemoryStore, ax as createRemoteStore, ay as createSession, aB as fromAnthropic, aC as fromOpenAI, aD as loadSession, aM as toAnthropic, aN as toOpenAI } from './agent-DFkSTVKm.js';
 import 'hookable';
 import './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/session.js

@@ -4,15 +4,15 @@ import {
   createRemoteStore,
   createSession,
   loadSession
-} from "./chunk-VG2E6YK3.js";
+} from "./chunk-PMCQOMV4.js";
 import {
   autoDetectAndConvert,
   fromAnthropic,
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-LN4LLLHA.js";
-import "./chunk-7JTBBZ2U.js";
+} from "./chunk-S3FCOMRI.js";
+import "./chunk-LNN5UTS2.js";
 export {
   autoDetectAndConvert,
   createFileMapStore,

package/dist/{skills-use-C4KFVla0.d.ts → skills-use-DWprxufr.d.ts}

@@ -1,4 +1,4 @@
-import { $ as ToolDef, N as SkillConfig, al as SkillActivationState, d as AgentHooks } from './agent-D-ZFMbSd.js';
+import { $ as ToolDef, N as SkillConfig, al as SkillActivationState, d as AgentHooks } from './agent-DFkSTVKm.js';
 import { Hookable } from 'hookable';
 
 declare const glob: ToolDef;

package/dist/skills.d.ts

@@ -1,5 +1,5 @@
-import { d as AgentHooks, al as SkillActivationState, N as SkillConfig, ao as SkillSource, an as SkillDiagnostic, T as SkillsConfig } from './agent-D-ZFMbSd.js';
-export { ad as ActivationVia, ae as ActiveSkill, af as DeactivationReason, am as SkillActivationStateOptions, Q as SkillResource, az as createSkillActivationState } from './agent-D-ZFMbSd.js';
+import { d as AgentHooks, al as SkillActivationState, N as SkillConfig, ao as SkillSource, an as SkillDiagnostic, T as SkillsConfig } from './agent-DFkSTVKm.js';
+export { ad as ActivationVia, ae as ActiveSkill, af as DeactivationReason, am as SkillActivationStateOptions, Q as SkillResource, az as createSkillActivationState } from './agent-DFkSTVKm.js';
 import { Hookable } from 'hookable';
 import { b as ExecutionContext, c as ExecutionHandle } from './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/skills.js

@@ -1,6 +1,6 @@
 import {
   defineSkill
-} from "./chunk-LVC7NQUZ.js";
+} from "./chunk-HJUB63VE.js";
 import {
   IMPLICITLY_ALLOWED_SKILL_TOOLS,
   buildCatalog,
@@ -22,8 +22,8 @@ import {
   validateSkillName,
   writeSkillToDisk,
   writeSkillsToDisk
-} from "./chunk-BCXXXJ3G.js";
-import "./chunk-7JTBBZ2U.js";
+} from "./chunk-DCYJYM3E.js";
+import "./chunk-LNN5UTS2.js";
 export {
   IMPLICITLY_ALLOWED_SKILL_TOOLS,
   buildCatalog,

package/dist/spawn-CW5GEK-T.d.ts

@@ -0,0 +1,150 @@
+import { _ as ToolContext, $ as ToolDef, p as HarnessConfig, h as AgentStats, l as ChildRunStats } from './agent-DFkSTVKm.js';
+
+/**
+ * Interaction tool — lets the agent request structured input from the outside world.
+ *
+ * Not included in any harness by default. Add it explicitly:
+ *
+ *   import { createInteractionTool } from 'zidane'
+ *
+ *   const askUser = createInteractionTool({
+ *     schema: { type: 'object', properties: { question: { type: 'string' } }, required: ['question'] },
+ *     onRequest: async (payload) => {
+ *       const answer = await promptUser(payload.question)
+ *       return { answer }
+ *     },
+ *   })
+ *
+ *   const harness = defineHarness({ name: 'interactive', tools: { ...basicTools, ask_user: askUser } })
+ */
+
+interface InteractionToolOptions {
+    /** JSON Schema for the request payload the model sends */
+    schema: Record<string, unknown>;
+    /** Tool name (default: 'interaction') */
+    name?: string;
+    /** Tool description shown to the model */
+    description?: string;
+    /** Called when the model invokes this tool. Receives the validated payload and tool context, returns data for the model. */
+    onRequest: (payload: Record<string, unknown>, ctx: ToolContext) => Promise<Record<string, unknown> | string>;
+}
+/**
+ * Create an interaction tool that lets the agent request structured input.
+ *
+ * The model calls this tool with a payload matching the schema.
+ * `onRequest` is called with the payload and should return the response
+ * (string or object) that gets sent back to the model as the tool result.
+ */
+declare function createInteractionTool(options: InteractionToolOptions): ToolDef;
+
+/**
+ * Spawn tool — create sub-agents from a parent agent.
+ *
+ * A configurable factory that reads provider + harness from ToolContext.
+ *
+ * Usage — default (stateless, safe across parent agents):
+ * ```ts
+ * import { spawn } from 'zidane'
+ * const harness = defineHarness({ name: 'orchestrator', tools: { ...basicTools, spawn } })
+ * ```
+ *
+ * Usage — with shared state (telemetry, lifecycle callbacks):
+ * ```ts
+ * const tool = createSpawnTool({ maxConcurrent: 5, onComplete })
+ * ```
+ *
+ * Key guarantees:
+ * - **Depth-capped** to `maxDepth` (default 3) to prevent infinite recursion.
+ * - **Concurrency slot is reserved synchronously** before any `await`, so a
+ *   parent running tools in parallel cannot exceed `maxConcurrent`.
+ * - **Pre-aborted signals short-circuit** without paying agent-spawn cost.
+ * - **Abort / timeout / error are surfaced distinctly** in the returned text
+ *   and via `ChildRunStats.status` on `spawn:complete`.
+ * - **`agent.destroy()` errors never mask the original run error** (captured
+ *   and emitted via `spawn:error` but the primary error wins).
+ * - **Child hooks bubble** to the parent as `child:*` events when
+ *   `forwardHooks` is set (default `true`).
+ * - **Persistence** via `persist: true` — child runs get appended to the
+ *   parent's session with `parentRunId` wired, so the run tree is
+ *   reconstructible from a stored `SessionData`.
+ */
+
+interface ChildAgent {
+    id: string;
+    task: string;
+    startedAt: number;
+    /** Subagent depth — 1 for a direct child of a top-level agent. */
+    depth: number;
+}
+interface SpawnToolState {
+    /** Currently running children. */
+    readonly children: ReadonlyMap<string, ChildAgent>;
+    /** Aggregated stats from all completed children (returns a copy). */
+    readonly totalChildStats: Readonly<AgentStats>;
+}
+interface SpawnToolOptions {
+    /** Maximum concurrent sub-agents (default: 3). */
+    maxConcurrent?: number;
+    /**
+     * Maximum subagent depth. 0 disables spawning entirely; 1 allows top-level
+     * spawns but forbids grandchildren; 3 (default) allows three levels of
+     * recursion — enough for most orchestration patterns, a sharp ceiling
+     * against runaway loops.
+     */
+    maxDepth?: number;
+    /** Child model override. */
+    model?: string;
+    /** Child system prompt override. Per-spawn `input.system` takes precedence. */
+    system?: string;
+    /** Child thinking level. */
+    thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
+    /** Harness override for children. Defaults to the parent's harness. */
+    harness?: HarnessConfig;
+    /**
+     * Per-child timeout, in milliseconds. When the child exceeds it the spawn
+     * tool returns a timeout marker, fires `spawn:error`, and destroys the
+     * child agent. Default: none.
+     */
+    timeoutMs?: number;
+    /**
+     * When `true` and the parent has a session, the child reuses the parent's
+     * session — child turns are appended with the child's own `runId`, and the
+     * resulting `SessionRun` carries `parentRunId` so the tree is
+     * reconstructible. Default: `false` (child is in-memory only).
+     */
+    persist?: boolean;
+    /**
+     * Forward a curated subset of child hook events (`stream:*`, `tool:*`,
+     * `turn:after`) onto the parent's hook bus as `child:*` events. Default:
+     * `true`. Grandchildren bubble through their child transparently.
+     */
+    forwardHooks?: boolean;
+    /** Called when a child agent starts. */
+    onSpawn?: (child: ChildAgent) => void;
+    /** Called when a child agent completes (success, abort, timeout, or error). */
+    onComplete?: (child: ChildAgent, stats: AgentStats, status: NonNullable<ChildRunStats['status']>) => void;
+}
+/**
+ * Create a configured spawn tool.
+ *
+ * State (`children`, `totalChildStats`, counters, active count) is scoped to
+ * the returned instance. Multiple parent agents using the same instance will
+ * share counters + stats + concurrency slots — call `createSpawnTool()` per
+ * agent (or use the stateless default `spawn`) to keep them isolated.
+ */
+declare function createSpawnTool(options?: SpawnToolOptions): ToolDef & SpawnToolState;
+/**
+ * Default spawn tool.
+ *
+ * Historically this was a module-scoped `createSpawnTool()` instance shared
+ * across every agent using `basic` — which meant `maxConcurrent`, `children`,
+ * and `totalChildStats` leaked between unrelated runs. The shared-state
+ * surface is preserved for backward compat: the spec + execute still work
+ * standalone.
+ *
+ * Prefer calling `createSpawnTool()` explicitly when you care about
+ * telemetry isolation between agents.
+ */
+declare const spawn: ToolDef & SpawnToolState;
+
+export { type ChildAgent as C, type InteractionToolOptions as I, type SpawnToolOptions as S, type SpawnToolState as a, createSpawnTool as b, createInteractionTool as c, spawn as s };

package/dist/tools.d.ts

@@ -1,6 +1,6 @@
-export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, g as glob } from './skills-use-C4KFVla0.js';
-export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, c as createInteractionTool, b as createSpawnTool, s as spawn } from './spawn-RoqpjYLZ.js';
-import { $ as ToolDef } from './agent-D-ZFMbSd.js';
+export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, g as glob } from './skills-use-DWprxufr.js';
+export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, c as createInteractionTool, b as createSpawnTool, s as spawn } from './spawn-CW5GEK-T.js';
+import { $ as ToolDef } from './agent-DFkSTVKm.js';
 export { V as ValidationResult, v as validateToolArgs } from './validation-DOY_k7lW.js';
 import 'hookable';
 import './types-BpvTmawk.js';

package/dist/tools.js

@@ -11,11 +11,11 @@ import {
   spawn,
   validateToolArgs,
   writeFile
-} from "./chunk-PASFWG7S.js";
-import "./chunk-BCXXXJ3G.js";
-import "./chunk-SZA4FKW5.js";
-import "./chunk-PJUUYBKF.js";
-import "./chunk-7JTBBZ2U.js";
+} from "./chunk-AWDWJ2YJ.js";
+import "./chunk-DCYJYM3E.js";
+import "./chunk-2EQT4EHD.js";
+import "./chunk-IJORSHFI.js";
+import "./chunk-LNN5UTS2.js";
 export {
   createInteractionTool,
   createSkillsReadTool,

package/dist/types.d.ts

@@ -1,7 +1,7 @@
-export { A as Agent, a as AgentAbortedError, b as AgentBehavior, c as AgentContextExceededError, d as AgentHooks, e as AgentOptions, f as AgentProviderError, g as AgentRunOptions, h as AgentStats, i as AgentToolNotAllowedError, j as AnthropicParams, C as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, k as CerebrasParams, l as ChildRunStats, m as ClassifiedError, n as ClassifiedErrorKind, o as CreateSessionOptions, H as Harness, p as HarnessConfig, I as ImageContent, M as McpConnection, q as McpServerConfig, r as McpToolHookContext, O as OAuthRefreshHookContext, s as OpenAIParams, t as OpenRouterParams, P as PromptDocumentPart, u as PromptImagePart, v as PromptPart, w as PromptTextPart, x as Provider, y as ProviderCapabilities, R as RemoteStoreOptions, z as RunHookMap, S as Session, B as SessionContentBlock, D as SessionData, E as SessionEndStatus, F as SessionHookContext, G as SessionMessage, J as SessionRun, K as SessionStore, L as SessionTurn, N as SkillConfig, Q as SkillResource, T as SkillsConfig, U as SpawnHookContext, V as StreamCallbacks, W as StreamHookContext, X as StreamOptions, Y as ThinkingLevel, Z as ToolCall, _ as ToolContext, $ as ToolDef, a0 as ToolExecutionMode, a1 as ToolHookContext, a2 as ToolMap, a3 as ToolResult, a4 as ToolResultContent, a5 as ToolResultImageContent, a6 as ToolResultTextContent, a7 as ToolSpec, a8 as TurnFinishReason, a9 as TurnResult, aa as TurnUsage, ab as matchesContextExceeded, ac as toolResultToText } from './agent-D-ZFMbSd.js';
+export { A as Agent, a as AgentAbortedError, b as AgentBehavior, c as AgentContextExceededError, d as AgentHooks, e as AgentOptions, f as AgentProviderError, g as AgentRunOptions, h as AgentStats, i as AgentToolNotAllowedError, j as AnthropicParams, C as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, k as CerebrasParams, l as ChildRunStats, m as ClassifiedError, n as ClassifiedErrorKind, o as CreateSessionOptions, H as Harness, p as HarnessConfig, I as ImageContent, M as McpConnection, q as McpServerConfig, r as McpToolHookContext, O as OAuthRefreshHookContext, s as OpenAIParams, t as OpenRouterParams, P as PromptDocumentPart, u as PromptImagePart, v as PromptPart, w as PromptTextPart, x as Provider, y as ProviderCapabilities, R as RemoteStoreOptions, z as RunHookMap, S as Session, B as SessionContentBlock, D as SessionData, E as SessionEndStatus, F as SessionHookContext, G as SessionMessage, J as SessionRun, K as SessionStore, L as SessionTurn, N as SkillConfig, Q as SkillResource, T as SkillsConfig, U as SpawnHookContext, V as StreamCallbacks, W as StreamHookContext, X as StreamOptions, Y as ThinkingLevel, Z as ToolCall, _ as ToolContext, $ as ToolDef, a0 as ToolExecutionMode, a1 as ToolHookContext, a2 as ToolMap, a3 as ToolResult, a4 as ToolResultContent, a5 as ToolResultImageContent, a6 as ToolResultTextContent, a7 as ToolSpec, a8 as TurnFinishReason, a9 as TurnResult, aa as TurnUsage, ab as matchesContextExceeded, ac as toolResultToText } from './agent-DFkSTVKm.js';
 export { C as ContextCapabilities, a as ContextType, E as ExecResult, b as ExecutionContext, c as ExecutionHandle, S as SpawnConfig } from './types-BpvTmawk.js';
 export { S as SandboxProvider } from './sandbox-CW72eLDP.js';
-export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState } from './spawn-RoqpjYLZ.js';
+export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState } from './spawn-CW5GEK-T.js';
 export { V as ValidationResult } from './validation-DOY_k7lW.js';
 import 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/types.js

@@ -8,7 +8,7 @@ import {
   AgentToolNotAllowedError,
   CONTEXT_EXCEEDED_MESSAGE_PATTERNS,
   matchesContextExceeded
-} from "./chunk-7JTBBZ2U.js";
+} from "./chunk-LNN5UTS2.js";
 export {
   AgentAbortedError,
   AgentContextExceededError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,
@@ -90,8 +90,8 @@
     }
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.88.0",
     "@antfu/eslint-config": "^8.1.1",
+    "@anthropic-ai/sdk": "^0.88.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@types/bun": "^1.3.12",
     "@types/dockerode": "^4.0.1",

package/dist/spawn-RoqpjYLZ.d.ts

@@ -1,99 +0,0 @@
-import { _ as ToolContext, $ as ToolDef, p as HarnessConfig, h as AgentStats } from './agent-D-ZFMbSd.js';
-
-/**
- * Interaction tool — lets the agent request structured input from the outside world.
- *
- * Not included in any harness by default. Add it explicitly:
- *
- *   import { createInteractionTool } from 'zidane'
- *
- *   const askUser = createInteractionTool({
- *     schema: { type: 'object', properties: { question: { type: 'string' } }, required: ['question'] },
- *     onRequest: async (payload) => {
- *       const answer = await promptUser(payload.question)
- *       return { answer }
- *     },
- *   })
- *
- *   const harness = defineHarness({ name: 'interactive', tools: { ...basicTools, ask_user: askUser } })
- */
-
-interface InteractionToolOptions {
-    /** JSON Schema for the request payload the model sends */
-    schema: Record<string, unknown>;
-    /** Tool name (default: 'interaction') */
-    name?: string;
-    /** Tool description shown to the model */
-    description?: string;
-    /** Called when the model invokes this tool. Receives the validated payload and tool context, returns data for the model. */
-    onRequest: (payload: Record<string, unknown>, ctx: ToolContext) => Promise<Record<string, unknown> | string>;
-}
-/**
- * Create an interaction tool that lets the agent request structured input.
- *
- * The model calls this tool with a payload matching the schema.
- * `onRequest` is called with the payload and should return the response
- * (string or object) that gets sent back to the model as the tool result.
- */
-declare function createInteractionTool(options: InteractionToolOptions): ToolDef;
-
-/**
- * Spawn tool — create sub-agents from a parent agent.
- *
- * A static tool that reads provider and harness from ToolContext.
- * Just add it to any harness's tools — no factory needed.
- *
- * Usage:
- *   import { spawn } from 'zidane'
- *
- *   const harness = defineHarness({
- *     name: 'orchestrator',
- *     tools: { ...basicTools, spawn },
- *   })
- */
-
-interface ChildAgent {
-    id: string;
-    task: string;
-    startedAt: number;
-}
-interface SpawnToolState {
-    /** Currently running children */
-    readonly children: ReadonlyMap<string, ChildAgent>;
-    /** Aggregated stats from all completed children (returns a copy) */
-    readonly totalChildStats: Readonly<AgentStats>;
-}
-interface SpawnToolOptions {
-    /** Maximum concurrent sub-agents (default: 3) */
-    maxConcurrent?: number;
-    /** Model override for child agents */
-    model?: string;
-    /** System prompt for child agents */
-    system?: string;
-    /** Thinking level for child agents */
-    thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
-    /** Override harness for children (defaults to parent's harness from ToolContext) */
-    harness?: HarnessConfig;
-    /** Called when a child agent starts */
-    onSpawn?: (child: ChildAgent) => void;
-    /** Called when a child agent completes */
-    onComplete?: (child: ChildAgent, stats: AgentStats) => void;
-}
-/**
- * Create a configured spawn tool with custom options.
- *
- * For most cases, use the static `spawn` export directly.
- * Use this factory when you need custom concurrency limits,
- * model overrides, or lifecycle callbacks.
- */
-declare function createSpawnTool(options?: SpawnToolOptions): ToolDef & SpawnToolState;
-/**
- * Static spawn tool — add directly to any harness.
- *
- * Reads provider and harness from ToolContext at execution time.
- * Children get the same harness as the parent (including spawn),
- * so sub-agents can spawn their own children.
- */
-declare const spawn: ToolDef & SpawnToolState;
-
-export { type ChildAgent as C, type InteractionToolOptions as I, type SpawnToolOptions as S, type SpawnToolState as a, createSpawnTool as b, createInteractionTool as c, spawn as s };