zidane 1.6.4 → 1.6.5

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-BDZbObgy.d.ts}

@@ -164,6 +164,7 @@ interface ToolResult {
 }
 interface StreamCallbacks {
     onText: (delta: string) => void;
+    onThinking?: (delta: string) => void;
 }
 interface TurnResult {
     /** Full assistant turn as a SessionMessage */
@@ -513,6 +514,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-R7PIZ4MU.js}

@@ -420,6 +420,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 +429,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-TWRNLI6I.js}

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

package/dist/{chunk-UHCWNQGG.js → chunk-UUITMJ7G.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) {

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-BDZbObgy.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-TWRNLI6I.js";
+import "./chunk-R7PIZ4MU.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-BDZbObgy.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-CQieNB1Y.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-TWRNLI6I.js";
 import {
   createAgent,
   createDockerContext,
@@ -10,7 +10,7 @@ import {
   createSandboxContext,
   createSpawnTool,
   spawn
-} from "./chunk-KWNFSVVE.js";
+} from "./chunk-R7PIZ4MU.js";
 import {
   connectMcpServers
 } from "./chunk-NNMWWSBY.js";
@@ -27,7 +27,7 @@ import {
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-UHCWNQGG.js";
+} from "./chunk-UUITMJ7G.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-BDZbObgy.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-BDZbObgy.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-UUITMJ7G.js";
 
 // src/providers/anthropic.ts
 import { existsSync, readFileSync } from "fs";
@@ -127,6 +127,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 {
@@ -198,7 +203,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,
@@ -266,7 +271,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-BDZbObgy.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-UUITMJ7G.js";
 export {
   autoDetectAndConvert,
   createMemoryStore,

package/dist/{spawn-CK08YMPC.d.ts → spawn-CQieNB1Y.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-BDZbObgy.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-CQieNB1Y.js';
+import { v as ToolDef } from './agent-BDZbObgy.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-R7PIZ4MU.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-BDZbObgy.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-CQieNB1Y.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.5",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,