zidane 5.14.4 → 6.0.0

package/dist/{logger-Ktm-lj1s.js → logger-DBX9uYOw.js}

@@ -1,3 +1,5 @@
+import { dirname } from "node:path";
+import { createWriteStream, mkdirSync } from "node:fs";
 //#region src/logger.ts
 /**
 * Build a Logger from a sink. Stateless and cheap; create one per agent
@@ -36,6 +38,17 @@ const LEVEL_ORDER = {
 	error: 3
 };
 /**
+* Render a record as a single human-readable line (no trailing newline):
+* `<ISO timestamp> <LEVEL> <message> <attrs as kv pairs>`. Shared by the
+* console + file sinks and the in-TUI logs viewer so all three surfaces
+* present a byte-identical line.
+*/
+function formatLogLine(record) {
+	const ts = new Date(record.timestamp).toISOString();
+	const kv = Object.entries(record.attrs).filter(([, v]) => v !== void 0).map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`).join(" ");
+	return `${ts} ${record.level.toUpperCase().padEnd(5)} ${record.message}${kv ? ` ${kv}` : ""}`;
+}
+/**
 * Human-readable terminal sink. Renders each record as
 * `<ISO timestamp> <LEVEL> <message> <attrs as kv pairs>`.
 *
@@ -47,9 +60,7 @@ function consoleSink(options = {}) {
 	const stream = options.stream ?? process.stderr;
 	return { emit(record) {
 		if (LEVEL_ORDER[record.level] < min) return;
-		const ts = new Date(record.timestamp).toISOString();
-		const kv = Object.entries(record.attrs).filter(([, v]) => v !== void 0).map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`).join(" ");
-		stream.write(`${ts} ${record.level.toUpperCase().padEnd(5)} ${record.message}${kv ? ` ${kv}` : ""}\n`);
+		stream.write(`${formatLogLine(record)}\n`);
 	} };
 }
 /**
@@ -67,6 +78,98 @@ function jsonSink(options = {}) {
 	} };
 }
 /**
+* Fan a single record out to several sinks. Each sink's `emit` is guarded
+* so one throwing sink can't starve the others (mirrors `createLogger`'s
+* "a sink must never crash the run" contract).
+*/
+function fanoutSink(sinks) {
+	return { emit(record) {
+		for (const sink of sinks) try {
+			sink.emit(record);
+		} catch {}
+	} };
+}
+/**
+* In-memory bounded log buffer backing the in-TUI logs viewer. Always
+* capturing and never touches I/O, so it's safe on the logging hot path.
+* Retains the most recent `capacity` records, dropping the oldest on
+* overflow. Kept simple (a plain array trimmed with `splice`) — TUI log
+* volume is low, so a true head-indexed ring isn't worth the complexity.
+*/
+function createRingBufferSink(options = {}) {
+	const capacity = Math.max(1, options.capacity ?? 2e3);
+	const min = LEVEL_ORDER[options.minLevel ?? "debug"];
+	const records = [];
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		emit(record) {
+			if (LEVEL_ORDER[record.level] < min) return;
+			records.push(record);
+			if (records.length > capacity) records.splice(0, records.length - capacity);
+			for (const listener of listeners) try {
+				listener();
+			} catch {}
+		},
+		getRecords: () => records,
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	};
+}
+/**
+* Append-mode file sink. The parent directory and the write stream are
+* opened lazily on the first record that passes the `enabled()` gate +
+* `minLevel`, so a disabled sink never creates the file. Writes are
+* buffered by the stream (no sync I/O per log). A single open failure
+* disables the sink rather than throwing on the logging path.
+*/
+function createFileSink(options) {
+	const min = LEVEL_ORDER[options.minLevel ?? "debug"];
+	const enabled = options.enabled ?? (() => true);
+	let stream = null;
+	let failed = false;
+	const open = () => {
+		if (stream || failed) return stream;
+		try {
+			mkdirSync(dirname(options.path), { recursive: true });
+			stream = createWriteStream(options.path, { flags: "a" });
+			return stream;
+		} catch {
+			failed = true;
+			return null;
+		}
+	};
+	return {
+		emit(record) {
+			if (failed || LEVEL_ORDER[record.level] < min || !enabled()) return;
+			const s = open();
+			if (!s) return;
+			try {
+				s.write(`${formatLogLine(record)}\n`);
+			} catch {
+				failed = true;
+			}
+		},
+		close() {
+			if (stream) {
+				try {
+					stream.end();
+				} catch {}
+				stream = null;
+			}
+		}
+	};
+}
+/**
+* Filesystem-safe timestamp for a per-session log filename. ISO 8601 with
+* `:` (illegal on Windows / awkward in shells) swapped for `-` and the
+* fractional millis dropped, e.g. `2026-07-01T10-34-14`.
+*/
+function logFileTimestamp(date = /* @__PURE__ */ new Date()) {
+	return date.toISOString().replace(/\.\d+Z$/, "").replace(/:/g, "-");
+}
+/**
 * 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`).
@@ -295,6 +398,6 @@ function createLoggingHooks(options) {
 	} };
 }
 //#endregion
-export { jsonSink as i, createLogger as n, createLoggingHooks as r, consoleSink as t };
+export { createRingBufferSink as a, jsonSink as c, createLoggingHooks as i, logFileTimestamp as l, createFileSink as n, fanoutSink as o, createLogger as r, formatLogLine as s, consoleSink as t };
 
-//# sourceMappingURL=logger-Ktm-lj1s.js.map
+//# sourceMappingURL=logger-DBX9uYOw.js.map

package/dist/logger-DBX9uYOw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-DBX9uYOw.js","names":[],"sources":["../src/logger.ts"],"sourcesContent":["/**\n * Structured logging primitive with auto-correlation.\n *\n * Every consumer of the harness used to roll its own logger; the TUI has\n * one, downstream apps have theirs, observability backends each want a\n * slightly different shape. This module ships the smallest reasonable\n * shared surface:\n *\n * - {@link Logger} — minimal level-tagged interface (`debug` / `info` /\n *   `warn` / `error`) plus a `with(...)` method that returns a child\n *   logger carrying baseline attributes (`runId`, `turnId`, `callId`,\n *   `childId`, `depth`, anything you want).\n * - {@link createLogger} — builds a Logger from a {@link LogSink}.\n * - {@link consoleSink} / {@link jsonSink} — built-in sinks that cover\n *   the common cases (human-readable to a terminal vs. one JSON object\n *   per line to a log aggregator).\n * - {@link createLoggingHooks} — installs Logger-attached hook handlers\n *   on an agent so every lifecycle event lands on the sink with the\n *   right correlation ids already stamped in.\n *\n * Hosts that already own a logger (pino, winston, structlog binding,\n * platform-native) plug it in via a custom {@link LogSink} — the helper\n * itself does no I/O.\n */\n\nimport type { Hookable } from 'hookable'\nimport type { WriteStream } from 'node:fs'\nimport type { AgentHooks } from './agent'\nimport { createWriteStream, mkdirSync } from 'node:fs'\nimport { dirname } from 'node:path'\n\n// ---------------------------------------------------------------------------\n// Core types\n// ---------------------------------------------------------------------------\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error'\n\nexport interface LogRecord {\n  level: LogLevel\n  /** Unix ms — set by `Logger` at emit time. */\n  timestamp: number\n  /** Free-form message. Sinks render this as the human-facing line. */\n  message: string\n  /** Structured fields. Correlation ids land here automatically. */\n  attrs: Record<string, unknown>\n}\n\nexport interface LogSink {\n  emit: (record: LogRecord) => void\n}\n\nexport interface Logger {\n  debug: (message: string, attrs?: Record<string, unknown>) => void\n  info: (message: string, attrs?: Record<string, unknown>) => void\n  warn: (message: string, attrs?: Record<string, unknown>) => void\n  error: (message: string, attrs?: Record<string, unknown>) => void\n  /**\n   * Returns a child logger that prepends the given attributes onto every\n   * subsequent emit. Equivalent to `pino.child` / `winston.child`. The\n   * parent and child share the same sink — children are zero-cost.\n   */\n  with: (extra: Record<string, unknown>) => Logger\n  /**\n   * Inspectable baseline attributes — handy for tests and for hook\n   * handlers that want to clone-with-extra without recursing.\n   */\n  readonly baseAttributes: Readonly<Record<string, unknown>>\n}\n\n// ---------------------------------------------------------------------------\n// createLogger\n// ---------------------------------------------------------------------------\n\n/**\n * Build a Logger from a sink. Stateless and cheap; create one per agent\n * (or per app) and use `.with()` to attach correlation ids per-call.\n */\nexport function createLogger(\n  sink: LogSink,\n  baseAttributes: Readonly<Record<string, unknown>> = {},\n): Logger {\n  function emit(level: LogLevel, message: string, attrs?: Record<string, unknown>): void {\n    try {\n      sink.emit({\n        level,\n        timestamp: Date.now(),\n        message,\n        attrs: attrs ? { ...baseAttributes, ...attrs } : { ...baseAttributes },\n      })\n    }\n    catch {\n      // Sinks should never crash the run.\n    }\n  }\n\n  return {\n    debug: (m, a) => emit('debug', m, a),\n    info: (m, a) => emit('info', m, a),\n    warn: (m, a) => emit('warn', m, a),\n    error: (m, a) => emit('error', m, a),\n    with: extra => createLogger(sink, { ...baseAttributes, ...extra }),\n    baseAttributes,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Built-in sinks\n// ---------------------------------------------------------------------------\n\nexport interface ConsoleSinkOptions {\n  /**\n   * Minimum level to emit. Defaults to `'info'` — `debug` is dropped so\n   * the harness's lifecycle logging is not noisy by default. Set to\n   * `'debug'` to see every event.\n   */\n  minLevel?: LogLevel\n  /** Custom output stream. Defaults to `process.stderr` so logs don't pollute stdout. */\n  stream?: { write: (chunk: string) => void }\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n}\n\n/**\n * Render a record as a single human-readable line (no trailing newline):\n * `<ISO timestamp> <LEVEL> <message> <attrs as kv pairs>`. Shared by the\n * console + file sinks and the in-TUI logs viewer so all three surfaces\n * present a byte-identical line.\n */\nexport function formatLogLine(record: LogRecord): string {\n  const ts = new Date(record.timestamp).toISOString()\n  const kv = Object.entries(record.attrs)\n    .filter(([, v]) => v !== undefined)\n    .map(([k, v]) => `${k}=${typeof v === 'string' ? v : JSON.stringify(v)}`)\n    .join(' ')\n  return `${ts} ${record.level.toUpperCase().padEnd(5)} ${record.message}${kv ? ` ${kv}` : ''}`\n}\n\n/**\n * Human-readable terminal sink. Renders each record as\n * `<ISO timestamp> <LEVEL> <message> <attrs as kv pairs>`.\n *\n * Honors `process.stderr` by default so log lines don't interleave with\n * the agent's stdout-bound output (chat responses, JSON results).\n */\nexport function consoleSink(options: ConsoleSinkOptions = {}): LogSink {\n  const min = LEVEL_ORDER[options.minLevel ?? 'info']\n  const stream = options.stream ?? process.stderr\n  return {\n    emit(record) {\n      if (LEVEL_ORDER[record.level] < min)\n        return\n      stream.write(`${formatLogLine(record)}\\n`)\n    },\n  }\n}\n\n/**\n * One-JSON-object-per-line sink. Suitable for piping into log aggregators\n * (Datadog Agent, Fluent Bit, Loki, Vector) that expect JSONL.\n */\nexport function jsonSink(options: ConsoleSinkOptions = {}): LogSink {\n  const min = LEVEL_ORDER[options.minLevel ?? 'info']\n  const stream = options.stream ?? process.stderr\n  return {\n    emit(record) {\n      if (LEVEL_ORDER[record.level] < min)\n        return\n      try {\n        stream.write(`${JSON.stringify(record)}\\n`)\n      }\n      catch {\n        // Non-serializable attr (cycle, BigInt, etc.). Skip rather than throw.\n      }\n    },\n  }\n}\n\n/**\n * Fan a single record out to several sinks. Each sink's `emit` is guarded\n * so one throwing sink can't starve the others (mirrors `createLogger`'s\n * \"a sink must never crash the run\" contract).\n */\nexport function fanoutSink(sinks: readonly LogSink[]): LogSink {\n  return {\n    emit(record) {\n      for (const sink of sinks) {\n        try {\n          sink.emit(record)\n        }\n        catch {\n          // A misbehaving sink must not block its siblings.\n        }\n      }\n    },\n  }\n}\n\n/** Live handle over a {@link createRingBufferSink} — the read side the logs viewer consumes. */\nexport interface RingBufferSink extends LogSink {\n  /** The buffered records, oldest first — the live array, so treat it as read-only. Bounded by `capacity`. */\n  getRecords: () => readonly LogRecord[]\n  /**\n   * Subscribe to appends. The callback fires after each retained record is\n   * pushed. Returns an unsubscribe fn. Used by the TUI logs viewer to\n   * re-render on new lines without polling.\n   */\n  subscribe: (listener: () => void) => () => void\n}\n\nexport interface RingBufferSinkOptions {\n  /** Max records retained; oldest are evicted past this. Default 2000. */\n  capacity?: number\n  /** Minimum level to retain. Default `'debug'` (retain everything). */\n  minLevel?: LogLevel\n}\n\n/**\n * In-memory bounded log buffer backing the in-TUI logs viewer. Always\n * capturing and never touches I/O, so it's safe on the logging hot path.\n * Retains the most recent `capacity` records, dropping the oldest on\n * overflow. Kept simple (a plain array trimmed with `splice`) — TUI log\n * volume is low, so a true head-indexed ring isn't worth the complexity.\n */\nexport function createRingBufferSink(options: RingBufferSinkOptions = {}): RingBufferSink {\n  const capacity = Math.max(1, options.capacity ?? 2000)\n  const min = LEVEL_ORDER[options.minLevel ?? 'debug']\n  const records: LogRecord[] = []\n  const listeners = new Set<() => void>()\n  return {\n    emit(record) {\n      if (LEVEL_ORDER[record.level] < min)\n        return\n      records.push(record)\n      if (records.length > capacity)\n        records.splice(0, records.length - capacity)\n      for (const listener of listeners) {\n        try {\n          listener()\n        }\n        catch {\n          // A viewer re-render callback must not break log capture.\n        }\n      }\n    },\n    getRecords: () => records,\n    subscribe(listener) {\n      listeners.add(listener)\n      return () => listeners.delete(listener)\n    },\n  }\n}\n\n/** A file sink plus a `close()` for best-effort flush on teardown. */\nexport interface FileSink extends LogSink {\n  /** Flush + close the underlying stream. Idempotent. */\n  close: () => void\n}\n\nexport interface FileSinkOptions {\n  /** Absolute path to the log file. Parent dirs are created lazily. */\n  path: string\n  /** Minimum level to write. Default `'debug'`. */\n  minLevel?: LogLevel\n  /**\n   * Live gate. When it returns false the sink is fully inert — no dir, no\n   * file, no I/O — so an opt-in setting can flip logging on mid-session\n   * without a relaunch. Default: always enabled.\n   */\n  enabled?: () => boolean\n}\n\n/**\n * Append-mode file sink. The parent directory and the write stream are\n * opened lazily on the first record that passes the `enabled()` gate +\n * `minLevel`, so a disabled sink never creates the file. Writes are\n * buffered by the stream (no sync I/O per log). A single open failure\n * disables the sink rather than throwing on the logging path.\n */\nexport function createFileSink(options: FileSinkOptions): FileSink {\n  const min = LEVEL_ORDER[options.minLevel ?? 'debug']\n  const enabled = options.enabled ?? (() => true)\n  let stream: WriteStream | null = null\n  let failed = false\n  const open = (): WriteStream | null => {\n    if (stream || failed)\n      return stream\n    try {\n      mkdirSync(dirname(options.path), { recursive: true })\n      stream = createWriteStream(options.path, { flags: 'a' })\n      return stream\n    }\n    catch {\n      // Unwritable path (permissions, read-only FS) — disable rather than\n      // retry the mkdir/open on every subsequent log line.\n      failed = true\n      return null\n    }\n  }\n  return {\n    emit(record) {\n      if (failed || LEVEL_ORDER[record.level] < min || !enabled())\n        return\n      const s = open()\n      if (!s)\n        return\n      try {\n        s.write(`${formatLogLine(record)}\\n`)\n      }\n      catch {\n        // Disk full / stream closed — stop trying rather than throw per-line.\n        failed = true\n      }\n    },\n    close() {\n      if (stream) {\n        try {\n          stream.end()\n        }\n        catch {\n          // Already-destroyed stream — nothing to flush.\n        }\n        stream = null\n      }\n    },\n  }\n}\n\n/**\n * Filesystem-safe timestamp for a per-session log filename. ISO 8601 with\n * `:` (illegal on Windows / awkward in shells) swapped for `-` and the\n * fractional millis dropped, e.g. `2026-07-01T10-34-14`.\n */\nexport function logFileTimestamp(date: Date = new Date()): string {\n  return date.toISOString().replace(/\\.\\d+Z$/, '').replace(/:/g, '-')\n}\n\n// ---------------------------------------------------------------------------\n// createLoggingHooks\n// ---------------------------------------------------------------------------\n\nexport interface LoggingHooksOptions {\n  logger: Logger\n  /**\n   * Minimum interesting level for harness-emitted lines. Default `'info'`.\n   * Set to `'debug'` to see every tool dispatch / stream event. Set to\n   * `'warn'` to mute the chatty ones and only see failures + budgets.\n   */\n  level?: LogLevel\n  /**\n   * When true (default), lifecycle events (`agent:start`, `turn:before`,\n   * `tool:before`, `mcp:bootstrap:start`) emit at `debug` level so they\n   * stay quiet by default. Set false to mute them entirely regardless of\n   * the configured minimum level — useful when piping into a tracer\n   * that already captures lifecycle.\n   */\n  includeLifecycle?: boolean\n}\n\nexport interface LoggingHookSet {\n  install: (hooks: Hookable<AgentHooks>) => () => void\n}\n\n/**\n * Install a bundle of hook handlers that emit a structured line per\n * relevant lifecycle event, automatically attaching correlation ids\n * (`runId`, `turnId`, `callId`, `childId`, `depth`, `agentName`).\n *\n * @example\n * ```ts\n * const logger = createLogger(consoleSink({ minLevel: 'debug' }), { service: 'tui' })\n * const lh = createLoggingHooks({ logger })\n * const uninstall = lh.install(agent.hooks)\n * try { await agent.run({ prompt }) }\n * finally { uninstall() }\n * ```\n */\nexport function createLoggingHooks(options: LoggingHooksOptions): LoggingHookSet {\n  const root = options.logger\n  const includeLifecycle = options.includeLifecycle ?? true\n  const minLevel = LEVEL_ORDER[options.level ?? 'info']\n\n  /**\n   * Wrap a Logger so emissions below `minLevel` are dropped before they\n   * hit the sink. Lets us gate harness chatter without forcing every\n   * `LogSink` to re-implement level filtering. Preserves `.with()`\n   * composition (children inherit the filter).\n   */\n  function gateLevel(logger: Logger): Logger {\n    const skip = (level: LogLevel): boolean => LEVEL_ORDER[level] < minLevel\n    const wrap = (l: Logger): Logger => ({\n      debug: (m, a) => {\n        if (!skip('debug'))\n          l.debug(m, a)\n      },\n      info: (m, a) => {\n        if (!skip('info'))\n          l.info(m, a)\n      },\n      warn: (m, a) => {\n        if (!skip('warn'))\n          l.warn(m, a)\n      },\n      error: (m, a) => {\n        if (!skip('error'))\n          l.error(m, a)\n      },\n      with: extra => wrap(l.with(extra)),\n      baseAttributes: l.baseAttributes,\n    })\n    return wrap(logger)\n  }\n\n  return {\n    install(hooks: Hookable<AgentHooks>): () => void {\n      const unregisters: Array<() => void> = []\n      // Per-install loggers, refreshed on `agent:start` / `turn:before`.\n      // Scoped INSIDE install() so concurrent installs across different\n      // agents don't share state — each call to `install()` gets its own\n      // attribution state.\n      const gatedRoot = gateLevel(root)\n      let runLogger = gatedRoot\n      let turnLogger = gatedRoot\n\n      // ---- Agent lifecycle --------------------------------------------\n\n      unregisters.push(hooks.hook('agent:start', (ctx) => {\n        runLogger = gatedRoot.with({\n          runId: ctx.runId,\n          ...(ctx.parentRunId ? { parentRunId: ctx.parentRunId } : {}),\n          depth: ctx.depth,\n          ...(ctx.agentName ? { agentName: ctx.agentName } : {}),\n        })\n        turnLogger = runLogger\n        if (includeLifecycle)\n          runLogger.debug('agent run started')\n      }))\n\n      unregisters.push(hooks.hook('agent:done', (stats) => {\n        runLogger.info('agent run completed', {\n          turns: stats.turns,\n          totalIn: stats.totalIn,\n          totalOut: stats.totalOut,\n          ...(typeof stats.cost === 'number' ? { cost: stats.cost } : {}),\n          elapsedMs: stats.elapsed,\n          ...(typeof stats.timeTillFirstTokenMs === 'number' ? { ttftMs: stats.timeTillFirstTokenMs } : {}),\n        })\n      }))\n\n      unregisters.push(hooks.hook('agent:abort', () => {\n        runLogger.warn('agent run aborted')\n      }))\n\n      // ---- Turn / stream ---------------------------------------------\n\n      unregisters.push(hooks.hook('turn:before', (ctx) => {\n        turnLogger = runLogger.with({ turnId: ctx.turnId, turn: ctx.turn })\n        if (includeLifecycle)\n          turnLogger.debug('turn started')\n      }))\n\n      unregisters.push(hooks.hook('turn:after', (ctx) => {\n        turnLogger.debug('turn ended', {\n          inputTokens: ctx.usage.input,\n          outputTokens: ctx.usage.output,\n          ...(ctx.usage.finishReason ? { finishReason: ctx.usage.finishReason } : {}),\n          ...(ctx.usage.modelId ? { modelId: ctx.usage.modelId } : {}),\n          ...(typeof ctx.usage.timeToFirstTokenMs === 'number' ? { ttftMs: ctx.usage.timeToFirstTokenMs } : {}),\n        })\n      }))\n\n      unregisters.push(hooks.hook('stream:error', (ctx) => {\n        turnLogger.error('stream error', {\n          message: ctx.err instanceof Error ? ctx.err.message : String(ctx.err),\n          ...(ctx.statusCode !== undefined ? { statusCode: ctx.statusCode } : {}),\n          ...(ctx.requestId !== undefined ? { requestId: ctx.requestId } : {}),\n        })\n      }))\n\n      // ---- Tool calls -------------------------------------------------\n\n      unregisters.push(hooks.hook('tool:before', (ctx) => {\n        if (!includeLifecycle)\n          return\n        turnLogger.debug('tool started', {\n          toolName: ctx.name,\n          displayName: ctx.displayName,\n          callId: ctx.callId,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:after', (ctx) => {\n        if (!includeLifecycle)\n          return\n        turnLogger.debug('tool ended', {\n          toolName: ctx.name,\n          callId: ctx.callId,\n          outputBytes: ctx.outputBytes,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:error', (ctx) => {\n        turnLogger.error('tool error', {\n          toolName: ctx.name,\n          callId: ctx.callId,\n          message: ctx.error.message,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool:dispatched', (ctx) => {\n        // Successful + gate-substitute paths are routine — only log at\n        // debug level. The three \"something refused / went wrong\" paths\n        // (gate-block, unknown tool, invalid input) land at warn so they\n        // surface in default-config dashboards without forcing debug.\n        const isAnomaly = ctx.outcome === 'gate-block'\n          || ctx.outcome === 'unknown'\n          || ctx.outcome === 'invalid-input'\n        if (!isAnomaly && !includeLifecycle)\n          return\n        const lvl: LogLevel = isAnomaly ? 'warn' : 'debug'\n        turnLogger[lvl]('tool dispatched', {\n          toolName: ctx.name,\n          callId: ctx.callId,\n          outcome: ctx.outcome,\n          ...(ctx.reason ? { reason: ctx.reason } : {}),\n        })\n      }))\n\n      unregisters.push(hooks.hook('validation:reject', (ctx) => {\n        turnLogger.warn('tool input rejected', {\n          toolName: ctx.name,\n          callId: ctx.callId,\n          reason: ctx.reason,\n        })\n      }))\n\n      // ---- Budgets ----------------------------------------------------\n\n      unregisters.push(hooks.hook('budget:exceeded', (ctx) => {\n        turnLogger.warn('byte budget exceeded', {\n          bytes: ctx.bytes,\n          budget: ctx.budget,\n        })\n      }))\n\n      unregisters.push(hooks.hook('tool-budget:exceeded', (ctx) => {\n        turnLogger.warn('tool budget exceeded', {\n          toolName: ctx.tool,\n          count: ctx.count,\n          max: ctx.max,\n          mode: ctx.mode,\n        })\n      }))\n\n      // ---- MCP --------------------------------------------------------\n\n      unregisters.push(hooks.hook('mcp:bootstrap:end', (ctx) => {\n        if (ctx.ok) {\n          if (includeLifecycle) {\n            runLogger.debug('mcp bootstrap ok', {\n              server: ctx.name,\n              transport: ctx.transport,\n              durationMs: ctx.durationMs,\n              toolCount: ctx.toolCount,\n              ...(ctx.lazy ? { lazy: true } : {}),\n              ...(ctx.cached ? { cached: true } : {}),\n            })\n          }\n        }\n        else {\n          runLogger.warn('mcp bootstrap failed', {\n            server: ctx.name,\n            transport: ctx.transport,\n            durationMs: ctx.durationMs,\n            message: ctx.error.message,\n          })\n        }\n      }))\n\n      unregisters.push(hooks.hook('mcp:error', (ctx) => {\n        runLogger.error('mcp error', {\n          server: ctx.name,\n          message: ctx.error.message,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:warn', (ctx) => {\n        runLogger.warn('mcp warn', {\n          server: ctx.name,\n          message: ctx.message,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:auth:required', (ctx) => {\n        runLogger.warn('mcp auth required', {\n          server: ctx.name,\n          transport: ctx.transport,\n          reason: ctx.reason,\n        })\n      }))\n\n      unregisters.push(hooks.hook('mcp:tool:error', (ctx) => {\n        turnLogger.error('mcp tool error', {\n          server: ctx.server,\n          tool: ctx.displayName,\n          callId: ctx.callId,\n          message: ctx.error.message,\n        })\n      }))\n\n      // ---- Spawn ------------------------------------------------------\n\n      unregisters.push(hooks.hook('spawn:before', (ctx) => {\n        if (!includeLifecycle)\n          return\n        runLogger.debug('spawn started', {\n          childId: ctx.id,\n          depth: ctx.depth,\n        })\n      }))\n\n      unregisters.push(hooks.hook('spawn:complete', (ctx) => {\n        runLogger.info('spawn completed', {\n          childId: ctx.id,\n          ...(ctx.depth ? { depth: ctx.depth } : {}),\n          status: ctx.status ?? 'completed',\n          turns: ctx.stats.turns,\n          totalIn: ctx.stats.totalIn,\n          totalOut: ctx.stats.totalOut,\n          ...(typeof ctx.stats.cost === 'number' ? { cost: ctx.stats.cost } : {}),\n        })\n      }))\n\n      unregisters.push(hooks.hook('spawn:error', (ctx) => {\n        runLogger.error('spawn error', {\n          childId: ctx.id,\n          ...(ctx.depth ? { depth: ctx.depth } : {}),\n          message: ctx.error.message,\n        })\n      }))\n\n      // -----------------------------------------------------------------\n      // Disposal\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"],"mappings":"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"}