zidane 5.4.0 → 5.4.2

package/dist/{presets-M8f6lDnW.js.map → presets-MCcvxiNT.js.map}

@@ -1 +1 @@
-{"version":3,"file":"presets-M8f6lDnW.js","names":[],"sources":["../src/presets/basic.ts","../src/presets/index.ts"],"sourcesContent":["import { definePreset } from '.'\nimport { edit, listFiles, multiEdit, readFile, shell, writeFile } from '../tools'\nimport { createSpawnTool } from '../tools/spawn'\n\n/**\n * Core tools available in every basic preset (without spawn).\n *\n * `edit` and `multi_edit` ship in the basic set because surgical edits are the\n * default modality for production agents — `write_file` is for full overwrites.\n * `glob` and `grep` are exported but opt-in: not every agent needs codebase\n * search, and shipping them by default would force `tool:gate` work onto\n * consumers that prefer the model to use `shell` + classic Unix tools.\n */\nexport const basicTools = { shell, readFile, writeFile, listFiles, edit, multiEdit }\n\nexport default definePreset({\n  name: 'basic',\n  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.',\n  // `persist: true` shares the parent's session with every child agent — child\n  // turns land in `session.turns` tagged with their own `runId`, and the run\n  // itself is recorded in `session.runs` with `parentRunId` + `depth`. That's\n  // what lets a reloaded TUI session reconstruct the full subagent tree (see\n  // `eventsFromTurns` in `tui/store.ts`). Hosts that want children in-memory\n  // only can construct their own preset with `createSpawnTool()`.\n  tools: { ...basicTools, spawn: createSpawnTool({ persist: true }) },\n})\n","import type { AgentHooks, AgentOptions } from '../agent'\n\nexport type { AgentHookMap } from '../agent'\n\n/**\n * A preset is a reusable slice of `AgentOptions` — spread it into `createAgent()`\n * to configure tools, a default system prompt, aliases, behavior defaults, and\n * agent-lifetime hooks.\n *\n * `provider`, `execution`, `session`, and internal fields are excluded so presets\n * remain shareable and composable.\n *\n * ```ts\n * import { basic } from 'zidane/presets'\n * createAgent({ ...basic, provider })\n * ```\n *\n * ### Composing multiple presets\n *\n * Bare `...spread` is shallow — `{ ...a, ...b }` overwrites every key `b`\n * defines, including `hooks`. Use {@link composePresets} when you want\n * field-aware merging (per-event hook concat, tools shallow-merge, etc.):\n *\n * ```ts\n * createAgent({ ...composePresets(basic, telemetry, mine), provider })\n * ```\n */\nexport type Preset = Omit<Partial<AgentOptions>, 'provider' | 'execution' | 'session' | 'mcpConnector'>\n\n/**\n * Identity helper for type inference when defining a preset.\n */\nexport function definePreset(config: Preset): Preset {\n  return config\n}\n\n/**\n * Field-aware composition of presets. Right-most preset wins for scalar fields;\n * objects shallow-merge; arrays and hook handler lists concatenate. Designed so\n * stacking presets does the obvious thing without the spread-collision footgun:\n *\n * - `name`, `system`, `eager`, `skills`              → last-defined wins\n * - `tools`, `toolAliases`, `behavior`               → shallow-merge (later keys override)\n * - `behavior.dedupTools`, `behavior.toolBudgets`    → **deep-merge** (per-tool-name; later wins on collision)\n * - `mcpServers`                                     → concat with last-wins on `name` collision\n * - `hooks`                                          → per-event concat; every handler fires\n *\n * `hooks` always emerges as `event → handler[]` so downstream registration\n * (in `createAgent`) sees a uniform shape. Order of handlers within an event\n * follows preset order: earlier presets register first.\n *\n * `mcpServers` is deduped by `name` because shipping two servers with the same\n * name would trip the connector at runtime — a later preset overriding an\n * earlier preset's `github` server is the practical intent.\n *\n * `behavior.dedupTools` and `behavior.toolBudgets` get the same per-key deep-merge\n * because they are tool-name-keyed records — a preset that ships a dedup hasher\n * for one tool should not erase a hasher another preset ships for a different\n * tool. Last-wins still applies on a per-tool collision so a downstream preset\n * can override an upstream preset's policy for one specific tool. Other\n * `behavior` fields keep last-wins semantics.\n */\nexport function composePresets(...presets: Preset[]): Preset {\n  const out: Preset = {}\n  const hooksByEvent: { [K in keyof AgentHooks]?: AgentHooks[K][] } = {}\n  // Keep mcpServers in source-order on first sight, but allow later\n  // declarations to override earlier ones with the same `name`. A `Map`\n  // keyed by name gives O(1) override + stable iteration.\n  const mcpByName = new Map<string, NonNullable<Preset['mcpServers']>[number]>()\n\n  for (const p of presets) {\n    if (p.name !== undefined)\n      out.name = p.name\n    if (p.system !== undefined)\n      out.system = p.system\n    if (p.eager !== undefined)\n      out.eager = p.eager\n    if (p.skills !== undefined)\n      out.skills = p.skills\n    if (p.tools)\n      out.tools = { ...out.tools, ...p.tools }\n    if (p.toolAliases)\n      out.toolAliases = { ...out.toolAliases, ...p.toolAliases }\n    if (p.behavior) {\n      // Top-level shallow-merge first; then deep-merge the two tool-name-keyed\n      // sub-records so per-tool entries from earlier presets aren't clobbered.\n      const merged: NonNullable<Preset['behavior']> = { ...out.behavior, ...p.behavior }\n      if (out.behavior?.dedupTools || p.behavior.dedupTools) {\n        merged.dedupTools = { ...out.behavior?.dedupTools, ...p.behavior.dedupTools }\n      }\n      if (out.behavior?.toolBudgets || p.behavior.toolBudgets) {\n        merged.toolBudgets = { ...out.behavior?.toolBudgets, ...p.behavior.toolBudgets }\n      }\n      out.behavior = merged\n    }\n    if (p.mcpServers) {\n      for (const server of p.mcpServers)\n        mcpByName.set(server.name, server)\n    }\n    if (p.hooks) {\n      for (const [event, handler] of Object.entries(p.hooks)) {\n        if (handler === undefined)\n          continue\n        const list = Array.isArray(handler) ? handler : [handler]\n        const key = event as keyof AgentHooks\n        // Safe cast: we read the loose `AgentHookMap` shape (handler-or-array)\n        // and re-emit only as arrays. Each `list` element matches the event's\n        // handler signature by construction (the input was typed `AgentHookMap`).\n        const bucket = (hooksByEvent[key] ??= []) as unknown[]\n        bucket.push(...(list as unknown[]))\n      }\n    }\n  }\n\n  if (mcpByName.size > 0)\n    out.mcpServers = [...mcpByName.values()]\n\n  if (Object.keys(hooksByEvent).length > 0)\n    out.hooks = hooksByEvent\n\n  return out\n}\n\nexport { default as basic, basicTools } from './basic'\n"],"mappings":";;;;;;;;;;;AAaA,MAAa,aAAa;CAAE;CAAO;CAAU;CAAW;CAAW;CAAM;CAAW;AAEpF,IAAA,gBAAe,aAAa;CAC1B,MAAM;CACN,QAAQ;CAOR,OAAO;EAAE,GAAG;EAAY,OAAO,gBAAgB,EAAE,SAAS,MAAM,CAAC;EAAE;CACpE,CAAC;;;;;;ACOF,SAAgB,aAAa,QAAwB;CACnD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BT,SAAgB,eAAe,GAAG,SAA2B;CAC3D,MAAM,MAAc,EAAE;CACtB,MAAM,eAA8D,EAAE;CAItE,MAAM,4BAAY,IAAI,KAAwD;CAE9E,KAAK,MAAM,KAAK,SAAS;EACvB,IAAI,EAAE,SAAS,KAAA,GACb,IAAI,OAAO,EAAE;EACf,IAAI,EAAE,WAAW,KAAA,GACf,IAAI,SAAS,EAAE;EACjB,IAAI,EAAE,UAAU,KAAA,GACd,IAAI,QAAQ,EAAE;EAChB,IAAI,EAAE,WAAW,KAAA,GACf,IAAI,SAAS,EAAE;EACjB,IAAI,EAAE,OACJ,IAAI,QAAQ;GAAE,GAAG,IAAI;GAAO,GAAG,EAAE;GAAO;EAC1C,IAAI,EAAE,aACJ,IAAI,cAAc;GAAE,GAAG,IAAI;GAAa,GAAG,EAAE;GAAa;EAC5D,IAAI,EAAE,UAAU;GAGd,MAAM,SAA0C;IAAE,GAAG,IAAI;IAAU,GAAG,EAAE;IAAU;GAClF,IAAI,IAAI,UAAU,cAAc,EAAE,SAAS,YACzC,OAAO,aAAa;IAAE,GAAG,IAAI,UAAU;IAAY,GAAG,EAAE,SAAS;IAAY;GAE/E,IAAI,IAAI,UAAU,eAAe,EAAE,SAAS,aAC1C,OAAO,cAAc;IAAE,GAAG,IAAI,UAAU;IAAa,GAAG,EAAE,SAAS;IAAa;GAElF,IAAI,WAAW;;EAEjB,IAAI,EAAE,YACJ,KAAK,MAAM,UAAU,EAAE,YACrB,UAAU,IAAI,OAAO,MAAM,OAAO;EAEtC,IAAI,EAAE,OACJ,KAAK,MAAM,CAAC,OAAO,YAAY,OAAO,QAAQ,EAAE,MAAM,EAAE;GACtD,IAAI,YAAY,KAAA,GACd;GACF,MAAM,OAAO,MAAM,QAAQ,QAAQ,GAAG,UAAU,CAAC,QAAQ;GACzD,MAAM,MAAM;GAKZ,CADgB,aAAa,SAAS,EAAE,EACjC,KAAK,GAAI,KAAmB;;;CAKzC,IAAI,UAAU,OAAO,GACnB,IAAI,aAAa,CAAC,GAAG,UAAU,QAAQ,CAAC;CAE1C,IAAI,OAAO,KAAK,aAAa,CAAC,SAAS,GACrC,IAAI,QAAQ;CAEd,OAAO"}
+{"version":3,"file":"presets-MCcvxiNT.js","names":[],"sources":["../src/presets/basic.ts","../src/presets/index.ts"],"sourcesContent":["import { definePreset } from '.'\nimport { edit, listFiles, multiEdit, readFile, shell, writeFile } from '../tools'\nimport { createSpawnTool } from '../tools/spawn'\n\n/**\n * Core tools available in every basic preset (without spawn).\n *\n * `edit` and `multi_edit` ship in the basic set because surgical edits are the\n * default modality for production agents — `write_file` is for full overwrites.\n * `glob` and `grep` are exported but opt-in: not every agent needs codebase\n * search, and shipping them by default would force `tool:gate` work onto\n * consumers that prefer the model to use `shell` + classic Unix tools.\n */\nexport const basicTools = { shell, readFile, writeFile, listFiles, edit, multiEdit }\n\nexport default definePreset({\n  name: 'basic',\n  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.',\n  // `persist: true` shares the parent's session with every child agent — child\n  // turns land in `session.turns` tagged with their own `runId`, and the run\n  // itself is recorded in `session.runs` with `parentRunId` + `depth`. That's\n  // what lets a reloaded TUI session reconstruct the full subagent tree (see\n  // `eventsFromTurns` in `tui/store.ts`). Hosts that want children in-memory\n  // only can construct their own preset with `createSpawnTool()`.\n  tools: { ...basicTools, spawn: createSpawnTool({ persist: true }) },\n})\n","import type { AgentHooks, AgentOptions } from '../agent'\n\nexport type { AgentHookMap } from '../agent'\n\n/**\n * A preset is a reusable slice of `AgentOptions` — spread it into `createAgent()`\n * to configure tools, a default system prompt, aliases, behavior defaults, and\n * agent-lifetime hooks.\n *\n * `provider`, `execution`, `session`, and internal fields are excluded so presets\n * remain shareable and composable.\n *\n * ```ts\n * import { basic } from 'zidane/presets'\n * createAgent({ ...basic, provider })\n * ```\n *\n * ### Composing multiple presets\n *\n * Bare `...spread` is shallow — `{ ...a, ...b }` overwrites every key `b`\n * defines, including `hooks`. Use {@link composePresets} when you want\n * field-aware merging (per-event hook concat, tools shallow-merge, etc.):\n *\n * ```ts\n * createAgent({ ...composePresets(basic, telemetry, mine), provider })\n * ```\n */\nexport type Preset = Omit<Partial<AgentOptions>, 'provider' | 'execution' | 'session' | 'mcpConnector'>\n\n/**\n * Identity helper for type inference when defining a preset.\n */\nexport function definePreset(config: Preset): Preset {\n  return config\n}\n\n/**\n * Field-aware composition of presets. Right-most preset wins for scalar fields;\n * objects shallow-merge; arrays and hook handler lists concatenate. Designed so\n * stacking presets does the obvious thing without the spread-collision footgun:\n *\n * - `name`, `system`, `eager`, `skills`              → last-defined wins\n * - `tools`, `toolAliases`, `behavior`               → shallow-merge (later keys override)\n * - `behavior.dedupTools`, `behavior.toolBudgets`    → **deep-merge** (per-tool-name; later wins on collision)\n * - `mcpServers`                                     → concat with last-wins on `name` collision\n * - `hooks`                                          → per-event concat; every handler fires\n *\n * `hooks` always emerges as `event → handler[]` so downstream registration\n * (in `createAgent`) sees a uniform shape. Order of handlers within an event\n * follows preset order: earlier presets register first.\n *\n * `mcpServers` is deduped by `name` because shipping two servers with the same\n * name would trip the connector at runtime — a later preset overriding an\n * earlier preset's `github` server is the practical intent.\n *\n * `behavior.dedupTools` and `behavior.toolBudgets` get the same per-key deep-merge\n * because they are tool-name-keyed records — a preset that ships a dedup hasher\n * for one tool should not erase a hasher another preset ships for a different\n * tool. Last-wins still applies on a per-tool collision so a downstream preset\n * can override an upstream preset's policy for one specific tool. Other\n * `behavior` fields keep last-wins semantics.\n */\nexport function composePresets(...presets: Preset[]): Preset {\n  const out: Preset = {}\n  const hooksByEvent: { [K in keyof AgentHooks]?: AgentHooks[K][] } = {}\n  // Keep mcpServers in source-order on first sight, but allow later\n  // declarations to override earlier ones with the same `name`. A `Map`\n  // keyed by name gives O(1) override + stable iteration.\n  const mcpByName = new Map<string, NonNullable<Preset['mcpServers']>[number]>()\n\n  for (const p of presets) {\n    if (p.name !== undefined)\n      out.name = p.name\n    if (p.system !== undefined)\n      out.system = p.system\n    if (p.eager !== undefined)\n      out.eager = p.eager\n    if (p.skills !== undefined)\n      out.skills = p.skills\n    if (p.tools)\n      out.tools = { ...out.tools, ...p.tools }\n    if (p.toolAliases)\n      out.toolAliases = { ...out.toolAliases, ...p.toolAliases }\n    if (p.behavior) {\n      // Top-level shallow-merge first; then deep-merge the two tool-name-keyed\n      // sub-records so per-tool entries from earlier presets aren't clobbered.\n      const merged: NonNullable<Preset['behavior']> = { ...out.behavior, ...p.behavior }\n      if (out.behavior?.dedupTools || p.behavior.dedupTools) {\n        merged.dedupTools = { ...out.behavior?.dedupTools, ...p.behavior.dedupTools }\n      }\n      if (out.behavior?.toolBudgets || p.behavior.toolBudgets) {\n        merged.toolBudgets = { ...out.behavior?.toolBudgets, ...p.behavior.toolBudgets }\n      }\n      out.behavior = merged\n    }\n    if (p.mcpServers) {\n      for (const server of p.mcpServers)\n        mcpByName.set(server.name, server)\n    }\n    if (p.hooks) {\n      for (const [event, handler] of Object.entries(p.hooks)) {\n        if (handler === undefined)\n          continue\n        const list = Array.isArray(handler) ? handler : [handler]\n        const key = event as keyof AgentHooks\n        // Safe cast: we read the loose `AgentHookMap` shape (handler-or-array)\n        // and re-emit only as arrays. Each `list` element matches the event's\n        // handler signature by construction (the input was typed `AgentHookMap`).\n        const bucket = (hooksByEvent[key] ??= []) as unknown[]\n        bucket.push(...(list as unknown[]))\n      }\n    }\n  }\n\n  if (mcpByName.size > 0)\n    out.mcpServers = [...mcpByName.values()]\n\n  if (Object.keys(hooksByEvent).length > 0)\n    out.hooks = hooksByEvent\n\n  return out\n}\n\nexport { default as basic, basicTools } from './basic'\n"],"mappings":";;;;;;;;;;;AAaA,MAAa,aAAa;CAAE;CAAO;CAAU;CAAW;CAAW;CAAM;CAAW;AAEpF,IAAA,gBAAe,aAAa;CAC1B,MAAM;CACN,QAAQ;CAOR,OAAO;EAAE,GAAG;EAAY,OAAO,gBAAgB,EAAE,SAAS,MAAM,CAAC;EAAE;CACpE,CAAC;;;;;;ACOF,SAAgB,aAAa,QAAwB;CACnD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BT,SAAgB,eAAe,GAAG,SAA2B;CAC3D,MAAM,MAAc,EAAE;CACtB,MAAM,eAA8D,EAAE;CAItE,MAAM,4BAAY,IAAI,KAAwD;CAE9E,KAAK,MAAM,KAAK,SAAS;EACvB,IAAI,EAAE,SAAS,KAAA,GACb,IAAI,OAAO,EAAE;EACf,IAAI,EAAE,WAAW,KAAA,GACf,IAAI,SAAS,EAAE;EACjB,IAAI,EAAE,UAAU,KAAA,GACd,IAAI,QAAQ,EAAE;EAChB,IAAI,EAAE,WAAW,KAAA,GACf,IAAI,SAAS,EAAE;EACjB,IAAI,EAAE,OACJ,IAAI,QAAQ;GAAE,GAAG,IAAI;GAAO,GAAG,EAAE;GAAO;EAC1C,IAAI,EAAE,aACJ,IAAI,cAAc;GAAE,GAAG,IAAI;GAAa,GAAG,EAAE;GAAa;EAC5D,IAAI,EAAE,UAAU;GAGd,MAAM,SAA0C;IAAE,GAAG,IAAI;IAAU,GAAG,EAAE;IAAU;GAClF,IAAI,IAAI,UAAU,cAAc,EAAE,SAAS,YACzC,OAAO,aAAa;IAAE,GAAG,IAAI,UAAU;IAAY,GAAG,EAAE,SAAS;IAAY;GAE/E,IAAI,IAAI,UAAU,eAAe,EAAE,SAAS,aAC1C,OAAO,cAAc;IAAE,GAAG,IAAI,UAAU;IAAa,GAAG,EAAE,SAAS;IAAa;GAElF,IAAI,WAAW;;EAEjB,IAAI,EAAE,YACJ,KAAK,MAAM,UAAU,EAAE,YACrB,UAAU,IAAI,OAAO,MAAM,OAAO;EAEtC,IAAI,EAAE,OACJ,KAAK,MAAM,CAAC,OAAO,YAAY,OAAO,QAAQ,EAAE,MAAM,EAAE;GACtD,IAAI,YAAY,KAAA,GACd;GACF,MAAM,OAAO,MAAM,QAAQ,QAAQ,GAAG,UAAU,CAAC,QAAQ;GACzD,MAAM,MAAM;GAKZ,CADgB,aAAa,SAAS,EAAE,EACjC,KAAK,GAAI,KAAmB;;;CAKzC,IAAI,UAAU,OAAO,GACnB,IAAI,aAAa,CAAC,GAAG,UAAU,QAAQ,CAAC;CAE1C,IAAI,OAAO,KAAK,aAAa,CAAC,SAAS,GACrC,IAAI,QAAQ;CAEd,OAAO"}

