zidane 3.1.2 → 3.3.0

package/dist/{agent-C9q5VMGa.d.ts → agent-BBzkPRAu.d.ts}

@@ -242,7 +242,7 @@ interface AgentBehavior {
      *   `runTurn` is 1-indexed, run-relative (resumed sessions reset).
      *
      * No-op when `thinkingBudget` is unset. Honored by every provider that
-     * respects `thinkingBudget` (anthropic legacy enabled+budget path,
+     * respects `thinkingBudget` (anthropic explicit-budget `enabled` path,
      * adaptive `maxTokensCap`, openai-compat `max_tokens` padding).
      *
      * Default: `undefined` (no decay).
@@ -356,8 +356,8 @@ interface AgentBehavior {
      * model "remembers" stale content and applies a substring edit against
      * bytes that have moved.
      *
-     * Requires a session. Off by default to preserve back-compat — turn it on
-     * for stricter eval-grade runs.
+     * Requires a session. Off by default; turn it on for stricter eval-grade
+     * runs where silent edit corruption would invalidate the result.
      *
      * Default: `false`.
      */
@@ -392,14 +392,40 @@ interface AgentBehavior {
      * for elision so the model keeps the freshest tool context. Default: `4`.
      */
     compactKeepTurns?: number;
-}
-interface ImageContent {
-    type: 'image';
-    source: {
-        type: 'base64';
-        media_type: string;
-        data: string;
-    };
+    /**
+     * Prefix every line of `read_file` output with its 1-indexed line number
+     * followed by a tab (`<N>\t<content>`) — the compact `cat -n`-style
+     * format Claude Code emits. The `edit` tool strips the prefix from
+     * `old_string` / `new_string` so the model can paste back a numbered
+     * chunk verbatim without breaking the match.
+     *
+     * Set `false` to opt out — useful for callers piping `read_file` into
+     * downstream parsers that don't recognize the prefix. Per-call
+     * `read_file({ lineNumbers: false })` overrides this default.
+     *
+     * Default: `true`.
+     */
+    readLineNumbers?: boolean;
+    /**
+     * Replace older `read_file` `tool_result` blocks with a short stub when
+     * a successful `edit` / `multi_edit` / `write_file` later in the same
+     * run modified the same path. The replacement is applied to the
+     * wire-level message list only — persisted session turns keep the
+     * original content.
+     *
+     * Eliminates the common waste pattern where the model carries the
+     * pre-edit file body forward across many turns "in case it needs it".
+     * Pairs cleanly with `compactStrategy: 'tail'`: stale reads shrink
+     * first, then the byte-threshold compaction fires if anything's left.
+     *
+     * Detection is conservative — only triggers when the corresponding
+     * tool_result confirms success (`Edited …`, `Created …`, `Updated …`).
+     * Failed edits and `No change needed` write_file calls do NOT
+     * invalidate prior reads.
+     *
+     * Default: `false`.
+     */
+    elideStaleReads?: boolean;
 }
 /**
  * One block of a multimodal user prompt.
@@ -540,11 +566,6 @@ interface AgentRunOptions {
     prompt?: string | PromptPart[];
     system?: string;
     thinking?: ThinkingLevel;
-    /**
-     * Legacy image attachments. When `prompt` is a string, these are appended as image
-     * parts after the text. Ignored when `prompt` is a `PromptPart[]`.
-     */
-    images?: ImageContent[];
     /** Abort signal — when triggered, the agent stops after the current turn */
     signal?: AbortSignal;
     /** Behavior overrides for this run (overrides agent defaults) */
@@ -1082,8 +1103,8 @@ interface Provider {
     } & Record<string, unknown>;
     /** Format tool specs for this provider */
     formatTools: (tools: ToolSpec[]) => unknown[];
-    /** Create a user message (text or with images) */
-    userMessage: (content: string, images?: ImageContent[]) => SessionMessage;
+    /** Create a text-only user message. Multimodal content goes through `promptMessage`. */
+    userMessage: (content: string) => SessionMessage;
     /** Create an assistant message (for priming) */
     assistantMessage: (content: string) => SessionMessage;
     /** Create a tool results message to send back */
@@ -1584,13 +1605,13 @@ interface McpConnection {
  */
 declare function normalizeMcpServers(input: unknown): McpServerConfig[];
 /**
- * Lossy flattener — converts MCP `CallToolResult.content` blocks to a single string.
- * Text blocks are extracted; non-text blocks are JSON-stringified.
+ * Lossy flattener — converts MCP `CallToolResult.content` blocks to a single
+ * string. Text blocks are extracted; non-text blocks are JSON-stringified.
  *
- * Prefer {@link normalizeMcpBlocks} for new code — it preserves image blocks so the
- * provider can route them through to the model natively (Anthropic tool_result blocks,
- * OpenAI companion-user-message). This function is kept for back-compat and is useful
- * as a logging/display helper where a single string is required.
+ * Use this only at UI / log boundaries that require a string. The agent
+ * loop itself routes through {@link normalizeMcpBlocks} so image blocks
+ * survive into provider-native tool_result content (Anthropic blocks,
+ * OpenAI companion-user-message).
  */
 declare function resultToString(content: unknown[]): string;
 /**
@@ -2092,7 +2113,14 @@ interface AgentOptions {
     session?: Session;
     /** Skills configuration */
     skills?: SkillsConfig;
-    /** @internal */
+    /**
+     * Test seam — replaces the default MCP connector with a custom
+     * implementation. Bypasses the `mcpServers` normalization layer entirely
+     * and is **not** part of the supported public API. Subject to change or
+     * removal in any release.
+     *
+     * @internal
+     */
     mcpConnector?: (configs: McpServerConfig[]) => Promise<McpConnection>;
     /**
      * Pre-connect MCP servers in the background as soon as `createAgent` returns,
@@ -2156,8 +2184,14 @@ interface Agent {
     readonly session: Session | null;
     /** Snapshot of currently active skills. */
     readonly activeSkills: readonly ActiveSkill[];
-    meta: Record<string, unknown>;
+    /**
+     * Frozen view of the underlying `provider.meta`. Read-only to prevent
+     * accidental cross-agent contamination — writes are rejected at runtime
+     * (via `Object.freeze`) and at compile time (via `Readonly`). To override
+     * model / capability defaults, construct a new provider.
+     */
+    readonly meta: Readonly<Record<string, unknown>>;
 }
 declare function createAgent({ provider, name: agentName, system: agentSystem, tools: agentTools, toolAliases, behavior: agentBehavior, execution, mcpServers, session, skills: agentSkills, mcpConnector, eager }: AgentOptions): Agent;
 
-export { type ToolHookContext as $, type Agent as A, type SessionData as B, CONTEXT_EXCEEDED_MESSAGE_PATTERNS as C, type SessionEndStatus as D, type SessionHookContext as E, type SessionMessage as F, type SessionRun as G, type SessionStore as H, type ImageContent as I, type SessionTurn as J, type SkillConfig as K, type SkillResource as L, type McpConnection as M, type SkillsConfig as N, type OAuthRefreshHookContext as O, type PromptDocumentPart as P, type SpawnHookContext as Q, type RemoteStoreOptions as R, type Session as S, type StreamCallbacks as T, type StreamHookContext as U, type StreamOptions as V, type ThinkingLevel as W, type ToolCall as X, type ToolContext as Y, type ToolDef as Z, type ToolExecutionMode as _, AgentAbortedError as a, type ToolMap as a0, type ToolResult as a1, type ToolResultContent as a2, type ToolResultImageContent as a3, type ToolResultTextContent as a4, type ToolSpec as a5, type TurnFinishReason as a6, type TurnResult as a7, type TurnUsage as a8, matchesContextExceeded as a9, fromOpenAI as aA, loadSession as aB, mapOAIFinishReason as aC, normalizeMcpBlocks as aD, normalizeMcpServers as aE, openai as aF, openaiCompat as aG, openrouter as aH, resultToString as aI, toAnthropic as aJ, toOpenAI as aK, toTypedError as aL, toolOutputByteLength as aa, toolResultToText as ab, type ActivationVia as ac, type ActiveSkill as ad, type DeactivationReason as ae, type FileMapAdapter as af, type FileMapStoreOptions as ag, type OpenAICompatAuthHeader as ah, OpenAICompatHttpError as ai, type OpenAICompatParams as aj, type SkillActivationState as ak, type SkillActivationStateOptions as al, type SkillDiagnostic as am, type SkillSource as an, anthropic as ao, autoDetectAndConvert as ap, cerebras as aq, classifyOpenAICompatError as ar, connectMcpServers as as, createAgent as at, createFileMapStore as au, createMemoryStore as av, createRemoteStore as aw, createSession as ax, createSkillActivationState as ay, fromAnthropic as az, type AgentBehavior as b, AgentContextExceededError as c, type AgentHooks as d, type AgentOptions as e, AgentProviderError as f, type AgentRunOptions as g, type AgentStats as h, AgentToolNotAllowedError as i, type AnthropicParams as j, type CerebrasParams as k, type ChildRunStats as l, type ClassifiedError as m, type ClassifiedErrorKind as n, type CreateSessionOptions as o, type McpServerConfig as p, type McpToolHookContext as q, type OpenAIParams as r, type OpenRouterParams as s, type PromptImagePart as t, type PromptPart as u, type PromptTextPart as v, type Provider as w, type ProviderCapabilities as x, type RunHookMap as y, type SessionContentBlock as z };
+export { type ToolMap as $, type Agent as A, type SessionData as B, CONTEXT_EXCEEDED_MESSAGE_PATTERNS as C, type SessionEndStatus as D, type SessionHookContext as E, type SessionMessage as F, type SessionRun as G, type SessionStore as H, type SessionTurn as I, type SkillConfig as J, type SkillResource as K, type SkillsConfig as L, type McpConnection as M, type SpawnHookContext as N, type OAuthRefreshHookContext as O, type PromptDocumentPart as P, type StreamCallbacks as Q, type RemoteStoreOptions as R, type Session as S, type StreamHookContext as T, type StreamOptions as U, type ThinkingLevel as V, type ToolCall as W, type ToolContext as X, type ToolDef as Y, type ToolExecutionMode as Z, type ToolHookContext as _, AgentAbortedError as a, type ToolResult as a0, type ToolResultContent as a1, type ToolResultImageContent as a2, type ToolResultTextContent as a3, type ToolSpec as a4, type TurnFinishReason as a5, type TurnResult as a6, type TurnUsage as a7, matchesContextExceeded as a8, toolOutputByteLength as a9, loadSession as aA, mapOAIFinishReason as aB, normalizeMcpBlocks as aC, normalizeMcpServers as aD, openai as aE, openaiCompat as aF, openrouter as aG, resultToString as aH, toAnthropic as aI, toOpenAI as aJ, toTypedError as aK, toolResultToText as aa, type ActivationVia as ab, type ActiveSkill as ac, type DeactivationReason as ad, type FileMapAdapter as ae, type FileMapStoreOptions as af, type OpenAICompatAuthHeader as ag, OpenAICompatHttpError as ah, type OpenAICompatParams as ai, type SkillActivationState as aj, type SkillActivationStateOptions as ak, type SkillDiagnostic as al, type SkillSource as am, anthropic as an, autoDetectAndConvert as ao, cerebras as ap, classifyOpenAICompatError as aq, connectMcpServers as ar, createAgent as as, createFileMapStore as at, createMemoryStore as au, createRemoteStore as av, createSession as aw, createSkillActivationState as ax, fromAnthropic as ay, fromOpenAI as az, type AgentBehavior as b, AgentContextExceededError as c, type AgentHooks as d, type AgentOptions as e, AgentProviderError as f, type AgentRunOptions as g, type AgentStats as h, AgentToolNotAllowedError as i, type AnthropicParams as j, type CerebrasParams as k, type ChildRunStats as l, type ClassifiedError as m, type ClassifiedErrorKind as n, type CreateSessionOptions as o, type McpServerConfig as p, type McpToolHookContext as q, type OpenAIParams as r, type OpenRouterParams as s, type PromptImagePart as t, type PromptPart as u, type PromptTextPart as v, type Provider as w, type ProviderCapabilities as x, type RunHookMap as y, type SessionContentBlock as z };

package/dist/{chunk-BXO7CZHJ.js → chunk-3D5Q527Y.js}

@@ -1,19 +1,19 @@
 import {
+  createSpawnTool,
   edit,
   listFiles,
   multiEdit,
   readFile,
   shell,
-  spawn,
   writeFile
-} from "./chunk-2AE3VM5O.js";
+} from "./chunk-Z2E5QN5X.js";
 
 // src/presets/basic.ts
 var basicTools = { shell, readFile, writeFile, listFiles, edit, multiEdit };
 var basic_default = definePreset({
   name: "basic",
   system: "You are a helpful assistant with access to shell, file reading, file writing, surgical and multi-edit tools, directory listing, and sub-agent spawning. Prefer `edit` / `multi_edit` for in-place changes and `write_file` for full file overwrites. Use them to accomplish tasks in the project directory.",
-  tools: { ...basicTools, spawn }
+  tools: { ...basicTools, spawn: createSpawnTool() }
 });
 
 // src/presets/index.ts

package/dist/{chunk-BW3WTFIR.js → chunk-LIVB5W4B.js}

@@ -1,6 +1,6 @@
 import {
   validateSkillForWrite
-} from "./chunk-TPXPVEH6.js";
+} from "./chunk-X3VOTPVM.js";
 
 // src/skills/index.ts
 function defineSkill(config) {

package/dist/{chunk-IUBBVF53.js → chunk-UD25QF3H.js}

@@ -78,19 +78,77 @@ function createDockerContext(config) {
       const stream = await exec.start({ Detach: false });
       return new Promise((resolve2) => {
         let stdout = "";
-        const stderr = "";
+        let stderr = "";
+        let resolved = false;
+        const stdoutSink = {
+          write(chunk) {
+            stdout += typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+            return true;
+          },
+          end() {
+          },
+          on() {
+          },
+          once() {
+          },
+          emit() {
+            return true;
+          }
+        };
+        const stderrSink = {
+          write(chunk) {
+            stderr += typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+            return true;
+          },
+          end() {
+          },
+          on() {
+          },
+          once() {
+          },
+          emit() {
+            return true;
+          }
+        };
+        try {
+          ref.docker.modem.demuxStream(stream, stdoutSink, stderrSink);
+        } catch {
+          stream.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+          });
+        }
         const timeout = options?.timeout ?? defaultLimits?.timeout ?? 30;
         const timer = setTimeout(() => {
-          resolve2({ stdout, stderr: `${stderr}
-[timeout]`, exitCode: 124 });
+          if (resolved)
+            return;
+          resolved = true;
+          try {
+            stream.destroy?.();
+          } catch {
+          }
+          resolve2({ stdout, stderr: stderr ? `${stderr}
+[timeout]` : "[timeout]", exitCode: 124 });
         }, timeout * 1e3);
-        stream.on("data", (chunk) => {
-          stdout += chunk.toString("utf-8");
-        });
         stream.on("end", async () => {
+          if (resolved)
+            return;
+          resolved = true;
+          clearTimeout(timer);
+          let exitCode = 0;
+          try {
+            const inspect = await exec.inspect();
+            exitCode = inspect.ExitCode ?? 0;
+          } catch {
+          }
+          resolve2({ stdout, stderr, exitCode });
+        });
+        stream.on("error", (err) => {
+          if (resolved)
+            return;
+          resolved = true;
           clearTimeout(timer);
-          const inspect = await exec.inspect();
-          resolve2({ stdout, stderr, exitCode: inspect.ExitCode ?? 0 });
+          resolve2({ stdout, stderr: stderr ? `${stderr}
+${err.message}` : err.message, exitCode: 1 });
         });
       });
     },

