@h-rig/cli 0.0.6-alpha.22 → 0.0.6-alpha.221

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

@@ -1,731 +0,0 @@
-// @bun
-var __require = import.meta.require;
-
-// packages/cli/src/commands/_server-client.ts
-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 scopedGitHubBearerTokens = new Map;
-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) {
-  const scopedKey = resolve2(projectRoot);
-  if (scopedGitHubBearerTokens.has(scopedKey))
-    return scopedGitHubBearerTokens.get(scopedKey) ?? null;
-  const privateSession = readPrivateRemoteSessionToken(projectRoot);
-  if (privateSession)
-    return privateSession;
-  return cleanToken(process.env.RIG_SERVER_AUTH_TOKEN) ?? cleanToken(process.env.RIG_REMOTE_AUTH_TOKEN);
-}
-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 getRunTimelineViaServer(context, runId, options = {}) {
-  const url = new URL(`http://rig.local/api/runs/${encodeURIComponent(runId)}/timeline`);
-  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-surface.ts
-import { createInterface } from "readline";
-var CANONICAL_STAGES = [
-  "Connect",
-  "GitHub/task sync",
-  "Prepare workspace",
-  "Launch Pi",
-  "Plan",
-  "Implement",
-  "Validate",
-  "Commit",
-  "Open PR",
-  "Review/CI",
-  "Merge",
-  "Complete"
-];
-function logDetail(log) {
-  return typeof log.detail === "string" ? log.detail.trim() : "";
-}
-function parseProviderProtocolLog(title, detail) {
-  if (title.trim().toLowerCase() !== "agent output")
-    return null;
-  if (!detail.startsWith("{") || !detail.endsWith("}"))
-    return null;
-  try {
-    const record = JSON.parse(detail);
-    if (!record || typeof record !== "object" || Array.isArray(record))
-      return null;
-    const type = record.type;
-    return typeof type === "string" && [
-      "assistant",
-      "message_start",
-      "message_update",
-      "message_end",
-      "stream_event",
-      "tool_result",
-      "tool_execution_start",
-      "tool_execution_update",
-      "tool_execution_end",
-      "turn_start",
-      "turn_end"
-    ].includes(type) ? record : null;
-  } catch {
-    return null;
-  }
-}
-function renderProviderProtocolLog(record) {
-  const type = typeof record.type === "string" ? record.type : "";
-  if (type === "tool_execution_start" || type === "tool_execution_update" || type === "tool_execution_end") {
-    const toolName = String(record.toolName ?? record.name ?? "tool");
-    const status = type === "tool_execution_start" ? "started" : type === "tool_execution_end" ? record.isError === true || record.result && typeof record.result === "object" && !Array.isArray(record.result) && record.result.isError === true ? "failed" : "completed" : "running";
-    return `[Pi tool] ${toolName} ${status}`;
-  }
-  return null;
-}
-function entryId(entry, fallback) {
-  return typeof entry.id === "string" && entry.id.trim() ? entry.id : fallback;
-}
-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 latestByStage = new Map;
-  for (const log of logs) {
-    const title = String(log.title ?? "").toLowerCase();
-    const stageName = String(log.stage ?? "").toLowerCase();
-    const stage = CANONICAL_STAGES.find((candidate) => candidate.toLowerCase() === title || candidate.toLowerCase() === stageName);
-    if (stage)
-      latestByStage.set(stage, log);
-  }
-  const stageLines = CANONICAL_STAGES.flatMap((stage) => {
-    const match = latestByStage.get(stage);
-    return match ? [`${stage}: ${String(match.status ?? status)}${logDetail(match) ? ` \u2014 ${logDetail(match)}` : ""}`] : [];
-  });
-  return [`Rig run ${runId}: ${status}`, ...stageLines].join(`
-`);
-}
-function createPiRunStreamRenderer(output = process.stdout) {
-  let lastSnapshot = "";
-  const assistantTextById = new Map;
-  const seenTimeline = new Set;
-  const seenLogs = new Set;
-  const writeLine = (line) => output.write(`${line}
-`);
-  return {
-    renderSnapshot(snapshot) {
-      const rendered = renderOperatorSnapshot(snapshot);
-      if (rendered && rendered !== lastSnapshot) {
-        writeLine(rendered);
-        lastSnapshot = rendered;
-      }
-    },
-    renderTimeline(entries) {
-      for (const [index, entry] of entries.entries()) {
-        const id = entryId(entry, `timeline:${index}:${String(entry.cursor ?? "")}`);
-        if (entry.type === "assistant_message" && typeof entry.text === "string") {
-          const text = entry.text;
-          const previousText = assistantTextById.get(id) ?? "";
-          if (!previousText && text.trim()) {
-            writeLine("[Pi assistant]");
-          }
-          if (text.startsWith(previousText)) {
-            const delta = text.slice(previousText.length);
-            if (delta)
-              output.write(delta);
-          } else if (text.trim() && text !== previousText) {
-            if (previousText)
-              writeLine(`
-[Pi assistant]`);
-            output.write(text);
-          }
-          assistantTextById.set(id, text);
-          continue;
-        }
-        if (seenTimeline.has(id))
-          continue;
-        seenTimeline.add(id);
-        if (entry.type === "tool_execution_start" || entry.type === "tool_execution_update" || entry.type === "tool_execution_end" || entry.type === "mcp_tool_call") {
-          writeLine(`[Pi tool] ${String(entry.toolName ?? entry.name ?? entry.title ?? entry.type)} ${String(entry.status ?? entry.state ?? "")}`.trim());
-          continue;
-        }
-        if (entry.type === "timeline_warning") {
-          writeLine(`[Rig timeline] ${String(entry.detail ?? entry.message ?? "timeline unavailable")}`);
-        }
-      }
-    },
-    renderLogs(entries) {
-      for (const [index, entry] of entries.entries()) {
-        const id = entryId(entry, `log:${index}:${String(entry.createdAt ?? "")}:${String(entry.title ?? "")}`);
-        if (seenLogs.has(id))
-          continue;
-        seenLogs.add(id);
-        const title = String(entry.title ?? "");
-        if (CANONICAL_STAGES.some((stage) => stage.toLowerCase() === title.toLowerCase()))
-          continue;
-        const detail = logDetail(entry);
-        if (!detail)
-          continue;
-        const protocolRecord = parseProviderProtocolLog(title, detail);
-        if (protocolRecord) {
-          const protocolLine = renderProviderProtocolLog(protocolRecord);
-          if (protocolLine)
-            writeLine(protocolLine);
-          continue;
-        }
-        writeLine(`[${title || "Rig log"}] ${detail}`);
-      }
-    }
-  };
-}
-function createOperatorSurface(options = {}) {
-  const input = options.input ?? process.stdin;
-  const output = options.output ?? process.stdout;
-  const errorOutput = options.errorOutput ?? process.stderr;
-  const renderer = createPiRunStreamRenderer(output);
-  const writeLine = (line) => output.write(`${line}
-`);
-  return {
-    mode: "pi-compatible-text",
-    ...renderer,
-    info: writeLine,
-    error: (message) => errorOutput.write(`${message}
-`),
-    attachCommandInput(handler) {
-      if (options.interactive === false || !input.isTTY)
-        return null;
-      const rl = createInterface({ input, output: process.stdout, terminal: false });
-      rl.on("line", (line) => {
-        Promise.resolve(handler(line)).catch((error) => writeLine(`Operator command failed: ${error instanceof Error ? error.message : String(error)}`));
-      });
-      return { close: () => rl.close() };
-    }
-  };
-}
-
-// 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_STAGES2 = [
-  "Connect",
-  "GitHub/task sync",
-  "Prepare workspace",
-  "Launch Pi",
-  "Plan",
-  "Implement",
-  "Validate",
-  "Commit",
-  "Open PR",
-  "Review/CI",
-  "Merge",
-  "Complete"
-];
-var GREEN = "\x1B[32m";
-var BLUE = "\x1B[34m";
-var MAGENTA = "\x1B[35m";
-var YELLOW = "\x1B[33m";
-var RED = "\x1B[31m";
-var DIM = "\x1B[2m";
-var BOLD = "\x1B[1m";
-var RESET = "\x1B[0m";
-async function loadPiTuiRuntime() {
-  try {
-    return await import("@earendil-works/pi-tui");
-  } catch {
-    const base = new URL("../../../pi/packages/tui/src/", import.meta.url);
-    const [tui, input, terminal, keys, utils] = await Promise.all([
-      import(new URL("tui.ts", base).href),
-      import(new URL("components/input.ts", base).href),
-      import(new URL("terminal.ts", base).href),
-      import(new URL("keys.ts", base).href),
-      import(new URL("utils.ts", base).href)
-    ]);
-    return {
-      Container: tui.Container,
-      TUI: tui.TUI,
-      Input: input.Input,
-      ProcessTerminal: terminal.ProcessTerminal,
-      matchesKey: keys.matchesKey,
-      truncateToWidth: utils.truncateToWidth
-    };
-  }
-}
-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, options = {}) {
-  const run = await getRunDetailsViaServer(context, runId);
-  const logsPage = await getRunLogsViaServer(context, runId, { limit: 100 });
-  const timelinePage = await getRunTimelineViaServer(context, runId, { limit: 200, ...options.timelineCursor ? { cursor: options.timelineCursor } : {} }).catch((error) => ({
-    entries: [{
-      id: `timeline-unavailable:${runId}`,
-      type: "timeline_warning",
-      detail: `Selected Rig server did not provide run timeline events: ${error instanceof Error ? error.message : String(error)}`,
-      createdAt: new Date().toISOString()
-    }],
-    nextCursor: options.timelineCursor ?? null
-  }));
-  const logs = Array.isArray(logsPage.entries) ? logsPage.entries.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))).toReversed() : [];
-  const timeline = Array.isArray(timelinePage.entries) ? timelinePage.entries.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry))) : [];
-  const timelineCursor = typeof timelinePage.nextCursor === "string" ? timelinePage.nextCursor : options.timelineCursor ?? null;
-  return { run, logs, timeline, timelineCursor, rendered: renderOperatorSnapshot({ run, logs, timeline }) };
-}
-function unwrapRun(runPayload) {
-  return runPayload.run && typeof runPayload.run === "object" && !Array.isArray(runPayload.run) ? runPayload.run : runPayload;
-}
-function logDetail2(log) {
-  return typeof log.detail === "string" ? log.detail.trim() : "";
-}
-function logTitle(log) {
-  return typeof log.title === "string" ? log.title.trim() : "";
-}
-function renderAssistantTextFromTimeline(entries) {
-  const assistant = entries.filter((entry) => entry.type === "assistant_message" && typeof entry.text === "string").at(-1);
-  const text = typeof assistant?.text === "string" ? assistant.text.trimEnd() : "";
-  if (!text)
-    return [];
-  return [`${BLUE}${BOLD}Remote Pi assistant${RESET}`, ...text.split(/\r?\n/).slice(-18)];
-}
-function renderToolLines(entries) {
-  return entries.filter((entry) => entry.type === "tool_execution_start" || entry.type === "tool_execution_update" || entry.type === "tool_execution_end" || entry.type === "mcp_tool_call").slice(-8).map((entry) => `${DIM}[tool]${RESET} ${String(entry.toolName ?? entry.name ?? entry.title ?? entry.type)} ${String(entry.status ?? entry.state ?? "")}`.trim());
-}
-function renderStageLines(logs) {
-  const latestByStage = new Map;
-  for (const log of logs) {
-    const title = logTitle(log).toLowerCase();
-    const stageName = String(log.stage ?? "").toLowerCase();
-    const stage = CANONICAL_STAGES2.find((candidate) => candidate.toLowerCase() === title || candidate.toLowerCase() === stageName);
-    if (stage)
-      latestByStage.set(stage, log);
-  }
-  return CANONICAL_STAGES2.map((stage) => {
-    const log = latestByStage.get(stage);
-    const status = String(log?.status ?? "pending");
-    const detail = log ? logDetail2(log) : "";
-    const color = status === "completed" ? GREEN : status === "failed" || status === "rejected" ? RED : status === "pending" ? DIM : YELLOW;
-    const mark = status === "completed" ? "\u2713" : status === "pending" ? "\xB7" : status === "failed" ? "\u2717" : "\u25B6";
-    return `${color}${mark} ${stage}${RESET}${detail ? ` ${DIM}\u2014 ${detail.slice(0, 140)}${RESET}` : ""}`;
-  });
-}
-function renderEventLines(logs) {
-  return logs.filter((log) => !CANONICAL_STAGES2.some((stage) => stage.toLowerCase() === logTitle(log).toLowerCase())).slice(-12).flatMap((log) => {
-    const title = logTitle(log) || "Rig event";
-    const detail = logDetail2(log);
-    if (!detail)
-      return [];
-    const tone = String(log.tone ?? "");
-    const color = tone === "error" ? RED : tone === "tool" ? MAGENTA : DIM;
-    return [`${color}[${title}]${RESET} ${detail.slice(0, 220)}`];
-  });
-}
-
-class RigRunComponent {
-  truncateToWidth;
-  snapshot = { run: {}, logs: [], timeline: [] };
-  localEvents = [];
-  constructor(truncateToWidth) {
-    this.truncateToWidth = truncateToWidth;
-  }
-  update(snapshot) {
-    this.snapshot = snapshot;
-  }
-  addLocalEvent(message) {
-    this.localEvents.push(`${new Date().toLocaleTimeString()} ${message}`);
-    this.localEvents = this.localEvents.slice(-8);
-  }
-  invalidate() {}
-  render(width) {
-    const run = unwrapRun(this.snapshot.run);
-    const runId = String(run.runId ?? run.id ?? "run");
-    const status = String(run.status ?? "unknown");
-    const worker = typeof run.worktreePath === "string" && run.worktreePath.trim() ? run.worktreePath.trim() : typeof run.projectRoot === "string" && run.projectRoot.trim() ? run.projectRoot.trim() : "worker workspace pending";
-    const lines = [
-      `${BOLD}Rig Pi frontend${RESET} ${DIM}(local Pi TUI \u2192 Rig server \u2192 worker Pi backend)${RESET}`,
-      `${BOLD}${runId}${RESET} \xB7 ${status} \xB7 ${DIM}${worker}${RESET}`,
-      "",
-      `${BOLD}Rig flow${RESET}`,
-      ...renderStageLines(this.snapshot.logs ?? []),
-      "",
-      ...renderAssistantTextFromTimeline(this.snapshot.timeline ?? []),
-      ...renderToolLines(this.snapshot.timeline ?? []),
-      "",
-      `${BOLD}Rig / Pi events${RESET}`,
-      ...renderEventLines(this.snapshot.logs ?? []),
-      ...this.localEvents.map((event) => `${GREEN}[frontend]${RESET} ${event}`),
-      ""
-    ];
-    return lines.slice(-42).map((line) => this.truncateToWidth(line, Math.max(10, width)));
-  }
-}
-
-class RigInputComponent {
-  matchesKey;
-  truncateToWidth;
-  input;
-  status = "Type text, /skill:..., or remote Pi slash commands. Local: /stop /detach.";
-  constructor(InputCtor, matchesKey, truncateToWidth, onSubmit, onEscape) {
-    this.matchesKey = matchesKey;
-    this.truncateToWidth = truncateToWidth;
-    this.input = new InputCtor;
-    this.input.onSubmit = (value) => {
-      const text = value.trim();
-      this.input.setValue("");
-      if (text)
-        Promise.resolve(onSubmit(text));
-    };
-    this.input.onEscape = onEscape;
-  }
-  handleInput(data) {
-    if (this.matchesKey(data, "ctrl+d")) {
-      this.input.onEscape?.();
-      return;
-    }
-    this.input.handleInput?.(data);
-  }
-  setStatus(status) {
-    this.status = status;
-  }
-  invalidate() {
-    this.input.invalidate();
-  }
-  render(width) {
-    return [
-      `${DIM}${this.truncateToWidth(this.status, Math.max(10, width))}${RESET}`,
-      `${GREEN}${BOLD}You \u2192 worker Pi:${RESET}`,
-      ...this.input.render(width)
-    ];
-  }
-}
-async function attachRunPiTuiFrontend(context, input) {
-  const piTui = await loadPiTuiRuntime();
-  const terminal = new piTui.ProcessTerminal;
-  const tui = new piTui.TUI(terminal);
-  const root = new piTui.Container;
-  const runView = new RigRunComponent(piTui.truncateToWidth);
-  let detached = false;
-  let steered = input.steered === true;
-  let latest = await readOperatorSnapshot(context, input.runId);
-  let timelineCursor = latest.timelineCursor;
-  runView.update(latest);
-  if (steered)
-    runView.addLocalEvent("initial message queued to worker Pi.");
-  const stop = () => {
-    detached = true;
-    tui.stop();
-  };
-  const inputView = new RigInputComponent(piTui.Input, piTui.matchesKey, piTui.truncateToWidth, async (line) => {
-    if (line === "/detach" || line === "/quit" || line === "/q") {
-      runView.addLocalEvent("detached from run.");
-      stop();
-      return;
-    }
-    if (line === "/stop") {
-      await stopRunViaServer(context, input.runId);
-      runView.addLocalEvent("stop requested.");
-      stop();
-      return;
-    }
-    await steerRunViaServer(context, input.runId, line);
-    steered = true;
-    runView.addLocalEvent(`queued to worker Pi: ${line.slice(0, 160)}`);
-    tui.requestRender();
-  }, stop);
-  root.addChild(runView);
-  root.addChild(inputView);
-  tui.addChild(root);
-  tui.setFocus(inputView.input);
-  tui.start();
-  tui.requestRender(true);
-  const pollMs = Math.max(250, Math.trunc(input.pollMs ?? 1000));
-  try {
-    while (!detached && !TERMINAL_RUN_STATUSES.has(runStatusFromPayload(latest.run))) {
-      await Bun.sleep(pollMs);
-      latest = await readOperatorSnapshot(context, input.runId, { timelineCursor });
-      timelineCursor = latest.timelineCursor;
-      runView.update(latest);
-      inputView.setStatus(`Remote worker ${runStatusFromPayload(latest.run)}. Input is forwarded to worker Pi; /stop /detach are local controls.`);
-      tui.requestRender();
-    }
-  } finally {
-    if (!detached)
-      tui.stop();
-  }
-  return { ...latest, timelineCursor, steered, detached, rendered: renderOperatorSnapshot(latest) };
-}
-async function attachRunOperatorView(context, input) {
-  let steered = false;
-  if (input.message?.trim()) {
-    await steerRunViaServer(context, input.runId, input.message.trim());
-    steered = true;
-  }
-  if (input.follow && !input.once && input.interactive !== false && context.outputMode === "text" && Boolean(process.stdin.isTTY && process.stdout.isTTY)) {
-    return attachRunPiTuiFrontend(context, {
-      runId: input.runId,
-      pollMs: input.pollMs,
-      steered
-    });
-  }
-  const surface = createOperatorSurface({ interactive: input.interactive !== false });
-  let snapshot = await readOperatorSnapshot(context, input.runId);
-  if (context.outputMode === "text") {
-    surface.renderSnapshot(snapshot);
-    surface.renderTimeline(snapshot.timeline);
-    surface.renderLogs(snapshot.logs);
-    if (steered)
-      surface.info("Steering message queued.");
-  }
-  let detached = false;
-  let commandInput = null;
-  if (input.follow && !input.once && context.outputMode === "text") {
-    if (input.interactive !== false && process.stdin.isTTY) {
-      surface.info("Controls: /user <message>, /stop, /detach");
-      commandInput = surface.attachCommandInput(async (line) => {
-        const result = await applyOperatorCommand(context, { runId: input.runId, line });
-        if (result.message)
-          surface.info(result.message);
-        if (result.action === "detach" || result.action === "stopped") {
-          detached = true;
-          commandInput?.close();
-        }
-      });
-    }
-    const pollMs = Math.max(250, Math.trunc(input.pollMs ?? 2000));
-    let timelineCursor = snapshot.timelineCursor;
-    while (!detached && !TERMINAL_RUN_STATUSES.has(runStatusFromPayload(snapshot.run))) {
-      await Bun.sleep(pollMs);
-      snapshot = await readOperatorSnapshot(context, input.runId, { timelineCursor });
-      timelineCursor = snapshot.timelineCursor;
-      surface.renderSnapshot(snapshot);
-      surface.renderTimeline(snapshot.timeline);
-      surface.renderLogs(snapshot.logs);
-    }
-    commandInput?.close();
-  }
-  return { ...snapshot, steered, detached };
-}
-export {
-  renderOperatorSnapshot,
-  createPiRunStreamRenderer,
-  attachRunOperatorView,
-  applyOperatorCommand
-};