@h-rig/cli 0.0.6-alpha.9 → 0.0.6-alpha.91

package/dist/src/operator-entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/operator-entry.js

@@ -0,0 +1,3 @@
+// @bun
+// packages/cli/src/operator-entry.ts
+throw new Error("@rig/cli/operator-entry is a retired legacy AuthorityRunRecord operator surface. Run the `rig` CLI instead; it launches upstream OMP with the bundled Rig extension.");

package/dist/src/runner.d.ts

@@ -0,0 +1,47 @@
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
+import type { PolicyMode } from "@rig/runtime/control-plane/runtime/guard-types";
+import type { RunnerContext } from "@rig/runtime/control-plane/runtime/runner-context";
+import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
+import type { CommandExecutionResult, OutputMode } from "@rig/runtime/control-plane/runtime/types";
+export type { RunnerContext } from "@rig/runtime/control-plane/runtime/runner-context";
+/**
+ * CLI-side error with an optional remediation hint. The hint is rendered on
+ * its own line as `Next: <hint>` (and carried in the --json error payload),
+ * so every failure names the next command to run. Extends the runtime
+ * CliError so `instanceof` checks against either class keep working.
+ */
+export declare class CliError extends RuntimeCliError {
+    readonly hint?: string;
+    constructor(message: string, exitCode?: number, options?: {
+        readonly hint?: string;
+    });
+}
+export declare function withProjectRoot(projectRoot: string): void;
+export declare function formatCommand(parts: string[]): string;
+type AgentShellBuild = typeof buildBinary;
+type AgentShellMaterializationOptions = {
+    readonly env?: Record<string, string | undefined>;
+    readonly cwd?: string;
+    readonly moduleDir?: string;
+    readonly build?: AgentShellBuild;
+};
+export declare function resolveAgentMaterializationSourceRoot(projectRoot: string, options?: AgentShellMaterializationOptions): string;
+export declare function ensureAgentShellBinary(projectRoot: string, options?: AgentShellMaterializationOptions): Promise<string>;
+export declare function initializeRuntime(options: {
+    projectRoot: string;
+    dryRun: boolean;
+    outputMode: OutputMode;
+    runId?: string;
+    policyMode?: PolicyMode;
+}): Promise<RunnerContext>;
+export declare function runCommand(context: RunnerContext, parts: string[]): Promise<CommandExecutionResult>;
+export declare function takeFlag(args: string[], flag: string): {
+    value: boolean;
+    rest: string[];
+};
+export declare function takeOption(args: string[], option: string): {
+    value: string | undefined;
+    rest: string[];
+};
+export declare function requireNoExtraArgs(args: string[], usage: string): void;
+export declare function requireTask(taskId: string | undefined, usage: string): string;

package/dist/src/runner.js

@@ -4,12 +4,19 @@ var {$ } = globalThis.Bun;
 import { existsSync, mkdirSync } from "fs";
 import { resolve } from "path";
 import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError } from "@rig/runtime/control-plane/errors";
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
 import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { PluginManager } from "@rig/runtime/control-plane/runtime/plugins";
-import { loadRuntimeContextFromEnv } from "@rig/runtime/control-plane/runtime/context";
 import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-import { CliError as CliError2 } from "@rig/runtime/control-plane/errors";
+
+class CliError extends RuntimeCliError {
+  hint;
+  constructor(message, exitCode = 1, options = {}) {
+    super(message, exitCode);
+    if (options.hint?.trim()) {
+      this.hint = options.hint.trim();
+    }
+  }
+}
 function withProjectRoot(projectRoot) {
   $.cwd(projectRoot);
 }
