agent-inspect 1.9.0 → 2.0.0

package/packages/core/dist/index.mjs

@@ -1,1473 +1,13 @@
-import { getCurrentContext, getCurrentDepth, getParentStepId, getTraceSafetyFromContext, runWithStepContext, runWithContext, printStepStart, printStepComplete, printError, printFailedAt, printRunStart, printRunComplete } from './chunk-6QSLZCBJ.mjs';
-export { MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, TERMINAL_INDENT, createInspector, createInspectorRuntime, formatTerminalName, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getIndent, getParentStepId, getTraceDirFromContext, getTraceSafetyFromContext, hasActiveContext, isSilentContext, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, runWithContext, runWithStepContext } from './chunk-6QSLZCBJ.mjs';
-export { inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents } from './chunk-U2BGPESY.mjs';
-export { DEFAULT_LOG_INGEST_CONFIG, EventNormalizer, JsonLogParser, LiveLogAccumulator, Log4jsParser, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './chunk-HR7G62IE.mjs';
-import { redactTraceEventsForReport, exportMarkdown, exportHtml, manualTraceEventsToRunTree, redactRunTreeForExport } from './chunk-Y56BPA3B.mjs';
-export { EXPORT_PAYLOAD_VERSION, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, validateExport, validateExportContent } from './chunk-Y56BPA3B.mjs';
-export { diffRuns, diffTraceEvents, manualTraceEventsToComparableRun, renderRunDiff } from './chunk-YWAOOXLR.mjs';
+import { getCurrentContext, getCurrentDepth, getParentStepId, getTraceSafetyFromContext, runWithStepContext, printStepStart, printStepComplete, printError, printFailedAt, inspectRun } from './chunk-A4V2H3YU.mjs';
+export { createInspector, getCurrentCorrelationMetadata, inspectRun, maybeInspectRun } from './chunk-A4V2H3YU.mjs';
 import './chunk-BT7CATSD.mjs';
-import { escapeMarkdown, escapeHtml } from './chunk-HY7H3CQM.mjs';
-export { compactAttributes, escapeHtml, escapeMarkdown, flattenTree, safeString, stableJson, summarizeTree } from './chunk-HY7H3CQM.mjs';
-export { bufferedFileWriter, compositeWriter, fileWriter, memoryWriter, nullWriter } from './chunk-6SZPTECC.mjs';
-import { readTraceEventsFromFile, resolveTraceSafetyOptions, prepareTraceEventForDisk, writeTraceEvent, initializeTraceFile } from './chunk-57S5D6HR.mjs';
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, getRunIdFromTraceFileName, initializeTraceFile, listTraceFiles, prepareMetadataForDisk, prepareTraceEventForDisk, readTraceEvents, readTraceFile, resolveTraceSafetyOptions, serializeEvent, validateEvent, writeTraceEvent } from './chunk-57S5D6HR.mjs';
-import { resolveRedactionProfile } from './chunk-EDTQHZPM.mjs';
-export { resolveRedactionProfile } from './chunk-EDTQHZPM.mjs';
-import { Redactor } from './chunk-VU6O5QAH.mjs';
-export { DEFAULT_REDACT_KEYS, Redactor } from './chunk-VU6O5QAH.mjs';
-export { DEFAULT_TRACE_READERS, TraceReadError, agentInspectJsonlReader, detectTraceFormat, openTrace, readTrace } from './chunk-TFLPUZ56.mjs';
-export { persistedInspectEventToInspectEvent, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './chunk-TZISEVLQ.mjs';
-import { buildRunStartedMetadata } from './chunk-S4YWKV4G.mjs';
-export { TreeBuilder } from './chunk-E5F2LQCX.mjs';
-import { warn, createStepId, formatError, truncateName, getDefaultTraceDir, parseTraceJsonl, parseDuration, formatTimestamp, formatDuration, isTraceEvent, createRunId, getTraceFilePath } from './chunk-VTIB5MDK.mjs';
-export { DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, RUNS_DIR_NAME, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTimestamp, getDefaultTraceDir, getTraceFilePath, isStepStatus, isStepType, isTraceEvent, parseDuration, parseTraceJsonl, truncateName, unknownTraceFormatMessage, warn } from './chunk-VTIB5MDK.mjs';
-export { isPersistedInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToTraceEvents } from './chunk-74XZ6N7Q.mjs';
+import { prepareTraceEventForDisk, writeTraceEvent } from './chunk-4JVGFNQH.mjs';
+import './chunk-EDTQHZPM.mjs';
+import './chunk-VU6O5QAH.mjs';
+import './chunk-S4YWKV4G.mjs';
+import { warn, createStepId, formatError, truncateName } from './chunk-NQZPZ2FN.mjs';
+import './chunk-IZBJAZGF.mjs';
 import './chunk-7TGZLWEE.mjs';
-import { readdir, stat, readFile } from 'fs/promises';
-import path from 'path';
-import { createReadStream } from 'fs';
-import { createInterface } from 'readline';
-
-function resolveTraceDir(options = {}) {
-  if (typeof options.dir === "string" && options.dir.trim() !== "") {
-    return options.dir.trim();
-  }
-  const envDir = process.env.AGENT_INSPECT_TRACE_DIR;
-  if (typeof envDir === "string" && envDir.trim() !== "") {
-    return envDir.trim();
-  }
-  return getDefaultTraceDir();
-}
-var TraceDirectory = class {
-  #dir;
-  constructor(options = {}) {
-    this.#dir = resolveTraceDir(options);
-  }
-  getPath(filename) {
-    return filename ? path.join(this.#dir, filename) : this.#dir;
-  }
-  async list() {
-    try {
-      const files = await readdir(this.#dir);
-      return files.filter((f) => f.endsWith(".jsonl"));
-    } catch (e) {
-      if (e && typeof e === "object" && "code" in e && e.code === "ENOENT") {
-        return [];
-      }
-      throw e;
-    }
-  }
-  async getFileStats(filename) {
-    return await stat(this.getPath(filename));
-  }
-};
-function isFiniteNumber(v) {
-  return typeof v === "number" && Number.isFinite(v);
-}
-function parseIsoToMs(value) {
-  if (value === void 0) return void 0;
-  const parsed = Date.parse(value);
-  return Number.isFinite(parsed) ? parsed : void 0;
-}
-async function extractMetadata(filePath, _quickScan) {
-  const stats = await stat(filePath);
-  let runIdFromFile = path.basename(filePath);
-  if (runIdFromFile.endsWith(".jsonl")) {
-    runIdFromFile = runIdFromFile.slice(0, -".jsonl".length);
-  }
-  const raw = await readFile(filePath, "utf-8");
-  const parsedTrace = parseTraceJsonl(raw, { warnings: false });
-  let runId;
-  let name;
-  let startedAt;
-  let endedAt;
-  let explicitDurationMs;
-  let hasRunStarted = false;
-  let hasRunCompleted = false;
-  let runCompletedStatus;
-  let anyStepError = false;
-  const anyKnownEvent = parsedTrace.sourceEventCount > 0;
-  let persistedStatus;
-  const persistedRun = parsedTrace.persisted.find(
-    (event) => event.kind === "RUN"
-  );
-  if (persistedRun) {
-    runId = persistedRun.runId;
-    if (persistedRun.name.trim() !== "") {
-      name = persistedRun.name;
-    }
-    startedAt = parseIsoToMs(persistedRun.startedAt) ?? parseIsoToMs(persistedRun.timestamp);
-    endedAt = parseIsoToMs(persistedRun.endedAt);
-    if (isFiniteNumber(persistedRun.durationMs)) {
-      explicitDurationMs = persistedRun.durationMs;
-      if (endedAt === void 0 && startedAt !== void 0) {
-        endedAt = startedAt + persistedRun.durationMs;
-      }
-    }
-    if (persistedRun.status === "ok") persistedStatus = "success";
-    else if (persistedRun.status === "error") persistedStatus = "error";
-    else if (persistedRun.status === "running") persistedStatus = "running";
-    else if (persistedRun.status === "unknown") persistedStatus = "unknown";
-  } else {
-    runId = parsedTrace.persisted[0]?.runId;
-  }
-  for (const e of parsedTrace.events) {
-    if (runId === void 0 && typeof e.runId === "string") {
-      runId = e.runId;
-    }
-    if (e.event === "run_started") {
-      hasRunStarted = true;
-      const rs = e;
-      if (typeof rs.name === "string" && rs.name.trim() !== "") {
-        name = rs.name;
-      }
-      if (isFiniteNumber(rs.startTime)) {
-        startedAt = rs.startTime;
-      } else if (isFiniteNumber(rs.timestamp)) {
-        startedAt = rs.timestamp;
-      }
-    }
-    if (e.event === "run_completed") {
-      hasRunCompleted = true;
-      const rc = e;
-      runCompletedStatus = rc.status;
-      if (isFiniteNumber(rc.endTime)) endedAt = rc.endTime;
-      else if (isFiniteNumber(rc.timestamp)) endedAt = rc.timestamp;
-      if (isFiniteNumber(rc.durationMs)) explicitDurationMs = rc.durationMs;
-    }
-    if (e.event === "step_completed") {
-      const sc = e;
-      if (sc.status === "error") {
-        anyStepError = true;
-      }
-    }
-  }
-  const resolvedRunId = runId ?? runIdFromFile;
-  let status = "unknown";
-  if (hasRunCompleted && (runCompletedStatus === "success" || runCompletedStatus === "error")) {
-    status = runCompletedStatus;
-  } else if (anyStepError) {
-    status = "error";
-  } else if (persistedStatus !== void 0) {
-    status = persistedStatus;
-  } else if (hasRunStarted && !hasRunCompleted) {
-    status = "running";
-  } else if (anyKnownEvent) {
-    status = "unknown";
-  } else {
-    status = "unknown";
-  }
-  const durationMs = explicitDurationMs ?? (startedAt !== void 0 && endedAt !== void 0 && Number.isFinite(startedAt) && Number.isFinite(endedAt) && endedAt >= startedAt ? endedAt - startedAt : void 0);
-  return {
-    runId: resolvedRunId,
-    name,
-    status,
-    startedAt,
-    endedAt,
-    durationMs,
-    eventCount: parsedTrace.sourceEventCount,
-    filePath,
-    fileSize: stats.size,
-    createdAt: stats.birthtime
-  };
-}
-function isNonNegativeFiniteNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) && value >= 0;
-}
-function buildRunSummary(events) {
-  const started = events.find(
-    (e) => e.event === "run_started"
-  );
-  const completed = events.filter(
-    (e) => e.event === "run_completed"
-  );
-  const lastCompleted = completed[completed.length - 1];
-  const runId = started?.runId ?? events.find((e) => typeof e.runId === "string")?.runId ?? "unknown-run";
-  const name = typeof started?.name === "string" && started.name.trim() !== "" ? started.name : void 0;
-  const status = lastCompleted ? lastCompleted.status : started ? "running" : "unknown";
-  const durationMs = lastCompleted && isFiniteNumber(lastCompleted.durationMs) ? lastCompleted.durationMs : void 0;
-  started && isFiniteNumber(started.startTime) ? started.startTime : void 0;
-  const steps = /* @__PURE__ */ new Map();
-  for (const e of events) {
-    if (e.event === "step_started") {
-      const s = e;
-      steps.set(s.stepId, {
-        type: s.type,
-        name: s.name,
-        status: "running",
-        parentId: s.parentId,
-        tokensInput: isNonNegativeFiniteNumber(s.metadata?.tokens?.input) ? s.metadata.tokens.input : void 0,
-        tokensOutput: isNonNegativeFiniteNumber(s.metadata?.tokens?.output) ? s.metadata.tokens.output : void 0,
-        tokensTotal: isNonNegativeFiniteNumber(s.metadata?.tokens?.total) ? s.metadata.tokens.total : void 0,
-        tokensCached: isNonNegativeFiniteNumber(s.metadata?.tokens?.cached) ? s.metadata.tokens.cached : void 0
-      });
-    }
-  }
-  for (const e of events) {
-    if (e.event === "step_completed") {
-      const c = e;
-      const existing = steps.get(c.stepId);
-      if (!existing) continue;
-      existing.status = c.status;
-      existing.durationMs = c.durationMs;
-    }
-  }
-  let totalSteps = 0;
-  let llmSteps = 0;
-  let toolSteps = 0;
-  let logicSteps = 0;
-  let errorSteps = 0;
-  let maxDepth = 0;
-  let longestStep;
-  let totalTokensInput = 0;
-  let totalTokensOutput = 0;
-  let totalTokensTotal = 0;
-  let totalTokensCached = 0;
-  let tokenBearingSteps = 0;
-  let stepsWithKnownTotal = 0;
-  let hasCachedTokens = false;
-  const depthCache = /* @__PURE__ */ new Map();
-  const computeDepth = (stepId) => {
-    const cached = depthCache.get(stepId);
-    if (cached !== void 0) return cached;
-    const node = steps.get(stepId);
-    if (!node) return 0;
-    const parent = node.parentId;
-    if (typeof parent !== "string" || parent.trim() === "" || !steps.has(parent)) {
-      depthCache.set(stepId, 0);
-      return 0;
-    }
-    const d = Math.min(1e3, computeDepth(parent) + 1);
-    depthCache.set(stepId, d);
-    return d;
-  };
-  for (const [id, s] of steps.entries()) {
-    totalSteps += 1;
-    if (s.type === "llm") llmSteps += 1;
-    else if (s.type === "tool") toolSteps += 1;
-    else logicSteps += 1;
-    if (s.status === "error") errorSteps += 1;
-    const depth = computeDepth(id);
-    if (depth > maxDepth) maxDepth = depth;
-    if (typeof s.durationMs === "number" && Number.isFinite(s.durationMs)) {
-      if (!longestStep || s.durationMs > longestStep.durationMs) {
-        longestStep = { name: s.name, durationMs: s.durationMs, type: s.type };
-      }
-    }
-    if (s.tokensInput !== void 0 || s.tokensOutput !== void 0 || s.tokensTotal !== void 0 || s.tokensCached !== void 0) {
-      tokenBearingSteps += 1;
-      if (s.tokensInput !== void 0) totalTokensInput += s.tokensInput;
-      if (s.tokensOutput !== void 0) totalTokensOutput += s.tokensOutput;
-      if (s.tokensTotal !== void 0) {
-        totalTokensTotal += s.tokensTotal;
-        stepsWithKnownTotal += 1;
-      } else if (s.tokensInput !== void 0 && s.tokensOutput !== void 0) {
-        totalTokensTotal += s.tokensInput + s.tokensOutput;
-        stepsWithKnownTotal += 1;
-      }
-      if (s.tokensCached !== void 0) {
-        totalTokensCached += s.tokensCached;
-        hasCachedTokens = true;
-      }
-    }
-  }
-  const summary = {
-    runId,
-    name,
-    status,
-    durationMs,
-    totalSteps,
-    llmSteps,
-    toolSteps,
-    logicSteps,
-    errorSteps,
-    maxDepth,
-    ...longestStep ? { longestStep } : {},
-    ...tokenBearingSteps > 0 ? {
-      totalTokens: {
-        input: totalTokensInput,
-        output: totalTokensOutput,
-        ...stepsWithKnownTotal === tokenBearingSteps ? { total: totalTokensTotal } : {},
-        ...hasCachedTokens ? { cached: totalTokensCached } : {}
-      }
-    } : {}
-  };
-  return summary;
-}
-
-// packages/core/src/trace-filter.ts
-function toLower(s) {
-  return typeof s === "string" ? s.toLowerCase() : "";
-}
-function filterTraces(traces, options) {
-  const input = [...traces];
-  let out = input.filter((t) => {
-    if (options.status && t.status !== options.status) return false;
-    if (options.name) {
-      const q = options.name.toLowerCase();
-      const hay = `${toLower(t.name)} ${toLower(t.runId)}`;
-      if (!hay.includes(q)) return false;
-    }
-    if (options.since) {
-      const windowMs = parseDuration(options.since);
-      const cutoff = Date.now() - windowMs;
-      const started = typeof t.startedAt === "number" ? t.startedAt : void 0;
-      const basis = started ?? t.createdAt.getTime();
-      if (!Number.isFinite(basis) || basis < cutoff) return false;
-    }
-    return true;
-  });
-  out.sort((a, b) => {
-    const aTime = (typeof a.startedAt === "number" ? a.startedAt : void 0) ?? a.createdAt.getTime();
-    const bTime = (typeof b.startedAt === "number" ? b.startedAt : void 0) ?? b.createdAt.getTime();
-    return bTime - aTime;
-  });
-  if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
-    const n = Math.max(0, Math.floor(options.limit));
-    out = out.slice(0, n);
-  }
-  return out;
-}
-
-// packages/core/src/timeline.ts
-function finite(n) {
-  return typeof n === "number" && Number.isFinite(n);
-}
-function pickStreamingMeta(metadata) {
-  if (!metadata || typeof metadata !== "object") return void 0;
-  const chunkCount = metadata.chunkCount;
-  const streamDurationMs = metadata.streamDurationMs;
-  const streamedCharCount = metadata.streamedCharCount;
-  if (!finite(chunkCount) && !finite(streamDurationMs) && !finite(streamedCharCount)) {
-    return void 0;
-  }
-  return {
-    ...finite(chunkCount) ? { chunkCount } : {},
-    ...finite(streamDurationMs) ? { streamDurationMs } : {},
-    ...finite(streamedCharCount) ? { streamedCharCount } : {}
-  };
-}
-function pickCorrelation(metadata) {
-  if (!metadata || typeof metadata !== "object") return void 0;
-  const out = {};
-  for (const key of [
-    "correlationId",
-    "requestId",
-    "decisionId",
-    "groupId"
-  ]) {
-    const v = metadata[key];
-    if (typeof v === "string" && v.trim() !== "") {
-      out[key] = v;
-    }
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function buildRunTimeline(events, options = {}) {
-  const started = events.find(
-    (e) => e.event === "run_started"
-  );
-  const completed = events.filter(
-    (e) => e.event === "run_completed"
-  );
-  const lastCompleted = completed[completed.length - 1];
-  const runId = started?.runId ?? events.find((e) => typeof e.runId === "string")?.runId ?? "unknown-run";
-  const runStart = started && finite(started.startTime) ? started.startTime : started && finite(started.timestamp) ? started.timestamp : void 0;
-  const status = lastCompleted ? lastCompleted.status : started ? "running" : "unknown";
-  const steps = /* @__PURE__ */ new Map();
-  for (const e of events) {
-    if (e.event === "step_started") {
-      const s = e;
-      steps.set(s.stepId, {
-        name: s.name,
-        type: s.type,
-        parentId: s.parentId,
-        startedAt: finite(s.startTime) ? s.startTime : s.timestamp,
-        status: "running",
-        metadata: s.metadata
-      });
-    }
-  }
-  for (const e of events) {
-    if (e.event !== "step_completed") continue;
-    const c = e;
-    const node = steps.get(c.stepId);
-    if (!node) continue;
-    node.status = c.status;
-    if (finite(c.durationMs)) node.durationMs = c.durationMs;
-  }
-  const depthCache = /* @__PURE__ */ new Map();
-  const computeDepth = (stepId) => {
-    const cached = depthCache.get(stepId);
-    if (cached !== void 0) return cached;
-    const node = steps.get(stepId);
-    if (!node) return 0;
-    const parent = node.parentId;
-    if (typeof parent !== "string" || parent.trim() === "" || !steps.has(parent)) {
-      depthCache.set(stepId, 0);
-      return 0;
-    }
-    const d = Math.min(1e3, computeDepth(parent) + 1);
-    depthCache.set(stepId, d);
-    return d;
-  };
-  const entries = [];
-  for (const [stepId, s] of steps.entries()) {
-    const offsetMs = runStart !== void 0 && finite(s.startedAt) ? Math.max(0, s.startedAt - runStart) : 0;
-    entries.push({
-      stepId,
-      name: s.name,
-      type: s.type,
-      status: s.status,
-      depth: computeDepth(stepId),
-      startedAt: s.startedAt,
-      offsetMs,
-      durationMs: s.durationMs,
-      isError: s.status === "error",
-      streaming: pickStreamingMeta(s.metadata)
-    });
-  }
-  entries.sort((a, b) => a.startedAt - b.startedAt);
-  const slowTopN = options.slowTopN ?? 3;
-  if (options.focus === "slow" && entries.length > 0) {
-    const ranked = [...entries].filter((e) => finite(e.durationMs)).sort((a, b) => (b.durationMs ?? 0) - (a.durationMs ?? 0));
-    const slowIds = new Set(
-      ranked.slice(0, slowTopN).map((e) => e.stepId)
-    );
-    for (const e of entries) {
-      if (slowIds.has(e.stepId)) e.slow = true;
-    }
-  }
-  return {
-    runId,
-    name: typeof started?.name === "string" && started.name.trim() !== "" ? started.name : void 0,
-    status,
-    startedAt: runStart,
-    endedAt: lastCompleted && finite(lastCompleted.endTime) ? lastCompleted.endTime : void 0,
-    durationMs: lastCompleted && finite(lastCompleted.durationMs) ? lastCompleted.durationMs : void 0,
-    correlation: pickCorrelation(
-      started?.metadata
-    ),
-    entries
-  };
-}
-function renderTimeline(timeline, options = {}) {
-  const lines = [];
-  lines.push(`Timeline: ${timeline.name ?? timeline.runId}`);
-  lines.push(`Run ID: ${timeline.runId}`);
-  lines.push(`Status: ${timeline.status}`);
-  if (timeline.startedAt !== void 0) {
-    lines.push(`Started: ${formatTimestamp(timeline.startedAt)}`);
-  }
-  if (timeline.durationMs !== void 0) {
-    lines.push(`Duration: ${formatDuration(timeline.durationMs)}`);
-  }
-  if (timeline.correlation) {
-    const parts = Object.entries(timeline.correlation).filter(([, v]) => typeof v === "string").map(([k, v]) => `${k}=${v}`);
-    if (parts.length > 0) {
-      lines.push(`Correlation: ${parts.join(", ")}`);
-    }
-  }
-  lines.push("");
-  lines.push("Steps (chronological):");
-  const show = timeline.entries.filter((e) => {
-    if (options.focus === "slow") return e.slow === true;
-    return true;
-  });
-  if (show.length === 0) {
-    lines.push(
-      options.focus === "slow" ? "(no steps with duration for slow focus)" : "(no steps)"
-    );
-    return lines.join("\n");
-  }
-  for (const e of show) {
-    const prefix = e.slow ? "[slow] " : "";
-    const typeTag = e.type === "llm" ? "llm" : e.type === "tool" ? "tool" : e.type;
-    const dur = e.durationMs !== void 0 ? formatDuration(e.durationMs) : "-";
-    const err = e.isError ? " error" : "";
-    const off = formatDuration(e.offsetMs);
-    let line = `${prefix}+${off} ${typeTag}:${e.name} (${dur})${err}`;
-    if (e.streaming?.chunkCount !== void 0) {
-      line += ` chunks=${e.streaming.chunkCount}`;
-    }
-    if (e.streaming?.streamDurationMs !== void 0) {
-      line += ` stream=${formatDuration(e.streaming.streamDurationMs)}`;
-    }
-    lines.push(line);
-  }
-  return lines.join("\n");
-}
-
-// packages/core/src/what.ts
-function pickCorrelation2(metadata) {
-  if (!metadata) return void 0;
-  const out = {};
-  for (const key of [
-    "correlationId",
-    "requestId",
-    "decisionId",
-    "groupId"
-  ]) {
-    const value = metadata[key];
-    if (typeof value === "string" && value.trim() !== "") {
-      out[key] = value;
-    }
-  }
-  return Object.keys(out).length > 0 ? out : void 0;
-}
-function stepMixLine(summary) {
-  const parts = [];
-  if (summary.llmSteps > 0) parts.push(`${summary.llmSteps} LLM`);
-  if (summary.toolSteps > 0) parts.push(`${summary.toolSteps} tool`);
-  if (summary.logicSteps > 0) parts.push(`${summary.logicSteps} logic`);
-  return parts.length > 0 ? parts.join(", ") : "none";
-}
-function outcomeLine(summary) {
-  if (summary.status === "success") {
-    return summary.errorSteps > 0 ? "Completed with step errors recorded." : "Completed successfully.";
-  }
-  if (summary.status === "error") {
-    if (summary.failedStepNames.length > 0) {
-      const names = summary.failedStepNames.slice(0, 3).join(", ");
-      const suffix = summary.failedStepNames.length > 3 ? ` (+${summary.failedStepNames.length - 3} more)` : "";
-      return `Failed at step(s): ${names}${suffix}.`;
-    }
-    if (summary.runErrorMessage) {
-      return `Run failed: ${summary.runErrorMessage}`;
-    }
-    return "Run failed.";
-  }
-  if (summary.status === "running") {
-    return "Run is still in progress (no run_completed).";
-  }
-  return "Outcome unknown \u2014 inspect events may be incomplete.";
-}
-function buildRunWhatSummary(events) {
-  const base = buildRunSummary(events);
-  const started = events.find(
-    (e) => e.event === "run_started"
-  );
-  const completed = events.filter(
-    (e) => e.event === "run_completed"
-  );
-  const lastCompleted = completed[completed.length - 1];
-  const failedStepNames = [];
-  const stepNames = /* @__PURE__ */ new Map();
-  for (const e of events) {
-    if (e.event === "step_started") {
-      const s = e;
-      stepNames.set(s.stepId, s.name);
-    }
-  }
-  for (const e of events) {
-    if (e.event === "step_completed") {
-      const sc = e;
-      if (sc.status === "error") {
-        failedStepNames.push(stepNames.get(sc.stepId) ?? sc.stepId);
-      }
-    }
-  }
-  return {
-    runId: base.runId,
-    name: base.name,
-    status: base.status,
-    durationMs: base.durationMs,
-    totalSteps: base.totalSteps,
-    llmSteps: base.llmSteps,
-    toolSteps: base.toolSteps,
-    logicSteps: base.logicSteps,
-    errorSteps: base.errorSteps,
-    maxDepth: base.maxDepth,
-    longestStep: base.longestStep,
-    totalTokens: base.totalTokens,
-    correlation: pickCorrelation2(started?.metadata),
-    failedStepNames,
-    runErrorMessage: lastCompleted?.error?.message
-  };
-}
-function renderRunWhat(summary, options = {}) {
-  const showCorrelation = options.correlation !== false;
-  const lines = [];
-  const label = summary.name ?? summary.runId;
-  lines.push(`What: ${label}`);
-  const duration = summary.durationMs !== void 0 ? formatDuration(summary.durationMs) : "\u2014";
-  lines.push(
-    `Status: ${summary.status} \xB7 Duration: ${duration} \xB7 Steps: ${summary.totalSteps} (${stepMixLine(summary)})`
-  );
-  if (summary.totalTokens) {
-    const tokenParts = [
-      `${summary.totalTokens.input} in`,
-      `${summary.totalTokens.output} out`
-    ];
-    if (summary.totalTokens.total !== void 0) {
-      tokenParts.push(`${summary.totalTokens.total} total`);
-    }
-    if (summary.totalTokens.cached !== void 0) {
-      tokenParts.push(`${summary.totalTokens.cached} cached`);
-    }
-    lines.push(`Tokens: ${tokenParts.join(" / ")}`);
-  }
-  if (showCorrelation && summary.correlation) {
-    const parts = [];
-    if (summary.correlation.correlationId) {
-      parts.push(`correlationId=${summary.correlation.correlationId}`);
-    }
-    if (summary.correlation.requestId) {
-      parts.push(`requestId=${summary.correlation.requestId}`);
-    }
-    if (summary.correlation.decisionId) {
-      parts.push(`decisionId=${summary.correlation.decisionId}`);
-    }
-    if (summary.correlation.groupId) {
-      parts.push(`groupId=${summary.correlation.groupId}`);
-    }
-    if (parts.length > 0) {
-      lines.push(`Correlation: ${parts.join(", ")}`);
-    }
-  }
-  lines.push(`Outcome: ${outcomeLine(summary)}`);
-  if (summary.longestStep && summary.totalSteps > 0) {
-    lines.push(
-      `Slowest: ${summary.longestStep.name} (${formatDuration(summary.longestStep.durationMs)}, ${summary.longestStep.type})`
-    );
-  }
-  if (summary.maxDepth > 0) {
-    lines.push(`Max depth: ${summary.maxDepth}`);
-  }
-  return lines.join("\n");
-}
-
-// packages/core/src/report.ts
-function resolveTree(events, profile) {
-  const tree = manualTraceEventsToRunTree(events);
-  return profile === "local" ? tree : redactRunTreeForExport(tree, { redactionProfile: profile });
-}
-function tailMarkdownSection(content, heading) {
-  const marker = `## ${heading}`;
-  const idx = content.indexOf(marker);
-  if (idx < 0) return "";
-  return content.slice(idx).trimEnd();
-}
-function extractHtmlFragment(content, start, end) {
-  const startIdx = content.indexOf(start);
-  if (startIdx < 0) return "";
-  const endIdx = content.indexOf(end, startIdx + start.length);
-  if (endIdx < 0) return content.slice(startIdx);
-  return content.slice(startIdx, endIdx);
-}
-var REPORT_HTML_CSS = `
-body{font-family:system-ui,sans-serif;line-height:1.5;margin:1.5rem;max-width:960px;color:#111}
-h1{font-size:1.35rem}
-h2{font-size:1.1rem;margin-top:1.5rem}
-pre{white-space:pre-wrap;background:#f8f8f8;padding:0.75rem;overflow:auto;font-size:0.9rem}
-ul.tree{list-style:none;padding-left:1rem}
-ul.tree.nested{padding-left:1.25rem;border-left:1px solid #ddd;margin:0.25rem 0}
-.nm{font-weight:600}
-.meta{color:#555;font-size:0.9rem}
-footer{margin-top:2rem;font-size:0.85rem;color:#555}
-`.trim();
-function buildRunReport(events, options) {
-  const profile = options.redactionProfile ?? "local";
-  const safeEvents = redactTraceEventsForReport(events, {
-    redactionProfile: profile
-  });
-  const whatSummary = buildRunWhatSummary(safeEvents);
-  const whatText = renderRunWhat(whatSummary, {
-    correlation: options.correlation !== false
-  });
-  const timelineText = renderTimeline(buildRunTimeline(safeEvents));
-  const tree = resolveTree(safeEvents, profile);
-  const exportOpts = {
-    includeMetadata: false,
-    includeAttributes: options.includeAttributes === true,
-    includeErrors: options.includeErrors !== false,
-    redacted: true,
-    redactionProfile: profile,
-    maxAttributeLength: 500
-  };
-  if (options.format === "markdown") {
-    const treeMd = exportMarkdown(tree, exportOpts);
-    const tail = tailMarkdownSection(treeMd.content, "Execution tree");
-    const title2 = escapeMarkdown(whatSummary.name ?? whatSummary.runId);
-    const lines = [
-      `# AgentInspect Report: ${title2}`,
-      "",
-      "Generated locally by AgentInspect. Review for sensitive data before sharing.",
-      "",
-      "## What happened",
-      "",
-      "```text",
-      whatText,
-      "```",
-      "",
-      "## Timeline",
-      "",
-      "```text",
-      timelineText,
-      "```",
-      ""
-    ];
-    if (tail) {
-      lines.push(tail, "");
-    } else {
-      lines.push("## Execution tree", "", "(no steps)", "");
-    }
-    return {
-      format: "markdown",
-      content: lines.join("\n"),
-      contentType: "text/markdown",
-      fileExtension: ".md"
-    };
-  }
-  const treeHtml = exportHtml(tree, exportOpts);
-  const title = escapeHtml(whatSummary.name ?? whatSummary.runId);
-  const treeSection = extractHtmlFragment(
-    treeHtml.content,
-    '<section class="tree">',
-    "</section>"
-  );
-  const errorsSection = treeHtml.content.includes("<h2>Errors</h2>") ? extractHtmlFragment(treeHtml.content, "<h2>Errors</h2>", "<footer>") : "";
-  const attrsSection = treeHtml.content.includes("<h2>Attributes (bounded)</h2>") ? extractHtmlFragment(
-    treeHtml.content,
-    "<h2>Attributes (bounded)</h2>",
-    "<footer>"
-  ) : "";
-  const html = `<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8"/>
-<meta name="viewport" content="width=device-width, initial-scale=1"/>
-<title>AgentInspect Report: ${title}</title>
-<style>${REPORT_HTML_CSS}</style>
-</head>
-<body>
-<header><h1>AgentInspect Report: ${title}</h1></header>
-<p class="note">Generated locally by AgentInspect. Review for sensitive data before sharing.</p>
-<section class="what"><h2>What happened</h2><pre>${escapeHtml(whatText)}</pre></section>
-<section class="timeline"><h2>Timeline</h2><pre>${escapeHtml(timelineText)}</pre></section>
-${treeSection || '<section class="tree"><h2>Execution tree</h2><p>No steps recorded.</p></section>'}
-${errorsSection}
-${attrsSection}
-<footer>Generated locally by AgentInspect. Review for sensitive data before sharing.</footer>
-</body>
-</html>`;
-  return {
-    format: "html",
-    content: html,
-    contentType: "text/html",
-    fileExtension: ".html"
-  };
-}
-
-// packages/core/src/explain.ts
-function flatten(nodes, out = []) {
-  for (const node of nodes) {
-    out.push({ node, index: out.length + 1 });
-    flatten(node.children, out);
-  }
-  return out;
-}
-function redactValue(redactor, key, value) {
-  return redactor.redactValue(key, value);
-}
-function fact(id, label, value, redactor) {
-  return {
-    id,
-    label,
-    value: redactValue(redactor, id.split(".").at(-1) ?? id, value),
-    source: "trace",
-    confidence: "observed"
-  };
-}
-function topKinds(run) {
-  return Object.entries(run.metadata.kinds).filter(([, count]) => count > 0).sort((a, b) => {
-    if (b[1] !== a[1]) return b[1] - a[1];
-    return a[0].localeCompare(b[0]);
-  }).slice(0, 5).map(([kind, count]) => `${kind}:${count}`);
-}
-function countErrorNodes(nodes) {
-  return nodes.filter((entry) => entry.node.event.status === "error").length;
-}
-function slowestNode(nodes) {
-  return nodes.filter((entry) => entry.node.event.durationMs !== void 0).sort((a, b) => {
-    const delta = (b.node.event.durationMs ?? 0) - (a.node.event.durationMs ?? 0);
-    return delta !== 0 ? delta : a.index - b.index;
-  })[0];
-}
-function attributeFacts(nodes, redactor) {
-  const facts = [];
-  for (const entry of nodes) {
-    const attrs = entry.node.event.attributes;
-    if (attrs === void 0) continue;
-    for (const key of Object.keys(attrs).sort()) {
-      facts.push({
-        id: `node.${entry.index}.attributes.${key}`,
-        label: `${entry.node.event.name} attribute ${key}`,
-        value: redactValue(redactor, key, attrs[key]),
-        source: "trace",
-        confidence: "observed"
-      });
-      if (facts.length >= 8) return facts;
-    }
-  }
-  return facts;
-}
-function buildFacts(run, redactor) {
-  const nodes = flatten(run.children);
-  const facts = [
-    fact("run.id", "Run id", run.runId, redactor),
-    fact("run.name", "Run name", run.name ?? run.runId, redactor),
-    fact("run.status", "Run status", run.status ?? "unknown", redactor),
-    fact("run.totalEvents", "Total events", run.metadata.totalEvents, redactor),
-    fact("run.stepCount", "Top-level step count", run.children.length, redactor),
-    fact("run.nodeCount", "Total node count", nodes.length, redactor),
-    fact("run.errorNodeCount", "Error node count", countErrorNodes(nodes), redactor),
-    fact("run.kinds", "Observed kind mix", topKinds(run), redactor)
-  ];
-  if (run.durationMs !== void 0) {
-    facts.push(fact("run.durationMs", "Run duration milliseconds", run.durationMs, redactor));
-  }
-  const slowest = slowestNode(nodes);
-  if (slowest !== void 0) {
-    facts.push(
-      fact("run.slowestNode", "Slowest observed node", {
-        name: slowest.node.event.name,
-        kind: slowest.node.event.kind,
-        durationMs: slowest.node.event.durationMs
-      }, redactor)
-    );
-  }
-  facts.push(...attributeFacts(nodes, redactor));
-  return facts;
-}
-function buildInferences(run, facts) {
-  const inferences = [];
-  const errorFact = facts.find((item) => item.id === "run.errorNodeCount");
-  const kindFact = facts.find((item) => item.id === "run.kinds");
-  const durationFact = facts.find((item) => item.id === "run.durationMs");
-  const errorNodeCount = typeof errorFact?.value === "number" ? errorFact.value : 0;
-  if (run.status === "error" || errorNodeCount > 0) {
-    inferences.push({
-      id: "outcome.error",
-      label: "Outcome",
-      text: "The run recorded an error status or at least one error node.",
-      evidence: ["run.status", "run.errorNodeCount"],
-      confidence: "deterministic"
-    });
-  } else if (run.status === "ok") {
-    inferences.push({
-      id: "outcome.success",
-      label: "Outcome",
-      text: "The run completed without observed error nodes.",
-      evidence: ["run.status", "run.errorNodeCount"],
-      confidence: "deterministic"
-    });
-  }
-  if (kindFact !== void 0) {
-    inferences.push({
-      id: "shape.kind-mix",
-      label: "Trace shape",
-      text: "The explanation is based on the observed event kind mix, not generated content.",
-      evidence: [kindFact.id],
-      confidence: "deterministic"
-    });
-  }
-  if (durationFact !== void 0) {
-    inferences.push({
-      id: "timing.duration",
-      label: "Timing",
-      text: "Timing claims are limited to persisted duration fields in the trace.",
-      evidence: [durationFact.id],
-      confidence: "deterministic"
-    });
-  }
-  return inferences;
-}
-function buildLocalExplanation(run, options = {}) {
-  const redactionProfile = options.redactionProfile ?? "local";
-  const resolved = resolveRedactionProfile(redactionProfile);
-  const redactor = new Redactor({ extraKeys: resolved.extraKeys });
-  const mode = options.mode ?? "local";
-  const facts = buildFacts(run, redactor);
-  return {
-    mode,
-    runId: String(redactValue(redactor, "runId", run.runId)),
-    ...run.name !== void 0 ? { name: String(redactValue(redactor, "name", run.name)) } : {},
-    ...run.status !== void 0 ? { status: run.status } : {},
-    redactionProfile,
-    facts,
-    inferences: mode === "dry-run" ? [] : buildInferences(run, facts),
-    notes: [
-      "Generated locally without provider or network calls.",
-      "Facts are observed from normalized trace data; inferences are deterministic labels."
-    ]
-  };
-}
-
-// packages/core/src/stats.ts
-function percentile(sorted, p) {
-  if (sorted.length === 0) return void 0;
-  const idx = Math.min(
-    sorted.length - 1,
-    Math.max(0, Math.ceil(p / 100 * sorted.length) - 1)
-  );
-  return sorted[idx];
-}
-async function readRunStartedMetadata(filePath) {
-  try {
-    const events = await readTraceEventsFromFile(filePath);
-    for (const event of events) {
-      if (event.event !== "run_started") continue;
-      const rs = event;
-      if (rs.metadata && typeof rs.metadata === "object") {
-        return rs.metadata;
-      }
-      return void 0;
-    }
-  } catch {
-  }
-  return void 0;
-}
-function metaMatchesCorrelation(metadata, correlationId, groupId) {
-  if (correlationId) {
-    const v = metadata?.correlationId;
-    if (typeof v !== "string" || v !== correlationId) return false;
-  }
-  if (groupId) {
-    const v = metadata?.groupId;
-    if (typeof v !== "string" || v !== groupId) return false;
-  }
-  return true;
-}
-async function buildTraceStats(metas, options) {
-  let filtered = filterTraces(metas, { since: options.since });
-  if (options.correlationId || options.groupId) {
-    const next = [];
-    for (const m of filtered) {
-      const md = await readRunStartedMetadata(m.filePath);
-      if (metaMatchesCorrelation(md, options.correlationId, options.groupId)) {
-        next.push(m);
-      }
-    }
-    filtered = next;
-  }
-  let successCount = 0;
-  let errorCount = 0;
-  let runningCount = 0;
-  let unknownCount = 0;
-  const durations = [];
-  let totalSteps = 0;
-  let totalLlmSteps = 0;
-  let totalToolSteps = 0;
-  let totalErrorSteps = 0;
-  const slowestRuns = [];
-  const slowestSteps = [];
-  for (const m of filtered) {
-    if (m.status === "success") successCount += 1;
-    else if (m.status === "error") errorCount += 1;
-    else if (m.status === "running") runningCount += 1;
-    else unknownCount += 1;
-    if (typeof m.durationMs === "number" && Number.isFinite(m.durationMs) && m.durationMs >= 0) {
-      durations.push(m.durationMs);
-      slowestRuns.push({
-        runId: m.runId,
-        name: m.name,
-        durationMs: m.durationMs,
-        status: m.status
-      });
-    }
-    try {
-      const events = await readTraceEventsFromFile(m.filePath);
-      if (events.length === 0) continue;
-      const summary = buildRunSummary(events);
-      totalSteps += summary.totalSteps;
-      totalLlmSteps += summary.llmSteps;
-      totalToolSteps += summary.toolSteps;
-      totalErrorSteps += summary.errorSteps;
-      const steps = collectCompletedSteps(events, m.runId);
-      for (const s of steps) {
-        slowestSteps.push(s);
-      }
-    } catch {
-    }
-  }
-  slowestRuns.sort((a, b) => (b.durationMs ?? 0) - (a.durationMs ?? 0));
-  slowestSteps.sort((a, b) => b.durationMs - a.durationMs);
-  const runLimit = options.slowRunLimit ?? 5;
-  const stepLimit = options.slowStepLimit ?? 5;
-  const sortedDur = [...durations].sort((a, b) => a - b);
-  const totalRuns = filtered.length;
-  const errorRate = totalRuns > 0 ? errorCount / totalRuns : 0;
-  const sumDur = durations.reduce((a, b) => a + b, 0);
-  return {
-    traceDir: options.traceDir,
-    ...options.since ? { since: options.since } : {},
-    ...options.correlationId ? { correlationId: options.correlationId } : {},
-    ...options.groupId ? { groupId: options.groupId } : {},
-    totalRuns,
-    successCount,
-    errorCount,
-    runningCount,
-    unknownCount,
-    errorRate,
-    duration: {
-      ...sortedDur.length > 0 ? {
-        minMs: sortedDur[0],
-        maxMs: sortedDur[sortedDur.length - 1],
-        avgMs: sumDur / sortedDur.length,
-        p50Ms: percentile(sortedDur, 50),
-        p95Ms: percentile(sortedDur, 95)
-      } : {}
-    },
-    totalSteps,
-    avgStepsPerRun: totalRuns > 0 ? totalSteps / totalRuns : 0,
-    totalLlmSteps,
-    totalToolSteps,
-    totalErrorSteps,
-    slowestRuns: slowestRuns.slice(0, runLimit),
-    slowestSteps: slowestSteps.slice(0, stepLimit)
-  };
-}
-function collectCompletedSteps(events, runId) {
-  const started = /* @__PURE__ */ new Map();
-  const out = [];
-  for (const e of events) {
-    if (e.event === "step_started") {
-      const s = e;
-      started.set(s.stepId, { name: s.name, type: s.type });
-    }
-    if (e.event === "step_completed") {
-      const c = e;
-      if (c.status !== "success" && c.status !== "error") continue;
-      if (typeof c.durationMs !== "number" || !Number.isFinite(c.durationMs)) {
-        continue;
-      }
-      const meta = started.get(c.stepId);
-      out.push({
-        runId,
-        stepName: meta?.name ?? c.stepId,
-        stepType: meta?.type ?? "logic",
-        durationMs: c.durationMs
-      });
-    }
-  }
-  return out;
-}
-function renderTraceStats(stats) {
-  const lines = [];
-  lines.push("Trace stats (local)");
-  lines.push(`Directory: ${stats.traceDir}`);
-  if (stats.since) lines.push(`Since: ${stats.since}`);
-  if (stats.correlationId) lines.push(`Correlation ID: ${stats.correlationId}`);
-  if (stats.groupId) lines.push(`Group ID: ${stats.groupId}`);
-  lines.push("");
-  lines.push(`Runs: ${stats.totalRuns}`);
-  lines.push(
-    `  success: ${stats.successCount}  error: ${stats.errorCount}  running: ${stats.runningCount}  unknown: ${stats.unknownCount}`
-  );
-  lines.push(`Error rate: ${(stats.errorRate * 100).toFixed(1)}%`);
-  if (stats.duration.avgMs !== void 0) {
-    lines.push(
-      `Duration: min ${formatDuration(stats.duration.minMs ?? 0)} | avg ${formatDuration(stats.duration.avgMs)} | p50 ${formatDuration(stats.duration.p50Ms ?? 0)} | p95 ${formatDuration(stats.duration.p95Ms ?? 0)} | max ${formatDuration(stats.duration.maxMs ?? 0)}`
-    );
-  }
-  lines.push("");
-  lines.push(`Steps: ${stats.totalSteps} (avg ${stats.avgStepsPerRun.toFixed(1)} per run)`);
-  lines.push(
-    `  LLM: ${stats.totalLlmSteps}  tool: ${stats.totalToolSteps}  errors: ${stats.totalErrorSteps}`
-  );
-  if (stats.slowestRuns.length > 0) {
-    lines.push("");
-    lines.push("Slowest runs:");
-    for (const r of stats.slowestRuns) {
-      lines.push(
-        `  ${r.runId} | ${r.name ?? "-"} | ${formatDuration(r.durationMs ?? 0)} | ${r.status}`
-      );
-    }
-  }
-  if (stats.slowestSteps.length > 0) {
-    lines.push("");
-    lines.push("Slowest steps:");
-    for (const s of stats.slowestSteps) {
-      lines.push(
-        `  ${s.runId} | ${s.stepType}:${s.stepName} | ${formatDuration(s.durationMs)}`
-      );
-    }
-  }
-  return lines.join("\n");
-}
-
-// packages/core/src/search.ts
-function parseDurationFilter(expr) {
-  const raw = expr.trim();
-  const m = raw.match(/^(>=|<=|>|<)\s*(.+)$/);
-  if (!m) {
-    throw new Error(
-      `Invalid --duration "${expr}". Use forms like >5s, >=500ms, <2m.`
-    );
-  }
-  const op = m[1];
-  const ms = parseDuration(m[2].trim());
-  return { op, ms };
-}
-function durationMatches(valueMs, filter) {
-  if (valueMs === void 0 || !Number.isFinite(valueMs)) return false;
-  switch (filter.op) {
-    case ">":
-      return valueMs > filter.ms;
-    case ">=":
-      return valueMs >= filter.ms;
-    case "<":
-      return valueMs < filter.ms;
-    case "<=":
-      return valueMs <= filter.ms;
-    default:
-      return false;
-  }
-}
-function normalizeStepTypeFilter(kind, type) {
-  const v = (kind ?? type)?.trim().toLowerCase();
-  return v && v !== "" ? v : void 0;
-}
-function nameMatches(hay, needle) {
-  return hay.toLowerCase().includes(needle.toLowerCase());
-}
-async function searchTraces(metas, options) {
-  let filtered = filterTraces(metas, { since: options.since });
-  const stepTypeFilter = normalizeStepTypeFilter(options.kind, options.type);
-  const nameQuery = options.name?.trim();
-  const toolQuery = options.tool?.trim();
-  let durationFilter;
-  if (options.duration) {
-    durationFilter = parseDurationFilter(options.duration);
-  }
-  const limit = options.limit ?? 50;
-  const hasContentFilter = Boolean(
-    options.status || stepTypeFilter || nameQuery || toolQuery || durationFilter
-  );
-  const results = [];
-  if (!hasContentFilter) {
-    for (const m of filtered) {
-      results.push({
-        runId: m.runId,
-        runName: m.name,
-        runStatus: m.status,
-        timestamp: m.startedAt,
-        durationMs: m.durationMs,
-        matchReason: "trace in directory",
-        matchedFields: ["run"],
-        filePath: m.filePath
-      });
-    }
-    return results.slice(0, limit);
-  }
-  for (const m of filtered) {
-    if (options.status && m.status !== options.status) continue;
-    let events = [];
-    try {
-      events = await readTraceEventsFromFile(m.filePath);
-    } catch {
-      continue;
-    }
-    if (events.length === 0) continue;
-    const runMatches = matchRunLevel(m, {
-      stepTypeFilter,
-      nameQuery,
-      toolQuery,
-      durationFilter,
-      statusFilter: options.status
-    });
-    results.push(...runMatches);
-    const stepMatches = matchStepLevel(m, events, {
-      stepTypeFilter,
-      nameQuery,
-      toolQuery,
-      durationFilter,
-      statusFilter: options.status
-    });
-    results.push(...stepMatches);
-  }
-  results.sort((a, b) => {
-    const ta = a.timestamp ?? 0;
-    const tb = b.timestamp ?? 0;
-    if (ta !== tb) return ta - tb;
-    const runCmp = a.runId.localeCompare(b.runId);
-    if (runCmp !== 0) return runCmp;
-    return (a.stepName ?? "").localeCompare(b.stepName ?? "");
-  });
-  return results.slice(0, limit);
-}
-function matchRunLevel(m, opts) {
-  if (opts.stepTypeFilter || opts.toolQuery) return [];
-  const out = [];
-  const fields = [];
-  if (opts.statusFilter && m.status === opts.statusFilter) {
-    fields.push("run.status");
-  }
-  if (opts.nameQuery && nameMatches(m.name ?? m.runId, opts.nameQuery)) {
-    fields.push("run.name");
-  }
-  if (opts.durationFilter && durationMatches(m.durationMs, opts.durationFilter)) {
-    fields.push("run.durationMs");
-  }
-  if (fields.length === 0) return out;
-  out.push({
-    runId: m.runId,
-    runName: m.name,
-    runStatus: m.status,
-    timestamp: m.startedAt,
-    durationMs: m.durationMs,
-    matchReason: `run match: ${fields.join(", ")}`,
-    matchedFields: fields,
-    filePath: m.filePath
-  });
-  return out;
-}
-function matchStepLevel(m, events, opts) {
-  const out = [];
-  const started = /* @__PURE__ */ new Map();
-  for (const e of events) {
-    if (e.event === "step_started") {
-      started.set(e.stepId, e);
-    }
-  }
-  for (const e of events) {
-    if (e.event !== "step_completed") continue;
-    const c = e;
-    const s = started.get(c.stepId);
-    if (!s) continue;
-    const fields = [];
-    const stepType = s.type;
-    if (opts.stepTypeFilter && stepType !== opts.stepTypeFilter) {
-      continue;
-    }
-    const hasStepFilters = opts.stepTypeFilter || opts.nameQuery || opts.toolQuery || opts.durationFilter || opts.statusFilter === "error" || opts.statusFilter === "success";
-    if (!hasStepFilters) continue;
-    if (opts.statusFilter === "error" && c.status === "error") {
-      fields.push("step.status");
-    } else if (opts.statusFilter === "success" && c.status === "success") {
-      fields.push("step.status");
-    } else if (opts.statusFilter === "error" || opts.statusFilter === "success") {
-      continue;
-    }
-    if (opts.nameQuery) {
-      if (!nameMatches(s.name, opts.nameQuery)) continue;
-      fields.push("step.name");
-    }
-    if (opts.toolQuery) {
-      const toolName = typeof s.metadata?.toolName === "string" ? s.metadata.toolName : s.name;
-      if (!nameMatches(toolName, opts.toolQuery)) continue;
-      fields.push("step.tool");
-    }
-    if (opts.durationFilter) {
-      if (!durationMatches(c.durationMs, opts.durationFilter)) continue;
-      fields.push("step.durationMs");
-    }
-    if (opts.stepTypeFilter) {
-      fields.push("step.type");
-    }
-    if (fields.length === 0) continue;
-    out.push({
-      runId: m.runId,
-      runName: m.name,
-      runStatus: m.status,
-      stepId: c.stepId,
-      stepName: s.name,
-      stepType,
-      timestamp: s.startTime ?? s.timestamp,
-      durationMs: c.durationMs,
-      matchReason: `step match: ${fields.join(", ")}`,
-      matchedFields: fields,
-      filePath: m.filePath
-    });
-  }
-  return out;
-}
-async function loadTraceMetadataList(_traceDir, fileNames, getPath) {
-  const metas = [];
-  for (const fileName of fileNames) {
-    try {
-      const filePath = getPath(fileName);
-      const meta = await extractMetadata(filePath);
-      metas.push(meta);
-    } catch {
-    }
-  }
-  return metas;
-}
-var KNOWN_EVENTS = /* @__PURE__ */ new Set([
-  "run_started",
-  "run_completed",
-  "step_started",
-  "step_completed"
-]);
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function safeParse(line) {
-  try {
-    return JSON.parse(line);
-  } catch {
-    return void 0;
-  }
-}
-async function isAgentInspectTrace(filePath) {
-  try {
-    const rl = createInterface({
-      input: createReadStream(filePath, { encoding: "utf8" }),
-      crlfDelay: Infinity
-    });
-    let checked = 0;
-    for await (const line of rl) {
-      const trimmed = line.trim();
-      if (trimmed === "") continue;
-      const parsed = safeParse(trimmed);
-      if (!parsed) continue;
-      if (!isRecord(parsed)) continue;
-      checked += 1;
-      if (isTraceEvent(parsed)) return true;
-      const ev = parsed.event;
-      const runId = parsed.runId;
-      if (typeof ev === "string" && KNOWN_EVENTS.has(ev) && typeof runId === "string") {
-        return true;
-      }
-      if (checked >= 20) break;
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-
-// packages/core/src/inspect-run.ts
-function normalizeRunName(name) {
-  if (typeof name !== "string" || name.trim() === "") {
-    return "unnamed-run";
-  }
-  return truncateName(name.trim(), 100);
-}
-async function safeInstrumentation(label, op) {
-  try {
-    await Promise.resolve(op());
-  } catch (e) {
-    warn(`inspectRun: ${label}`, e);
-  }
-}
-async function inspectRun(name, fn, options) {
-  if (typeof fn !== "function") {
-    throw new TypeError("inspectRun requires `fn` to be a function");
-  }
-  if (options?.enabled === false) {
-    return Promise.resolve(fn());
-  }
-  const runName = normalizeRunName(name);
-  const runId = createRunId();
-  const traceDir = resolveTraceDir({ dir: options?.traceDir });
-  const traceSafety = resolveTraceSafetyOptions(options);
-  const runMetadata = buildRunStartedMetadata(options);
-  const context = {
-    runId,
-    runName,
-    traceDir,
-    silent: options?.silent ?? false,
-    metadata: runMetadata
-  };
-  return runWithContext(context, async () => {
-    const startTime = Date.now();
-    let traceFilePath;
-    await safeInstrumentation("initializeTraceFile", async () => {
-      traceFilePath = await initializeTraceFile(runId, traceDir);
-    });
-    await safeInstrumentation("writeTraceEvent(run_started)", async () => {
-      const started = {
-        schemaVersion: "0.1",
-        event: "run_started",
-        timestamp: startTime,
-        runId,
-        name: runName,
-        startTime,
-        ...runMetadata !== void 0 ? { metadata: runMetadata } : {}
-      };
-      await writeTraceEvent(
-        prepareTraceEventForDisk(started, traceSafety),
-        traceDir
-      );
-    });
-    await safeInstrumentation("printRunStart", () => {
-      printRunStart(runId, runName);
-    });
-    let result;
-    try {
-      result = await Promise.resolve(fn());
-    } catch (userError) {
-      const endTime2 = Date.now();
-      const durationMs2 = endTime2 - startTime;
-      const formatted = formatError(userError);
-      const printPath2 = traceFilePath ?? getTraceFilePath(runId, traceDir);
-      await safeInstrumentation("writeTraceEvent(run_completed error)", async () => {
-        const completed = {
-          schemaVersion: "0.1",
-          event: "run_completed",
-          timestamp: endTime2,
-          runId,
-          status: "error",
-          endTime: endTime2,
-          durationMs: durationMs2,
-          error: formatted
-        };
-        await writeTraceEvent(
-          prepareTraceEventForDisk(completed, traceSafety),
-          traceDir
-        );
-      });
-      await safeInstrumentation("printRunComplete(error)", () => {
-        printRunComplete(runName, runId, durationMs2, "error", printPath2);
-      });
-      throw userError;
-    }
-    const endTime = Date.now();
-    const durationMs = endTime - startTime;
-    const printPath = traceFilePath ?? getTraceFilePath(runId, traceDir);
-    await safeInstrumentation("writeTraceEvent(run_completed success)", async () => {
-      const completed = {
-        schemaVersion: "0.1",
-        event: "run_completed",
-        timestamp: endTime,
-        runId,
-        status: "success",
-        endTime,
-        durationMs
-      };
-      await writeTraceEvent(
-        prepareTraceEventForDisk(completed, traceSafety),
-        traceDir
-      );
-    });
-    await safeInstrumentation("printRunComplete(success)", () => {
-      printRunComplete(runName, runId, durationMs, "success", printPath);
-    });
-    return result;
-  }, traceSafety);
-}
-
-// packages/core/src/maybe-inspect-run.ts
-var ENABLED_ENV_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on", "enabled"]);
-function isAgentInspectEnabled(value) {
-  if (value === void 0) return false;
-  const normalized = value.trim().toLowerCase();
-  if (normalized === "") return false;
-  return ENABLED_ENV_VALUES.has(normalized);
-}
-async function maybeInspectRun(name, fn, options) {
-  if (typeof fn !== "function") {
-    throw new TypeError("maybeInspectRun requires `fn` to be a function");
-  }
-  const enabled = options?.enabled !== void 0 ? options.enabled : isAgentInspectEnabled(process.env.AGENT_INSPECT);
-  if (!enabled) {
-    return Promise.resolve(fn());
-  }
-  return inspectRun(name, fn, options);
-}
 
 // packages/core/src/step.ts
 function normalizeStepName(name) {
@@ -1476,7 +16,7 @@ function normalizeStepName(name) {
   }
   return truncateName(name.trim(), 100);
 }
-async function safeInstrumentation2(label, op) {
+async function safeInstrumentation(label, op) {
   try {
     await Promise.resolve(op());
   } catch (e) {
@@ -1500,7 +40,7 @@ async function stepImpl(name, fn, options) {
   const metadata = options?.metadata;
   const traceSafety = getTraceSafetyFromContext();
   const startTime = Date.now();
-  await safeInstrumentation2("writeTraceEvent(step_started)", async () => {
+  await safeInstrumentation("writeTraceEvent(step_started)", async () => {
     const started = {
       schemaVersion: "0.1",
       event: "step_started",
@@ -1516,7 +56,7 @@ async function stepImpl(name, fn, options) {
     const safe = traceSafety !== void 0 ? prepareTraceEventForDisk(started, traceSafety) : started;
     await writeTraceEvent(safe, context.traceDir);
   });
-  await safeInstrumentation2("printStepStart", () => {
+  await safeInstrumentation("printStepStart", () => {
     printStepStart(stepName, renderDepth);
   });
   let result;
@@ -1528,7 +68,7 @@ async function stepImpl(name, fn, options) {
     const endTime2 = Date.now();
     const durationMs2 = endTime2 - startTime;
     const formatted = formatError(userError);
-    await safeInstrumentation2("writeTraceEvent(step_completed error)", async () => {
+    await safeInstrumentation("writeTraceEvent(step_completed error)", async () => {
       const completed = {
         schemaVersion: "0.1",
         event: "step_completed",
@@ -1543,20 +83,20 @@ async function stepImpl(name, fn, options) {
       const safe = traceSafety !== void 0 ? prepareTraceEventForDisk(completed, traceSafety) : completed;
       await writeTraceEvent(safe, context.traceDir);
     });
-    await safeInstrumentation2("printStepComplete(error)", () => {
+    await safeInstrumentation("printStepComplete(error)", () => {
       printStepComplete(stepName, durationMs2, "error", renderDepth);
     });
-    await safeInstrumentation2("printError", () => {
+    await safeInstrumentation("printError", () => {
       printError(formatted, renderDepth);
     });
-    await safeInstrumentation2("printFailedAt", () => {
+    await safeInstrumentation("printFailedAt", () => {
       printFailedAt(stepName);
     });
     throw userError;
   }
   const endTime = Date.now();
   const durationMs = endTime - startTime;
-  await safeInstrumentation2("writeTraceEvent(step_completed success)", async () => {
+  await safeInstrumentation("writeTraceEvent(step_completed success)", async () => {
     const completed = {
       schemaVersion: "0.1",
       event: "step_completed",
@@ -1570,7 +110,7 @@ async function stepImpl(name, fn, options) {
     const safe = traceSafety !== void 0 ? prepareTraceEventForDisk(completed, traceSafety) : completed;
     await writeTraceEvent(safe, context.traceDir);
   });
-  await safeInstrumentation2("printStepComplete(success)", () => {
+  await safeInstrumentation("printStepComplete(success)", () => {
     printStepComplete(stepName, durationMs, "success", renderDepth);
   });
   return result;
@@ -1668,6 +208,6 @@ function observe(agent, options) {
   }
 }
 
-export { TraceDirectory, buildLocalExplanation, buildRunReport, buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildTraceStats, extractMetadata, filterTraces, inspectRun, isAgentInspectEnabled, isAgentInspectTrace, loadTraceMetadataList, maybeInspectRun, observe, parseDurationFilter, renderRunWhat, renderTimeline, renderTraceStats, resolveTraceDir, searchTraces, step };
+export { observe, step };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map