agent-inspect 4.1.0 → 4.2.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 path14 = require('path');
+var path16 = 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 path14__default = /*#__PURE__*/_interopDefault(path14);
+var path16__default = /*#__PURE__*/_interopDefault(path16);
 var process3__default = /*#__PURE__*/_interopDefault(process3);
 var tty__default = /*#__PURE__*/_interopDefault(tty);
 
@@ -859,7 +859,7 @@ function getDefaultTraceDir() {
     if (typeof home !== "string" || home.trim() === "") {
       return FALLBACK_TRACE_DIR;
     }
-    return path14__default.default.join(home, DEFAULT_TRACE_DIR_NAME, RUNS_DIR_NAME);
+    return path16__default.default.join(home, DEFAULT_TRACE_DIR_NAME, RUNS_DIR_NAME);
   } catch {
     return FALLBACK_TRACE_DIR;
   }
@@ -867,11 +867,11 @@ function getDefaultTraceDir() {
 function getTraceFilePath(runId, traceDir) {
   const baseDir = traceDir ?? getDefaultTraceDir();
   let safeId = typeof runId === "string" && runId.trim() !== "" ? runId.trim() : "run_unknown";
-  safeId = path14__default.default.basename(safeId);
+  safeId = path16__default.default.basename(safeId);
   if (safeId === "" || safeId === "." || safeId === "..") {
     safeId = "run_unknown";
   }
-  return path14__default.default.join(baseDir, `${safeId}.jsonl`);
+  return path16__default.default.join(baseDir, `${safeId}.jsonl`);
 }
 function formatError(error) {
   if (error instanceof Error) {
@@ -928,7 +928,7 @@ var init_utils = __esm({
     init_duration();
     DEFAULT_TRACE_DIR_NAME = ".agent-inspect";
     RUNS_DIR_NAME = "runs";
-    FALLBACK_TRACE_DIR = path14__default.default.join(
+    FALLBACK_TRACE_DIR = path16__default.default.join(
       os__default.default.tmpdir(),
       "agent-inspect",
       RUNS_DIR_NAME
@@ -1723,7 +1723,7 @@ var init_trace_directory = __esm({
         this.#dir = resolveTraceDir(options);
       }
       getPath(filename) {
-        return filename ? path14__default.default.join(this.#dir, filename) : this.#dir;
+        return filename ? path16__default.default.join(this.#dir, filename) : this.#dir;
       }
       async list() {
         try {
@@ -1752,7 +1752,7 @@ function parseIsoToMs2(value) {
 }
 async function extractMetadata(filePath, _quickScan) {
   const stats = await promises.stat(filePath);
-  let runIdFromFile = path14__default.default.basename(filePath);
+  let runIdFromFile = path16__default.default.basename(filePath);
   if (runIdFromFile.endsWith(".jsonl")) {
     runIdFromFile = runIdFromFile.slice(0, -".jsonl".length);
   }
@@ -2960,6 +2960,262 @@ var init_metadata = __esm({
   }
 });
 
+// packages/core/src/sessions/status.ts
+function isExplicitSessionStatus(value) {
+  return typeof value === "string" && EXPLICIT_SESSION_STATUSES.has(value);
+}
+function activityMs(run) {
+  return run.endedAt ?? run.startedAt ?? 0;
+}
+function latestActivityMs(runs) {
+  let latest = 0;
+  for (const run of runs) {
+    const ms = activityMs(run);
+    if (ms > latest) latest = ms;
+  }
+  return latest;
+}
+function earliestStart(runs) {
+  let earliest;
+  for (const run of runs) {
+    if (run.startedAt === void 0) continue;
+    if (earliest === void 0 || run.startedAt < earliest) {
+      earliest = run.startedAt;
+    }
+  }
+  return earliest;
+}
+function latestEndWhenAllEnded(runs) {
+  if (runs.length === 0) return void 0;
+  let latest;
+  for (const run of runs) {
+    if (run.endedAt === void 0) return void 0;
+    if (latest === void 0 || run.endedAt > latest) latest = run.endedAt;
+  }
+  return latest;
+}
+function pickExplicitStatus(runs) {
+  let best;
+  let bestPriority = 0;
+  for (const run of runs) {
+    const raw = run.metadata?.sessionStatus;
+    if (!isExplicitSessionStatus(raw)) continue;
+    const priority = EXPLICIT_STATUS_PRIORITY[raw] ?? 0;
+    if (priority > bestPriority) {
+      bestPriority = priority;
+      best = raw;
+    }
+  }
+  return best;
+}
+function deriveLastError(runs) {
+  const errorRuns = runs.filter((run) => run.status === "error").sort((a, b) => activityMs(b) - activityMs(a));
+  const latest = errorRuns[0];
+  if (!latest) return void 0;
+  const meta2 = latest.metadata ?? {};
+  const message = typeof meta2.errorMessage === "string" && meta2.errorMessage.trim() !== "" ? meta2.errorMessage.trim() : latest.name ?? latest.runId;
+  const code = typeof meta2.errorCode === "string" && meta2.errorCode.trim() !== "" ? meta2.errorCode.trim() : void 0;
+  return { runId: latest.runId, message, code };
+}
+function deriveCheckSummary(runs) {
+  let pass2 = 0;
+  let fail4 = 0;
+  let warn2 = 0;
+  let found = false;
+  for (const run of runs) {
+    const summary = run.metadata?.checkSummary;
+    if (!summary || typeof summary !== "object") continue;
+    const record = summary;
+    if (typeof record.pass === "number") {
+      pass2 += record.pass;
+      found = true;
+    }
+    if (typeof record.fail === "number") {
+      fail4 += record.fail;
+      found = true;
+    }
+    if (typeof record.warn === "number") {
+      warn2 += record.warn;
+      found = true;
+    }
+  }
+  return found ? { pass: pass2, fail: fail4, warn: warn2 } : void 0;
+}
+function deriveObservationSummary(runs) {
+  for (const run of [...runs].sort((a, b) => activityMs(b) - activityMs(a))) {
+    const value = run.metadata?.observationSummary;
+    if (typeof value === "string" && value.trim() !== "") {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+function deriveSessionStatus(runs, options = {}) {
+  if (runs.length === 0) return "unknown";
+  if (runs.some((run) => run.status === "running")) return "running";
+  const explicit = pickExplicitStatus(runs);
+  if (explicit && explicit !== "running") return explicit;
+  if (runs.some((run) => run.status === "error")) return "error";
+  if (runs.every((run) => run.status === "success")) return "completed";
+  const nowMs = options.nowMs ?? Date.now();
+  const staleThresholdMs = options.staleThresholdMs ?? DEFAULT_STALE_THRESHOLD_MS;
+  const lastMs = latestActivityMs(runs);
+  if (lastMs > 0 && nowMs - lastMs > staleThresholdMs) return "stale";
+  return "unknown";
+}
+function enrichSessionSummary(summary, runs, options = {}) {
+  const sessionRuns = runs.filter((run) => summary.runIds.includes(run.runId)).sort((a, b) => a.runId.localeCompare(b.runId));
+  const startedAt = earliestStart(sessionRuns);
+  const endedAt = latestEndWhenAllEnded(sessionRuns);
+  const durationMs2 = startedAt !== void 0 && endedAt !== void 0 ? endedAt - startedAt : void 0;
+  let correlationId;
+  let jobId;
+  let workflowId;
+  for (const run of sessionRuns) {
+    const meta2 = extractSessionWorkflowMetadata(run.metadata);
+    if (!correlationId && meta2?.correlationId) correlationId = meta2.correlationId;
+    if (!jobId && meta2?.jobId) jobId = meta2.jobId;
+    if (!workflowId && meta2?.workflowName) workflowId = meta2.workflowName;
+    else if (!workflowId && meta2?.workflowStep) workflowId = meta2.workflowStep;
+  }
+  const lastMs = latestActivityMs(sessionRuns);
+  const lastActivity = lastMs > 0 ? new Date(lastMs).toISOString() : (/* @__PURE__ */ new Date(0)).toISOString();
+  const retryCount2 = summary.retries.filter(
+    (retry) => retry.retryOf !== void 0 || (retry.attempt ?? 0) > 1
+  ).length;
+  return {
+    ...summary,
+    status: deriveSessionStatus(sessionRuns, options),
+    startedAt,
+    endedAt,
+    durationMs: durationMs2,
+    correlationId,
+    jobId,
+    workflowId,
+    lastError: deriveLastError(sessionRuns),
+    lastActivity,
+    retryCount: retryCount2,
+    observationSummary: deriveObservationSummary(sessionRuns),
+    checkSummary: deriveCheckSummary(sessionRuns)
+  };
+}
+var DEFAULT_STALE_THRESHOLD_MS, EXPLICIT_STATUS_PRIORITY, EXPLICIT_SESSION_STATUSES;
+var init_status = __esm({
+  "packages/core/src/sessions/status.ts"() {
+    init_metadata();
+    DEFAULT_STALE_THRESHOLD_MS = 864e5;
+    EXPLICIT_STATUS_PRIORITY = {
+      error: 5,
+      waiting_input: 4,
+      idle: 3,
+      stale: 2,
+      completed: 1
+    };
+    EXPLICIT_SESSION_STATUSES = /* @__PURE__ */ new Set([
+      "running",
+      "waiting_input",
+      "idle",
+      "completed",
+      "error",
+      "stale",
+      "unknown"
+    ]);
+  }
+});
+
+// packages/core/src/sessions/activity.ts
+function statusLine(session) {
+  const name = session.workflowId ?? session.correlationId ?? session.sessionId;
+  const status = session.status;
+  if (session.lastError) {
+    return `${name} session ${session.sessionId} failed at ${session.lastError.message}`;
+  }
+  if (session.observationSummary) {
+    return `${name} session ${session.sessionId} ${status} with observation warning`;
+  }
+  return `${name} session ${session.sessionId} ${status}`;
+}
+function parseSinceMs(since, nowMs) {
+  if (!since || since.trim() === "") return nowMs - 7 * 864e5;
+  const trimmed = since.trim().toLowerCase();
+  const match = /^(\d+)([smhd])$/.exec(trimmed);
+  if (!match) return nowMs - 7 * 864e5;
+  const amount = Number.parseInt(match[1], 10);
+  const unit = match[2];
+  const mult = unit === "s" ? 1e3 : unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5;
+  return nowMs - amount * mult;
+}
+function isFailed(status) {
+  return status === "error";
+}
+function isStale(status) {
+  return status === "stale";
+}
+function guardrailWarnings(session) {
+  const summary = session.checkSummary;
+  if (!summary) return 0;
+  return summary.warn;
+}
+function buildActivitySummary(index, options = {}) {
+  const nowMs = options.nowMs ?? Date.now();
+  const sinceMs = parseSinceMs(options.since, nowMs);
+  const sinceIso = new Date(sinceMs).toISOString();
+  const limit = Number.isInteger(options.limit) && options.limit > 0 ? options.limit : 20;
+  const inWindow = index.sessions.filter((session) => {
+    const activityMs2 = Date.parse(session.lastActivity);
+    return Number.isFinite(activityMs2) && activityMs2 >= sinceMs;
+  });
+  const entries = [...inWindow].sort((a, b) => Date.parse(b.lastActivity) - Date.parse(a.lastActivity)).slice(0, limit).map((session) => ({
+    sessionId: session.sessionId,
+    status: session.status,
+    summary: statusLine(session),
+    lastActivity: session.lastActivity,
+    runCount: session.runIds.length
+  }));
+  let failed = 0;
+  let stale = 0;
+  let guardrailWarningTotal = 0;
+  for (const session of inWindow) {
+    if (isFailed(session.status)) failed += 1;
+    if (isStale(session.status)) stale += 1;
+    guardrailWarningTotal += guardrailWarnings(session);
+  }
+  return {
+    since: sinceIso,
+    sessions: inWindow.length,
+    failed,
+    stale,
+    guardrailWarnings: guardrailWarningTotal,
+    entries
+  };
+}
+function renderActivitySummaryHuman(summary) {
+  const lines = [];
+  const todayStart = /* @__PURE__ */ new Date();
+  todayStart.setHours(0, 0, 0, 0);
+  const todayMs = todayStart.getTime();
+  const today = summary.entries.filter(
+    (entry) => Date.parse(entry.lastActivity) >= todayMs
+  );
+  if (today.length > 0) {
+    lines.push("Today");
+    for (const entry of today) {
+      lines.push(`  ${entry.summary}`);
+    }
+    lines.push("");
+  }
+  lines.push(`Since ${summary.since}`);
+  lines.push(`  ${summary.sessions} sessions`);
+  lines.push(`  ${summary.failed} failed`);
+  lines.push(`  ${summary.stale} stale`);
+  lines.push(`  ${summary.guardrailWarnings} guardrail warnings`);
+  return lines.join("\n");
+}
+var init_activity = __esm({
+  "packages/core/src/sessions/activity.ts"() {
+  }
+});
+
 // packages/core/src/sessions/types.ts
 var init_types2 = __esm({
   "packages/core/src/sessions/types.ts"() {
@@ -3306,12 +3562,12 @@ function buildCriticalPath(runs, handoffs) {
     handoffs.filter((edge) => edge.confidence === "explicit").map((edge) => edge.from)
   );
   const ordered = [...runs].sort(compareRuns);
-  const path22 = [];
+  const path23 = [];
   const visited = /* @__PURE__ */ new Set();
   const pushRun = (run, confidence, source) => {
     if (visited.has(run.runId)) return;
     visited.add(run.runId);
-    path22.push({
+    path23.push({
       runId: run.runId,
       name: run.name,
       startedAt: run.startedAt,
@@ -3336,7 +3592,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 path22;
+  return path23;
 }
 function metaRunIdMatches(run, token, runById) {
   const meta2 = extractSessionWorkflowMetadata(run.metadata);
@@ -3378,14 +3634,21 @@ function buildSessionIndex(inputRuns, options = {}) {
         sessionId
       });
     }
-    return {
-      sessionId,
-      runIds,
-      groups,
-      handoffs,
-      retries,
-      criticalPath
-    };
+    return enrichSessionSummary(
+      {
+        sessionId,
+        runIds,
+        groups,
+        handoffs,
+        retries,
+        criticalPath
+      },
+      runs,
+      {
+        nowMs: options.nowMs,
+        staleThresholdMs: options.staleThresholdMs
+      }
+    );
   });
   if (sessions.length === 0 && runs.length > 0) {
     warnings.push({
@@ -3408,7 +3671,10 @@ function buildSessionIndex(inputRuns, options = {}) {
 var init_sessions = __esm({
   "packages/core/src/sessions/index.ts"() {
     init_metadata();
+    init_status();
     init_metadata();
+    init_status();
+    init_activity();
     init_types2();
     init_load();
     init_scope();
@@ -3573,19 +3839,19 @@ var require_file_uri_to_path = __commonJS({
       var rest = decodeURI(uri.substring(7));
       var firstSlash = rest.indexOf("/");
       var host = rest.substring(0, firstSlash);
-      var path22 = rest.substring(firstSlash + 1);
+      var path23 = rest.substring(firstSlash + 1);
       if ("localhost" == host) host = "";
       if (host) {
         host = sep + sep + host;
       }
-      path22 = path22.replace(/^(.+)\|/, "$1:");
+      path23 = path23.replace(/^(.+)\|/, "$1:");
       if (sep == "\\") {
-        path22 = path22.replace(/\//g, "\\");
+        path23 = path23.replace(/\//g, "\\");
       }
-      if (/^.+\:/.test(path22)) ; else {
-        path22 = sep + path22;
+      if (/^.+\:/.test(path23)) ; else {
+        path23 = sep + path23;
       }
-      return host + path22;
+      return host + path23;
     }
   }
 });
@@ -3594,18 +3860,18 @@ var require_file_uri_to_path = __commonJS({
 var require_bindings = __commonJS({
   "node_modules/.pnpm/bindings@1.5.0/node_modules/bindings/bindings.js"(exports$1, module) {
     var fs = __require("fs");
-    var path22 = __require("path");
+    var path23 = __require("path");
     var fileURLToPath2 = require_file_uri_to_path();
-    var join = path22.join;
-    var dirname = path22.dirname;
-    var exists = fs.accessSync && function(path23) {
+    var join = path23.join;
+    var dirname = path23.dirname;
+    var exists = fs.accessSync && function(path24) {
       try {
-        fs.accessSync(path23);
+        fs.accessSync(path24);
       } catch (e) {
         return false;
       }
       return true;
-    } || fs.existsSync || path22.existsSync;
+    } || fs.existsSync || path23.existsSync;
     var defaults = {
       arrow: process.env.NODE_BINDINGS_ARROW || " \u2192 ",
       compiled: process.env.NODE_BINDINGS_COMPILED_DIR || "compiled",
@@ -3650,7 +3916,7 @@ var require_bindings = __commonJS({
       if (!opts.module_root) {
         opts.module_root = exports$1.getRoot(exports$1.getFileName());
       }
-      if (path22.extname(opts.bindings) != ".node") {
+      if (path23.extname(opts.bindings) != ".node") {
         opts.bindings += ".node";
       }
       var requireFunc = typeof __webpack_require__ === "function" ? __non_webpack_require__ : __require;
@@ -3885,7 +4151,7 @@ var require_pragma = __commonJS({
 var require_backup = __commonJS({
   "node_modules/.pnpm/better-sqlite3@11.10.0/node_modules/better-sqlite3/lib/methods/backup.js"(exports$1, module) {
     var fs = __require("fs");
-    var path22 = __require("path");
+    var path23 = __require("path");
     var { promisify } = __require("util");
     var { cppdb } = require_util();
     var fsAccess = promisify(fs.access);
@@ -3901,7 +4167,7 @@ var require_backup = __commonJS({
       if (typeof attachedName !== "string") throw new TypeError('Expected the "attached" option to be a string');
       if (!attachedName) throw new TypeError('The "attached" option cannot be an empty string');
       if (handler != null && typeof handler !== "function") throw new TypeError('Expected the "progress" option to be a function');
-      await fsAccess(path22.dirname(filename)).catch(() => {
+      await fsAccess(path23.dirname(filename)).catch(() => {
         throw new TypeError("Cannot save backup because the directory does not exist");
       });
       const isNewFile = await fsAccess(filename).then(() => false, () => true);
@@ -4201,7 +4467,7 @@ var require_inspect = __commonJS({
 var require_database = __commonJS({
   "node_modules/.pnpm/better-sqlite3@11.10.0/node_modules/better-sqlite3/lib/database.js"(exports$1, module) {
     var fs = __require("fs");
-    var path22 = __require("path");
+    var path23 = __require("path");
     var util = require_util();
     var SqliteError = require_sqlite_error();
     var DEFAULT_ADDON;
@@ -4237,7 +4503,7 @@ var require_database = __commonJS({
         addon = DEFAULT_ADDON || (DEFAULT_ADDON = require_bindings()("better_sqlite3.node"));
       } else if (typeof nativeBinding === "string") {
         const requireFunc = typeof __non_webpack_require__ === "function" ? __non_webpack_require__ : __require;
-        addon = requireFunc(path22.resolve(nativeBinding).replace(/(\.node)?$/, ".node"));
+        addon = requireFunc(path23.resolve(nativeBinding).replace(/(\.node)?$/, ".node"));
       } else {
         addon = nativeBinding;
       }
@@ -4245,7 +4511,7 @@ var require_database = __commonJS({
         addon.setErrorConstructor(SqliteError);
         addon.isInitialized = true;
       }
-      if (!anonymous && !fs.existsSync(path22.dirname(filename))) {
+      if (!anonymous && !fs.existsSync(path23.dirname(filename))) {
         throw new TypeError("Cannot open database because the directory does not exist");
       }
       Object.defineProperties(this, {
@@ -4372,8 +4638,8 @@ GROUP BY session_id;
   }
 });
 function resolveIndexDbPath(traceDir, dbPath) {
-  if (dbPath && dbPath.trim() !== "") return path14__default.default.resolve(dbPath);
-  return path14__default.default.join(path14__default.default.resolve(traceDir), INDEX_DB_FILENAME);
+  if (dbPath && dbPath.trim() !== "") return path16__default.default.resolve(dbPath);
+  return path16__default.default.join(path16__default.default.resolve(traceDir), INDEX_DB_FILENAME);
 }
 function str(value) {
   return typeof value === "string" && value !== "" ? value : null;
@@ -4465,7 +4731,7 @@ async function buildIndex(options = {}) {
       warnings.push(`index.unreadable: ${file}`);
     }
   }
-  await promises.mkdir(path14__default.default.dirname(dbPath), { recursive: true });
+  await promises.mkdir(path16__default.default.dirname(dbPath), { recursive: true });
   await promises.rm(dbPath, { force: true });
   const db = new import_better_sqlite3.default(dbPath);
   let runCount = 0;
@@ -4608,7 +4874,7 @@ function indexStatus(dbPath) {
     db.close();
   }
 }
-function isIndexStale(dbPath, newestTraceMtimeMs2) {
+function isIndexStale(dbPath, newestTraceMtimeMs3) {
   const opened = openHealthy(dbPath);
   if (!opened) return true;
   try {
@@ -4616,7 +4882,7 @@ function isIndexStale(dbPath, newestTraceMtimeMs2) {
     if (!builtAt) return true;
     const builtMs = Date.parse(builtAt);
     if (Number.isNaN(builtMs)) return true;
-    return newestTraceMtimeMs2 > builtMs;
+    return newestTraceMtimeMs3 > builtMs;
   } finally {
     opened.db.close();
   }
@@ -4703,7 +4969,7 @@ var init_src = __esm({
 });
 
 // package.json
-var version = "4.1.0";
+var version = "4.2.0";
 
 // packages/cli/src/list.ts
 init_advanced();
@@ -5612,7 +5878,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) => path14__default.default.join(dirPath, entry.name)).sort((a, b) => a.localeCompare(b));
+  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl")).map((entry) => path16__default.default.join(dirPath, entry.name)).sort((a, b) => a.localeCompare(b));
 }
 async function resolveInput(input3) {
   const cached = resolvedInputCache.get(input3);
@@ -9754,9 +10020,9 @@ Trace directory: ${traceDir}`);
   if (validation !== void 0 && !validation.ok) {
     process.exitCode = 1;
   }
-  const outPath = options.output !== void 0 && options.output.trim() !== "" ? path14__default.default.resolve(options.output.trim()) : void 0;
+  const outPath = options.output !== void 0 && options.output.trim() !== "" ? path16__default.default.resolve(options.output.trim()) : void 0;
   if (outPath !== void 0) {
-    await promises.mkdir(path14__default.default.dirname(outPath), { recursive: true });
+    await promises.mkdir(path16__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})`);
@@ -9936,13 +10202,13 @@ function pairSteps(left, right) {
   return pairs;
 }
 function compareLeafSteps(L, R, segments, opts, out) {
-  const path22 = buildPath(segments);
+  const path23 = buildPath(segments);
   if (L.name !== R.name) {
     out.push({
       kind: "structure",
       severity: "warning",
       message: "Step name differs",
-      path: path22,
+      path: path23,
       left: L.name,
       right: R.name
     });
@@ -9952,7 +10218,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "step-type",
       severity: "warning",
       message: "Step type differs",
-      path: path22,
+      path: path23,
       left: L.type,
       right: R.type
     });
@@ -9962,7 +10228,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "step-status",
       severity: "warning",
       message: "Step status differs",
-      path: path22,
+      path: path23,
       left: L.status,
       right: R.status
     });
@@ -9974,7 +10240,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "error",
       severity: "error",
       message: "Step error message differs",
-      path: path22,
+      path: path23,
       left: le || void 0,
       right: re || void 0
     });
@@ -9992,7 +10258,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
         kind: "duration",
         severity: "info",
         message: "Step duration differs",
-        path: path22,
+        path: path23,
         left: ld,
         right: rd
       });
@@ -10005,7 +10271,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "metadata",
       severity: "info",
       message: "Step metadata differs",
-      path: path22,
+      path: path23,
       left: L.metadata,
       right: R.metadata
     });
@@ -10017,7 +10283,7 @@ function compareLeafSteps(L, R, segments, opts, out) {
       kind: "output",
       severity: "info",
       message: "Output preview differs",
-      path: path22,
+      path: path23,
       left: L.outputPreview,
       right: R.outputPreview
     });
@@ -10178,11 +10444,11 @@ function diffRuns(left, right, options) {
 
 // packages/core/src/diff/renderer.ts
 init_source();
-function formatPath(path22) {
-  if (path22 === void 0 || path22.path.length === 0) {
+function formatPath(path23) {
+  if (path23 === void 0 || path23.path.length === 0) {
     return "(run)";
   }
-  return path22.path.map((s) => s.name).join(" > ");
+  return path23.path.map((s) => s.name).join(" > ");
 }
 function formatValue(v, verbose) {
   if (v === void 0) return "(undefined)";
@@ -10550,7 +10816,31 @@ async function searchCommand(options = {}) {
 
 // packages/cli/src/sessions.ts
 init_advanced();
-async function loadSessionIndex(traceDir, correlateGroup) {
+
+// packages/cli/src/sessions-load.ts
+init_advanced();
+function isModuleNotFound2(e) {
+  return e !== null && typeof e === "object" && "code" in e && (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "MODULE_NOT_FOUND");
+}
+function toStatus(raw) {
+  if (raw === "success" || raw === "error" || raw === "running") return raw;
+  return "unknown";
+}
+function indexedToMetadata(row, traceDir) {
+  return {
+    runId: row.runId,
+    name: row.name ?? void 0,
+    status: toStatus(row.status),
+    startedAt: row.startedAt ?? void 0,
+    endedAt: row.endedAt ?? void 0,
+    durationMs: row.durationMs ?? void 0,
+    eventCount: 0,
+    filePath: path16__default.default.join(traceDir, row.file),
+    fileSize: 0,
+    createdAt: new Date(row.mtimeMs)
+  };
+}
+async function loadFromScan(traceDir) {
   const td = new TraceDirectory({ dir: traceDir });
   const files = await td.list();
   const metas = await loadTraceMetadataList(
@@ -10558,12 +10848,77 @@ async function loadSessionIndex(traceDir, correlateGroup) {
     files,
     (fileName) => td.getPath(fileName)
   );
-  const runs = await loadSessionRunRecords(metas);
-  return buildSessionIndex(runs, { correlateByGroupId: correlateGroup === true });
+  return loadSessionRunRecords(metas);
+}
+async function newestTraceMtimeMs(traceDir) {
+  const td = new TraceDirectory({ dir: traceDir });
+  let newest = 0;
+  for (const file of await td.list()) {
+    try {
+      const stats = await td.getFileStats(file);
+      if (stats.mtimeMs > newest) newest = stats.mtimeMs;
+    } catch {
+    }
+  }
+  return newest;
+}
+async function loadSessionRuns(traceDir) {
+  try {
+    const mod = await Promise.resolve().then(() => (init_src(), src_exports));
+    const dbPath = mod.resolveIndexDbPath(traceDir);
+    const status = mod.indexStatus(dbPath);
+    if (!status.healthy) {
+      return { runs: await loadFromScan(traceDir), source: "scan" };
+    }
+    const newest = await newestTraceMtimeMs(traceDir);
+    if (mod.isIndexStale(dbPath, newest)) {
+      return { runs: await loadFromScan(traceDir), source: "scan" };
+    }
+    const indexed = mod.queryRuns(dbPath, { limit: 1e4 });
+    if (indexed.length === 0) {
+      return { runs: await loadFromScan(traceDir), source: "scan" };
+    }
+    const runs = [];
+    for (const row of indexed) {
+      runs.push(await enrichSessionRunRecord(indexedToMetadata(row, traceDir)));
+    }
+    runs.sort((a, b) => (a.startedAt ?? 0) - (b.startedAt ?? 0));
+    return { runs, source: "index" };
+  } catch (e) {
+    if (!isModuleNotFound2(e)) ;
+    return { runs: await loadFromScan(traceDir), source: "scan" };
+  }
+}
+
+// packages/cli/src/sessions.ts
+async function loadSessionIndex(traceDir, options = {}) {
+  const { runs } = await loadSessionRuns(traceDir);
+  const staleThresholdMs = options.staleAfter && options.staleAfter.trim() !== "" ? parseDuration(options.staleAfter.trim()) : void 0;
+  return buildSessionIndex(runs, {
+    correlateByGroupId: options.correlateGroup === true,
+    staleThresholdMs
+  });
 }
 function findSession(index, sessionId) {
   return index.sessions.find((session) => session.sessionId === sessionId);
 }
+function latestSession(index) {
+  if (index.sessions.length === 0) return void 0;
+  return [...index.sessions].sort(
+    (a, b) => Date.parse(b.lastActivity) - Date.parse(a.lastActivity)
+  )[0];
+}
+function parseSinceCutoff(since) {
+  if (!since || since.trim() === "") return void 0;
+  return Date.now() - parseDuration(since.trim());
+}
+function sessionsInSinceWindow(index, since) {
+  const cutoff = parseSinceCutoff(since);
+  if (cutoff === void 0) return index.sessions;
+  return index.sessions.filter(
+    (session) => Date.parse(session.lastActivity) >= cutoff
+  );
+}
 function renderSessionsHuman(index, traceDir) {
   if (index.sessions.length === 0) {
     console.log("No sessions found");
@@ -10577,13 +10932,9 @@ function renderSessionsHuman(index, traceDir) {
   }
   console.log("Sessions:");
   for (const session of index.sessions) {
-    const firstRun = index.runs.find(
-      (run) => session.runIds.includes(run.runId)
-    );
-    const workflowName = firstRun?.metadata && typeof firstRun.metadata.workflowName === "string" ? firstRun.metadata.workflowName : void 0;
-    const suffix = workflowName ? ` workflow=${workflowName}` : "";
+    const suffix = session.workflowId ? ` workflow=${session.workflowId}` : "";
     console.log(
-      `  ${session.sessionId} (${session.runIds.length} run${session.runIds.length === 1 ? "" : "s"})${suffix}`
+      `  ${session.sessionId} [${session.status}] (${session.runIds.length} run${session.runIds.length === 1 ? "" : "s"})${suffix}`
     );
   }
   if (index.unscopedRunIds.length > 0) {
@@ -10595,7 +10946,14 @@ function renderSessionsHuman(index, traceDir) {
 }
 function renderSessionHuman(session, index, options) {
   console.log(`Session: ${session.sessionId}`);
+  console.log(`Status: ${session.status}`);
   console.log(`Runs: ${session.runIds.join(", ")}`);
+  if (session.lastActivity) console.log(`Last activity: ${session.lastActivity}`);
+  if (session.lastError) {
+    console.log(
+      `Last error: ${session.lastError.message} (run ${session.lastError.runId})`
+    );
+  }
   if (session.handoffs.length > 0) {
     console.log("");
     console.log("Handoffs:");
@@ -10640,10 +10998,29 @@ function renderSessionHuman(session, index, options) {
     }
   }
 }
+function collectHandoffs(index, sessionId) {
+  const sessions = sessionId ? index.sessions.filter((s) => s.sessionId === sessionId) : index.sessions;
+  const out = [];
+  for (const session of sessions) {
+    for (const edge of session.handoffs) {
+      out.push({ ...edge, sessionId: session.sessionId });
+    }
+  }
+  return out.sort((a, b) => {
+    const session = a.sessionId.localeCompare(b.sessionId);
+    if (session !== 0) return session;
+    const from = a.from.localeCompare(b.from);
+    if (from !== 0) return from;
+    return a.to.localeCompare(b.to);
+  });
+}
 async function sessionsCommand(options = {}) {
   try {
     const traceDir = resolveTraceDir({ dir: options.dir });
-    const index = await loadSessionIndex(traceDir, options.correlateGroup);
+    const index = await loadSessionIndex(traceDir, {
+      correlateGroup: options.correlateGroup,
+      staleAfter: options.staleAfter
+    });
     if (options.json) {
       console.log(
         JSON.stringify(
@@ -10666,6 +11043,121 @@ async function sessionsCommand(options = {}) {
     process.exitCode = 1;
   }
 }
+async function sessionsLatestCommand(options = {}) {
+  try {
+    const traceDir = resolveTraceDir({ dir: options.dir });
+    const index = await loadSessionIndex(traceDir, {
+      correlateGroup: options.correlateGroup,
+      staleAfter: options.staleAfter
+    });
+    const latest = latestSession(index);
+    if (!latest) {
+      if (options.json) {
+        console.log(JSON.stringify({ ok: false, traceDir, reason: "no-sessions" }, null, 2));
+      } else {
+        console.log("No sessions found");
+        console.log(`Trace directory: ${traceDir}`);
+      }
+      process.exitCode = 1;
+      return;
+    }
+    if (options.json) {
+      console.log(JSON.stringify({ ok: true, traceDir, session: latest }, null, 2));
+      return;
+    }
+    console.log(`Latest session: ${latest.sessionId}`);
+    console.log(`Status: ${latest.status}`);
+    console.log(`Last activity: ${latest.lastActivity}`);
+    console.log(`Runs: ${latest.runIds.join(", ")}`);
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`[AgentInspect] sessions latest failed: ${msg}`);
+    process.exitCode = 1;
+  }
+}
+async function sessionsActivityCommand(options = {}) {
+  try {
+    const traceDir = resolveTraceDir({ dir: options.dir });
+    const index = await loadSessionIndex(traceDir, {
+      correlateGroup: options.correlateGroup,
+      staleAfter: options.staleAfter
+    });
+    const summary = buildActivitySummary(index, { since: options.since });
+    if (options.json) {
+      console.log(JSON.stringify({ ok: true, traceDir, ...summary }, null, 2));
+      return;
+    }
+    console.log(renderActivitySummaryHuman(summary));
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`[AgentInspect] sessions activity failed: ${msg}`);
+    process.exitCode = 1;
+  }
+}
+async function sessionsHandoffsCommand(options = {}) {
+  try {
+    const traceDir = resolveTraceDir({ dir: options.dir });
+    const index = await loadSessionIndex(traceDir, {
+      correlateGroup: options.correlateGroup
+    });
+    const handoffs = collectHandoffs(index, options.session);
+    if (options.json) {
+      console.log(
+        JSON.stringify({ ok: true, traceDir, count: handoffs.length, handoffs }, null, 2)
+      );
+      return;
+    }
+    if (handoffs.length === 0) {
+      console.log("No handoffs found");
+      return;
+    }
+    for (const edge of handoffs) {
+      console.log(
+        `${edge.sessionId}: ${edge.from} -> ${edge.to} (${edge.confidence})`
+      );
+    }
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`[AgentInspect] sessions handoffs failed: ${msg}`);
+    process.exitCode = 1;
+  }
+}
+async function sessionsErrorsCommand(options = {}) {
+  try {
+    const traceDir = resolveTraceDir({ dir: options.dir });
+    const index = await loadSessionIndex(traceDir, {
+      correlateGroup: options.correlateGroup,
+      staleAfter: options.staleAfter
+    });
+    const scoped = sessionsInSinceWindow(index, options.since);
+    const errors = scoped.filter((session) => session.status === "error");
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          { ok: true, traceDir, count: errors.length, sessions: errors },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    if (errors.length === 0) {
+      console.log("No error sessions found");
+      return;
+    }
+    for (const session of errors) {
+      const detail = session.lastError?.message ?? "error";
+      console.log(`${session.sessionId}  ${detail}  (${session.runIds.length} runs)`);
+    }
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`[AgentInspect] sessions errors failed: ${msg}`);
+    process.exitCode = 1;
+  }
+}
+async function sessionsShowCommand(sessionId, options = {}) {
+  await sessionCommand(sessionId, options);
+}
 async function sessionCommand(sessionId, options = {}) {
   const id = typeof sessionId === "string" && sessionId.trim() !== "" ? sessionId.trim() : "";
   if (id === "") {
@@ -10823,9 +11315,9 @@ async function reportCommand(runId, options = {}) {
     redactionProfile,
     correlation: !options.noCorrelation
   });
-  const outPath = options.output !== void 0 && options.output.trim() !== "" ? path14__default.default.resolve(options.output.trim()) : void 0;
+  const outPath = options.output !== void 0 && options.output.trim() !== "" ? path16__default.default.resolve(options.output.trim()) : void 0;
   if (outPath !== void 0) {
-    await promises.mkdir(path14__default.default.dirname(outPath), { recursive: true });
+    await promises.mkdir(path16__default.default.dirname(outPath), { recursive: true });
     await promises.writeFile(outPath, result.content, "utf-8");
     console.log(`Wrote ${result.fileExtension} report to ${outPath}`);
   }
@@ -11075,17 +11567,17 @@ function applyRule(rule, value, replacement) {
   }
   return value;
 }
-function childPath(path22, key) {
+function childPath(path23, key) {
   if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {
-    return path22 ? `${path22}.${key}` : key;
+    return path23 ? `${path23}.${key}` : key;
   }
-  return `${path22 || "$"}[${JSON.stringify(key)}]`;
+  return `${path23 || "$"}[${JSON.stringify(key)}]`;
 }
-function indexPath(path22, index) {
-  return `${path22 || "$"}[${index}]`;
+function indexPath(path23, index) {
+  return `${path23 || "$"}[${index}]`;
 }
-function makeFinding(path22, detector, action, matchKind, severity = "warning", preview) {
-  return preview === void 0 ? { path: path22, detector, action, severity, matchKind } : { path: path22, detector, action, severity, matchKind, preview };
+function makeFinding(path23, detector, action, matchKind, severity = "warning", preview) {
+  return preview === void 0 ? { path: path23, detector, action, severity, matchKind } : { path: path23, detector, action, severity, matchKind, preview };
 }
 function createRedactionProfile(profile = "local") {
   switch (profile) {
@@ -11154,11 +11646,11 @@ var Redactor2 = class {
   #recordFinding(state, finding) {
     if (this.#collectFindings) state.findings.push(finding);
   }
-  #redactValue(value, key, path22, depth, state) {
+  #redactValue(value, key, path23, depth, state) {
     if (depth > this.#maxDepth) {
       this.#recordFinding(
         state,
-        makeFinding(path22, "structure.maxDepth", "truncate", "value", "warning")
+        makeFinding(path23, "structure.maxDepth", "truncate", "value", "warning")
       );
       return "[Truncated]";
     }
@@ -11167,19 +11659,19 @@ var Redactor2 = class {
       if (rule) {
         this.#recordFinding(
           state,
-          makeFinding(path22, `key.${rule.key}`, actionForRule(rule), "key", "warning")
+          makeFinding(path23, `key.${rule.key}`, actionForRule(rule), "key", "warning")
         );
         return applyRule(rule, value, this.#replacement);
       }
     }
     for (const detector of this.#detectors) {
-      const detections = detector.detect({ path: path22, key, value });
+      const detections = detector.detect({ path: path23, key, value });
       for (const detection of detections) {
         const action = detection.action ?? "replace";
         this.#recordFinding(
           state,
           makeFinding(
-            path22,
+            path23,
             detector.id,
             action,
             detection.matchKind ?? detector.matchKind ?? "custom",
@@ -11197,7 +11689,7 @@ var Redactor2 = class {
       const out = [];
       state.seen.set(value, out);
       value.forEach((item, index) => {
-        out[index] = this.#redactValue(item, void 0, indexPath(path22, index), depth + 1, state);
+        out[index] = this.#redactValue(item, void 0, indexPath(path23, index), depth + 1, state);
       });
       return out;
     }
@@ -11209,7 +11701,7 @@ var Redactor2 = class {
         out[entryKey] = this.#redactValue(
           entryValue,
           entryKey,
-          childPath(path22 === "$" ? "" : path22, entryKey),
+          childPath(path23 === "$" ? "" : path23, entryKey),
           depth + 1,
           state
         );
@@ -11666,14 +12158,14 @@ function uniqueSorted(values) {
   return [...new Set(values)].sort();
 }
 function isWithinDirectory(child, parent) {
-  const relative = path14__default.default.relative(parent, child);
-  return relative === "" || !relative.startsWith("..") && !path14__default.default.isAbsolute(relative);
+  const relative = path16__default.default.relative(parent, child);
+  return relative === "" || !relative.startsWith("..") && !path16__default.default.isAbsolute(relative);
 }
 async function resolveOutputPath(inputPath, output2, force) {
   if (output2 === void 0 || output2.trim() === "") return void 0;
-  const inputAbs = path14__default.default.resolve(inputPath);
-  const outputAbs = path14__default.default.resolve(output2.trim());
-  const inputDir = path14__default.default.dirname(inputAbs);
+  const inputAbs = path16__default.default.resolve(inputPath);
+  const outputAbs = path16__default.default.resolve(output2.trim());
+  const inputDir = path16__default.default.dirname(inputAbs);
   if (!isWithinDirectory(outputAbs, inputDir)) {
     throw new Error("Refusing to write migrated output outside the input directory.");
   }
@@ -11794,7 +12286,7 @@ async function migrateCommand(input3, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const inputPath = path14__default.default.resolve(input3.trim());
+  const inputPath = path16__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>.");
@@ -11813,7 +12305,7 @@ async function migrateCommand(input3, options = {}) {
     );
     const result = await buildMigration(inputPath, outputPath);
     if (!dryRun && outputPath !== void 0) {
-      await promises.mkdir(path14__default.default.dirname(outputPath), { recursive: true });
+      await promises.mkdir(path16__default.default.dirname(outputPath), { recursive: true });
       await promises.writeFile(outputPath, result.content, "utf-8");
     }
     printSummary2(result, dryRun);
@@ -12092,7 +12584,7 @@ function stripPrefix(name, prefixes) {
   }
   return name;
 }
-function eventEvidence(event, path22) {
+function eventEvidence(event, path23) {
   return {
     runId: event.runId,
     eventId: event.eventId,
@@ -12102,7 +12594,7 @@ function eventEvidence(event, path22) {
     kind: event.kind,
     name: event.name,
     status: event.status,
-    ...path22 ? { path: path22 } : {}
+    ...path23 ? { path: path23 } : {}
   };
 }
 function runEvidence(run) {
@@ -12165,9 +12657,9 @@ function eventEndMs(event) {
 function normalizedKey(value) {
   return value.toLowerCase().replace(/[^a-z0-9_]/g, "");
 }
-function lastPathSegment(path22) {
-  const parts = path22.split(".");
-  return parts[parts.length - 1] ?? path22;
+function lastPathSegment(path23) {
+  const parts = path23.split(".");
+  return parts[parts.length - 1] ?? path23;
 }
 function valueType(value) {
   if (Array.isArray(value)) return "array";
@@ -12181,12 +12673,12 @@ function serializedByteLength(value) {
     return void 0;
   }
 }
-function pushValueEntries(entries, event, value, path22, key, depth = 0) {
-  entries.push({ event, path: path22, key, value });
+function pushValueEntries(entries, event, value, path23, key, depth = 0) {
+  entries.push({ event, path: path23, key, value });
   if (depth >= 8) return;
   if (Array.isArray(value)) {
     for (const [index, item] of value.entries()) {
-      pushValueEntries(entries, event, item, `${path22}.${index}`, String(index), depth + 1);
+      pushValueEntries(entries, event, item, `${path23}.${index}`, String(index), depth + 1);
     }
     return;
   }
@@ -12196,7 +12688,7 @@ function pushValueEntries(entries, event, value, path22, key, depth = 0) {
       entries,
       event,
       value[nestedKey],
-      `${path22}.${nestedKey}`,
+      `${path23}.${nestedKey}`,
       nestedKey,
       depth + 1
     );
@@ -12277,9 +12769,9 @@ function eventDurationMs(event) {
 }
 function treeShape(nodes) {
   const lines = [];
-  const visit = (node, path22) => {
-    lines.push(`${path22}:${node.event.kind}:${node.event.name}:${node.event.status ?? "unknown"}`);
-    node.children.forEach((child, index) => visit(child, `${path22}.${index}`));
+  const visit = (node, path23) => {
+    lines.push(`${path23}:${node.event.kind}:${node.event.name}:${node.event.status ?? "unknown"}`);
+    node.children.forEach((child, index) => visit(child, `${path23}.${index}`));
   };
   nodes.forEach((node, index) => visit(node, String(index)));
   return lines;
@@ -12328,9 +12820,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, path22) {
+function firstEvidenceForKind(context, kind, path23) {
   const event = context.events.find((candidate) => candidate.kind === kind);
-  return event ? [eventEvidence(event, path22)] : runEvidence(context.selectedRun);
+  return event ? [eventEvidence(event, path23)] : runEvidence(context.selectedRun);
 }
 function baselineDiffFinding(message, evidence, expected, actual) {
   return failFinding("baseline.regression", message, evidence, expected, actual);
@@ -12680,13 +13172,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 path22 = [];
+        const path23 = [];
         const seenAt = /* @__PURE__ */ new Map();
         let current = event;
         while (current) {
           const existing = seenAt.get(current.eventId);
           if (existing !== void 0) {
-            const cycle = path22.slice(existing);
+            const cycle = path23.slice(existing);
             const key = cycle.map((item) => item.eventId).sort().join("\0");
             if (!seenCycles.has(key)) {
               seenCycles.add(key);
@@ -12702,8 +13194,8 @@ function createStructureCycleRule() {
             }
             break;
           }
-          seenAt.set(current.eventId, path22.length);
-          path22.push(current);
+          seenAt.set(current.eventId, path23.length);
+          path23.push(current);
           current = current.parentId ? byId.get(current.parentId) : void 0;
         }
       }
@@ -13500,23 +13992,23 @@ function evaluatePromptInjection(text, options = {}) {
   }
   return fail(ruleId, `Matched ${evidence.length} injection pattern(s).`, evidence, "warning");
 }
-function validateSchemaField(value, field, path22, evidence) {
+function validateSchemaField(value, field, path23, 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: path22, preview: `expected ${field.type}, got ${actual}` });
+      evidence.push({ ruleId, path: path23, preview: `expected ${field.type}, got ${actual}` });
       return;
     }
   }
   if (field.enum && !field.enum.some((item) => Object.is(item, value))) {
-    evidence.push({ ruleId, path: path22, preview: "value not in enum" });
+    evidence.push({ ruleId, path: path23, 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: `${path22}.${key}`, preview: "missing required key" });
+        evidence.push({ ruleId, path: `${path23}.${key}`, preview: "missing required key" });
       }
     }
   }
@@ -13843,7 +14335,7 @@ function asConfig(value) {
 }
 async function loadConfig(configPath) {
   if (configPath === void 0) return {};
-  const extension = path14__default.default.extname(configPath);
+  const extension = path16__default.default.extname(configPath);
   if (TS_CONFIG_EXTENSIONS.has(extension)) {
     throw new Error(
       "TypeScript check configs require an explicit precompiled JavaScript config or future --config-loader support."
@@ -13852,7 +14344,7 @@ async function loadConfig(configPath) {
   if (!CONFIG_EXTENSIONS.has(extension)) {
     throw new Error("Unsupported check config extension. Use .json, .js, .mjs, or .cjs.");
   }
-  const absolute = path14__default.default.resolve(configPath);
+  const absolute = path16__default.default.resolve(configPath);
   if (extension === ".json") {
     const raw = await promises.readFile(absolute, "utf-8");
     return asConfig(JSON.parse(raw));
@@ -14001,10 +14493,10 @@ function printHuman(result) {
     console.log(`- ${diagnostic4.code}: ${diagnostic4.message}`);
   }
   for (const finding of result.findings) {
-    const path22 = finding.evidence[0]?.path;
+    const path23 = finding.evidence[0]?.path;
     const run = finding.evidence[0]?.runId;
     const runPrefix = run ? `[${run}] ` : "";
-    console.log(`- ${runPrefix}${finding.ruleId}: ${finding.message}${path22 ? ` (${path22})` : ""}`);
+    console.log(`- ${runPrefix}${finding.ruleId}: ${finding.message}${path23 ? ` (${path23})` : ""}`);
   }
 }
 function readErrorResult(error) {
@@ -14207,7 +14699,7 @@ function createViewerServer(options = {}) {
         return sendJson(res, 200, {
           ok: true,
           readOnly: true,
-          traceDir: path14__default.default.resolve(traceDir)
+          traceDir: path16__default.default.resolve(traceDir)
         });
       }
       const td = new TraceDirectory({ dir: traceDir });
@@ -14225,7 +14717,7 @@ function createViewerServer(options = {}) {
             runId: meta2.runId,
             name: meta2.name,
             status: meta2.status,
-            file: path14__default.default.basename(meta2.filePath),
+            file: path16__default.default.basename(meta2.filePath),
             startedAt: meta2.startedAt,
             durationMs: meta2.durationMs
           }))
@@ -14340,7 +14832,7 @@ function startViewerServer(options = {}) {
       resolve({
         host,
         port: resolvedPort,
-        traceDir: path14__default.default.resolve(traceDir),
+        traceDir: path16__default.default.resolve(traceDir),
         url: `http://${host}:${resolvedPort}`
       });
     });
@@ -14545,10 +15037,10 @@ async function evalRun(input3, options = {}) {
     diagnostics: []
   };
 }
-function evidenceForRun(run, path22) {
-  return [{ runId: run.runId, ...path22 !== void 0 ? { path: path22 } : {} }];
+function evidenceForRun(run, path23) {
+  return [{ runId: run.runId, ...path23 !== void 0 ? { path: path23 } : {} }];
 }
-function evidenceForEvent(event, path22) {
+function evidenceForEvent(event, path23) {
   return [
     {
       runId: event.runId,
@@ -14556,7 +15048,7 @@ function evidenceForEvent(event, path22) {
       ...event.parentId !== void 0 ? { parentId: event.parentId } : {},
       kind: event.kind,
       name: event.name,
-      ...path22 !== void 0 ? { path: path22 } : {}
+      ...path23 !== void 0 ? { path: path23 } : {}
     }
   ];
 }
@@ -14714,9 +15206,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, path22) {
+function firstEvidence(fields, run, path23) {
   const first = fields[0];
-  return first === void 0 ? evidenceForRun(run, path22) : evidenceForEvent(first.node.event, first.path);
+  return first === void 0 ? evidenceForRun(run, path23) : evidenceForEvent(first.node.event, first.path);
 }
 function collectSourceIds(nodes, keys) {
   const wanted = keySet(keys);
@@ -15093,8 +15585,8 @@ function renderEvalMarkdown(result) {
   if (result.findings.length > 0) {
     lines.push("", "## Findings");
     for (const finding of result.findings) {
-      const path22 = finding.evidence[0]?.path;
-      lines.push(`- ${finding.ruleId}: ${finding.message}${path22 ? ` (${path22})` : ""}`);
+      const path23 = finding.evidence[0]?.path;
+      lines.push(`- ${finding.ruleId}: ${finding.message}${path23 ? ` (${path23})` : ""}`);
     }
   }
   return `${lines.join("\n")}
@@ -15141,7 +15633,7 @@ function asConfig2(value) {
 }
 async function loadConfig2(configPath) {
   if (configPath === void 0) return {};
-  const extension = path14__default.default.extname(configPath);
+  const extension = path16__default.default.extname(configPath);
   if (TS_CONFIG_EXTENSIONS2.has(extension)) {
     throw new Error(
       "TypeScript eval configs require an explicit precompiled JavaScript config or future --config-loader support."
@@ -15150,7 +15642,7 @@ async function loadConfig2(configPath) {
   if (!CONFIG_EXTENSIONS2.has(extension)) {
     throw new Error("Unsupported eval config extension. Use .json, .js, .mjs, or .cjs.");
   }
-  const absolute = path14__default.default.resolve(configPath);
+  const absolute = path16__default.default.resolve(configPath);
   if (extension === ".json") {
     const raw = await promises.readFile(absolute, "utf-8");
     return asConfig2(JSON.parse(raw));
@@ -15287,8 +15779,8 @@ function printHuman2(result) {
     console.log(`- ${diagnostic4.code}: ${diagnostic4.message}`);
   }
   for (const finding of result.findings) {
-    const path22 = finding.evidence[0]?.path;
-    console.log(`- ${finding.ruleId}: ${finding.message}${path22 ? ` (${path22})` : ""}`);
+    const path23 = finding.evidence[0]?.path;
+    console.log(`- ${finding.ruleId}: ${finding.message}${path23 ? ` (${path23})` : ""}`);
   }
 }
 function readErrorResult2(error) {
@@ -15526,8 +16018,8 @@ function printHuman3(result) {
     console.log(`- ${diagnostic4.code}: ${diagnostic4.message}`);
   }
   for (const finding of result.findings) {
-    const path22 = finding.evidence[0]?.path;
-    console.log(`- ${finding.ruleId}: ${finding.message}${path22 ? ` (${path22})` : ""}`);
+    const path23 = finding.evidence[0]?.path;
+    console.log(`- ${finding.ruleId}: ${finding.message}${path23 ? ` (${path23})` : ""}`);
   }
   console.log(`Note: ${result.note}`);
 }
@@ -15646,8 +16138,8 @@ function renderCheckSection(result) {
     `Diagnostics: ${result.diagnostics.length}`
   ];
   for (const finding of result.findings.slice(0, 10)) {
-    const path22 = finding.evidence[0]?.path ?? "(run)";
-    lines.push(`- ${finding.ruleId}: ${finding.message} (${path22})`);
+    const path23 = finding.evidence[0]?.path ?? "(run)";
+    lines.push(`- ${finding.ruleId}: ${finding.message} (${path23})`);
   }
   for (const diagnostic4 of result.diagnostics.slice(0, 10)) {
     lines.push(`- ${diagnostic4.code}: ${diagnostic4.message}`);
@@ -15725,8 +16217,8 @@ function renderHtml(trace, check, diff) {
 `;
 }
 async function writeArtifact(outputDir, relativePath, content, files) {
-  const outPath = path14__default.default.join(outputDir, relativePath);
-  await promises.mkdir(path14__default.default.dirname(outPath), { recursive: true });
+  const outPath = path16__default.default.join(outputDir, relativePath);
+  await promises.mkdir(path16__default.default.dirname(outPath), { recursive: true });
   await promises.writeFile(outPath, content, "utf-8");
   files.push(relativePath);
 }
@@ -15742,7 +16234,7 @@ function manifestStatus(check, diff) {
   return "ok";
 }
 async function artifactsCommand(target, options = {}, stdin = process.stdin) {
-  const outputDir = options.outputDir !== void 0 && options.outputDir.trim() !== "" ? path14__default.default.resolve(options.outputDir.trim()) : "";
+  const outputDir = options.outputDir !== void 0 && options.outputDir.trim() !== "" ? path16__default.default.resolve(options.outputDir.trim()) : "";
   if (outputDir === "") {
     console.error("--output-dir is required.");
     process.exitCode = 1;
@@ -15808,8 +16300,8 @@ async function artifactsCommand(target, options = {}, stdin = process.stdin) {
   await writeArtifact(outputDir, "report.html", renderHtml(trace, check, diff), files);
   const summaryTarget = options.githubSummary ?? process.env.GITHUB_STEP_SUMMARY;
   if (summaryTarget !== void 0 && summaryTarget.trim() !== "") {
-    await promises.mkdir(path14__default.default.dirname(path14__default.default.resolve(summaryTarget)), { recursive: true });
-    await promises.appendFile(path14__default.default.resolve(summaryTarget), `
+    await promises.mkdir(path16__default.default.dirname(path16__default.default.resolve(summaryTarget)), { recursive: true });
+    await promises.appendFile(path16__default.default.resolve(summaryTarget), `
 ${renderMarkdown(trace, check, diff)}`, "utf-8");
   }
   const manifestFiles = [...files, "manifest.json"].sort((a, b) => a.localeCompare(b));
@@ -15828,10 +16320,10 @@ ${renderMarkdown(trace, check, diff)}`, "utf-8");
       findings: diff?.findings.length ?? 0,
       diagnostics: diff?.diagnostics.length ?? 0
     },
-    ...summaryTarget !== void 0 && summaryTarget.trim() !== "" ? { githubSummary: path14__default.default.resolve(summaryTarget) } : {},
+    ...summaryTarget !== void 0 && summaryTarget.trim() !== "" ? { githubSummary: path16__default.default.resolve(summaryTarget) } : {},
     note: NOTE
   };
-  await promises.writeFile(path14__default.default.join(outputDir, "manifest.json"), writeJson3(manifest), "utf-8");
+  await promises.writeFile(path16__default.default.join(outputDir, "manifest.json"), writeJson3(manifest), "utf-8");
   if (options.json === true) {
     console.log(writeJson3(manifest).trimEnd());
   } else {
@@ -15843,7 +16335,7 @@ ${renderMarkdown(trace, check, diff)}`, "utf-8");
   }
 }
 function validateReporterArtifactPath(options) {
-  const outputDir = path14__default.default.resolve(options.outputDir);
+  const outputDir = path16__default.default.resolve(options.outputDir);
   const diagnostics = [];
   const rawPath = options.relativePath;
   if (rawPath.length === 0) {
@@ -15863,7 +16355,7 @@ function validateReporterArtifactPath(options) {
     });
     return { ok: false, outputDir, diagnostics };
   }
-  if (path14__default.default.isAbsolute(rawPath) || path14__default.default.win32.isAbsolute(rawPath)) {
+  if (path16__default.default.isAbsolute(rawPath) || path16__default.default.win32.isAbsolute(rawPath)) {
     diagnostics.push({
       code: "artifact_path_absolute",
       severity: "error",
@@ -15872,7 +16364,7 @@ function validateReporterArtifactPath(options) {
     });
     return { ok: false, outputDir, diagnostics };
   }
-  const normalized = path14__default.default.posix.normalize(rawPath.replace(/\\/g, "/"));
+  const normalized = path16__default.default.posix.normalize(rawPath.replace(/\\/g, "/"));
   const segments = normalized.split("/");
   if (normalized === "." || normalized.startsWith("../") || segments.some((segment) => segment === "..")) {
     diagnostics.push({
@@ -15883,9 +16375,9 @@ function validateReporterArtifactPath(options) {
     });
     return { ok: false, outputDir, diagnostics };
   }
-  const absolutePath = path14__default.default.resolve(outputDir, normalized);
-  const relFromOutput = path14__default.default.relative(outputDir, absolutePath);
-  if (relFromOutput.length === 0 || relFromOutput.startsWith("..") || path14__default.default.isAbsolute(relFromOutput)) {
+  const absolutePath = path16__default.default.resolve(outputDir, normalized);
+  const relFromOutput = path16__default.default.relative(outputDir, absolutePath);
+  if (relFromOutput.length === 0 || relFromOutput.startsWith("..") || path16__default.default.isAbsolute(relFromOutput)) {
     diagnostics.push({
       code: "artifact_path_escape",
       severity: "error",
@@ -16031,23 +16523,23 @@ function readManifestDocument(value) {
   };
 }
 function cwdRelative(filePath) {
-  const relative = path14__default.default.relative(process.cwd(), path14__default.default.resolve(filePath)).replace(/\\/g, "/");
-  if (relative === "" || relative.startsWith("../") || path14__default.default.isAbsolute(relative)) {
-    return path14__default.default.basename(filePath);
+  const relative = path16__default.default.relative(process.cwd(), path16__default.default.resolve(filePath)).replace(/\\/g, "/");
+  if (relative === "" || relative.startsWith("../") || path16__default.default.isAbsolute(relative)) {
+    return path16__default.default.basename(filePath);
   }
   return relative;
 }
 async function readReporterManifest(filePath) {
-  const absolute = path14__default.default.resolve(filePath);
+  const absolute = path16__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(path14__default.default.basename(result.file)) },
+    ...result.file === void 0 ? {} : { file: safeText(path16__default.default.basename(result.file)) },
     status: result.status,
-    ...result.tracePath === void 0 ? {} : { tracePath: safeText(path14__default.default.basename(result.tracePath)) },
+    ...result.tracePath === void 0 ? {} : { tracePath: safeText(path16__default.default.basename(result.tracePath)) },
     artifacts: result.artifacts,
     diagnostics: result.diagnostics
   }));
@@ -16186,15 +16678,15 @@ async function ciSummaryCommand(manifestPaths, options = {}) {
     return;
   }
   const markdown = renderMarkdown2(result);
-  const outputPath = options.output !== void 0 && options.output.trim() !== "" ? path14__default.default.resolve(options.output.trim()) : void 0;
+  const outputPath = options.output !== void 0 && options.output.trim() !== "" ? path16__default.default.resolve(options.output.trim()) : void 0;
   if (outputPath !== void 0) {
-    await promises.mkdir(path14__default.default.dirname(outputPath), { recursive: true });
+    await promises.mkdir(path16__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 = path14__default.default.resolve(summaryTarget);
-    await promises.mkdir(path14__default.default.dirname(summaryPath), { recursive: true });
+    const summaryPath = path16__default.default.resolve(summaryTarget);
+    await promises.mkdir(path16__default.default.dirname(summaryPath), { recursive: true });
     await promises.appendFile(summaryPath, `
 ${markdown}`, "utf-8");
   }
@@ -16342,8 +16834,8 @@ jobs:
 }
 async function planInit(options = {}) {
   const framework = normalizeFramework(options.framework);
-  const cwd = path14__default.default.resolve(options.cwd ?? process.cwd());
-  const demoPath = framework === "custom" ? path14__default.default.join("examples", "agent-inspect-demo.mjs") : path14__default.default.join("examples", `agent-inspect-${framework}-demo.mjs`);
+  const cwd = path16__default.default.resolve(options.cwd ?? process.cwd());
+  const demoPath = framework === "custom" ? path16__default.default.join("examples", "agent-inspect-demo.mjs") : path16__default.default.join("examples", `agent-inspect-${framework}-demo.mjs`);
   const candidates = [
     { rel: CONFIG_FILE, content: configTemplate(framework) },
     { rel: GITKEEP, content: "" },
@@ -16357,7 +16849,7 @@ async function planInit(options = {}) {
   }
   const files = [];
   for (const candidate of candidates) {
-    const abs = path14__default.default.join(cwd, candidate.rel);
+    const abs = path16__default.default.join(cwd, candidate.rel);
     try {
       await promises.access(abs);
       files.push({
@@ -16378,12 +16870,12 @@ async function writePlannedFiles(plan, cwd, options) {
     if (entry.action === "skip") {
       continue;
     }
-    const abs = path14__default.default.join(cwd, entry.path);
+    const abs = path16__default.default.join(cwd, entry.path);
     if (options.dryRun) {
       written.push(entry.path);
       continue;
     }
-    await promises.mkdir(path14__default.default.dirname(abs), { recursive: true });
+    await promises.mkdir(path16__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);
@@ -16391,7 +16883,7 @@ async function writePlannedFiles(plan, cwd, options) {
   return written;
 }
 async function initCommand(options = {}) {
-  const cwd = path14__default.default.resolve(options.cwd ?? process.cwd());
+  const cwd = path16__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);
@@ -16482,7 +16974,7 @@ function envCheck(name, optional = true) {
   };
 }
 async function traceDirWritable(traceDir) {
-  const resolved = path14__default.default.resolve(traceDir);
+  const resolved = path16__default.default.resolve(traceDir);
   try {
     await promises.mkdir(resolved, { recursive: true });
     await promises.access(resolved, promises.constants.W_OK);
@@ -16503,7 +16995,7 @@ async function traceDirWritable(traceDir) {
   }
 }
 function resolvePackage(cwd, name) {
-  const require2 = module$1.createRequire(path14__default.default.join(cwd, "package.json"));
+  const require2 = module$1.createRequire(path16__default.default.join(cwd, "package.json"));
   try {
     const pkgPath = require2.resolve(`${name}/package.json`);
     const pkg = require2(pkgPath);
@@ -16514,7 +17006,7 @@ function resolvePackage(cwd, name) {
 }
 function importSmoke(cwd) {
   const results = [];
-  const require2 = module$1.createRequire(path14__default.default.join(cwd, "package.json"));
+  const require2 = module$1.createRequire(path16__default.default.join(cwd, "package.json"));
   try {
     require2.resolve("agent-inspect");
     results.push({
@@ -16597,7 +17089,7 @@ function versionMismatchCheck(cwd) {
   };
 }
 async function runDoctorChecks(options = {}) {
-  const cwd = path14__default.default.resolve(options.cwd ?? process3__default.default.cwd());
+  const cwd = path16__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(),
@@ -16711,7 +17203,7 @@ function createTraceDirectoryIndexer() {
 init_advanced();
 var INDEX_FILENAME = ".agent-inspect-index.json";
 function traceIndexPath(traceDir) {
-  return path14__default.default.join(traceDir, INDEX_FILENAME);
+  return path16__default.default.join(traceDir, INDEX_FILENAME);
 }
 function parseMaxEntries(raw) {
   if (raw === void 0 || raw.trim() === "") return void 0;
@@ -16822,14 +17314,14 @@ async function indexCleanCommand(options = {}) {
 // packages/cli/src/index-sqlite-cmd.ts
 init_advanced();
 var PACKAGE = "@agent-inspect/index-sqlite";
-function isModuleNotFound2(e) {
+function isModuleNotFound3(e) {
   return e !== null && typeof e === "object" && "code" in e && (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "MODULE_NOT_FOUND");
 }
 async function loadIndexSqlite() {
   try {
     return await Promise.resolve().then(() => (init_src(), src_exports));
   } catch (e) {
-    if (isModuleNotFound2(e)) {
+    if (isModuleNotFound3(e)) {
       console.error(
         `The optional SQLite index is not installed. Run: npm install ${PACKAGE}`
       );
@@ -16850,14 +17342,14 @@ function parsePositiveInt(raw, flag) {
   }
   return parsed;
 }
-async function newestTraceMtimeMs(traceDir) {
+async function newestTraceMtimeMs2(traceDir) {
   let newest = 0;
   try {
     const files = await promises.readdir(traceDir);
     for (const file of files) {
       if (!file.endsWith(".jsonl")) continue;
       try {
-        const s = await promises.stat(path14__default.default.join(traceDir, file));
+        const s = await promises.stat(path16__default.default.join(traceDir, file));
         if (s.mtimeMs > newest) newest = s.mtimeMs;
       } catch {
       }
@@ -16887,7 +17379,7 @@ async function indexSqliteStatusCommand(options = {}) {
   const traceDir = resolveTraceDir({ dir: options.dir });
   const dbPath = mod.resolveIndexDbPath(traceDir);
   const status = mod.indexStatus(dbPath);
-  const stale = mod.isIndexStale(dbPath, await newestTraceMtimeMs(traceDir));
+  const stale = mod.isIndexStale(dbPath, await newestTraceMtimeMs2(traceDir));
   if (options.json) {
     console.log(JSON.stringify({ ok: true, traceDir, stale, ...status }, null, 2));
     return;
@@ -17136,19 +17628,19 @@ function serializeWorkspaceManifest(manifest) {
 }
 var INDEX_DIR_NAME = "index";
 function resolveWorkspaceLocation(cwd = process.cwd()) {
-  const projectRoot = path14__default.default.resolve(cwd);
-  const workspaceDir = path14__default.default.join(projectRoot, WORKSPACE_DIR_NAME);
+  const projectRoot = path16__default.default.resolve(cwd);
+  const workspaceDir = path16__default.default.join(projectRoot, WORKSPACE_DIR_NAME);
   return {
     projectRoot,
     workspaceDir,
-    manifestPath: path14__default.default.join(workspaceDir, WORKSPACE_MANIFEST_FILENAME)
+    manifestPath: path16__default.default.join(workspaceDir, WORKSPACE_MANIFEST_FILENAME)
   };
 }
 function resolveInsideWorkspace(workspaceDir, relative) {
-  const base = path14__default.default.resolve(workspaceDir);
-  const resolved = path14__default.default.resolve(base, relative);
-  const rel = path14__default.default.relative(base, resolved);
-  if (rel === "" || rel === "." || !rel.startsWith("..") && !path14__default.default.isAbsolute(rel)) {
+  const base = path16__default.default.resolve(workspaceDir);
+  const resolved = path16__default.default.resolve(base, relative);
+  const rel = path16__default.default.relative(base, resolved);
+  if (rel === "" || rel === "." || !rel.startsWith("..") && !path16__default.default.isAbsolute(rel)) {
     return resolved;
   }
   throw new Error(
@@ -17217,7 +17709,7 @@ async function createWorkspace(options = {}) {
     created = false;
     adopted = true;
   } else {
-    const project = options.project?.trim() || path14__default.default.basename(location.projectRoot) || "workspace";
+    const project = options.project?.trim() || path16__default.default.basename(location.projectRoot) || "workspace";
     const traceDirs = detectedExistingTraces ? ["runs", "."] : ["runs"];
     manifest = createDefaultWorkspaceManifest({
       project,
@@ -17356,7 +17848,7 @@ async function doctorWorkspace(location) {
     const abs = resolveInsideWorkspace(location.workspaceDir, rel);
     for (const file of await listJsonl(abs)) {
       try {
-        const s = await promises.stat(path14__default.default.join(abs, file));
+        const s = await promises.stat(path16__default.default.join(abs, file));
         newestTraceMtime = Math.max(newestTraceMtime, s.mtimeMs);
       } catch {
         checks2.push({ id: "trace-readability", status: "warn", message: `cannot stat ${rel}/${file}` });
@@ -17404,7 +17896,7 @@ async function cleanWorkspace(location, manifest, options = {}) {
       const relPath = `${rel}/${entry}`;
       removed.push(relPath);
       if (!dryRun) {
-        await promises.rm(path14__default.default.join(abs, entry), { recursive: true, force: true });
+        await promises.rm(path16__default.default.join(abs, entry), { recursive: true, force: true });
       }
     }
   }
@@ -17810,12 +18302,32 @@ function createCliProgram() {
   ).option("--json", "print results as JSON").action((opts) => {
     runCommand(() => searchCommand(opts));
   });
-  program.command("sessions").description("List workflow sessions grouped from local trace metadata (read-only)").option("--dir <path>", "trace directory").option(
+  const sessionsCmd = program.command("sessions").description(
+    "Workflow sessions and activity from local trace metadata (read-only, v4.2+)"
+  ).option("--dir <path>", "trace directory").option(
     "--correlate-group",
     "treat shared groupId as a synthetic session when sessionId is absent"
-  ).option("--json", "print sessions index as JSON").action((opts) => {
+  ).option("--json", "print JSON output").option(
+    "--stale-after <duration>",
+    "mark sessions stale after inactivity (e.g. 24h, 7d)"
+  ).action((opts) => {
     runCommand(() => sessionsCommand(opts));
   });
+  sessionsCmd.command("latest").description("Show the most recently active session").option("--dir <path>", "trace directory").option("--correlate-group", "include synthetic group: sessions").option("--stale-after <duration>", "staleness threshold for status derivation").option("--json", "print JSON result").action((opts) => {
+    runCommand(() => sessionsLatestCommand(opts));
+  });
+  sessionsCmd.command("activity").description("Summarize recent session activity").option("--dir <path>", "trace directory").option("--since <duration>", "activity window (default 7d)").option("--correlate-group", "include synthetic group: sessions").option("--stale-after <duration>", "staleness threshold for status derivation").option("--json", "print JSON result").action((opts) => {
+    runCommand(() => sessionsActivityCommand(opts));
+  });
+  sessionsCmd.command("show").description("Show one session (alias for session <id>)").argument("<session-id>", "session id").option("--dir <path>", "trace directory").option("--timeline", "include per-run timelines").option("--critical-path", "include critical path section").option("--diagnostics", "include ambiguity warnings").option("--json", "print JSON result").action((sessionId, opts) => {
+    runCommand(() => sessionsShowCommand(sessionId, opts));
+  });
+  sessionsCmd.command("handoffs").description("List handoff edges across sessions").option("--dir <path>", "trace directory").option("--session <id>", "limit to one session").option("--correlate-group", "include synthetic group: sessions").option("--json", "print JSON result").action((opts) => {
+    runCommand(() => sessionsHandoffsCommand(opts));
+  });
+  sessionsCmd.command("errors").description("List sessions with errors in a time window").option("--dir <path>", "trace directory").option("--since <duration>", "filter by last activity (default: all)").option("--correlate-group", "include synthetic group: sessions").option("--stale-after <duration>", "staleness threshold for status derivation").option("--json", "print JSON result").action((opts) => {
+    runCommand(() => sessionsErrorsCommand(opts));
+  });
   program.command("session").description("Inspect one workflow session: runs, handoffs, retries (read-only)").argument("<session-id>", "session id (from sessions output)").option("--dir <path>", "trace directory").option("--timeline", "include per-run timelines").option("--critical-path", "include critical path section").option("--diagnostics", "include ambiguity warnings").option("--json", "print session view as JSON").action((sessionId, opts) => {
     runCommand(() => sessionCommand(sessionId, opts));
   });
@@ -17944,9 +18456,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(path14__default.default.resolve(entry)) === fs.realpathSync(path14__default.default.resolve(selfPath));
+    return fs.realpathSync(path16__default.default.resolve(entry)) === fs.realpathSync(path16__default.default.resolve(selfPath));
   } catch {
-    return path14__default.default.resolve(entry) === path14__default.default.resolve(selfPath);
+    return path16__default.default.resolve(entry) === path16__default.default.resolve(selfPath);
   }
 }
 if (isPrimaryModule()) {