zidane 1.6.0 → 1.6.4

package/README.md

@@ -34,16 +34,16 @@ All options on `createAgent`:
 ```ts
 createAgent({
   provider,                          // required: LLM provider
+  session,                           // session for persistence
   harness: basic,                    // tool set (default: noTools)
   behavior: {                        // agent-level defaults
-    toolExecution: 'sequential',     // or 'parallel'
+    toolExecution: 'parallel',       // or 'sequential' (default: parallel)
     maxTurns: 50,                    // max loop iterations
-    maxTokens: 16384,               // max tokens per LLM response
-    thinkingBudget: 10240,          // exact thinking token budget
+    maxTokens: 16384,                // max tokens per LLM response
+    thinkingBudget: 10240,           // exact thinking token budget
   },
   execution: createProcessContext(), // where tools run
   mcpServers: [],                    // MCP tool servers
-  session,                           // session for persistence
   skills: {},                        // skills configuration
 })
 ```
@@ -52,7 +52,7 @@ All options on `agent.run()`:
 
 ```ts
 await agent.run({
-  prompt: 'your task',       // required
+  prompt: 'your task',       // optional when session has existing turns
   model: 'claude-opus-4-6',
   system: 'be concise',
   thinking: 'medium',        // off | minimal | low | medium | high
@@ -67,6 +67,8 @@ await agent.run({
 })
 ```
 
+`prompt` is optional when a session with existing turns is provided — the agent resumes from the last turn. This supports apps where the user message is persisted to the session before the agent runs (e.g. WebSocket → session → queue → agent).
+
 Precedence: `run.behavior` > `agent.behavior` > `harness.behavior` > hardcoded defaults.
 
 ## CLI
@@ -166,10 +168,10 @@ Extended reasoning with named levels or exact token budgets.
 await agent.run({ prompt: 'solve this', thinking: 'high' })
 
 // Exact budget (overrides level default)
-await agent.run({ prompt: 'solve this', thinking: 'high', thinkingBudget: 50000 })
+await agent.run({ prompt: 'solve this', thinking: 'high', behavior: { thinkingBudget: 50000 } })
 
 // Agent-level default
-const agent = createAgent({ provider, harness, thinkingBudget: 16384 })
+const agent = createAgent({ provider, harness, behavior: { thinkingBudget: 16384 } })
 ```
 
 ## Hooks
@@ -184,12 +186,19 @@ agent.hooks.hook('turn:before', (ctx) => {
 })
 
 agent.hooks.hook('turn:after', (ctx) => {
-  // ctx.turn, ctx.turnId, ctx.usage { input, output }
+  // ctx.turn, ctx.turnId, ctx.usage, ctx.message (full SessionTurn)
   // Always fires — even if the provider throws mid-stream
+  // Turn is guaranteed to be in agent.turns before this fires
+})
+
+agent.hooks.hook('usage', (ctx) => {
+  // ctx.turn, ctx.turnId, ctx.usage (per-turn)
+  // ctx.totalIn, ctx.totalOut (running totals)
 })
 
 agent.hooks.hook('agent:done', (ctx) => {
   // ctx.totalIn, ctx.totalOut, ctx.turns, ctx.elapsed, ctx.children?
+  // ctx.output — structured output (when behavior.schema is set)
   // Fires on all exit paths: completion, maxTurns, and abort
 })
 ```
