@iowarp/clio-coder 0.4.9 → 0.5.0

package/dist/monitor-LHNH577J.js

@@ -0,0 +1,811 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  monitorToolSurface
+} from "./chunk-B7GY6QER.js";
+import "./chunk-HQVN7G4F.js";
+import "./chunk-V35KZDUZ.js";
+import "./chunk-HOEDA42N.js";
+import {
+  compactHelperResultLines,
+  receiptEvidenceLabels,
+  receiptHelperResult,
+  workerTextLabel,
+  workerTextNonEvidenceNotices
+} from "./chunk-AVSR2HKI.js";
+import "./chunk-Y3JU5RPK.js";
+import "./chunk-6OWUM2NC.js";
+import {
+  COST_NOT_MEASURED,
+  UNVERIFIABLE_RECEIPT_VERIFICATION,
+  costAggregateForAmount,
+  formatCostAggregate,
+  renderAgentLedgerBoard
+} from "./chunk-LTWH2ACR.js";
+import "./chunk-PECBKCDK.js";
+import "./chunk-OV62D6KO.js";
+import "./chunk-I4ELN5BX.js";
+import "./chunk-DXSETN72.js";
+import "./chunk-NFSK2VNU.js";
+import {
+  summarizeTrustStatus,
+  trustStateWord
+} from "./chunk-OZ76TLGU.js";
+import "./chunk-EOJPDNUP.js";
+import "./chunk-BOBCCDJ6.js";
+import "./chunk-E6IPKW2E.js";
+import "./chunk-XMDBTYCH.js";
+import "./chunk-UQIVHSE4.js";
+import "./chunk-BYFHHCFV.js";
+import "./chunk-TKDRT2DF.js";
+import "./chunk-LQTKDAUO.js";
+import "./chunk-ZU4JPCPR.js";
+import "./chunk-U5QU5ZOD.js";
+import "./chunk-DNHVRBH4.js";
+import "./chunk-O5F25NIE.js";
+import "./chunk-U6YTUVOX.js";
+import "./chunk-SD7SHNDW.js";
+import "./chunk-7RET77VB.js";
+import "./chunk-YQ3GFEUY.js";
+import "./chunk-WTQGRBHV.js";
+import "./chunk-GLIQT7SU.js";
+import "./chunk-BHJMMCXS.js";
+import "./chunk-SUTLW6ND.js";
+import "./chunk-G5R53COU.js";
+import "./chunk-GM4TY6VN.js";
+import "./chunk-XISLDHEL.js";
+import "./chunk-RNDCROSG.js";
+import "./chunk-5LP5FNNR.js";
+import "./chunk-NVPXXW2H.js";
+import "./chunk-R7FGRZNF.js";
+import "./chunk-DOUISWEE.js";
+import {
+  adaptRunReceiptTrustStatus,
+  inspectRunReceiptTrustStatus
+} from "./chunk-VKHLUZNO.js";
+import {
+  formatBudgetPolicy,
+  formatBudgetReasons,
+  formatBudgetRequest,
+  formatEffectiveBudget,
+  isTerminalRunEnvelope
+} from "./chunk-OQ2EOAHA.js";
+import "./chunk-NDPF2N2L.js";
+import "./chunk-7QXCO3AF.js";
+import "./chunk-T33IYTZM.js";
+import "./chunk-OH3YYA3B.js";
+import "./chunk-VESL6DQY.js";
+import "./chunk-FD3IAHQM.js";
+import "./chunk-XNIZBOFV.js";
+import "./chunk-XZWSP67B.js";
+import "./chunk-BRCOSE7O.js";
+import "./chunk-55RMDDFM.js";
+import "./chunk-L4N3DWNW.js";
+import "./chunk-TDGYTWM6.js";
+import "./chunk-CTFPFW3H.js";
+import "./chunk-DE2LU267.js";
+import "./chunk-YYLCPDCC.js";
+import "./chunk-EFSEIZE6.js";
+import "./chunk-KBUTSJSR.js";
+import "./chunk-YBUECLAF.js";
+import "./chunk-CRHPCPZP.js";
+import "./chunk-FFYTC2KQ.js";
+import "./chunk-UJD5MPP6.js";
+import "./chunk-DZLR4UEH.js";
+import "./chunk-OPD7GL6F.js";
+import "./chunk-733ZBT5P.js";
+import "./chunk-GHXGMFQ5.js";
+import "./chunk-KECNXMDE.js";
+import "./chunk-WXA2CFJO.js";
+import "./chunk-6CTHLZFB.js";
+import "./chunk-2KUBKL63.js";
+import {
+  truncateUtf8
+} from "./chunk-MYI32N4R.js";
+import "./chunk-X6FLVUM5.js";
+import "./chunk-EYTLV3W3.js";
+import "./chunk-MCJKEGHO.js";
+import "./chunk-DVTBERFY.js";
+import "./chunk-6EJYVCTN.js";
+import "./chunk-W53XSRQE.js";
+import "./chunk-6W75D37F.js";
+import "./chunk-77DCC6JZ.js";
+import "./chunk-SYF7FVBL.js";
+import "./chunk-Z4GLJ6J4.js";
+import "./chunk-VNBICSS2.js";
+import "./chunk-2WVPJF3Z.js";
+import "./chunk-27YTM2CV.js";
+import "./chunk-L7G7K4I2.js";
+import "./chunk-ALJWT6O6.js";
+import "./chunk-4WV4PI66.js";
+import "./chunk-HMN2C6YL.js";
+import "./chunk-I4Y4WKZR.js";
+import "./chunk-UZVYEF57.js";
+import "./chunk-O3VV6IVK.js";
+import "./chunk-EKV4UBCM.js";
+import "./chunk-UHW5V7HC.js";
+import "./chunk-LNOXCGN2.js";
+import "./chunk-BJH6WFIB.js";
+import "./chunk-5EQO5NWP.js";
+import "./chunk-VYRQHORQ.js";
+import "./chunk-P4GNZPXO.js";
+import "./chunk-R2P2U3ZS.js";
+import "./chunk-NTTS3O53.js";
+import "./chunk-C2CPOIH2.js";
+import "./chunk-MGLRTOCK.js";
+import "./chunk-M4KFUXS7.js";
+import "./chunk-V4XJWDHR.js";
+import "./chunk-56XP4FJU.js";
+import "./chunk-QZTTRSJE.js";
+import "./chunk-U2MSJ57E.js";
+import "./chunk-C27U2TYG.js";
+import "./chunk-B5GGDIHT.js";
+import "./chunk-O63U2I6I.js";
+import "./chunk-M2IPMWCN.js";
+import "./chunk-XS2QPZJE.js";
+import {
+  sleep
+} from "./chunk-6EXUUOSN.js";
+import "./chunk-ZTNFYMIO.js";
+import "./chunk-53OXPRI6.js";
+import "./chunk-2EMLKSCX.js";
+import "./chunk-KMF54VH3.js";
+import "./chunk-DVJL77SO.js";
+import "./chunk-SER7RRAE.js";
+import "./chunk-GH5ZR6JP.js";
+import "./chunk-TK2BMCBZ.js";
+import "./chunk-CTTI7G3T.js";
+import "./chunk-QG6I2T5E.js";
+import "./chunk-CVDAFGPW.js";
+import "./chunk-KPRLAMP4.js";
+import "./chunk-W2RJEH6Q.js";
+import "./chunk-PPEZJWUG.js";
+import "./chunk-WDV62RKY.js";
+import "./chunk-ZZFWWYLX.js";
+import "./chunk-2VLYHHFT.js";
+import "./chunk-3JHUFKG7.js";
+import "./chunk-ZPST2KQO.js";
+import "./chunk-JQCLXSFI.js";
+import "./chunk-PS6JAWJZ.js";
+import "./chunk-FD2I4KBR.js";
+import {
+  init_esm_shims
+} from "./chunk-ECBHH7LU.js";
+
+// src/tools/monitor.ts
+init_esm_shims();
+import { readFileSync } from "node:fs";
+var LIST_LIMIT = 20;
+var PEEK_MAX_BYTES = 8 * 1024;
+var RECEIPT_MAX_BYTES = 14 * 1024;
+var WAIT_POLL_MS = 250;
+var WAIT_DEFAULT_TIMEOUT_MS = 6e4;
+var WAIT_MAX_TIMEOUT_MS = 10 * 6e4;
+var COLLECT_TEXT_BYTES = 2e3;
+var COLLECT_TIMEOUT_NOTICE = 'collect never blocks; timeout_ms is ignored \u2014 block on one run with mode="wait".';
+function runLine(run) {
+  const state = run.outcome ?? run.status;
+  const receipt = run.receiptPath ?? "n/a";
+  return `- ${run.id} agent=${run.agentId} state=${state} node=${run.node?.id ?? "local"} started=${run.startedAt} tokens=${run.tokenCount} receipt=${receipt}`;
+}
+function listRuns(deps, options) {
+  let runs;
+  try {
+    runs = deps.dispatch.listRuns();
+  } catch (err) {
+    return { kind: "error", message: `monitor: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  const sessionId = options?.sessionId ?? null;
+  const sessionRuns = sessionId !== null ? runs.filter((run) => run.sessionId === sessionId) : [];
+  const scoped = sessionRuns.length > 0 ? sessionRuns : runs;
+  const scopeNote = sessionRuns.length > 0 ? "this session" : "all sessions";
+  const shown = scoped.slice(0, LIST_LIMIT);
+  if (shown.length === 0) {
+    return { kind: "ok", output: "No dispatched runs recorded.", details: { mode: "list", runCount: 0 } };
+  }
+  const lines = [`dispatched runs (${scopeNote}, newest first, ${shown.length} of ${scoped.length}):`];
+  for (const run of shown) lines.push(runLine(run));
+  lines.push("", 'Use monitor(run_id=<id>) for state, mode="peek" for recent output, mode="receipt" for the receipt.');
+  return {
+    kind: "ok",
+    output: lines.join("\n"),
+    details: {
+      mode: "list",
+      runCount: scoped.length,
+      runs: shown.map((run) => ({ runId: run.id, agentId: run.agentId, state: run.outcome ?? run.status }))
+    }
+  };
+}
+function runStatus(deps, runId) {
+  const requestedRun = deps.dispatch.getRun(runId);
+  const assignment = deps.dispatch.assignments?.getStored(runId) ?? null;
+  const rootRunId = assignment?.assignmentId ?? requestedRun?.lineage?.rootRunId ?? runId;
+  const resolvedRunId = assignment?.terminalRunId ?? runId;
+  const run = deps.dispatch.getRun(resolvedRunId) ?? requestedRun;
+  if (!run && !assignment) return { kind: "error", message: `monitor: unknown run or assignment '${runId}'` };
+  if (!run) return { kind: "error", message: `monitor: assignment '${runId}' has no available attempt` };
+  const live = deps.dispatch.snapshot().running.find(
+    (entry) => (deps.dispatch.assignments?.getStored(entry.runId)?.assignmentId ?? entry.lineage.rootRunId) === rootRunId
+  ) ?? null;
+  const reroutes = run.reroutes !== void 0 && run.reroutes.length > 0 ? ` reroutes=${run.reroutes.map((hop) => `${hop.fromNode}>${hop.toNode}`).join(",")}` : "";
+  const lines = [
+    ...assignment ? [
+      `assignment ${assignment.assignmentId} status=${assignment.status} terminal=${assignment.terminalRunId ?? "pending"}`,
+      `attempts: ${assignment.attempts.join(", ") || "none finalized"}`
+    ] : [],
+    `run ${run.id} (${run.agentId})`,
+    `state: ${run.status}${run.outcome ? ` outcome=${run.outcome}` : ""}${run.outcomeDetail ? ` detail=${run.outcomeDetail}` : ""}`,
+    `target=${run.targetId} model=${run.wireModelId} runtime=${run.runtimeKind} node=${run.node?.id ?? "local"}${reroutes}`,
+    `started=${run.startedAt} ended=${run.endedAt ?? "n/a"} exit=${run.exitCode ?? "n/a"}`,
+    `tokens=${run.tokenCount} cost=${formatCostAggregate(costAggregateForAmount(run.costUsd, run.costProvenance)) ?? COST_NOT_MEASURED} receipt=${run.receiptPath ?? "n/a"}`
+  ];
+  if (run.council !== void 0 || run.gate?.role === "synthesis") {
+    lines.push(
+      `council: role=${run.gate?.role === "synthesis" ? "synthesis" : "member"} group=${run.council?.group ?? run.gate?.group ?? "unknown"}${run.council?.label ? ` label=${run.council.label}` : ""}`
+    );
+  }
+  if (run.budget !== void 0) {
+    lines.push(
+      `recipe policy: ${formatBudgetPolicy(run.budget)}`,
+      `requested envelope: ${formatBudgetRequest(run.budget)}`,
+      `effective envelope: ${formatEffectiveBudget(run.budget)}`,
+      `clamp or escalation reason: ${formatBudgetReasons(run.budget)}`
+    );
+  }
+  if (live) {
+    lines.push(
+      `live: phase=${live.outcomePhase} heartbeat=${live.heartbeat} elapsed=${Math.round(live.elapsedMs / 1e3)}s tokens=${live.tokens.total}`
+    );
+  }
+  const trust = isTerminalRunEnvelope(run) ? summarizeTrustStatus(durableRunEvidence(run).trustStatus) : null;
+  if (trust)
+    lines.push(
+      `quality: ${trustStateWord("validationGrounding", trust.axes.validationGrounding)}`,
+      `trust: ${trust.text}`
+    );
+  return {
+    kind: "ok",
+    output: lines.join("\n"),
+    details: {
+      mode: "status",
+      ...trust ? { trust } : {},
+      ...assignment ? {
+        assignmentId: assignment.assignmentId,
+        assignmentStatus: assignment.status,
+        attemptRunIds: [...assignment.attempts],
+        terminalRunId: assignment.terminalRunId
+      } : {},
+      runId: run.id,
+      agentId: run.agentId,
+      status: run.status,
+      outcome: run.outcome ?? null,
+      exitCode: run.exitCode,
+      tokenCount: run.tokenCount,
+      costUsd: run.costUsd,
+      costProvenance: run.costProvenance ?? "unknown",
+      budget: run.budget ?? null,
+      ...run.council !== void 0 || run.gate?.role === "synthesis" ? {
+        council: {
+          role: run.gate?.role === "synthesis" ? "synthesis" : "member",
+          group: run.council?.group ?? run.gate?.group ?? null,
+          ...run.council !== void 0 ? { label: run.council.label, round: run.council.round } : {}
+        }
+      } : {},
+      receiptPath: run.receiptPath,
+      running: live !== null
+    }
+  };
+}
+function runPeek(deps, runId) {
+  const run = deps.dispatch.getRun(runId);
+  const tail = deps.runEvents?.eventTail(runId) ?? null;
+  if (!tail || tail.entries.length === 0) {
+    if (!run) return { kind: "error", message: `monitor: unknown run '${runId}'` };
+    return {
+      kind: "ok",
+      output: `No buffered events for run ${runId} in this process. Use mode="receipt" for the stored receipt or mode="status" for run state.`,
+      details: { mode: "peek", runId, eventCount: 0 }
+    };
+  }
+  const rendered = tail.entries.map((entry) => `${entry.at} ${entry.type}${entry.detail ? `: ${entry.detail}` : ""}`);
+  let body = rendered.join("\n");
+  let dropped = 0;
+  while (Buffer.byteLength(body, "utf8") > PEEK_MAX_BYTES && dropped < rendered.length - 1) {
+    dropped += 1;
+    body = rendered.slice(dropped).join("\n");
+  }
+  const lines = [
+    `recent events for run ${runId} (${tail.agentId}), newest last${dropped > 0 ? `, ${dropped} older omitted` : ""}:`,
+    body
+  ];
+  return {
+    kind: "ok",
+    output: lines.join("\n"),
+    details: { mode: "peek", runId, eventCount: tail.entries.length, omitted: dropped }
+  };
+}
+var TOOLS_MAX_CALL_LINES = 60;
+var TOOLS_MAX_BYTES = 8 * 1024;
+var TOOLS_ARGUMENTS_CHARS = 160;
+var TOOL_CALL_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "clio_coder_tool_finish",
+  "clio_coder_permission_resolved",
+  "clio_coder_permission_escalated"
+]);
+function toolCallLines(entries) {
+  const lines = [];
+  for (const entry of entries) {
+    const detailed = entry.detail !== void 0 && entry.detail.length > 0;
+    if (!TOOL_CALL_EVENT_TYPES.has(entry.type) && !(entry.type === "tool_execution_end" && detailed)) continue;
+    lines.push(`  ${entry.at} ${entry.type}${detailed ? `: ${entry.detail}` : ""}`);
+  }
+  return lines;
+}
+function receiptToolLines(receipt) {
+  const lines = [];
+  const activity = receipt.toolActivity;
+  if (activity) {
+    lines.push(
+      `  totals: calls=${activity.calls} succeeded=${activity.succeeded} failed=${activity.failed} blocked=${activity.blocked} mutating_succeeded=${activity.mutatingSucceeded}`
+    );
+  } else {
+    lines.push(`  totals: calls=${receipt.toolCalls}`);
+  }
+  for (const stat of receipt.toolStats) {
+    lines.push(
+      `  ${stat.tool}: count=${stat.count} ok=${stat.ok} errors=${stat.errors} blocked=${stat.blocked} total_ms=${stat.totalDurationMs}`
+    );
+  }
+  for (const attempt of receipt.safety?.blockedAttempts ?? []) {
+    const parts = [
+      `  blocked: ${attempt.tool}`,
+      attempt.actionClass !== void 0 ? `class=${attempt.actionClass}` : "",
+      attempt.ruleId !== void 0 ? `rule=${attempt.ruleId}` : "",
+      attempt.reasonCode !== void 0 ? `reason_code=${attempt.reasonCode}` : ""
+    ].filter((part) => part.length > 0);
+    lines.push(parts.join(" "));
+  }
+  for (const entry of receipt.delegation?.toolCallLog ?? []) {
+    let rendered;
+    try {
+      rendered = truncateUtf8(JSON.stringify(entry.arguments), TOOLS_ARGUMENTS_CHARS, "\u2026");
+    } catch {
+      rendered = "(arguments not serializable)";
+    }
+    lines.push(`  ${entry.timestamp} ${entry.tool} ${entry.decision} args=${rendered}`);
+  }
+  return lines;
+}
+function runTools(deps, runId) {
+  const requestedRun = deps.dispatch.getRun(runId);
+  const assignment = deps.dispatch.assignments?.getStored(runId) ?? null;
+  const resolvedRunId = assignment?.terminalRunId ?? runId;
+  const run = deps.dispatch.getRun(resolvedRunId) ?? requestedRun ?? null;
+  if (run === null && assignment === null) return { kind: "error", message: `monitor: unknown run '${runId}'` };
+  const tail = deps.runEvents?.eventTail(resolvedRunId) ?? null;
+  const callLines = tail ? toolCallLines(tail.entries) : [];
+  const evidence = durableRunEvidence(run);
+  const receiptLines = evidence.receipt !== null ? receiptToolLines(evidence.receipt) : [];
+  const lines = [`tool calls for run ${resolvedRunId}${run ? ` (${run.agentId})` : ""}:`];
+  let omitted = 0;
+  if (callLines.length > 0) {
+    const shown = callLines.length > TOOLS_MAX_CALL_LINES ? callLines.slice(-TOOLS_MAX_CALL_LINES) : callLines;
+    omitted = callLines.length - shown.length;
+    lines.push(
+      `executed calls from this process's event buffer (newest last, ${shown.length} of ${callLines.length}${omitted > 0 ? `, ${omitted} older omitted` : ""}):`,
+      ...shown
+    );
+  } else {
+    lines.push(
+      tail === null ? "executed calls: no event buffer for this run in this process (it ran in another process, or its tail was evicted)." : "executed calls: the event buffer holds no tool-call events for this run."
+    );
+  }
+  if (receiptLines.length > 0) {
+    lines.push("receipt totals (integrity verified):", ...receiptLines);
+  } else if (evidence.integrityNote !== null) {
+    lines.push(`receipt totals: unavailable. ${evidence.integrityNote}`);
+  }
+  lines.push(
+    "note: the event buffer records tool name and outcome, not command arguments; absent argv is not evidence that no command ran."
+  );
+  const body = truncateUtf8(lines.join("\n"), TOOLS_MAX_BYTES, "\n[tool list truncated]");
+  return {
+    kind: "ok",
+    output: body,
+    details: {
+      mode: "tools",
+      runId: resolvedRunId,
+      callCount: callLines.length,
+      omitted,
+      bufferAvailable: tail !== null,
+      receiptAvailable: evidence.receipt !== null,
+      ...evidence.receipt !== null ? {
+        toolCalls: evidence.receipt.toolCalls,
+        toolActivity: evidence.receipt.toolActivity ?? null,
+        toolStats: evidence.receipt.toolStats
+      } : {}
+    }
+  };
+}
+function runReceipt(deps, runId) {
+  const run = deps.dispatch.getRun(runId);
+  if (!run) return { kind: "error", message: `monitor: unknown run '${runId}'` };
+  if (!run.receiptPath) {
+    return {
+      kind: "error",
+      message: `monitor: run '${runId}' has no stored receipt (state=${run.outcome ?? run.status}); try mode="status" or mode="peek"`
+    };
+  }
+  let raw;
+  try {
+    raw = readFileSync(run.receiptPath, "utf8");
+  } catch (err) {
+    return {
+      kind: "error",
+      message: `monitor: cannot read receipt ${run.receiptPath}: ${err instanceof Error ? err.message : String(err)}`
+    };
+  }
+  const body = truncateUtf8(raw, RECEIPT_MAX_BYTES, `
+[receipt truncated; read ${run.receiptPath} for the rest]`);
+  let receipt = null;
+  let receiptIntegrity;
+  let trustStatus;
+  try {
+    receipt = JSON.parse(raw);
+    const inspection = inspectRunReceiptTrustStatus(receipt, run);
+    receiptIntegrity = inspection.integrity;
+    trustStatus = inspection.status;
+  } catch (err) {
+    receiptIntegrity = {
+      ok: false,
+      reason: `receipt invalid: ${err instanceof Error ? err.message : String(err)}`
+    };
+    trustStatus = adaptRunReceiptTrustStatus(null, { integrity: receiptIntegrity });
+  }
+  return {
+    kind: "ok",
+    output: body,
+    details: {
+      mode: "receipt",
+      runId,
+      receiptPath: run.receiptPath,
+      receiptIntegrity,
+      trustStatus,
+      trust: summarizeTrustStatus(trustStatus),
+      ...receipt !== null && receiptIntegrity.ok ? {
+        evidenceVerification: receipt.verification,
+        hostVerification: receipt.hostVerification ?? null,
+        briefing: receipt.briefing ?? null,
+        projectContext: receipt.projectContext ?? null
+      } : {}
+    }
+  };
+}
+function unavailableRunEvidence(reason, note, integrityFailure = false) {
+  return {
+    receipt: null,
+    output: null,
+    verification: UNVERIFIABLE_RECEIPT_VERIFICATION,
+    integrity: { ok: false, reason },
+    trustStatus: adaptRunReceiptTrustStatus(null, { integrity: { ok: false, reason } }),
+    integrityNote: note,
+    integrityFailure
+  };
+}
+function durableRunEvidence(run) {
+  if (!run) {
+    return unavailableRunEvidence(
+      "run ledger envelope unavailable",
+      "receipt integrity unavailable: the run ledger envelope is missing; worker text cannot be authenticated."
+    );
+  }
+  if (!run.receiptPath) {
+    return unavailableRunEvidence(
+      "receipt unavailable",
+      "receipt integrity unavailable: no stored receipt; worker text is unavailable and validation is unknown."
+    );
+  }
+  let receipt;
+  try {
+    receipt = JSON.parse(readFileSync(run.receiptPath, "utf8"));
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return unavailableRunEvidence(
+      `receipt unreadable: ${detail}`,
+      `receipt integrity unavailable: cannot read or parse ${run.receiptPath} (${detail}); worker text is unavailable and validation is unknown.`
+    );
+  }
+  const inspection = inspectRunReceiptTrustStatus(receipt, run);
+  const integrity = inspection.integrity;
+  if (!integrity.ok) {
+    if (integrity.retired !== void 0) {
+      return {
+        ...unavailableRunEvidence(
+          integrity.reason,
+          `${integrity.reason}; worker text is unavailable and validation is unknown.`
+        ),
+        trustStatus: inspection.status
+      };
+    }
+    return {
+      ...unavailableRunEvidence(
+        integrity.reason,
+        `receipt integrity failed: ${integrity.reason}; worker text is withheld as untrusted and validation is unknown.`,
+        true
+      ),
+      trustStatus: inspection.status
+    };
+  }
+  return {
+    receipt,
+    output: receipt.output ?? null,
+    verification: receipt.verification,
+    integrity,
+    trustStatus: inspection.status,
+    integrityNote: null,
+    integrityFailure: false
+  };
+}
+async function runWait(deps, runId, timeoutMs, signal) {
+  const startedAt = performance.now();
+  let run = deps.dispatch.getRun(runId);
+  if (!run) return { kind: "error", message: `monitor: unknown run '${runId}'` };
+  let assignment = deps.dispatch.assignments?.getStored(runId) ?? null;
+  const rootRunId = assignment?.assignmentId ?? runId;
+  while (assignment?.status === "running" || assignment === null && !isTerminalRunEnvelope(run)) {
+    if (signal?.aborted) return { kind: "error", message: "monitor: wait aborted" };
+    const elapsed = Math.round(performance.now() - startedAt);
+    if (elapsed >= timeoutMs) {
+      return {
+        kind: "ok",
+        output: `wait timed out after ${timeoutMs}ms: ${assignment ? "assignment" : "run"} ${runId} is still ${assignment?.status ?? run.status} and keeps running normally. Wait again or collect later. Only steer(action="cancel") if the result is no longer needed \u2014 cancelling discards its work.`,
+        details: {
+          mode: "wait",
+          runId,
+          timedOut: true,
+          state: assignment?.status ?? run.status,
+          waitedMs: elapsed
+        }
+      };
+    }
+    await sleep(Math.min(WAIT_POLL_MS, timeoutMs - elapsed));
+    assignment = deps.dispatch.assignments?.getStored(rootRunId) ?? null;
+    const resolvedRunId = assignment?.terminalRunId ?? runId;
+    run = deps.dispatch.getRun(resolvedRunId) ?? run;
+    if (!run) return { kind: "error", message: `monitor: run '${runId}' disappeared from the ledger while waiting` };
+  }
+  const status = runStatus(deps, runId);
+  if (status.kind !== "ok") return status;
+  const waitedMs = Math.round(performance.now() - startedAt);
+  return {
+    kind: "ok",
+    output: `wait complete after ${waitedMs}ms:
+${status.output}`,
+    details: { ...status.details, mode: "wait", timedOut: false, waitedMs }
+  };
+}
+function failedIntegrityReason(integrity) {
+  return integrity.ok ? "verification result unavailable" : integrity.reason;
+}
+function collectRunLine(row) {
+  if (row.evidence.receipt !== null) {
+    const helperLines = compactHelperResultLines(row.evidence.receipt, row.evidence.integrity, COLLECT_TEXT_BYTES);
+    if (helperLines !== null) return helperLines;
+  }
+  const run = row.run;
+  const lines = run ? [
+    `- ${run.id} agent=${run.agentId} state=${run.outcome ?? run.status} node=${run.node?.id ?? "local"} exit=${run.exitCode ?? "n/a"} tokens=${run.tokenCount} cost=${formatCostAggregate(costAggregateForAmount(run.costUsd, run.costProvenance)) ?? COST_NOT_MEASURED} receipt=${run.receiptPath ?? "n/a"}${run.outcomeDetail ? ` detail=${run.outcomeDetail}` : ""}`
+  ] : [`- ${row.runId} agent=${row.agentId} state=missing (ledger row pruned; receipt may still exist)`];
+  if (row.assignmentId !== null) {
+    lines.unshift(
+      `- assignment=${row.assignmentId} status=${row.assignmentStatus ?? "unknown"} terminal=${row.runId}`,
+      `  attempts=${row.attemptRunIds.join(",") || "none"}`
+    );
+  }
+  if (row.evidence.receipt !== null) {
+    lines.push(
+      ...receiptEvidenceLabels(row.evidence.receipt, row.evidence.verification, row.evidence.integrity).map(
+        (label) => `  ${label}`
+      )
+    );
+  } else {
+    const reason = failedIntegrityReason(row.evidence.integrity);
+    lines.push(
+      row.evidence.integrityFailure ? `  RECEIPT INTEGRITY FAILED for ${row.runId} (${reason}); stored receipt fields and worker text are untrusted.` : `  receipt_integrity=unavailable reason=${JSON.stringify(reason)}`
+    );
+  }
+  if (row.evidence.integrityNote) lines.push(`  ${row.evidence.integrityNote}`);
+  lines.push(`  ${workerTextLabel(row.evidence.trustStatus)}`);
+  const output = row.evidence.output;
+  if (output) {
+    const capped = truncateUtf8(
+      output.text,
+      COLLECT_TEXT_BYTES,
+      `
+[preview clipped at ${COLLECT_TEXT_BYTES} bytes; the complete sealed text is output.text in ${row.run?.receiptPath ?? "the receipt"}]`
+    );
+    const qualifier = output.state === "partial" ? " (partial; the run did not complete this message)" : "";
+    const truncatedNote = output.truncated ? ` (stored output truncated; full text was ${output.bytes} bytes)` : "";
+    lines.push(`  agent output${qualifier}${truncatedNote}:`, ...capped.split("\n").map((line) => `  ${line}`));
+    if (row.evidence.receipt) {
+      lines.push(
+        ...workerTextNonEvidenceNotices(row.evidence.receipt, row.evidence.trustStatus, output.text).map(
+          (notice) => `  ${notice}`
+        )
+      );
+    }
+  } else if (row.evidence.integrity.ok) {
+    lines.push("  (no assistant text captured)");
+  }
+  return lines;
+}
+function resolveCollectRow(deps, originalRunId, agentId) {
+  const original = deps.dispatch.getRun(originalRunId);
+  const assignment = deps.dispatch.assignments?.getStored(originalRunId) ?? null;
+  const runId = assignment?.terminalRunId ?? originalRunId;
+  const run = deps.dispatch.getRun(runId) ?? original;
+  return {
+    runId,
+    assignmentId: assignment?.assignmentId ?? null,
+    attemptRunIds: assignment?.attempts ?? [originalRunId],
+    assignmentStatus: assignment?.status ?? null,
+    agentId: run?.agentId ?? agentId,
+    run
+  };
+}
+async function runCollect(deps, batchId, runIds, timeoutWasPassed) {
+  let rows;
+  let scope;
+  let ledgerId = null;
+  if (batchId.length > 0) {
+    const detached = deps.dispatch.detached;
+    if (!detached) return { kind: "error", message: "monitor: no detached batch records are available in this context" };
+    const record = detached.get(batchId);
+    if (!record) return { kind: "error", message: `monitor: unknown batch '${batchId}'` };
+    ledgerId = record.ledgerId ?? null;
+    rows = record.runs.map((entry) => resolveCollectRow(deps, entry.assignmentId, entry.agentId));
+    scope = `batch ${batchId}${record.collectedAt !== null ? " (already collected)" : ""}`;
+  } else {
+    rows = runIds.map((runId) => resolveCollectRow(deps, runId, "unknown"));
+    scope = `${rows.length} run(s)`;
+  }
+  const pending = rows.filter((row) => {
+    if (row.assignmentStatus === null) return row.run !== null && !isTerminalRunEnvelope(row.run);
+    return row.assignmentStatus === "running";
+  });
+  if (pending.length > 0) {
+    const lines2 = [
+      `collect pending: ${pending.length} of ${rows.length} run(s) still in flight for ${scope}`,
+      ...rows.map((row) => {
+        const state = row.run === null ? "missing" : row.run.outcome ?? row.run.status;
+        return `- ${row.assignmentId ?? row.runId} agent=${row.agentId} state=${row.assignmentStatus ?? state}`;
+      }),
+      "",
+      'Collect again later, or block on a single run with mode="wait".',
+      ...timeoutWasPassed ? ["", COLLECT_TIMEOUT_NOTICE] : []
+    ];
+    return {
+      kind: "ok",
+      output: lines2.join("\n"),
+      details: {
+        mode: "collect",
+        ...batchId.length > 0 ? { batchId } : {},
+        complete: false,
+        pendingCount: pending.length,
+        runCount: rows.length,
+        pendingRunIds: pending.map((row) => row.assignmentId ?? row.runId)
+      }
+    };
+  }
+  const failed = rows.filter(
+    (row) => row.run === null || row.run.exitCode !== 0 || row.run.outcome !== void 0 && row.run.outcome !== "succeeded" && row.run.outcome !== null
+  );
+  const missing = rows.filter((row) => row.run === null);
+  const board = ledgerId === null ? null : renderAgentLedgerBoard(ledgerId);
+  let collected = false;
+  if (batchId.length > 0) {
+    try {
+      const marked = await deps.dispatch.detached?.markCollected(batchId);
+      collected = marked !== null && marked !== void 0;
+    } catch {
+      collected = false;
+    }
+  }
+  const collectedRows = rows.map((row) => ({ ...row, evidence: durableRunEvidence(row.run) }));
+  const lines = [
+    `collect complete for ${scope}: total=${rows.length} failed=${failed.length}${missing.length > 0 ? ` missing=${missing.length}` : ""}`,
+    ...collectedRows.flatMap((row) => collectRunLine(row)),
+    ...board !== null ? ["", board] : [],
+    ...batchId.length > 0 && !collected ? ["", "note: the batch record could not be marked collected; it stays open for a later collect."] : [],
+    ...timeoutWasPassed ? ["", COLLECT_TIMEOUT_NOTICE] : []
+  ];
+  return {
+    kind: "ok",
+    output: lines.join("\n"),
+    details: {
+      mode: "collect",
+      ...batchId.length > 0 ? { batchId, collected } : {},
+      ...board !== null ? { agentLedgerBoard: board } : {},
+      complete: true,
+      runCount: rows.length,
+      failedCount: failed.length,
+      runs: collectedRows.map((row) => {
+        const output = row.evidence.output;
+        const helperResult = row.evidence.receipt === null ? null : receiptHelperResult(row.evidence.receipt, row.evidence.integrity);
+        return {
+          ...helperResult !== null ? { helperResult } : {},
+          runId: row.runId,
+          ...row.assignmentId !== null ? {
+            assignmentId: row.assignmentId,
+            assignmentStatus: row.assignmentStatus,
+            attemptRunIds: [...row.attemptRunIds],
+            terminalRunId: row.runId
+          } : {},
+          agentId: row.agentId,
+          state: row.run === null ? "missing" : row.run.outcome ?? row.run.status,
+          exitCode: row.run?.exitCode ?? null,
+          receiptPath: row.run?.receiptPath ?? null,
+          receiptIntegrity: row.evidence.integrity,
+          trustStatus: row.evidence.trustStatus,
+          evidenceVerification: row.evidence.verification,
+          hostVerification: row.evidence.receipt?.hostVerification ?? null,
+          briefing: row.evidence.receipt?.briefing ?? null,
+          projectContext: row.evidence.receipt?.projectContext ?? null,
+          ...output ? { output: { state: output.state, bytes: output.bytes, truncated: output.truncated } } : {}
+        };
+      })
+    }
+  };
+}
+function createMonitorTool(deps) {
+  return {
+    ...monitorToolSurface,
+    async run(args, options) {
+      const explicitRunId = typeof args.run_id === "string" ? args.run_id.trim() : "";
+      const rawRunIds = Array.isArray(args.run_ids) ? args.run_ids : null;
+      const singletonRunId = rawRunIds?.length === 1 && typeof rawRunIds[0] === "string" ? rawRunIds[0].trim() : "";
+      const runId = explicitRunId.length > 0 ? explicitRunId : singletonRunId;
+      const mode = typeof args.mode === "string" ? args.mode : runId.length > 0 ? "status" : "list";
+      if (mode !== "status" && mode !== "peek" && mode !== "receipt" && mode !== "list" && mode !== "wait" && mode !== "collect" && mode !== "tools") {
+        return {
+          kind: "error",
+          message: `monitor: mode must be status, peek, receipt, list, wait, collect, or tools; got '${mode}'`
+        };
+      }
+      if (mode === "list") return listRuns(deps, options);
+      if (mode === "collect") {
+        const batchId = typeof args.batch_id === "string" ? args.batch_id.trim() : "";
+        const runIds = rawRunIds ? rawRunIds.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [];
+        if (batchId.length === 0 && runIds.length === 0) {
+          return { kind: "error", message: "monitor: mode=collect requires batch_id or a non-empty run_ids array" };
+        }
+        return runCollect(deps, batchId, runIds, Object.hasOwn(args, "timeout_ms"));
+      }
+      if (runId.length === 0) {
+        if (rawRunIds !== null) {
+          const entryLabel = rawRunIds.length === 1 ? "entry" : "entries";
+          return {
+            kind: "error",
+            message: `monitor: mode=${mode} observes one run; got run_ids with ${rawRunIds.length} ${entryLabel} \u2014 pass run_id=<one id>, or use mode=collect run_ids=[...] for a batch`
+          };
+        }
+        return {
+          kind: "error",
+          message: `monitor: mode=${mode} observes one run and needs run_id; call monitor(mode="list") first to see the run ids this session knows about`
+        };
+      }
+      if (mode === "wait") {
+        const rawTimeout = typeof args.timeout_ms === "number" && Number.isFinite(args.timeout_ms) ? args.timeout_ms : NaN;
+        const timeoutMs = Number.isFinite(rawTimeout) && rawTimeout > 0 ? Math.min(Math.floor(rawTimeout), WAIT_MAX_TIMEOUT_MS) : WAIT_DEFAULT_TIMEOUT_MS;
+        return runWait(deps, runId, timeoutMs, options?.signal);
+      }
+      if (mode === "status") return runStatus(deps, runId);
+      if (mode === "peek") return runPeek(deps, runId);
+      if (mode === "tools") return runTools(deps, runId);
+      return runReceipt(deps, runId);
+    }
+  };
+}
+export {
+  createMonitorTool
+};
+//# sourceMappingURL=monitor-LHNH577J.js.map