agent-inspect 6.10.0 → 6.12.0

package/packages/cli/dist/index.cjs

@@ -4,7 +4,7 @@
 var crypto = require('crypto');
 var promises = require('fs/promises');
 var os = require('os');
-var path29 = require('path');
+var path30 = require('path');
 var async_hooks = require('async_hooks');
 var process3 = require('process');
 var tty = require('tty');
@@ -20,7 +20,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var crypto__default = /*#__PURE__*/_interopDefault(crypto);
 var os__default = /*#__PURE__*/_interopDefault(os);
-var path29__default = /*#__PURE__*/_interopDefault(path29);
+var path30__default = /*#__PURE__*/_interopDefault(path30);
 var process3__default = /*#__PURE__*/_interopDefault(process3);
 var tty__default = /*#__PURE__*/_interopDefault(tty);
 
@@ -864,7 +864,7 @@ function getDefaultTraceDir() {
     if (typeof home !== "string" || home.trim() === "") {
       return FALLBACK_TRACE_DIR;
     }
-    return path29__default.default.join(home, DEFAULT_TRACE_DIR_NAME, RUNS_DIR_NAME);
+    return path30__default.default.join(home, DEFAULT_TRACE_DIR_NAME, RUNS_DIR_NAME);
   } catch {
     return FALLBACK_TRACE_DIR;
   }
