zidane 5.10.13 → 5.11.1

package/dist/{headless-CPaunZsU.js.map → headless-Bb5gU8AR.js.map}

@@ -1 +1 @@
-{"version":3,"file":"headless-CPaunZsU.js","names":["basic"],"sources":["../src/run-summary.ts","../src/headless.ts"],"sourcesContent":["/**\n * Run summary collector — one JSON postmortem per `agent.run()`.\n *\n * `AgentStats` is great for billing and per-turn accounting but doesn't\n * carry a record of the *interesting* events that happened during a run\n * (errors, gate blocks, validation rejects, budget hits, MCP failures).\n * Reconstructing that from a hook stream after the fact is exactly the\n * kind of plumbing every consumer ends up re-implementing.\n *\n * This module ships:\n *\n * - {@link RunSummary} — a serializable shape that bundles totals,\n *   per-model breakdown, and all the per-run incident lists.\n * - {@link createRunSummaryCollector} — installs hook listeners that\n *   build up a {@link RunSummary} during the run and surfaces it on\n *   `agent:done`. Calls an optional `onSummary` callback so the host can\n *   forward to a log aggregator / DB / postmortem dashboard without\n *   touching `agent.run()`'s return value.\n *\n * The collector is purely additive — it doesn't touch the agent loop,\n * doesn't change return shapes, and doesn't suppress any other hook\n * handlers. Drop it in alongside tracing / metrics / logging or use it\n * standalone when you only need the summary.\n */\n\nimport type { Hookable } from 'hookable'\nimport type { AgentHooks } from './agent'\nimport type { AgentStats } from './types'\nimport { statsByModel } from './stats'\n\n// ---------------------------------------------------------------------------\n// Public shape\n// ---------------------------------------------------------------------------\n\nexport interface RunSummaryTokens {\n  input: number\n  output: number\n  cacheRead: number\n  cacheCreation: number\n  cost?: number\n  /** First observable byte from the provider, ms from run start. */\n  ttftMs?: number\n}\n\nexport interface RunSummaryByModel {\n  modelId: string\n  input: number\n  output: number\n  cacheRead: number\n  cacheCreation: number\n  cost: number\n  turns: number\n}\n\nexport interface RunSummaryError {\n  kind: 'stream' | 'tool' | 'mcp-tool' | 'mcp' | 'spawn'\n  message: string\n  errorType?: string\n  turnId?: string\n  callId?: string\n  server?: string\n  toolName?: string\n  childId?: string\n  statusCode?: number\n  requestId?: string\n}\n\nexport interface RunSummaryBlock {\n  callId: string\n  toolName: string\n  outcome: 'gate-block' | 'unknown' | 'invalid-input'\n  reason?: string\n}\n\nexport interface RunSummaryValidation {\n  callId: string\n  toolName: string\n  reason: string\n}\n\nexport interface RunSummaryBudget {\n  kind: 'bytes' | 'tool-count'\n  /** Tool name (for `'tool-count'`); absent for byte budgets. */\n  toolName?: string\n  /** `mode` for `'tool-count'`; absent for byte budgets. */\n  mode?: 'steer' | 'block'\n  observed: number\n  limit: number\n  turnId?: string\n}\n\nexport interface RunSummaryRepeatGuard {\n  toolName: string\n  /** Consecutive identical calls including the one that tripped the guard. */\n  count: number\n  threshold: number\n  action: 'block' | 'abort'\n  turnId?: string\n}\n\n/**\n * Postmortem snapshot of one `agent.run()`. Strictly serializable — every\n * field round-trips through `JSON.stringify` / `JSON.parse` without loss\n * so a log aggregator can ingest it as-is.\n */\nexport interface RunSummary {\n  runId?: string\n  parentRunId?: string\n  depth: number\n  agentName?: string\n  startedAt: number\n  endedAt: number\n  durationMs: number\n  status: 'completed' | 'aborted'\n  turns: number\n  totals: RunSummaryTokens\n  byModel: RunSummaryByModel[]\n  errors: RunSummaryError[]\n  blocks: RunSummaryBlock[]\n  validationRejects: RunSummaryValidation[]\n  budgetEvents: RunSummaryBudget[]\n  /**\n   * Consecutive-identical repeat-guard escalations. An `action: 'abort'`\n   * entry means the guard terminated the run via the agent's\n   * `AbortController` (the run finalizes as `'aborted'`).\n   */\n  repeatGuardEvents: RunSummaryRepeatGuard[]\n  /** Counts of pairing repairs, keyed by repair mode. */\n  pairingRepairs: Record<string, number>\n  /**\n   * Postmortem snapshots of child runs that bubbled their stats up via\n   * `spawn:complete`. Only present when the run actually spawned.\n   */\n  children?: RunSummary[]\n}\n\n// ---------------------------------------------------------------------------\n// Collector\n// ---------------------------------------------------------------------------\n\nexport interface RunSummaryCollectorOptions {\n  /**\n   * Called with the assembled {@link RunSummary} on every `agent:done`.\n   * Synchronous — heavy I/O should be deferred (e.g. via `setImmediate`).\n   */\n  onSummary?: (summary: RunSummary) => void\n}\n\nexport interface RunSummaryCollector {\n  /** Install the collector's hook handlers. Returns an uninstall fn. */\n  install: (hooks: Hookable<AgentHooks>) => () => void\n  /** Most-recent summary; `undefined` until the first `agent:done` fires. */\n  latest: () => RunSummary | undefined\n}\n\n/**\n * Build a run-summary collector. State is created fresh inside each\n * `install()` call, so a single collector instance can be installed\n * across multiple agents without attribution cross-talk. `latest()`\n * returns the most-recent summary across **any** install — install\n * per-agent collectors if you need separate post-run snapshots.\n *\n * @example\n * ```ts\n * const collector = createRunSummaryCollector({\n *   onSummary: s => console.log(JSON.stringify(s)),\n * })\n * const uninstall = collector.install(agent.hooks)\n * try { await agent.run({ prompt }) }\n * finally { uninstall() }\n * ```\n */\nexport function createRunSummaryCollector(\n  options: RunSummaryCollectorOptions = {},\n): RunSummaryCollector {\n  let last: RunSummary | undefined\n\n  return {\n    latest: () => last,\n    install(hooks: Hookable<AgentHooks>): () => void {\n      // Per-run in-progress accumulators. The hookable bus serializes\n      // agent.run lifecycles per agent — we reset between runs on\n      // `agent:start` and consume on `agent:done`.\n      let runId: string | undefined\n      let parentRunId: string | undefined\n      let depth = 0\n      let agentName: string | undefined\n      let startedAt = Date.now()\n      let aborted = false\n      const errors: RunSummaryError[] = []\n      const blocks: RunSummaryBlock[] = []\n      const validationRejects: RunSummaryValidation[] = []\n      const budgetEvents: RunSummaryBudget[] = []\n      const repeatGuardEvents: RunSummaryRepeatGuard[] = []\n      const pairingRepairs: Record<string, number> = {}\n      const children: RunSummary[] = []\n\n      function resetForNewRun(): void {\n        aborted = false\n        errors.length = 0\n        blocks.length = 0\n        validationRejects.length = 0\n        budgetEvents.length = 0\n        repeatGuardEvents.length = 0\n        for (const k of Object.keys(pairingRepairs))\n          delete pairingRepairs[k]\n        children.length = 0\n      }\n\n      const unregisters: Array<() => void> = []\n\n      unregisters.push(hooks.hook('agent:start', (ctx) => {\n        resetForNewRun()\n        runId = ctx.runId\n        parentRunId = ctx.parentRunId\n        depth = ctx.depth\n        agentName = ctx.agentName\n        startedAt = ctx.startedAt\n      }))\n\n      unregisters.push(hooks.hook('agent:abort', () => {\n        aborted = true\n      }))\n\n      unregisters.push(hooks.hook('stream:error', (ctx) => {\n        const msg = ctx.err instanceof Error ? ctx.err.message : String(ctx.err)\n        const errorType = ctx.err instanceof Error ? ctx.err.name : 'unknown'\n        errors.push({\n          kind: 'stream',\n          message: msg,\n          errorType,\n          turnId: ctx.turnId,\n          ...(ctx.statusCode !== undefined ? { statusCode: ctx.statusCode } : {}),\n          ...(ctx.requestId !== undefined ? { requestId: ctx.requestId } : {}),\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:error', (ctx) => {\n        errors.push({\n          kind: 'tool',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          turnId: ctx.turnId,\n          callId: ctx.callId,\n          toolName: ctx.name,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:tool:error', (ctx) => {\n        errors.push({\n          kind: 'mcp-tool',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          turnId: ctx.turnId,\n          callId: ctx.callId,\n          server: ctx.server,\n          toolName: ctx.displayName,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:error', (ctx) => {\n        errors.push({\n          kind: 'mcp',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          server: ctx.name,\n        })\n      }))\n\n      unregisters.push(hooks.hook('spawn:error', (ctx) => {\n        errors.push({\n          kind: 'spawn',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          childId: ctx.id,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:dispatched', (ctx) => {\n        if (ctx.outcome === 'gate-block' || ctx.outcome === 'unknown' || ctx.outcome === 'invalid-input') {\n          blocks.push({\n            callId: ctx.callId,\n            toolName: ctx.name,\n            outcome: ctx.outcome,\n            ...(ctx.reason ? { reason: ctx.reason } : {}),\n          })\n        }\n      }))\n\n      unregisters.push(hooks.hook('validation:reject', (ctx) => {\n        validationRejects.push({\n          callId: ctx.callId,\n          toolName: ctx.name,\n          reason: ctx.reason,\n        })\n      }))\n\n      unregisters.push(hooks.hook('budget:exceeded', (ctx) => {\n        budgetEvents.push({\n          kind: 'bytes',\n          observed: ctx.bytes,\n          limit: ctx.budget,\n          turnId: ctx.turnId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool-budget:exceeded', (ctx) => {\n        budgetEvents.push({\n          kind: 'tool-count',\n          toolName: ctx.tool,\n          mode: ctx.mode,\n          observed: ctx.count,\n          limit: ctx.max,\n          turnId: ctx.turnId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('repeat-guard:exceeded', (ctx) => {\n        repeatGuardEvents.push({\n          toolName: ctx.tool,\n          count: ctx.count,\n          threshold: ctx.threshold,\n          action: ctx.action,\n          turnId: ctx.turnId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('pairing:repair', (ctx) => {\n        pairingRepairs[ctx.mode] = (pairingRepairs[ctx.mode] ?? 0) + 1\n      }))\n\n      unregisters.push(hooks.hook('agent:done', (stats) => {\n        const endedAt = Date.now()\n\n        // Build per-model rollup via the existing `statsByModel` helper\n        // so we stay in lockstep with how the rest of the harness\n        // attributes cost and tokens by model id.\n        const byModel: RunSummaryByModel[] = []\n        for (const [modelId, usage] of statsByModel(stats)) {\n          byModel.push({\n            modelId,\n            input: usage.input,\n            output: usage.output,\n            cacheRead: usage.cacheRead,\n            cacheCreation: usage.cacheCreation,\n            cost: usage.cost,\n            turns: usage.turns,\n          })\n        }\n\n        // Flatten child stats into nested summaries. We don't have the\n        // child's full event lists here (those landed on the child's\n        // own hooks), so the nested entry is a minimal totals-only\n        // record — enough for a flat per-run audit trail; consumers\n        // wanting full per-child event lists install a collector on\n        // each subagent.\n        for (const c of stats.children ?? []) {\n          children.push(minimalSummaryFromStats(c.stats, {\n            depth: c.depth ?? depth + 1,\n            status: c.status === 'aborted' ? 'aborted' : 'completed',\n          }))\n        }\n\n        const summary: RunSummary = {\n          ...(runId ? { runId } : {}),\n          ...(parentRunId ? { parentRunId } : {}),\n          depth,\n          ...(agentName ? { agentName } : {}),\n          startedAt,\n          endedAt,\n          durationMs: endedAt - startedAt,\n          status: aborted ? 'aborted' : 'completed',\n          turns: stats.turns,\n          totals: buildTotals(stats),\n          byModel,\n          errors: errors.slice(),\n          blocks: blocks.slice(),\n          validationRejects: validationRejects.slice(),\n          budgetEvents: budgetEvents.slice(),\n          repeatGuardEvents: repeatGuardEvents.slice(),\n          pairingRepairs: { ...pairingRepairs },\n          ...(children.length > 0 ? { children: children.slice() } : {}),\n        }\n\n        last = summary\n        try {\n          options.onSummary?.(summary)\n        }\n        catch {\n          // Sink errors are not the collector's concern.\n        }\n      }))\n\n      let disposed = false\n      return function uninstall() {\n        if (disposed)\n          return\n        disposed = true\n        for (const un of unregisters) {\n          try {\n            un()\n          }\n          catch { /* ignore */ }\n        }\n      }\n    },\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction buildTotals(stats: AgentStats): RunSummaryTokens {\n  return {\n    input: stats.totalIn,\n    output: stats.totalOut,\n    cacheRead: stats.totalCacheRead,\n    cacheCreation: stats.totalCacheCreation,\n    ...(typeof stats.cost === 'number' ? { cost: stats.cost } : {}),\n    ...(typeof stats.timeTillFirstTokenMs === 'number' ? { ttftMs: stats.timeTillFirstTokenMs } : {}),\n  }\n}\n\nfunction minimalSummaryFromStats(\n  stats: AgentStats,\n  meta: { depth: number, status: 'completed' | 'aborted' },\n): RunSummary {\n  const byModel: RunSummaryByModel[] = []\n  for (const [modelId, usage] of statsByModel(stats)) {\n    byModel.push({\n      modelId,\n      input: usage.input,\n      output: usage.output,\n      cacheRead: usage.cacheRead,\n      cacheCreation: usage.cacheCreation,\n      cost: usage.cost,\n      turns: usage.turns,\n    })\n  }\n  const children: RunSummary[] = []\n  for (const c of stats.children ?? []) {\n    children.push(minimalSummaryFromStats(c.stats, {\n      depth: c.depth ?? meta.depth + 1,\n      status: c.status === 'aborted' ? 'aborted' : 'completed',\n    }))\n  }\n  return {\n    depth: meta.depth,\n    startedAt: 0,\n    endedAt: 0,\n    durationMs: stats.elapsed,\n    status: meta.status,\n    turns: stats.turns,\n    totals: buildTotals(stats),\n    byModel,\n    errors: [],\n    blocks: [],\n    validationRejects: [],\n    budgetEvents: [],\n    repeatGuardEvents: [],\n    pairingRepairs: {},\n    ...(children.length > 0 ? { children } : {}),\n  }\n}\n","/**\n * Headless mode — a non-interactive, fully-structured way to drive the agent\n * for automation and RL rollouts.\n *\n * `agent.run()` already returns rich {@link AgentStats}, the session captures a\n * lossless transcript (`session.turns`), and the hook bus exposes every\n * streaming/tool/turn event. What this module adds is the *contract* an RL loop\n * needs: one call (`runHeadless`) that runs a prompt to completion in a chosen\n * workdir, bounded by turns + wall-clock, and hands back a single serializable\n * {@link HeadlessResult} — final answer, verifiable structured output, usage,\n * and the complete trajectory — plus an optional live {@link HeadlessEvent}\n * stream (the in-process equivalent of `--output-format stream-json`).\n *\n * It is provider-agnostic: the caller passes a built {@link Provider} (e.g.\n * `local()` pointed at a vLLM server, or any of the named providers). The thin\n * CLI in `src/headless-cli.ts` wraps this with arg parsing, file/stdin I/O, and\n * JSONL transcript writing.\n */\n\nimport type { Hookable } from 'hookable'\nimport type { AgentHooks, AgentOptions } from './agent'\nimport type { ExecutionContext } from './contexts'\nimport type { Provider } from './providers'\nimport type { RunSummary } from './run-summary'\nimport type { Session, SessionStore } from './session'\nimport type { PairingRepair } from './session/messages'\nimport type { ToolDef } from './tools'\nimport type {\n  AgentStats,\n  McpServerConfig,\n  PromptPart,\n  SessionContentBlock,\n  SessionTurn,\n  ThinkingLevel,\n  ToolResultContent,\n  ToolResultDocumentContent,\n  TurnFinishReason,\n} from './types'\nimport { createAgent } from './agent'\nimport { createProcessContext } from './contexts'\nimport { basic } from './presets'\nimport { createRunSummaryCollector } from './run-summary'\nimport { createMemoryStore, createSession, toAnthropic } from './session'\nimport { ensureToolResultPairing } from './session/messages'\nimport { documentBlockMarker, toolResultToText } from './types'\n\n// ---------------------------------------------------------------------------\n// Public shapes\n// ---------------------------------------------------------------------------\n\nexport type HeadlessStatus = 'completed' | 'aborted' | 'error' | 'timeout'\n\nexport interface HeadlessUsage {\n  input: number\n  output: number\n  cacheRead: number\n  cacheCreation: number\n  /** Cumulative USD cost when the provider/registry could price the run. */\n  cost?: number\n}\n\nexport interface HeadlessErrorInfo {\n  message: string\n  /** Typed-error class name (`AgentAbortedError`, `AgentContextExceededError`, …). */\n  type: string\n}\n\n/**\n * Strictly JSON-serializable postmortem of one headless run. Everything an RL\n * reward function needs: the final answer (`finalText`), the verifiable\n * structured output (`output`, present iff a `schema` was set), usage/turns,\n * and the lossless `transcript` (the SFT training data).\n */\nexport interface HeadlessResult {\n  status: HeadlessStatus\n  /** Concatenated text of the last assistant turn that produced any text. */\n  finalText: string\n  /** Schema-enforced structured output (only when `opts.schema` is set). */\n  output?: Record<string, unknown>\n  usage: HeadlessUsage\n  turns: number\n  durationMs: number\n  /** Total `tool_call` blocks across the whole transcript. */\n  numToolCalls: number\n  /** Finish reason of the final turn that reported one. */\n  finishReason?: TurnFinishReason\n  error?: HeadlessErrorInfo\n  sessionId: string\n  /** Incident postmortem (errors, gate blocks, budget events) via run-summary. */\n  summary?: RunSummary\n  /** Lossless transcript — raw `session.turns`. Thinking stripped when `includeThinking: false`. */\n  transcript: SessionTurn[]\n}\n\nexport type HeadlessOutputFormat = 'zidane' | 'provider'\n\nexport type ProviderTranscriptFormat = 'anthropic' | 'openai'\n\nexport type FormattedHeadlessResult\n  = | HeadlessResult\n    | unknown[]\n\nexport type FormattedHeadlessTurnEvent\n  = | Extract<HeadlessEvent, { type: 'turn' }>\n    | unknown[]\n\nexport function exitCodeForHeadlessResult(result: HeadlessResult): number {\n  switch (result.status) {\n    case 'completed': return 0\n    case 'timeout': return 124\n    case 'aborted': return 130\n    case 'error':\n    default: return 1\n  }\n}\n\n/**\n * Live event union — the in-process equivalent of a `stream-json` line. Every\n * member is JSON-serializable; render to JSONL with {@link headlessEventToJsonl}.\n */\nexport type HeadlessEvent\n  = | { type: 'start', runId: string, provider?: string }\n    | { type: 'text', delta: string }\n    | { type: 'thinking', delta: string }\n    | { type: 'tool_call', callId: string, name: string, input: Record<string, unknown> }\n    | { type: 'tool_result', callId: string, name: string, output: string, isError: boolean }\n    | { type: 'turn', index: number, turn: SessionTurn }\n    | { type: 'spawn', event: 'before' | 'complete' | 'error', id: string, info?: Record<string, unknown> }\n    | { type: 'error', message: string, errorType?: string }\n    | { type: 'result', result: HeadlessResult }\n\n/** Serialize one event as a newline-terminated JSON line (stream-json). */\nexport function headlessEventToJsonl(event: HeadlessEvent): string {\n  return `${JSON.stringify(event)}\\n`\n}\n\nexport function formattedHeadlessTurnEventToJsonl(event: FormattedHeadlessTurnEvent): string {\n  return `${JSON.stringify(event)}\\n`\n}\n\nexport function providerTranscriptFormatForProvider(providerName: string): ProviderTranscriptFormat {\n  return providerName === 'anthropic' ? 'anthropic' : 'openai'\n}\n\nexport function transcriptToProviderMessages(\n  turns: SessionTurn[],\n  providerName: string,\n): unknown[] {\n  const format = providerTranscriptFormatForProvider(providerName)\n  if (format === 'anthropic') {\n    return turns\n      .filter((turn): turn is SessionTurn & { role: 'user' | 'assistant' } => turn.role === 'user' || turn.role === 'assistant')\n      .map(turn => toAnthropic({ role: turn.role, content: turn.content }))\n  }\n  return transcriptToOpenAIMessages(turns, { strictToolPairing: false })\n}\n\nexport function formatHeadlessResult(\n  result: HeadlessResult,\n  options: { format: HeadlessOutputFormat, providerName: string },\n): FormattedHeadlessResult {\n  if (options.format === 'zidane')\n    return result\n  return transcriptToProviderMessages(result.transcript, options.providerName)\n}\n\nexport function formatHeadlessTurnEvent(\n  event: Extract<HeadlessEvent, { type: 'turn' }>,\n  options: { format: HeadlessOutputFormat, providerName: string },\n): FormattedHeadlessTurnEvent {\n  if (options.format === 'zidane')\n    return event\n  return transcriptToProviderMessages([event.turn], options.providerName)\n}\n\nexport interface HeadlessOptions {\n  /** User prompt — plain string or multimodal `PromptPart[]`. */\n  prompt: string | PromptPart[]\n  /** Built provider (e.g. `local()`, `openaiCompat(...)`, `anthropic(...)`). */\n  provider: Provider\n  model?: string\n  /** Override the preset system prompt for this run. */\n  system?: string\n  thinking?: ThinkingLevel\n  maxTurns?: number\n  maxTokens?: number\n  /** Wall-clock cap; on expiry the run is aborted and `status` becomes `'timeout'`. */\n  timeoutMs?: number\n  /** External abort signal — chained with the internal timeout controller. */\n  signal?: AbortSignal\n  /** JSON Schema for structured-output enforcement → populates `result.output`. */\n  schema?: Record<string, unknown>\n  /** Agent behavior defaults for this headless run. Top-level shortcuts below override matching fields. */\n  behavior?: AgentOptions['behavior']\n  /** Tool overrides. Omit to use the basic preset's tools. */\n  tools?: Record<string, ToolDef>\n  mcpServers?: McpServerConfig[]\n  skills?: AgentOptions['skills']\n  /** Execution context. Defaults to a process context rooted at `cwd`. */\n  execution?: ExecutionContext\n  /** Working directory for the default process context (ignored if `execution` is set). */\n  cwd?: string\n  /** Reuse / resume an existing session. */\n  session?: Session\n  /** Session store for a fresh session (defaults to an in-memory store). */\n  store?: SessionStore\n  /** Keep `thinking` blocks in `result.transcript` (default true). */\n  includeThinking?: boolean\n  /** Live event callback — the in-process stream-json equivalent. */\n  onEvent?: (event: HeadlessEvent) => void\n}\n\n// ---------------------------------------------------------------------------\n// runHeadless\n// ---------------------------------------------------------------------------\n\n/**\n * Run a prompt to completion, headless, and return a single serializable\n * {@link HeadlessResult}. Safe to call concurrently for parallel rollouts —\n * each call builds its own agent + session and tears them down in `finally`.\n */\nexport async function runHeadless(opts: HeadlessOptions): Promise<HeadlessResult> {\n  const startedAt = Date.now()\n  const execution = opts.execution ?? createProcessContext({ cwd: opts.cwd })\n  const session = opts.session ?? await createSession({ store: opts.store ?? createMemoryStore() })\n\n  const behavior: NonNullable<AgentOptions['behavior']> = { ...(opts.behavior ?? {}) }\n  if (opts.maxTurns !== undefined)\n    behavior.maxTurns = opts.maxTurns\n  if (opts.maxTokens !== undefined)\n    behavior.maxTokens = opts.maxTokens\n  if (opts.schema !== undefined)\n    behavior.schema = opts.schema\n\n  const agent = createAgent({\n    ...basic,\n    provider: opts.provider,\n    execution,\n    session,\n    behavior,\n    ...(opts.tools !== undefined ? { tools: opts.tools } : {}),\n    ...(opts.mcpServers !== undefined ? { mcpServers: opts.mcpServers } : {}),\n    ...(opts.skills !== undefined ? { skills: opts.skills } : {}),\n  })\n\n  const collector = createRunSummaryCollector()\n  const uninstallSummary = collector.install(agent.hooks)\n  const uninstallEvents = opts.onEvent ? installHeadlessEventAdapter(agent.hooks, opts.onEvent) : noop\n\n  // Resumed sessions carry turns from prior runs — remember where this run\n  // starts so transcript/finalText/numToolCalls stay per-run, matching the\n  // per-run usage/turns/durationMs stats.\n  const runStartIndex = session.turns.length\n\n  // Internal controller drives the wall-clock timeout and chains any external\n  // signal so a host cancel and a timeout both abort the same run. The\n  // listener is removed in `finally` — a long-lived host signal must not\n  // accumulate one listener per rollout.\n  const controller = new AbortController()\n  const onExternalAbort = (): void => controller.abort(opts.signal!.reason)\n  if (opts.signal) {\n    if (opts.signal.aborted)\n      controller.abort(opts.signal.reason)\n    else\n      opts.signal.addEventListener('abort', onExternalAbort, { once: true })\n  }\n  let timedOut = false\n  const timer = opts.timeoutMs && opts.timeoutMs > 0\n    ? setTimeout(() => {\n        timedOut = true\n        controller.abort(new Error(`Headless run timed out after ${opts.timeoutMs}ms`))\n      }, opts.timeoutMs)\n    : undefined\n\n  let stats: AgentStats | undefined\n  let error: HeadlessErrorInfo | undefined\n\n  try {\n    stats = await agent.run({\n      prompt: opts.prompt,\n      signal: controller.signal,\n      ...(opts.model !== undefined ? { model: opts.model } : {}),\n      ...(opts.system !== undefined ? { system: opts.system } : {}),\n      ...(opts.thinking !== undefined ? { thinking: opts.thinking } : {}),\n    })\n  }\n  catch (err) {\n    // The agent loop throws typed errors (AgentAbortedError,\n    // AgentContextExceededError, AgentProviderError, …) — their `name` already\n    // classifies the failure, so surface it directly.\n    const e = err instanceof Error ? err : new Error(String(err))\n    error = { message: e.message, type: e.name }\n  }\n  finally {\n    if (timer)\n      clearTimeout(timer)\n    opts.signal?.removeEventListener('abort', onExternalAbort)\n    uninstallEvents()\n    uninstallSummary()\n    await agent.destroy()\n  }\n\n  // Status: a thrown error wins, but an abort/timeout can also surface as a\n  // clean resolve (the loop returns partial stats), so check the signal too.\n  let status: HeadlessStatus\n  if (error)\n    status = timedOut ? 'timeout' : controller.signal.aborted ? 'aborted' : 'error'\n  else if (controller.signal.aborted)\n    status = timedOut ? 'timeout' : 'aborted'\n  else\n    status = 'completed'\n\n  const rawTranscript = session.turns.slice(runStartIndex)\n  const transcript = opts.includeThinking === false ? stripThinking(rawTranscript) : rawTranscript\n  const summary = collector.latest()\n\n  const result: HeadlessResult = {\n    status,\n    finalText: extractFinalText(rawTranscript),\n    ...(stats?.output ? { output: stats.output } : {}),\n    usage: {\n      input: stats?.totalIn ?? 0,\n      output: stats?.totalOut ?? 0,\n      cacheRead: stats?.totalCacheRead ?? 0,\n      cacheCreation: stats?.totalCacheCreation ?? 0,\n      ...(typeof stats?.cost === 'number' ? { cost: stats.cost } : {}),\n    },\n    turns: stats?.turns ?? 0,\n    durationMs: stats?.elapsed ?? (Date.now() - startedAt),\n    numToolCalls: countToolCalls(rawTranscript),\n    // Suppress `finishReason` on abort/timeout: the last persisted turn can\n    // carry `finishReason: 'stop'` (e.g. the model finished a turn, a follow-up\n    // continued, then the run was cancelled), which would make a consumer\n    // keyed on `finishReason === 'stop'` misread a cancel as \"model finished\".\n    // `status` is authoritative for those exits; let it speak alone. The\n    // `'pause'` exhaustion exit keeps `status: 'completed'` so it still\n    // surfaces its `finishReason: 'pause'` here.\n    ...(status !== 'aborted' && status !== 'timeout' && lastFinishReason(stats)\n      ? { finishReason: lastFinishReason(stats) }\n      : {}),\n    ...(error ? { error } : {}),\n    sessionId: session.id,\n    ...(summary ? { summary } : {}),\n    transcript,\n  }\n\n  opts.onEvent?.({ type: 'result', result })\n  return result\n}\n\n// ---------------------------------------------------------------------------\n// Transcript → OpenAI chat messages (SFT-ready)\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIChatMessage {\n  role: 'system' | 'user' | 'assistant' | 'tool'\n  content: string | null | OpenAIChatContentPart[]\n  tool_calls?: Array<{ id: string, type: 'function', function: { name: string, arguments: string } }>\n  tool_call_id?: string\n}\n\nexport type OpenAIChatContentPart\n  = | { type: 'text', text: string }\n    | { type: 'image_url', image_url: { url: string } }\n\n/**\n * Convert raw `session.turns` into standard OpenAI chat-completion messages:\n * assistant turns carry `tool_calls`, and each `tool_result` becomes its own\n * `role: 'tool'` message. This is the drop-in shape for an SFT renderer —\n * unlike `toOpenAI` (session/messages.ts), which emits an internal `_tag`\n * envelope meant for re-sending to a provider, not for training data.\n *\n * Fails closed on corrupt raw turns instead of fabricating tool results; silent\n * placeholders would create structurally-valid but semantically-poisoned SFT\n * examples.\n */\nexport function transcriptToOpenAIMessages(\n  turns: SessionTurn[],\n  options: { strictToolPairing?: boolean } = {},\n): OpenAIChatMessage[] {\n  const { strictToolPairing = true } = options\n  const messages: OpenAIChatMessage[] = []\n  let chunk: Array<{ role: 'user' | 'assistant', content: SessionContentBlock[] }> = []\n  const flushChunk = () => {\n    if (chunk.length === 0)\n      return\n    let paired = chunk\n    if (strictToolPairing) {\n      const repairs: PairingRepair[] = []\n      paired = ensureToolResultPairing(chunk, { onRepair: repair => repairs.push(repair) })\n      if (repairs.length > 0) {\n        throw new Error(\n          `Cannot convert transcript to OpenAI messages: tool pairing repair required (${repairs.map(r => r.mode).join(', ')})`,\n        )\n      }\n    }\n    for (const msg of paired)\n      pushOpenAIChatMessage(messages, msg)\n    chunk = []\n  }\n\n  for (const turn of turns) {\n    if (turn.role === 'system') {\n      flushChunk()\n      messages.push({ role: 'system', content: textOf(turn.content) })\n      continue\n    }\n    chunk.push({ role: turn.role, content: turn.content })\n  }\n  flushChunk()\n\n  return messages\n}\n\nfunction pushOpenAIChatMessage(messages: OpenAIChatMessage[], msg: { role: 'user' | 'assistant', content: SessionContentBlock[] }): void {\n  const text = textOf(msg.content)\n\n  if (msg.role === 'assistant') {\n    const toolCalls = msg.content.filter((b): b is ToolCallBlock => b.type === 'tool_call')\n    const out: OpenAIChatMessage = { role: 'assistant', content: text || null }\n    if (toolCalls.length > 0) {\n      out.tool_calls = toolCalls.map(b => ({\n        id: b.id,\n        type: 'function' as const,\n        function: { name: b.name, arguments: JSON.stringify(b.input) },\n      }))\n    }\n    messages.push(out)\n    return\n  }\n\n  // user turn — may carry prompt text/images and/or tool_result blocks\n  const userParts = contentPartsFromBlocks(msg.content)\n  if (userParts.length > 0)\n    messages.push({ role: 'user', content: simplifyOpenAIContent(userParts) })\n\n  for (const tr of msg.content.filter((b): b is ToolResultBlock => b.type === 'tool_result')) {\n    const { text, images } = summarizeToolResultForOpenAI(tr.output)\n    if (images.length === 0) {\n      messages.push({ role: 'tool', tool_call_id: tr.callId, content: text })\n      continue\n    }\n\n    const noun = images.length === 1 ? 'image' : 'images'\n    const marker = `[${images.length} ${noun} attached — see next user message]`\n    messages.push({\n      role: 'tool',\n      tool_call_id: tr.callId,\n      content: text.length > 0 ? `${text}\\n\\n${marker}` : marker,\n    })\n    messages.push({\n      role: 'user',\n      content: [\n        ...images.map(toOpenAIImagePart),\n        { type: 'text', text: `(${noun} returned by tool call ${tr.callId})` },\n      ],\n    })\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internals\n// ---------------------------------------------------------------------------\n\ntype TextBlock = Extract<SessionContentBlock, { type: 'text' }>\ntype ToolCallBlock = Extract<SessionContentBlock, { type: 'tool_call' }>\ntype ToolResultBlock = Extract<SessionContentBlock, { type: 'tool_result' }>\n\nfunction noop(): void {}\n\nfunction textOf(content: SessionContentBlock[]): string {\n  return content.filter((b): b is TextBlock => b.type === 'text').map(b => b.text).join('')\n}\n\nfunction contentPartsFromBlocks(content: SessionContentBlock[]): OpenAIChatContentPart[] {\n  const parts: OpenAIChatContentPart[] = []\n  for (const block of content) {\n    if (block.type === 'image')\n      parts.push(toOpenAIImagePart(block))\n    else if (block.type === 'document')\n      parts.push({ type: 'text', text: documentMarker(block) })\n    else if (block.type === 'text' && block.text.length > 0)\n      parts.push({ type: 'text', text: block.text })\n  }\n  return parts\n}\n\nfunction simplifyOpenAIContent(parts: OpenAIChatContentPart[]): string | OpenAIChatContentPart[] {\n  if (parts.length === 1 && parts[0].type === 'text')\n    return parts[0].text\n  return parts\n}\n\nfunction toOpenAIImagePart(image: { mediaType: string, data: string }): OpenAIChatContentPart {\n  return {\n    type: 'image_url',\n    image_url: { url: `data:${image.mediaType};base64,${image.data}` },\n  }\n}\n\nfunction summarizeToolResultForOpenAI(output: string | ToolResultContent[]): {\n  text: string\n  images: Array<{ mediaType: string, data: string }>\n} {\n  if (typeof output === 'string')\n    return { text: output, images: [] }\n\n  const texts: string[] = []\n  const images: Array<{ mediaType: string, data: string }> = []\n  for (const block of output) {\n    if (block.type === 'text') {\n      texts.push(block.text)\n    }\n    else if (block.type === 'image') {\n      images.push({ mediaType: block.mediaType, data: block.data })\n    }\n    else {\n      texts.push(documentMarker(block))\n    }\n  }\n  return { text: texts.join('\\n'), images }\n}\n\nfunction documentMarker(doc: ToolResultDocumentContent): string {\n  return documentBlockMarker(doc, 'document omitted')\n}\n\nfunction extractFinalText(turns: SessionTurn[]): string {\n  for (let i = turns.length - 1; i >= 0; i--) {\n    const turn = turns[i]\n    if (turn.role !== 'assistant')\n      continue\n    const text = textOf(turn.content)\n    if (text)\n      return text\n  }\n  return ''\n}\n\nfunction countToolCalls(turns: SessionTurn[]): number {\n  let n = 0\n  for (const turn of turns) {\n    for (const block of turn.content) {\n      if (block.type === 'tool_call')\n        n++\n    }\n  }\n  return n\n}\n\nfunction lastFinishReason(stats?: AgentStats): TurnFinishReason | undefined {\n  const usages = stats?.turnUsage\n  if (!usages)\n    return undefined\n  for (let i = usages.length - 1; i >= 0; i--) {\n    if (usages[i].finishReason)\n      return usages[i].finishReason\n  }\n  return undefined\n}\n\nfunction stripThinking(turns: SessionTurn[]): SessionTurn[] {\n  return turns.map(turn => ({\n    ...turn,\n    content: turn.content.filter(b => b.type !== 'thinking' && b.type !== 'redacted_thinking'),\n  }))\n}\n\nexport function installHeadlessEventAdapter(\n  hooks: Hookable<AgentHooks>,\n  onEvent: (event: HeadlessEvent) => void,\n): () => void {\n  const unregs: Array<() => void> = []\n  const emittedTurnIds = new Set<string>()\n  const emit = (event: HeadlessEvent): void => {\n    try {\n      onEvent(event)\n    }\n    catch {\n      // A consumer's sink throwing is not the adapter's concern.\n    }\n  }\n\n  unregs.push(hooks.hook('agent:start', ctx => emit({\n    type: 'start',\n    runId: ctx.runId,\n    ...(ctx.providerName ? { provider: ctx.providerName } : {}),\n  })))\n  unregs.push(hooks.hook('stream:text', ctx => emit({ type: 'text', delta: ctx.delta })))\n  unregs.push(hooks.hook('stream:thinking', ctx => emit({ type: 'thinking', delta: ctx.delta })))\n  unregs.push(hooks.hook('tool:before', ctx => emit({\n    type: 'tool_call',\n    callId: ctx.callId,\n    name: ctx.name,\n    input: ctx.input,\n  })))\n  unregs.push(hooks.hook('tool:after', ctx => emit({\n    type: 'tool_result',\n    callId: ctx.callId,\n    name: ctx.name,\n    output: toolResultToText(ctx.result),\n    isError: false,\n  })))\n  unregs.push(hooks.hook('tool:error', ctx => emit({\n    type: 'tool_result',\n    callId: ctx.callId,\n    name: ctx.name,\n    output: ctx.error.message,\n    isError: true,\n  })))\n  unregs.push(hooks.hook('session:turns', (ctx) => {\n    const startIndex = ctx.count - ctx.turns.length\n    ctx.turns.forEach((turn, i) => {\n      if (emittedTurnIds.has(turn.id))\n        return\n      emittedTurnIds.add(turn.id)\n      emit({ type: 'turn', index: startIndex + i, turn })\n    })\n  }))\n  unregs.push(hooks.hook('spawn:before', ctx => emit({ type: 'spawn', event: 'before', id: ctx.id })))\n  unregs.push(hooks.hook('spawn:complete', ctx => emit({\n    type: 'spawn',\n    event: 'complete',\n    id: ctx.id,\n    info: { status: ctx.status ?? 'completed' },\n  })))\n  unregs.push(hooks.hook('spawn:error', ctx => emit({\n    type: 'spawn',\n    event: 'error',\n    id: ctx.id,\n    info: { message: ctx.error.message },\n  })))\n  unregs.push(hooks.hook('stream:error', ctx => emit({\n    type: 'error',\n    message: ctx.err instanceof Error ? ctx.err.message : String(ctx.err),\n    ...(ctx.err instanceof Error ? { errorType: ctx.err.name } : {}),\n  })))\n\n  return () => {\n    for (const un of unregs) {\n      try {\n        un()\n      }\n      catch {\n        // ignore\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"headless-Bb5gU8AR.js","names":["basic"],"sources":["../src/run-summary.ts","../src/headless.ts"],"sourcesContent":["/**\n * Run summary collector — one JSON postmortem per `agent.run()`.\n *\n * `AgentStats` is great for billing and per-turn accounting but doesn't\n * carry a record of the *interesting* events that happened during a run\n * (errors, gate blocks, validation rejects, budget hits, MCP failures).\n * Reconstructing that from a hook stream after the fact is exactly the\n * kind of plumbing every consumer ends up re-implementing.\n *\n * This module ships:\n *\n * - {@link RunSummary} — a serializable shape that bundles totals,\n *   per-model breakdown, and all the per-run incident lists.\n * - {@link createRunSummaryCollector} — installs hook listeners that\n *   build up a {@link RunSummary} during the run and surfaces it on\n *   `agent:done`. Calls an optional `onSummary` callback so the host can\n *   forward to a log aggregator / DB / postmortem dashboard without\n *   touching `agent.run()`'s return value.\n *\n * The collector is purely additive — it doesn't touch the agent loop,\n * doesn't change return shapes, and doesn't suppress any other hook\n * handlers. Drop it in alongside tracing / metrics / logging or use it\n * standalone when you only need the summary.\n */\n\nimport type { Hookable } from 'hookable'\nimport type { AgentHooks } from './agent'\nimport type { AgentStats } from './types'\nimport { statsByModel } from './stats'\n\n// ---------------------------------------------------------------------------\n// Public shape\n// ---------------------------------------------------------------------------\n\nexport interface RunSummaryTokens {\n  input: number\n  output: number\n  cacheRead: number\n  cacheCreation: number\n  cost?: number\n  /** First observable byte from the provider, ms from run start. */\n  ttftMs?: number\n}\n\nexport interface RunSummaryByModel {\n  modelId: string\n  input: number\n  output: number\n  cacheRead: number\n  cacheCreation: number\n  cost: number\n  turns: number\n}\n\nexport interface RunSummaryError {\n  kind: 'stream' | 'tool' | 'mcp-tool' | 'mcp' | 'spawn'\n  message: string\n  errorType?: string\n  turnId?: string\n  callId?: string\n  server?: string\n  toolName?: string\n  childId?: string\n  statusCode?: number\n  requestId?: string\n}\n\nexport interface RunSummaryBlock {\n  callId: string\n  toolName: string\n  outcome: 'gate-block' | 'unknown' | 'invalid-input'\n  reason?: string\n}\n\nexport interface RunSummaryValidation {\n  callId: string\n  toolName: string\n  reason: string\n}\n\nexport interface RunSummaryBudget {\n  kind: 'bytes' | 'tool-count'\n  /** Tool name (for `'tool-count'`); absent for byte budgets. */\n  toolName?: string\n  /** `mode` for `'tool-count'`; absent for byte budgets. */\n  mode?: 'steer' | 'block'\n  observed: number\n  limit: number\n  turnId?: string\n}\n\nexport interface RunSummaryRepeatGuard {\n  toolName: string\n  /** Consecutive identical calls including the one that tripped the guard. */\n  count: number\n  threshold: number\n  action: 'block' | 'abort'\n  turnId?: string\n}\n\n/**\n * Postmortem snapshot of one `agent.run()`. Strictly serializable — every\n * field round-trips through `JSON.stringify` / `JSON.parse` without loss\n * so a log aggregator can ingest it as-is.\n */\nexport interface RunSummary {\n  runId?: string\n  parentRunId?: string\n  depth: number\n  agentName?: string\n  startedAt: number\n  endedAt: number\n  durationMs: number\n  status: 'completed' | 'aborted'\n  turns: number\n  totals: RunSummaryTokens\n  byModel: RunSummaryByModel[]\n  errors: RunSummaryError[]\n  blocks: RunSummaryBlock[]\n  validationRejects: RunSummaryValidation[]\n  budgetEvents: RunSummaryBudget[]\n  /**\n   * Consecutive-identical repeat-guard escalations. An `action: 'abort'`\n   * entry means the guard terminated the run via the agent's\n   * `AbortController` (the run finalizes as `'aborted'`).\n   */\n  repeatGuardEvents: RunSummaryRepeatGuard[]\n  /** Counts of pairing repairs, keyed by repair mode. */\n  pairingRepairs: Record<string, number>\n  /**\n   * Postmortem snapshots of child runs that bubbled their stats up via\n   * `spawn:complete`. Only present when the run actually spawned.\n   */\n  children?: RunSummary[]\n}\n\n// ---------------------------------------------------------------------------\n// Collector\n// ---------------------------------------------------------------------------\n\nexport interface RunSummaryCollectorOptions {\n  /**\n   * Called with the assembled {@link RunSummary} on every `agent:done`.\n   * Synchronous — heavy I/O should be deferred (e.g. via `setImmediate`).\n   */\n  onSummary?: (summary: RunSummary) => void\n}\n\nexport interface RunSummaryCollector {\n  /** Install the collector's hook handlers. Returns an uninstall fn. */\n  install: (hooks: Hookable<AgentHooks>) => () => void\n  /** Most-recent summary; `undefined` until the first `agent:done` fires. */\n  latest: () => RunSummary | undefined\n}\n\n/**\n * Build a run-summary collector. State is created fresh inside each\n * `install()` call, so a single collector instance can be installed\n * across multiple agents without attribution cross-talk. `latest()`\n * returns the most-recent summary across **any** install — install\n * per-agent collectors if you need separate post-run snapshots.\n *\n * @example\n * ```ts\n * const collector = createRunSummaryCollector({\n *   onSummary: s => console.log(JSON.stringify(s)),\n * })\n * const uninstall = collector.install(agent.hooks)\n * try { await agent.run({ prompt }) }\n * finally { uninstall() }\n * ```\n */\nexport function createRunSummaryCollector(\n  options: RunSummaryCollectorOptions = {},\n): RunSummaryCollector {\n  let last: RunSummary | undefined\n\n  return {\n    latest: () => last,\n    install(hooks: Hookable<AgentHooks>): () => void {\n      // Per-run in-progress accumulators. The hookable bus serializes\n      // agent.run lifecycles per agent — we reset between runs on\n      // `agent:start` and consume on `agent:done`.\n      let runId: string | undefined\n      let parentRunId: string | undefined\n      let depth = 0\n      let agentName: string | undefined\n      let startedAt = Date.now()\n      let aborted = false\n      const errors: RunSummaryError[] = []\n      const blocks: RunSummaryBlock[] = []\n      const validationRejects: RunSummaryValidation[] = []\n      const budgetEvents: RunSummaryBudget[] = []\n      const repeatGuardEvents: RunSummaryRepeatGuard[] = []\n      const pairingRepairs: Record<string, number> = {}\n      const children: RunSummary[] = []\n\n      function resetForNewRun(): void {\n        aborted = false\n        errors.length = 0\n        blocks.length = 0\n        validationRejects.length = 0\n        budgetEvents.length = 0\n        repeatGuardEvents.length = 0\n        for (const k of Object.keys(pairingRepairs))\n          delete pairingRepairs[k]\n        children.length = 0\n      }\n\n      const unregisters: Array<() => void> = []\n\n      unregisters.push(hooks.hook('agent:start', (ctx) => {\n        resetForNewRun()\n        runId = ctx.runId\n        parentRunId = ctx.parentRunId\n        depth = ctx.depth\n        agentName = ctx.agentName\n        startedAt = ctx.startedAt\n      }))\n\n      unregisters.push(hooks.hook('agent:abort', () => {\n        aborted = true\n      }))\n\n      unregisters.push(hooks.hook('stream:error', (ctx) => {\n        const msg = ctx.err instanceof Error ? ctx.err.message : String(ctx.err)\n        const errorType = ctx.err instanceof Error ? ctx.err.name : 'unknown'\n        errors.push({\n          kind: 'stream',\n          message: msg,\n          errorType,\n          turnId: ctx.turnId,\n          ...(ctx.statusCode !== undefined ? { statusCode: ctx.statusCode } : {}),\n          ...(ctx.requestId !== undefined ? { requestId: ctx.requestId } : {}),\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:error', (ctx) => {\n        errors.push({\n          kind: 'tool',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          turnId: ctx.turnId,\n          callId: ctx.callId,\n          toolName: ctx.name,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:tool:error', (ctx) => {\n        errors.push({\n          kind: 'mcp-tool',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          turnId: ctx.turnId,\n          callId: ctx.callId,\n          server: ctx.server,\n          toolName: ctx.displayName,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:error', (ctx) => {\n        errors.push({\n          kind: 'mcp',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          server: ctx.name,\n        })\n      }))\n\n      unregisters.push(hooks.hook('spawn:error', (ctx) => {\n        errors.push({\n          kind: 'spawn',\n          message: ctx.error.message,\n          errorType: ctx.error.name,\n          childId: ctx.id,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:dispatched', (ctx) => {\n        if (ctx.outcome === 'gate-block' || ctx.outcome === 'unknown' || ctx.outcome === 'invalid-input') {\n          blocks.push({\n            callId: ctx.callId,\n            toolName: ctx.name,\n            outcome: ctx.outcome,\n            ...(ctx.reason ? { reason: ctx.reason } : {}),\n          })\n        }\n      }))\n\n      unregisters.push(hooks.hook('validation:reject', (ctx) => {\n        validationRejects.push({\n          callId: ctx.callId,\n          toolName: ctx.name,\n          reason: ctx.reason,\n        })\n      }))\n\n      unregisters.push(hooks.hook('budget:exceeded', (ctx) => {\n        budgetEvents.push({\n          kind: 'bytes',\n          observed: ctx.bytes,\n          limit: ctx.budget,\n          turnId: ctx.turnId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool-budget:exceeded', (ctx) => {\n        budgetEvents.push({\n          kind: 'tool-count',\n          toolName: ctx.tool,\n          mode: ctx.mode,\n          observed: ctx.count,\n          limit: ctx.max,\n          turnId: ctx.turnId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('repeat-guard:exceeded', (ctx) => {\n        repeatGuardEvents.push({\n          toolName: ctx.tool,\n          count: ctx.count,\n          threshold: ctx.threshold,\n          action: ctx.action,\n          turnId: ctx.turnId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('pairing:repair', (ctx) => {\n        pairingRepairs[ctx.mode] = (pairingRepairs[ctx.mode] ?? 0) + 1\n      }))\n\n      unregisters.push(hooks.hook('agent:done', (stats) => {\n        const endedAt = Date.now()\n\n        // Build per-model rollup via the existing `statsByModel` helper\n        // so we stay in lockstep with how the rest of the harness\n        // attributes cost and tokens by model id.\n        const byModel: RunSummaryByModel[] = []\n        for (const [modelId, usage] of statsByModel(stats)) {\n          byModel.push({\n            modelId,\n            input: usage.input,\n            output: usage.output,\n            cacheRead: usage.cacheRead,\n            cacheCreation: usage.cacheCreation,\n            cost: usage.cost,\n            turns: usage.turns,\n          })\n        }\n\n        // Flatten child stats into nested summaries. We don't have the\n        // child's full event lists here (those landed on the child's\n        // own hooks), so the nested entry is a minimal totals-only\n        // record — enough for a flat per-run audit trail; consumers\n        // wanting full per-child event lists install a collector on\n        // each subagent.\n        for (const c of stats.children ?? []) {\n          children.push(minimalSummaryFromStats(c.stats, {\n            depth: c.depth ?? depth + 1,\n            status: c.status === 'aborted' ? 'aborted' : 'completed',\n          }))\n        }\n\n        const summary: RunSummary = {\n          ...(runId ? { runId } : {}),\n          ...(parentRunId ? { parentRunId } : {}),\n          depth,\n          ...(agentName ? { agentName } : {}),\n          startedAt,\n          endedAt,\n          durationMs: endedAt - startedAt,\n          status: aborted ? 'aborted' : 'completed',\n          turns: stats.turns,\n          totals: buildTotals(stats),\n          byModel,\n          errors: errors.slice(),\n          blocks: blocks.slice(),\n          validationRejects: validationRejects.slice(),\n          budgetEvents: budgetEvents.slice(),\n          repeatGuardEvents: repeatGuardEvents.slice(),\n          pairingRepairs: { ...pairingRepairs },\n          ...(children.length > 0 ? { children: children.slice() } : {}),\n        }\n\n        last = summary\n        try {\n          options.onSummary?.(summary)\n        }\n        catch {\n          // Sink errors are not the collector's concern.\n        }\n      }))\n\n      let disposed = false\n      return function uninstall() {\n        if (disposed)\n          return\n        disposed = true\n        for (const un of unregisters) {\n          try {\n            un()\n          }\n          catch { /* ignore */ }\n        }\n      }\n    },\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction buildTotals(stats: AgentStats): RunSummaryTokens {\n  return {\n    input: stats.totalIn,\n    output: stats.totalOut,\n    cacheRead: stats.totalCacheRead,\n    cacheCreation: stats.totalCacheCreation,\n    ...(typeof stats.cost === 'number' ? { cost: stats.cost } : {}),\n    ...(typeof stats.timeTillFirstTokenMs === 'number' ? { ttftMs: stats.timeTillFirstTokenMs } : {}),\n  }\n}\n\nfunction minimalSummaryFromStats(\n  stats: AgentStats,\n  meta: { depth: number, status: 'completed' | 'aborted' },\n): RunSummary {\n  const byModel: RunSummaryByModel[] = []\n  for (const [modelId, usage] of statsByModel(stats)) {\n    byModel.push({\n      modelId,\n      input: usage.input,\n      output: usage.output,\n      cacheRead: usage.cacheRead,\n      cacheCreation: usage.cacheCreation,\n      cost: usage.cost,\n      turns: usage.turns,\n    })\n  }\n  const children: RunSummary[] = []\n  for (const c of stats.children ?? []) {\n    children.push(minimalSummaryFromStats(c.stats, {\n      depth: c.depth ?? meta.depth + 1,\n      status: c.status === 'aborted' ? 'aborted' : 'completed',\n    }))\n  }\n  return {\n    depth: meta.depth,\n    startedAt: 0,\n    endedAt: 0,\n    durationMs: stats.elapsed,\n    status: meta.status,\n    turns: stats.turns,\n    totals: buildTotals(stats),\n    byModel,\n    errors: [],\n    blocks: [],\n    validationRejects: [],\n    budgetEvents: [],\n    repeatGuardEvents: [],\n    pairingRepairs: {},\n    ...(children.length > 0 ? { children } : {}),\n  }\n}\n","/**\n * Headless mode — a non-interactive, fully-structured way to drive the agent\n * for automation and RL rollouts.\n *\n * `agent.run()` already returns rich {@link AgentStats}, the session captures a\n * lossless transcript (`session.turns`), and the hook bus exposes every\n * streaming/tool/turn event. What this module adds is the *contract* an RL loop\n * needs: one call (`runHeadless`) that runs a prompt to completion in a chosen\n * workdir, bounded by turns + wall-clock, and hands back a single serializable\n * {@link HeadlessResult} — final answer, verifiable structured output, usage,\n * and the complete trajectory — plus an optional live {@link HeadlessEvent}\n * stream (the in-process equivalent of `--output-format stream-json`).\n *\n * It is provider-agnostic: the caller passes a built {@link Provider} (e.g.\n * `local()` pointed at a vLLM server, or any of the named providers). The thin\n * CLI in `src/headless-cli.ts` wraps this with arg parsing, file/stdin I/O, and\n * JSONL transcript writing.\n */\n\nimport type { Hookable } from 'hookable'\nimport type { AgentHooks, AgentOptions } from './agent'\nimport type { ExecutionContext } from './contexts'\nimport type { Provider } from './providers'\nimport type { RunSummary } from './run-summary'\nimport type { Session, SessionStore } from './session'\nimport type { PairingRepair } from './session/messages'\nimport type { ToolDef } from './tools'\nimport type {\n  AgentStats,\n  McpServerConfig,\n  PromptPart,\n  SessionContentBlock,\n  SessionTurn,\n  ThinkingLevel,\n  ToolResultContent,\n  ToolResultDocumentContent,\n  TurnFinishReason,\n} from './types'\nimport { createAgent } from './agent'\nimport { createProcessContext } from './contexts'\nimport { basic } from './presets'\nimport { createRunSummaryCollector } from './run-summary'\nimport { createMemoryStore, createSession, toAnthropic } from './session'\nimport { ensureToolResultPairing } from './session/messages'\nimport { documentBlockMarker, toolResultToText } from './types'\n\n// ---------------------------------------------------------------------------\n// Public shapes\n// ---------------------------------------------------------------------------\n\nexport type HeadlessStatus = 'completed' | 'aborted' | 'error' | 'timeout'\n\nexport interface HeadlessUsage {\n  input: number\n  output: number\n  cacheRead: number\n  cacheCreation: number\n  /** Cumulative USD cost when the provider/registry could price the run. */\n  cost?: number\n}\n\nexport interface HeadlessErrorInfo {\n  message: string\n  /** Typed-error class name (`AgentAbortedError`, `AgentContextExceededError`, …). */\n  type: string\n}\n\n/**\n * Strictly JSON-serializable postmortem of one headless run. Everything an RL\n * reward function needs: the final answer (`finalText`), the verifiable\n * structured output (`output`, present iff a `schema` was set), usage/turns,\n * and the lossless `transcript` (the SFT training data).\n */\nexport interface HeadlessResult {\n  status: HeadlessStatus\n  /** Concatenated text of the last assistant turn that produced any text. */\n  finalText: string\n  /** Schema-enforced structured output (only when `opts.schema` is set). */\n  output?: Record<string, unknown>\n  usage: HeadlessUsage\n  turns: number\n  durationMs: number\n  /** Total `tool_call` blocks across the whole transcript. */\n  numToolCalls: number\n  /** Finish reason of the final turn that reported one. */\n  finishReason?: TurnFinishReason\n  error?: HeadlessErrorInfo\n  sessionId: string\n  /** Incident postmortem (errors, gate blocks, budget events) via run-summary. */\n  summary?: RunSummary\n  /** Lossless transcript — raw `session.turns`. Thinking stripped when `includeThinking: false`. */\n  transcript: SessionTurn[]\n}\n\nexport type HeadlessOutputFormat = 'zidane' | 'provider'\n\nexport type ProviderTranscriptFormat = 'anthropic' | 'openai'\n\nexport type FormattedHeadlessResult\n  = | HeadlessResult\n    | unknown[]\n\nexport type FormattedHeadlessTurnEvent\n  = | Extract<HeadlessEvent, { type: 'turn' }>\n    | unknown[]\n\nexport function exitCodeForHeadlessResult(result: HeadlessResult): number {\n  switch (result.status) {\n    case 'completed': return 0\n    case 'timeout': return 124\n    case 'aborted': return 130\n    case 'error':\n    default: return 1\n  }\n}\n\n/**\n * Live event union — the in-process equivalent of a `stream-json` line. Every\n * member is JSON-serializable; render to JSONL with {@link headlessEventToJsonl}.\n */\nexport type HeadlessEvent\n  = | { type: 'start', runId: string, provider?: string }\n    | { type: 'text', delta: string }\n    | { type: 'thinking', delta: string }\n    | { type: 'tool_call', callId: string, name: string, input: Record<string, unknown> }\n    | { type: 'tool_result', callId: string, name: string, output: string, isError: boolean }\n    | { type: 'turn', index: number, turn: SessionTurn }\n    | { type: 'spawn', event: 'before' | 'complete' | 'error', id: string, info?: Record<string, unknown> }\n    | { type: 'error', message: string, errorType?: string }\n    | { type: 'result', result: HeadlessResult }\n\n/** Serialize one event as a newline-terminated JSON line (stream-json). */\nexport function headlessEventToJsonl(event: HeadlessEvent): string {\n  return `${JSON.stringify(event)}\\n`\n}\n\nexport function formattedHeadlessTurnEventToJsonl(event: FormattedHeadlessTurnEvent): string {\n  return `${JSON.stringify(event)}\\n`\n}\n\nexport function providerTranscriptFormatForProvider(providerName: string): ProviderTranscriptFormat {\n  return providerName === 'anthropic' ? 'anthropic' : 'openai'\n}\n\nexport function transcriptToProviderMessages(\n  turns: SessionTurn[],\n  providerName: string,\n): unknown[] {\n  const format = providerTranscriptFormatForProvider(providerName)\n  if (format === 'anthropic') {\n    return turns\n      .filter((turn): turn is SessionTurn & { role: 'user' | 'assistant' } => turn.role === 'user' || turn.role === 'assistant')\n      .map(turn => toAnthropic({ role: turn.role, content: turn.content }))\n  }\n  return transcriptToOpenAIMessages(turns, { strictToolPairing: false })\n}\n\nexport function formatHeadlessResult(\n  result: HeadlessResult,\n  options: { format: HeadlessOutputFormat, providerName: string },\n): FormattedHeadlessResult {\n  if (options.format === 'zidane')\n    return result\n  return transcriptToProviderMessages(result.transcript, options.providerName)\n}\n\nexport function formatHeadlessTurnEvent(\n  event: Extract<HeadlessEvent, { type: 'turn' }>,\n  options: { format: HeadlessOutputFormat, providerName: string },\n): FormattedHeadlessTurnEvent {\n  if (options.format === 'zidane')\n    return event\n  return transcriptToProviderMessages([event.turn], options.providerName)\n}\n\nexport interface HeadlessOptions {\n  /** User prompt — plain string or multimodal `PromptPart[]`. */\n  prompt: string | PromptPart[]\n  /** Built provider (e.g. `local()`, `openaiCompat(...)`, `anthropic(...)`). */\n  provider: Provider\n  model?: string\n  /** Override the preset system prompt for this run. */\n  system?: string\n  thinking?: ThinkingLevel\n  maxTurns?: number\n  maxTokens?: number\n  /** Wall-clock cap; on expiry the run is aborted and `status` becomes `'timeout'`. */\n  timeoutMs?: number\n  /** External abort signal — chained with the internal timeout controller. */\n  signal?: AbortSignal\n  /** JSON Schema for structured-output enforcement → populates `result.output`. */\n  schema?: Record<string, unknown>\n  /** Agent behavior defaults for this headless run. Top-level shortcuts below override matching fields. */\n  behavior?: AgentOptions['behavior']\n  /** Tool overrides. Omit to use the basic preset's tools. */\n  tools?: Record<string, ToolDef>\n  mcpServers?: McpServerConfig[]\n  skills?: AgentOptions['skills']\n  /** Execution context. Defaults to a process context rooted at `cwd`. */\n  execution?: ExecutionContext\n  /** Working directory for the default process context (ignored if `execution` is set). */\n  cwd?: string\n  /** Reuse / resume an existing session. */\n  session?: Session\n  /** Session store for a fresh session (defaults to an in-memory store). */\n  store?: SessionStore\n  /** Keep `thinking` blocks in `result.transcript` (default true). */\n  includeThinking?: boolean\n  /** Live event callback — the in-process stream-json equivalent. */\n  onEvent?: (event: HeadlessEvent) => void\n}\n\n// ---------------------------------------------------------------------------\n// runHeadless\n// ---------------------------------------------------------------------------\n\n/**\n * Run a prompt to completion, headless, and return a single serializable\n * {@link HeadlessResult}. Safe to call concurrently for parallel rollouts —\n * each call builds its own agent + session and tears them down in `finally`.\n */\nexport async function runHeadless(opts: HeadlessOptions): Promise<HeadlessResult> {\n  const startedAt = Date.now()\n  const execution = opts.execution ?? createProcessContext({ cwd: opts.cwd })\n  const session = opts.session ?? await createSession({ store: opts.store ?? createMemoryStore() })\n\n  const behavior: NonNullable<AgentOptions['behavior']> = { ...(opts.behavior ?? {}) }\n  if (opts.maxTurns !== undefined)\n    behavior.maxTurns = opts.maxTurns\n  if (opts.maxTokens !== undefined)\n    behavior.maxTokens = opts.maxTokens\n  if (opts.schema !== undefined)\n    behavior.schema = opts.schema\n\n  const agent = createAgent({\n    ...basic,\n    provider: opts.provider,\n    execution,\n    session,\n    behavior,\n    ...(opts.tools !== undefined ? { tools: opts.tools } : {}),\n    ...(opts.mcpServers !== undefined ? { mcpServers: opts.mcpServers } : {}),\n    ...(opts.skills !== undefined ? { skills: opts.skills } : {}),\n  })\n\n  const collector = createRunSummaryCollector()\n  const uninstallSummary = collector.install(agent.hooks)\n  const uninstallEvents = opts.onEvent ? installHeadlessEventAdapter(agent.hooks, opts.onEvent) : noop\n\n  // Resumed sessions carry turns from prior runs — remember where this run\n  // starts so transcript/finalText/numToolCalls stay per-run, matching the\n  // per-run usage/turns/durationMs stats.\n  const runStartIndex = session.turns.length\n\n  // Internal controller drives the wall-clock timeout and chains any external\n  // signal so a host cancel and a timeout both abort the same run. The\n  // listener is removed in `finally` — a long-lived host signal must not\n  // accumulate one listener per rollout.\n  const controller = new AbortController()\n  const onExternalAbort = (): void => controller.abort(opts.signal!.reason)\n  if (opts.signal) {\n    if (opts.signal.aborted)\n      controller.abort(opts.signal.reason)\n    else\n      opts.signal.addEventListener('abort', onExternalAbort, { once: true })\n  }\n  let timedOut = false\n  const timer = opts.timeoutMs && opts.timeoutMs > 0\n    ? setTimeout(() => {\n        timedOut = true\n        controller.abort(new Error(`Headless run timed out after ${opts.timeoutMs}ms`))\n      }, opts.timeoutMs)\n    : undefined\n\n  let stats: AgentStats | undefined\n  let error: HeadlessErrorInfo | undefined\n\n  try {\n    stats = await agent.run({\n      prompt: opts.prompt,\n      signal: controller.signal,\n      ...(opts.model !== undefined ? { model: opts.model } : {}),\n      ...(opts.system !== undefined ? { system: opts.system } : {}),\n      ...(opts.thinking !== undefined ? { thinking: opts.thinking } : {}),\n    })\n  }\n  catch (err) {\n    // The agent loop throws typed errors (AgentAbortedError,\n    // AgentContextExceededError, AgentProviderError, …) — their `name` already\n    // classifies the failure, so surface it directly.\n    const e = err instanceof Error ? err : new Error(String(err))\n    error = { message: e.message, type: e.name }\n  }\n  finally {\n    if (timer)\n      clearTimeout(timer)\n    opts.signal?.removeEventListener('abort', onExternalAbort)\n    uninstallEvents()\n    uninstallSummary()\n    await agent.destroy()\n  }\n\n  // Status: a thrown error wins, but an abort/timeout can also surface as a\n  // clean resolve (the loop returns partial stats), so check the signal too.\n  let status: HeadlessStatus\n  if (error)\n    status = timedOut ? 'timeout' : controller.signal.aborted ? 'aborted' : 'error'\n  else if (controller.signal.aborted)\n    status = timedOut ? 'timeout' : 'aborted'\n  else\n    status = 'completed'\n\n  const rawTranscript = session.turns.slice(runStartIndex)\n  const transcript = opts.includeThinking === false ? stripThinking(rawTranscript) : rawTranscript\n  const summary = collector.latest()\n\n  const result: HeadlessResult = {\n    status,\n    finalText: extractFinalText(rawTranscript),\n    ...(stats?.output ? { output: stats.output } : {}),\n    usage: {\n      input: stats?.totalIn ?? 0,\n      output: stats?.totalOut ?? 0,\n      cacheRead: stats?.totalCacheRead ?? 0,\n      cacheCreation: stats?.totalCacheCreation ?? 0,\n      ...(typeof stats?.cost === 'number' ? { cost: stats.cost } : {}),\n    },\n    turns: stats?.turns ?? 0,\n    durationMs: stats?.elapsed ?? (Date.now() - startedAt),\n    numToolCalls: countToolCalls(rawTranscript),\n    // Suppress `finishReason` on abort/timeout: the last persisted turn can\n    // carry `finishReason: 'stop'` (e.g. the model finished a turn, a follow-up\n    // continued, then the run was cancelled), which would make a consumer\n    // keyed on `finishReason === 'stop'` misread a cancel as \"model finished\".\n    // `status` is authoritative for those exits; let it speak alone. The\n    // `'pause'` exhaustion exit keeps `status: 'completed'` so it still\n    // surfaces its `finishReason: 'pause'` here.\n    ...(status !== 'aborted' && status !== 'timeout' && lastFinishReason(stats)\n      ? { finishReason: lastFinishReason(stats) }\n      : {}),\n    ...(error ? { error } : {}),\n    sessionId: session.id,\n    ...(summary ? { summary } : {}),\n    transcript,\n  }\n\n  opts.onEvent?.({ type: 'result', result })\n  return result\n}\n\n// ---------------------------------------------------------------------------\n// Transcript → OpenAI chat messages (SFT-ready)\n// ---------------------------------------------------------------------------\n\nexport interface OpenAIChatMessage {\n  role: 'system' | 'user' | 'assistant' | 'tool'\n  content: string | null | OpenAIChatContentPart[]\n  tool_calls?: Array<{ id: string, type: 'function', function: { name: string, arguments: string } }>\n  tool_call_id?: string\n}\n\nexport type OpenAIChatContentPart\n  = | { type: 'text', text: string }\n    | { type: 'image_url', image_url: { url: string } }\n\n/**\n * Convert raw `session.turns` into standard OpenAI chat-completion messages:\n * assistant turns carry `tool_calls`, and each `tool_result` becomes its own\n * `role: 'tool'` message. This is the drop-in shape for an SFT renderer —\n * unlike `toOpenAI` (session/messages.ts), which emits an internal `_tag`\n * envelope meant for re-sending to a provider, not for training data.\n *\n * Fails closed on corrupt raw turns instead of fabricating tool results; silent\n * placeholders would create structurally-valid but semantically-poisoned SFT\n * examples.\n */\nexport function transcriptToOpenAIMessages(\n  turns: SessionTurn[],\n  options: { strictToolPairing?: boolean } = {},\n): OpenAIChatMessage[] {\n  const { strictToolPairing = true } = options\n  const messages: OpenAIChatMessage[] = []\n  let chunk: Array<{ role: 'user' | 'assistant', content: SessionContentBlock[] }> = []\n  const flushChunk = () => {\n    if (chunk.length === 0)\n      return\n    let paired = chunk\n    if (strictToolPairing) {\n      const repairs: PairingRepair[] = []\n      paired = ensureToolResultPairing(chunk, { onRepair: repair => repairs.push(repair) })\n      if (repairs.length > 0) {\n        throw new Error(\n          `Cannot convert transcript to OpenAI messages: tool pairing repair required (${repairs.map(r => r.mode).join(', ')})`,\n        )\n      }\n    }\n    for (const msg of paired)\n      pushOpenAIChatMessage(messages, msg)\n    chunk = []\n  }\n\n  for (const turn of turns) {\n    if (turn.role === 'system') {\n      flushChunk()\n      messages.push({ role: 'system', content: textOf(turn.content) })\n      continue\n    }\n    chunk.push({ role: turn.role, content: turn.content })\n  }\n  flushChunk()\n\n  return messages\n}\n\nfunction pushOpenAIChatMessage(messages: OpenAIChatMessage[], msg: { role: 'user' | 'assistant', content: SessionContentBlock[] }): void {\n  const text = textOf(msg.content)\n\n  if (msg.role === 'assistant') {\n    const toolCalls = msg.content.filter((b): b is ToolCallBlock => b.type === 'tool_call')\n    const out: OpenAIChatMessage = { role: 'assistant', content: text || null }\n    if (toolCalls.length > 0) {\n      out.tool_calls = toolCalls.map(b => ({\n        id: b.id,\n        type: 'function' as const,\n        function: { name: b.name, arguments: JSON.stringify(b.input) },\n      }))\n    }\n    messages.push(out)\n    return\n  }\n\n  // user turn — may carry prompt text/images and/or tool_result blocks\n  const userParts = contentPartsFromBlocks(msg.content)\n  if (userParts.length > 0)\n    messages.push({ role: 'user', content: simplifyOpenAIContent(userParts) })\n\n  for (const tr of msg.content.filter((b): b is ToolResultBlock => b.type === 'tool_result')) {\n    const { text, images } = summarizeToolResultForOpenAI(tr.output)\n    if (images.length === 0) {\n      messages.push({ role: 'tool', tool_call_id: tr.callId, content: text })\n      continue\n    }\n\n    const noun = images.length === 1 ? 'image' : 'images'\n    const marker = `[${images.length} ${noun} attached — see next user message]`\n    messages.push({\n      role: 'tool',\n      tool_call_id: tr.callId,\n      content: text.length > 0 ? `${text}\\n\\n${marker}` : marker,\n    })\n    messages.push({\n      role: 'user',\n      content: [\n        ...images.map(toOpenAIImagePart),\n        { type: 'text', text: `(${noun} returned by tool call ${tr.callId})` },\n      ],\n    })\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internals\n// ---------------------------------------------------------------------------\n\ntype TextBlock = Extract<SessionContentBlock, { type: 'text' }>\ntype ToolCallBlock = Extract<SessionContentBlock, { type: 'tool_call' }>\ntype ToolResultBlock = Extract<SessionContentBlock, { type: 'tool_result' }>\n\nfunction noop(): void {}\n\nfunction textOf(content: SessionContentBlock[]): string {\n  return content.filter((b): b is TextBlock => b.type === 'text').map(b => b.text).join('')\n}\n\nfunction contentPartsFromBlocks(content: SessionContentBlock[]): OpenAIChatContentPart[] {\n  const parts: OpenAIChatContentPart[] = []\n  for (const block of content) {\n    if (block.type === 'image')\n      parts.push(toOpenAIImagePart(block))\n    else if (block.type === 'document')\n      parts.push({ type: 'text', text: documentMarker(block) })\n    else if (block.type === 'text' && block.text.length > 0)\n      parts.push({ type: 'text', text: block.text })\n  }\n  return parts\n}\n\nfunction simplifyOpenAIContent(parts: OpenAIChatContentPart[]): string | OpenAIChatContentPart[] {\n  if (parts.length === 1 && parts[0].type === 'text')\n    return parts[0].text\n  return parts\n}\n\nfunction toOpenAIImagePart(image: { mediaType: string, data: string }): OpenAIChatContentPart {\n  return {\n    type: 'image_url',\n    image_url: { url: `data:${image.mediaType};base64,${image.data}` },\n  }\n}\n\nfunction summarizeToolResultForOpenAI(output: string | ToolResultContent[]): {\n  text: string\n  images: Array<{ mediaType: string, data: string }>\n} {\n  if (typeof output === 'string')\n    return { text: output, images: [] }\n\n  const texts: string[] = []\n  const images: Array<{ mediaType: string, data: string }> = []\n  for (const block of output) {\n    if (block.type === 'text') {\n      texts.push(block.text)\n    }\n    else if (block.type === 'image') {\n      images.push({ mediaType: block.mediaType, data: block.data })\n    }\n    else {\n      texts.push(documentMarker(block))\n    }\n  }\n  return { text: texts.join('\\n'), images }\n}\n\nfunction documentMarker(doc: ToolResultDocumentContent): string {\n  return documentBlockMarker(doc, 'document omitted')\n}\n\nfunction extractFinalText(turns: SessionTurn[]): string {\n  for (let i = turns.length - 1; i >= 0; i--) {\n    const turn = turns[i]\n    if (turn.role !== 'assistant')\n      continue\n    const text = textOf(turn.content)\n    if (text)\n      return text\n  }\n  return ''\n}\n\nfunction countToolCalls(turns: SessionTurn[]): number {\n  let n = 0\n  for (const turn of turns) {\n    for (const block of turn.content) {\n      if (block.type === 'tool_call')\n        n++\n    }\n  }\n  return n\n}\n\nfunction lastFinishReason(stats?: AgentStats): TurnFinishReason | undefined {\n  const usages = stats?.turnUsage\n  if (!usages)\n    return undefined\n  for (let i = usages.length - 1; i >= 0; i--) {\n    if (usages[i].finishReason)\n      return usages[i].finishReason\n  }\n  return undefined\n}\n\nfunction stripThinking(turns: SessionTurn[]): SessionTurn[] {\n  return turns.map(turn => ({\n    ...turn,\n    content: turn.content.filter(b => b.type !== 'thinking' && b.type !== 'redacted_thinking'),\n  }))\n}\n\nexport function installHeadlessEventAdapter(\n  hooks: Hookable<AgentHooks>,\n  onEvent: (event: HeadlessEvent) => void,\n): () => void {\n  const unregs: Array<() => void> = []\n  const emittedTurnIds = new Set<string>()\n  const emit = (event: HeadlessEvent): void => {\n    try {\n      onEvent(event)\n    }\n    catch {\n      // A consumer's sink throwing is not the adapter's concern.\n    }\n  }\n\n  unregs.push(hooks.hook('agent:start', ctx => emit({\n    type: 'start',\n    runId: ctx.runId,\n    ...(ctx.providerName ? { provider: ctx.providerName } : {}),\n  })))\n  unregs.push(hooks.hook('stream:text', ctx => emit({ type: 'text', delta: ctx.delta })))\n  unregs.push(hooks.hook('stream:thinking', ctx => emit({ type: 'thinking', delta: ctx.delta })))\n  unregs.push(hooks.hook('tool:before', ctx => emit({\n    type: 'tool_call',\n    callId: ctx.callId,\n    name: ctx.name,\n    input: ctx.input,\n  })))\n  unregs.push(hooks.hook('tool:after', ctx => emit({\n    type: 'tool_result',\n    callId: ctx.callId,\n    name: ctx.name,\n    output: toolResultToText(ctx.result),\n    isError: false,\n  })))\n  unregs.push(hooks.hook('tool:error', ctx => emit({\n    type: 'tool_result',\n    callId: ctx.callId,\n    name: ctx.name,\n    output: ctx.error.message,\n    isError: true,\n  })))\n  unregs.push(hooks.hook('session:turns', (ctx) => {\n    const startIndex = ctx.count - ctx.turns.length\n    ctx.turns.forEach((turn, i) => {\n      if (emittedTurnIds.has(turn.id))\n        return\n      emittedTurnIds.add(turn.id)\n      emit({ type: 'turn', index: startIndex + i, turn })\n    })\n  }))\n  unregs.push(hooks.hook('spawn:before', ctx => emit({ type: 'spawn', event: 'before', id: ctx.id })))\n  unregs.push(hooks.hook('spawn:complete', ctx => emit({\n    type: 'spawn',\n    event: 'complete',\n    id: ctx.id,\n    info: { status: ctx.status ?? 'completed' },\n  })))\n  unregs.push(hooks.hook('spawn:error', ctx => emit({\n    type: 'spawn',\n    event: 'error',\n    id: ctx.id,\n    info: { message: ctx.error.message },\n  })))\n  unregs.push(hooks.hook('stream:error', ctx => emit({\n    type: 'error',\n    message: ctx.err instanceof Error ? ctx.err.message : String(ctx.err),\n    ...(ctx.err instanceof Error ? { errorType: ctx.err.name } : {}),\n  })))\n\n  return () => {\n    for (const un of unregs) {\n      try {\n        un()\n      }\n      catch {\n        // ignore\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/headless.d.ts

@@ -1,2 +1,2 @@
-import { $n as installHeadlessEventAdapter, Bn as HeadlessOptions, Gn as OpenAIChatContentPart, Hn as HeadlessResult, In as FormattedHeadlessResult, Jn as exitCodeForHeadlessResult, Kn as OpenAIChatMessage, Ln as FormattedHeadlessTurnEvent, Qn as headlessEventToJsonl, Rn as HeadlessErrorInfo, Un as HeadlessStatus, Vn as HeadlessOutputFormat, Wn as HeadlessUsage, Xn as formatHeadlessTurnEvent, Yn as formatHeadlessResult, Zn as formattedHeadlessTurnEventToJsonl, er as providerTranscriptFormatForProvider, nr as transcriptToOpenAIMessages, qn as ProviderTranscriptFormat, rr as transcriptToProviderMessages, tr as runHeadless, zn as HeadlessEvent } from "./index-C4aT2kO_.js";
+import { An as HeadlessOutputFormat, Bn as formattedHeadlessTurnEventToJsonl, Dn as HeadlessErrorInfo, En as FormattedHeadlessTurnEvent, Fn as OpenAIChatMessage, Gn as transcriptToOpenAIMessages, Hn as installHeadlessEventAdapter, In as ProviderTranscriptFormat, Kn as transcriptToProviderMessages, Ln as exitCodeForHeadlessResult, Mn as HeadlessStatus, Nn as HeadlessUsage, On as HeadlessEvent, Pn as OpenAIChatContentPart, Rn as formatHeadlessResult, Tn as FormattedHeadlessResult, Un as providerTranscriptFormatForProvider, Vn as headlessEventToJsonl, Wn as runHeadless, jn as HeadlessResult, kn as HeadlessOptions, zn as formatHeadlessTurnEvent } from "./index-DZR99FD4.js";
 export { FormattedHeadlessResult, FormattedHeadlessTurnEvent, HeadlessErrorInfo, HeadlessEvent, HeadlessOptions, HeadlessOutputFormat, HeadlessResult, HeadlessStatus, HeadlessUsage, OpenAIChatContentPart, OpenAIChatMessage, ProviderTranscriptFormat, exitCodeForHeadlessResult, formatHeadlessResult, formatHeadlessTurnEvent, formattedHeadlessTurnEventToJsonl, headlessEventToJsonl, installHeadlessEventAdapter, providerTranscriptFormatForProvider, runHeadless, transcriptToOpenAIMessages, transcriptToProviderMessages };

package/dist/headless.js

@@ -1,2 +1,2 @@
-import { a as headlessEventToJsonl, c as runHeadless, i as formattedHeadlessTurnEventToJsonl, l as transcriptToOpenAIMessages, n as formatHeadlessResult, o as installHeadlessEventAdapter, r as formatHeadlessTurnEvent, s as providerTranscriptFormatForProvider, t as exitCodeForHeadlessResult, u as transcriptToProviderMessages } from "./headless-CPaunZsU.js";
+import { a as headlessEventToJsonl, c as runHeadless, i as formattedHeadlessTurnEventToJsonl, l as transcriptToOpenAIMessages, n as formatHeadlessResult, o as installHeadlessEventAdapter, r as formatHeadlessTurnEvent, s as providerTranscriptFormatForProvider, t as exitCodeForHeadlessResult, u as transcriptToProviderMessages } from "./headless-Bb5gU8AR.js";
 export { exitCodeForHeadlessResult, formatHeadlessResult, formatHeadlessTurnEvent, formattedHeadlessTurnEventToJsonl, headlessEventToJsonl, installHeadlessEventAdapter, providerTranscriptFormatForProvider, runHeadless, transcriptToOpenAIMessages, transcriptToProviderMessages };

package/dist/{index-C_t8tW_X.d.ts → index-CrMb8jCE.d.ts}

@@ -1,4 +1,4 @@
-import { l as SpawnConfig, o as ExecResult, s as ExecutionContext } from "./types-BibzMDjX.js";
+import { c as ExecutionContext, s as ExecResult, u as SpawnConfig } from "./types-B39tBba1.js";
 
 //#region src/contexts/process.d.ts
 declare function createProcessContext(config?: SpawnConfig): ExecutionContext;
@@ -23,4 +23,4 @@ interface SandboxProvider {
 declare function createSandboxContext(provider: SandboxProvider): ExecutionContext;
 //#endregion
 export { createSandboxContext as n, createProcessContext as r, SandboxProvider as t };
-//# sourceMappingURL=index-C_t8tW_X.d.ts.map
+//# sourceMappingURL=index-CrMb8jCE.d.ts.map

package/dist/{index-C_t8tW_X.d.ts.map → index-CrMb8jCE.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-C_t8tW_X.d.ts","names":[],"sources":["../src/contexts/process.ts","../src/contexts/sandbox.ts"],"mappings":";;;iBAgGgB,oBAAA,CAAqB,MAAA,GAAS,WAAA,GAAc,gBAAgB;;;UCnF3D,eAAA;EACf,IAAA;EACA,KAAA,GAAQ,MAAA,EAAQ,WAAA,KAAgB,OAAA;IAAU,EAAA;IAAY,GAAA;EAAA;EACtD,IAAA,GAAO,SAAA,UAAmB,OAAA,UAAiB,OAAA;IAAY,GAAA;IAAc,GAAA,GAAM,MAAA;IAAwB,OAAA;EAAA,MAAuB,OAAA,CAAQ,UAAA;EAClI,QAAA,GAAW,SAAA,UAAmB,IAAA,aAAiB,OAAA;EAC/C,SAAA,GAAY,SAAA,UAAmB,IAAA,UAAc,OAAA,aAAoB,OAAA;EACjE,SAAA,GAAY,SAAA,UAAmB,IAAA,aAAiB,OAAA;EAChD,OAAA,GAAU,SAAA,aAAsB,OAAA;AAAA;AAAA,iBAOlB,oBAAA,CAAqB,QAAA,EAAU,eAAA,GAAkB,gBAAgB"}
+{"version":3,"file":"index-CrMb8jCE.d.ts","names":[],"sources":["../src/contexts/process.ts","../src/contexts/sandbox.ts"],"mappings":";;;iBA0GgB,oBAAA,CAAqB,MAAA,GAAS,WAAA,GAAc,gBAAgB;;;UC7F3D,eAAA;EACf,IAAA;EACA,KAAA,GAAQ,MAAA,EAAQ,WAAA,KAAgB,OAAA;IAAU,EAAA;IAAY,GAAA;EAAA;EACtD,IAAA,GAAO,SAAA,UAAmB,OAAA,UAAiB,OAAA;IAAY,GAAA;IAAc,GAAA,GAAM,MAAA;IAAwB,OAAA;EAAA,MAAuB,OAAA,CAAQ,UAAA;EAClI,QAAA,GAAW,SAAA,UAAmB,IAAA,aAAiB,OAAA;EAC/C,SAAA,GAAY,SAAA,UAAmB,IAAA,UAAc,OAAA,aAAoB,OAAA;EACjE,SAAA,GAAY,SAAA,UAAmB,IAAA,aAAiB,OAAA;EAChD,OAAA,GAAU,SAAA,aAAsB,OAAA;AAAA;AAAA,iBAOlB,oBAAA,CAAqB,QAAA,EAAU,eAAA,GAAkB,gBAAgB"}

package/dist/{index-BIo67xLV.d.ts → index-D60tX5XC.d.ts}

@@ -1,5 +1,5 @@
-import { M as SkillsConfig, O as SkillConfig, j as SkillSource, k as SkillDiagnostic, l as SkillActivationState, r as AgentHooks } from "./agent-BHkvYIH9.js";
-import { c as ExecutionHandle, s as ExecutionContext } from "./types-BibzMDjX.js";
+import { A as SkillDiagnostic, M as SkillSource, N as SkillsConfig, k as SkillConfig, l as SkillActivationState, r as AgentHooks } from "./agent-D0W9yClt.js";
+import { c as ExecutionContext, l as ExecutionHandle } from "./types-B39tBba1.js";
 import { Hookable } from "hookable";
 
 //#region src/skills/allowed-tools.d.ts
@@ -120,6 +120,13 @@ interface InterpolateShellCommandsOptions {
    * proceeding on partial content.
    */
   onFailure?: (command: string, placeholder: string) => void;
+  /**
+   * Optional per-command approval gate, invoked BEFORE each !\`command\` runs.
+   * Return `false` to skip executing that command — it is replaced with a
+   * `[shell interpolation not approved]` placeholder instead of its output.
+   * When omitted, every command runs (back-compat).
+   */
+  approve?: (command: string) => boolean | Promise<boolean>;
 }
 /**
  * Interpolate shell commands in skill instructions.
@@ -306,4 +313,4 @@ declare function defineSkill(config: Omit<SkillConfig, 'source'> & {
 }): SkillConfig;
 //#endregion
 export { buildCatalog as C, parseSkillFile as S, installAllowedToolsGate as T, SourcedScanPath as _, SkillValidationResult as a, inferSource as b, parseAllowedToolPattern as c, validateSkillForWrite as d, validateSkillName as f, stripShellInterpolations as g, interpolateShellCommands as h, SkillValidationIssue as i, validateResourcePath as l, InterpolateShellCommandsOptions as m, writeSkillToDisk as n, isToolAllowedByUnion as o, resolveSkills as p, writeSkillsToDisk as r, matchesAllowedTool as s, defineSkill as t, validateResourcePathReal as u, discoverSkills as v, IMPLICITLY_ALLOWED_SKILL_TOOLS as w, parseFrontmatter as x, getDefaultScanPaths as y };
-//# sourceMappingURL=index-BIo67xLV.d.ts.map
+//# sourceMappingURL=index-D60tX5XC.d.ts.map

package/dist/index-D60tX5XC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-D60tX5XC.d.ts","names":[],"sources":["../src/skills/allowed-tools.ts","../src/skills/catalog.ts","../src/skills/discovery.ts","../src/skills/interpolate.ts","../src/skills/resolve.ts","../src/skills/validate.ts","../src/skills/writer.ts","../src/skills/index.ts"],"mappings":"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"}

package/dist/{index-C4aT2kO_.d.ts → index-DZR99FD4.d.ts}

@@ -1,5 +1,5 @@
-import { $t as AgentStats, L as SessionStore, Mn as TurnFinishReason, Nn as TurnUsage, O as SkillConfig, On as ToolResultContent, P as Session, an as McpServerConfig, b as ToolDef, dn as PromptPart, en as ChildRunStats, ft as Provider, ht as StreamOptions, i as AgentOptions, l as SkillActivationState, r as AgentHooks, s as ActiveSkill, wn as ThinkingLevel, xn as SessionTurn, y as ToolContext } from "./agent-BHkvYIH9.js";
-import { c as ExecutionHandle, s as ExecutionContext } from "./types-BibzMDjX.js";
+import { An as ToolResultContent, Cn as SessionTurn, En as ThinkingLevel, F as Session, Fn as TurnUsage, O as ShellInterpolationApproval, Pn as TurnFinishReason, R as SessionStore, _t as StreamOptions, b as ToolDef, i as AgentOptions, k as SkillConfig, l as SkillActivationState, mt as Provider, nn as ChildRunStats, pn as PromptPart, r as AgentHooks, s as ActiveSkill, sn as McpServerConfig, tn as AgentStats, y as ToolContext } from "./agent-D0W9yClt.js";
+import { c as ExecutionContext, l as ExecutionHandle } from "./types-B39tBba1.js";
 import { Hookable } from "hookable";
 import { OAuthClientProvider, OAuthDiscoveryState } from "@modelcontextprotocol/sdk/client/auth.js";
 import { OAuthClientInformationMixed, OAuthClientMetadata, OAuthTokens } from "@modelcontextprotocol/sdk/shared/auth.js";
@@ -897,6 +897,15 @@ interface SkillsUseToolOptions {
    * placeholder.
    */
   allowShellInterpolation?: boolean;
+  /**
+   * Optional approval gate for `!\`cmd\`` shell interpolation. Invoked once
+   * per (skill, command) the first time a skill with embedded shell is
+   * activated, BEFORE the command runs. Return `false` to skip that command
+   * (it is replaced with a `[shell interpolation not approved]` placeholder).
+   * When omitted, interpolation runs without prompting (back-compat). Hosts
+   * (TUI/GUI) can wire this to an interactive confirmation.
+   */
+  approveShellInterpolation?: (request: ShellInterpolationApproval) => boolean | Promise<boolean>;
 }
 /**
  * Factory for `skills_use`. Auto-injected into the agent's tool set by the
@@ -951,7 +960,7 @@ interface SpawnToolOptions {
   /** Child system prompt override. Per-spawn `input.system` takes precedence. */
   system?: string;
   /** Child thinking level. */
-  thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high';
+  thinking?: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
   /** Preset override for children. Shallow-merged over the parent's preset (parent fields still win for anything left unset). */
   preset?: Preset;
   /**
@@ -1625,7 +1634,7 @@ interface EvalAgent {
 }
 /**
  * Multi-turn eval agent over the low-level headless runner. It keeps session
- * and execution lifetime outside any Playwright/Bolt-specific fixture layer,
+ * and execution lifetime outside any Playwright-specific fixture layer,
  * so downstream platforms can wrap it with their own `agent.run(...)` shape.
  */
 declare function createEvalAgent(options: CreateEvalAgentOptions): EvalAgent;
@@ -1873,103 +1882,6 @@ declare function computeEvalTagScores(metrics: EvalMetric[]): Record<string, num
 declare function artifactPath(root: string, result: EvalCaseResult): string;
 declare function relativeArtifactPath(root: string, path: string): string;
 //#endregion
-//#region src/logger.d.ts
-type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-interface LogRecord {
-  level: LogLevel;
-  /** Unix ms — set by `Logger` at emit time. */
-  timestamp: number;
-  /** Free-form message. Sinks render this as the human-facing line. */
-  message: string;
-  /** Structured fields. Correlation ids land here automatically. */
-  attrs: Record<string, unknown>;
-}
-interface LogSink {
-  emit: (record: LogRecord) => void;
-}
-interface Logger {
-  debug: (message: string, attrs?: Record<string, unknown>) => void;
-  info: (message: string, attrs?: Record<string, unknown>) => void;
-  warn: (message: string, attrs?: Record<string, unknown>) => void;
-  error: (message: string, attrs?: Record<string, unknown>) => void;
-  /**
-   * Returns a child logger that prepends the given attributes onto every
-   * subsequent emit. Equivalent to `pino.child` / `winston.child`. The
-   * parent and child share the same sink — children are zero-cost.
-   */
-  with: (extra: Record<string, unknown>) => Logger;
-  /**
-   * Inspectable baseline attributes — handy for tests and for hook
-   * handlers that want to clone-with-extra without recursing.
-   */
-  readonly baseAttributes: Readonly<Record<string, unknown>>;
-}
-/**
- * Build a Logger from a sink. Stateless and cheap; create one per agent
- * (or per app) and use `.with()` to attach correlation ids per-call.
- */
-declare function createLogger(sink: LogSink, baseAttributes?: Readonly<Record<string, unknown>>): Logger;
-interface ConsoleSinkOptions {
-  /**
-   * Minimum level to emit. Defaults to `'info'` — `debug` is dropped so
-   * the harness's lifecycle logging is not noisy by default. Set to
-   * `'debug'` to see every event.
-   */
-  minLevel?: LogLevel;
-  /** Custom output stream. Defaults to `process.stderr` so logs don't pollute stdout. */
-  stream?: {
-    write: (chunk: string) => void;
-  };
-}
-/**
- * Human-readable terminal sink. Renders each record as
- * `<ISO timestamp> <LEVEL> <message> <attrs as kv pairs>`.
- *
- * Honors `process.stderr` by default so log lines don't interleave with
- * the agent's stdout-bound output (chat responses, JSON results).
- */
-declare function consoleSink(options?: ConsoleSinkOptions): LogSink;
-/**
- * One-JSON-object-per-line sink. Suitable for piping into log aggregators
- * (Datadog Agent, Fluent Bit, Loki, Vector) that expect JSONL.
- */
-declare function jsonSink(options?: ConsoleSinkOptions): LogSink;
-interface LoggingHooksOptions {
-  logger: Logger;
-  /**
-   * Minimum interesting level for harness-emitted lines. Default `'info'`.
-   * Set to `'debug'` to see every tool dispatch / stream event. Set to
-   * `'warn'` to mute the chatty ones and only see failures + budgets.
-   */
-  level?: LogLevel;
-  /**
-   * When true (default), lifecycle events (`agent:start`, `turn:before`,
-   * `tool:before`, `mcp:bootstrap:start`) emit at `debug` level so they
-   * stay quiet by default. Set false to mute them entirely regardless of
-   * the configured minimum level — useful when piping into a tracer
-   * that already captures lifecycle.
-   */
-  includeLifecycle?: boolean;
-}
-interface LoggingHookSet {
-  install: (hooks: Hookable<AgentHooks>) => () => void;
-}
-/**
- * Install a bundle of hook handlers that emit a structured line per
- * relevant lifecycle event, automatically attaching correlation ids
- * (`runId`, `turnId`, `callId`, `childId`, `depth`, `agentName`).
- *
- * @example
- * ```ts
- * const logger = createLogger(consoleSink({ minLevel: 'debug' }), { service: 'tui' })
- * const lh = createLoggingHooks({ logger })
- * const uninstall = lh.install(agent.hooks)
- * try { await agent.run({ prompt }) }
- * finally { uninstall() }
- * ```
- */
-declare function createLoggingHooks(options: LoggingHooksOptions): LoggingHookSet;
-//#endregion
 //#region src/loop.d.ts
 /**
  * Canonical tool_result text emitted when a tool call is interrupted by the
@@ -2131,6 +2043,8 @@ interface BuildStubInput {
   originalBytes: number;
   persistedPath: string;
   output: string;
+  /** Preview cap in bytes. Default {@link PERSISTENCE_PREVIEW_BYTES}. */
+  previewBytes?: number;
 }
 /**
  * Render the byte-stable `<persisted-output>` stub the model sees in place
@@ -2477,10 +2391,13 @@ declare function createMetricsHooks(options: MetricsHooksOptions): MetricsHookSe
 //#endregion
 //#region src/repeat-guard.d.ts
 /**
- * Default tracked-tool predicate: `shell` exactly, plus any tool whose
- * canonical name ends in `_execute_sql` (the MCP SQL-runner shape,
- * `mcp_<server>_execute_sql`). Both are auto-approved, side-effect-light
- * retry magnets — the exact loop shapes the abort escalation exists for.
+ * Default tracked-tool predicate: the built-in `shell` and `read_file` tools.
+ * `shell` is an auto-approved, side-effect-light retry magnet; `read_file` is
+ * the re-read loop magnet — a compaction/dedup interaction can strand the
+ * model re-reading one file forever (see {@link READ_LOOP_TOOLS}). Both are the
+ * loop shapes the abort escalation exists for. Consumers that want to track
+ * additional tools (e.g. an MCP query runner) pass them via
+ * {@link RepeatGuardConfig.tools}.
  */
 declare function defaultRepeatGuardTracked(name: string): boolean;
 /**
@@ -2501,10 +2418,12 @@ declare function defaultRepeatGuardTracked(name: string): boolean;
 declare function normalizeShellCommand(command: string): string;
 /**
  * Built-in normalizer used when the consumer doesn't supply one. Shell-shaped
- * tools get {@link normalizeShellCommand}; SQL-runner tools get a whitespace-
- * collapsed query; everything else falls back to a stable JSON encoding.
- * Returns `undefined` when there's no meaningful payload to key on (so the
- * call is excluded from streak tracking rather than keyed on `'{}'`).
+ * tools get {@link normalizeShellCommand}; everything else falls back to a
+ * stable JSON encoding. Returns `undefined` when there's no meaningful payload
+ * to key on (so the call is excluded from streak tracking rather than keyed on
+ * `'{}'`). Consumers needing semantic keying for their own tools (e.g.
+ * collapsing a query's whitespace) supply a normalizer via
+ * {@link RepeatGuardConfig.normalize}.
  */
 declare function defaultRepeatGuardNormalize(name: string, input: Record<string, unknown>): string | undefined;
 /** Deterministic JSON with sorted keys so key order doesn't split a streak. */
@@ -3006,5 +2925,5 @@ declare function definePreset(config: Preset): Preset;
  */
 declare function composePresets(...presets: Preset[]): Preset;
 //#endregion
-export { PERSISTENCE_PREVIEW_BYTES as $, installHeadlessEventAdapter as $n, buildPostCompactAttachments as $r, MetricEmitter as $t, Counter as A, CacheDimensionName as Ai, llmJudge as An, listFiles as Ar, EvalArtifacts as At, OAuthCallbackOptions as B, HeadlessOptions as Bn, RunSummaryCollector as Br, EvalRunSummary as Bt, ModelUsage as C, anchorPreviewFor as Ci, fileExists as Cn, createSkillsReadTool as Cr, EFFICIENCY_METRICS as Ct, defaultRepeatGuardTracked as D, truncateHeadForPtlRetry as Di, formatEvalRunSummary as Dn, shell as Dr, EvalAgentRunResult as Dt, defaultRepeatGuardNormalize as E, summaryToTurn as Ei, formatEvalCaseSummary as En, createShellTool as Er, EvalAgentRunOptions as Et, MetricsHookSet as F, snapshotCacheDimensions as Fi, statusCompleted as Fn, edit as Fr, EvalMetric as Ft, loginMcpServer as G, OpenAIChatContentPart as Gn, RunSummaryValidation as Gr, EvalScorerContext as Gt, startOAuthCallback as H, HeadlessResult as Hn, RunSummaryError as Hr, EvalRunUsage as Ht, MetricsHooksOptions as I, FormattedHeadlessResult as In, RunSummary as Ir, EvalMetricError as It, McpOAuthProvider as J, exitCodeForHeadlessResult as Jn, estimateTokens as Jr, EvalWorkspaceFile as Jt, McpCredentialEntry as K, OpenAIChatMessage as Kn, createRunSummaryCollector as Kr, EvalTestRunner as Kt, UpDownCounter as L, FormattedHeadlessTurnEvent as Ln, RunSummaryBlock as Lr, EvalRunMetricAggregate as Lt, InstrumentOptions as M, diffCacheDimensions as Mi, registerEvalTests as Mn, createInteractionTool as Mr, EvalCaseResult as Mt, Meter as N, fnv1a32 as Ni, relativeArtifactPath as Nn, grep as Nr, EvalDefinition as Nt, normalizeShellCommand as O, CacheBreakLoggerOptions as Oi, formatTrajectoryLine as On, readFile as Or, EvalAgentRunStats as Ot, MetricAttributes as P, installCacheBreakLogger as Pi, runEvalCase as Pn, glob as Pr, EvalDefinitionContext as Pt, PERSISTED_STUB_PREFIX as Q, headlessEventToJsonl as Qn, RecentFile as Qr, MetricDirection as Qt, createMetricsHooks as R, HeadlessErrorInfo as Rn, RunSummaryBudget as Rr, EvalRunReporter as Rt, splitSystemPrompt as S, SummaryToTurnInput as Si, fileContentQuality as Sn, SkillsReadToolOptions as Sr, CreateEvalAgentOptions as St, statsByModel as T, stripImagesFromTurns as Ti, finalizeEvalMetrics as Tn, CreateShellToolOptions as Tr, EvalAgentMcpServers as Tt, LoginMcpServerOptions as U, HeadlessStatus as Un, RunSummaryRepeatGuard as Ur, EvalScore as Ut, OAuthCallbackResult as V, HeadlessOutputFormat as Vn, RunSummaryCollectorOptions as Vr, EvalRunSummaryCase as Vt, LoginMcpServerResult as W, HeadlessUsage as Wn, RunSummaryTokens as Wr, EvalScorer as Wt, createMemoryMcpCredentialStore as X, formatHeadlessTurnEvent as Xn, PostCompactAttachments as Xr, EvalWorkspaceSnapshot as Xt, McpOAuthProviderOptions as Y, formatHeadlessResult as Yn, utf8ByteLength as Yr, EvalWorkspaceOptions as Yt, hasAuthorizationHeader as Z, formattedHeadlessTurnEventToJsonl as Zn, PostCompactRestoreOptions as Zr, LlmJudgeOptions as Zt, appendStaticSection as _, buildTailCompactPrompt as _i, defineEval as _n, createSpawnTool as _r, LoggingHooksOptions as _t, basicTools as a, compactConversation as ai, Trajectory as an, WAIT_TASK_TIMED_OUT_PREFIX as ar, resolvePersistDir as at, renderSystemForWire as b, CompactScope as bi, emitEfficiencyMetrics as bn, SkillsRunScriptToolOptions as br, createLoggingHooks as bt, Span as c, BASE_INSTRUCTIONS as ci, artifactPath as cn, validateToolArgs as cr, SHELL_CASCADE_CANCEL_MESSAGE as ct, TracingHookSet as d, CompactPromptOptions as di, buildTrajectory as dn, createToolSearchTool as dr, ConsoleSinkOptions as dt, selectFilesFromReadState as ei, MetricSpec as en, providerTranscriptFormatForProvider as er, PersistInput as et, TracingHooksOptions as f, NO_TOOLS_PREAMBLE as fi, clearRegisteredEvals as fn, ChildAgent as fr, LogLevel as ft, appendDynamicSection as g, buildFullCompactPrompt as gi, createReusableExecutionContext as gn, SubagentRegistry as gr, LoggingHookSet as gt, SystemPromptParts as h, buildFromCompactPrompt as hi, createEvalRunReporter as hn, SubagentDef as hr, Logger as ht, _default as i, CompactResult as ii, ReusableExecutionContext as in, writeFile as ir, maybePersistToolResult as it, Histogram as j, CacheDimensionSnapshot as ji, normalizeMetric as jn, InteractionToolOptions as jr, EvalCaseOptions as jt, stableStringify as k, CacheDimensionDiff as ki, functionalityMetric as kn, multiEdit as kr, EvalAgentStats as kt, StartSpan as l, CompactDirection as li, buildEvalRunSummary as ln, LazyToolEntry as lr, TOOL_USE_CANCELLED_MESSAGE as lt, SYSTEM_PROMPT_BOUNDARY as m, buildCompactPrompt as mi, createEvalAgent as mn, SpawnToolState as mr, LogSink as mt, composePresets as n, selectRecentFiles as ni, MetricStats as nn, transcriptToOpenAIMessages as nr, buildPersistedStub as nt, zodToJsonSchema as o, CompactInvalidInputError as oi, TrajectoryStep as on, waitTask as or, resolveTasksDir as ot, createTracingHooks as p, TRAILER as pi, computeEvalTagScores as pn, SpawnToolOptions as pr, LogRecord as pt, McpCredentialStore as q, ProviderTranscriptFormat as qn, BYTES_PER_TOKEN as qr, EvalVariantSummary as qt, definePreset as r, CompactOptions as ri, RegisterEvalTestsOptions as rn, transcriptToProviderMessages as rr, cleanupPersistedSession as rt, GEN_AI_ATTRIBUTES as s, CompactPromptTooLongError as si, TrajectoryStepKind as sn, ValidationResult as sr, INTERRUPT_MESSAGE_FOR_TOOL_USE as st, Preset as t, selectFilesFromSession as ti, MetricSpecMap as tn, runHeadless as tr, PersistOutcome as tt, TracingConventions as u, CompactPromptBuilder as ui, buildRegisteredEvals as un, ToolSearchToolOptions as ur, TOOL_USE_SKIPPED_MESSAGE as ut, hasSystemPromptBoundary as v, buildUpToCompactPrompt as vi, defineMetrics as vn, SkillsUseToolOptions as vr, consoleSink as vt, flattenTurns as w, sliceForCompaction as wi, fileExistsOneOf as wn, shellKill as wr, EvalAgent as wt, replaceDynamicSection as x, CompactionSlice as xi, fileContains as xn, createSkillsRunScriptTool as xr, jsonSink as xt, joinSystemPrompt as y, ANCHOR_PREVIEW_MAX_CHARS as yi, efficiencyMetricValues as yn, createSkillsUseTool as yr, createLogger as yt, OAuthCallbackHandle as z, HeadlessEvent as zn, RunSummaryByModel as zr, EvalRunReporterOptions as zt };
-//# sourceMappingURL=index-C4aT2kO_.d.ts.map
+export { PERSISTENCE_PREVIEW_BYTES as $, ToolSearchToolOptions as $n, CompactPromptBuilder as $r, buildRegisteredEvals as $t, Counter as A, HeadlessOutputFormat as An, RunSummaryCollectorOptions as Ar, EvalRunSummaryCase as At, OAuthCallbackOptions as B, formattedHeadlessTurnEventToJsonl as Bn, PostCompactRestoreOptions as Br, LlmJudgeOptions as Bt, ModelUsage as C, installCacheBreakLogger as Ci, runEvalCase as Cn, glob as Cr, EvalDefinitionContext as Ct, defaultRepeatGuardTracked as D, HeadlessErrorInfo as Dn, RunSummaryBudget as Dr, EvalRunReporter as Dt, defaultRepeatGuardNormalize as E, FormattedHeadlessTurnEvent as En, RunSummaryBlock as Er, EvalRunMetricAggregate as Et, MetricsHookSet as F, OpenAIChatMessage as Fn, createRunSummaryCollector as Fr, EvalTestRunner as Ft, loginMcpServer as G, transcriptToOpenAIMessages as Gn, selectRecentFiles as Gr, MetricStats as Gt, startOAuthCallback as H, installHeadlessEventAdapter as Hn, buildPostCompactAttachments as Hr, MetricEmitter as Ht, MetricsHooksOptions as I, ProviderTranscriptFormat as In, BYTES_PER_TOKEN as Ir, EvalVariantSummary as It, McpOAuthProvider as J, WAIT_TASK_TIMED_OUT_PREFIX as Jn, compactConversation as Jr, Trajectory as Jt, McpCredentialEntry as K, transcriptToProviderMessages as Kn, CompactOptions as Kr, RegisterEvalTestsOptions as Kt, UpDownCounter as L, exitCodeForHeadlessResult as Ln, estimateTokens as Lr, EvalWorkspaceFile as Lt, InstrumentOptions as M, HeadlessStatus as Mn, RunSummaryRepeatGuard as Mr, EvalScore as Mt, Meter as N, HeadlessUsage as Nn, RunSummaryTokens as Nr, EvalScorer as Nt, normalizeShellCommand as O, HeadlessEvent as On, RunSummaryByModel as Or, EvalRunReporterOptions as Ot, MetricAttributes as P, OpenAIChatContentPart as Pn, RunSummaryValidation as Pr, EvalScorerContext as Pt, PERSISTED_STUB_PREFIX as Q, LazyToolEntry as Qn, CompactDirection as Qr, buildEvalRunSummary as Qt, createMetricsHooks as R, formatHeadlessResult as Rn, utf8ByteLength as Rr, EvalWorkspaceOptions as Rt, splitSystemPrompt as S, fnv1a32 as Si, relativeArtifactPath as Sn, grep as Sr, EvalDefinition as St, statsByModel as T, FormattedHeadlessResult as Tn, RunSummary as Tr, EvalMetricError as Tt, LoginMcpServerOptions as U, providerTranscriptFormatForProvider as Un, selectFilesFromReadState as Ur, MetricSpec as Ut, OAuthCallbackResult as V, headlessEventToJsonl as Vn, RecentFile as Vr, MetricDirection as Vt, LoginMcpServerResult as W, runHeadless as Wn, selectFilesFromSession as Wr, MetricSpecMap as Wt, createMemoryMcpCredentialStore as X, ValidationResult as Xn, CompactPromptTooLongError as Xr, TrajectoryStepKind as Xt, McpOAuthProviderOptions as Y, waitTask as Yn, CompactInvalidInputError as Yr, TrajectoryStep as Yt, hasAuthorizationHeader as Z, validateToolArgs as Zn, BASE_INSTRUCTIONS as Zr, artifactPath as Zt, appendStaticSection as _, CacheBreakLoggerOptions as _i, formatTrajectoryLine as _n, readFile as _r, EvalAgentRunStats as _t, basicTools as a, buildFullCompactPrompt as ai, createReusableExecutionContext as an, SubagentRegistry as ar, resolvePersistDir as at, renderSystemForWire as b, CacheDimensionSnapshot as bi, normalizeMetric as bn, InteractionToolOptions as br, EvalCaseOptions as bt, Span as c, ANCHOR_PREVIEW_MAX_CHARS as ci, efficiencyMetricValues as cn, createSkillsUseTool as cr, SHELL_CASCADE_CANCEL_MESSAGE as ct, TracingHookSet as d, SummaryToTurnInput as di, fileContentQuality as dn, SkillsReadToolOptions as dr, CreateEvalAgentOptions as dt, CompactPromptOptions as ei, buildTrajectory as en, createToolSearchTool as er, PersistInput as et, TracingHooksOptions as f, anchorPreviewFor as fi, fileExists as fn, createSkillsReadTool as fr, EFFICIENCY_METRICS as ft, appendDynamicSection as g, truncateHeadForPtlRetry as gi, formatEvalRunSummary as gn, shell as gr, EvalAgentRunResult as gt, SystemPromptParts as h, summaryToTurn as hi, formatEvalCaseSummary as hn, createShellTool as hr, EvalAgentRunOptions as ht, _default as i, buildFromCompactPrompt as ii, createEvalRunReporter as in, SubagentDef as ir, maybePersistToolResult as it, Histogram as j, HeadlessResult as jn, RunSummaryError as jr, EvalRunUsage as jt, stableStringify as k, HeadlessOptions as kn, RunSummaryCollector as kr, EvalRunSummary as kt, StartSpan as l, CompactScope as li, emitEfficiencyMetrics as ln, SkillsRunScriptToolOptions as lr, TOOL_USE_CANCELLED_MESSAGE as lt, SYSTEM_PROMPT_BOUNDARY as m, stripImagesFromTurns as mi, finalizeEvalMetrics as mn, CreateShellToolOptions as mr, EvalAgentMcpServers as mt, composePresets as n, TRAILER as ni, computeEvalTagScores as nn, SpawnToolOptions as nr, buildPersistedStub as nt, zodToJsonSchema as o, buildTailCompactPrompt as oi, defineEval as on, createSpawnTool as or, resolveTasksDir as ot, createTracingHooks as p, sliceForCompaction as pi, fileExistsOneOf as pn, shellKill as pr, EvalAgent as pt, McpCredentialStore as q, writeFile as qn, CompactResult as qr, ReusableExecutionContext as qt, definePreset as r, buildCompactPrompt as ri, createEvalAgent as rn, SpawnToolState as rr, cleanupPersistedSession as rt, GEN_AI_ATTRIBUTES as s, buildUpToCompactPrompt as si, defineMetrics as sn, SkillsUseToolOptions as sr, INTERRUPT_MESSAGE_FOR_TOOL_USE as st, Preset as t, NO_TOOLS_PREAMBLE as ti, clearRegisteredEvals as tn, ChildAgent as tr, PersistOutcome as tt, TracingConventions as u, CompactionSlice as ui, fileContains as un, createSkillsRunScriptTool as ur, TOOL_USE_SKIPPED_MESSAGE as ut, hasSystemPromptBoundary as v, CacheDimensionDiff as vi, functionalityMetric as vn, multiEdit as vr, EvalAgentStats as vt, flattenTurns as w, snapshotCacheDimensions as wi, statusCompleted as wn, edit as wr, EvalMetric as wt, replaceDynamicSection as x, diffCacheDimensions as xi, registerEvalTests as xn, createInteractionTool as xr, EvalCaseResult as xt, joinSystemPrompt as y, CacheDimensionName as yi, llmJudge as yn, listFiles as yr, EvalArtifacts as yt, OAuthCallbackHandle as z, formatHeadlessTurnEvent as zn, PostCompactAttachments as zr, EvalWorkspaceSnapshot as zt };
+//# sourceMappingURL=index-DZR99FD4.d.ts.map