zidane 3.0.1 → 3.1.0

package/README.md

@@ -12,25 +12,17 @@ Built to be embedded.
 
 ## Features
 
-- 🧠 **Multi-provider** — Anthropic, OpenAI Codex, OpenRouter, Cerebras, plus a generic `openaiCompat` factory (Baseten, Fireworks, Groq, local servers). OAuth + API-key auth, auto-refreshing tokens.
-- 🔁 **Streaming turn loop** — stream text + thinking deltas, tool calls, and tool results with hookable events at every step.
-- 🛠 **Tools first-class** — `shell`, `read_file`, `write_file`, `edit`, `multi_edit`, `glob`, `grep`, `spawn`, human-in-the-loop, plus any [MCP](https://modelcontextprotocol.io) server. Sequential or parallel execution, per-call gates, typed hooks. Built-in tools ship with sensible truncation and idempotency defaults so consumers don't have to polyfill them.
-- ✂️ **Token-aware tool ergonomics** — `read_file` line-paginates with a footer that documents how to read the rest, `shell` tail-truncates combined output at 8 KB, `write_file` returns `No change needed` on idempotent writes. `outputBytes` surfaced on every tool/mcp hook.
-- 🧰 **Self-healing tool args** — `validateToolArgs` auto-coerces small/OSS-model mistakes (`"true"` → `true`, `"42"` → `42`, JSON-encoded arrays) before reaching `execute`. `validation:reject` fires only on irrecoverable mismatches.
-- 🪤 **Hallucinated tool names** handled — `tool:unknown` fires before the default error so consumers can substitute a friendly response.
-- 📉 **Per-turn output budget** — `behavior.toolOutputBudget` injects a "summarize before continuing" message when a turn's tool outputs exceed the cap. Off by default.
-- 🧩 **[Agent Skills](https://agentskills.io/specification) spec-aligned** — discover, activate, and run skills with `allowed-tools` enforcement and session-resume rehydration.
-- 💾 **Pluggable sessions** — in-memory, SQLite, remote HTTP, or a file-map adapter. Turns persist incrementally — a crash leaves valid partial history.
-- 🖼 **Multimodal** — images + documents via `PromptPart[]`; tools can return image blocks (screenshots, diagrams) routed natively on vision providers and via companion messages elsewhere.
-- 🧠 **Extended thinking** — named levels (`off` / `minimal` / `low` / `medium` / `high`) or exact token budgets; traces streamed + persisted.
-- ⚡ **Prompt caching** — auto-injected `cache_control` breakpoints on Anthropic + OpenRouter routes; cache-read / cache-write surfaced on `TurnUsage`.
-- 🚀 **Parallel MCP bootstrap** — every server connects concurrently with per-server timeouts; `agent.warmup()` + `eager: true` hide cold-start latency.
-- 🎯 **Structured output** — force the final answer to match a JSON Schema (Zod v4 interop), no brittle parsing.
-- 🧵 **Sub-agent spawning** — delegate to child agents with inherited or overridden preset; child stream/tool events bubble to the parent.
-- 🧭 **Typed errors** — `AgentContextExceededError` / `AgentProviderError` / `AgentAbortedError` instead of sniffing error strings.
-- 🔌 **Execution contexts** — run tools in-process, in Docker, or in a remote sandbox (E2B / Rivet / any `SandboxProvider`).
-- 🪝 **Hookable everything** — typed hook events covering turn, stream, tool, MCP, session, skills, spawn, OAuth refresh, bootstrap timing, validation rejection / coercion, and budget overflow.
-- 🧪 **1000+ tests, zero API keys** — mock providers + mock execution contexts; suite runs in under 2 seconds.
+A small, hookable core with sensible defaults so most consumers don't write a single hook. Built around three principles: **token discipline by default** (cache, dedup, compaction, byte-accounting), **self-healing on the fault paths** (auto-coerce args, hallucinated-tool fallback, error rewriting), and **provider parity** (server-side features on Anthropic, client-side equivalents everywhere else).
+
+- 🧠 **Multi-provider, multi-auth** — Anthropic, OpenAI Codex, OpenRouter, Cerebras, plus a generic `openaiCompat` factory (Baseten, Fireworks, Groq, local servers). OAuth + API key, auto-refreshing tokens. Anthropic accepts opt-in `extraBetas` and `contextManagement` for first-party features.
+- 🪝 **Streaming, hookable turn loop** — text/thinking deltas, tool calls, MCP, sessions, skills, spawn, OAuth, validation, budgets — all observable (and most mutatable) via typed hook events.
+- 🛠 **Tools first-class** — `shell`, `read_file`, `write_file`, `edit`, `multi_edit`, `glob`, `grep`, `spawn`, human-in-the-loop, plus any [MCP](https://modelcontextprotocol.io) server. Sequential or parallel, per-call gates (`tool:gate`), validation auto-coerce (`"true"` → `true`), hallucinated-tool fallback (`tool:unknown`), error rewriting (`tool:error` → `result`).
+- ✂️ **Token-aware ergonomics** — paginated reads with a "how to page" footer, 8 KB tail-truncated `shell`, idempotent `write_file`; `outputBytes` surfaced on every tool/MCP hook. `behavior.toolOutputBudget` injects a "summarize" nudge when a turn's outputs exceed the cap.
+- 🗜 **Context discipline** — auto-injected `cache_control` breakpoints (Anthropic + OpenRouter); server-side compaction via `context-management-2025-06-27` on Anthropic, `behavior.compactStrategy: 'tail'` on everyone else. Per-session `read_file` dedup + opt-in `requireReadBeforeEdit` guard kill stale-content edits.
+- 🎯 **Reasoning + structured output** — thinking levels (`off` / `minimal` / `low` / `medium` / `high` / `adaptive`) with optional exact budgets; force the final answer to a JSON Schema (Zod v4 interop), no brittle parsing.
+- 💾 **Sessions, skills, multimodal** — pluggable session stores (memory / SQLite / remote / file-map), incremental persistence; [Agent Skills](https://agentskills.io/specification) spec-aligned with `allowed-tools` enforcement + resume rehydration; images + documents via `PromptPart[]`, tools can return image blocks routed natively on vision providers or via companion messages elsewhere.
+- 🧵 **Sub-agents + execution contexts** — delegate to child agents with inherited or overridden preset (child events bubble to the parent); run tools in-process, Docker, or any `SandboxProvider` (E2B / Rivet / custom). Parallel MCP bootstrap with `agent.warmup()` + `eager: true` to hide cold starts.
+- 🧭 **Typed errors + 1000+ tests** — `AgentContextExceededError` / `AgentProviderError` / `AgentAbortedError` instead of sniffing strings. Suite runs in under 2s with mock providers + mock execution contexts, zero API keys.
 
 > Upgrading from 2.x? See [`docs/migrate-from-v2.md`](./docs/migrate-from-v2.md) for the full list of behavior changes.
 
@@ -77,6 +69,11 @@ createAgent({
     thinkingBudget: 10240,           // exact thinking token budget
     cache: true,                     // prompt-cache breakpoints on supported providers (default: true)
     toolOutputBudget: 32768,         // soft per-turn cap on tool-output bytes (off by default)
+    dedupReads: true,                // dedup identical re-reads of the same file in `read_file` (default: true)
+    requireReadBeforeEdit: false,    // refuse `edit` / `multi_edit` against unread or stale files (default: false)
+    compactStrategy: 'off',          // client-side tail compaction for non-Anthropic providers — 'off' | 'tail' (default: 'off')
+    compactThreshold: 131_072,       // bytes threshold that triggers tail compaction (default: 128 KiB)
+    compactKeepTurns: 4,             // trailing turns left intact during compaction (default: 4)
   },
   execution: createProcessContext(), // where tools run
   mcpServers: [],                    // MCP tool servers
@@ -141,10 +138,30 @@ anthropic({ apiKey: 'sk-ant-...' })
 anthropic({ access: 'sk-ant-oat-...' })                      // OAuth
 anthropic({ access: 'sk-ant-oat-...', refresh: '...', expires: Date.now() + 3600_000 }) // auto-refresh
 anthropic({ apiKey: '...', defaultModel: 'claude-sonnet-4-6' })
+
+// Opt into first-party Anthropic betas + server-side context compaction:
+anthropic({
+  apiKey: '...',
+  extraBetas: [
+    'context-management-2025-06-27',     // server-side, token-accurate compaction
+    'token-efficient-tools-2026-03-28',  // ~4.5% output token reduction
+    'interleaved-thinking-2025-05-14',   // think between tool calls in one turn
+  ],
+  contextManagement: {
+    edits: [{
+      type: 'clear_tool_uses_20250919',
+      trigger: { type: 'input_tokens', value: 180_000 },
+      clear_at_least: { type: 'input_tokens', value: 140_000 },
+      clear_tool_inputs: ['Read', 'Bash', 'Grep', 'Glob'],
+    }],
+  },
+})
 ```
 
 Fallback: `params.apiKey` > `params.access` > `ANTHROPIC_API_KEY` env > `.credentials.json`
 
+`extraBetas` are merged with the OAuth defaults (`claude-code-20250219`, `oauth-2025-04-20`) and de-duped. `contextManagement` is sent on the request body as `context_management`; pair it with the `context-management-2025-06-27` beta. For non-Anthropic providers, see `behavior.compactStrategy: 'tail'` for the client-side fallback.
+
 ### OpenRouter
 
 ```ts
@@ -270,6 +287,7 @@ Extended reasoning with named levels or exact token budgets.
 | `low` | 4,096 tokens |
 | `medium` | 10,240 tokens |
 | `high` | 32,768 tokens |
+| `adaptive` | model self-budgets per turn |
 
 ```ts
 // Named level
@@ -278,12 +296,18 @@ await agent.run({ prompt: 'solve this', thinking: 'high' })
 // Exact budget (overrides level default)
 await agent.run({ prompt: 'solve this', thinking: 'high', behavior: { thinkingBudget: 50000 } })
 
+// Adaptive — model self-budgets, but `thinkingBudget` caps the response envelope
+// (max_tokens) to soft-bound runaway thinking on Anthropic.
+await agent.run({ prompt: 'solve this', thinking: 'adaptive', behavior: { thinkingBudget: 32000 } })
+
 // Agent-level default
 const agent = createAgent({ ...basic, provider, 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).
 
+`adaptive` is Anthropic-specific (`thinking.type='adaptive'`) and avoids the `thinking.type='enabled'` deprecation warning on opus 4.6+. It has no native budget knob — when `thinkingBudget` is paired with `adaptive`, zidane caps `max_tokens = min(maxTokens, thinkingBudget)` so unbounded reasoning can't run away. Other providers fall back to no reasoning when `adaptive` is selected.
+
 ## Hooks
 
 Every hook receives a mutable context object.
@@ -352,7 +376,11 @@ agent.hooks.hook('tool:gate', (ctx) => {
 
 agent.hooks.hook('tool:before', (ctx) => { /* ctx.turnId, ctx.callId, ctx.name, ctx.input, ctx.coercions? */ })
 agent.hooks.hook('tool:after', (ctx) => { /* + ctx.result, ctx.outputBytes, ctx.coercions? */ })
-agent.hooks.hook('tool:error', (ctx) => { /* + ctx.error */ })
+agent.hooks.hook('tool:error', (ctx) => {
+  // + ctx.error. Mutate ctx.result to substitute the payload sent back to the
+  // model in place of the default `Tool error: <msg>` — useful for OSS-model
+  // error rewriting (collapse stack traces, prepend recovery hints).
+})
 agent.hooks.hook('tool:transform', (ctx) => {
   // + ctx.result, ctx.isError, ctx.outputBytes (pre-mutation), ctx.coercions? — mutate result/isError to modify.
   // Built-in tools already truncate; use this hook for consumer concerns the framework can't infer,
@@ -458,6 +486,30 @@ agent.hooks.hook('budget:exceeded', (ctx) => {
 })
 ```
 
+### Client-side context compaction (non-Anthropic)
+
+For non-Anthropic providers (cerebras / openai-compat / openrouter on OSS models), `behavior.compactStrategy: 'tail'` elides older `tool_result` blocks from the wire-level message list once their combined size exceeds `compactThreshold`. The newest `compactKeepTurns` messages stay intact so the model retains the freshest tool context.
+
+```ts
+const agent = createAgent({
+  ...basic,
+  provider: cerebras({ apiKey: '...' }),
+  behavior: {
+    compactStrategy: 'tail',
+    compactThreshold: 131_072,  // 128 KiB; default
+    compactKeepTurns: 4,        // default
+  },
+})
+```
+
+Anthropic users should prefer the server-side `context-management-2025-06-27` beta (token-accurate, configured via `anthropic({ extraBetas, contextManagement })`) — `'tail'` is a client-side approximation that exists because OSS-model providers have no server-side equivalent.
+
+### Read dedup + read-before-edit guard
+
+`behavior.dedupReads` (on by default) — `read_file` returns a short `"unchanged since the previous read"` stub instead of re-emitting bytes when the model re-reads the same file with the same slice. Per-session content-hash; requires a session.
+
+`behavior.requireReadBeforeEdit` (off by default) — `edit` and `multi_edit` reject when the file hasn't been read in the session, or when its on-disk content has drifted since the last read. Eliminates the silent-corruption case where a model edits against bytes it "remembers" but no longer reflect reality. Recommended on for stricter eval-grade runs.
+
 ## Steering and Follow-up
 
 ### Steering

package/dist/{agent-4zeSbdXy.d.ts → agent-O5SmWixc.d.ts}

@@ -216,6 +216,62 @@ interface AgentBehavior {
      * starting value for OSS-model integrations is `32768`.
      */
     toolOutputBudget?: number;
+    /**
+     * Deduplicate identical re-reads of the same file in `read_file`. When the
+     * model re-reads a file with the same slice and the bytes haven't changed
+     * since the last read in this session, the tool returns a short stub
+     * instead of re-emitting the full content. Pairs with the read-before-edit
+     * guard in `edit` / `multi_edit`.
+     *
+     * Requires a session (set via `createSession()`); without one, the flag is
+     * a no-op since per-session state has nowhere to live.
+     *
+     * Default: `true`.
+     */
+    dedupReads?: boolean;
+    /**
+     * Require `read_file` before `edit` / `multi_edit` on the same path, and
+     * reject edits when the file has changed on disk since the last read in
+     * this session. Eliminates the silent-corruption failure mode where a
+     * 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.
+     *
+     * Default: `false`.
+     */
+    requireReadBeforeEdit?: boolean;
+    /**
+     * Client-side context compaction strategy. Use this for non-Anthropic
+     * providers (OSS via cerebras / openai-compat / openrouter) that don't
+     * have a server-side equivalent. Anthropic users should prefer the
+     * server-side `context-management-2025-06-27` beta — see
+     * `AnthropicParams.contextManagement`.
+     *
+     * - `'off'` (default) — no client-side compaction.
+     * - `'tail'` — when total tool-output bytes in the persisted history
+     *   exceed `compactThreshold`, replace older `tool_result` outputs with a
+     *   short stub, keeping the newest `compactKeepTurns` turns intact. The
+     *   compaction is applied to the wire-level message list only; the
+     *   underlying session turns are not modified.
+     *
+     * Default: `'off'`.
+     */
+    compactStrategy?: 'off' | 'tail';
+    /**
+     * Soft byte threshold that triggers tail compaction when
+     * `compactStrategy === 'tail'`. Counts the post-`context:transform` bytes
+     * of `tool_result` outputs across all messages. Default: `131_072` (128
+     * KiB). Ignored when compaction is off.
+     */
+    compactThreshold?: number;
+    /**
+     * Number of trailing turns to leave untouched during tail compaction. The
+     * most-recent `compactKeepTurns` user/assistant messages are not eligible
+     * for elision so the model keeps the freshest tool context. Default: `4`.
+     */
+    compactKeepTurns?: number;
 }
 interface ImageContent {
     type: 'image';
@@ -541,6 +597,18 @@ interface OAuthRefreshHookContext {
 }
 type SessionEndStatus = 'completed' | 'aborted' | 'error';
 
+/**
+ * Server-side context-management config — the body of `context_management` on
+ * the Messages API. Typed loosely (Record-of-unknown) so we don't pin a specific
+ * SDK schema version: the v0.90 SDK does not yet type this field, but the wire
+ * format is stable behind the `context-management-2025-06-27` beta.
+ *
+ * See: https://docs.anthropic.com/en/docs/build-with-claude/context-management
+ */
+interface AnthropicContextManagement {
+    edits?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}
 interface AnthropicParams {
     apiKey?: string;
     access?: string;
@@ -553,6 +621,43 @@ interface AnthropicParams {
      * gateways, internal router).
      */
     baseURL?: string;
+    /**
+     * Additional `anthropic-beta` flags to opt into. Merged with the OAuth-path
+     * defaults (`claude-code-20250219`, `oauth-2025-04-20`); duplicates are
+     * de-duped. Examples:
+     *
+     * - `'context-management-2025-06-27'` — server-side context compaction
+     *   (token-accurate; pair with {@link AnthropicParams.contextManagement}).
+     * - `'token-efficient-tools-2026-03-28'` — terser tool_use wire format.
+     * - `'interleaved-thinking-2025-05-14'` — think between tool calls within
+     *   one turn.
+     * - `'redact-thinking-2026-02-12'` — replace large thinking blocks with
+     *   stubs server-side.
+     * - `'prompt-caching-scope-2026-01-05'` — extended prompt-cache scope.
+     *
+     * Honored on both the OAuth and API-key paths.
+     */
+    extraBetas?: readonly string[];
+    /**
+     * Server-side context-management directive. Sent on the request body as
+     * `context_management`. Requires the `context-management-2025-06-27` beta —
+     * add it to {@link AnthropicParams.extraBetas}.
+     *
+     * Typed loosely so future Anthropic schema additions land without an SDK
+     * bump. A typical compaction edit:
+     *
+     * ```ts
+     * contextManagement: {
+     *   edits: [{
+     *     type: 'clear_tool_uses_20250919',
+     *     trigger: { type: 'input_tokens', value: 180_000 },
+     *     clear_at_least: { type: 'input_tokens', value: 140_000 },
+     *     clear_tool_inputs: ['Read', 'Bash', 'Grep'],
+     *   }],
+     * }
+     * ```
+     */
+    contextManagement?: AnthropicContextManagement;
 }
 declare function anthropic(anthropicParams?: AnthropicParams): Provider;
 
@@ -1466,8 +1571,18 @@ interface AgentHooks {
         outputBytes: number;
         coercions?: readonly string[];
     }) => void;
+    /**
+     * Fires when a tool throws during execution. Mutate `result` to substitute a
+     * tool-output payload that gets sent back to the model in place of the
+     * default `Tool error: <msg>` string — useful for OSS-model error rewriting
+     * (collapse stack traces, hide internal paths, prepend recovery hints).
+     *
+     * The post-hook value flows through `tool:transform` like a normal output, so
+     * downstream byte-budgeting and image-stripping still apply.
+     */
     'tool:error': (ctx: ToolHookContext & {
         error: Error;
+        result?: string | ToolResultContent[];
     }) => void;
     'tool:transform': (ctx: ToolHookContext & {
         result: string | ToolResultContent[];

package/dist/{chunk-HQD5ICI6.js → chunk-FEAOZ5DB.js}

@@ -5,7 +5,7 @@ import {
   toAnthropic,
   toolResultsMessage,
   userMessage
-} from "./chunk-CYWF2U62.js";
+} from "./chunk-VF4A7HAC.js";
 import {
   matchesContextExceeded
 } from "./chunk-LNN5UTS2.js";
@@ -132,6 +132,28 @@ async function loadAnthropicSdk() {
     );
   }
 }
+var OAUTH_DEFAULT_BETAS = ["claude-code-20250219", "oauth-2025-04-20"];
+function resolveAnthropicBetas(isOAuth, extraBetas) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  if (isOAuth) {
+    for (const b of OAUTH_DEFAULT_BETAS) {
+      if (!seen.has(b)) {
+        seen.add(b);
+        out.push(b);
+      }
+    }
+  }
+  if (extraBetas) {
+    for (const b of extraBetas) {
+      if (typeof b === "string" && b.length > 0 && !seen.has(b)) {
+        seen.add(b);
+        out.push(b);
+      }
+    }
+  }
+  return out.length > 0 ? out.join(",") : void 0;
+}
 function getConfiguredApiKey(anthropicParams) {
   if (anthropicParams?.apiKey)
     return anthropicParams.apiKey;
@@ -144,22 +166,31 @@ function getConfiguredApiKey(anthropicParams) {
     return access;
   throw new Error("No API key found. Run `bun run auth` first.");
 }
-function createClient(SDK, apiKey, isOAuth, baseURL) {
+function createClient(SDK, apiKey, isOAuth, baseURL, extraBetas) {
   const base = baseURL ? { baseURL } : {};
-  return new SDK(
-    isOAuth ? {
+  const betaHeader = resolveAnthropicBetas(isOAuth, extraBetas);
+  if (isOAuth) {
+    const defaultHeaders2 = {
+      "anthropic-dangerous-direct-browser-access": "true",
+      "user-agent": "zidane/2.0.0",
+      "x-app": "cli"
+    };
+    if (betaHeader)
+      defaultHeaders2["anthropic-beta"] = betaHeader;
+    return new SDK({
       apiKey: null,
       authToken: apiKey,
       dangerouslyAllowBrowser: true,
-      defaultHeaders: {
-        "anthropic-beta": "claude-code-20250219,oauth-2025-04-20",
-        "anthropic-dangerous-direct-browser-access": "true",
-        "user-agent": "zidane/2.0.0",
-        "x-app": "cli"
-      },
+      defaultHeaders: defaultHeaders2,
       ...base
-    } : { apiKey, ...base }
-  );
+    });
+  }
+  const defaultHeaders = betaHeader ? { "anthropic-beta": betaHeader } : void 0;
+  return new SDK({
+    apiKey,
+    ...defaultHeaders ? { defaultHeaders } : {},
+    ...base
+  });
 }
 var EFFORT_FOR_LEVEL = {
   minimal: "low",
@@ -170,8 +201,11 @@ var EFFORT_FOR_LEVEL = {
 function planAnthropicThinking(level, customBudget) {
   if (level === "off")
     return null;
-  if (level === "adaptive")
+  if (level === "adaptive") {
+    if (typeof customBudget === "number" && customBudget > 0)
+      return { kind: "adaptive", maxTokensCap: customBudget };
     return { kind: "adaptive" };
+  }
   if (customBudget !== void 0) {
     return { kind: "enabled", budgetTokens: customBudget, maxTokensBump: customBudget };
   }
@@ -384,7 +418,13 @@ function anthropic(anthropicParams) {
           }
         }
       );
-      const client = createClient(SDK, apiKey, apiKey.includes("sk-ant-oat"), anthropicParams?.baseURL);
+      const client = createClient(
+        SDK,
+        apiKey,
+        apiKey.includes("sk-ant-oat"),
+        anthropicParams?.baseURL,
+        anthropicParams?.extraBetas
+      );
       const system = isOAuth ? `You are Claude Code, Anthropic's official CLI for Claude.` : options.system;
       const messages = isOAuth && options.system ? [
         { role: "user", content: [{ type: "text", text: options.system }] },
@@ -401,6 +441,10 @@ function anthropic(anthropicParams) {
         messages: messages.map((m) => toAnthropic(m)),
         stream: true
       };
+      if (anthropicParams?.contextManagement) {
+        ;
+        params.context_management = anthropicParams.contextManagement;
+      }
       if (options.cache !== false)
         applyAnthropicCacheBreakpoints(params);
       const plan = planAnthropicThinking(thinking, options.thinkingBudget);
@@ -412,6 +456,8 @@ function anthropic(anthropicParams) {
           params.thinking = { type: "adaptive" };
           if (plan.effort)
             params.output_config = { effort: plan.effort };
+          if (typeof plan.maxTokensCap === "number" && plan.maxTokensCap > 0)
+            params.max_tokens = Math.min(params.max_tokens, plan.maxTokensCap);
         }
         params.temperature = 1;
       }

package/dist/{chunk-QFHGWKK3.js → chunk-PYLYK3K7.js}

@@ -37,6 +37,27 @@ function countExactMatches(haystack, needle) {
   return count;
 }
 
+// src/tools/read-state.ts
+var STATE = /* @__PURE__ */ new WeakMap();
+function getReadState(session) {
+  if (!session)
+    return void 0;
+  let map = STATE.get(session);
+  if (!map) {
+    map = /* @__PURE__ */ new Map();
+    STATE.set(session, map);
+  }
+  return map;
+}
+function hashContent(text) {
+  let h = 2166136261;
+  for (let i = 0; i < text.length; i++) {
+    h ^= text.charCodeAt(i);
+    h = h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24)) >>> 0;
+  }
+  return h.toString(16).padStart(8, "0");
+}
+
 // src/tools/edit.ts
 var edit = {
   spec: {
@@ -68,6 +89,15 @@ var edit = {
     } catch {
       return `Edit error: file not found: ${target}`;
     }
+    if (ctx.behavior?.requireReadBeforeEdit && ctx.session) {
+      const readState = getReadState(ctx.session);
+      const absKey = `${ctx.handle.cwd}::${target}`;
+      const prior = readState?.get(absKey);
+      if (!prior)
+        return `Edit error: ${target} has not been read in this session. Call read_file first so the edit applies against the current contents.`;
+      if (prior.contentHash !== hashContent(original))
+        return `Edit error: ${target} has changed on disk since the last read. Re-read the file before editing.`;
+    }
     const occurrences = countExactMatches(original, find);
     if (occurrences === 0) {
       const preview = nearestMatchPreview(original, find);
@@ -79,6 +109,14 @@ var edit = {
     if (updated === original)
       return `Edit error: replacement produced no change in ${target}.`;
     await ctx.execution.writeFile(ctx.handle, target, updated);
+    if (ctx.session) {
+      const readState = getReadState(ctx.session);
+      const absKey = `${ctx.handle.cwd}::${target}`;
+      const prior = readState?.get(absKey);
+      if (readState && prior) {
+        readState.set(absKey, { ...prior, contentHash: hashContent(updated), mtimeMs: Date.now() });
+      }
+    }
     return `Edited ${target}: replaced ${occurrences} occurrence${occurrences === 1 ? "" : "s"}.`;
   }
 };
@@ -443,6 +481,15 @@ var multiEdit = {
     } catch {
       return `multi_edit error: file not found: ${target}`;
     }
+    if (ctx.behavior?.requireReadBeforeEdit && ctx.session) {
+      const readState = getReadState(ctx.session);
+      const absKey = `${ctx.handle.cwd}::${target}`;
+      const prior = readState?.get(absKey);
+      if (!prior)
+        return `multi_edit error: ${target} has not been read in this session. Call read_file first so the edits apply against the current contents.`;
+      if (prior.contentHash !== hashContent(current))
+        return `multi_edit error: ${target} has changed on disk since the last read. Re-read the file before editing.`;
+    }
     let applied = 0;
     for (let i = 0; i < steps.length; i++) {
       const step = steps[i];
@@ -464,6 +511,14 @@ var multiEdit = {
       applied += occurrences;
     }
     await ctx.execution.writeFile(ctx.handle, target, current);
+    if (ctx.session) {
+      const readState = getReadState(ctx.session);
+      const absKey = `${ctx.handle.cwd}::${target}`;
+      const prior = readState?.get(absKey);
+      if (readState && prior) {
+        readState.set(absKey, { ...prior, contentHash: hashContent(current), mtimeMs: Date.now() });
+      }
+    }
     return `Edited ${target}: applied ${steps.length} edit${steps.length === 1 ? "" : "s"} (${applied} replacement${applied === 1 ? "" : "s"}).`;
   }
 };
@@ -496,12 +551,25 @@ var readFile = {
       return `File not found: ${path}`;
     }
     const totalBytes = Buffer.byteLength(raw);
+    const dedupEnabled = ctx.behavior?.dedupReads !== false;
+    const readState = dedupEnabled ? getReadState(ctx.session) : void 0;
+    const absKey = `${ctx.handle.cwd}::${path}`;
+    const offsetForKey = normalizeInteger(offset, 1);
+    const limitForKey = normalizeInteger(limit, DEFAULT_LINE_LIMIT);
+    const maxBytesForKey = normalizeInteger(maxBytes, DEFAULT_BYTE_CAP);
+    const currentHash = readState ? hashContent(raw) : "";
+    if (readState) {
+      const prior = readState.get(absKey);
+      if (prior && prior.contentHash === currentHash && prior.offset === offsetForKey && prior.limit === limitForKey && prior.maxBytes === maxBytesForKey) {
+        return `File ${path} unchanged since the previous read in this session \u2014 the prior result is still current.`;
+      }
+    }
     if (looksBinary(raw)) {
       return `[binary file: ${path}, ${totalBytes} bytes; use shell with hexdump | xxd | od to inspect]`;
     }
-    const offsetN = normalizeInteger(offset, 1);
-    const limitN = normalizeInteger(limit, DEFAULT_LINE_LIMIT);
-    const maxBytesN = normalizeInteger(maxBytes, DEFAULT_BYTE_CAP);
+    const offsetN = offsetForKey;
+    const limitN = limitForKey;
+    const maxBytesN = maxBytesForKey;
     const lines = raw.split("\n");
     const totalLines = lines.length;
     const startIdx = Math.max(0, offsetN - 1);
@@ -546,6 +614,15 @@ var readFile = {
     const body = slice.join("\n");
     const linesReturned = slice.length;
     const lastLineRead = startIdx + linesReturned;
+    if (readState) {
+      readState.set(absKey, {
+        contentHash: currentHash,
+        offset: offsetN,
+        limit: limitN,
+        maxBytes: maxBytesN,
+        mtimeMs: Date.now()
+      });
+    }
     const linesTruncated = endIdx < totalLines || bytesCut;
     if (!linesTruncated && offsetN === 1)
       return body;
@@ -1101,6 +1178,43 @@ var IMAGE_OMITTED_MARKER = "[image omitted \u2014 model does not support vision]
 function turnsToMessages(turns) {
   return turns.filter((t) => t.role !== "system").map((t) => ({ role: t.role, content: t.content }));
 }
+var COMPACTION_STUB = "[\u2026elided by client-side tail compaction; ask the user or re-run the tool to retrieve.]";
+function applyTailCompaction(messages, threshold, keepTurns) {
+  if (messages.length === 0)
+    return messages;
+  let totalBytes = 0;
+  for (const msg of messages) {
+    for (const block of msg.content) {
+      if (block.type === "tool_result")
+        totalBytes += toolOutputByteLength(block.output);
+    }
+  }
+  if (totalBytes <= threshold)
+    return messages;
+  const keep = Math.max(0, keepTurns);
+  const cutoff = messages.length - keep;
+  if (cutoff <= 0)
+    return messages;
+  let changed = false;
+  const out = messages.slice();
+  for (let i = 0; i < cutoff; i++) {
+    const msg = out[i];
+    let msgChanged = false;
+    const newContent = msg.content.map((block) => {
+      if (block.type !== "tool_result")
+        return block;
+      const existingBytes = toolOutputByteLength(block.output);
+      if (existingBytes <= COMPACTION_STUB.length)
+        return block;
+      msgChanged = true;
+      changed = true;
+      return { ...block, output: COMPACTION_STUB };
+    });
+    if (msgChanged)
+      out[i] = { ...msg, content: newContent };
+  }
+  return changed ? out : messages;
+}
 function sanitizeStoredToolResults(provider, messages) {
   if (provider.meta.capabilities?.vision !== false)
     return messages;
@@ -1210,7 +1324,12 @@ async function executeTurn(ctx, turn) {
   const turnId = await ctx.generateTurnId();
   const canonicalMessages = turnsToMessages(ctx.turns);
   const wireMessages = rewriteMessagesToWire(canonicalMessages, ctx.aliasMaps);
-  const sanitizedMessages = sanitizeStoredToolResults(ctx.provider, wireMessages);
+  let sanitizedMessages = sanitizeStoredToolResults(ctx.provider, wireMessages);
+  if (ctx.compactStrategy === "tail") {
+    const threshold = typeof ctx.compactThreshold === "number" && ctx.compactThreshold > 0 ? ctx.compactThreshold : 131072;
+    const keep = typeof ctx.compactKeepTurns === "number" && ctx.compactKeepTurns >= 0 ? ctx.compactKeepTurns : 4;
+    sanitizedMessages = applyTailCompaction(sanitizedMessages, threshold, keep);
+  }
   const streamOptions = {
     model: ctx.model,
     system: ctx.system,
@@ -1479,15 +1598,16 @@ async function executeSingleTool(ctx, call, turnId) {
     output = await toolDef.execute(effectiveInput, toolCtx);
   } catch (err) {
     const error = err instanceof Error ? err : new Error(String(err));
-    await ctx.hooks.callHook("tool:error", {
+    const errorCtx = {
       turnId,
       callId,
       name: call.name,
       displayName,
       input: effectiveInput,
       error
-    });
-    output = `Tool error: ${error.message}`;
+    };
+    await ctx.hooks.callHook("tool:error", errorCtx);
+    output = errorCtx.result ?? `Tool error: ${error.message}`;
     isError = true;
   }
   const transformCtx = {
@@ -1690,7 +1810,10 @@ function resolveBehavior(agentBehavior, runBehavior) {
     thinkingBudget: runBehavior?.thinkingBudget ?? agentBehavior?.thinkingBudget,
     schema: runBehavior?.schema ?? agentBehavior?.schema,
     cache: runBehavior?.cache ?? agentBehavior?.cache ?? true,
-    toolOutputBudget: runBehavior?.toolOutputBudget ?? agentBehavior?.toolOutputBudget
+    toolOutputBudget: runBehavior?.toolOutputBudget ?? agentBehavior?.toolOutputBudget,
+    compactStrategy: runBehavior?.compactStrategy ?? agentBehavior?.compactStrategy ?? "off",
+    compactThreshold: runBehavior?.compactThreshold ?? agentBehavior?.compactThreshold,
+    compactKeepTurns: runBehavior?.compactKeepTurns ?? agentBehavior?.compactKeepTurns
   };
 }
 function createAgent({ provider, name: agentName, system: agentSystem, tools: agentTools, toolAliases, behavior: agentBehavior, execution, mcpServers, session, skills: agentSkills, mcpConnector, eager }) {
@@ -1813,7 +1936,7 @@ function createAgent({ provider, name: agentName, system: agentSystem, tools: ag
     }
     const thinking = options.thinking ?? "off";
     const model = options.model ?? provider.meta.defaultModel;
-    const { toolExecution, maxTurns, maxTokens, thinkingBudget, schema, cache, toolOutputBudget } = resolveBehavior(agentBehavior, options.behavior);
+    const { toolExecution, maxTurns, maxTokens, thinkingBudget, schema, cache, toolOutputBudget, compactStrategy, compactThreshold, compactKeepTurns } = resolveBehavior(agentBehavior, options.behavior);
     let system = options.system || agentSystem || "You are a helpful assistant.";
     if (skillsCatalog) {
       system = `${system}
@@ -1949,6 +2072,9 @@ ${skillsCatalog}`;
         schema,
         cache,
         toolOutputBudget,
+        compactStrategy,
+        compactThreshold,
+        compactKeepTurns,
         runStartMs
       });
       const finalStats = {

package/dist/{chunk-2VM47IBI.js → chunk-SARMZCEL.js}

@@ -6,7 +6,7 @@ import {
   shell,
   spawn,
   writeFile
-} from "./chunk-QFHGWKK3.js";
+} from "./chunk-PYLYK3K7.js";
 
 // src/presets/basic.ts
 var basicTools = { shell, readFile, writeFile, listFiles, edit, multiEdit };

package/dist/{chunk-CYWF2U62.js → chunk-VF4A7HAC.js}

@@ -433,6 +433,8 @@ function openaiCompat(params) {
         usage: {
           input: result.usage.input,
           output: result.usage.output,
+          ...result.usage.cacheRead !== void 0 ? { cacheRead: result.usage.cacheRead } : {},
+          ...result.usage.cacheCreation !== void 0 ? { cacheCreation: result.usage.cacheCreation } : {},
           ...result.usage.cost !== void 0 ? { cost: result.usage.cost } : {},
           ...finishReason ? { finishReason } : {},
           modelId

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import { d as AgentHooks } from './agent-4zeSbdXy.js';
-export { ac as ActivationVia, ad as ActiveSkill, A as Agent, a as AgentAbortedError, b as AgentBehavior, c as AgentContextExceededError, e as AgentOptions, f as AgentProviderError, g as AgentRunOptions, h as AgentStats, i as AgentToolNotAllowedError, j as AnthropicParams, C as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, k as CerebrasParams, m as ClassifiedError, n as ClassifiedErrorKind, o as CreateSessionOptions, ae as DeactivationReason, af as FileMapAdapter, ag as FileMapStoreOptions, I as ImageContent, M as McpConnection, p as McpServerConfig, q as McpToolHookContext, O as OAuthRefreshHookContext, ah as OpenAICompatAuthHeader, ai as OpenAICompatHttpError, aj as OpenAICompatParams, r as OpenAIParams, s as OpenRouterParams, P as PromptDocumentPart, t as PromptImagePart, u as PromptPart, v as PromptTextPart, w as Provider, x as ProviderCapabilities, R as RemoteStoreOptions, y as RunHookMap, S as Session, z as SessionContentBlock, B as SessionData, D as SessionEndStatus, E as SessionHookContext, F as SessionMessage, G as SessionRun, H as SessionStore, J as SessionTurn, ak as SkillActivationState, al as SkillActivationStateOptions, K as SkillConfig, am as SkillDiagnostic, L as SkillResource, an as SkillSource, N as SkillsConfig, Q as SpawnHookContext, T as StreamCallbacks, U as StreamHookContext, V as StreamOptions, W as ThinkingLevel, X as ToolCall, Y as ToolContext, Z as ToolDef, _ as ToolExecutionMode, $ as ToolHookContext, a0 as ToolMap, a1 as ToolResult, a2 as ToolResultContent, a3 as ToolResultImageContent, a4 as ToolResultTextContent, a5 as ToolSpec, a6 as TurnFinishReason, a7 as TurnResult, a8 as TurnUsage, ao as anthropic, ap as autoDetectAndConvert, aq as cerebras, ar as classifyOpenAICompatError, as as connectMcpServers, at as createAgent, au as createFileMapStore, av as createMemoryStore, aw as createRemoteStore, ax as createSession, ay as createSkillActivationState, az as fromAnthropic, aA as fromOpenAI, aB as loadSession, aC as mapOAIFinishReason, a9 as matchesContextExceeded, aD as normalizeMcpBlocks, aE as normalizeMcpServers, aF as openai, aG as openaiCompat, aH as openrouter, aI as resultToString, aJ as toAnthropic, aK as toOpenAI, aL as toTypedError, aa as toolOutputByteLength, ab as toolResultToText } from './agent-4zeSbdXy.js';
+import { d as AgentHooks } from './agent-O5SmWixc.js';
+export { ac as ActivationVia, ad as ActiveSkill, A as Agent, a as AgentAbortedError, b as AgentBehavior, c as AgentContextExceededError, e as AgentOptions, f as AgentProviderError, g as AgentRunOptions, h as AgentStats, i as AgentToolNotAllowedError, j as AnthropicParams, C as CONTEXT_EXCEEDED_MESSAGE_PATTERNS, k as CerebrasParams, m as ClassifiedError, n as ClassifiedErrorKind, o as CreateSessionOptions, ae as DeactivationReason, af as FileMapAdapter, ag as FileMapStoreOptions, I as ImageContent, M as McpConnection, p as McpServerConfig, q as McpToolHookContext, O as OAuthRefreshHookContext, ah as OpenAICompatAuthHeader, ai as OpenAICompatHttpError, aj as OpenAICompatParams, r as OpenAIParams, s as OpenRouterParams, P as PromptDocumentPart, t as PromptImagePart, u as PromptPart, v as PromptTextPart, w as Provider, x as ProviderCapabilities, R as RemoteStoreOptions, y as RunHookMap, S as Session, z as SessionContentBlock, B as SessionData, D as SessionEndStatus, E as SessionHookContext, F as SessionMessage, G as SessionRun, H as SessionStore, J as SessionTurn, ak as SkillActivationState, al as SkillActivationStateOptions, K as SkillConfig, am as SkillDiagnostic, L as SkillResource, an as SkillSource, N as SkillsConfig, Q as SpawnHookContext, T as StreamCallbacks, U as StreamHookContext, V as StreamOptions, W as ThinkingLevel, X as ToolCall, Y as ToolContext, Z as ToolDef, _ as ToolExecutionMode, $ as ToolHookContext, a0 as ToolMap, a1 as ToolResult, a2 as ToolResultContent, a3 as ToolResultImageContent, a4 as ToolResultTextContent, a5 as ToolSpec, a6 as TurnFinishReason, a7 as TurnResult, a8 as TurnUsage, ao as anthropic, ap as autoDetectAndConvert, aq as cerebras, ar as classifyOpenAICompatError, as as connectMcpServers, at as createAgent, au as createFileMapStore, av as createMemoryStore, aw as createRemoteStore, ax as createSession, ay as createSkillActivationState, az as fromAnthropic, aA as fromOpenAI, aB as loadSession, aC as mapOAIFinishReason, a9 as matchesContextExceeded, aD as normalizeMcpBlocks, aE as normalizeMcpServers, aF as openai, aG as openaiCompat, aH as openrouter, aI as resultToString, aJ as toAnthropic, aK as toOpenAI, aL as toTypedError, aa as toolOutputByteLength, ab as toolResultToText } from './agent-O5SmWixc.js';
 export { createDockerContext, createProcessContext } from './contexts.js';
 export { S as SandboxProvider, c as createSandboxContext } from './sandbox-CW72eLDP.js';
 export { C as ContextCapabilities, a as ContextType, E as ExecResult, b as ExecutionContext, c as ExecutionHandle, S as SpawnConfig } from './types-BpvTmawk.js';
 export { Preset, basic, basicTools, definePreset } from './presets.js';
 export { IMPLICITLY_ALLOWED_SKILL_TOOLS, SkillValidationIssue, SkillValidationResult, SourcedScanPath, buildCatalog, defineSkill, discoverSkills, installAllowedToolsGate, interpolateShellCommands, isToolAllowedByUnion, matchesAllowedTool, parseAllowedToolPattern, parseSkillFile, resolveSkills, validateResourcePath, validateSkillForWrite, validateSkillName, writeSkillToDisk, writeSkillsToDisk } from './skills.js';
-export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, f as edit, g as glob, h as grep, m as multiEdit } from './skills-use-DhxQaluD.js';
-export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, V as ValidationResult, c as createInteractionTool, b as createSpawnTool, s as spawn, v as validateToolArgs } from './validation-CYISGVTn.js';
+export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, f as edit, g as glob, h as grep, m as multiEdit } from './skills-use-DJKUctM5.js';
+export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, V as ValidationResult, c as createInteractionTool, b as createSpawnTool, s as spawn, v as validateToolArgs } from './validation-DE4g5Cez.js';
 import { Hookable } from 'hookable';
 import '@modelcontextprotocol/sdk/client/index.js';
 

package/dist/index.js

@@ -6,12 +6,12 @@ import {
   cerebras,
   openai,
   openrouter
-} from "./chunk-HQD5ICI6.js";
+} from "./chunk-FEAOZ5DB.js";
 import {
   basicTools,
   basic_default,
   definePreset
-} from "./chunk-2VM47IBI.js";
+} from "./chunk-SARMZCEL.js";
 import {
   createAgent,
   createInteractionTool,
@@ -25,7 +25,7 @@ import {
   multiEdit,
   spawn,
   validateToolArgs
-} from "./chunk-QFHGWKK3.js";
+} from "./chunk-PYLYK3K7.js";
 import {
   IMPLICITLY_ALLOWED_SKILL_TOOLS,
   buildCatalog,
@@ -76,7 +76,7 @@ import {
   openaiCompat,
   toAnthropic,
   toOpenAI
-} from "./chunk-CYWF2U62.js";
+} from "./chunk-VF4A7HAC.js";
 import {
   AgentAbortedError,
   AgentContextExceededError,

package/dist/mcp.d.ts

@@ -1,4 +1,4 @@
 import 'hookable';
-export { M as McpConnection, p as McpServerConfig, as as connectMcpServers, aD as normalizeMcpBlocks, aE as normalizeMcpServers, aI as resultToString } from './agent-4zeSbdXy.js';
+export { M as McpConnection, p as McpServerConfig, as as connectMcpServers, aD as normalizeMcpBlocks, aE as normalizeMcpServers, aI as resultToString } from './agent-O5SmWixc.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import './types-BpvTmawk.js';

package/dist/presets.d.ts

@@ -1,4 +1,4 @@
-import { Z as ToolDef, e as AgentOptions } from './agent-4zeSbdXy.js';
+import { Z as ToolDef, e as AgentOptions } from './agent-O5SmWixc.js';
 import 'hookable';
 import './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/presets.js

@@ -2,8 +2,8 @@ import {
   basicTools,
   basic_default,
   definePreset
-} from "./chunk-2VM47IBI.js";
-import "./chunk-QFHGWKK3.js";
+} from "./chunk-SARMZCEL.js";
+import "./chunk-PYLYK3K7.js";
 import "./chunk-TPXPVEH6.js";
 import "./chunk-2EQT4EHD.js";
 import "./chunk-R74LQKAM.js";

package/dist/providers.d.ts

@@ -1,4 +1,4 @@
-export { j as AnthropicParams, k as CerebrasParams, ah as OpenAICompatAuthHeader, ai as OpenAICompatHttpError, aj as OpenAICompatParams, r as OpenAIParams, s as OpenRouterParams, w as Provider, x as ProviderCapabilities, T as StreamCallbacks, V as StreamOptions, X as ToolCall, a1 as ToolResult, a5 as ToolSpec, a7 as TurnResult, ao as anthropic, aq as cerebras, ar as classifyOpenAICompatError, aC as mapOAIFinishReason, aF as openai, aG as openaiCompat, aH as openrouter } from './agent-4zeSbdXy.js';
+export { j as AnthropicParams, k as CerebrasParams, ah as OpenAICompatAuthHeader, ai as OpenAICompatHttpError, aj as OpenAICompatParams, r as OpenAIParams, s as OpenRouterParams, w as Provider, x as ProviderCapabilities, T as StreamCallbacks, V as StreamOptions, X as ToolCall, a1 as ToolResult, a5 as ToolSpec, a7 as TurnResult, ao as anthropic, aq as cerebras, ar as classifyOpenAICompatError, aC as mapOAIFinishReason, aF as openai, aG as openaiCompat, aH as openrouter } from './agent-O5SmWixc.js';
 import 'hookable';
 import './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/providers.js

@@ -3,13 +3,13 @@ import {
   cerebras,
   openai,
   openrouter
-} from "./chunk-HQD5ICI6.js";
+} from "./chunk-FEAOZ5DB.js";
 import {
   OpenAICompatHttpError,
   classifyOpenAICompatError,
   mapOAIFinishReason,
   openaiCompat
-} from "./chunk-CYWF2U62.js";
+} from "./chunk-VF4A7HAC.js";
 import "./chunk-LNN5UTS2.js";
 export {
   OpenAICompatHttpError,

package/dist/session/sqlite.d.ts

@@ -1,4 +1,4 @@
-import { H as SessionStore } from '../agent-4zeSbdXy.js';
+import { H as SessionStore } from '../agent-O5SmWixc.js';
 import 'hookable';
 import '../types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-export { o as CreateSessionOptions, af as FileMapAdapter, ag as FileMapStoreOptions, R as RemoteStoreOptions, S as Session, z as SessionContentBlock, B as SessionData, F as SessionMessage, G as SessionRun, H as SessionStore, J as SessionTurn, ap as autoDetectAndConvert, au as createFileMapStore, av as createMemoryStore, aw as createRemoteStore, ax as createSession, az as fromAnthropic, aA as fromOpenAI, aB as loadSession, aJ as toAnthropic, aK as toOpenAI } from './agent-4zeSbdXy.js';
+export { o as CreateSessionOptions, af as FileMapAdapter, ag as FileMapStoreOptions, R as RemoteStoreOptions, S as Session, z as SessionContentBlock, B as SessionData, F as SessionMessage, G as SessionRun, H as SessionStore, J as SessionTurn, ap as autoDetectAndConvert, au as createFileMapStore, av as createMemoryStore, aw as createRemoteStore, ax as createSession, az as fromAnthropic, aA as fromOpenAI, aB as loadSession, aJ as toAnthropic, aK as toOpenAI } from './agent-O5SmWixc.js';
 import 'hookable';
 import './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/session.js

@@ -11,7 +11,7 @@ import {
   fromOpenAI,
   toAnthropic,
   toOpenAI
-} from "./chunk-CYWF2U62.js";
+} from "./chunk-VF4A7HAC.js";
 import "./chunk-LNN5UTS2.js";
 export {
   autoDetectAndConvert,

package/dist/{skills-use-DhxQaluD.d.ts → skills-use-DJKUctM5.d.ts}

@@ -1,4 +1,4 @@
-import { Z as ToolDef, K as SkillConfig, ak as SkillActivationState, d as AgentHooks } from './agent-4zeSbdXy.js';
+import { Z as ToolDef, K as SkillConfig, ak as SkillActivationState, d as AgentHooks } from './agent-O5SmWixc.js';
 import { Hookable } from 'hookable';
 
 /**

package/dist/skills.d.ts

@@ -1,5 +1,5 @@
-import { d as AgentHooks, ak as SkillActivationState, K as SkillConfig, an as SkillSource, am as SkillDiagnostic, N as SkillsConfig } from './agent-4zeSbdXy.js';
-export { ac as ActivationVia, ad as ActiveSkill, ae as DeactivationReason, al as SkillActivationStateOptions, L as SkillResource, ay as createSkillActivationState } from './agent-4zeSbdXy.js';
+import { d as AgentHooks, ak as SkillActivationState, K as SkillConfig, an as SkillSource, am as SkillDiagnostic, N as SkillsConfig } from './agent-O5SmWixc.js';
+export { ac as ActivationVia, ad as ActiveSkill, ae as DeactivationReason, al as SkillActivationStateOptions, L as SkillResource, ay as createSkillActivationState } from './agent-O5SmWixc.js';
 import { Hookable } from 'hookable';
 import { b as ExecutionContext, c as ExecutionHandle } from './types-BpvTmawk.js';
 import '@modelcontextprotocol/sdk/client/index.js';

package/dist/tools.d.ts

@@ -1,7 +1,7 @@
-export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, f as edit, g as glob, h as grep, m as multiEdit } from './skills-use-DhxQaluD.js';
-export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, V as ValidationResult, c as createInteractionTool, b as createSpawnTool, s as spawn, v as validateToolArgs } from './validation-CYISGVTn.js';
-import { Z as ToolDef } from './agent-4zeSbdXy.js';
-export { Y as ToolContext, a0 as ToolMap } from './agent-4zeSbdXy.js';
+export { S as SkillsReadToolOptions, a as SkillsRunScriptToolOptions, b as SkillsUseToolOptions, c as createSkillsReadTool, d as createSkillsRunScriptTool, e as createSkillsUseTool, f as edit, g as glob, h as grep, m as multiEdit } from './skills-use-DJKUctM5.js';
+export { C as ChildAgent, I as InteractionToolOptions, S as SpawnToolOptions, a as SpawnToolState, V as ValidationResult, c as createInteractionTool, b as createSpawnTool, s as spawn, v as validateToolArgs } from './validation-DE4g5Cez.js';
+import { Z as ToolDef } from './agent-O5SmWixc.js';
+export { Y as ToolContext, a0 as ToolMap } from './agent-O5SmWixc.js';
 import 'hookable';
 import './presets.js';
 import './types-BpvTmawk.js';

package/dist/tools.js

@@ -14,7 +14,7 @@ import {
   spawn,
   validateToolArgs,
   writeFile
-} from "./chunk-QFHGWKK3.js";
+} from "./chunk-PYLYK3K7.js";
 import "./chunk-TPXPVEH6.js";
 import "./chunk-2EQT4EHD.js";
 import "./chunk-R74LQKAM.js";

package/dist/types.d.ts

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

package/dist/{validation-CYISGVTn.d.ts → validation-DE4g5Cez.d.ts}

@@ -1,4 +1,4 @@
-import { Y as ToolContext, Z as ToolDef, h as AgentStats, l as ChildRunStats } from './agent-4zeSbdXy.js';
+import { Y as ToolContext, Z as ToolDef, h as AgentStats, l as ChildRunStats } from './agent-O5SmWixc.js';
 import { Preset } from './presets.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,
@@ -77,7 +77,7 @@
     "md4x": "^0.0.25"
   },
   "peerDependencies": {
-    "@anthropic-ai/sdk": "^0.88.0",
+    "@anthropic-ai/sdk": "^0.90.0",
     "@modelcontextprotocol/sdk": ">=1.11.0",
     "zod": ">=4.0.0"
   },