@@ -198,11 +207,11 @@ agent.hooks.hook('agent:done', (ctx) => {
 
 ```ts
 agent.hooks.hook('stream:text', (ctx) => {
-  // ctx.delta, ctx.text, ctx.turnId, ctx.blockIndex
+  // ctx.delta, ctx.text, ctx.turnId
 })
 
 agent.hooks.hook('stream:end', (ctx) => {
-  // ctx.text (final), ctx.turnId, ctx.blockIndex
+  // ctx.text (final), ctx.turnId
   // Only fires when there is text content (not on tool-only turns)
 })
 ```
@@ -290,6 +299,34 @@ const harness = defineHarness({
 
 Children inherit the parent's harness and can spawn their own children.
 
+## Interaction Tool
+
+Let the agent pause and request structured input from the outside world. Not included in any harness by default.
+
+```ts
+import { createInteractionTool, defineHarness, basicTools } from 'zidane'
+
+const askUser = createInteractionTool({
+  name: 'ask_user',
+  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 },
+})
+```
+
+`onRequest` can be async — the agent waits for the response. Return a string or object (objects are JSON-stringified).
+
 ## Sessions
 
 Sessions give an agent persistent turn history and run metadata across calls.
@@ -333,7 +370,7 @@ if (session) {
 
 ```ts
 agent.hooks.hook('session:start', (ctx) => { /* ctx.sessionId, ctx.runId, ctx.prompt */ })
-agent.hooks.hook('session:end', (ctx) => { /* ctx.sessionId, ctx.runId, ctx.status */ })
+agent.hooks.hook('session:end', (ctx) => { /* ctx.sessionId, ctx.runId, ctx.status, ctx.turnRange */ })
 agent.hooks.hook('session:turns', (ctx) => { /* ctx.sessionId, ctx.count */ })
 ```
 
@@ -453,7 +490,7 @@ const agent = createAgent({
 
 ```ts
 agent.isRunning           // is a run in progress?
-agent.messages            // conversation history
+agent.turns               // conversation history (SessionTurn[])
 agent.abort()             // cancel the current run
 agent.reset()             // clear messages and queues
 await agent.destroy()     // clean up context + MCP connections
@@ -484,6 +521,45 @@ Converters for external interop:
 import { fromAnthropic, toAnthropic, fromOpenAI, toOpenAI, autoDetectAndConvert } from 'zidane'
 ```
 
+## Structured Output
+
+Force the agent's final response to match a JSON Schema via provider-level tool forcing.
+
+```ts
+const stats = await agent.run({
+  prompt: 'Extract the entities',
+  behavior: {
+    schema: {
+      type: 'object',
+      properties: { name: { type: 'string' }, age: { type: 'number' } },
+      required: ['name', 'age'],
+    },
+  },
+})
+
+console.log(stats.output) // { name: 'Alice', age: 30 }
+```
+
+The `output` hook fires when structured output is extracted:
+
+```ts
+agent.hooks.hook('output', (ctx) => {
+  // ctx.output — the parsed JSON matching the schema
+  // ctx.schema — the schema that was enforced
+})
+```
+
+### Zod v4 integration
+
+Use `zodToJsonSchema` to normalize `z.toJsonSchema()` output for tool schemas:
+
+```ts
+import { z } from 'zod'
+import { zodToJsonSchema } from 'zidane'
+
+const schema = zodToJsonSchema(z.toJsonSchema(z.object({ name: z.string() })))
+```
+
 ## Usage Tracking
 
 ```ts
@@ -492,13 +568,21 @@ stats.turnUsage   // TurnUsage[] — per-turn { input, output, cacheCreation?, c
 stats.cost        // total USD cost (if reported by provider)
 ```
 
+## Types
+
+All types are available from `zidane/types`:
+
+```ts
+import type { Agent, SessionTurn, TurnUsage, Provider, ToolDef } from 'zidane/types'
+```
+
 ## Testing
 
 ```bash
 bun test
 ```
 
-430+ tests with mock provider and execution context. No API keys or Docker needed.
+474+ tests with mock provider and execution context. No API keys or Docker needed.
 
 ## License
 

package/dist/{agent-DVvuhEN-.d.ts → agent-CPOBJlcn.d.ts}

@@ -1,5 +1,5 @@
 import { Hookable } from 'hookable';
-import { b as ExecutionContext, c as ExecutionHandle, e as SkillsConfig, S as SkillConfig } from './types-CyRzBgm0.js';
+import { b as ExecutionContext, c as ExecutionHandle, e as SkillsConfig, S as SkillConfig } from './types-CKXAp41h.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 
 /**
@@ -83,7 +83,8 @@ interface SessionTurn {
 }
 interface AgentRunOptions {
     model?: string;
-    prompt: string;
+    /** User prompt. Optional when resuming a session with existing turns. */
+    prompt?: string;
     system?: string;
     thinking?: ThinkingLevel;
     images?: ImageContent[];
@@ -150,7 +151,7 @@ declare function openrouter(params?: OpenRouterParams): Provider;
 interface ToolSpec {
     name: string;
     description: string;
-    input_schema: Record<string, unknown>;
+    inputSchema: Record<string, unknown>;
 }
 interface ToolCall {
     id: string;
@@ -433,7 +434,7 @@ interface Session {
     /** Arbitrary metadata */
     readonly metadata: Record<string, unknown>;
     /** Start tracking a new run */
-    startRun: (runId: string, prompt: string) => void;
+    startRun: (runId: string, prompt?: string) => void;
     /** Mark a run as completed */
     completeRun: (runId: string, stats: {
         turns: number;
@@ -507,12 +508,10 @@ interface AgentHooks {
         delta: string;
         text: string;
         turnId: string;
-        blockIndex: number;
     }) => void;
     'stream:end': (ctx: {
         text: string;
         turnId: string;
-        blockIndex: number;
     }) => void;
     'tool:before': (ctx: {
         name: string;

package/dist/{chunk-3K5D27BF.js → chunk-4C6Y56CC.js}

@@ -229,10 +229,9 @@ async function parseSkillFile(filePath) {
     config.allowedTools = frontmatter["allowed-tools"].split(WHITESPACE_SPLIT_RE);
   if (frontmatter.model)
     config.model = frontmatter.model;
-  if (frontmatter.thinking)
-    config.thinking = frontmatter.thinking;
-  if (frontmatter.effort)
-    config.thinking = frontmatter.effort;
+  const thinkingValue = frontmatter.thinking ?? frontmatter.effort;
+  if (thinkingValue)
+    config.thinking = thinkingValue;
   if (frontmatter.paths) {
     const raw = frontmatter.paths;
     config.paths = raw.split(COMMA_OR_SPACE_RE).filter(Boolean);

package/dist/{chunk-7V33E7LT.js → chunk-BDBQ5MIB.js}

@@ -4,7 +4,7 @@ import {
   shell,
   spawn,
   writeFile
-} from "./chunk-VRAZJES3.js";
+} from "./chunk-KWNFSVVE.js";
 
 // src/harnesses/basic.ts
 var basicTools = { shell, readFile, writeFile, listFiles };

package/dist/{chunk-VRAZJES3.js → chunk-KWNFSVVE.js}

@@ -1,19 +1,36 @@
 import {
   connectMcpServers
-} from "./chunk-YTZOORAP.js";
+} from "./chunk-NNMWWSBY.js";
 import {
   buildCatalog,
   interpolateShellCommands,
   mergeSkillsConfig,
   resolveSkills
-} from "./chunk-3K5D27BF.js";
+} from "./chunk-4C6Y56CC.js";
+
+// src/tools/interaction.ts
+function createInteractionTool(options) {
+  const name = options.name ?? "interaction";
+  const description = options.description ?? "Request structured input from the user or external system.";
+  return {
+    spec: {
+      name,
+      description,
+      inputSchema: options.schema
+    },
+    async execute(input) {
+      const result = await options.onRequest(input);
+      return typeof result === "string" ? result : JSON.stringify(result);
+    }
+  };
+}
 
 // src/tools/list-files.ts
 var listFiles = {
   spec: {
     name: "list_files",
     description: "List files and directories at the given path (relative to project root).",
-    input_schema: {
+    inputSchema: {
       type: "object",
       properties: {
         path: { type: "string", description: 'Relative directory path (default: ".")' }
@@ -36,7 +53,7 @@ var readFile = {
   spec: {
     name: "read_file",
     description: "Read the contents of a file at the given path (relative to project root).",
-    input_schema: {
+    inputSchema: {
       type: "object",
       properties: {
         path: { type: "string", description: "Relative file path" }
@@ -58,7 +75,7 @@ var shell = {
   spec: {
     name: "shell",
     description: "Execute a shell command and return stdout+stderr. Runs in the project root.",
-    input_schema: {
+    inputSchema: {
       type: "object",
       properties: {
         command: { type: "string", description: "The shell command to run" }
@@ -403,7 +420,6 @@ async function executeTurn(ctx, turn) {
   await ctx.hooks.callHook("context:transform", { messages });
   await ctx.hooks.callHook("turn:before", { turn, turnId, options: streamOptions });
   let currentText = "";
-  let blockIndex = 0;
   let result;
   try {
     result = await ctx.provider.stream(
@@ -411,26 +427,26 @@ async function executeTurn(ctx, turn) {
       {
         onText(delta) {
           currentText += delta;
-          ctx.hooks.callHook("stream:text", { delta, text: currentText, turnId, blockIndex });
+          ctx.hooks.callHook("stream:text", { delta, text: currentText, turnId });
         }
       }
     );
   } catch (err) {
+    const errorUsage = { input: 0, output: 0 };
     const errorTurn = {
       id: turnId,
       runId: ctx.runId,
       role: "assistant",
       content: currentText ? [{ type: "text", text: currentText }] : [],
-      usage: { input: 0, output: 0 },
+      usage: errorUsage,
       createdAt: Date.now()
     };
     ctx.turns.push(errorTurn);
-    await ctx.hooks.callHook("turn:after", { turn, turnId, usage: errorTurn.usage, message: errorTurn });
+    await ctx.hooks.callHook("turn:after", { turn, turnId, usage: errorUsage, message: errorTurn });
     throw err;
   }
   if (currentText) {
-    await ctx.hooks.callHook("stream:end", { text: currentText, turnId, blockIndex });
-    blockIndex++;
+    await ctx.hooks.callHook("stream:end", { text: currentText, turnId });
   }
   const assistantTurn = {
     id: turnId,
@@ -447,7 +463,7 @@ async function executeTurn(ctx, turn) {
       const outputSpec = {
         name: "__output__",
         description: "Return the final structured output matching the required schema.",
-        input_schema: ctx.schema
+        inputSchema: ctx.schema
       };
       const schemaResult = await ctx.provider.stream(
         {
@@ -503,16 +519,16 @@ async function executeSingleTool(ctx, call) {
   const gateCtx = { name: call.name, input: call.input, block: false, reason: "Tool execution was blocked" };
   await ctx.hooks.callHook("tool:gate", gateCtx);
   if (gateCtx.block) {
-    return { result: { id: call.id, content: `Blocked: ${gateCtx.reason}` }, steered: false };
+    return { result: { id: call.id, content: `Blocked: ${gateCtx.reason}` } };
   }
   if (!toolDef) {
     const err = new Error(`Unknown tool: ${call.name}`);
     await ctx.hooks.callHook("tool:error", { name: call.name, input: call.input, error: err });
-    return { result: { id: call.id, content: `Tool error: ${err.message}` }, steered: false };
+    return { result: { id: call.id, content: `Tool error: ${err.message}` } };
   }
-  const validation = validateToolArgs(call.input, toolDef.spec.input_schema);
+  const validation = validateToolArgs(call.input, toolDef.spec.inputSchema);
   if (!validation.valid) {
-    return { result: { id: call.id, content: `Validation error: ${validation.error}` }, steered: false };
+    return { result: { id: call.id, content: `Validation error: ${validation.error}` } };
   }
   await ctx.hooks.callHook("tool:before", { name: call.name, input: call.input });
   let output;
@@ -537,7 +553,7 @@ async function executeSingleTool(ctx, call) {
   output = transformCtx.result;
   isError = transformCtx.isError;
   await ctx.hooks.callHook("tool:after", { name: call.name, input: call.input, result: output });
-  return { result: { id: call.id, content: output }, steered: false };
+  return { result: { id: call.id, content: output } };
 }
 async function executeToolsSequential(ctx, toolCalls) {
   const results = [];
@@ -583,7 +599,7 @@ async function executeToolsParallel(ctx, toolCalls) {
 var noTools = { name: "none", system: "You are a helpful assistant.", tools: {} };
 function resolveBehavior(harnessBehavior, agentBehavior, runBehavior) {
   return {
-    toolExecution: runBehavior?.toolExecution ?? agentBehavior?.toolExecution ?? harnessBehavior?.toolExecution ?? "sequential",
+    toolExecution: runBehavior?.toolExecution ?? agentBehavior?.toolExecution ?? harnessBehavior?.toolExecution ?? "parallel",
     maxTurns: runBehavior?.maxTurns ?? agentBehavior?.maxTurns ?? harnessBehavior?.maxTurns,
     maxTokens: runBehavior?.maxTokens ?? agentBehavior?.maxTokens ?? harnessBehavior?.maxTokens,
     thinkingBudget: runBehavior?.thinkingBudget ?? agentBehavior?.thinkingBudget ?? harnessBehavior?.thinkingBudget,
@@ -614,13 +630,23 @@ function createAgent({ harness: harnessOption, provider, behavior: agentBehavior
     if (running) {
       throw new Error("Agent is already running. Use steer() or followUp() to queue messages, or waitForIdle().");
     }
+    const hasSessionTurns = session && session.turns.length > 0;
+    if (!options.prompt && !hasSessionTurns) {
+      throw new Error("prompt is required when no session with existing turns is provided");
+    }
+    if (!options.prompt && hasSessionTurns) {
+      const lastTurn = session.turns.at(-1);
+      if (lastTurn && lastTurn.role !== "user") {
+        throw new Error("cannot resume without prompt: last session turn must be a user message");
+      }
+    }
     running = true;
     abortController = new AbortController();
     const runId = `run_${++runCounter}`;
     session?.startRun(runId, options.prompt);
     if (session) {
       await session.updateStatus("running");
-      await hooks.callHook("session:start", { sessionId: session.id, runId, prompt: options.prompt });
+      await hooks.callHook("session:start", { sessionId: session.id, runId, prompt: options.prompt ?? "" });
     }
     if (options.signal) {
       if (options.signal.aborted) {
@@ -698,12 +724,12 @@ ${skillsCatalog}`;
       (t) => ({
         name: t.spec.name,
         description: t.spec.description || "",
-        input_schema: t.spec.input_schema
+        inputSchema: t.spec.inputSchema
       })
     );
     const formattedTools = toolSpecs.length > 0 ? provider.formatTools(toolSpecs) : [];
     const turns = [];
-    const isResume = session && session.turns.length > 0 && session.runs.length > 0;
+    const isResume = session && session.turns.length > 0 && (session.runs.length > 0 || !options.prompt);
     if (isResume) {
       turns.push(...session.turns);
     }
@@ -727,14 +753,16 @@ ${skillsCatalog}`;
         createdAt: Date.now()
       });
     }
-    const promptMsg = provider.userMessage(options.prompt, options.images);
-    turns.push({
-      id: crypto.randomUUID(),
-      runId,
-      role: promptMsg.role,
-      content: promptMsg.content,
-      createdAt: Date.now()
-    });
+    if (options.prompt) {
+      const promptMsg = provider.userMessage(options.prompt, options.images);
+      turns.push({
+        id: crypto.randomUUID(),
+        runId,
+        role: promptMsg.role,
+        content: promptMsg.content,
+        createdAt: Date.now()
+      });
+    }
     conversationTurns = turns;
     let lastPersistedTurnCount = isResume ? session.turns.length : 0;
     const unregisterSessionSync = session ? hooks.hook("turn:after", async () => {
@@ -945,7 +973,7 @@ function createSpawnTool(options = {}) {
     spec: {
       name: "spawn",
       description: "Spawn a sub-agent to work on a specific task. The sub-agent runs independently with its own tool access and returns its final response. Use this to delegate work, parallelize tasks, or isolate concerns.",
-      input_schema: {
+      inputSchema: {
         type: "object",
         properties: {
           task: {
@@ -1020,7 +1048,7 @@ var writeFile2 = {
   spec: {
     name: "write_file",
     description: "Write content to a file. Creates parent directories if needed.",
-    input_schema: {
+    inputSchema: {
       type: "object",
       properties: {
         path: { type: "string", description: "Relative file path" },
@@ -1041,6 +1069,7 @@ export {
   createSandboxContext,
   validateToolArgs,
   createAgent,
+  createInteractionTool,
   listFiles,
   readFile,
   shell,

package/dist/{chunk-YTZOORAP.js → chunk-NNMWWSBY.js}

@@ -51,7 +51,7 @@ async function connectMcpServers(configs, _clientFactory, hooks) {
           spec: {
             name: namespacedName,
             description: tool.description || "",
-            input_schema: tool.inputSchema ?? { type: "object", properties: {} }
+            inputSchema: tool.inputSchema ?? { type: "object", properties: {} }
           },
           execute: async (input, _ctx) => {
             await hooks?.callHook("mcp:tool:before", { server: config.name, tool: tool.name, input });

package/dist/{chunk-LS57GDAV.js → chunk-UHCWNQGG.js}

@@ -124,7 +124,7 @@ function toOAIMessages(system, messages) {
 function formatTools(tools) {
   return tools.map((t) => ({
     type: "function",
-    function: { name: t.name, description: t.description, parameters: t.input_schema }
+    function: { name: t.name, description: t.description, parameters: t.inputSchema }
   }));
 }
 function userMessage(content, images) {

package/dist/{chunk-XT7QBZ47.js → chunk-V4PBD7LE.js}

@@ -307,7 +307,7 @@ async function createSession(options = {}) {
       data.runs.push({
         id: runId,
         startedAt: Date.now(),
-        prompt,
+        prompt: prompt ?? "",
         status: "running"
       });
       touch();

package/dist/harnesses.d.ts

@@ -1,4 +1,4 @@
 import 'hookable';
-export { H as Harness, i as HarnessConfig, u as ToolContext, v as ToolDef, x as ToolMap, a1 as basic, a2 as basicTools, Q as defineHarness, X as noTools } from './agent-DVvuhEN-.js';
-import './types-CyRzBgm0.js';
+export { H as Harness, i as HarnessConfig, u as ToolContext, v as ToolDef, x as ToolMap, a1 as basic, a2 as basicTools, Q as defineHarness, X as noTools } from './agent-CPOBJlcn.js';
+import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/harnesses.js

@@ -3,10 +3,10 @@ import {
   basic_default,
   defineHarness,
   noTools
-} from "./chunk-7V33E7LT.js";
-import "./chunk-VRAZJES3.js";
-import "./chunk-YTZOORAP.js";
-import "./chunk-3K5D27BF.js";
+} from "./chunk-BDBQ5MIB.js";
+import "./chunk-KWNFSVVE.js";
+import "./chunk-NNMWWSBY.js";
+import "./chunk-4C6Y56CC.js";
 export {
   basic_default as basic,
   basicTools,

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { A as Agent, a as AgentBehavior, b as AgentHooks, c as AgentOptions, d as AgentRunOptions, e as AgentStats, h as CreateSessionOptions, H as Harness, i as HarnessConfig, I as ImageContent, M as McpConnection, j as McpServerConfig, R as RemoteStoreOptions, S as Session, k as SessionContentBlock, l as SessionData, m as SessionMessage, n as SessionRun, o as SessionStore, p as SessionTurn, q as SqliteStoreOptions, T as ThinkingLevel, u as ToolContext, v as ToolDef, w as ToolExecutionMode, x as ToolMap, D as TurnUsage, E as autoDetectAndConvert, F as connectMcpServers, G as createAgent, J as createMemoryStore, K as createRemoteStore, L as createSession, N as createSqliteStore, Q as defineHarness, U as fromAnthropic, V as fromOpenAI, W as loadSession, X as noTools, Y as toAnthropic, Z as toOpenAI } from './agent-DVvuhEN-.js';
-import { f as SpawnConfig, b as ExecutionContext } from './types-CyRzBgm0.js';
-export { C as ContextCapabilities, a as ContextType, E as ExecResult, c as ExecutionHandle, S as SkillConfig, d as SkillResource, e as SkillsConfig } from './types-CyRzBgm0.js';
-export { S as SandboxProvider, c as createSandboxContext } from './sandbox-C08DQPTu.js';
+export { A as Agent, a as AgentBehavior, b as AgentHooks, c as AgentOptions, d as AgentRunOptions, e as AgentStats, h as CreateSessionOptions, H as Harness, i as HarnessConfig, I as ImageContent, M as McpConnection, j as McpServerConfig, R as RemoteStoreOptions, S as Session, k as SessionContentBlock, l as SessionData, m as SessionMessage, n as SessionRun, o as SessionStore, p as SessionTurn, q as SqliteStoreOptions, T as ThinkingLevel, u as ToolContext, v as ToolDef, w as ToolExecutionMode, x as ToolMap, D as TurnUsage, E as autoDetectAndConvert, F as connectMcpServers, G as createAgent, J as createMemoryStore, K as createRemoteStore, L as createSession, N as createSqliteStore, Q as defineHarness, U as fromAnthropic, V as fromOpenAI, W as loadSession, X as noTools, Y as toAnthropic, Z as toOpenAI } from './agent-CPOBJlcn.js';
+import { f as SpawnConfig, b as ExecutionContext } from './types-CKXAp41h.js';
+export { C as ContextCapabilities, a as ContextType, E as ExecResult, c as ExecutionHandle, S as SkillConfig, d as SkillResource, e as SkillsConfig } from './types-CKXAp41h.js';
+export { S as SandboxProvider, c as createSandboxContext } from './sandbox-DZn3ybp_.js';
 export { buildCatalog, defineSkill, discoverSkills, interpolateShellCommands, mergeSkillsConfig, parseSkillFile, resolveSkills, validateSkillName, writeSkillToDisk, writeSkillsToDisk } from './skills.js';
-export { C as ChildAgent, S as SpawnToolOptions, a as SpawnToolState, c as createSpawnTool, s as spawn } from './spawn-DJZZ9ZWw.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-CK08YMPC.js';
 import 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';
 
@@ -30,7 +30,7 @@ declare function createProcessContext(config?: SpawnConfig): ExecutionContext;
 /**
  * Zod v4 integration helper.
  *
- * Normalizes the output of z.toJsonSchema() for use as ToolSpec.input_schema.
+ * Normalizes the output of z.toJsonSchema() for use as ToolSpec.inputSchema.
  * Zod is an optional peer dependency — consumers call z.toJsonSchema() themselves.
  *
  * Usage:
@@ -40,7 +40,7 @@ declare function createProcessContext(config?: SpawnConfig): ExecutionContext;
  */
 /**
  * Normalize a JSON Schema (e.g. from zod v4's z.toJsonSchema()) for use
- * as a ToolSpec.input_schema.
+ * as a ToolSpec.inputSchema.
  *
  * Strips the $schema key that some providers reject.
  */

package/dist/index.js

@@ -1,32 +1,33 @@
 import {
   defineHarness,
   noTools
-} from "./chunk-7V33E7LT.js";
+} from "./chunk-BDBQ5MIB.js";
 import {
   createAgent,
   createDockerContext,
+  createInteractionTool,
   createProcessContext,
   createSandboxContext,
   createSpawnTool,
   spawn
-} from "./chunk-VRAZJES3.js";
+} from "./chunk-KWNFSVVE.js";
 import {
   connectMcpServers
-} from "./chunk-YTZOORAP.js";
+} from "./chunk-NNMWWSBY.js";
 import {
   createMemoryStore,
   createRemoteStore,
   createSession,
   createSqliteStore,
   loadSession
-} from "./chunk-XT7QBZ47.js";
+} from "./chunk-V4PBD7LE.js";
 import {
   autoDetectAndConvert,
   fromAnthropic,
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-LS57GDAV.js";
+} from "./chunk-UHCWNQGG.js";
 import {
   defineSkill
 } from "./chunk-CFLC2I7D.js";
@@ -40,7 +41,7 @@ import {
   validateSkillName,
   writeSkillToDisk,
   writeSkillsToDisk
-} from "./chunk-3K5D27BF.js";
+} from "./chunk-4C6Y56CC.js";
 
 // src/zod.ts
 function zodToJsonSchema(jsonSchema) {
@@ -53,6 +54,7 @@ export {
   connectMcpServers,
   createAgent,
   createDockerContext,
+  createInteractionTool,
   createMemoryStore,
   createProcessContext,
   createRemoteStore,

package/dist/mcp.d.ts

@@ -1,4 +1,4 @@
 import 'hookable';
-export { M as McpConnection, j as McpServerConfig, F as connectMcpServers, a3 as resultToString } from './agent-DVvuhEN-.js';
+export { M as McpConnection, j as McpServerConfig, F as connectMcpServers, a3 as resultToString } from './agent-CPOBJlcn.js';
 import '@modelcontextprotocol/sdk/client/index.js';
-import './types-CyRzBgm0.js';
+import './types-CKXAp41h.js';

package/dist/mcp.js

@@ -1,7 +1,7 @@
 import {
   connectMcpServers,
   resultToString
-} from "./chunk-YTZOORAP.js";
+} from "./chunk-NNMWWSBY.js";
 export {
   connectMcpServers,
   resultToString

package/dist/providers.d.ts

@@ -1,4 +1,4 @@
-export { f as AnthropicParams, C as CerebrasParams, O as OpenRouterParams, P as Provider, r as StreamCallbacks, s as StreamOptions, t as ToolCall, y as ToolResult, z as ToolSpec, B as TurnResult, _ as anthropic, $ as cerebras, a0 as openrouter } from './agent-DVvuhEN-.js';
+export { f as AnthropicParams, C as CerebrasParams, O as OpenRouterParams, P as Provider, r as StreamCallbacks, s as StreamOptions, t as ToolCall, y as ToolResult, z as ToolSpec, B as TurnResult, _ as anthropic, $ as cerebras, a0 as openrouter } from './agent-CPOBJlcn.js';
 import 'hookable';
-import './types-CyRzBgm0.js';
+import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/providers.js

@@ -8,7 +8,7 @@ import {
   toOAIMessages,
   toolResultsMessage,
   userMessage
-} from "./chunk-LS57GDAV.js";
+} from "./chunk-UHCWNQGG.js";
 
 // src/providers/anthropic.ts
 import { existsSync, readFileSync } from "fs";
@@ -59,7 +59,7 @@ function anthropic(anthropicParams) {
       return tools.map((t) => ({
         name: t.name,
         description: t.description,
-        input_schema: t.input_schema
+        input_schema: t.inputSchema
       }));
     },
     userMessage(content, images) {

package/dist/{sandbox-C08DQPTu.d.ts → sandbox-DZn3ybp_.d.ts}

@@ -1,4 +1,4 @@
-import { f as SpawnConfig, E as ExecResult, b as ExecutionContext } from './types-CyRzBgm0.js';
+import { f as SpawnConfig, E as ExecResult, b as ExecutionContext } from './types-CKXAp41h.js';
 
 /**
  * Remote sandbox execution context.

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-export { h as CreateSessionOptions, R as RemoteStoreOptions, S as Session, k as SessionContentBlock, l as SessionData, m as SessionMessage, n as SessionRun, o as SessionStore, p as SessionTurn, q as SqliteStoreOptions, E as autoDetectAndConvert, J as createMemoryStore, K as createRemoteStore, L as createSession, N as createSqliteStore, U as fromAnthropic, V as fromOpenAI, W as loadSession, Y as toAnthropic, Z as toOpenAI } from './agent-DVvuhEN-.js';
+export { h as CreateSessionOptions, R as RemoteStoreOptions, S as Session, k as SessionContentBlock, l as SessionData, m as SessionMessage, n as SessionRun, o as SessionStore, p as SessionTurn, q as SqliteStoreOptions, E as autoDetectAndConvert, J as createMemoryStore, K as createRemoteStore, L as createSession, N as createSqliteStore, U as fromAnthropic, V as fromOpenAI, W as loadSession, Y as toAnthropic, Z as toOpenAI } from './agent-CPOBJlcn.js';
 import 'hookable';
-import './types-CyRzBgm0.js';
+import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/session.js

@@ -4,14 +4,14 @@ import {
   createSession,
   createSqliteStore,
   loadSession
-} from "./chunk-XT7QBZ47.js";
+} from "./chunk-V4PBD7LE.js";
 import {
   autoDetectAndConvert,
   fromAnthropic,
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-LS57GDAV.js";
+} from "./chunk-UHCWNQGG.js";
 export {
   autoDetectAndConvert,
   createMemoryStore,

package/dist/skills.d.ts

@@ -1,5 +1,5 @@
-import { S as SkillConfig, b as ExecutionContext, c as ExecutionHandle, e as SkillsConfig } from './types-CyRzBgm0.js';
-export { d as SkillResource } from './types-CyRzBgm0.js';
+import { S as SkillConfig, b as ExecutionContext, c as ExecutionHandle, e as SkillsConfig } from './types-CKXAp41h.js';
+export { d as SkillResource } from './types-CKXAp41h.js';
 
 /**
  * Skill catalog generation.

package/dist/skills.js

@@ -13,7 +13,7 @@ import {
   validateSkillName,
   writeSkillToDisk,
   writeSkillsToDisk
-} from "./chunk-3K5D27BF.js";
+} from "./chunk-4C6Y56CC.js";
 export {
   buildCatalog,
   defineSkill,

package/dist/{spawn-DJZZ9ZWw.d.ts → spawn-CK08YMPC.d.ts}

@@ -1,4 +1,41 @@
-import { i as HarnessConfig, e as AgentStats, v as ToolDef } from './agent-DVvuhEN-.js';
+import { v as ToolDef, i as HarnessConfig, e as AgentStats } from './agent-CPOBJlcn.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, returns data for the model. */
+    onRequest: (payload: Record<string, unknown>) => 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.
@@ -59,4 +96,4 @@ declare function createSpawnTool(options?: SpawnToolOptions): ToolDef & SpawnToo
  */
 declare const spawn: ToolDef & SpawnToolState;
 
-export { type ChildAgent as C, type SpawnToolOptions as S, type SpawnToolState as a, createSpawnTool as c, spawn as s };
+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,8 +1,8 @@
-import { v as ToolDef } from './agent-DVvuhEN-.js';
-export { C as ChildAgent, S as SpawnToolOptions, a as SpawnToolState, c as createSpawnTool, s as spawn } from './spawn-DJZZ9ZWw.js';
-export { V as ValidationResult, v as validateToolArgs } from './validation-CwSuvOKf.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-CK08YMPC.js';
+import { v as ToolDef } from './agent-CPOBJlcn.js';
+export { V as ValidationResult, v as validateToolArgs } from './validation-DOY_k7lW.js';
 import 'hookable';
-import './types-CyRzBgm0.js';
+import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 
 declare const listFiles: ToolDef;

package/dist/tools.js

@@ -1,4 +1,5 @@
 import {
+  createInteractionTool,
   createSpawnTool,
   listFiles,
   readFile,
@@ -6,10 +7,11 @@ import {
   spawn,
   validateToolArgs,
   writeFile
-} from "./chunk-VRAZJES3.js";
-import "./chunk-YTZOORAP.js";
-import "./chunk-3K5D27BF.js";
+} from "./chunk-KWNFSVVE.js";
+import "./chunk-NNMWWSBY.js";
+import "./chunk-4C6Y56CC.js";
 export {
+  createInteractionTool,
   createSpawnTool,
   listFiles,
   readFile,

package/dist/{types-CyRzBgm0.d.ts → types-CKXAp41h.d.ts}

@@ -113,8 +113,8 @@ interface SkillConfig {
     thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
     /**
      * Glob patterns that limit when this skill auto-activates.
-     * When set, the skill is only included in the catalog when
-     * the agent is working with files matching these patterns.
+     * Parsed and stored per the Agent Skills spec, but not yet
+     * enforced at runtime — all skills are included in the catalog.
      */
     paths?: string[];
 }

package/dist/types.d.ts

@@ -1,7 +1,7 @@
-export { A as Agent, a as AgentBehavior, b as AgentHooks, c as AgentOptions, d as AgentRunOptions, e as AgentStats, f as AnthropicParams, C as CerebrasParams, g as ChildRunStats, h as CreateSessionOptions, H as Harness, i as HarnessConfig, I as ImageContent, M as McpConnection, j as McpServerConfig, O as OpenRouterParams, P as Provider, R as RemoteStoreOptions, S as Session, k as SessionContentBlock, l as SessionData, m as SessionMessage, n as SessionRun, o as SessionStore, p as SessionTurn, q as SqliteStoreOptions, r as StreamCallbacks, s as StreamOptions, T as ThinkingLevel, t as ToolCall, u as ToolContext, v as ToolDef, w as ToolExecutionMode, x as ToolMap, y as ToolResult, z as ToolSpec, B as TurnResult, D as TurnUsage } from './agent-DVvuhEN-.js';
-export { C as ContextCapabilities, a as ContextType, E as ExecResult, b as ExecutionContext, c as ExecutionHandle, S as SkillConfig, d as SkillResource, e as SkillsConfig, f as SpawnConfig } from './types-CyRzBgm0.js';
-export { S as SandboxProvider } from './sandbox-C08DQPTu.js';
-export { C as ChildAgent, S as SpawnToolOptions, a as SpawnToolState } from './spawn-DJZZ9ZWw.js';
-export { V as ValidationResult } from './validation-CwSuvOKf.js';
+export { A as Agent, a as AgentBehavior, b as AgentHooks, c as AgentOptions, d as AgentRunOptions, e as AgentStats, f as AnthropicParams, C as CerebrasParams, g as ChildRunStats, h as CreateSessionOptions, H as Harness, i as HarnessConfig, I as ImageContent, M as McpConnection, j as McpServerConfig, O as OpenRouterParams, P as Provider, R as RemoteStoreOptions, S as Session, k as SessionContentBlock, l as SessionData, m as SessionMessage, n as SessionRun, o as SessionStore, p as SessionTurn, q as SqliteStoreOptions, r as StreamCallbacks, s as StreamOptions, T as ThinkingLevel, t as ToolCall, u as ToolContext, v as ToolDef, w as ToolExecutionMode, x as ToolMap, y as ToolResult, z as ToolSpec, B as TurnResult, D as TurnUsage } from './agent-CPOBJlcn.js';
+export { C as ContextCapabilities, a as ContextType, E as ExecResult, b as ExecutionContext, c as ExecutionHandle, S as SkillConfig, d as SkillResource, e as SkillsConfig, f as SpawnConfig } from './types-CKXAp41h.js';
+export { S as SandboxProvider } from './sandbox-DZn3ybp_.js';
+export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState } from './spawn-CK08YMPC.js';
+export { V as ValidationResult } from './validation-DOY_k7lW.js';
 import 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/{validation-CwSuvOKf.d.ts → validation-DOY_k7lW.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Simple tool argument validation against JSON Schema-style input_schema.
+ * Simple tool argument validation against JSON Schema-style inputSchema.
  * Checks required fields are present; type coercion is left to the tools themselves.
  */
 interface ValidationResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "1.6.0",
+  "version": "1.6.4",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,
@@ -59,7 +59,8 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "test": "bun test",
-    "release": "bumpp"
+    "release": "bumpp",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.80.0",
@@ -84,6 +85,7 @@
     "bumpp": "^11.0.1",
     "eslint": "^10.0.3",
     "jiti": "^2.6.1",
-    "tsup": "^8.5.1"
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3"
   }
 }