@@ -61,13 +68,6 @@ async function ensureAgentShellBinary(projectRoot, options = {}) {
 }
 async function initializeRuntime(options) {
   const eventBus = new EventBus({ projectRoot: options.projectRoot, runId: options.runId });
-  const runtimeContext = loadRuntimeContextFromEnv() ?? undefined;
-  const plugins = await PluginManager.load({
-    projectRoot: options.projectRoot,
-    runId: eventBus.getRunId(),
-    eventBus,
-    runtimeContext
-  });
   const context = {
     projectRoot: options.projectRoot,
     dryRun: options.dryRun,
@@ -75,10 +75,8 @@ async function initializeRuntime(options) {
     runId: eventBus.getRunId(),
     policyMode: options.policyMode,
     eventBus,
-    plugins,
     emitEvent: async (type, payload) => {
-      const event = await eventBus.emit(type, payload);
-      await plugins.onEvent(event);
+      await eventBus.emit(type, payload);
     }
   };
   context.runCommand = async (parts) => runCommand(context, parts);
@@ -87,8 +85,7 @@ async function initializeRuntime(options) {
     outputMode: context.outputMode,
     dryRun: context.dryRun,
     policyMode: context.policyMode ?? loadPolicy(options.projectRoot).mode,
-    policyFile: resolve(options.projectRoot, "rig/policy/policy.json"),
-    plugins: context.plugins.list()
+    policyFile: resolve(options.projectRoot, "rig/policy/policy.json")
   });
   return context;
 }
@@ -137,9 +134,8 @@ async function runCommand(context, parts) {
       matchedRuleIds: guardDecision.matchedRules.map((r) => r.id),
       mode: effectiveMode
     });
-    throw new CliError(`Policy blocked command: ${formatted}`, 126);
+    throw new CliError(`Policy blocked command: ${formatted}`, 126, { hint: "Review rig/policy/policy.json, or re-run with `--policy-mode observe` to log instead of block." });
   }
