@h-rig/run-worker 0.0.6-alpha.154 → 0.0.6-alpha.156

package/dist/src/runs/index.js

@@ -0,0 +1,990 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// packages/run-worker/src/runs/diagnostics.ts
+function normalizeString(value) {
+  if (typeof value !== "string")
+    return null;
+  const normalized = value.replace(/\s+/g, " ").trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function isGenericRunFailure(value) {
+  const text = normalizeString(value);
+  return Boolean(text && /^Task run failed \([^)]*\)$/i.test(text));
+}
+function appendCandidate(candidates, value) {
+  const text = normalizeString(value);
+  if (text && !candidates.includes(text))
+    candidates.push(text);
+}
+function categorizeUsefulRunError(lines) {
+  const taskSourceFailure = lines.find((line) => /failed to update task source/i.test(line));
+  if (taskSourceFailure)
+    return `Task source update failed: ${taskSourceFailure}`;
+  const moduleFailure = lines.find((line) => /cannot find module/i.test(line));
+  if (moduleFailure)
+    return `Runtime module resolution failed: ${moduleFailure}`;
+  const providerFailure = lines.find((line) => /no api key found|unauthorized|authentication failed|invalid api key/i.test(line));
+  if (providerFailure)
+    return `Provider authentication failed: ${providerFailure}`;
+  return null;
+}
+function summarizeRunError(projection) {
+  if (projection.status !== "failed")
+    return null;
+  const candidates = [];
+  for (const anomaly of projection.anomalies) {
+    appendCandidate(candidates, `Journal anomaly (${anomaly.kind}): ${anomaly.detail}`);
+  }
+  for (const phase of projection.closeoutPhases) {
+    if (phase.outcome === "failed")
+      appendCandidate(candidates, phase.detail);
+  }
+  for (const entry of projection.statusHistory) {
+    appendCandidate(candidates, entry.reason);
+  }
+  appendCandidate(candidates, projection.record.statusDetail);
+  appendCandidate(candidates, projection.record.errorText);
+  const nonGeneric = candidates.filter((candidate) => !isGenericRunFailure(candidate));
+  return categorizeUsefulRunError(nonGeneric) ?? nonGeneric.at(-1) ?? normalizeString(projection.record.errorText);
+}
+var init_diagnostics = () => {};
+
+// packages/run-worker/src/runs/projection.ts
+var exports_projection = {};
+__export(exports_projection, {
+  selectRunProjection: () => selectRunProjection,
+  runRecordsFromRegistrySnapshot: () => runRecordsFromRegistrySnapshot,
+  runRecordFromRegistryEntry: () => runRecordFromRegistryEntry,
+  resolveRunJoinTarget: () => resolveRunJoinTarget,
+  resolveJoinTarget: () => resolveJoinTarget,
+  readSessionRunEntries: () => readSessionRunEntries,
+  listRuns: () => listRuns,
+  listRunProjections: () => listRunProjections,
+  getRunProjection: () => getRunProjection,
+  getRun: () => getRun,
+  discoveryDiagnosticRunRecord: () => discoveryDiagnosticRunRecord
+});
+import { existsSync, readFileSync } from "fs";
+import { isAbsolute, relative, resolve } from "path";
+import { Duration, Effect, Option, Stream } from "effect";
+import {
+  foldRunSessionEntries,
+  isTerminalRunStatus,
+  timelineEntriesFromCustomEntries
+} from "@rig/contracts";
+import { registrySnapshotStream } from "@rig/runtime/control-plane/discovery";
+function readSessionRunEntries(sessionPath) {
+  if (!sessionPath || !existsSync(sessionPath))
+    return [];
+  try {
+    return parseSessionRunEntries(readFileSync(sessionPath, "utf8"));
+  } catch {
+    return [];
+  }
+}
+function parseSessionRunEntries(raw) {
+  const entries = [];
+  for (const line of raw.split(`
+`)) {
+    if (!line.trim())
+      continue;
+    try {
+      const parsed = JSON.parse(line);
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        continue;
+      entries.push({
+        type: "type" in parsed && typeof parsed.type === "string" ? parsed.type : "",
+        ..."customType" in parsed && typeof parsed.customType === "string" ? { customType: parsed.customType } : {},
+        ..."data" in parsed ? { data: parsed.data } : {}
+      });
+    } catch {
+      continue;
+    }
+  }
+  return entries;
+}
+function stringOrNull(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function numberOrNull(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function objectRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function registryStatusAsRunStatus(status) {
+  if (status === "waiting-input")
+    return "waiting-user-input";
+  if (status === "starting")
+    return "preparing";
+  return typeof status === "string" && [
+    "created",
+    "queued",
+    "preparing",
+    "running",
+    "waiting-approval",
+    "waiting-user-input",
+    "paused",
+    "validating",
+    "reviewing",
+    "closing-out",
+    "needs-attention",
+    "completed",
+    "failed",
+    "stopped"
+  ].includes(status) ? status : null;
+}
+function payloadString(payload, keys) {
+  if (!payload || typeof payload !== "object")
+    return null;
+  const record = payload;
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim())
+      return value.trim();
+  }
+  return null;
+}
+function payloadOptions(payload) {
+  if (!payload || typeof payload !== "object")
+    return;
+  const record = payload;
+  const options = Array.isArray(record.options) ? record.options : Array.isArray(record.choices) ? record.choices : null;
+  const values = options?.filter((value) => typeof value === "string" && value.trim().length > 0) ?? [];
+  return values.length > 0 ? values : undefined;
+}
+function inboxRequest(request, kind) {
+  const fallback = kind === "approval" ? "Approval requested" : "Input requested";
+  return {
+    requestId: request.requestId,
+    kind,
+    title: payloadString(request.payload, ["title", "message", "reason", "prompt", "summary"]) ?? fallback,
+    body: payloadString(request.payload, ["body", "description", "detail", "details"]),
+    ...payloadOptions(request.payload) ? { options: payloadOptions(request.payload) } : {},
+    requestedAt: request.requestedAt ?? null,
+    source: "run"
+  };
+}
+function inboxFromProjection(projection) {
+  return [
+    ...projection.pendingApprovals.map((request) => inboxRequest(request, "approval")),
+    ...projection.pendingUserInputs.map((request) => inboxRequest(request, "input"))
+  ].sort((a, b) => (Date.parse(a.requestedAt ?? "") || 0) - (Date.parse(b.requestedAt ?? "") || 0));
+}
+function isProjectPath(projectRoot, cwd) {
+  const root = resolve(projectRoot);
+  const candidate = resolve(cwd);
+  const pathFromRoot = relative(root, candidate);
+  return pathFromRoot === "" || !pathFromRoot.startsWith("../") && pathFromRoot !== ".." && !isAbsolute(pathFromRoot);
+}
+function sourceFromEntry(projectRoot, projection, entry) {
+  const candidates = [
+    stringOrNull(projection.collabCwd),
+    stringOrNull(projection.cwd),
+    stringOrNull(entry.cwd),
+    stringOrNull(projection.worktreePath)
+  ].filter((cwd) => cwd !== null);
+  return candidates.some((cwd) => isProjectPath(projectRoot, cwd)) ? "local" : "remote";
+}
+function pendingRequests(value, fallbackKind) {
+  if (!Array.isArray(value))
+    return [];
+  return value.flatMap((item) => {
+    const record = objectRecord(item);
+    const requestId = stringOrNull(record?.requestId) ?? stringOrNull(record?.id);
+    if (!record || !requestId)
+      return [];
+    return [{
+      requestId,
+      requestKind: stringOrNull(record.requestKind) ?? stringOrNull(record.kind) ?? fallbackKind,
+      actionId: stringOrNull(record.actionId),
+      payload: "payload" in record ? record.payload : record,
+      requestedAt: stringOrNull(record.requestedAt) ?? stringOrNull(record.at) ?? ""
+    }];
+  });
+}
+function emptyFoldedProjection(runId, projection) {
+  const projectionRecord = projection;
+  const nestedProjection = objectRecord(projectionRecord.projection);
+  const pendingApprovals = pendingRequests(nestedProjection?.pendingApprovals ?? projectionRecord.pendingApprovals, "approval");
+  const pendingUserInputs = pendingRequests(nestedProjection?.pendingUserInputs ?? nestedProjection?.pendingInputs ?? projectionRecord.pendingUserInputs ?? (Array.isArray(projectionRecord.pendingInputs) ? projectionRecord.pendingInputs : undefined), "user-input");
+  const nestedRecord = objectRecord(nestedProjection?.record);
+  const nestedFolded = nestedProjection;
+  return {
+    ...EMPTY_PROJECTION,
+    ...nestedFolded ?? {},
+    record: {
+      ...nestedRecord ?? {},
+      runId,
+      ...projection.taskId ? { taskId: projection.taskId } : {},
+      ...projection.title ? { title: projection.title } : {},
+      ...projection.startedAt ? { startedAt: projection.startedAt } : {},
+      ...projection.updatedAt ? { updatedAt: projection.updatedAt } : {},
+      ...projection.completedAt ? { completedAt: projection.completedAt } : {},
+      ...projection.sessionPath ? { sessionPath: projection.sessionPath } : {},
+      ...projection.worktreePath ? { worktreePath: projection.worktreePath } : {},
+      ...projection.prUrl ? { prUrl: projection.prUrl } : {}
+    },
+    status: registryStatusAsRunStatus(projection.status) ?? registryStatusAsRunStatus(nestedProjection?.status),
+    pendingApprovals,
+    pendingUserInputs,
+    steeringCount: projection.steeringCount ?? numberOrNull(nestedProjection?.steeringCount) ?? 0,
+    stallCount: projection.stallCount ?? numberOrNull(nestedProjection?.stallCount) ?? 0,
+    lastEventAt: projection.updatedAt ?? stringOrNull(nestedProjection?.lastEventAt)
+  };
+}
+function runRecordFromRegistryEntry(projectRoot, entry) {
+  const projection = entry.projection && typeof entry.projection === "object" ? entry.projection : {};
+  const runId = stringOrNull(projection.runId) ?? entry.roomId;
+  const folded = emptyFoldedProjection(runId, projection);
+  const pushedStatus = registryStatusAsRunStatus(projection.status) ?? folded.status ?? registryStatusAsRunStatus(entry.status);
+  const status = entry.stale ? pushedStatus && isTerminalRunStatus(pushedStatus) ? pushedStatus : "stale" : pushedStatus ?? "running";
+  const sessionPath = stringOrNull(projection.sessionPath) ?? stringOrNull(entry.sessionPath) ?? null;
+  const collabCwd = stringOrNull(projection.collabCwd) ?? stringOrNull(projection.cwd) ?? stringOrNull(entry.cwd) ?? stringOrNull(projection.worktreePath);
+  return {
+    runId,
+    taskId: stringOrNull(projection.taskId),
+    title: stringOrNull(projection.title) ?? entry.title,
+    status,
+    source: sourceFromEntry(projectRoot, projection, entry),
+    live: !entry.stale,
+    stale: entry.stale,
+    startedAt: stringOrNull(projection.startedAt) ?? entry.startedAt ?? null,
+    updatedAt: stringOrNull(projection.updatedAt) ?? entry.heartbeatAt ?? null,
+    completedAt: stringOrNull(projection.completedAt),
+    joinLink: stringOrNull(projection.joinLink) ?? entry.joinLink ?? null,
+    webLink: stringOrNull(projection.webLink) ?? entry.webLink ?? null,
+    relayUrl: stringOrNull(projection.relayUrl) ?? entry.relayUrl ?? null,
+    sessionPath,
+    prUrl: stringOrNull(projection.prUrl),
+    worktreePath: stringOrNull(projection.worktreePath) ?? collabCwd,
+    pendingApprovals: numberOrNull(projection.pendingApprovals) ?? folded.pendingApprovals.length,
+    pendingInputs: numberOrNull(projection.pendingInputs) ?? folded.pendingUserInputs.length,
+    steeringCount: projection.steeringCount ?? 0,
+    stallCount: projection.stallCount ?? 0,
+    errorSummary: stringOrNull(projection.errorSummary) ?? summarizeRunError(folded),
+    timeline: Array.isArray(projection.timeline) ? [...projection.timeline] : [...timelineEntriesFromCustomEntries([])],
+    inbox: inboxFromProjection(folded),
+    collabCwd: collabCwd ?? null,
+    projection: folded
+  };
+}
+function runRecordsFromRegistrySnapshot(projectRoot, snapshot) {
+  return sortByRecency(snapshot.entries.map((entry) => runRecordFromRegistryEntry(projectRoot, entry)).filter((record) => record !== null));
+}
+function sortByRecency(records) {
+  return [...records].sort((a, b) => {
+    const at = Date.parse(b.updatedAt ?? b.startedAt ?? "") || 0;
+    const bt = Date.parse(a.updatedAt ?? a.startedAt ?? "") || 0;
+    return at - bt;
+  });
+}
+function discoveryDiagnosticRunRecord(projectRoot, error) {
+  const detail = error instanceof Error ? error.message : String(error);
+  const runId = DISCOVERY_DIAGNOSTIC_RUN_ID;
+  const projection = {
+    ...EMPTY_PROJECTION,
+    record: { runId, title: "Registry discovery unavailable" },
+    status: "needs-attention",
+    stallCount: 1
+  };
+  return {
+    runId,
+    taskId: null,
+    title: "Registry discovery unavailable",
+    status: "needs-attention",
+    source: "remote",
+    live: false,
+    stale: true,
+    startedAt: null,
+    updatedAt: null,
+    completedAt: null,
+    joinLink: null,
+    webLink: null,
+    relayUrl: null,
+    sessionPath: null,
+    prUrl: null,
+    worktreePath: null,
+    pendingApprovals: 0,
+    pendingInputs: 0,
+    steeringCount: 0,
+    stallCount: 1,
+    errorSummary: `registry discovery unavailable: ${detail}`,
+    timeline: [],
+    inbox: [],
+    collabCwd: null,
+    projection
+  };
+}
+async function listRunProjections(projectRoot, filter = {}) {
+  try {
+    const snapshot = await Effect.runPromise(registrySnapshotStream(projectRoot, filter).pipe(Stream.runHead, Effect.timeout(Duration.seconds(15)), Effect.map(Option.getOrNull)));
+    return snapshot ? runRecordsFromRegistrySnapshot(projectRoot, snapshot) : [discoveryDiagnosticRunRecord(projectRoot, "registry discovery stream ended without a snapshot")];
+  } catch (error) {
+    return [discoveryDiagnosticRunRecord(projectRoot, error)];
+  }
+}
+function selectRunProjection(runs, runId) {
+  const exactRun = runs.find((run) => run.runId === runId);
+  if (exactRun)
+    return exactRun;
+  const exactTask = runs.find((run) => run.taskId === runId);
+  if (exactTask)
+    return exactTask;
+  const prefixMatches = runs.filter((run) => run.runId.startsWith(runId));
+  if (prefixMatches.length === 1)
+    return prefixMatches[0] ?? null;
+  if (prefixMatches.length > 1) {
+    const matches = prefixMatches.map((run) => run.runId).join(", ");
+    throw new Error(`Ambiguous run id prefix "${runId}" matched ${prefixMatches.length} runs: ${matches}`);
+  }
+  return runs.find((run) => run.runId === DISCOVERY_DIAGNOSTIC_RUN_ID) ?? null;
+}
+async function getRunProjection(projectRoot, runId, filter = {}) {
+  const runs = await listRunProjections(projectRoot, filter);
+  return selectRunProjection(runs, runId);
+}
+async function resolveRunJoinTarget(projectRoot, runId, filter = {}) {
+  const run = await getRunProjection(projectRoot, runId, filter);
+  if (!run || !run.joinLink)
+    return null;
+  return { runId: run.runId, taskId: run.taskId, joinLink: run.joinLink, cwd: run.collabCwd ?? run.sessionPath, stale: run.stale };
+}
+var EMPTY_PROJECTION, DISCOVERY_DIAGNOSTIC_RUN_ID = "__registry_discovery_error__", listRuns, getRun, resolveJoinTarget;
+var init_projection = __esm(() => {
+  init_diagnostics();
+  EMPTY_PROJECTION = foldRunSessionEntries([], "");
+  listRuns = listRunProjections;
+  getRun = getRunProjection;
+  resolveJoinTarget = resolveRunJoinTarget;
+});
+
+// packages/run-worker/src/runs/control.ts
+init_projection();
+import { buildPauseSentinel, buildResumeSentinel, buildStopSentinel } from "@rig/contracts";
+async function loadCollabControlDeps() {
+  const [{ importRoomKey, seal }, { COLLAB_PROTO, packEnvelope, parseCollabLink }] = await Promise.all([
+    import("@oh-my-pi/pi-coding-agent/collab/crypto"),
+    import("@oh-my-pi/pi-coding-agent/collab/protocol")
+  ]);
+  return { importRoomKey, seal, COLLAB_PROTO, packEnvelope, parseCollabLink };
+}
+function collabControlFrames(runId, control) {
+  switch (control.kind) {
+    case "steer":
+      return [{ t: "prompt", text: control.message }];
+    case "resume":
+      return [{ t: "prompt", text: `${buildResumeSentinel(runId)}
+Continue the run from where it paused.` }];
+    case "pause":
+      return [
+        { t: "prompt", text: `${buildPauseSentinel(runId)}
+Pause this run after the current interruption settles.` },
+        { t: "abort" }
+      ];
+    case "stop":
+      return [
+        { t: "prompt", text: `${buildStopSentinel(runId, control.reason)}
+Stop this run and do not continue after the interruption settles.` },
+        { t: "abort" }
+      ];
+  }
+}
+function collabControlFrame(runId, control) {
+  return collabControlFrames(runId, control)[0];
+}
+async function sendSealedCollabFrames(joinLink, frames, deps = {}) {
+  const { importRoomKey, seal, COLLAB_PROTO, packEnvelope, parseCollabLink } = await loadCollabControlDeps();
+  const parsed = parseCollabLink(joinLink);
+  if ("error" in parsed)
+    throw new Error(parsed.error);
+  if (!parsed.writeToken)
+    throw new Error("Run collab link is read-only; cannot send control.");
+  const key = await importRoomKey(parsed.key);
+  const WebSocketCtor = deps.WebSocket ?? WebSocket;
+  const ws = new WebSocketCtor(`${parsed.wsUrl}?role=guest`);
+  await new Promise((resolveOpen, rejectOpen) => {
+    ws.addEventListener("open", () => resolveOpen(), { once: true });
+    ws.addEventListener("error", () => rejectOpen(new Error("collab websocket error")), { once: true });
+  });
+  const hello = {
+    t: "hello",
+    proto: COLLAB_PROTO,
+    name: "rig-operator",
+    writeToken: Buffer.from(parsed.writeToken).toString("base64url")
+  };
+  ws.send(packEnvelope(0, await seal(key, hello)));
+  for (const frame of frames)
+    ws.send(packEnvelope(0, await seal(key, frame)));
+  try {
+    ws.close();
+  } catch {}
+}
+async function deliverRemoteRunControl(projectRoot, target, control, deps = {}) {
+  const record = typeof target === "string" ? await getRun(projectRoot, target) : target;
+  const runId = typeof target === "string" ? target : target.runId;
+  if (!record)
+    throw new Error(`Run not found: ${runId}`);
+  if (!record.joinLink)
+    throw new Error(`Run ${record.runId} has no writable collab join link.`);
+  await sendSealedCollabFrames(record.joinLink, collabControlFrames(record.runId, control), deps);
+}
+async function deliverRunControl(projectRoot, target, control, deps = {}) {
+  const record = typeof target === "string" ? await (deps.getRun ?? getRun)(projectRoot, target) : target;
+  const runId = typeof target === "string" ? target : target.runId;
+  if (!record)
+    throw new Error(`Run not found: ${runId}`);
+  if (!record.joinLink)
+    throw new Error(`Run ${record.runId} has no writable collab join link; attach interactively to ${control.kind}.`);
+  try {
+    await (deps.deliverRemote ?? deliverRemoteRunControl)(projectRoot, record, control);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : `Attach to ${control.kind} interactively: rig run attach ${record.runId}`;
+    throw new Error(`Could not ${control.kind} run ${record.runId}. ${detail}`);
+  }
+}
+// packages/run-worker/src/runs/guard.ts
+import { TERMINAL_RUN_STATUSES } from "@rig/contracts";
+var TERMINAL = new Set(TERMINAL_RUN_STATUSES);
+function runBlocksNewRunForTask(run) {
+  return run.live && !run.stale && !TERMINAL.has(run.status) && run.status !== "needs-attention" && run.status !== "needs_attention";
+}
+async function activeRunByTaskId(listRuns2, projectRoot) {
+  const active = new Map;
+  for (const run of await listRuns2(projectRoot)) {
+    if (run.taskId && runBlocksNewRunForTask(run) && !active.has(run.taskId))
+      active.set(run.taskId, run.runId);
+  }
+  return active;
+}
+async function assertNoActiveRunForTask(listRuns2, projectRoot, taskId) {
+  const existing = (await activeRunByTaskId(listRuns2, projectRoot)).get(taskId);
+  if (existing) {
+    throw new Error(`Task ${taskId} already has an active run: ${existing}. Attach instead: rig run attach ${existing} \u2014 or re-dispatch anyway with --force.`);
+  }
+}
+// packages/run-worker/src/runs/inbox.ts
+import { buildInboxResolutionSentinel } from "@rig/contracts";
+init_projection();
+function promptFromPayload(payload, fallback) {
+  if (payload && typeof payload === "object") {
+    const record = payload;
+    for (const key of ["title", "message", "reason", "prompt", "summary"]) {
+      const value = record[key];
+      if (typeof value === "string" && value.trim().length > 0)
+        return value.trim();
+    }
+  }
+  return fallback;
+}
+function recordsFromRun(run, kind) {
+  const pending = kind === "approvals" ? run.projection.pendingApprovals : run.projection.pendingUserInputs;
+  return pending.map((request) => ({
+    runId: run.runId,
+    taskId: run.taskId,
+    requestId: request.requestId,
+    status: "pending",
+    prompt: promptFromPayload(request.payload, kind === "approvals" ? "Approval requested" : "Input requested"),
+    requestedAt: request.requestedAt,
+    payload: request.payload,
+    kind: kind === "approvals" ? "approval" : "input"
+  }));
+}
+async function listInboxRecords(context, kind, filters = {}, deps = {}) {
+  const projectRoot = typeof context === "string" ? context : context.projectRoot;
+  const runs = await (deps.listRuns ?? listRuns)(projectRoot);
+  const out = [];
+  for (const run of runs) {
+    if (filters.run && run.runId !== filters.run)
+      continue;
+    if (filters.task && run.taskId !== filters.task)
+      continue;
+    out.push(...recordsFromRun(run, kind));
+  }
+  return out;
+}
+async function listInbox(projectRoot, filters = {}, deps = {}) {
+  const runs = await (deps.listRuns ?? listRuns)(projectRoot);
+  const out = [];
+  for (const run of runs) {
+    if (filters.run && run.runId !== filters.run)
+      continue;
+    if (filters.task && run.taskId !== filters.task)
+      continue;
+    for (const request of run.inbox ?? []) {
+      if (request.source !== "run")
+        continue;
+      out.push(request);
+    }
+  }
+  return out;
+}
+async function readPendingInboxCounts(context, deps = {}) {
+  try {
+    const projectRoot = typeof context === "string" ? context : context.projectRoot;
+    const [approvals, inputs] = await Promise.all([
+      listInboxRecords(projectRoot, "approvals", {}, deps),
+      listInboxRecords(projectRoot, "inputs", {}, deps)
+    ]);
+    return { approvals: approvals.length, inputs: inputs.length };
+  } catch {
+    return null;
+  }
+}
+var readInboxCounts = readPendingInboxCounts;
+function normalizedApprovalDecision(decision) {
+  return decision === "approved" || decision === "approve" ? "approve" : "reject";
+}
+function inputAnswers(answer) {
+  return typeof answer === "string" ? { answer } : answer;
+}
+function decisionText(runId, requestId, decision) {
+  if (decision.kind === "approval") {
+    const normalized = normalizedApprovalDecision(decision.decision);
+    const label = normalized === "approve" ? "approved" : "rejected";
+    return [
+      buildInboxResolutionSentinel(runId, { kind: "approval", requestId, decision: normalized, note: decision.note ?? null }),
+      `Rig inbox approval ${requestId} was ${label}.`,
+      decision.note ? `Operator note: ${decision.note}` : null,
+      "Continue using this approval decision."
+    ].filter((line) => Boolean(line)).join(`
+`);
+  }
+  const answers = inputAnswers(decision.answer);
+  return [
+    buildInboxResolutionSentinel(runId, { kind: "input", requestId, answers }),
+    `Rig inbox input ${requestId} was answered with:`,
+    JSON.stringify(answers),
+    "Continue using this input answer."
+  ].join(`
+`);
+}
+async function resolveInboxRequest(projectRoot, runId, requestId, decision, deps = {}) {
+  await (deps.deliverRunControl ?? deliverRunControl)(projectRoot, runId, { kind: "steer", message: decisionText(runId, requestId, decision) });
+}
+// packages/run-worker/src/runs/inspect.ts
+init_projection();
+init_diagnostics();
+import { RIG_RUN_LOG_ENTRY } from "@rig/contracts";
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function firstString(record, keys) {
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.trim().length > 0)
+      return value;
+  }
+  return null;
+}
+function stringifyLogPayload(value) {
+  if (typeof value === "string")
+    return value;
+  if (typeof value === "number" || typeof value === "boolean")
+    return String(value);
+  const record = asRecord(value);
+  if (!record)
+    return null;
+  const direct = firstString(record, ["line", "message", "text", "content", "output", "summary", "detail"]);
+  if (direct)
+    return direct;
+  try {
+    return JSON.stringify(record);
+  } catch {
+    return String(record);
+  }
+}
+function logLineFromValue(value) {
+  const record = asRecord(value);
+  if (!record)
+    return stringifyLogPayload(value);
+  const direct = firstString(record, ["line", "message", "text", "content", "output", "summary", "detail"]);
+  if (direct)
+    return direct;
+  if ("payload" in record)
+    return stringifyLogPayload(record.payload);
+  if ("data" in record)
+    return stringifyLogPayload(record.data);
+  return stringifyLogPayload(record);
+}
+function logLineFromSessionEntry(entry) {
+  if (entry.type !== "custom" || entry.customType !== RIG_RUN_LOG_ENTRY)
+    return null;
+  return logLineFromValue(entry.data);
+}
+function logLinesFromProjection(projection) {
+  const projected = projection;
+  const lines = [];
+  for (const key of ["logs", "logEntries", "journalLogs", "runLogs"]) {
+    const entries = projected[key];
+    if (!Array.isArray(entries))
+      continue;
+    for (const entry of entries) {
+      const line = logLineFromValue(entry);
+      if (line !== null)
+        lines.push(line);
+    }
+  }
+  return lines;
+}
+function extractRunLogs(run, deps = {}) {
+  const projectedLines = logLinesFromProjection(run.projection);
+  if (projectedLines.length > 0)
+    return projectedLines;
+  return (deps.readSessionRunEntries ?? readSessionRunEntries)(run.sessionPath).map(logLineFromSessionEntry).filter((line) => line !== null);
+}
+function summarizeRunFailures(run) {
+  const failures = [];
+  const useful = summarizeRunError(run.projection);
+  if (useful)
+    failures.push(`${run.runId}: ${useful}`);
+  if (run.status === "failed" || run.projection.status === "failed")
+    failures.push(`${run.runId}: run status failed`);
+  for (const phase of run.projection.closeoutPhases) {
+    if (phase.outcome === "failed")
+      failures.push(`${run.runId}: closeout ${phase.phase} failed${phase.detail ? ` \u2014 ${phase.detail}` : ""}`);
+  }
+  for (const anomaly of run.projection.anomalies) {
+    failures.push(`${run.runId}: anomaly ${anomaly.kind}${anomaly.detail ? ` \u2014 ${anomaly.detail}` : ""}`);
+  }
+  return failures;
+}
+var summarizeProjectionFailures = summarizeRunFailures;
+async function runsForTask(projectRoot, taskId, deps = {}) {
+  const list = deps.listRuns ?? listRuns;
+  try {
+    const runs = await list(projectRoot);
+    const filtered = runs.filter((run2) => run2.taskId === taskId || run2.runId === taskId);
+    if (filtered.length > 0)
+      return [...filtered];
+  } catch {}
+  const run = await (deps.getRun ?? getRun)(projectRoot, taskId);
+  return run ? [run] : [];
+}
+function runInspectSummaryRows(runs, options = {}) {
+  const attachable = runs.filter((run) => Boolean(run.joinLink && !run.stale)).length;
+  const pendingInbox = options.pendingInbox ?? runs.reduce((total, run) => total + run.pendingApprovals + run.pendingInputs, 0);
+  return [
+    { id: "title", label: "Inspect", currentValue: "runtime", heading: true, description: "session/runtime inspection rows from @rig/client" },
+    { id: "inspect:sessions", label: "RUNS", currentValue: String(runs.length), heading: true, description: `${attachable} attachable OMP collab links` },
+    { id: "inspect:cwd", label: "PROJECT ROOT", currentValue: options.projectRoot ?? "", heading: true, description: "selected target/project root used by Rig chrome" },
+    { id: "inspect:inbox", label: "INBOX", currentValue: String(pendingInbox), values: ["open"], description: "pending run gates; open Inbox to resolve" },
+    { id: "inspect:runs", label: "RUNS", currentValue: String(runs.length), values: ["open"], description: "open Runs to inspect individual run detail, logs, and attach controls" },
+    { id: "inspect:audit", label: "AUDIT", currentValue: "unavailable", heading: true, description: "CLI inspect audit has no cockpit equivalent; use rig inspect audit" }
+  ];
+}
+// packages/run-worker/src/runs/run-status.ts
+import {
+  ACTIVE_RUN_STATUSES,
+  TERMINAL_RUN_STATUSES as TERMINAL_RUN_STATUSES2,
+  isActiveRunStatus,
+  isTerminalRunStatus as isTerminalRunStatus2,
+  normalizeRunStatusToken
+} from "@rig/contracts";
+var KNOWN_RUN_STATUS = Object.fromEntries([...ACTIVE_RUN_STATUSES, ...TERMINAL_RUN_STATUSES2].map((status) => [status, true]));
+function canonicalStatusToken(status) {
+  const normalized = normalizeRunStatusToken(status);
+  if (normalized === "waiting-input")
+    return "waiting-user-input";
+  return normalized;
+}
+function asRunStatus(status) {
+  return KNOWN_RUN_STATUS[status] ? status : null;
+}
+function statusColorRole(status) {
+  switch (canonicalStatusToken(status)) {
+    case "done":
+    case "completed":
+    case "ready":
+    case "healthy":
+    case "approved":
+    case "merged":
+      return "success";
+    case "needs-attention":
+    case "needs_attention":
+    case "waiting-approval":
+    case "waiting-user-input":
+    case "waiting-input":
+    case "waiting_input":
+    case "blocked":
+    case "paused":
+      return "action-yellow";
+    case "running":
+    case "adopted":
+    case "preparing":
+    case "created":
+    case "queued":
+    case "starting":
+    case "pending":
+    case "in_progress":
+    case "in-progress":
+    case "active":
+    case "booting":
+    case "validating":
+    case "reviewing":
+    case "closing-out":
+    case "closing_out":
+      return "active-cyan";
+    case "failed":
+    case "error":
+    case "rejected":
+      return "failure";
+    case "stopped":
+    case "cancelled":
+    case "canceled":
+    case "stale":
+      return "muted";
+    default:
+      return "neutral";
+  }
+}
+function runStatusColorRole(run) {
+  const classification = classifyRun(run);
+  return classification.isNeedsAttention && !classification.isTerminal ? "action-yellow" : statusColorRole(classification.status);
+}
+function isSteerableStatus(status) {
+  switch (status) {
+    case "needs-attention":
+    case "waiting-approval":
+    case "waiting-user-input":
+    case "paused":
+      return false;
+    default: {
+      const runStatus = asRunStatus(status);
+      return runStatus ? isActiveRunStatus(runStatus) : false;
+    }
+  }
+}
+function isNeedsAttention(run) {
+  return canonicalStatusToken(run.status) === "needs-attention" || run.pendingApprovals + run.pendingInputs > 0 || run.stallCount > 0;
+}
+function phaseForStatus(status, runStatus, needsAttention) {
+  if (runStatus && isTerminalRunStatus2(runStatus))
+    return runStatus === "completed" || runStatus === "failed" || runStatus === "stopped" ? runStatus : "stopped";
+  if (needsAttention)
+    return "needs-attention";
+  switch (status) {
+    case "created":
+    case "queued":
+    case "preparing":
+    case "starting":
+    case "booting":
+      return "starting";
+    case "waiting-approval":
+    case "waiting-user-input":
+      return "waiting";
+    case "paused":
+      return "paused";
+    case "running":
+    case "validating":
+    case "reviewing":
+    case "closing-out":
+      return "active";
+    default:
+      return runStatus && isActiveRunStatus(runStatus) ? "active" : "unknown";
+  }
+}
+function classifyRun(run) {
+  const status = canonicalStatusToken(run.status) || (run.live && !run.stale ? "starting" : "unknown");
+  const runStatus = asRunStatus(status);
+  const isTerminal = runStatus ? isTerminalRunStatus2(runStatus) : false;
+  const isNeedsAttentionValue = isNeedsAttention(run);
+  const phase = phaseForStatus(status, runStatus, isNeedsAttentionValue);
+  return {
+    status,
+    phase,
+    isActive: runStatus ? isActiveRunStatus(runStatus) : !isTerminal && status !== "unknown",
+    isTerminal,
+    isNeedsAttention: isNeedsAttentionValue
+  };
+}
+function runStatusText(run) {
+  return classifyRun(run).status;
+}
+function statusRank(run) {
+  const classification = classifyRun(run);
+  if (classification.isNeedsAttention)
+    return 0;
+  switch (classification.phase) {
+    case "needs-attention":
+      return 0;
+    case "active":
+    case "waiting":
+    case "paused":
+      return 1;
+    case "starting":
+      return 2;
+    case "completed":
+      return 3;
+    case "failed":
+      return 4;
+    case "stopped":
+      return 5;
+    case "unknown":
+      return 6;
+  }
+}
+function canSteer(run) {
+  const classification = classifyRun(run);
+  if (classification.phase === "active" || classification.phase === "starting")
+    return true;
+  return classification.isNeedsAttention && isSteerableStatus(classification.status);
+}
+function canStop(run) {
+  const classification = classifyRun(run);
+  return classification.isActive && !classification.isTerminal;
+}
+function canPause(run) {
+  const phase = classifyRun(run).phase;
+  return phase === "active" || phase === "starting";
+}
+function canResume(run) {
+  return classifyRun(run).phase === "paused";
+}
+// packages/run-worker/src/runs/stats.ts
+function parseTimestamp(value) {
+  if (!value)
+    return null;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function median(values) {
+  if (values.length === 0)
+    return null;
+  const sorted = [...values].sort((left, right) => left - right);
+  const middle = Math.floor(sorted.length / 2);
+  return sorted.length % 2 === 1 ? sorted[middle] : (sorted[middle - 1] + sorted[middle]) / 2;
+}
+function rate(part, total) {
+  return total === 0 ? null : part / total;
+}
+function completedDuration(run) {
+  if (run.status !== "completed")
+    return null;
+  const startedAt = parseTimestamp(run.startedAt);
+  const completedAt = parseTimestamp(run.completedAt);
+  if (startedAt === null || completedAt === null || completedAt < startedAt)
+    return null;
+  return completedAt - startedAt;
+}
+async function computeStats(projectRootOrRuns, options = {}) {
+  const sinceMs = options.since ? options.since.getTime() : null;
+  const allRuns = typeof projectRootOrRuns === "string" ? await (options.listRuns ?? (await Promise.resolve().then(() => (init_projection(), exports_projection))).listRuns)(projectRootOrRuns) : projectRootOrRuns;
+  const runs = allRuns.filter((run) => {
+    if (sinceMs === null)
+      return true;
+    const startedAt = parseTimestamp(run.startedAt);
+    return startedAt !== null && startedAt >= sinceMs;
+  });
+  const statusCounts = {};
+  const completionDurations = [];
+  let completedRuns = 0;
+  let failedRuns = 0;
+  let needsAttentionRuns = 0;
+  let steeringTotal = 0;
+  let stallTotal = 0;
+  let approvalsPending = 0;
+  for (const run of runs) {
+    const status = run.status || "unknown";
+    statusCounts[status] = (statusCounts[status] ?? 0) + 1;
+    if (status === "completed")
+      completedRuns += 1;
+    if (status === "failed")
+      failedRuns += 1;
+    if (isNeedsAttention(run))
+      needsAttentionRuns += 1;
+    const duration = completedDuration(run);
+    if (duration !== null)
+      completionDurations.push(duration);
+    steeringTotal += run.steeringCount;
+    stallTotal += run.stallCount;
+    approvalsPending += run.pendingApprovals;
+  }
+  const totalRuns = runs.length;
+  return {
+    since: options.since ? options.since.toISOString() : null,
+    totalRuns,
+    statusCounts,
+    completedRuns,
+    failedRuns,
+    needsAttentionRuns,
+    completionRate: rate(completedRuns, totalRuns),
+    failureRate: rate(failedRuns, totalRuns),
+    needsAttentionRate: rate(needsAttentionRuns, totalRuns),
+    medianCompletionMs: median(completionDurations),
+    steeringTotal,
+    steeringPerRun: totalRuns === 0 ? null : steeringTotal / totalRuns,
+    stallTotal,
+    approvalsRequested: approvalsPending,
+    approvalsApproved: 0,
+    approvalsRejected: 0,
+    approvalsPending
+  };
+}
+var computeRigStats = computeStats;
+
+// packages/run-worker/src/runs/index.ts
+init_projection();
+init_diagnostics();
+export {
+  summarizeRunFailures,
+  summarizeRunError,
+  summarizeProjectionFailures,
+  stringifyLogPayload,
+  statusRank,
+  statusColorRole,
+  runsForTask,
+  runStatusText,
+  runStatusColorRole,
+  runInspectSummaryRows,
+  runBlocksNewRunForTask,
+  resolveRunJoinTarget,
+  resolveJoinTarget,
+  resolveInboxRequest,
+  recordsFromRun,
+  readSessionRunEntries,
+  readPendingInboxCounts,
+  readInboxCounts,
+  rate,
+  parseTimestamp,
+  median,
+  logLinesFromProjection,
+  logLineFromValue,
+  logLineFromSessionEntry,
+  listRuns,
+  listInboxRecords,
+  listInbox,
+  isNeedsAttention,
+  getRun,
+  extractRunLogs,
+  deliverRunControl,
+  deliverRemoteRunControl,
+  computeStats,
+  computeRigStats,
+  completedDuration,
+  collabControlFrames,
+  collabControlFrame,
+  classifyRun,
+  canStop,
+  canSteer,
+  canResume,
+  canPause,
+  assertNoActiveRunForTask,
+  activeRunByTaskId
+};