package/dist/presets.d.ts

@@ -1,3 +1,3 @@
-import { n as AgentHookMap } from "./agent-DHQAsdj6.js";
-import { a as basicTools, i as _default, n as composePresets, r as definePreset, t as Preset } from "./index-CrqFoaQA.js";
+import { n as AgentHookMap } from "./agent-DxBoKDba.js";
+import { a as basicTools, i as _default, n as composePresets, r as definePreset, t as Preset } from "./index-B2VOOijU.js";
 export { AgentHookMap, Preset, _default as basic, basicTools, composePresets, definePreset };

package/dist/presets.js

@@ -1,2 +1,2 @@
-import { i as basic_default, n as definePreset, r as basicTools, t as composePresets } from "./presets-M8f6lDnW.js";
+import { i as basic_default, n as definePreset, r as basicTools, t as composePresets } from "./presets-MCcvxiNT.js";
 export { basic_default as basic, basicTools, composePresets, definePreset };

package/dist/providers.d.ts

@@ -1,2 +1,2 @@
-import { At as cerebras, Ct as OpenAICompatParams, Dt as OpenAIParams, Et as openaiCompat, Mt as anthropic, Ot as openai, St as OpenAICompatHttpError, Tt as mapOAIFinishReason, _t as sanitizeToolSchema, bt as openrouter, ct as StreamCallbacks, dt as ToolResult, ft as ToolSpec, gt as SchemaSanitizeResult, ht as SchemaSanitizeProfile, jt as AnthropicParams, kt as CerebrasParams, lt as StreamOptions, mt as SchemaSanitizeOptions, ot as Provider, pt as TurnResult, st as ProviderCapabilities, ut as ToolCall, vt as sanitizeToolSpecs, wt as classifyOpenAICompatError, xt as OpenAICompatAuthHeader, yt as OpenRouterParams } from "./agent-DHQAsdj6.js";
+import { At as cerebras, Ct as OpenAICompatParams, Dt as OpenAIParams, Et as openaiCompat, Mt as anthropic, Ot as openai, St as OpenAICompatHttpError, Tt as mapOAIFinishReason, _t as sanitizeToolSchema, bt as openrouter, ct as StreamCallbacks, dt as ToolResult, ft as ToolSpec, gt as SchemaSanitizeResult, ht as SchemaSanitizeProfile, jt as AnthropicParams, kt as CerebrasParams, lt as StreamOptions, mt as SchemaSanitizeOptions, ot as Provider, pt as TurnResult, st as ProviderCapabilities, ut as ToolCall, vt as sanitizeToolSpecs, wt as classifyOpenAICompatError, xt as OpenAICompatAuthHeader, yt as OpenRouterParams } from "./agent-DxBoKDba.js";
 export { AnthropicParams, CerebrasParams, OpenAICompatAuthHeader, OpenAICompatHttpError, OpenAICompatParams, OpenAIParams, OpenRouterParams, Provider, ProviderCapabilities, SchemaSanitizeOptions, SchemaSanitizeProfile, SchemaSanitizeResult, StreamCallbacks, StreamOptions, ToolCall, ToolResult, ToolSpec, TurnResult, anthropic, cerebras, classifyOpenAICompatError, mapOAIFinishReason, openai, openaiCompat, openrouter, sanitizeToolSchema, sanitizeToolSpecs };