-  await context.plugins.beforeCommand({ command: commandWithEnv, formattedCommand: formatted });
   const startedAt = new Date;
   await context.emitEvent("command.started", {
     command: commandWithEnv,
@@ -159,7 +155,6 @@ async function runCommand(context, parts) {
     if (context.outputMode === "text") {
       console.log(`$ ${formatted}`);
     }
-    await context.plugins.afterCommand(dryResult);
     await context.emitEvent("command.finished", {
       ...dryResult,
       dryRun: true
@@ -199,7 +194,6 @@ async function runCommand(context, parts) {
     stdout: context.outputMode === "json" ? stdout : undefined,
     stderr: context.outputMode === "json" ? stderr : undefined
   };
-  await context.plugins.afterCommand(result);
   if (exitCode !== 0) {
     await context.emitEvent("command.failed", {
       ...result
@@ -233,7 +227,7 @@ function takeOption(args, option) {
     if (current === option) {
       const next = args[index + 1];
       if (!next || next.startsWith("-")) {
-        throw new CliError(`Missing value for ${option}`);
+        throw new CliError(`Missing value for ${option}`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} <value>\`.` });
       }
       value = next;
       index += 1;
@@ -269,5 +263,5 @@ export {
   initializeRuntime,
   formatCommand,
   ensureAgentShellBinary,
-  CliError2 as CliError
+  CliError
 };

package/dist/src/withMutedConsole.d.ts

@@ -0,0 +1,2 @@
+export declare function withMutedConsole<T>(mute: boolean, fn: () => Promise<T>): Promise<T>;
+export declare function withMutedConsole<T>(mute: boolean, fn: () => T): T;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@h-rig/cli",
-  "version": "0.0.6-alpha.9",
+  "version": "0.0.6-alpha.91",
   "type": "module",
-  "description": "Rig package",
+  "description": "Rig CLI launcher for upstream OMP collab; legacy operator entrypoints are retired.",
   "license": "UNLICENSED",
   "files": [
     "dist",
@@ -10,6 +10,7 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     }
   },
@@ -18,15 +19,27 @@
   },
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "bin": {
     "rig": "./dist/bin/rig.js"
   },
   "dependencies": {
-    "@clack/prompts": "^1.2.0",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.9",
-    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.9",
-    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.9",
-    "@rig/server": "npm:@h-rig/server@0.0.6-alpha.9",
-    "picocolors": "^1.1.1"
+    "@oh-my-pi/omp-stats": "16.0.4",
+    "@oh-my-pi/pi-coding-agent": "16.0.4",
+    "@oh-my-pi/pi-tui": "16.0.4",
+    "@oh-my-pi/pi-utils": "16.0.4",
+    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.91",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.91",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.91",
+    "@rig/relay-registry": "0.0.6-alpha.91",
+    "@rig/rig-extension": "npm:@h-rig/rig-extension@0.0.6-alpha.91",
+    "@rig/rig-host": "npm:@h-rig/rig-host@0.0.6-alpha.91",
+    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.91",
+    "@rig/shared": "npm:@h-rig/shared@0.0.6-alpha.91",
+    "@rig/standard-plugin": "npm:@h-rig/standard-plugin@0.0.6-alpha.91",
+    "@xterm/headless": "^6.0.0",
+    "effect": "4.0.0-beta.78",
+    "picocolors": "^1.1.1",
+    "react": "^19.2.0"
   }
 }

package/dist/src/commands/_authority-runs.js

@@ -1,111 +0,0 @@
-// @bun
-// packages/cli/src/commands/_authority-runs.ts
-import { existsSync } from "fs";
-import { resolve } from "path";
-import {
-  readAuthorityRun,
-  readJsonlFile,
-  resolveAuthorityRunDir,
-  writeJsonFile
-} from "@rig/runtime/control-plane/authority-files";
-
-// packages/cli/src/commands/_paths.ts
-import { resolveMonorepoRoot } from "@rig/runtime/control-plane/native/utils";
-function resolveControlPlaneMonorepoRoot(projectRoot) {
-  return resolveMonorepoRoot(projectRoot);
-}
-
-// packages/cli/src/commands/_authority-runs.ts
-var RIG_WORKSPACE_ID = "rig-local-workspace";
-function normalizeRuntimeAdapter(value) {
-  const normalized = value?.trim().toLowerCase();
-  if (!normalized) {
-    return "pi";
-  }
-  if (normalized === "codex" || normalized === "codex-cli" || normalized === "codex-app-server" || normalized === "gpt-codex") {
-    return "codex";
-  }
-  if (normalized === "pi" || normalized === "rig-pi" || normalized === "@rig/pi") {
-    return "pi";
-  }
-  return "claude-code";
-}
-function readLatestBeadRecord(projectRoot, taskId) {
-  const issuesPath = resolve(resolveControlPlaneMonorepoRoot(projectRoot), ".beads", "issues.jsonl");
-  if (!existsSync(issuesPath)) {
-    return null;
-  }
-  let latest = null;
-  for (const issue of readJsonlFile(issuesPath)) {
-    if (!issue || typeof issue !== "object") {
-      continue;
-    }
-    const record = issue;
-    if (record.id === taskId) {
-      latest = record;
-    }
-  }
-  return latest;
-}
-function resolveTaskTitleForAuthorityRun(projectRoot, taskId) {
-  try {
-    const record = readLatestBeadRecord(projectRoot, taskId);
-    const title = record && typeof record.title === "string" ? record.title.trim() : "";
-    if (title) {
-      return title;
-    }
-  } catch {}
-  return null;
-}
-function upsertAgentAuthorityRun(projectRoot, input) {
-  const current = readAuthorityRun(projectRoot, input.runId);
-  const existing = current;
-  const createdAt = existing?.createdAt ?? input.createdAt;
-  const runtimeMode = typeof existing?.runtimeMode === "string" ? existing.runtimeMode : "full-access";
-  const interactionMode = typeof existing?.interactionMode === "string" ? existing.interactionMode : "default";
-  const runMode = typeof existing?.runMode === "string" ? existing.runMode : "autonomous";
-  const runtimeAdapter = normalizeRuntimeAdapter(input.runtimeAdapter ?? existing?.runtimeAdapter ?? "claude-code");
-  const title = resolveTaskTitleForAuthorityRun(projectRoot, input.taskId) ?? input.taskId;
-  const next = {
-    ...existing ?? {},
-    runId: input.runId,
-    projectRoot,
-    workspaceId: existing?.workspaceId ?? RIG_WORKSPACE_ID,
-    taskId: input.taskId,
-    threadId: existing?.threadId ?? null,
-    mode: "local",
-    runtimeAdapter,
-    status: input.status,
-    createdAt,
-    startedAt: input.startedAt ?? existing?.startedAt ?? null,
-    completedAt: input.completedAt ?? existing?.completedAt ?? null,
-    endpointId: existing?.endpointId ?? null,
-    hostId: existing?.hostId ?? null,
-    worktreePath: input.worktreePath ?? existing?.worktreePath ?? null,
-    artifactRoot: input.artifactRoot ?? existing?.artifactRoot ?? null,
-    logRoot: input.logRoot ?? existing?.logRoot ?? null,
-    sessionPath: input.sessionPath ?? existing?.sessionPath ?? null,
-    sessionLogPath: input.sessionLogPath ?? existing?.sessionLogPath ?? null,
-    pid: input.pid ?? existing?.pid ?? null,
-    updatedAt: input.createdAt,
-    title,
-    model: typeof existing?.model === "string" ? existing.model : null,
-    runtimeMode,
-    interactionMode,
-    runMode,
-    initialPrompt: typeof existing?.initialPrompt === "string" ? existing.initialPrompt : null
-  };
-  if (input.errorText !== undefined) {
-    next.errorText = input.errorText;
-  } else if ("errorText" in next) {
-    delete next.errorText;
-  }
-  writeJsonFile(resolve(resolveAuthorityRunDir(projectRoot, input.runId), "run.json"), next);
-  return next;
-}
-export {
-  upsertAgentAuthorityRun,
-  readLatestBeadRecord,
-  normalizeRuntimeAdapter,
-  RIG_WORKSPACE_ID
-};

package/dist/src/commands/_operator-view.js

@@ -1,340 +0,0 @@
-// @bun
-// packages/cli/src/commands/_operator-view.ts
-import { createInterface } from "readline";
-
-// packages/cli/src/commands/_server-client.ts
-import { spawnSync } from "child_process";
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-
-// packages/cli/src/runner.ts
-import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError } from "@rig/runtime/control-plane/errors";
-import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { PluginManager } from "@rig/runtime/control-plane/runtime/plugins";
-import { loadRuntimeContextFromEnv } from "@rig/runtime/control-plane/runtime/context";
-import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-import { CliError as CliError2 } from "@rig/runtime/control-plane/errors";
-
-// packages/cli/src/commands/_server-client.ts
-import { ensureLocalRigServerConnection } from "@rig/runtime/local-server";
-
-// packages/cli/src/commands/_connection-state.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { dirname, resolve } from "path";
-function resolveGlobalConnectionsPath(env = process.env) {
-  const explicit = env.RIG_CONNECTIONS_FILE?.trim();
-  if (explicit)
-    return resolve(explicit);
-  const stateDir = env.RIG_GLOBAL_STATE_DIR?.trim();
-  if (stateDir)
-    return resolve(stateDir, "connections.json");
-  return resolve(homedir(), ".rig", "connections.json");
-}
-function resolveRepoConnectionPath(projectRoot) {
-  return resolve(projectRoot, ".rig", "state", "connection.json");
-}
-function readJsonFile(path) {
-  if (!existsSync(path))
-    return null;
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch (error) {
-    throw new CliError2(`Invalid Rig connection state at ${path}: ${error instanceof Error ? error.message : String(error)}`, 1);
-  }
-}
-function normalizeConnection(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    return null;
-  const record = value;
-  if (record.kind === "local")
-    return { kind: "local", mode: "auto" };
-  if (record.kind === "remote" && typeof record.baseUrl === "string" && record.baseUrl.trim()) {
-    const baseUrl = record.baseUrl.trim().replace(/\/+$/, "");
-    return { kind: "remote", baseUrl };
-  }
-  return null;
-}
-function readGlobalConnections(options = {}) {
-  const path = resolveGlobalConnectionsPath(options.env ?? process.env);
-  const payload = readJsonFile(path);
-  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
-    return { connections: {} };
-  }
-  const rawConnections = payload.connections;
-  const connections = {};
-  if (rawConnections && typeof rawConnections === "object" && !Array.isArray(rawConnections)) {
-    for (const [alias, raw] of Object.entries(rawConnections)) {
-      const connection = normalizeConnection(raw);
-      if (connection)
-        connections[alias] = connection;
-    }
-  }
-  return { connections };
-}
-function readRepoConnection(projectRoot) {
-  const payload = readJsonFile(resolveRepoConnectionPath(projectRoot));
-  if (!payload || typeof payload !== "object" || Array.isArray(payload))
-    return null;
-  const record = payload;
-  const selected = typeof record.selected === "string" ? record.selected.trim() : "";
-  if (!selected)
-    return null;
-  return {
-    selected,
-    project: typeof record.project === "string" ? record.project : undefined,
-    linkedAt: typeof record.linkedAt === "string" ? record.linkedAt : undefined
-  };
-}
-function resolveSelectedConnection(projectRoot, options = {}) {
-  const repo = readRepoConnection(projectRoot);
-  if (!repo)
-    return null;
-  if (repo.selected === "local")
-    return { alias: "local", connection: { kind: "local", mode: "auto" } };
-  const global = readGlobalConnections(options);
-  const connection = global.connections[repo.selected];
-  if (!connection) {
-    throw new CliError2(`Selected Rig connection "${repo.selected}" was not found. Run \`rig connect list\` or \`rig connect use local\`.`, 1);
-  }
-  return { alias: repo.selected, connection };
-}
-
-// packages/cli/src/commands/_server-client.ts
-var cachedGitHubBearerToken;
-function cleanToken(value) {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : null;
-}
-function readPrivateRemoteSessionToken(projectRoot) {
-  const path = resolve2(projectRoot, ".rig", "state", "github-auth.json");
-  if (!existsSync2(path))
-    return null;
-  try {
-    const parsed = JSON.parse(readFileSync2(path, "utf8"));
-    return cleanToken(typeof parsed.apiSessionToken === "string" ? parsed.apiSessionToken : typeof parsed.sessionToken === "string" ? parsed.sessionToken : undefined);
-  } catch {
-    return null;
-  }
-}
-function readGitHubBearerTokenForRemote(projectRoot) {
-  if (cachedGitHubBearerToken !== undefined)
-    return cachedGitHubBearerToken;
-  const privateSession = readPrivateRemoteSessionToken(projectRoot);
-  if (privateSession) {
-    cachedGitHubBearerToken = privateSession;
-    return cachedGitHubBearerToken;
-  }
-  const envToken = cleanToken(process.env.RIG_GITHUB_TOKEN) ?? cleanToken(process.env.GITHUB_TOKEN) ?? cleanToken(process.env.GH_TOKEN);
-  if (envToken) {
-    cachedGitHubBearerToken = envToken;
-    return cachedGitHubBearerToken;
-  }
-  const result = spawnSync("gh", ["auth", "token"], {
-    encoding: "utf8",
-    timeout: 5000,
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-  cachedGitHubBearerToken = result.status === 0 ? cleanToken(result.stdout) : null;
-  return cachedGitHubBearerToken;
-}
-async function ensureServerForCli(projectRoot) {
-  try {
-    const selected = resolveSelectedConnection(projectRoot);
-    if (selected?.connection.kind === "remote") {
-      return {
-        baseUrl: selected.connection.baseUrl,
-        authToken: readGitHubBearerTokenForRemote(projectRoot),
-        connectionKind: "remote"
-      };
-    }
-    const connection = await ensureLocalRigServerConnection(projectRoot);
-    return {
-      baseUrl: connection.baseUrl,
-      authToken: connection.authToken,
-      connectionKind: "local"
-    };
-  } catch (error) {
-    if (error instanceof Error) {
-      throw new CliError2(error.message, 1);
-    }
-    throw error;
-  }
-}
-function mergeHeaders(headers, authToken) {
-  const merged = new Headers(headers);
-  if (authToken) {
-    merged.set("authorization", `Bearer ${authToken}`);
-  }
-  return merged;
-}
-function diagnosticMessage(payload) {
-  if (!payload || typeof payload !== "object" || Array.isArray(payload))
-    return null;
-  const record = payload;
-  const diagnostics = Array.isArray(record.diagnostics) ? record.diagnostics : [];
-  const messages = diagnostics.flatMap((entry) => {
-    if (!entry || typeof entry !== "object" || Array.isArray(entry))
-      return [];
-    const diagnostic = entry;
-    const kind = typeof diagnostic.kind === "string" ? diagnostic.kind : "task-source";
-    const message = typeof diagnostic.message === "string" ? diagnostic.message : null;
-    return message ? [`${kind}: ${message}`] : [];
-  });
-  return messages.length > 0 ? messages.join("; ") : null;
-}
-async function requestServerJson(context, pathname, init = {}) {
-  const server = await ensureServerForCli(context.projectRoot);
-  const response = await fetch(`${server.baseUrl}${pathname}`, {
-    ...init,
-    headers: mergeHeaders(init.headers, server.authToken)
-  });
-  const text = await response.text();
-  const payload = text.trim().length > 0 ? (() => {
-    try {
-      return JSON.parse(text);
-    } catch {
-      return null;
-    }
-  })() : null;
-  if (!response.ok) {
-    const diagnostics = diagnosticMessage(payload);
-    const detail = diagnostics ?? (text || response.statusText);
-    throw new CliError2(`Rig server request failed (${response.status}): ${detail}`, 1);
-  }
-  return payload;
-}
-async function getRunDetailsViaServer(context, runId) {
-  const payload = await requestServerJson(context, `/api/runs/${encodeURIComponent(runId)}`);
-  return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
-}
-async function getRunLogsViaServer(context, runId, options = {}) {
-  const url = new URL(`http://rig.local/api/runs/${encodeURIComponent(runId)}/logs`);
-  if (options.limit !== undefined)
-    url.searchParams.set("limit", String(options.limit));
-  if (options.cursor)
-    url.searchParams.set("cursor", options.cursor);
-  const payload = await requestServerJson(context, `${url.pathname}${url.search}`);
-  return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { entries: [] };
-}
-async function stopRunViaServer(context, runId) {
-  const payload = await requestServerJson(context, "/api/runs/stop", {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify({ runId })
-  });
-  return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { ok: true, runId };
-}
-async function steerRunViaServer(context, runId, message) {
-  const payload = await requestServerJson(context, `/api/runs/${encodeURIComponent(runId)}/steer`, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify({ message })
-  });
-  return payload && typeof payload === "object" && !Array.isArray(payload) ? payload : { ok: true };
-}
-
-// packages/cli/src/commands/_operator-view.ts
-var TERMINAL_RUN_STATUSES = new Set(["completed", "failed", "stopped", "cancelled", "canceled", "closed", "merged", "needs_attention", "needs-attention"]);
-var CANONICAL_STAGES = [
-  "Connect",
-  "GitHub/task sync",
-  "Prepare workspace",
-  "Launch Pi",
-  "Plan",
-  "Implement",
-  "Validate",
-  "Commit",
-  "Open PR",
-  "Review/CI",
-  "Merge",
-  "Complete"
-];
-function renderOperatorSnapshot(snapshot) {
-  const run = snapshot.run.run && typeof snapshot.run.run === "object" ? snapshot.run.run : snapshot.run;
-  const runId = String(run.runId ?? run.id ?? "run");
-  const status = String(run.status ?? "unknown");
-  const logs = snapshot.logs ?? [];
-  const stageLines = CANONICAL_STAGES.flatMap((stage) => {
-    const match = logs.find((log) => String(log.title ?? "").toLowerCase() === stage.toLowerCase() || String(log.stage ?? "").toLowerCase() === stage.toLowerCase());
-    return match ? [`${stage}: ${String(match.status ?? status)}`] : [];
-  });
-  return [`Rig run ${runId}: ${status}`, ...stageLines].join(`
-`);
-}
-function runStatusFromPayload(payload) {
-  const run = payload.run && typeof payload.run === "object" && !Array.isArray(payload.run) ? payload.run : payload;
-  return String(run.status ?? "unknown").toLowerCase();
-}
-async function applyOperatorCommand(context, input, deps = {}) {
-  const line = input.line.trim();
-  if (!line)
-    return { action: "ignored" };
-  if (line === "/detach" || line === "/quit" || line === "/q") {
-    return { action: "detach", message: "Detached from run." };
-  }
-  if (line === "/stop") {
-    await (deps.stop ?? stopRunViaServer)(context, input.runId);
-    return { action: "stopped", message: "Stop requested." };
-  }
-  const userMessage = line.startsWith("/user ") ? line.slice("/user ".length).trim() : line;
-  if (!userMessage)
-    return { action: "ignored" };
-  await (deps.steer ?? steerRunViaServer)(context, input.runId, userMessage);
-  return { action: "continue", message: "Steering message queued." };
-}
-async function readOperatorSnapshot(context, runId) {
-  const run = await getRunDetailsViaServer(context, runId);
-  const logsPage = await getRunLogsViaServer(context, runId, { limit: 100 });
-  const entries = Array.isArray(logsPage.entries) ? logsPage.entries.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
-  return { run, logs: entries, rendered: renderOperatorSnapshot({ run, logs: entries }) };
-}
-async function attachRunOperatorView(context, input) {
-  let steered = false;
-  if (input.message?.trim()) {
-    await steerRunViaServer(context, input.runId, input.message.trim());
-    steered = true;
-  }
-  let snapshot = await readOperatorSnapshot(context, input.runId);
-  if (context.outputMode === "text") {
-    console.log(snapshot.rendered);
-    if (steered)
-      console.log("Steering message queued.");
-  }
-  let detached = false;
-  let rl = null;
-  if (input.follow && !input.once && context.outputMode === "text") {
-    if (input.interactive !== false && process.stdin.isTTY) {
-      console.log("Controls: /user <message>, /stop, /detach");
-      rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-      rl.on("line", (line) => {
-        applyOperatorCommand(context, { runId: input.runId, line }).then((result) => {
-          if (result.message)
-            console.log(result.message);
-          if (result.action === "detach" || result.action === "stopped") {
-            detached = true;
-            rl?.close();
-          }
-        }).catch((error) => console.log(`Operator command failed: ${error instanceof Error ? error.message : String(error)}`));
-      });
-    }
-    let lastRendered = snapshot.rendered;
-    const pollMs = Math.max(250, Math.trunc(input.pollMs ?? 2000));
-    while (!detached && !TERMINAL_RUN_STATUSES.has(runStatusFromPayload(snapshot.run))) {
-      await Bun.sleep(pollMs);
-      snapshot = await readOperatorSnapshot(context, input.runId);
-      if (snapshot.rendered !== lastRendered) {
-        console.log(snapshot.rendered);
-        lastRendered = snapshot.rendered;
-      }
-    }
-    rl?.close();
-  }
-  return { ...snapshot, steered, detached };
-}
-export {
-  renderOperatorSnapshot,
-  attachRunOperatorView,
-  applyOperatorCommand
-};