zidane 1.6.4 → 1.6.6

package/README.md

@@ -174,6 +174,8 @@ await agent.run({ prompt: 'solve this', thinking: 'high', behavior: { thinkingBu
 const agent = createAgent({ provider, harness, behavior: { thinkingBudget: 16384 } })
 ```
 
+Thinking traces are stored in session turns as `{ type: 'thinking', text }` content blocks and streamed live via the `stream:thinking` hook. Supported by Anthropic (native) and OpenRouter/Cerebras (`reasoning_content`/`reasoning` SSE fields).
+
 ## Hooks
 
 Every hook receives a mutable context object.
@@ -214,6 +216,11 @@ agent.hooks.hook('stream:end', (ctx) => {
   // ctx.text (final), ctx.turnId
   // Only fires when there is text content (not on tool-only turns)
 })
+
+agent.hooks.hook('stream:thinking', (ctx) => {
+  // ctx.delta, ctx.thinking (accumulated), ctx.turnId
+  // Fires when the model streams reasoning traces (Anthropic, OpenRouter)
+})
 ```
 
 ### Tool execution
@@ -582,7 +589,7 @@ import type { Agent, SessionTurn, TurnUsage, Provider, ToolDef } from 'zidane/ty
 bun test
 ```
 
-474+ tests with mock provider and execution context. No API keys or Docker needed.
+484+ tests with mock provider and execution context. No API keys or Docker needed.
 
 ## License
 

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

@@ -64,6 +64,7 @@ type SessionContentBlock = {
 } | {
     type: 'thinking';
     text: string;
+    signature?: string;
 };
 interface SessionMessage {
     role: 'user' | 'assistant';
@@ -164,6 +165,7 @@ interface ToolResult {
 }
 interface StreamCallbacks {
     onText: (delta: string) => void;
+    onThinking?: (delta: string) => void;
 }
 interface TurnResult {
     /** Full assistant turn as a SessionMessage */
@@ -513,6 +515,11 @@ interface AgentHooks {
         text: string;
         turnId: string;
     }) => void;
+    'stream:thinking': (ctx: {
+        delta: string;
+        thinking: string;
+        turnId: string;
+    }) => void;
     'tool:before': (ctx: {
         name: string;
         input: Record<string, unknown>;

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

@@ -395,14 +395,10 @@ async function runLoop(ctx) {
         });
         continue;
       }
-      const stats2 = { totalIn, totalOut, turns: turn + 1, elapsed: Date.now() - startTime, turnUsage: turnUsages, output: result.output };
-      await ctx.hooks.callHook("agent:done", stats2);
-      return stats2;
+      return { totalIn, totalOut, turns: turn + 1, elapsed: Date.now() - startTime, turnUsage: turnUsages, output: result.output };
     }
   }
-  const stats = { totalIn, totalOut, turns: maxTurns, elapsed: Date.now() - startTime, turnUsage: turnUsages };
-  await ctx.hooks.callHook("agent:done", stats);
-  return stats;
+  return { totalIn, totalOut, turns: maxTurns, elapsed: Date.now() - startTime, turnUsage: turnUsages };
 }
 async function executeTurn(ctx, turn) {
   const turnId = await ctx.generateTurnId();
@@ -420,6 +416,7 @@ 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 currentThinking = "";
   let result;
   try {
     result = await ctx.provider.stream(
@@ -428,6 +425,10 @@ async function executeTurn(ctx, turn) {
         onText(delta) {
           currentText += delta;
           ctx.hooks.callHook("stream:text", { delta, text: currentText, turnId });
+        },
+        onThinking(delta) {
+          currentThinking += delta;
+          ctx.hooks.callHook("stream:thinking", { delta, thinking: currentThinking, turnId });
         }
       }
     );

package/dist/{chunk-BDBQ5MIB.js → chunk-KG63Q5KF.js}

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

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

@@ -6,6 +6,7 @@ async function consumeSSE(response, callbacks, signal) {
   const decoder = new TextDecoder();
   let buffer = "";
   let text = "";
+  let thinking = "";
   let finishReason = "stop";
   let usage = { input: 0, output: 0 };
   const tcMap = /* @__PURE__ */ new Map();
@@ -36,6 +37,11 @@ async function consumeSSE(response, callbacks, signal) {
           continue;
         if (choice.finish_reason)
           finishReason = choice.finish_reason;
+        const thinkingDelta = choice.delta?.reasoning_content ?? choice.delta?.reasoning;
+        if (thinkingDelta) {
+          thinking += thinkingDelta;
+          callbacks.onThinking?.(thinkingDelta);
+        }
         if (choice.delta?.content) {
           text += choice.delta.content;
           callbacks.onText(choice.delta.content);
@@ -72,7 +78,7 @@ async function consumeSSE(response, callbacks, signal) {
     name: tc.name,
     input: tc.args ? JSON.parse(tc.args) : {}
   }));
-  return { text, toolCalls, finishReason, usage };
+  return { text, thinking, toolCalls, finishReason, usage };
 }
 function toOAIMessages(system, messages) {
   const out = [{ role: "system", content: system }];
@@ -156,8 +162,10 @@ function toolResultsMessage(results) {
     }))
   };
 }
-function buildAssistantContent(text, toolCalls) {
+function buildAssistantContent(text, toolCalls, thinking) {
   const content = [];
+  if (thinking)
+    content.push({ type: "thinking", text: thinking });
   if (text)
     content.push({ type: "text", text });
   for (const tc of toolCalls) {
@@ -192,7 +200,7 @@ function fromAnthropic(msg) {
         const output = typeof b.content === "string" ? b.content : JSON.stringify(b.content);
         content.push({ type: "tool_result", callId: b.tool_use_id, output });
       } else if (b.type === "thinking") {
-        content.push({ type: "thinking", text: b.thinking });
+        content.push({ type: "thinking", text: b.thinking, signature: b.signature });
       }
     }
   }
@@ -261,7 +269,7 @@ function toAnthropic(msg) {
       case "tool_result":
         return { type: "tool_result", tool_use_id: block.callId, content: block.output };
       case "thinking":
-        return { type: "thinking", thinking: block.text };
+        return { type: "thinking", thinking: block.text, signature: block.signature };
       default:
         return { type: "text", text: "" };
     }

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-CPOBJlcn.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-0Tafyla0.js';
 import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/harnesses.js

@@ -3,8 +3,8 @@ import {
   basic_default,
   defineHarness,
   noTools
-} from "./chunk-BDBQ5MIB.js";
-import "./chunk-KWNFSVVE.js";
+} from "./chunk-KG63Q5KF.js";
+import "./chunk-F4BVVP67.js";
 import "./chunk-NNMWWSBY.js";
 import "./chunk-4C6Y56CC.js";
 export {

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-CPOBJlcn.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-0Tafyla0.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, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, c as createInteractionTool, b as createSpawnTool, s as spawn } from './spawn-CK08YMPC.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-Bm1ihQ_K.js';
 import 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';
 

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   defineHarness,
   noTools
-} from "./chunk-BDBQ5MIB.js";
+} from "./chunk-KG63Q5KF.js";
 import {
   createAgent,
   createDockerContext,
@@ -10,7 +10,7 @@ import {
   createSandboxContext,
   createSpawnTool,
   spawn
-} from "./chunk-KWNFSVVE.js";
+} from "./chunk-F4BVVP67.js";
 import {
   connectMcpServers
 } from "./chunk-NNMWWSBY.js";
@@ -27,7 +27,7 @@ import {
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-UHCWNQGG.js";
+} from "./chunk-QCJKUQTQ.js";
 import {
   defineSkill
 } from "./chunk-CFLC2I7D.js";

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-CPOBJlcn.js';
+export { M as McpConnection, j as McpServerConfig, F as connectMcpServers, a3 as resultToString } from './agent-0Tafyla0.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import './types-CKXAp41h.js';

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-CPOBJlcn.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-0Tafyla0.js';
 import 'hookable';
 import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/providers.js

@@ -8,7 +8,7 @@ import {
   toOAIMessages,
   toolResultsMessage,
   userMessage
-} from "./chunk-UHCWNQGG.js";
+} from "./chunk-QCJKUQTQ.js";
 
 // src/providers/anthropic.ts
 import { existsSync, readFileSync } from "fs";
@@ -109,6 +109,7 @@ function anthropic(anthropicParams) {
           type: "enabled",
           budget_tokens: budgetTokens
         };
+        params.max_tokens = budgetTokens + params.max_tokens;
         params.temperature = 1;
       }
       if (options.toolChoice) {
@@ -127,6 +128,11 @@ function anthropic(anthropicParams) {
         text += delta;
         callbacks.onText(delta);
       });
+      if (callbacks.onThinking) {
+        s.on("thinking", (delta) => {
+          callbacks.onThinking(delta);
+        });
+      }
       const response = await s.finalMessage();
       const toolCalls = response.content.filter((b) => b.type === "tool_use").map((b) => ({ id: b.id, name: b.name, input: b.input }));
       return {
@@ -167,10 +173,11 @@ function cerebras(params) {
     async stream(options, callbacks) {
       const modelId = options.model || defaultModel;
       const messages = toOAIMessages(options.system, options.messages);
+      const maxTokens = options.thinkingBudget ? options.thinkingBudget + options.maxTokens : options.maxTokens;
       const body = {
         model: modelId,
         messages,
-        max_tokens: options.maxTokens,
+        max_tokens: maxTokens,
         stream: true
       };
       if (options.tools && options.tools.length > 0)
@@ -198,7 +205,7 @@ function cerebras(params) {
       }
       const result = await consumeSSE(response, callbacks, options.signal);
       return {
-        assistantMessage: buildAssistantContent(result.text, result.toolCalls),
+        assistantMessage: buildAssistantContent(result.text, result.toolCalls, result.thinking),
         text: result.text,
         toolCalls: result.toolCalls,
         done: result.finishReason === "stop" || result.toolCalls.length === 0,
@@ -233,10 +240,11 @@ function openrouter(params) {
       if (thinking !== "off" && !modelId.includes(":thinking"))
         modelId = `${modelId}:thinking`;
       const messages = toOAIMessages(options.system, options.messages);
+      const maxTokens = options.thinkingBudget ? options.thinkingBudget + options.maxTokens : options.maxTokens;
       const body = {
         model: modelId,
         messages,
-        max_tokens: options.maxTokens,
+        max_tokens: maxTokens,
         stream: true
       };
       if (options.tools && options.tools.length > 0)
@@ -266,7 +274,7 @@ function openrouter(params) {
       }
       const result = await consumeSSE(response, callbacks, options.signal);
       return {
-        assistantMessage: buildAssistantContent(result.text, result.toolCalls),
+        assistantMessage: buildAssistantContent(result.text, result.toolCalls, result.thinking),
         text: result.text,
         toolCalls: result.toolCalls,
         done: result.finishReason === "stop" || result.toolCalls.length === 0,

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-CPOBJlcn.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-0Tafyla0.js';
 import 'hookable';
 import './types-CKXAp41h.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/session.js

@@ -11,7 +11,7 @@ import {
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-UHCWNQGG.js";
+} from "./chunk-QCJKUQTQ.js";
 export {
   autoDetectAndConvert,
   createMemoryStore,

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

@@ -1,4 +1,4 @@
-import { v as ToolDef, i as HarnessConfig, e as AgentStats } from './agent-CPOBJlcn.js';
+import { v as ToolDef, i as HarnessConfig, e as AgentStats } from './agent-0Tafyla0.js';
 
 /**
  * Interaction tool — lets the agent request structured input from the outside world.

package/dist/tools.d.ts

@@ -1,5 +1,5 @@
-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 { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, c as createInteractionTool, b as createSpawnTool, s as spawn } from './spawn-Bm1ihQ_K.js';
+import { v as ToolDef } from './agent-0Tafyla0.js';
 export { V as ValidationResult, v as validateToolArgs } from './validation-DOY_k7lW.js';
 import 'hookable';
 import './types-CKXAp41h.js';

package/dist/tools.js

@@ -7,7 +7,7 @@ import {
   spawn,
   validateToolArgs,
   writeFile
-} from "./chunk-KWNFSVVE.js";
+} from "./chunk-F4BVVP67.js";
 import "./chunk-NNMWWSBY.js";
 import "./chunk-4C6Y56CC.js";
 export {

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-CPOBJlcn.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-0Tafyla0.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 { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState } from './spawn-Bm1ihQ_K.js';
 export { V as ValidationResult } from './validation-DOY_k7lW.js';
 import 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,