package/dist/session/sqlite.d.ts

@@ -1,4 +1,4 @@
-import { I as SessionStore } from "../agent-DHQAsdj6.js";
+import { I as SessionStore } from "../agent-DxBoKDba.js";
 
 //#region src/session/sqlite.d.ts
 interface SqliteStoreOptions {

package/dist/session.d.ts

@@ -1,2 +1,2 @@
-import { $ as fromOpenAI, B as createRemoteStore, F as SessionRun, I as SessionStore, J as autoDetectAndConvert, Kt as SessionContentBlock, L as createSession, M as CreateSessionOptions, N as Session, P as SessionData, Q as fromAnthropic, R as loadSession, Xt as SessionTurn, Yt as SessionMessage, at as createFileMapStore, et as toAnthropic, it as FileMapStoreOptions, nt as createMemoryStore, rt as FileMapAdapter, tt as toOpenAI, z as RemoteStoreOptions } from "./agent-DHQAsdj6.js";
+import { $ as fromOpenAI, B as createRemoteStore, F as SessionRun, I as SessionStore, J as autoDetectAndConvert, Kt as SessionContentBlock, L as createSession, M as CreateSessionOptions, N as Session, P as SessionData, Q as fromAnthropic, R as loadSession, Xt as SessionTurn, Yt as SessionMessage, at as createFileMapStore, et as toAnthropic, it as FileMapStoreOptions, nt as createMemoryStore, rt as FileMapAdapter, tt as toOpenAI, z as RemoteStoreOptions } from "./agent-DxBoKDba.js";
 export { CreateSessionOptions, FileMapAdapter, FileMapStoreOptions, RemoteStoreOptions, Session, SessionContentBlock, SessionData, SessionMessage, SessionRun, SessionStore, SessionTurn, autoDetectAndConvert, createFileMapStore, createMemoryStore, createRemoteStore, createSession, fromAnthropic, fromOpenAI, loadSession, toAnthropic, toOpenAI };

package/dist/skills.d.ts

@@ -1,3 +1,3 @@
-import { A as SkillSource, D as SkillConfig, O as SkillDiagnostic, c as DeactivationReason, d as createSkillActivationState, j as SkillsConfig, k as SkillResource, l as SkillActivationState, o as ActivationVia, s as ActiveSkill, u as SkillActivationStateOptions } from "./agent-DHQAsdj6.js";
-import { S as installAllowedToolsGate, _ as inferSource, a as SkillValidationResult, b as buildCatalog, c as parseAllowedToolPattern, d as validateSkillName, f as resolveSkills, g as getDefaultScanPaths, h as discoverSkills, i as SkillValidationIssue, l as validateResourcePath, m as SourcedScanPath, n as writeSkillToDisk, o as isToolAllowedByUnion, p as interpolateShellCommands, r as writeSkillsToDisk, s as matchesAllowedTool, t as defineSkill, u as validateSkillForWrite, v as parseFrontmatter, x as IMPLICITLY_ALLOWED_SKILL_TOOLS, y as parseSkillFile } from "./index-CHSaLab5.js";
+import { A as SkillSource, D as SkillConfig, O as SkillDiagnostic, c as DeactivationReason, d as createSkillActivationState, j as SkillsConfig, k as SkillResource, l as SkillActivationState, o as ActivationVia, s as ActiveSkill, u as SkillActivationStateOptions } from "./agent-DxBoKDba.js";
+import { S as installAllowedToolsGate, _ as inferSource, a as SkillValidationResult, b as buildCatalog, c as parseAllowedToolPattern, d as validateSkillName, f as resolveSkills, g as getDefaultScanPaths, h as discoverSkills, i as SkillValidationIssue, l as validateResourcePath, m as SourcedScanPath, n as writeSkillToDisk, o as isToolAllowedByUnion, p as interpolateShellCommands, r as writeSkillsToDisk, s as matchesAllowedTool, t as defineSkill, u as validateSkillForWrite, v as parseFrontmatter, x as IMPLICITLY_ALLOWED_SKILL_TOOLS, y as parseSkillFile } from "./index-BOtXdQkW.js";
 export { ActivationVia, ActiveSkill, DeactivationReason, IMPLICITLY_ALLOWED_SKILL_TOOLS, SkillActivationState, SkillActivationStateOptions, SkillConfig, SkillDiagnostic, SkillResource, SkillSource, SkillValidationIssue, SkillValidationResult, SkillsConfig, SourcedScanPath, buildCatalog, createSkillActivationState, defineSkill, discoverSkills, getDefaultScanPaths, inferSource, installAllowedToolsGate, interpolateShellCommands, isToolAllowedByUnion, matchesAllowedTool, parseAllowedToolPattern, parseFrontmatter, parseSkillFile, resolveSkills, validateResourcePath, validateSkillForWrite, validateSkillName, writeSkillToDisk, writeSkillsToDisk };

package/dist/{tools-DKdyPoUf.js → tools-BNfyY14s.js}

@@ -1071,6 +1071,8 @@ function applyStaleReadElision(messages) {
 		messages,
 		elidedPaths: []
 	};
+	const pathsWithFreshRead = /* @__PURE__ */ new Set();
+	for (const [callId, info] of readCallInfo) if (!staleCallIds.has(callId)) pathsWithFreshRead.add(info.path);
 	let changed = false;
 	const out = messages.slice();
 	for (let i = 0; i < out.length; i++) {
@@ -1094,7 +1096,7 @@ function applyStaleReadElision(messages) {
 	}
 	return {
 		messages: changed ? out : messages,
-		elidedPaths: [...elidedPathSet]
+		elidedPaths: [...elidedPathSet].filter((p) => !pathsWithFreshRead.has(p))
 	};
 }
 /**
@@ -1182,7 +1184,14 @@ async function runLoop(ctx) {
 				await ctx.hooks.callHook("agent:abort", {});
 				break;
 			}
-			const result = await executeTurn(ctx, turn);
+			const result = await executeTurn(ctx, turn, {
+				input: totalIn,
+				output: totalOut,
+				cacheRead: totalCacheRead,
+				cacheCreation: totalCacheCreation,
+				priorCost: turnUsages.reduce((s, t) => s + (t.cost ?? 0), 0),
+				priorTurns: turnsCompleted
+			});
 			turnsCompleted = turn + 1;
 			totalIn += result.usage.input;
 			totalOut += result.usage.output;
@@ -1293,7 +1302,49 @@ function buildStreamErrorPlaceholder(err) {
 	const oneLine = raw.replace(/\s+/g, " ");
 	return `[✗ Streaming failed before any output: ${oneLine.length > ERROR_PLACEHOLDER_MAX ? `${oneLine.slice(0, ERROR_PLACEHOLDER_MAX - 1).trimEnd()}…` : oneLine}]`;
 }
-async function executeTurn(ctx, turn) {
+function buildCumulativeUsage(prior, turnUsage) {
+	const cost = prior.priorCost + (turnUsage.cost ?? 0);
+	return Object.freeze({
+		input: prior.input + turnUsage.input,
+		output: prior.output + turnUsage.output,
+		cacheRead: prior.cacheRead + (turnUsage.cacheRead ?? 0),
+		cacheCreation: prior.cacheCreation + (turnUsage.cacheCreation ?? 0),
+		...cost > 0 ? { cost } : {},
+		turns: prior.priorTurns + 1
+	});
+}
+/**
+* Best-effort extraction of `statusCode` / `requestId` from native provider
+* SDK exceptions, attached to `stream:error` ctx so observability handlers
+* don't have to walk `cause` chains. Recognized shapes:
+*
+* - Anthropic SDK `APIError` (`status`, `headers['request-id']`)
+* - OpenAI SDK error (`status`, `headers['x-request-id']`)
+* - OpenRouter / OpenAI-compat HTTP errors (`status`)
+* - Cerebras (`status`)
+*
+* Silent no-op for arbitrary `Error`s and primitives — the fields stay
+* undefined and the raw `err` is still forwarded for handlers that need
+* full context.
+*/
+function extractStreamErrorMeta(err) {
+	if (!err || typeof err !== "object") return {};
+	const e = err;
+	const out = {};
+	const statusCandidate = typeof e.status === "number" ? e.status : typeof e.statusCode === "number" ? e.statusCode : void 0;
+	if (typeof statusCandidate === "number" && Number.isFinite(statusCandidate)) out.statusCode = statusCandidate;
+	if (typeof e.requestId === "string") out.requestId = e.requestId;
+	else {
+		const headers = e.headers;
+		if (headers && typeof headers === "object") {
+			const h = headers;
+			const candidate = h["request-id"] ?? h["x-request-id"] ?? h.requestId;
+			if (typeof candidate === "string") out.requestId = candidate;
+		}
+	}
+	return out;
+}
+async function executeTurn(ctx, turn, priorUsage) {
 	const turnId = await ctx.generateTurnId();
 	let canonicalMessages = turnsToMessages(applyCompactSummaryCutoff(ctx.turns));
 	if (ctx.elideStaleReads === true) {
@@ -1341,10 +1392,20 @@ async function executeTurn(ctx, turn) {
 	});
 	let currentText = "";
 	let currentThinking = "";
+	const streamStartedAt = Date.now();
+	let turnTtftMs;
+	const markTurnTtft = () => {
+		if (turnTtftMs === void 0) turnTtftMs = Date.now() - streamStartedAt;
+	};
+	await ctx.hooks.callHook("stream:start", {
+		turnId,
+		startedAt: streamStartedAt
+	});
 	let result;
 	try {
 		result = await ctx.provider.stream(streamOptions, {
 			onText(delta) {
+				markTurnTtft();
 				currentText += delta;
 				ctx.hooks.callHook("stream:text", {
 					delta,
@@ -1353,6 +1414,7 @@ async function executeTurn(ctx, turn) {
 				});
 			},
 			onThinking(delta) {
+				markTurnTtft();
 				currentThinking += delta;
 				ctx.hooks.callHook("stream:thinking", {
 					delta,
@@ -1387,10 +1449,14 @@ async function executeTurn(ctx, turn) {
 			createdAt: Date.now()
 		};
 		ctx.turns.push(errorTurn);
-		if (!wasAborted) await ctx.hooks.callHook("stream:error", {
-			err,
-			turnId
-		});
+		if (!wasAborted) {
+			const meta = extractStreamErrorMeta(err);
+			await ctx.hooks.callHook("stream:error", {
+				err,
+				turnId,
+				...meta
+			});
+		}
 		await ctx.hooks.callHook("turn:after", {
 			turn,
 			turnId,
@@ -1399,7 +1465,8 @@ async function executeTurn(ctx, turn) {
 			toolCounts: {
 				turn: Object.freeze({}),
 				run: Object.freeze({ ...ctx.runToolCounts })
-			}
+			},
+			cumulativeUsage: buildCumulativeUsage(priorUsage, errorUsage)
 		});
 		throw wrapProviderError(err, ctx);
 	}
@@ -1407,11 +1474,13 @@ async function executeTurn(ctx, turn) {
 		text: currentText,
 		turnId
 	});
+	if (turnTtftMs === void 0 && result.toolCalls.length > 0) turnTtftMs = Date.now() - streamStartedAt;
 	const canonicalToolCalls = result.toolCalls.map((tc) => ({
 		...tc,
 		name: toCanonicalName(tc.name, ctx.aliasMaps)
 	}));
 	const canonicalContent = rewriteContentToCanonical(result.assistantMessage?.content ?? [], ctx.aliasMaps);
+	if (turnTtftMs !== void 0 && result.usage.timeToFirstTokenMs === void 0) result.usage.timeToFirstTokenMs = turnTtftMs;
 	const assistantTurn = {
 		id: turnId,
 		runId: ctx.runId,
@@ -1434,7 +1503,8 @@ async function executeTurn(ctx, turn) {
 		toolCounts: {
 			turn: Object.freeze(turnCounts),
 			run: Object.freeze({ ...ctx.runToolCounts })
-		}
+		},
+		cumulativeUsage: buildCumulativeUsage(priorUsage, result.usage)
 	});
 	if (result.done) {
 		if (ctx.schema && !ctx.signal.aborted) {
@@ -2588,9 +2658,11 @@ function createToolSearchTool(options) {
 //#region src/agent.ts
 const HOOK_EVENT_SET = new Set([
 	"system:before",
+	"agent:start",
 	"turn:before",
 	"turn:after",
 	"tool-results:after",
+	"stream:start",
 	"stream:text",
 	"stream:end",
 	"stream:thinking",
@@ -2647,6 +2719,7 @@ const HOOK_EVENT_SET = new Set([
 	"budget:exceeded",
 	"tool-budget:exceeded",
 	"pairing:repair",
+	"tracing:redact",
 	"agent:abort",
 	"agent:done",
 	"session:start",
@@ -2981,6 +3054,16 @@ function createAgent({ provider, name: agentName, system: agentSystem, tools: ag
 					prompt: promptLabel
 				});
 			}
+			const runStartedAt = Date.now();
+			await hooks.callHook("agent:start", {
+				runId,
+				...options.parentRunId ? { parentRunId: options.parentRunId } : {},
+				depth: typeof options.depth === "number" ? options.depth : 0,
+				...agentName ? { agentName } : {},
+				...provider.name ? { providerName: provider.name } : {},
+				startedAt: runStartedAt,
+				...options.tracingContext ? { tracingContext: Object.freeze({ ...options.tracingContext }) } : {}
+			});
 			if (externalSignal) if (externalSignal.aborted) abortController.abort();
 			else {
 				externalAbortListener = () => abortController?.abort();
@@ -3770,7 +3853,7 @@ const edit = {
 			if (readState) {
 				const absKey = readStateKey(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. (Reads inside a \`spawn\` subagent with \`persist: false\` and without \`shareReadState: true\` do NOT propagate to the parent — re-read in the calling context.)`;
+				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.`;
 			}
 		}
@@ -4193,10 +4276,33 @@ const listFiles = {
 };
 //#endregion
 //#region src/tools/multi-edit.ts
+/**
+* Inline annotation builder — kept local to avoid importing from
+* `chat/edit-approval.ts` (that's a renderer-side module; tools live
+* one layer below). Line shape matches `parseEditOutcomesFromResult`'s
+* regex so the round-trip is lossless.
+*
+* Newlines in `reason` are folded to spaces because the parser is line-
+* scoped (`body.split('\n')`); a multi-line reason would split into a
+* "trailing prose" line and trip the malformed-block guard, losing every
+* outcome below it. Static reasons in this file are single-line; the
+* sanitize is a guard against a pathological `target` (file path
+* containing a newline) leaking into `old_string not found in <target>`.
+*/
+function annotationFor(outcomes) {
+	const lines = ["<edit-outcomes>"];
+	for (let i = 0; i < outcomes.length; i++) {
+		const o = outcomes[i];
+		const reason = o.reason ? `: ${o.reason.replace(/\r?\n/g, " ")}` : "";
+		lines.push(`#${i + 1} ${o.kind}${reason}`);
+	}
+	lines.push("</edit-outcomes>");
+	return lines.join("\n");
+}
 const multiEdit = {
 	spec: {
 		name: "multi_edit",
-		description: "Apply a sequential list of edits to a file. Each edit operates on the result of the previous edit. Prefer this over multiple `edit` calls when several non-overlapping changes are needed in the same file. The batch is atomic — if any edit fails to apply, none are written. Each step tolerates `read_file` line-number prefixes (`<N>\\t…`, `<N>|…`, or `<N>→…`) in `old_string` / `new_string`.",
+		description: "Apply a sequential list of edits to a file. Each edit operates on the result of the previous APPLIED edit. Prefer this over multiple `edit` calls when several non-overlapping changes are needed in the same file. Edits run **best-effort**: a per-step failure (`old_string` not found, ambiguous match without `replace_all`, identical strings) is reported in the result but does NOT block the remaining steps. The file is written iff at least one step applied. The result lists per-hunk outcomes (`applied` / `failed`) so the model can re-issue just the failures without resending the whole batch. Each step tolerates `read_file` line-number prefixes (`<N>\\t…`, `<N>|…`, or `<N>→…`) in `old_string` / `new_string`.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4206,7 +4312,7 @@ const multiEdit = {
 				},
 				edits: {
 					type: "array",
-					description: "List of edits applied in order; each operates on the previous edit's output.",
+					description: "List of edits applied in order; each operates on the previous applied edit's output.",
 					items: {
 						type: "object",
 						properties: {
@@ -4236,40 +4342,88 @@ const multiEdit = {
 			if (readState) {
 				const absKey = readStateKey(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. (Reads inside a \`spawn\` subagent with \`persist: false\` and without \`shareReadState: true\` do NOT propagate to the parent — re-read in the calling context.)`;
+				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.`;
 			}
 		}
+		const outcomes = [];
 		let totalReplacements = 0;
 		for (let i = 0; i < steps.length; i++) {
 			const step = steps[i];
 			const find = step.old_string;
 			const replacement = step.new_string;
 			const replaceAll = step.replace_all === true;
-			if (typeof find !== "string" || typeof replacement !== "string") return `multi_edit error: edit #${i + 1} is missing old_string or new_string.`;
-			if (find.length === 0) return `multi_edit error: edit #${i + 1} has empty old_string. Use write_file to fully replace a file.`;
-			if (find === replacement) return `multi_edit error: edit #${i + 1} old_string and new_string are identical.`;
+			if (typeof find !== "string" || typeof replacement !== "string") {
+				outcomes.push({
+					kind: "failed",
+					reason: "missing old_string or new_string"
+				});
+				continue;
+			}
+			if (find.length === 0) {
+				outcomes.push({
+					kind: "failed",
+					reason: "empty old_string (use write_file to fully replace a file)"
+				});
+				continue;
+			}
+			if (find === replacement) {
+				outcomes.push({
+					kind: "failed",
+					reason: "old_string and new_string are identical"
+				});
+				continue;
+			}
 			const match = resolveOldString(current, find);
-			if (!match) return `multi_edit error: edit #${i + 1} old_string not found in ${target}.`;
+			if (!match) {
+				outcomes.push({
+					kind: "failed",
+					reason: `old_string not found in ${target}`
+				});
+				continue;
+			}
 			const { actual, occurrences, via } = match;
-			if (occurrences > 1 && !replaceAll) return `multi_edit error: edit #${i + 1} old_string appears ${occurrences} times. Pass replace_all=true on this edit or expand old_string for uniqueness.`;
+			if (occurrences > 1 && !replaceAll) {
+				outcomes.push({
+					kind: "failed",
+					reason: `old_string appears ${occurrences} times — pass replace_all=true on this edit or expand old_string for uniqueness`
+				});
+				continue;
+			}
 			const styledReplacement = styleReplacementForVia(replacement, via, actual);
 			current = replaceAll ? current.split(actual).join(styledReplacement) : current.replace(actual, styledReplacement);
 			totalReplacements += occurrences;
+			outcomes.push({ kind: "applied" });
 		}
-		await ctx.execution.writeFile(ctx.handle, target, current);
-		const readState = resolveReadStateMap(ctx);
-		if (readState) {
-			const absKey = readStateKey(ctx.handle.cwd, target);
-			const prior = readState.get(absKey);
-			if (prior) readState.set(absKey, {
-				...prior,
-				contentHash: hashContent(current),
-				mtimeMs: Date.now()
-			});
+		const appliedCount = outcomes.reduce((n, o) => o.kind === "applied" ? n + 1 : n, 0);
+		const failedCount = outcomes.length - appliedCount;
+		if (appliedCount > 0) {
+			await ctx.execution.writeFile(ctx.handle, target, current);
+			const readState = resolveReadStateMap(ctx);
+			if (readState) {
+				const absKey = readStateKey(ctx.handle.cwd, target);
+				const prior = readState.get(absKey);
+				if (prior) readState.set(absKey, {
+					...prior,
+					contentHash: hashContent(current),
+					mtimeMs: Date.now()
+				});
+			}
 		}
 		const n = steps.length;
-		return `Edited ${target}: applied ${n} edit${n === 1 ? "" : "s"} (${totalReplacements} replacement${totalReplacements === 1 ? "" : "s"}).`;
+		let header;
+		if (appliedCount === n) header = `Edited ${target}: applied ${n} edit${n === 1 ? "" : "s"} (${totalReplacements} replacement${totalReplacements === 1 ? "" : "s"}).`;
+		else if (appliedCount > 0) header = `Edited ${target}: applied ${appliedCount} of ${n} edits (${totalReplacements} replacement${totalReplacements === 1 ? "" : "s"}).`;
+		else header = `multi_edit error: no edits applied to ${target} (${n} attempted).`;
+		const failureLines = [];
+		for (let i = 0; i < outcomes.length; i++) {
+			const o = outcomes[i];
+			if (o.kind === "failed") failureLines.push(`edit #${i + 1} failed: ${o.reason}`);
+		}
+		const parts = [header];
+		if (failureLines.length > 0) parts.push(failureLines.join("\n"));
+		if (failedCount > 0) parts.push(annotationFor(outcomes));
+		return parts.join("\n\n");
 	}
 };
 //#endregion
@@ -5007,11 +5161,14 @@ function createSpawnTool(options = {}) {
 					};
 				}
 				options.onSpawn?.(child);
-				await ctx.hooks.callHook("spawn:before", {
+				const spawnHookCtx = {
 					id,
 					task,
-					depth: childDepth
-				});
+					depth: childDepth,
+					tracingContext: {}
+				};
+				await ctx.hooks.callHook("spawn:before", spawnHookCtx);
+				const propagatedTracing = Object.keys(spawnHookCtx.tracingContext).length > 0 ? Object.freeze({ ...spawnHookCtx.tracingContext }) : void 0;
 				const runPromise = agent.run({
 					prompt: task,
 					model: options.model,
@@ -5019,7 +5176,8 @@ function createSpawnTool(options = {}) {
 					thinking: options.thinking,
 					signal: ctx.signal,
 					depth: childDepth,
-					...options.persist && ctx.runId ? { parentRunId: ctx.runId } : {}
+					...options.persist && ctx.runId ? { parentRunId: ctx.runId } : {},
+					...propagatedTracing ? { tracingContext: propagatedTracing } : {}
 				});
 				try {
 					finalStats = await raceWithTimeout(runPromise, options.timeoutMs);
@@ -5165,4 +5323,4 @@ const writeFile$1 = {
 //#endregion
 export { readStateKey as A, PERSISTENCE_PREVIEW_BYTES as C, resolvePersistDir as D, maybePersistToolResult as E, getReadState as O, PERSISTED_STUB_PREFIX as S, cleanupPersistedSession as T, createSkillsReadTool as _, multiEdit as a, TOOL_USE_SKIPPED_MESSAGE as b, grep as c, resolveOldString as d, styleReplacementForVia as f, createSkillsRunScriptTool as g, createSkillsUseTool as h, readFile$1 as i, resolveReadStateMap as j, hashContent as k, glob as l, createToolSearchTool as m, createSpawnTool as n, listFiles as o, createAgent as p, shell as r, createInteractionTool as s, writeFile$1 as t, edit as u, INTERRUPT_MESSAGE_FOR_TOOL_USE as v, buildPersistedStub as w, validateToolArgs as x, SHELL_CASCADE_CANCEL_MESSAGE as y };
 
-//# sourceMappingURL=tools-DKdyPoUf.js.map
+//# sourceMappingURL=tools-BNfyY14s.js.map