@@ -872,11 +872,11 @@ function getDefaultTraceDir() {
 function getTraceFilePath(runId, traceDir) {
   const baseDir = traceDir ?? getDefaultTraceDir();
   let safeId = typeof runId === "string" && runId.trim() !== "" ? runId.trim() : "run_unknown";
-  safeId = path29__default.default.basename(safeId);
+  safeId = path30__default.default.basename(safeId);
   if (safeId === "" || safeId === "." || safeId === "..") {
     safeId = "run_unknown";
   }
-  return path29__default.default.join(baseDir, `${safeId}.jsonl`);
+  return path30__default.default.join(baseDir, `${safeId}.jsonl`);
 }
 function formatError(error) {
   if (error instanceof Error) {
@@ -933,7 +933,7 @@ var init_utils = __esm({
     init_duration();
     DEFAULT_TRACE_DIR_NAME = ".agent-inspect";
     RUNS_DIR_NAME = "runs";
-    FALLBACK_TRACE_DIR = path29__default.default.join(
+    FALLBACK_TRACE_DIR = path30__default.default.join(
       os__default.default.tmpdir(),
       "agent-inspect",
       RUNS_DIR_NAME
@@ -1899,7 +1899,7 @@ var init_trace_directory = __esm({
         this.#dir = resolveTraceDir(options);
       }
       getPath(filename) {
-        return filename ? path29__default.default.join(this.#dir, filename) : this.#dir;
+        return filename ? path30__default.default.join(this.#dir, filename) : this.#dir;
       }
       async list() {
         try {
@@ -1928,7 +1928,7 @@ function parseIsoToMs2(value) {
 }
 async function extractMetadata(filePath, _quickScan) {
   const stats = await promises.stat(filePath);
-  let runIdFromFile = path29__default.default.basename(filePath);
+  let runIdFromFile = path30__default.default.basename(filePath);
   if (runIdFromFile.endsWith(".jsonl")) {
     runIdFromFile = runIdFromFile.slice(0, -".jsonl".length);
   }
@@ -2720,6 +2720,14 @@ var init_what = __esm({
   }
 });
 
+// packages/core/src/causal-failure.ts
+var init_causal_failure = __esm({
+  "packages/core/src/causal-failure.ts"() {
+    init_extract();
+    init_timeline();
+  }
+});
+
 // packages/core/src/explain.ts
 function toDisplayStatus(status) {
   if (status === "ok") return "success";
@@ -3773,12 +3781,12 @@ function buildCriticalPath(runs, handoffs) {
     handoffs.filter((edge) => edge.confidence === "explicit").map((edge) => edge.from)
   );
   const ordered = [...runs].sort(compareRuns);
-  const path40 = [];
+  const path41 = [];
   const visited = /* @__PURE__ */ new Set();
   const pushRun = (run, confidence, source) => {
     if (visited.has(run.runId)) return;
     visited.add(run.runId);
-    path40.push({
+    path41.push({
       runId: run.runId,
       name: run.name,
       startedAt: run.startedAt,
@@ -3803,7 +3811,7 @@ function buildCriticalPath(runs, handoffs) {
     const confidence = explicitTargets.has(run.runId) || explicitSources.has(run.runId) ? "explicit" : "correlated";
     pushRun(run, confidence, confidence === "explicit" ? "manual" : "inferred");
   }
-  return path40;
+  return path41;
 }
 function metaRunIdMatches(run, token, runById) {
   const meta2 = extractSessionWorkflowMetadata(run.metadata);
@@ -4132,7 +4140,7 @@ var init_summary = __esm({
 });
 function sanitizeBundleRunId(runId) {
   let safe = typeof runId === "string" && runId.trim() !== "" ? runId.trim() : "run_unknown";
-  safe = path29__default.default.basename(safe);
+  safe = path30__default.default.basename(safe);
   safe = safe.replace(/[^a-zA-Z0-9._-]+/g, "_");
   if (safe === "" || safe === "." || safe === "..") {
     safe = "run_unknown";
@@ -4142,12 +4150,12 @@ function sanitizeBundleRunId(runId) {
 function bundleRunAssetRelativePath(runId, extension) {
   const safe = sanitizeBundleRunId(runId);
   const ext = extension.startsWith(".") ? extension : `.${extension}`;
-  return path29__default.default.posix.join("assets", "runs", `${safe}${ext}`);
+  return path30__default.default.posix.join("assets", "runs", `${safe}${ext}`);
 }
 function assertBundlePathContained(outputDir, relativePath) {
-  const base = path29__default.default.resolve(outputDir);
-  const resolved = path29__default.default.resolve(base, relativePath);
-  if (resolved !== base && !resolved.startsWith(base + path29__default.default.sep)) {
+  const base = path30__default.default.resolve(outputDir);
+  const resolved = path30__default.default.resolve(base, relativePath);
+  if (resolved !== base && !resolved.startsWith(base + path30__default.default.sep)) {
     throw new Error(`Bundle path escapes output directory: ${relativePath}`);
   }
   return resolved;
@@ -4157,7 +4165,7 @@ function normalizeBundleOutputPath(out, options) {
   if (trimmed === "") {
     throw new Error("--out requires a non-empty path.");
   }
-  const resolved = path29__default.default.resolve(trimmed);
+  const resolved = path30__default.default.resolve(trimmed);
   if (options?.preserveZipExtension !== true && resolved.toLowerCase().endsWith(".zip")) {
     return resolved.slice(0, -4);
   }
@@ -4166,7 +4174,7 @@ function normalizeBundleOutputPath(out, options) {
 function defaultBundleOutputPath(runIds) {
   const label = runIds.length === 1 ? sanitizeBundleRunId(runIds[0]) : `multi-${runIds.length}`;
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  return path29__default.default.resolve(`agent-inspect-bundle-${label}-${stamp}`);
+  return path30__default.default.resolve(`agent-inspect-bundle-${label}-${stamp}`);
 }
 var init_paths = __esm({
   "packages/core/src/bundle/paths.ts"() {
@@ -4229,7 +4237,7 @@ function assertEvidenceRelativePath(relativePath) {
     throw new Error("Evidence file path must be a non-empty relative path.");
   }
   const trimmed = relativePath.trim().replaceAll("\\", "/");
-  if (path29__default.default.isAbsolute(trimmed) || trimmed.startsWith("/")) {
+  if (path30__default.default.isAbsolute(trimmed) || trimmed.startsWith("/")) {
     throw new Error(`Evidence file path must be relative: ${relativePath}`);
   }
   const parts = trimmed.split("/").filter((part) => part !== "");
@@ -5095,13 +5103,13 @@ function pairSteps(left, right) {
   return pairs;
 }
 function compareLeafSteps(L, R, segments, opts, out) {
-  const path40 = buildPath(segments);
+  const path41 = buildPath(segments);
   if (L.name !== R.name) {
     out.push({
       kind: "structure",
       severity: "warning",
       message: "Step name differs",
-      path: path40,
+      path: path41,
       left: L.name,
       right: R.name
     });
@@ -5111,7 +5119,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "step-type",
       severity: "warning",
       message: "Step type differs",
-      path: path40,
+      path: path41,
       left: L.type,
       right: R.type
     });
@@ -5121,7 +5129,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "step-status",
       severity: "warning",
       message: "Step status differs",
-      path: path40,
+      path: path41,
       left: L.status,
       right: R.status
     });
@@ -5133,7 +5141,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "error",
       severity: "error",
       message: "Step error message differs",
-      path: path40,
+      path: path41,
       left: le || void 0,
       right: re || void 0
     });
@@ -5151,7 +5159,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
         kind: "duration",
         severity: "info",
         message: "Step duration differs",
-        path: path40,
+        path: path41,
         left: ld,
         right: rd
       });
@@ -5164,7 +5172,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "metadata",
       severity: "info",
       message: "Step metadata differs",
-      path: path40,
+      path: path41,
       left: L.metadata,
       right: R.metadata
     });
@@ -5176,7 +5184,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "output",
       severity: "info",
       message: "Output preview differs",
-      path: path40,
+      path: path41,
       left: L.outputPreview,
       right: R.outputPreview
     });
@@ -5343,11 +5351,11 @@ var init_engine = __esm({
 });
 
 // packages/core/src/diff/renderer.ts
-function formatPath(path40) {
-  if (path40 === void 0 || path40.path.length === 0) {
+function formatPath(path41) {
+  if (path41 === void 0 || path41.path.length === 0) {
     return "(run)";
   }
-  return path40.path.map((s) => s.name).join(" > ");
+  return path41.path.map((s) => s.name).join(" > ");
 }
 function formatValue(v, verbose) {
   if (v === void 0) return "(undefined)";
@@ -5727,11 +5735,11 @@ async function listFilesRecursive(root) {
   async function walk(dir) {
     const entries = await promises.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const abs = path29__default.default.join(dir, entry.name);
+      const abs = path30__default.default.join(dir, entry.name);
       if (entry.isDirectory()) {
         await walk(abs);
       } else if (entry.isFile()) {
-        const rel = path29__default.default.relative(root, abs).split(path29__default.default.sep).join("/");
+        const rel = path30__default.default.relative(root, abs).split(path30__default.default.sep).join("/");
         out.push(rel);
       }
     }
@@ -5741,7 +5749,7 @@ async function listFilesRecursive(root) {
 }
 async function verifyEvidenceDirectory(rootPath, options = {}) {
   const unexpectedMode = options.unexpectedFiles ?? "fail";
-  const root = path29__default.default.resolve(rootPath);
+  const root = path30__default.default.resolve(rootPath);
   const issues = [];
   let rootStat;
   try {
@@ -5771,7 +5779,7 @@ async function verifyEvidenceDirectory(rootPath, options = {}) {
       checkedFiles: 0
     };
   }
-  const manifestPath = path29__default.default.join(root, EVIDENCE_MANIFEST_FILENAME);
+  const manifestPath = path30__default.default.join(root, EVIDENCE_MANIFEST_FILENAME);
   let manifestText;
   try {
     manifestText = await promises.readFile(manifestPath, "utf-8");
@@ -5857,7 +5865,7 @@ async function verifyEvidenceDirectory(rootPath, options = {}) {
       continue;
     }
     listed.add(rel);
-    const abs = path29__default.default.join(root, ...rel.split("/"));
+    const abs = path30__default.default.join(root, ...rel.split("/"));
     let bytes;
     try {
       bytes = await promises.readFile(abs);
@@ -6171,7 +6179,7 @@ function normalizeSuiteConfig(value) {
 }
 async function validateSuiteConfig(config, options) {
   const diagnostics = [];
-  const tracesDir = path29__default.default.resolve(options.configDir, config.traces);
+  const tracesDir = path30__default.default.resolve(options.configDir, config.traces);
   try {
     await promises.access(tracesDir);
   } catch {
@@ -6181,7 +6189,7 @@ async function validateSuiteConfig(config, options) {
   }
   for (const suiteCase of config.cases) {
     if (suiteCase.input !== void 0) {
-      const inputPath = path29__default.default.resolve(options.configDir, suiteCase.input);
+      const inputPath = path30__default.default.resolve(options.configDir, suiteCase.input);
       try {
         await promises.access(inputPath);
       } catch {
@@ -6214,12 +6222,12 @@ async function fileExists(filePath) {
   }
 }
 async function resolveSuiteConfigPath(options = {}) {
-  const cwd = path29__default.default.resolve(options.cwd ?? process.cwd());
+  const cwd = path30__default.default.resolve(options.cwd ?? process.cwd());
   if (options.configPath !== void 0 && options.configPath.trim() !== "") {
-    return path29__default.default.resolve(cwd, options.configPath.trim());
+    return path30__default.default.resolve(cwd, options.configPath.trim());
   }
   for (const name of DEFAULT_SUITE_CONFIG_NAMES) {
-    const candidate = path29__default.default.join(cwd, name);
+    const candidate = path30__default.default.join(cwd, name);
     if (await fileExists(candidate)) return candidate;
   }
   throw new Error(
@@ -6236,7 +6244,7 @@ async function loadSuiteConfig(options = {}) {
       diagnostics: [diagnostic2("AI_SUITE_CONFIG_LOAD_FAILED", message)]
     });
   }
-  const extension = path29__default.default.extname(configPath);
+  const extension = path30__default.default.extname(configPath);
   if (TS_CONFIG_EXTENSIONS.has(extension)) {
     const message = "TypeScript suite configs require an explicit precompiled JavaScript config or future --config-loader support.";
     throw Object.assign(new Error(message), {
@@ -6261,7 +6269,7 @@ async function loadSuiteConfig(options = {}) {
     return {
       config,
       configPath,
-      configDir: path29__default.default.dirname(configPath)
+      configDir: path30__default.default.dirname(configPath)
     };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -6311,7 +6319,7 @@ async function exists(filePath) {
 }
 async function resolveSuiteCaseTrace(suiteCase, options) {
   if (suiteCase.trace !== void 0) {
-    const tracePath = path29__default.default.resolve(options.configDir, suiteCase.trace);
+    const tracePath = path30__default.default.resolve(options.configDir, suiteCase.trace);
     if (await exists(tracePath)) {
       return { caseId: suiteCase.id, tracePath, missing: false };
     }
@@ -6327,7 +6335,7 @@ async function resolveSuiteCaseTrace(suiteCase, options) {
   if (await exists(directPath)) {
     return { caseId: suiteCase.id, tracePath: directPath, runId: runKey, missing: false };
   }
-  const nestedPath = path29__default.default.join(options.tracesDir, `${path29__default.default.basename(runKey)}.jsonl`);
+  const nestedPath = path30__default.default.join(options.tracesDir, `${path30__default.default.basename(runKey)}.jsonl`);
   if (await exists(nestedPath)) {
     return { caseId: suiteCase.id, tracePath: nestedPath, runId: runKey, missing: false };
   }
@@ -6569,7 +6577,7 @@ function stripPrefix(name, prefixes) {
   }
   return name;
 }
-function eventEvidence(event, path40) {
+function eventEvidence(event, path41) {
   return {
     runId: event.runId,
     eventId: event.eventId,
@@ -6579,7 +6587,7 @@ function eventEvidence(event, path40) {
     kind: event.kind,
     name: event.name,
     status: event.status,
-    ...path40 ? { path: path40 } : {}
+    ...path41 ? { path: path41 } : {}
   };
 }
 function runEvidence(run) {
@@ -6646,9 +6654,9 @@ function eventEndMs(event) {
 function normalizedKey(value) {
   return value.toLowerCase().replace(/[^a-z0-9_]/g, "");
 }
-function lastPathSegment(path40) {
-  const parts = path40.split(".");
-  return parts[parts.length - 1] ?? path40;
+function lastPathSegment(path41) {
+  const parts = path41.split(".");
+  return parts[parts.length - 1] ?? path41;
 }
 function valueType(value) {
   if (Array.isArray(value)) return "array";
@@ -6662,12 +6670,12 @@ function serializedByteLength(value) {
     return void 0;
   }
 }
-function pushValueEntries(entries, event, value, path40, key, depth = 0) {
-  entries.push({ event, path: path40, key, value });
+function pushValueEntries(entries, event, value, path41, key, depth = 0) {
+  entries.push({ event, path: path41, key, value });
   if (depth >= 8) return;
   if (Array.isArray(value)) {
     for (const [index, item] of value.entries()) {
-      pushValueEntries(entries, event, item, `${path40}.${index}`, String(index), depth + 1);
+      pushValueEntries(entries, event, item, `${path41}.${index}`, String(index), depth + 1);
     }
     return;
   }
@@ -6677,7 +6685,7 @@ function pushValueEntries(entries, event, value, path40, key, depth = 0) {
       entries,
       event,
       value[nestedKey],
-      `${path40}.${nestedKey}`,
+      `${path41}.${nestedKey}`,
       nestedKey,
       depth + 1
     );
@@ -6718,18 +6726,18 @@ function isRawContentKey(key, forbiddenKeys) {
   const normalized = normalizedKey(key);
   return forbiddenKeys.some((forbidden) => normalized === normalizedKey(forbidden));
 }
-function isSafeRawContentMetricPath(path40, key, safePathPrefixes) {
-  const leaf = normalizedKey(key ?? lastPathSegment(path40));
+function isSafeRawContentMetricPath(path41, key, safePathPrefixes) {
+  const leaf = normalizedKey(key ?? lastPathSegment(path41));
   if (!SAFE_USAGE_LEAF_KEYS.has(leaf)) return false;
-  const parts = path40.split(".").filter(Boolean);
+  const parts = path41.split(".").filter(Boolean);
   if (parts.length < 2) return false;
   const parent = parts[parts.length - 2] ?? "";
   const parentNorm = normalizedKey(parent);
   return safePathPrefixes.some((prefix) => parentNorm === normalizedKey(prefix));
 }
-function isRawContentPath(path40, key, forbiddenKeys, safePathPrefixes) {
-  if (isSafeRawContentMetricPath(path40, key, safePathPrefixes)) return false;
-  return isRawContentKey(key ?? lastPathSegment(path40), forbiddenKeys);
+function isRawContentPath(path41, key, forbiddenKeys, safePathPrefixes) {
+  if (isSafeRawContentMetricPath(path41, key, safePathPrefixes)) return false;
+  return isRawContentKey(key ?? lastPathSegment(path41), forbiddenKeys);
 }
 function parentMarkedUnresolved(event) {
   if (booleanAttr(event, [
@@ -6771,9 +6779,9 @@ function eventDurationMs(event) {
 }
 function treeShape(nodes) {
   const lines = [];
-  const visit = (node, path40) => {
-    lines.push(`${path40}:${node.event.kind}:${node.event.name}:${node.event.status ?? "unknown"}`);
-    node.children.forEach((child, index) => visit(child, `${path40}.${index}`));
+  const visit = (node, path41) => {
+    lines.push(`${path41}:${node.event.kind}:${node.event.name}:${node.event.status ?? "unknown"}`);
+    node.children.forEach((child, index) => visit(child, `${path41}.${index}`));
   };
   nodes.forEach((node, index) => visit(node, String(index)));
   return lines;
@@ -6822,9 +6830,9 @@ function retrievalShape(context) {
 function guardrailShape(context) {
   return guardrailEvents(context).map((event) => signalName(event, ["guardrailName", "guardrail", "guardrailId"], ["guardrail:"])).sort((a, b) => a.localeCompare(b));
 }
-function firstEvidenceForKind(context, kind, path40) {
+function firstEvidenceForKind(context, kind, path41) {
   const event = context.events.find((candidate) => candidate.kind === kind);
-  return event ? [eventEvidence(event, path40)] : runEvidence(context.selectedRun);
+  return event ? [eventEvidence(event, path41)] : runEvidence(context.selectedRun);
 }
 function baselineDiffFinding(message, evidence, expected, actual) {
   return failFinding("baseline.regression", message, evidence, expected, actual);
@@ -7174,13 +7182,13 @@ function createStructureCycleRule() {
       const seenCycles = /* @__PURE__ */ new Set();
       const findings = [];
       for (const event of [...context.events].sort((a, b) => a.eventId.localeCompare(b.eventId))) {
-        const path40 = [];
+        const path41 = [];
         const seenAt = /* @__PURE__ */ new Map();
         let current = event;
         while (current) {
           const existing = seenAt.get(current.eventId);
           if (existing !== void 0) {
-            const cycle = path40.slice(existing);
+            const cycle = path41.slice(existing);
             const key = cycle.map((item) => item.eventId).sort().join("\0");
             if (!seenCycles.has(key)) {
               seenCycles.add(key);
@@ -7196,8 +7204,8 @@ function createStructureCycleRule() {
             }
             break;
           }
-          seenAt.set(current.eventId, path40.length);
-          path40.push(current);
+          seenAt.set(current.eventId, path41.length);
+          path41.push(current);
           current = current.parentId ? byId.get(current.parentId) : void 0;
         }
       }
@@ -8420,7 +8428,7 @@ function findReaderByFormat(format, readers) {
 }
 async function jsonlFilesInDirectory(dirPath) {
   const entries = await promises.readdir(dirPath, { withFileTypes: true });
-  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl")).map((entry) => path29__default.default.join(dirPath, entry.name)).sort((a, b) => a.localeCompare(b));
+  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl")).map((entry) => path30__default.default.join(dirPath, entry.name)).sort((a, b) => a.localeCompare(b));
 }
 async function resolveInput(input3) {
   const cached2 = resolvedInputCache.get(input3);
@@ -10119,7 +10127,7 @@ async function runSuiteCase(suiteCase, config, options) {
 async function runSuite(options = {}) {
   const startedAt = new Date(options.nowMs ?? Date.now()).toISOString();
   const { config, configPath, configDir } = await loadSuiteConfig(options);
-  const tracesDir = path29__default.default.resolve(configDir, config.traces);
+  const tracesDir = path30__default.default.resolve(configDir, config.traces);
   const cases = [];
   const diagnostics = [];
   for (const suiteCase of config.cases) {
@@ -11146,7 +11154,7 @@ function validateOptions(options) {
 }
 function isConfigLoadError(error) {
   if (!(error instanceof Error)) return false;
-  const ext = path29__default.default.extname(error.message);
+  const ext = path30__default.default.extname(error.message);
   if (error.message.includes("Unsupported suite config extension")) return true;
   if (error.message.includes("TypeScript suite configs require")) return true;
   if (error.message.includes("No suite config found")) return true;
@@ -11403,6 +11411,7 @@ var init_advanced = __esm({
     init_trace_filter();
     init_timeline();
     init_what();
+    init_causal_failure();
     init_explain();
     init_stats();
     init_search();
@@ -11539,8 +11548,8 @@ var init_load_sqlite = __esm({
   }
 });
 function resolveIndexDbPath(traceDir, dbPath) {
-  if (dbPath && dbPath.trim() !== "") return path29__default.default.resolve(dbPath);
-  return path29__default.default.join(path29__default.default.resolve(traceDir), INDEX_DB_FILENAME);
+  if (dbPath && dbPath.trim() !== "") return path30__default.default.resolve(dbPath);
+  return path30__default.default.join(path30__default.default.resolve(traceDir), INDEX_DB_FILENAME);
 }
 function str(value) {
   return typeof value === "string" && value !== "" ? value : null;
@@ -11632,7 +11641,7 @@ async function buildIndex(options = {}) {
       warnings.push(`index.unreadable: ${file}`);
     }
   }
-  await promises.mkdir(path29__default.default.dirname(dbPath), { recursive: true });
+  await promises.mkdir(path30__default.default.dirname(dbPath), { recursive: true });
   await promises.rm(dbPath, { force: true });
   const Sqlite = loadBetterSqlite3();
   const db = new Sqlite(dbPath);
@@ -11880,7 +11889,7 @@ var init_src = __esm({
 });
 
 // package.json
-var version = "6.10.0";
+var version = "6.12.0";
 
 // packages/cli/src/list.ts
 init_advanced();
@@ -14902,9 +14911,9 @@ Trace directory: ${traceDir}`);
     process.exitCode = 1;
   }
   const resolvedOutput = resolveOutputOption(options);
-  const outPath = resolvedOutput !== void 0 ? path29__default.default.resolve(resolvedOutput) : void 0;
+  const outPath = resolvedOutput !== void 0 ? path30__default.default.resolve(resolvedOutput) : void 0;
   if (outPath !== void 0) {
-    await promises.mkdir(path29__default.default.dirname(outPath), { recursive: true });
+    await promises.mkdir(path30__default.default.dirname(outPath), { recursive: true });
     await promises.writeFile(outPath, result.content, "utf-8");
     const vlabel = validation !== void 0 ? validation.ok ? "ok" : "failed" : "skipped";
     console.log(`Wrote ${result.fileExtension} export to ${outPath} (validation: ${vlabel})`);
@@ -15263,7 +15272,7 @@ function indexedToMetadata(row, traceDir) {
     endedAt: row.endedAt ?? void 0,
     durationMs: row.durationMs ?? void 0,
     eventCount: 0,
-    filePath: path29__default.default.join(traceDir, row.file),
+    filePath: path30__default.default.join(traceDir, row.file),
     fileSize: 0,
     createdAt: new Date(row.mtimeMs)
   };
@@ -15745,9 +15754,9 @@ async function reportCommand(runId, options = {}) {
     ...options.section ? { section: options.section } : {}
   });
   const resolvedOutput = resolveOutputOption(options);
-  const outPath = resolvedOutput !== void 0 ? path29__default.default.resolve(resolvedOutput) : void 0;
+  const outPath = resolvedOutput !== void 0 ? path30__default.default.resolve(resolvedOutput) : void 0;
   if (outPath !== void 0) {
-    await promises.mkdir(path29__default.default.dirname(outPath), { recursive: true });
+    await promises.mkdir(path30__default.default.dirname(outPath), { recursive: true });
     await promises.writeFile(outPath, result.content, "utf-8");
     console.log(`Wrote ${result.fileExtension} report to ${outPath}`);
   }
@@ -15876,8 +15885,8 @@ function passesLuhn(value) {
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var EPOCH_MS_RE = /^1[0-9]{12}$/;
 var EMAIL_RE = /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi;
-function pathSuggestsNonCard(path40) {
-  const normalized = path40.toLowerCase().replace(/[^a-z0-9._]/g, "");
+function pathSuggestsNonCard(path41) {
+  const normalized = path41.toLowerCase().replace(/[^a-z0-9._]/g, "");
   return /(^|\.)(tokenusage|usage)(\.|$)/.test(normalized) || /(startedat|endedat|durationms|timestamp|createdat|updatedat)(\.|$)/.test(normalized) || /(^|\.)(runid|traceid|spanid|eventid|sessionid|userid|parentid|requestid|correlationid)(\.|$)/.test(
     normalized
   ) || /(^|\.)ts(\.|$)/.test(normalized);
@@ -16064,17 +16073,17 @@ function applyRule(rule, value, replacement) {
   }
   return value;
 }
-function childPath(path40, key) {
+function childPath(path41, key) {
   if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {
-    return path40 ? `${path40}.${key}` : key;
+    return path41 ? `${path41}.${key}` : key;
   }
-  return `${path40 || "$"}[${JSON.stringify(key)}]`;
+  return `${path41 || "$"}[${JSON.stringify(key)}]`;
 }
-function indexPath(path40, index) {
-  return `${path40 || "$"}[${index}]`;
+function indexPath(path41, index) {
+  return `${path41 || "$"}[${index}]`;
 }
-function makeFinding(path40, detector, action, matchKind, severity = "warning", preview) {
-  return preview === void 0 ? { path: path40, detector, action, severity, matchKind } : { path: path40, detector, action, severity, matchKind, preview };
+function makeFinding(path41, detector, action, matchKind, severity = "warning", preview) {
+  return preview === void 0 ? { path: path41, detector, action, severity, matchKind } : { path: path41, detector, action, severity, matchKind, preview };
 }
 function createRedactionProfile(profile = "local") {
   switch (profile) {
@@ -16143,11 +16152,11 @@ var Redactor2 = class {
   #recordFinding(state, finding) {
     if (this.#collectFindings) state.findings.push(finding);
   }
-  #redactValue(value, key, path40, depth, state) {
+  #redactValue(value, key, path41, depth, state) {
     if (depth > this.#maxDepth) {
       this.#recordFinding(
         state,
-        makeFinding(path40, "structure.maxDepth", "truncate", "value", "warning")
+        makeFinding(path41, "structure.maxDepth", "truncate", "value", "warning")
       );
       return "[Truncated]";
     }
@@ -16156,19 +16165,19 @@ var Redactor2 = class {
       if (rule) {
         this.#recordFinding(
           state,
-          makeFinding(path40, `key.${rule.key}`, actionForRule(rule), "key", "warning")
+          makeFinding(path41, `key.${rule.key}`, actionForRule(rule), "key", "warning")
         );
         return applyRule(rule, value, this.#replacement);
       }
     }
     for (const detector of this.#detectors) {
-      const detections = detector.detect({ path: path40, key, value });
+      const detections = detector.detect({ path: path41, key, value });
       for (const detection of detections) {
         const action = detection.action ?? "replace";
         this.#recordFinding(
           state,
           makeFinding(
-            path40,
+            path41,
             detector.id,
             action,
             detection.matchKind ?? detector.matchKind ?? "custom",
@@ -16186,7 +16195,7 @@ var Redactor2 = class {
       const out = [];
       state.seen.set(value, out);
       value.forEach((item, index) => {
-        out[index] = this.#redactValue(item, void 0, indexPath(path40, index), depth + 1, state);
+        out[index] = this.#redactValue(item, void 0, indexPath(path41, index), depth + 1, state);
       });
       return out;
     }
@@ -16198,7 +16207,7 @@ var Redactor2 = class {
         out[entryKey] = this.#redactValue(
           entryValue,
           entryKey,
-          childPath(path40 === "$" ? "" : path40, entryKey),
+          childPath(path41 === "$" ? "" : path41, entryKey),
           depth + 1,
           state
         );
@@ -16669,14 +16678,14 @@ function uniqueSorted(values) {
   return [...new Set(values)].sort();
 }
 function isWithinDirectory(child, parent) {
-  const relative = path29__default.default.relative(parent, child);
-  return relative === "" || !relative.startsWith("..") && !path29__default.default.isAbsolute(relative);
+  const relative = path30__default.default.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path30__default.default.isAbsolute(relative);
 }
 async function resolveOutputPath(inputPath, output2, force) {
   if (output2 === void 0 || output2.trim() === "") return void 0;
-  const inputAbs = path29__default.default.resolve(inputPath);
-  const outputAbs = path29__default.default.resolve(output2.trim());
-  const inputDir = path29__default.default.dirname(inputAbs);
+  const inputAbs = path30__default.default.resolve(inputPath);
+  const outputAbs = path30__default.default.resolve(output2.trim());
+  const inputDir = path30__default.default.dirname(inputAbs);
   if (!isWithinDirectory(outputAbs, inputDir)) {
     throw new Error("Refusing to write migrated output outside the input directory.");
   }
@@ -16797,7 +16806,7 @@ async function migrateCommand(input3, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const inputPath = path29__default.default.resolve(input3.trim());
+  const inputPath = path30__default.default.resolve(input3.trim());
   const dryRun = options.dryRun === true;
   if (!dryRun && (options.output === void 0 || options.output.trim() === "")) {
     console.error("migrate requires --dry-run or --output <path>.");
@@ -16816,7 +16825,7 @@ async function migrateCommand(input3, options = {}) {
     );
     const result = await buildMigration(inputPath, outputPath);
     if (!dryRun && outputPath !== void 0) {
-      await promises.mkdir(path29__default.default.dirname(outputPath), { recursive: true });
+      await promises.mkdir(path30__default.default.dirname(outputPath), { recursive: true });
       await promises.writeFile(outputPath, result.content, "utf-8");
     }
     printSummary2(result, dryRun);
@@ -17150,23 +17159,23 @@ function evaluatePromptInjection(text, options = {}) {
   }
   return fail(ruleId, `Matched ${evidence.length} injection pattern(s).`, evidence, "warning");
 }
-function validateSchemaField(value, field, path40, evidence) {
+function validateSchemaField(value, field, path41, evidence) {
   const ruleId = "guardrail.structured-output";
   if (field.type) {
     const actual = value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
     if (actual !== field.type) {
-      evidence.push({ ruleId, path: path40, preview: `expected ${field.type}, got ${actual}` });
+      evidence.push({ ruleId, path: path41, preview: `expected ${field.type}, got ${actual}` });
       return;
     }
   }
   if (field.enum && !field.enum.some((item) => Object.is(item, value))) {
-    evidence.push({ ruleId, path: path40, preview: "value not in enum" });
+    evidence.push({ ruleId, path: path41, preview: "value not in enum" });
   }
   if (field.type === "object" && field.required && value && typeof value === "object" && !Array.isArray(value)) {
     const record = value;
     for (const key of field.required) {
       if (!(key in record)) {
-        evidence.push({ ruleId, path: `${path40}.${key}`, preview: "missing required key" });
+        evidence.push({ ruleId, path: `${path41}.${key}`, preview: "missing required key" });
       }
     }
   }
@@ -17493,7 +17502,7 @@ function asConfig(value) {
 }
 async function loadConfig(configPath) {
   if (configPath === void 0) return {};
-  const extension = path29__default.default.extname(configPath);
+  const extension = path30__default.default.extname(configPath);
   if (TS_CONFIG_EXTENSIONS2.has(extension)) {
     throw new Error(
       "TypeScript check configs require an explicit precompiled JavaScript config or future --config-loader support."
@@ -17502,7 +17511,7 @@ async function loadConfig(configPath) {
   if (!CONFIG_EXTENSIONS2.has(extension)) {
     throw new Error("Unsupported check config extension. Use .json, .js, .mjs, or .cjs.");
   }
-  const absolute = path29__default.default.resolve(configPath);
+  const absolute = path30__default.default.resolve(configPath);
   if (extension === ".json") {
     const raw = await promises.readFile(absolute, "utf-8");
     return asConfig(JSON.parse(raw));
@@ -17678,10 +17687,10 @@ function printHuman(result) {
     console.log(`- ${diagnostic7.code}: ${diagnostic7.message}`);
   }
   for (const finding of result.findings) {
-    const path40 = finding.evidence[0]?.path;
+    const path41 = finding.evidence[0]?.path;
     const run = finding.evidence[0]?.runId;
     const runPrefix = run ? `[${run}] ` : "";
-    console.log(`- ${runPrefix}${finding.ruleId}: ${finding.message}${path40 ? ` (${path40})` : ""}`);
+    console.log(`- ${runPrefix}${finding.ruleId}: ${finding.message}${path41 ? ` (${path41})` : ""}`);
   }
 }
 function readErrorResult(error) {
@@ -17949,7 +17958,7 @@ async function loadSuiteViewerData(options) {
   for (const suiteCase of result.cases) {
     cases.push(await enrichCase(suiteCase, baselinePath));
   }
-  const artifactsDir = path29__default.default.join(path29__default.default.dirname(result.configPath), ".agent-inspect/suite-runs");
+  const artifactsDir = path30__default.default.join(path30__default.default.dirname(result.configPath), ".agent-inspect/suite-runs");
   return {
     suiteName: result.suiteName,
     configPath: result.configPath,
@@ -18145,19 +18154,19 @@ function serializeWorkspaceManifest(manifest) {
 }
 var INDEX_DIR_NAME = "index";
 function resolveWorkspaceLocation(cwd = process.cwd()) {
-  const projectRoot = path29__default.default.resolve(cwd);
-  const workspaceDir = path29__default.default.join(projectRoot, WORKSPACE_DIR_NAME);
+  const projectRoot = path30__default.default.resolve(cwd);
+  const workspaceDir = path30__default.default.join(projectRoot, WORKSPACE_DIR_NAME);
   return {
     projectRoot,
     workspaceDir,
-    manifestPath: path29__default.default.join(workspaceDir, WORKSPACE_MANIFEST_FILENAME)
+    manifestPath: path30__default.default.join(workspaceDir, WORKSPACE_MANIFEST_FILENAME)
   };
 }
 function resolveInsideWorkspace(workspaceDir, relative) {
-  const base = path29__default.default.resolve(workspaceDir);
-  const resolved = path29__default.default.resolve(base, relative);
-  const rel = path29__default.default.relative(base, resolved);
-  if (rel === "" || rel === "." || !rel.startsWith("..") && !path29__default.default.isAbsolute(rel)) {
+  const base = path30__default.default.resolve(workspaceDir);
+  const resolved = path30__default.default.resolve(base, relative);
+  const rel = path30__default.default.relative(base, resolved);
+  if (rel === "" || rel === "." || !rel.startsWith("..") && !path30__default.default.isAbsolute(rel)) {
     return resolved;
   }
   throw new Error(
@@ -18226,7 +18235,7 @@ async function createWorkspace(options = {}) {
     created = false;
     adopted = true;
   } else {
-    const project = options.project?.trim() || path29__default.default.basename(location.projectRoot) || "workspace";
+    const project = options.project?.trim() || path30__default.default.basename(location.projectRoot) || "workspace";
     const traceDirs = detectedExistingTraces ? ["runs", "."] : ["runs"];
     manifest = createDefaultWorkspaceManifest({
       project,
@@ -18365,7 +18374,7 @@ async function doctorWorkspace(location) {
     const abs = resolveInsideWorkspace(location.workspaceDir, rel);
     for (const file of await listJsonl(abs)) {
       try {
-        const s = await promises.stat(path29__default.default.join(abs, file));
+        const s = await promises.stat(path30__default.default.join(abs, file));
         newestTraceMtime = Math.max(newestTraceMtime, s.mtimeMs);
       } catch {
         checks2.push({ id: "trace-readability", status: "warn", message: `cannot stat ${rel}/${file}` });
@@ -18413,7 +18422,7 @@ async function cleanWorkspace(location, manifest, options = {}) {
       const relPath = `${rel}/${entry}`;
       removed.push(relPath);
       if (!dryRun) {
-        await promises.rm(path29__default.default.join(abs, entry), { recursive: true, force: true });
+        await promises.rm(path30__default.default.join(abs, entry), { recursive: true, force: true });
       }
     }
   }
@@ -18422,7 +18431,7 @@ async function cleanWorkspace(location, manifest, options = {}) {
 
 // packages/viewer/src/workspace-data.ts
 async function loadWorkspaceViewerData(options) {
-  const cwd = path29__default.default.resolve(options.cwd ?? process.cwd());
+  const cwd = path30__default.default.resolve(options.cwd ?? process.cwd());
   const location = resolveWorkspaceLocation(cwd);
   const manifestRead = await readWorkspaceManifestFile(location);
   if (!manifestRead.ok || manifestRead.manifest === void 0) {
@@ -18435,7 +18444,7 @@ async function loadWorkspaceViewerData(options) {
   const runs = [];
   for (const rel of manifestRead.manifest.traceDirs) {
     const traceDir = resolveTraceDir({
-      dir: path29__default.default.join(location.workspaceDir, rel)
+      dir: path30__default.default.join(location.workspaceDir, rel)
     });
     const td = new TraceDirectory({ dir: traceDir });
     const files = await td.list();
@@ -18449,7 +18458,7 @@ async function loadWorkspaceViewerData(options) {
         runId: meta2.runId,
         ...meta2.name !== void 0 ? { name: meta2.name } : {},
         status: meta2.status,
-        file: path29__default.default.basename(meta2.filePath)
+        file: path30__default.default.basename(meta2.filePath)
       });
     }
   }
@@ -18460,8 +18469,8 @@ async function loadWorkspaceViewerData(options) {
     doctor,
     runs,
     bundleDirs: [
-      path29__default.default.join(location.workspaceDir, manifestRead.manifest.bundlesDir),
-      path29__default.default.join(location.workspaceDir, manifestRead.manifest.artifactsDir)
+      path30__default.default.join(location.workspaceDir, manifestRead.manifest.bundlesDir),
+      path30__default.default.join(location.workspaceDir, manifestRead.manifest.artifactsDir)
     ]
   };
 }
@@ -18524,7 +18533,7 @@ function createViewerServer(options = {}) {
           ok: true,
           readOnly: true,
           mode,
-          traceDir: path29__default.default.resolve(traceDir)
+          traceDir: path30__default.default.resolve(traceDir)
         });
       }
       if (pathname === "/api/suite" && mode === "suite") {
@@ -18553,7 +18562,7 @@ function createViewerServer(options = {}) {
             runId: meta2.runId,
             name: meta2.name,
             status: meta2.status,
-            file: path29__default.default.basename(meta2.filePath),
+            file: path30__default.default.basename(meta2.filePath),
             startedAt: meta2.startedAt,
             durationMs: meta2.durationMs
           }))
@@ -18670,7 +18679,7 @@ function startViewerServer(options = {}) {
       resolve({
         host,
         port: resolvedPort,
-        traceDir: path29__default.default.resolve(traceDir),
+        traceDir: path30__default.default.resolve(traceDir),
         url: `http://${host}:${resolvedPort}/${modeQuery}`,
         mode
       });
@@ -19041,10 +19050,10 @@ async function evalRun(input3, options = {}) {
     diagnostics: []
   };
 }
-function evidenceForRun(run, path40) {
-  return [{ runId: run.runId, ...path40 !== void 0 ? { path: path40 } : {} }];
+function evidenceForRun(run, path41) {
+  return [{ runId: run.runId, ...path41 !== void 0 ? { path: path41 } : {} }];
 }
-function evidenceForEvent(event, path40) {
+function evidenceForEvent(event, path41) {
   return [
     {
       runId: event.runId,
@@ -19052,7 +19061,7 @@ function evidenceForEvent(event, path40) {
       ...event.parentId !== void 0 ? { parentId: event.parentId } : {},
       kind: event.kind,
       name: event.name,
-      ...path40 !== void 0 ? { path: path40 } : {}
+      ...path41 !== void 0 ? { path: path41 } : {}
     }
   ];
 }
@@ -19210,9 +19219,9 @@ function collectTextFields(nodes, keys, preferredKinds = []) {
 function tokenize(text) {
   return [...text.toLowerCase().matchAll(/[a-z0-9][a-z0-9'-]{2,}/g)].map((match) => match[0].replace(/^['-]+|['-]+$/g, "")).filter((token) => token.length > 2 && !STOP_WORDS.has(token));
 }
-function firstEvidence(fields, run, path40) {
+function firstEvidence(fields, run, path41) {
   const first = fields[0];
-  return first === void 0 ? evidenceForRun(run, path40) : evidenceForEvent(first.node.event, first.path);
+  return first === void 0 ? evidenceForRun(run, path41) : evidenceForEvent(first.node.event, first.path);
 }
 function collectSourceIds(nodes, keys) {
   const wanted = keySet(keys);
@@ -19589,8 +19598,8 @@ function renderEvalMarkdown(result) {
   if (result.findings.length > 0) {
     lines.push("", "## Findings");
     for (const finding of result.findings) {
-      const path40 = finding.evidence[0]?.path;
-      lines.push(`- ${finding.ruleId}: ${finding.message}${path40 ? ` (${path40})` : ""}`);
+      const path41 = finding.evidence[0]?.path;
+      lines.push(`- ${finding.ruleId}: ${finding.message}${path41 ? ` (${path41})` : ""}`);
     }
   }
   return `${lines.join("\n")}
@@ -19637,7 +19646,7 @@ function asConfig2(value) {
 }
 async function loadConfig2(configPath) {
   if (configPath === void 0) return {};
-  const extension = path29__default.default.extname(configPath);
+  const extension = path30__default.default.extname(configPath);
   if (TS_CONFIG_EXTENSIONS3.has(extension)) {
     throw new Error(
       "TypeScript eval configs require an explicit precompiled JavaScript config or future --config-loader support."
@@ -19646,7 +19655,7 @@ async function loadConfig2(configPath) {
   if (!CONFIG_EXTENSIONS3.has(extension)) {
     throw new Error("Unsupported eval config extension. Use .json, .js, .mjs, or .cjs.");
   }
-  const absolute = path29__default.default.resolve(configPath);
+  const absolute = path30__default.default.resolve(configPath);
   if (extension === ".json") {
     const raw = await promises.readFile(absolute, "utf-8");
     return asConfig2(JSON.parse(raw));
@@ -19783,8 +19792,8 @@ function printHuman2(result) {
     console.log(`- ${diagnostic7.code}: ${diagnostic7.message}`);
   }
   for (const finding of result.findings) {
-    const path40 = finding.evidence[0]?.path;
-    console.log(`- ${finding.ruleId}: ${finding.message}${path40 ? ` (${path40})` : ""}`);
+    const path41 = finding.evidence[0]?.path;
+    console.log(`- ${finding.ruleId}: ${finding.message}${path41 ? ` (${path41})` : ""}`);
   }
 }
 function readErrorResult2(error) {
@@ -20037,14 +20046,14 @@ function exitCodeFor3(result) {
   return 2;
 }
 function explainFinding(finding, blocksBundle) {
-  const path40 = finding.evidence[0]?.path ?? "(unknown path)";
+  const path41 = finding.evidence[0]?.path ?? "(unknown path)";
   const category = finding.category ?? "structure";
   const confidence = finding.confidence ?? "medium";
   const detector = finding.detector ?? finding.ruleId;
   const action = finding.action ?? "review";
   const redactionHint = category === "credential" || category === "personal-data" || category === "raw-content" || action.includes("redact") ? "Usually removable by share/strict redaction before bundling." : "May require omitting the field, lowering limits, or an explicit local override.";
   return [
-    `  Matched: detector=${detector}; path=${path40}; category=${category}`,
+    `  Matched: detector=${detector}; path=${path41}; category=${category}`,
     `  Why: ${finding.message}`,
     `  Confidence: ${confidence}`,
     `  Redaction: ${redactionHint}`,
@@ -20086,9 +20095,9 @@ function printHuman3(result, explain = false) {
     console.log(`- ${diagnostic7.code}: ${diagnostic7.message}`);
   }
   for (const finding of result.findings) {
-    const path40 = finding.evidence[0]?.path;
+    const path41 = finding.evidence[0]?.path;
     const taxonomy = finding.category !== void 0 || finding.confidence !== void 0 ? ` [${[finding.category, finding.confidence].filter(Boolean).join("/")}]` : "";
-    console.log(`- ${finding.ruleId}: ${finding.message}${path40 ? ` (${path40})` : ""}${taxonomy}`);
+    console.log(`- ${finding.ruleId}: ${finding.message}${path41 ? ` (${path41})` : ""}${taxonomy}`);
     if (explain) {
       const blocks = finding.severity === "error" || finding.status === "fail";
       for (const line of explainFinding(finding, blocks)) {
@@ -20204,7 +20213,7 @@ function messageStartsWithDash(error) {
 }
 init_advanced();
 function validateReporterArtifactPath(options) {
-  const outputDir = path29__default.default.resolve(options.outputDir);
+  const outputDir = path30__default.default.resolve(options.outputDir);
   const diagnostics = [];
   const rawPath = options.relativePath;
   if (rawPath.length === 0) {
@@ -20224,7 +20233,7 @@ function validateReporterArtifactPath(options) {
     });
     return { ok: false, outputDir, diagnostics };
   }
-  if (path29__default.default.isAbsolute(rawPath) || path29__default.default.win32.isAbsolute(rawPath)) {
+  if (path30__default.default.isAbsolute(rawPath) || path30__default.default.win32.isAbsolute(rawPath)) {
     diagnostics.push({
       code: "artifact_path_absolute",
       severity: "error",
@@ -20233,7 +20242,7 @@ function validateReporterArtifactPath(options) {
     });
     return { ok: false, outputDir, diagnostics };
   }
-  const normalized = path29__default.default.posix.normalize(rawPath.replace(/\\/g, "/"));
+  const normalized = path30__default.default.posix.normalize(rawPath.replace(/\\/g, "/"));
   const segments = normalized.split("/");
   if (normalized === "." || normalized.startsWith("../") || segments.some((segment) => segment === "..")) {
     diagnostics.push({
@@ -20244,9 +20253,9 @@ function validateReporterArtifactPath(options) {
     });
     return { ok: false, outputDir, diagnostics };
   }
-  const absolutePath = path29__default.default.resolve(outputDir, normalized);
-  const relFromOutput = path29__default.default.relative(outputDir, absolutePath);
-  if (relFromOutput.length === 0 || relFromOutput.startsWith("..") || path29__default.default.isAbsolute(relFromOutput)) {
+  const absolutePath = path30__default.default.resolve(outputDir, normalized);
+  const relFromOutput = path30__default.default.relative(outputDir, absolutePath);
+  if (relFromOutput.length === 0 || relFromOutput.startsWith("..") || path30__default.default.isAbsolute(relFromOutput)) {
     diagnostics.push({
       code: "artifact_path_escape",
       severity: "error",
@@ -20272,7 +20281,7 @@ var EVIDENCE_CI_ARTIFACT_FILES = [
 function createEvidenceCiArtifacts(options) {
   const profile = options.redactionProfile;
   const prefix = options.relativeDir !== void 0 && options.relativeDir.trim() !== "" ? options.relativeDir.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "") : "";
-  const join = (name) => prefix === "" ? name : path29__default.default.posix.join(prefix, name);
+  const join = (name) => prefix === "" ? name : path30__default.default.posix.join(prefix, name);
   const formatFor = (name) => {
     if (name.endsWith(".html")) return "html";
     if (name.endsWith(".jsonl")) return "jsonl";
@@ -20361,8 +20370,8 @@ function renderCheckSection(result) {
     `Diagnostics: ${result.diagnostics.length}`
   ];
   for (const finding of result.findings.slice(0, 10)) {
-    const path40 = finding.evidence[0]?.path ?? "(run)";
-    lines.push(`- ${finding.ruleId}: ${finding.message} (${path40})`);
+    const path41 = finding.evidence[0]?.path ?? "(run)";
+    lines.push(`- ${finding.ruleId}: ${finding.message} (${path41})`);
   }
   for (const diagnostic7 of result.diagnostics.slice(0, 10)) {
     lines.push(`- ${diagnostic7.code}: ${diagnostic7.message}`);
@@ -20440,8 +20449,8 @@ function renderHtml(trace, check, diff) {
 `;
 }
 async function writeArtifact(outputDir, relativePath, content, files) {
-  const outPath = path29__default.default.join(outputDir, relativePath);
-  await promises.mkdir(path29__default.default.dirname(outPath), { recursive: true });
+  const outPath = path30__default.default.join(outputDir, relativePath);
+  await promises.mkdir(path30__default.default.dirname(outPath), { recursive: true });
   await promises.writeFile(outPath, content, "utf-8");
   files.push(relativePath);
 }
@@ -20470,7 +20479,7 @@ function shouldWriteEvidence(options, status) {
   return status === "unsafe" || status === "regression" || status === "unknown" || status === "warning";
 }
 async function artifactsCommand(target, options = {}, stdin = process.stdin) {
-  const outputDir = options.outputDir !== void 0 && options.outputDir.trim() !== "" ? path29__default.default.resolve(options.outputDir.trim()) : "";
+  const outputDir = options.outputDir !== void 0 && options.outputDir.trim() !== "" ? path30__default.default.resolve(options.outputDir.trim()) : "";
   if (outputDir === "") {
     console.error("--output-dir is required.");
     process.exitCode = 1;
@@ -20598,8 +20607,8 @@ async function artifactsCommand(target, options = {}, stdin = process.stdin) {
   }
   const summaryTarget = options.githubSummary ?? process.env.GITHUB_STEP_SUMMARY;
   if (summaryTarget !== void 0 && summaryTarget.trim() !== "") {
-    await promises.mkdir(path29__default.default.dirname(path29__default.default.resolve(summaryTarget)), { recursive: true });
-    await promises.appendFile(path29__default.default.resolve(summaryTarget), `
+    await promises.mkdir(path30__default.default.dirname(path30__default.default.resolve(summaryTarget)), { recursive: true });
+    await promises.appendFile(path30__default.default.resolve(summaryTarget), `
 ${renderMarkdown(trace, check, diff)}`, "utf-8");
   }
   const manifestFiles = [...files, "manifest.json"].sort((a, b) => a.localeCompare(b));
@@ -20618,10 +20627,10 @@ ${renderMarkdown(trace, check, diff)}`, "utf-8");
       findings: diff?.findings.length ?? 0,
       diagnostics: diff?.diagnostics.length ?? 0
     },
-    ...summaryTarget !== void 0 && summaryTarget.trim() !== "" ? { githubSummary: path29__default.default.resolve(summaryTarget) } : {},
+    ...summaryTarget !== void 0 && summaryTarget.trim() !== "" ? { githubSummary: path30__default.default.resolve(summaryTarget) } : {},
     note: NOTE
   };
-  await promises.writeFile(path29__default.default.join(outputDir, "manifest.json"), writeJson3(manifest), "utf-8");
+  await promises.writeFile(path30__default.default.join(outputDir, "manifest.json"), writeJson3(manifest), "utf-8");
   if (options.json === true) {
     console.log(writeJson3(manifest).trimEnd());
   } else {
@@ -20682,8 +20691,8 @@ async function resolveOutputDir(options, runIds, cwd, format) {
       const location = resolveWorkspaceLocation(cwd);
       const manifest = await readWorkspaceManifestFile(location);
       if (manifest.ok && manifest.manifest) {
-        const rel = path29__default.default.relative(location.workspaceDir, normalized);
-        if (!rel.startsWith("..") && !path29__default.default.isAbsolute(rel)) {
+        const rel = path30__default.default.relative(location.workspaceDir, normalized);
+        if (!rel.startsWith("..") && !path30__default.default.isAbsolute(rel)) {
           return resolveInsideWorkspace(location.workspaceDir, rel);
         }
       }
@@ -20699,7 +20708,7 @@ async function resolveOutputDir(options, runIds, cwd, format) {
       const label = runIds.length === 1 ? sanitizeBundleRunId(runIds[0]) : `multi-${runIds.length}`;
       const base2 = resolveInsideWorkspace(
         location.workspaceDir,
-        path29__default.default.join(manifest.manifest.bundlesDir, `bundle-${label}-${stamp}`)
+        path30__default.default.join(manifest.manifest.bundlesDir, `bundle-${label}-${stamp}`)
       );
       return format === "zip" ? `${base2}.zip` : base2;
     }
@@ -21104,19 +21113,19 @@ async function bundleCommand(runIdArg, options = {}) {
     let sidecarDir = outputDir;
     if (outputDir.toLowerCase().endsWith(".html")) {
       htmlPath = outputDir;
-      sidecarDir = path29__default.default.dirname(outputDir);
+      sidecarDir = path30__default.default.dirname(outputDir);
     } else {
       await promises.mkdir(outputDir, { recursive: true });
-      htmlPath = path29__default.default.join(outputDir, EVIDENCE_HTML_FILENAME);
+      htmlPath = path30__default.default.join(outputDir, EVIDENCE_HTML_FILENAME);
       sidecarDir = outputDir;
     }
     await promises.mkdir(sidecarDir, { recursive: true });
     await promises.writeFile(htmlPath, htmlContent, "utf-8");
-    await promises.writeFile(path29__default.default.join(sidecarDir, EVIDENCE_MANIFEST_FILENAME), evidenceJson, "utf-8");
+    await promises.writeFile(path30__default.default.join(sidecarDir, EVIDENCE_MANIFEST_FILENAME), evidenceJson, "utf-8");
     outputPath = htmlPath;
   } else if (format === "zip") {
     const zipPath = outputDir.toLowerCase().endsWith(".zip") ? outputDir : `${outputDir}.zip`;
-    const zipParent = path29__default.default.dirname(zipPath);
+    const zipParent = path30__default.default.dirname(zipPath);
     await promises.mkdir(zipParent, { recursive: true });
     const entries = [
       ...[...packaged.entries()].map(([relativePath, content]) => ({
@@ -21132,10 +21141,10 @@ async function bundleCommand(runIdArg, options = {}) {
     await promises.mkdir(outputDir, { recursive: true });
     for (const [relativePath, content] of packaged.entries()) {
       const outPath = assertBundlePathContained(outputDir, relativePath);
-      await promises.mkdir(path29__default.default.dirname(outPath), { recursive: true });
+      await promises.mkdir(path30__default.default.dirname(outPath), { recursive: true });
       await promises.writeFile(outPath, content, "utf-8");
     }
-    await promises.writeFile(path29__default.default.join(outputDir, EVIDENCE_MANIFEST_FILENAME), evidenceJson, "utf-8");
+    await promises.writeFile(path30__default.default.join(outputDir, EVIDENCE_MANIFEST_FILENAME), evidenceJson, "utf-8");
     if (!files.includes(EVIDENCE_MANIFEST_FILENAME)) {
       files.push(EVIDENCE_MANIFEST_FILENAME);
     }
@@ -21184,7 +21193,7 @@ function writeJson5(value) {
 `;
 }
 async function bundleVerifyCommand(targetPath, options = {}) {
-  const root = path29__default.default.resolve(targetPath.trim() || ".");
+  const root = path30__default.default.resolve(targetPath.trim() || ".");
   const result = await verifyEvidenceDirectory(root, {
     unexpectedFiles: options.unexpected ?? "fail"
   });
@@ -21217,6 +21226,141 @@ async function bundleVerifyCommand(targetPath, options = {}) {
     process.exitCode = 1;
   }
 }
+var CLIENTS = [
+  "cursor",
+  "claude-code",
+  "codex",
+  "gemini"
+];
+function isMcpConfigureClient(value) {
+  return CLIENTS.includes(value);
+}
+function buildServerBlock(traceDir) {
+  return {
+    command: "npx",
+    args: ["-y", "@agent-inspect/mcp-server", "--dir", traceDir],
+    env: {
+      AGENT_INSPECT_TRACE_DIR: traceDir,
+      AGENT_INSPECT_MCP_REDACTION_PROFILE: "share"
+    }
+  };
+}
+function buildMcpClientConfig(client, traceDir) {
+  const server = buildServerBlock(traceDir);
+  switch (client) {
+    case "cursor":
+      return {
+        mcpServers: {
+          "agent-inspect": server
+        }
+      };
+    case "claude-code":
+      return {
+        mcpServers: {
+          "agent-inspect": server
+        }
+      };
+    case "codex":
+      return {
+        mcp_servers: {
+          "agent-inspect": {
+            command: server.command,
+            args: server.args,
+            env: server.env
+          }
+        }
+      };
+    case "gemini":
+      return {
+        mcpServers: {
+          "agent-inspect": server
+        }
+      };
+    default: {
+      const _exhaustive = client;
+      return _exhaustive;
+    }
+  }
+}
+function resolveTargetPath(client, projectLocal) {
+  if (projectLocal) {
+    switch (client) {
+      case "cursor":
+        return path30__default.default.join(".cursor", "mcp.json");
+      case "claude-code":
+        return path30__default.default.join(".mcp.json");
+      case "codex":
+        return path30__default.default.join(".codex", "config.toml.json");
+      case "gemini":
+        return path30__default.default.join(".gemini", "settings.json");
+    }
+  }
+  switch (client) {
+    case "cursor":
+      return path30__default.default.join("~", ".cursor", "mcp.json");
+    case "claude-code":
+      return path30__default.default.join("~", ".claude.json");
+    case "codex":
+      return path30__default.default.join("~", ".codex", "config.toml");
+    case "gemini":
+      return path30__default.default.join("~", ".gemini", "settings.json");
+  }
+}
+async function mcpConfigureCommand(options) {
+  if (!isMcpConfigureClient(options.client)) {
+    throw new Error(
+      `Unsupported client "${String(options.client)}". Use: ${CLIENTS.join(", ")}`
+    );
+  }
+  const traceDir = options.dir?.trim() || ".agent-inspect";
+  const projectLocal = Boolean(options.projectLocal);
+  const write = Boolean(options.write);
+  const yes = Boolean(options.yes);
+  const dryRun = !(write && yes && projectLocal);
+  const config = buildMcpClientConfig(options.client, traceDir);
+  const targetPath = resolveTargetPath(options.client, projectLocal);
+  const notes = [
+    "Read-only MCP server; no network upload; share redaction by default.",
+    "Dry-run by default. Pass --project-local --write --yes to write a project file.",
+    "User-level paths are never auto-written by this command.",
+    "Remove the agent-inspect server block to uninstall."
+  ];
+  let wrote = false;
+  if (!dryRun && projectLocal) {
+    const abs = path30__default.default.resolve(targetPath);
+    await promises.mkdir(path30__default.default.dirname(abs), { recursive: true });
+    await promises.writeFile(abs, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+    wrote = true;
+  }
+  const result = {
+    client: options.client,
+    dryRun,
+    wrote,
+    targetPath,
+    config,
+    notes
+  };
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+  } else {
+    process.stdout.write(
+      [
+        `Client: ${result.client}`,
+        `Mode: ${result.dryRun ? "dry-run" : "write"}`,
+        `Target: ${result.targetPath}`,
+        `Wrote: ${result.wrote}`,
+        "",
+        JSON.stringify(result.config, null, 2),
+        "",
+        ...result.notes.map((note) => `- ${note}`),
+        ""
+      ].join("\n")
+    );
+  }
+  return result;
+}
 var NOTE2 = "Generated locally by AgentInspect from reporter artifact manifests. Trace contents are not embedded.";
 var MAX_TEXT = 180;
 var FRAMEWORKS = /* @__PURE__ */ new Set(["vitest", "jest", "manual"]);
@@ -21344,23 +21488,23 @@ function readManifestDocument(value) {
   };
 }
 function cwdRelative(filePath) {
-  const relative = path29__default.default.relative(process.cwd(), path29__default.default.resolve(filePath)).replace(/\\/g, "/");
-  if (relative === "" || relative.startsWith("../") || path29__default.default.isAbsolute(relative)) {
-    return path29__default.default.basename(filePath);
+  const relative = path30__default.default.relative(process.cwd(), path30__default.default.resolve(filePath)).replace(/\\/g, "/");
+  if (relative === "" || relative.startsWith("../") || path30__default.default.isAbsolute(relative)) {
+    return path30__default.default.basename(filePath);
   }
   return relative;
 }
 async function readReporterManifest(filePath) {
-  const absolute = path29__default.default.resolve(filePath);
+  const absolute = path30__default.default.resolve(filePath);
   const raw = await promises.readFile(absolute, "utf-8");
   const document = readManifestDocument(JSON.parse(raw));
   const manifest = document.manifest;
   const results = manifest.results.map((result) => ({
     testId: safeText(result.testId),
     name: safeText(result.name),
-    ...result.file === void 0 ? {} : { file: safeText(path29__default.default.basename(result.file)) },
+    ...result.file === void 0 ? {} : { file: safeText(path30__default.default.basename(result.file)) },
     status: result.status,
-    ...result.tracePath === void 0 ? {} : { tracePath: safeText(path29__default.default.basename(result.tracePath)) },
+    ...result.tracePath === void 0 ? {} : { tracePath: safeText(path30__default.default.basename(result.tracePath)) },
     artifacts: result.artifacts,
     diagnostics: result.diagnostics
   }));
@@ -21499,15 +21643,15 @@ async function ciSummaryCommand(manifestPaths, options = {}) {
     return;
   }
   const markdown = renderMarkdown2(result);
-  const outputPath = options.output !== void 0 && options.output.trim() !== "" ? path29__default.default.resolve(options.output.trim()) : void 0;
+  const outputPath = options.output !== void 0 && options.output.trim() !== "" ? path30__default.default.resolve(options.output.trim()) : void 0;
   if (outputPath !== void 0) {
-    await promises.mkdir(path29__default.default.dirname(outputPath), { recursive: true });
+    await promises.mkdir(path30__default.default.dirname(outputPath), { recursive: true });
     await promises.writeFile(outputPath, markdown, "utf-8");
   }
   const summaryTarget = options.githubSummary ?? process.env.GITHUB_STEP_SUMMARY;
   if (summaryTarget !== void 0 && summaryTarget.trim() !== "") {
-    const summaryPath = path29__default.default.resolve(summaryTarget);
-    await promises.mkdir(path29__default.default.dirname(summaryPath), { recursive: true });
+    const summaryPath = path30__default.default.resolve(summaryTarget);
+    await promises.mkdir(path30__default.default.dirname(summaryPath), { recursive: true });
     await promises.appendFile(summaryPath, `
 ${markdown}`, "utf-8");
   }
@@ -21655,7 +21799,7 @@ jobs:
 }
 async function planInit(options = {}) {
   const framework = normalizeFramework(options.framework);
-  const cwd = path29__default.default.resolve(options.cwd ?? process.cwd());
+  const cwd = path30__default.default.resolve(options.cwd ?? process.cwd());
   const demoPath = framework === "custom" ? "examples/agent-inspect-demo.mjs" : `examples/agent-inspect-${framework}-demo.mjs`;
   const candidates = [
     { rel: CONFIG_FILE, content: configTemplate(framework) },
@@ -21670,7 +21814,7 @@ async function planInit(options = {}) {
   }
   const files = [];
   for (const candidate of candidates) {
-    const abs = path29__default.default.join(cwd, candidate.rel);
+    const abs = path30__default.default.join(cwd, candidate.rel);
     try {
       await promises.access(abs);
       files.push({
@@ -21691,12 +21835,12 @@ async function writePlannedFiles(plan, cwd, options) {
     if (entry.action === "skip") {
       continue;
     }
-    const abs = path29__default.default.join(cwd, entry.path);
+    const abs = path30__default.default.join(cwd, entry.path);
     if (options.dryRun) {
       written.push(entry.path);
       continue;
     }
-    await promises.mkdir(path29__default.default.dirname(abs), { recursive: true });
+    await promises.mkdir(path30__default.default.dirname(abs), { recursive: true });
     const content = entry.path === CONFIG_FILE ? configTemplate(plan.framework) : entry.path === GITKEEP ? "" : entry.path.endsWith(".yml") ? githubWorkflowTemplate() : demoTemplate(plan.framework);
     await promises.writeFile(abs, content, "utf-8");
     written.push(entry.path);
@@ -21704,7 +21848,7 @@ async function writePlannedFiles(plan, cwd, options) {
   return written;
 }
 async function initCommand(options = {}) {
-  const cwd = path29__default.default.resolve(options.cwd ?? process.cwd());
+  const cwd = path30__default.default.resolve(options.cwd ?? process.cwd());
   try {
     const plan = await planInit({ ...options, cwd });
     const toWrite = plan.files.filter((file) => file.action === "create").map((f) => f.path);
@@ -21795,7 +21939,7 @@ function envCheck(name, optional = true) {
   };
 }
 async function traceDirWritable(traceDir) {
-  const resolved = path29__default.default.resolve(traceDir);
+  const resolved = path30__default.default.resolve(traceDir);
   try {
     await promises.mkdir(resolved, { recursive: true });
     await promises.access(resolved, promises.constants.W_OK);
@@ -21816,10 +21960,10 @@ async function traceDirWritable(traceDir) {
   }
 }
 function readPackageVersionNearEntry(entryPath, packageName) {
-  let dir = path29__default.default.dirname(path29__default.default.resolve(entryPath));
-  const { root } = path29__default.default.parse(dir);
+  let dir = path30__default.default.dirname(path30__default.default.resolve(entryPath));
+  const { root } = path30__default.default.parse(dir);
   while (true) {
-    const candidate = path29__default.default.join(dir, "package.json");
+    const candidate = path30__default.default.join(dir, "package.json");
     if (fs.existsSync(candidate)) {
       try {
         const pkg = JSON.parse(fs.readFileSync(candidate, "utf8"));
@@ -21830,14 +21974,14 @@ function readPackageVersionNearEntry(entryPath, packageName) {
       }
     }
     if (dir === root) break;
-    const parent = path29__default.default.dirname(dir);
+    const parent = path30__default.default.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
   return void 0;
 }
 function resolveInstalledPackage(cwd, name) {
-  const require2 = module$1.createRequire(path29__default.default.join(cwd, "package.json"));
+  const require2 = module$1.createRequire(path30__default.default.join(cwd, "package.json"));
   try {
     const entry = require2.resolve(name);
     let version2;
@@ -21935,7 +22079,7 @@ function versionMismatchCheck(cwd) {
   };
 }
 async function runDoctorChecks(options = {}) {
-  const cwd = path29__default.default.resolve(options.cwd ?? process3__default.default.cwd());
+  const cwd = path30__default.default.resolve(options.cwd ?? process3__default.default.cwd());
   const traceDir = options.traceDir?.trim() || process3__default.default.env.AGENT_INSPECT_TRACE_DIR?.trim() || ".agent-inspect";
   const checks2 = [
     nodeVersionCheck(),
@@ -22175,7 +22319,7 @@ function parsePluginManifest(input3) {
   };
 }
 async function readPluginManifestFile(packageDir) {
-  const manifestPath = path29__default.default.join(packageDir, PLUGIN_MANIFEST_FILENAME);
+  const manifestPath = path30__default.default.join(packageDir, PLUGIN_MANIFEST_FILENAME);
   try {
     const raw = await promises.readFile(manifestPath, "utf8");
     const parsed = parsePluginManifest(JSON.parse(raw));
@@ -22250,7 +22394,7 @@ function createTraceDirectoryIndexer() {
 // packages/cli/src/plugins.ts
 async function readPackageName(packageDir) {
   try {
-    const raw = await promises.readFile(path29__default.default.join(packageDir, "package.json"), "utf8");
+    const raw = await promises.readFile(path30__default.default.join(packageDir, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     return typeof parsed.name === "string" ? parsed.name : void 0;
   } catch {
@@ -22258,7 +22402,7 @@ async function readPackageName(packageDir) {
   }
 }
 async function discoverPlugins(cwd = process.cwd()) {
-  const nodeModules = path29__default.default.join(cwd, "node_modules");
+  const nodeModules = path30__default.default.join(cwd, "node_modules");
   const found = [];
   let entries;
   try {
@@ -22269,7 +22413,7 @@ async function discoverPlugins(cwd = process.cwd()) {
   for (const entry of entries.sort()) {
     if (entry.startsWith("@")) continue;
     if (!isPluginPackageName(entry)) continue;
-    const packageDir = path29__default.default.join(nodeModules, entry);
+    const packageDir = path30__default.default.join(nodeModules, entry);
     const manifestRead = await readPluginManifestFile(packageDir);
     found.push({
       packageName: entry,
@@ -22282,7 +22426,7 @@ async function discoverPlugins(cwd = process.cwd()) {
   return found;
 }
 async function validatePluginPackage(packageRef, cwd = process.cwd()) {
-  const packageDir = path29__default.default.isAbsolute(packageRef) ? packageRef : path29__default.default.join(cwd, "node_modules", packageRef);
+  const packageDir = path30__default.default.isAbsolute(packageRef) ? packageRef : path30__default.default.join(cwd, "node_modules", packageRef);
   const packageName = await readPackageName(packageDir) ?? packageRef;
   const errors = [];
   const warnings = [];
@@ -22359,7 +22503,7 @@ async function pluginsValidateCommand(packageRef, cwd) {
 init_advanced();
 var INDEX_FILENAME = ".agent-inspect-index.json";
 function traceIndexPath(traceDir) {
-  return path29__default.default.join(traceDir, INDEX_FILENAME);
+  return path30__default.default.join(traceDir, INDEX_FILENAME);
 }
 function parseMaxEntries(raw) {
   if (raw === void 0 || raw.trim() === "") return void 0;
@@ -22505,7 +22649,7 @@ async function newestTraceMtimeMs2(traceDir) {
     for (const file of files) {
       if (!file.endsWith(".jsonl")) continue;
       try {
-        const s = await promises.stat(path29__default.default.join(traceDir, file));
+        const s = await promises.stat(path30__default.default.join(traceDir, file));
         if (s.mtimeMs > newest) newest = s.mtimeMs;
       } catch {
       }
@@ -22760,11 +22904,11 @@ function printJson5(value) {
   console.log(JSON.stringify(value, null, 2));
 }
 function resolveCwd(options) {
-  return path29__default.default.resolve(options.cwd ?? process.cwd());
+  return path30__default.default.resolve(options.cwd ?? process.cwd());
 }
 async function suiteInitCommand(options = {}) {
   const cwd = resolveCwd(options);
-  const configPath = path29__default.default.join(cwd, DEFAULT_CONFIG_FILENAME);
+  const configPath = path30__default.default.join(cwd, DEFAULT_CONFIG_FILENAME);
   const template = options.template?.trim();
   const suiteConfig = template !== void 0 && template !== "" ? resolveSuiteTemplate(template) : defaultSuiteConfigTemplate();
   if (options.dryRun) {
@@ -22883,13 +23027,13 @@ async function suiteListCommand(options = {}) {
 }
 async function writeSuiteArtifact(result, configOutputDir, options) {
   const cwd = resolveCwd(options);
-  const outputDir = path29__default.default.resolve(
+  const outputDir = path30__default.default.resolve(
     cwd,
     options.output ?? configOutputDir ?? DEFAULT_SUITE_ARTIFACTS_DIR
   );
   await promises.mkdir(outputDir, { recursive: true });
   const stamp = result.startedAt.replace(/[:.]/g, "-");
-  const filePath = path29__default.default.join(outputDir, `${result.suiteName}-${stamp}.json`);
+  const filePath = path30__default.default.join(outputDir, `${result.suiteName}-${stamp}.json`);
   await promises.writeFile(filePath, `${JSON.stringify(result, null, 2)}
 `, "utf-8");
   return filePath;
@@ -22947,7 +23091,7 @@ async function loadSuiteResultFromInput(options) {
   if (options.input === void 0 || options.input.trim() === "") {
     throw new Error("Pass --input <suite-run.json> from a prior suite run.");
   }
-  const inputPath = path29__default.default.resolve(cwd, options.input.trim());
+  const inputPath = path30__default.default.resolve(cwd, options.input.trim());
   const raw = await promises.readFile(inputPath, "utf-8");
   return JSON.parse(raw);
 }
@@ -22984,9 +23128,9 @@ function normalizeMetrics2(raw) {
 }
 async function writeArtifacts(result, outputDir) {
   await promises.mkdir(outputDir, { recursive: true });
-  const jsonPath = path29__default.default.join(outputDir, "cohort-results.json");
-  const markdownPath = path29__default.default.join(outputDir, "cohort-summary.md");
-  const htmlPath = path29__default.default.join(outputDir, "cohort-report.html");
+  const jsonPath = path30__default.default.join(outputDir, "cohort-results.json");
+  const markdownPath = path30__default.default.join(outputDir, "cohort-summary.md");
+  const htmlPath = path30__default.default.join(outputDir, "cohort-report.html");
   await promises.writeFile(jsonPath, `${renderCohortReport(result, { format: "json" })}
 `, "utf-8");
   await promises.writeFile(
@@ -23014,7 +23158,7 @@ async function cohortCommand(options = {}) {
     const format = options.format ?? (options.json ? "json" : "markdown");
     let artifacts;
     if (options.output !== void 0 && options.output.trim() !== "") {
-      artifacts = await writeArtifacts(result, path29__default.default.resolve(options.output.trim()));
+      artifacts = await writeArtifacts(result, path30__default.default.resolve(options.output.trim()));
     }
     if (options.json || format === "json") {
       console.log(
@@ -23087,11 +23231,11 @@ function parseDuration2(value) {
 async function writeArtifacts2(result, outputDir) {
   await promises.mkdir(outputDir, { recursive: true });
   const paths = {
-    jsonPath: path29__default.default.join(outputDir, "gate-results.json"),
-    markdownPath: path29__default.default.join(outputDir, "gate-summary.md"),
-    htmlPath: path29__default.default.join(outputDir, "gate-report.html"),
-    junitPath: path29__default.default.join(outputDir, "junit.xml"),
-    githubPath: path29__default.default.join(outputDir, "github-step-summary.md")
+    jsonPath: path30__default.default.join(outputDir, "gate-results.json"),
+    markdownPath: path30__default.default.join(outputDir, "gate-summary.md"),
+    htmlPath: path30__default.default.join(outputDir, "gate-report.html"),
+    junitPath: path30__default.default.join(outputDir, "junit.xml"),
+    githubPath: path30__default.default.join(outputDir, "github-step-summary.md")
   };
   await promises.writeFile(
     paths.jsonPath,
@@ -23159,7 +23303,7 @@ async function gateCommand(options = {}) {
     const result = await runGate(runs, gateOptions);
     let artifacts;
     if (options.output !== void 0 && options.output.trim() !== "") {
-      artifacts = await writeArtifacts2(result, path29__default.default.resolve(options.output.trim()));
+      artifacts = await writeArtifacts2(result, path30__default.default.resolve(options.output.trim()));
     }
     if (options.json || format === "json") {
       console.log(JSON.stringify({ ...result, artifacts: artifacts ?? null }, null, 2));
@@ -23691,6 +23835,20 @@ function createCliProgram() {
   ).option("--format <format>", "markdown, json, or html", "markdown").option("-o, --output <dir>", "write cohort-results.json, cohort-summary.md, cohort-report.html").option("--json", "print deterministic JSON result").action((opts) => {
     runCommand(() => cohortCommand(opts));
   });
+  const mcpCmd = program.command("mcp").description("Configure local coding-agent MCP clients (read-only; dry-run by default)");
+  mcpCmd.command("configure").description("Print or write MCP client config for Cursor/Claude/Codex/Gemini").requiredOption(
+    "--client <name>",
+    "cursor | claude-code | codex | gemini"
+  ).option("--dir <path>", "trace directory for the MCP server", ".agent-inspect").option("--project-local", "target a project-local config path").option("--write", "write config (requires --project-local --yes)").option("--yes", "confirm write").option("--json", "print deterministic JSON result").action((opts) => {
+    runCommand(async () => {
+      if (!isMcpConfigureClient(opts.client)) {
+        throw new Error(
+          `Unsupported --client "${opts.client}". Use: cursor, claude-code, codex, gemini`
+        );
+      }
+      await mcpConfigureCommand({ ...opts, client: opts.client });
+    });
+  });
   program.command("gate").description("Run deterministic CI quality gates over traces or suites (v5.2+)").option("--dir <path>", "trace directory for threshold checks").option("--suite <path>", "suite config path").option("--max-error-rate <percent>", "maximum allowed error rate percentage").option("--max-p95-duration <ms>", "maximum allowed p95 run duration in ms").option("--forbid-tool <name>", "forbidden tool name (repeatable or comma-separated)").option(
     "--require-observation <name>",
     "required passed observation (repeatable or comma-separated)"
@@ -23707,9 +23865,9 @@ function isPrimaryModule() {
   if (!entry) return false;
   const selfPath = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
   try {
-    return fs.realpathSync(path29__default.default.resolve(entry)) === fs.realpathSync(path29__default.default.resolve(selfPath));
+    return fs.realpathSync(path30__default.default.resolve(entry)) === fs.realpathSync(path30__default.default.resolve(selfPath));
   } catch {
-    return path29__default.default.resolve(entry) === path29__default.default.resolve(selfPath);
+    return path30__default.default.resolve(entry) === path30__default.default.resolve(selfPath);
   }
 }
 if (isPrimaryModule()) {