@titan-design/session-analytics 0.5.0 → 0.6.0

package/dist/index.js

@@ -515,6 +515,8 @@ var reviewerCostSchema = z.object({
   requestsPerPr: z.number(),
   /** The reviewer model whose sessions give `requestsPerPr`: the row's own, else the newest reviewer cohort; `pooled` with none. */
   requestsFrom: z.string(),
+  /** Sessions in the `requestsFrom` cohort; 1 means the per-PR figure rests on one session. */
+  requestsFromSessions: count,
   costUsd: z.number()
 });
 var reviewerSchema = z.object({ prs: count, fresh: z.array(reviewerCostSchema), standing: z.array(reviewerCostSchema) });
@@ -533,9 +535,9 @@ var handoffThresholdSchema = z.object({
 function isBootAction(calls) {
   return calls.some((call) => BOOT_TOOL.test(call.tool) || (call.writePaths?.length ?? 0) > 0);
 }
-function parseTeleportEvents(lines) {
+function parseTeleportEvents(lines2) {
   const events = [];
-  for (const line of lines) {
+  for (const line of lines2) {
     const entry = parseJson(line);
     if (entry?.event !== TELEPORT_EVENT || typeof entry.from !== "string" || typeof entry.ts !== "string") continue;
     events.push({ ts: entry.ts, name: typeof entry.name === "string" ? entry.name : null, fromAgentId: entry.from });
@@ -593,7 +595,7 @@ function fitSession(unsorted, prices, sweep) {
   const price = findPrice(first.model, first.ts, prices);
   if (bootIndex < 0 || price === null) return null;
   const params = {
-    bootCostUsd: requests.slice(0, bootIndex + 1).reduce((sum, row) => sum + priceRequest(row.tokens, row.model, row.ts, prices).costUsd, 0),
+    bootCostUsd: requests.slice(0, bootIndex + 1).reduce((sum2, row) => sum2 + priceRequest(row.tokens, row.model, row.ts, prices).costUsd, 0),
     bootFill: requests[bootIndex].fill,
     growthPerRequest: meanGrowth(requests.slice(bootIndex).map((row) => row.fill)),
     readPricePerMTok: price.cacheRead
@@ -622,7 +624,7 @@ function cohortsOf(sessions, sweep, configuredK) {
   }).sort((a, b) => a.role.localeCompare(b.role) || a.model.localeCompare(b.model));
 }
 function meanParams(sessions) {
-  const mean = (pick) => sessions.reduce((sum, s) => sum + pick(s), 0) / sessions.length;
+  const mean = (pick) => sessions.reduce((sum2, s) => sum2 + pick(s), 0) / sessions.length;
   return {
     bootCostUsd: mean((s) => s.bootCostUsd),
     bootFill: mean((s) => s.bootFill),
@@ -632,7 +634,7 @@ function meanParams(sessions) {
 }
 function meanGrowthOf(sessions) {
   const grown = sessions.filter((s) => s.growthPerRequest > 0);
-  return grown.length === 0 ? 0 : grown.reduce((sum, s) => sum + s.growthPerRequest, 0) / grown.length;
+  return grown.length === 0 ? 0 : grown.reduce((sum2, s) => sum2 + s.growthPerRequest, 0) / grown.length;
 }
 function teleportExit(event, agentSessions2, bySession, cohorts, configuredK) {
   const candidates = (agentSessions2.get(event.fromAgentId) ?? []).flatMap((id) => bySession.get(id) ?? []);
@@ -661,7 +663,8 @@ function reviewerComparison(sessions, reviewerRole, standingRole, prs) {
   const priced = (role, costOf2) => cohorts(role).map(([model, members]) => {
     const from = perPr.has(model) ? model : newest;
     const requestsPerPr = from === null ? 0 : perPr.get(from);
-    return { role, model, sessions: members.length, requestsPerPr, requestsFrom: from ?? POOLED_REVIEWERS, costUsd: costOf2(meanParams(members), requestsPerPr) };
+    const requestsFromSessions = from === null ? 0 : reviewers.find(([name]) => name === from)?.[1].length ?? 0;
+    return { role, model, sessions: members.length, requestsPerPr, requestsFrom: from ?? POOLED_REVIEWERS, requestsFromSessions, costUsd: costOf2(meanParams(members), requestsPerPr) };
   });
   return {
     prs,
@@ -670,12 +673,13 @@ function reviewerComparison(sessions, reviewerRole, standingRole, prs) {
   };
 }
 function newestCohort(reviewers) {
-  const latest = reviewers.map(([model, members]) => ({ model, ts: members.reduce((max, s) => s.lastTs > max ? s.lastTs : max, "") }));
-  latest.sort((a, b) => b.ts.localeCompare(a.ts) || b.model.localeCompare(a.model));
+  const epoch = (ts) => Number.isNaN(Date.parse(ts)) ? Number.NEGATIVE_INFINITY : Date.parse(ts);
+  const latest = reviewers.map(([model, members]) => ({ model, at: Math.max(...members.map((s) => epoch(s.lastTs))) }));
+  latest.sort((a, b) => a.at === b.at ? b.model.localeCompare(a.model) : b.at - a.at);
   return latest[0]?.model ?? null;
 }
 function meanRequestsAfterBoot(sessions) {
-  return sessions.length === 0 ? 0 : sessions.reduce((sum, s) => sum + s.requests - s.bootRequests, 0) / sessions.length;
+  return sessions.length === 0 ? 0 : sessions.reduce((sum2, s) => sum2 + s.requests - s.bootRequests, 0) / sessions.length;
 }
 function groupBy(rows, keyOf) {
   const groups = /* @__PURE__ */ new Map();
@@ -765,6 +769,7 @@ var PROFILE_ROLES = {
   "fable-architect": "planner",
   planner: "planner",
   "bd-planner": "planner",
+  decider: "planner",
   "fable-coordinator": "coordinator",
   "opus-coordinator": "coordinator",
   peer: "standing_peer"
@@ -919,7 +924,7 @@ function buildWakeEpisodes(events, requests, names, noActionClasses) {
       from: pairSender(fromKind, event.fromName, names.seats),
       to: names.receivers.get(event.sessionId) ?? UNNAMED,
       requests: members.length,
-      costUsd: members.reduce((sum, row) => sum + row.costUsd, 0),
+      costUsd: members.reduce((sum2, row) => sum2 + row.costUsd, 0),
       noAction: members.every((row) => noActionClasses.includes(row.action))
     };
   });
@@ -935,20 +940,20 @@ function summarizeWakeEpisodes(episodes, requests, roles, noActionClasses) {
     roles: [...roles],
     noActionClasses: [...noActionClasses],
     ...costOf(episodes),
-    unattributed: { requests: unattributed.length, costUsd: unattributed.reduce((sum, row) => sum + row.costUsd, 0) },
+    unattributed: { requests: unattributed.length, costUsd: unattributed.reduce((sum2, row) => sum2 + row.costUsd, 0) },
     byCause: causeBuckets(episodes),
     pairs: pairBuckets(episodes)
   };
 }
 function costOf(episodes) {
   const noAction = episodes.filter((episode) => episode.noAction);
-  const sum = (list, pick) => list.reduce((total, episode) => total + pick(episode), 0);
+  const sum2 = (list, pick) => list.reduce((total, episode) => total + pick(episode), 0);
   return {
     episodes: episodes.length,
-    requests: sum(episodes, (episode) => episode.requests),
-    costUsd: sum(episodes, (episode) => episode.costUsd),
+    requests: sum2(episodes, (episode) => episode.requests),
+    costUsd: sum2(episodes, (episode) => episode.costUsd),
     noActionEpisodes: noAction.length,
-    noActionCostUsd: sum(noAction, (episode) => episode.costUsd)
+    noActionCostUsd: sum2(noAction, (episode) => episode.costUsd)
   };
 }
 function causeBuckets(episodes) {
@@ -969,7 +974,7 @@ function pairBuckets(episodes) {
   return [...groupBy2(sent, (episode) => JSON.stringify([episode.from, episode.fromKind, episode.to]))].map(([key, members]) => {
     const [from, fromKind, to] = JSON.parse(key);
     return { from, fromKind, to, ...costOf(members) };
-  }).sort((a, b) => b.costUsd - a.costUsd || a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
+  }).sort((a, b) => b.costUsd - a.costUsd || a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.fromKind.localeCompare(b.fromKind));
 }
 function groupBy2(rows, keyOf) {
   const groups = /* @__PURE__ */ new Map();
@@ -1096,7 +1101,7 @@ function episodeCountKey(episodes) {
   return episodes >= EPISODE_COUNT_CAP ? `${EPISODE_COUNT_CAP}+` : String(episodes);
 }
 function sumOf(rows) {
-  return { requests: rows.length, costUsd: rows.reduce((sum, row) => sum + row.costUsd, 0) };
+  return { requests: rows.length, costUsd: rows.reduce((sum2, row) => sum2 + row.costUsd, 0) };
 }
 function tokenClasses(rows) {
   const pick = {
@@ -1108,7 +1113,7 @@ function tokenClasses(rows) {
   };
   return TOKEN_CLASSES.map((tokenClass) => {
     const pairs = rows.map(pick[tokenClass]);
-    return { tokenClass, tokens: pairs.reduce((sum, [tokens]) => sum + tokens, 0), costUsd: pairs.reduce((sum, [, cost]) => sum + cost, 0) };
+    return { tokenClass, tokens: pairs.reduce((sum2, [tokens]) => sum2 + tokens, 0), costUsd: pairs.reduce((sum2, [, cost]) => sum2 + cost, 0) };
   });
 }
 function dimensionBuckets(rows) {
@@ -1208,7 +1213,7 @@ function compactionCounts(rows) {
     manual: rows.filter((row) => row.trigger === "manual").length,
     auto: rows.filter((row) => row.trigger === "auto").length,
     midLoop: rows.filter((row) => row.midLoop).length,
-    droppedTokens: rows.reduce((sum, row) => sum + (row.droppedTokens ?? 0), 0)
+    droppedTokens: rows.reduce((sum2, row) => sum2 + (row.droppedTokens ?? 0), 0)
   };
 }
 function topSessions(rows, top) {
@@ -1219,7 +1224,7 @@ function topSessions(rows, top) {
 }
 function unpricedModels(rows) {
   const unpriced = rows.filter((row) => !row.priced);
-  return [...groupRows(unpriced, (row) => row.model)].map(([model, members]) => ({ model, requests: members.length, tokens: members.reduce((sum, row) => sum + tokensOf(row), 0) })).sort((a, b) => b.tokens - a.tokens || a.model.localeCompare(b.model));
+  return [...groupRows(unpriced, (row) => row.model)].map(([model, members]) => ({ model, requests: members.length, tokens: members.reduce((sum2, row) => sum2 + tokensOf(row), 0) })).sort((a, b) => b.tokens - a.tokens || a.model.localeCompare(b.model));
 }
 function tokensOf(row) {
   return row.inputTokens + row.cacheReadTokens + row.cacheWrite5mTokens + row.cacheWrite1hTokens + row.outputTokens;
@@ -1283,8 +1288,8 @@ function bucketTable(title, buckets2, total) {
 }
 function actionTable(roles) {
   const rows = roles.flatMap(({ role, buckets: buckets2 }) => {
-    const total = buckets2.reduce((sum, b) => sum + b.costUsd, 0);
-    const requests = buckets2.reduce((sum, b) => sum + b.requests, 0);
+    const total = buckets2.reduce((sum2, b) => sum2 + b.costUsd, 0);
+    const requests = buckets2.reduce((sum2, b) => sum2 + b.requests, 0);
     return [[role, requests, usd(total), share(total, total)], ...buckets2.map((b) => [`  ${b.key}`, b.requests, usd(b.costUsd), share(b.costUsd, total)])];
   });
   return table("By action per role", ["role / action", "requests", "cost", "share"], rows);
@@ -1377,8 +1382,8 @@ function table(title, head, rows) {
   const widths = head.map((_, i) => Math.max(...text.map((row) => row[i].length)));
   const rightAligned = head.map((_, i) => rows.every((row) => isNumeric(row[i])));
   const pad = (cell, i) => rightAligned[i] ? cell.padStart(widths[i]) : cell.padEnd(widths[i]);
-  const lines = text.map((row) => row.map(pad).join("  ").trimEnd());
-  return [title, ...lines].join("\n");
+  const lines2 = text.map((row) => row.map(pad).join("  ").trimEnd());
+  return [title, ...lines2].join("\n");
 }
 function isNumeric(cell) {
   return typeof cell === "number" || /^\$|%$/.test(cell);
@@ -1455,17 +1460,17 @@ function requestEffect(row, price) {
   };
 }
 function sumEffects(effects) {
-  const sum = (pick) => effects.reduce((total, effect) => total + pick(effect), 0);
+  const sum2 = (pick) => effects.reduce((total, effect) => total + pick(effect), 0);
   const sessions = new Set(effects.map((effect) => effect.sessionId)).size;
-  const netSavingUsd = sum((effect) => effect.repriceSavingUsd - effect.rebuildCostUsd);
+  const netSavingUsd = sum2((effect) => effect.repriceSavingUsd - effect.rebuildCostUsd);
   return {
     sessions,
     requests: effects.length,
-    write1hTokens: sum((effect) => effect.write1hTokens),
-    repriceSavingUsd: sum((effect) => effect.repriceSavingUsd),
+    write1hTokens: sum2((effect) => effect.write1hTokens),
+    repriceSavingUsd: sum2((effect) => effect.repriceSavingUsd),
     rebuilds: effects.filter((effect) => effect.rebuildTokens > 0).length,
-    rebuildTokens: sum((effect) => effect.rebuildTokens),
-    rebuildCostUsd: sum((effect) => effect.rebuildCostUsd),
+    rebuildTokens: sum2((effect) => effect.rebuildTokens),
+    rebuildCostUsd: sum2((effect) => effect.rebuildCostUsd),
     netSavingUsd,
     netPerSessionUsd: sessions > 0 ? netSavingUsd / sessions : 0
   };
@@ -1630,10 +1635,10 @@ function classifyDeniedAction(tool, input) {
 function bashAction(command) {
   return BASH_ACTIONS.find(([, pattern]) => pattern.test(command))?.[0] ?? "bash-other";
 }
-function parseDenials(lines, seat) {
+function parseDenials(lines2, seat) {
   const calls = /* @__PURE__ */ new Map();
   const denials = [];
-  for (const line of lines) {
+  for (const line of lines2) {
     if (!line.includes('"tool_use"') && !line.includes("auto mode classifier")) continue;
     const entry = parseLine(line);
     for (const block of blocksOf(entry)) {
@@ -1641,11 +1646,22 @@ function parseDenials(lines, seat) {
       const reason = block.type === "tool_result" ? DENIAL.exec(resultText(block.content))?.[1] : void 0;
       if (reason === void 0) continue;
       const call = calls.get(block.tool_use_id ?? "") ?? { tool: "unknown", input: null };
-      denials.push({ seat, at: entry?.timestamp ?? "", reason, action: classifyDeniedAction(call.tool, call.input), tool: call.tool });
+      const toolUseId = block.tool_use_id ? { toolUseId: block.tool_use_id } : {};
+      denials.push({ seat, at: entry?.timestamp ?? "", reason, action: classifyDeniedAction(call.tool, call.input), tool: call.tool, ...toolUseId });
     }
   }
   return denials;
 }
+function dedupeDenials(denials) {
+  const seen = /* @__PURE__ */ new Set();
+  return denials.filter((d) => {
+    if (d.toolUseId === void 0) return true;
+    const key = `${d.seat}\0${d.toolUseId}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
 function parseLine(line) {
   try {
     return JSON.parse(line);
@@ -1781,9 +1797,9 @@ function blockedFlowReport(input) {
     ...input.splitAt ? { splitAt: input.splitAt } : {},
     sources: BLOCKED_FLOW_SOURCES,
     verdictToMerge: { cites: ["verdicts", "pulls"], rows: latencyRows(outcomes, input.splitAt) },
-    openHoldingMerge: { cites: ["verdicts", "pulls"], prMinutes: round(open.reduce((sum, r) => sum + r.ageMin, 0)), rows: open },
-    denials: denialSection(input.denials.filter((d) => inScope(d.seat, d.at))),
-    idleSlots: { cites: ["journals"], holdMaxMin: TICK_HOLD_MAX_MIN, total: idle.reduce((sum, r) => sum + r.slotMinutes, 0), rows: idle }
+    openHoldingMerge: { cites: ["verdicts", "pulls"], prMinutes: round(open.reduce((sum2, r) => sum2 + r.ageMin, 0)), rows: open },
+    denials: denialSection(dedupeDenials(input.denials).filter((d) => inScope(d.seat, d.at))),
+    idleSlots: { cites: ["journals"], holdMaxMin: TICK_HOLD_MAX_MIN, total: idle.reduce((sum2, r) => sum2 + r.slotMinutes, 0), rows: idle }
   };
 }
 function scopeTest(seats, window) {
@@ -1846,6 +1862,282 @@ function idleTable(report) {
 function sourceLines(report) {
   return ["Sources", ...Object.entries(report.sources).map(([name, s]) => `${name}: ${s.command} (${s.field})`)].join("\n");
 }
+
+// src/liveness-broker.ts
+function parseBrokerLog(lines2) {
+  const entries = [];
+  let line = 0;
+  for (const text of lines2) {
+    line += 1;
+    const fields = text.startsWith("{") ? parseObject(text) : null;
+    if (fields && typeof fields.ts === "string" && typeof fields.event === "string") entries.push({ line, ts: fields.ts, event: fields.event, fields });
+  }
+  return entries;
+}
+function parseObject(text) {
+  try {
+    const value = JSON.parse(text);
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+function stringField(entry, key) {
+  const value = entry.fields[key];
+  return typeof value === "string" ? value : null;
+}
+function splitNames(to) {
+  return (to ?? "").split(",").map((name) => name.trim()).filter((name) => name.length > 0);
+}
+function minutesBetween2(from, to) {
+  return Math.round((Date.parse(to) - Date.parse(from)) / 6e3) / 10;
+}
+
+// src/liveness-routes.ts
+var INBOX_KINDS = /* @__PURE__ */ new Set(["answer", "decided"]);
+function routeMisses(entries) {
+  return entries.filter((e) => e.event === "route").flatMap((entry) => {
+    const base = { line: entry.line, at: entry.ts, from: stringField(entry, "from") ?? "", kind: stringField(entry, "kind") ?? "" };
+    return missedRecipients(entry).map(({ recipient, miss }) => ({ ...base, recipient, miss }));
+  });
+}
+function missedRecipients(entry) {
+  const to = stringField(entry, "to");
+  const kind = stringField(entry, "kind") ?? "";
+  if (to === null || to.startsWith("tag ") || kind === "broadcast") return [];
+  const named = splitNames(to);
+  if (entry.fields.delivered === false) {
+    const miss = entry.fields.held !== void 0 || INBOX_KINDS.has(kind) ? "queued" : "failed";
+    return named.map((recipient) => ({ recipient, miss }));
+  }
+  const reached = entry.fields.recipients;
+  if (entry.fields.delivered !== true || !Array.isArray(reached)) return [];
+  return named.filter((name) => !reached.includes(name)).map((recipient) => ({ recipient, miss: "partial" }));
+}
+function routeFailureRows(misses) {
+  const rows = /* @__PURE__ */ new Map();
+  for (const m of misses) {
+    const row = rows.get(m.recipient) ?? { recipient: m.recipient, failed: 0, partial: 0, queued: 0, first: m.at, last: m.at, lines: [] };
+    rows.set(m.recipient, { ...row, [m.miss]: row[m.miss] + 1, last: m.at, lines: [...row.lines, m.line] });
+  }
+  const total = (r) => r.failed + r.partial + r.queued;
+  return [...rows.values()].sort((a, b) => total(b) - total(a) || a.recipient.localeCompare(b.recipient));
+}
+function countMisses(misses) {
+  return { failed: misses.filter((m) => m.miss === "failed").length, partial: misses.filter((m) => m.miss === "partial").length, queued: misses.filter((m) => m.miss === "queued").length };
+}
+
+// src/liveness-dark.ts
+var DARK_MIN = 5;
+var TELEPORT_EVENTS = /* @__PURE__ */ new Set(["teleport_started", "teleport_completed", "teleport_failed", "teleport_aborted"]);
+function darkGaps(entries, misses, asOf) {
+  return gapsByLifecycle(entries, asOf).filter((gap) => minutesBetween2(gap.from, gap.to ?? asOf) > DARK_MIN).map((gap) => toDarkGap(gap, misses, asOf)).filter((gap) => gap.to !== null || gap.failedRoutes + gap.partialRoutes + gap.queuedRoutes > 0).sort((a, b) => a.from.localeCompare(b.from) || a.seat.localeCompare(b.seat));
+}
+function gapsByLifecycle(entries, asOf) {
+  const states = /* @__PURE__ */ new Map();
+  const gaps = [];
+  const keep = (state, gap) => {
+    if (!state.exited || gap.teleportLines.length > 0) gaps.push(gap);
+  };
+  for (const entry of entries) {
+    const seat = stringField(entry, "name");
+    if (seat === null || entry.ts >= asOf) continue;
+    const state = states.get(seat) ?? { open: null, teleportLines: [], exited: false };
+    states.set(seat, state);
+    step(state, entry, (gap) => keep(state, { ...gap, seat, to: entry.ts, closeLine: entry.line }));
+  }
+  for (const [seat, state] of states) if (state.open) keep(state, { ...state.open, seat, to: null });
+  return gaps;
+}
+function step(state, entry, close) {
+  if (entry.event === "agent_exited") {
+    state.exited ||= exitedCleanly(entry);
+  } else if (TELEPORT_EVENTS.has(entry.event)) {
+    state.teleportLines.push(entry.line);
+    state.open?.teleportLines.push(entry.line);
+  } else if (entry.event === "deregistered" && !state.open) {
+    state.open = { from: entry.ts, lines: [entry.line], teleportLines: [...state.teleportLines] };
+  } else if (entry.event === "registered") {
+    if (state.open) close(state.open);
+    state.open = null;
+    state.teleportLines = [];
+    state.exited = false;
+  }
+}
+function exitedCleanly(entry) {
+  return entry.fields.code === 0 && entry.fields.inferred !== true;
+}
+function toDarkGap(gap, misses, asOf) {
+  const end = gap.to ?? asOf;
+  const missed = misses.filter((m) => m.recipient === gap.seat && m.at >= gap.from && m.at < end);
+  const counts = countMisses(missed);
+  return {
+    seat: gap.seat,
+    from: gap.from,
+    to: gap.to,
+    minutes: minutesBetween2(gap.from, end),
+    teleport: gap.teleportLines.length > 0,
+    failedRoutes: counts.failed,
+    partialRoutes: counts.partial,
+    queuedRoutes: counts.queued,
+    lines: [...gap.lines, ...gap.closeLine === void 0 ? [] : [gap.closeLine], ...gap.teleportLines],
+    routeLines: missed.map((m) => m.line)
+  };
+}
+
+// src/liveness-exits.ts
+var UNKNOWN_PROFILE = "unknown";
+function unreportedExitRows(entries, spawns) {
+  const byAgent = new Map(spawns.map((s) => [s.agentId, s]));
+  const rows = /* @__PURE__ */ new Map();
+  for (const entry of entries.filter((e) => e.event === "unreported-exit")) {
+    const agentId = stringField(entry, "agentId") ?? "";
+    const spawn = byAgent.get(agentId);
+    const profile = spawn?.profile ?? UNKNOWN_PROFILE;
+    const exit = {
+      at: entry.ts,
+      line: entry.line,
+      agentId,
+      name: stringField(entry, "name") ?? spawn?.name ?? "",
+      spawner: stringField(entry, "spawner") ?? "",
+      lastAction: stringField(entry, "lastAction") ?? "",
+      spawnEventId: spawn?.eventId ?? null
+    };
+    rows.set(profile, [...rows.get(profile) ?? [], exit]);
+  }
+  return [...rows.entries()].map(([profile, exits]) => ({ profile, count: exits.length, exits })).sort((a, b) => b.count - a.count || a.profile.localeCompare(b.profile));
+}
+
+// src/liveness-prompts.ts
+var PROMPT_STALE_MIN = 10;
+function stalePromptRows(lastEvents, broker, asOf) {
+  const gone = goneSinceRestart(broker, asOf);
+  return lastEvents.filter((e) => e.kind === "approval_request" && e.at < asOf && e.endEventId === null && !gone(e)).map((e) => ({ agent: e.actor, at: e.at, ageMin: minutesBetween2(e.at, asOf), tool: e.tool, eventId: e.eventId, resolutionEventId: e.resolutionEventId })).filter((row) => row.ageMin > PROMPT_STALE_MIN).sort((a, b) => b.ageMin - a.ageMin || a.agent.localeCompare(b.agent));
+}
+function goneSinceRestart(broker, asOf) {
+  const before = broker.filter((e) => e.ts < asOf);
+  const restart = before.filter((e) => e.event === "broker_started").at(-1)?.ts;
+  if (restart === void 0) return () => false;
+  const live = new Set(before.filter((e) => e.event === "registered" && e.ts >= restart).map((e) => stringField(e, "name")));
+  return (e) => e.at < restart && !live.has(e.actor);
+}
+
+// src/liveness.ts
+import { z as z7 } from "zod";
+var LIVENESS_SOURCES = {
+  registrations: {
+    command: `grep -nE '"event":"(registered|deregistered|agent_exited|teleport_started|teleport_completed|teleport_failed|teleport_aborted)"' <broker.log>`,
+    field: "ts, event, name; cited as broker.log line numbers; a gap with a clean agent_exited (code 0, not inferred) and no teleport is a resume"
+  },
+  routes: { command: `grep -n '"event":"route"' <broker.log>`, field: "to, delivered, recipients" },
+  exits: { command: `grep -n '"event":"unreported-exit"' <broker.log>`, field: "agentId, name, spawner, lastAction" },
+  spawns: {
+    command: `sqlite3 -readonly <events.db> "SELECT id, msg_id, target, json_extract(meta,'$.profile') FROM events WHERE kind='agent_spawned'"`,
+    field: "events.msg_id (agent id), events.meta.profile"
+  },
+  prompts: {
+    command: `sqlite3 -readonly <events.db> "SELECT e.* FROM events e JOIN (SELECT actor, max(id) id FROM events WHERE ts < <asOf> AND kind != 'resolution' GROUP BY actor) l ON e.id = l.id WHERE e.kind='approval_request'"`,
+    field: "events.ts, events.actor, events.meta.tool_name; a resolution row's events.ref; skipped after the actor's agent_exited or agent_retired, or a broker_started it never re-registered after"
+  }
+};
+var source2 = z7.enum(["registrations", "routes", "exits", "spawns", "prompts"]);
+var count6 = z7.number().int().nonnegative();
+var lines = z7.array(count6);
+var darkRow = z7.object({
+  seat: z7.string(),
+  from: z7.string(),
+  to: z7.string().nullable(),
+  minutes: z7.number(),
+  teleport: z7.boolean(),
+  failedRoutes: count6,
+  partialRoutes: count6,
+  queuedRoutes: count6,
+  lines,
+  routeLines: lines
+});
+var exitRow = z7.object({ at: z7.string(), line: count6, agentId: z7.string(), name: z7.string(), spawner: z7.string(), lastAction: z7.string(), spawnEventId: count6.nullable() });
+var promptRow = z7.object({ agent: z7.string(), at: z7.string(), ageMin: z7.number(), tool: z7.string().nullable(), eventId: count6, resolutionEventId: count6.nullable() });
+var livenessSchema = z7.object({
+  asOf: z7.string(),
+  window: z7.object({ since: z7.string().optional(), until: z7.string().optional() }),
+  thresholds: z7.object({ darkMin: z7.number(), promptStaleMin: z7.number() }),
+  sources: z7.record(source2, z7.object({ command: z7.string(), field: z7.string() })),
+  darkSeats: z7.object({ cites: z7.array(source2), withTeleport: count6, withoutTeleport: count6, rows: z7.array(darkRow) }),
+  routeFailures: z7.object({
+    cites: z7.array(source2),
+    failed: count6,
+    partial: count6,
+    queued: count6,
+    rows: z7.array(z7.object({ recipient: z7.string(), failed: count6, partial: count6, queued: count6, first: z7.string(), last: z7.string(), lines }))
+  }),
+  unreportedExits: z7.object({ cites: z7.array(source2), total: count6, rows: z7.array(z7.object({ profile: z7.string(), count: count6, exits: z7.array(exitRow) })) }),
+  stalePrompts: z7.object({ cites: z7.array(source2), rows: z7.array(promptRow), resolvedRows: z7.array(promptRow) })
+});
+function livenessReport(input) {
+  const window = input.window ?? {};
+  const keep = scopeTest2(input.seats, window);
+  const broker = input.broker.filter((e) => e.ts < input.asOf);
+  const misses = routeMisses(broker);
+  const dark = darkGaps(broker, misses, input.asOf).filter((g) => keep([g.seat], g.from));
+  const routeMissesInScope = misses.filter((m) => keep([m.recipient], m.at));
+  const routes = routeFailureRows(routeMissesInScope);
+  const prompts = stalePromptRows(input.lastEvents, broker, input.asOf).filter((p) => !input.seats || input.seats.includes(p.agent));
+  const exits = unreportedExitRows(broker.filter((e) => keep([stringField(e, "name") ?? "", stringField(e, "spawner") ?? ""], e.ts)), input.spawns);
+  return {
+    asOf: input.asOf,
+    window,
+    thresholds: { darkMin: DARK_MIN, promptStaleMin: PROMPT_STALE_MIN },
+    sources: LIVENESS_SOURCES,
+    darkSeats: { cites: ["registrations", "routes"], withTeleport: dark.filter((g) => g.teleport).length, withoutTeleport: dark.filter((g) => !g.teleport).length, rows: dark },
+    routeFailures: { cites: ["routes"], ...countMisses(routeMissesInScope), rows: routes },
+    unreportedExits: { cites: ["exits", "spawns"], total: sum(exits.map((r) => r.count)), rows: exits },
+    stalePrompts: { cites: ["prompts"], rows: prompts.filter((p) => p.resolutionEventId === null), resolvedRows: prompts.filter((p) => p.resolutionEventId !== null) }
+  };
+}
+function scopeTest2(seats, window) {
+  const named = seats ? new Set(seats) : null;
+  return (names, at) => (!named || names.some((n) => named.has(n))) && (!window.since || at >= window.since) && (!window.until || at < window.until);
+}
+function sum(values) {
+  return values.reduce((total, v) => total + v, 0);
+}
+var CITED_LINES = 4;
+function cite(prefix, ids) {
+  if (ids.length === 0) return "-";
+  const shown = ids.slice(0, CITED_LINES).map((id) => `${prefix}${id}`).join(",");
+  return ids.length > CITED_LINES ? `${shown} +${ids.length - CITED_LINES}` : shown;
+}
+function renderLivenessText(report) {
+  const scope = `Liveness as of ${report.asOf}${report.window.since ? `, since ${report.window.since}` : ""}${report.window.until ? `, until ${report.window.until}` : ""}`;
+  const sources = ["Sources", ...Object.entries(report.sources).map(([name, s]) => `${name}: ${s.command} (${s.field})`)].join("\n");
+  return [scope, darkTable(report), routeTable(report), exitTable(report), promptTable(report), sources, LIST_PRICE_CAVEAT].join("\n\n") + "\n";
+}
+function darkTable(report) {
+  const { rows, withTeleport, withoutTeleport } = report.darkSeats;
+  const cells = rows.map((r) => [r.seat, r.from, r.to ?? "still dark", r.minutes, r.teleport ? "yes" : "no", r.failedRoutes, r.partialRoutes, r.queuedRoutes, cite("broker.log:", [...r.lines, ...r.routeLines])]);
+  const title = `Seats dark over ${report.thresholds.darkMin} min, ${withTeleport} with a teleport and ${withoutTeleport} without [darkSeats.rows[]]`;
+  return table(title, ["seat", "from", "to", "min", "teleport", "failed routes", "partial routes", "queued routes", "cites"], cells);
+}
+function routeTable(report) {
+  const { rows, failed, partial, queued } = report.routeFailures;
+  const cells = rows.map((r) => [r.recipient, r.failed, r.partial, r.queued, r.first, r.last, cite("broker.log:", r.lines)]);
+  const title = `Routes that missed a recipient, ${failed} dropped, ${partial} partial and ${queued} held or queued for later [routeFailures.rows[]]`;
+  return table(title, ["recipient", "failed", "partial", "queued", "first", "last", "cites"], cells);
+}
+function exitTable(report) {
+  const cells = report.unreportedExits.rows.flatMap((r) => r.exits.map((e) => [r.profile, e.name, e.spawner, e.lastAction, e.at, cite("broker.log:", [e.line]), e.spawnEventId === null ? "-" : `events#${e.spawnEventId}`]));
+  const title = `Unreported exits by profile, ${report.unreportedExits.total} in all [unreportedExits.rows[].exits[]]`;
+  return table(title, ["profile", "agent", "spawner", "last action", "at", "exit", "spawn"], cells);
+}
+function promptTable(report) {
+  const cells = (rows) => rows.map((r) => [r.agent, r.tool ?? "-", r.at, r.ageMin, `events#${r.eventId}`, r.resolutionEventId === null ? "-" : `events#${r.resolutionEventId}`]);
+  const head = ["agent", "tool", "at", "age min", "prompt", "resolution"];
+  const over = `over ${report.thresholds.promptStaleMin} min old`;
+  return [
+    table(`Agents whose last event is an unresolved permission prompt ${over} [stalePrompts.rows[]]`, head, cells(report.stalePrompts.rows)),
+    table(`Agents silent since a resolved permission prompt ${over} [stalePrompts.resolvedRows[]]`, head, cells(report.stalePrompts.resolvedRows))
+  ].join("\n\n");
+}
 export {
   ACTION_CLASSES,
   AGENT_LIFECYCLE,
@@ -1859,6 +2151,7 @@ export {
   COORDINATOR_MIN_EPISODE_REQUESTS,
   COORDINATOR_WAVE_QUIET_REQUESTS,
   COST_REPORT_SECTIONS,
+  DARK_MIN,
   DEFAULT_ACTION_RULES,
   DEFAULT_CONFIGURED_K,
   DEFAULT_EPISODE_ROLES,
@@ -1872,16 +2165,19 @@ export {
   HEURISTIC_VERSIONS,
   IDLE_GAP_MS,
   LIST_PRICE_CAVEAT,
+  LIVENESS_SOURCES,
   POOLED_REVIEWERS,
   PRICE_TABLE,
   PRICE_TABLE_VERSION,
   PROFILE_ROLES,
+  PROMPT_STALE_MIN,
   REBUILD_GAP_BANDS,
   STANDING_PEER_MIN_ASSIGNMENTS,
   STANDING_PEER_MIN_HOURS,
   TELEPORT_EVENT,
   TICK_HOLD_MAX_MIN,
   TOKEN_CLASSES,
+  UNKNOWN_PROFILE,
   UNSTATED_REASON,
   WAKE_FROM_KINDS,
   assignmentCount,
@@ -1900,6 +2196,9 @@ export {
   costPerRequest,
   costReport,
   costReportSchema,
+  countMisses,
+  darkGaps,
+  dedupeDenials,
   episodeNames,
   findPrice,
   gapBand,
@@ -1911,7 +2210,10 @@ export {
   isBootAction,
   latencyStats,
   latencyStatsSchema,
+  livenessReport,
+  livenessSchema,
   mergeOutcomes,
+  parseBrokerLog,
   parseDenials,
   parseSeatJournal,
   parseTeleportEvents,
@@ -1925,12 +2227,17 @@ export {
   renderCacheTtlText,
   renderCostReportSections,
   renderCostReportText,
+  renderLivenessText,
   roleFromProfile,
+  routeFailureRows,
+  routeMisses,
   scopeFilter,
   sessionInitiative,
   sessionRole,
+  stalePromptRows,
   summarizeWakeEpisodes,
   sweepK,
+  unreportedExitRows,
   wakeEpisodesSchema,
   workerRole,
   writeEpisodes