package/dist/{chunk-BRMURQA2.js → chunk-VGFQEOHF.js}

@@ -5,7 +5,7 @@ import {
   toAnthropic,
   toolResultsMessage,
   userMessage
-} from "./chunk-YQ7LY6CL.js";
+} from "./chunk-X244RS5H.js";
 import {
   matchesContextExceeded
 } from "./chunk-LNN5UTS2.js";
@@ -365,20 +365,7 @@ function anthropic(anthropicParams) {
         input_schema: t.inputSchema
       }));
     },
-    userMessage(content, images) {
-      if (images && images.length > 0) {
-        return {
-          role: "user",
-          content: [
-            ...images.map((img) => ({
-              type: "image",
-              mediaType: img.source.media_type,
-              data: img.source.data
-            })),
-            { type: "text", text: content }
-          ]
-        };
-      }
+    userMessage(content) {
       return { role: "user", content: [{ type: "text", text: content }] };
     },
     assistantMessage(content) {

package/dist/{chunk-YQ7LY6CL.js → chunk-X244RS5H.js}

@@ -246,20 +246,7 @@ function formatTools(tools) {
     function: { name: t.name, description: t.description, parameters: t.inputSchema }
   }));
 }
-function userMessage(content, images) {
-  if (images?.length) {
-    return {
-      role: "user",
-      content: [
-        ...images.map((img) => ({
-          type: "image",
-          mediaType: img.source.media_type,
-          data: img.source.data
-        })),
-        { type: "text", text: content }
-      ]
-    };
-  }
+function userMessage(content) {
   return { role: "user", content: [{ type: "text", text: content }] };
 }
 function assistantMessage(content) {
@@ -532,22 +519,31 @@ function fromOpenAI(msg) {
     content.push({ type: "text", text: c });
     return { role, content };
   }
-  if (typeof c === "object" && c._tag === ASSISTANT_TOOL_CALLS_TAG) {
-    if (c.text) {
-      content.push({ type: "text", text: c.text });
+  if (typeof c === "object" && !Array.isArray(c) && c._tag === ASSISTANT_TOOL_CALLS_TAG) {
+    const tagged = c;
+    if (typeof tagged.text === "string" && tagged.text) {
+      content.push({ type: "text", text: tagged.text });
     }
-    if (Array.isArray(c.tool_calls)) {
-      for (const tc of c.tool_calls) {
-        const input = tc.function?.arguments ? typeof tc.function.arguments === "string" ? JSON.parse(tc.function.arguments) : tc.function.arguments : {};
-        content.push({ type: "tool_call", id: tc.id, name: tc.function?.name ?? "", input });
+    if (Array.isArray(tagged.tool_calls)) {
+      for (const raw of tagged.tool_calls) {
+        if (!raw || typeof raw !== "object")
+          continue;
+        const tc = raw;
+        const rawArgs = tc.function?.arguments;
+        const input = rawArgs ? typeof rawArgs === "string" ? JSON.parse(rawArgs) : rawArgs : {};
+        content.push({ type: "tool_call", id: tc.id ?? "", name: tc.function?.name ?? "", input });
       }
     }
     return { role, content };
   }
-  if (typeof c === "object" && c._tag === TOOL_RESULTS_TAG) {
-    if (Array.isArray(c.results)) {
-      for (const r of c.results) {
-        content.push({ type: "tool_result", callId: r.tool_call_id, output: r.content });
+  if (typeof c === "object" && !Array.isArray(c) && c._tag === TOOL_RESULTS_TAG) {
+    const tagged = c;
+    if (Array.isArray(tagged.results)) {
+      for (const raw of tagged.results) {
+        if (!raw || typeof raw !== "object")
+          continue;
+        const r = raw;
+        content.push({ type: "tool_result", callId: r.tool_call_id ?? "", output: r.content ?? "" });
       }
     }
     return { role, content };
@@ -649,8 +645,10 @@ function toOpenAI(msg) {
 }
 function autoDetectAndConvert(msg) {
   const c = msg.content;
-  if (c && typeof c === "object" && typeof c._tag === "string" && c._tag.startsWith("__zidane_")) {
-    return fromOpenAI(msg);
+  if (c && typeof c === "object" && !Array.isArray(c)) {
+    const tag = c._tag;
+    if (typeof tag === "string" && tag.startsWith("__zidane_"))
+      return fromOpenAI(msg);
   }
   if (Array.isArray(c)) {
     for (const block of c) {

package/dist/{chunk-TPXPVEH6.js → chunk-X3VOTPVM.js}

@@ -252,10 +252,9 @@ function installAllowedToolsGate(hooks, state) {
 }
 
 // src/skills/catalog.ts
-function buildCatalog(skills, optionsOrReadToolName = {}) {
+function buildCatalog(skills, options = {}) {
   if (skills.length === 0)
     return "";
-  const options = typeof optionsOrReadToolName === "string" ? { skillsToolRegistered: false, readToolName: optionsOrReadToolName } : optionsOrReadToolName;
   const skillsToolRegistered = options.skillsToolRegistered ?? true;
   const readToolName = options.readToolName ?? "read_file";
   const entries = skills.map((skill) => {
@@ -740,11 +739,12 @@ function writeSkillsToDisk(skills, targetDir) {
 }
 
 // src/skills/resolve.ts
-import { mkdtempSync } from "fs";
+import { mkdtempSync, rmSync } from "fs";
 import { tmpdir } from "os";
 import { join as join3 } from "path";
 async function resolveSkills(config) {
   const sourcedPaths = [];
+  let writeDir;
   if (!config.skipDefaultPaths) {
     sourcedPaths.push(...getDefaultScanPaths());
   }
@@ -752,7 +752,7 @@ async function resolveSkills(config) {
     sourcedPaths.push({ path: p, source: inferSource(p) });
   }
   if (config.write?.length) {
-    const writeDir = mkdtempSync(join3(tmpdir(), "zidane-skills-"));
+    writeDir = mkdtempSync(join3(tmpdir(), "zidane-skills-"));
     writeSkillsToDisk(config.write, writeDir);
     sourcedPaths.push({ path: writeDir, source: "inline" });
   }
@@ -766,7 +766,14 @@ async function resolveSkills(config) {
     const allowlist = new Set(config.enabled);
     filtered = filtered.filter((s) => allowlist.has(s.name));
   }
-  return filtered;
+  const cleanup = writeDir ? () => {
+    try {
+      rmSync(writeDir, { recursive: true, force: true });
+    } catch {
+    }
+  } : () => {
+  };
+  return { skills: filtered, cleanup };
 }
 
 // src/skills/interpolate.ts