@h-rig/cli 0.0.6-alpha.73 → 0.0.6-alpha.75

package/dist/src/index.js

@@ -7887,14 +7887,13 @@ function buildOperatorPiEnv(input) {
     ...input.serverProjectRoot ? { RIG_PROJECT_ROOT: input.serverProjectRoot } : {}
   };
 }
-async function attachRunBundledPiFrontend(context, input) {
-  const tempSessionDir = mkdtempSync(join3(tmpdir(), "rig-pi-frontend-sessions-"));
+async function prepareOperatorConsole(context, runId, tempSessionDir) {
   const server = await ensureServerForCli(context.projectRoot);
   let sessionFileArg = [];
   try {
-    const payload = await requestServerJson(context, `/api/runs/${encodeURIComponent(input.runId)}/session-file`);
+    const payload = await requestServerJson(context, `/api/runs/${encodeURIComponent(runId)}/session-file`);
     if (payload?.ok && typeof payload.content === "string" && payload.content.trim()) {
-      const fileName = typeof payload.fileName === "string" && payload.fileName.trim() ? payload.fileName.replace(/[^A-Za-z0-9._-]/g, "_") : `rig-run-${input.runId}.jsonl`;
+      const fileName = typeof payload.fileName === "string" && payload.fileName.trim() ? payload.fileName.replace(/[^A-Za-z0-9._-]/g, "_") : `rig-run-${runId}.jsonl`;
       const localSessionPath = join3(tempSessionDir, fileName);
       const content = payload.content.split(`
 `).map((line, index) => {
@@ -7913,6 +7912,11 @@ async function attachRunBundledPiFrontend(context, input) {
       sessionFileArg = ["--session", localSessionPath];
     }
   } catch {}
+  return { server, sessionFileArg };
+}
+async function attachRunBundledPiFrontend(context, input) {
+  const tempSessionDir = mkdtempSync(join3(tmpdir(), "rig-pi-frontend-sessions-"));
+  const { server, sessionFileArg } = await withSpinner(`Opening Pi console for run ${input.runId}\u2026`, () => prepareOperatorConsole(context, input.runId, tempSessionDir), { outputMode: context.outputMode });
   const restoreEnv = setTemporaryEnv(buildOperatorPiEnv({
     runId: input.runId,
     serverUrl: server.baseUrl,
@@ -8743,6 +8747,18 @@ import { computeRigStats } from "@rig/runtime/control-plane/native/run-stats";
 import { intro as intro3, log as log4, note as note4, outro as outro3 } from "@clack/prompts";
 import pc5 from "picocolors";
 var TOP_LEVEL_SECTIONS = [
+  {
+    title: "Pi console",
+    subtitle: "the operator surface \u2014 every attach opens the run's FULL Pi session",
+    commands: [
+      { command: "rig run attach <run-id>", description: "Open the run's Pi console: complete transcript (live AND finished runs), worker turns streaming in live." },
+      { command: "type a message", description: "Inside the console, plain text steers the worker mid-turn \u2014 it lands in the agent's context, not a local model." },
+      { command: "!<command>", description: "Inside the console, runs shell in the WORKER's workspace; output streams back into the transcript." },
+      { command: "/<command>", description: "The palette includes the WORKER session's slash commands ([worker]-tagged) next to /rig." },
+      { command: "/rig abort | /rig stop", description: "Abort the worker's current turn, or stop the whole run, from inside the console." },
+      { command: "rig run steer <id> --message <text>", description: "Steer without attaching \u2014 queue a message; the worker picks it up within seconds." }
+    ]
+  },
   {
     title: "Start here",
     subtitle: "one-time setup, pick a server",
@@ -8757,9 +8773,9 @@ var TOP_LEVEL_SECTIONS = [
     subtitle: "find a task, put an agent on it, answer what it asks",
     commands: [
       { command: "rig task list", description: "What's on the board (from the selected source/server)." },
-      { command: "rig task run --next", description: "Dispatch an agent; interactive mode opens the native Pi session." },
+      { command: "rig task run --next", description: "Dispatch an agent on the next ready task; interactive mode drops you into its Pi console." },
       { command: "rig run status", description: "Active and recent runs at a glance." },
-      { command: "rig run attach <id> --follow", description: "Join the live Pi session (worker keeps running if you /detach)." },
+      { command: "rig run attach <id> --follow", description: "Same as plain attach \u2014 the Pi console is always the interactive surface." },
       { command: "rig inbox approvals", description: "Approvals workers are waiting on (then `rig inbox approve \u2026`)." }
     ]
   },
@@ -8838,29 +8854,35 @@ var PRIMARY_GROUPS = [
   },
   {
     name: "run",
-    summary: "Observe, attach to, and control Rig runs.",
-    usage: ["rig run <list|status|show|attach|stop> [options]"],
+    summary: "Observe, attach to, and control Rig runs. `attach` opens the Pi console \u2014 the full worker session, live.",
+    usage: ["rig run <list|status|show|attach|steer|stop|resume|restart> [options]"],
     commands: [
       { command: "list", description: "List recent runs from the selected server or local state.", primary: true },
       { command: "status", description: "Render active and recent run groups.", primary: true },
       { command: "show <id>|--run <id> [--raw]", description: "Show a human run summary; --raw prints the full payload.", primary: true },
-      { command: "attach <run-id>|--run <id> [--follow]", description: "Attach to the run; --follow opens the enriched bundled Pi (worker brain).", primary: true },
+      { command: "attach <run-id>|--run <id>", description: "Open the run's Pi console \u2014 see 'Inside the console' below. Works on live AND finished runs.", primary: true },
+      { command: "steer <run-id> --message <text>", description: "Queue a steering message into a live worker without attaching \u2014 delivered into the agent's context within seconds.", primary: true },
       { command: "stop [<run-id>|--run <id>]", description: "Request stop for one run or local active runs.", primary: true },
-      { command: "steer <run-id> --message <text>", description: "Queue a steering message into a live worker without attaching." },
-      { command: "timeline --run <id> [--follow]", description: "Stream raw run timeline events." },
+      { command: "resume [<run-id>]", description: "Resume an interrupted run on the selected server (defaults to the most recent resumable)." },
+      { command: "restart [<run-id>]", description: "Re-dispatch a run from a clean runtime, reopening its Pi session where possible." },
+      { command: "timeline --run <id> [--follow]", description: "Stream raw run timeline events (scripts; humans should attach)." },
       { command: "replay <run-id>|--run <id> [--with-session]", description: "Print the run's consolidated run.jsonl as a merged timeline; --with-session interleaves the Pi session log." },
-      { command: "resume", description: "Resume the most recent interrupted local run." },
-      { command: "restart", description: "Restart the most recent local run from a clean runtime." },
       { command: "delete|cleanup", description: "Remove completed run records/artifacts." }
     ],
     examples: [
+      "rig run attach <run-id>          # full session console \u2014 live mirror, steering, worker shell",
+      "rig run steer <run-id> --message 'focus on the failing test first'",
       "rig run list",
-      "rig run status",
       "rig run show <run-id>",
-      "rig run attach <run-id> --follow",
       "rig run stop <run-id>"
     ],
-    next: ["Use `rig task run --next` to create a new run.", "Use `--json` when scripts need the full structured record."]
+    next: [
+      "Inside the console: the run's COMPLETE transcript loads on open (finished runs too), and new worker turns stream in live.",
+      "Inside the console: plain text = steering into the worker's context \xB7 !<cmd> = shell in the WORKER workspace \xB7 /<cmd> includes the worker session's commands \xB7 /rig abort stops the current turn.",
+      "The console is read-write but remote-only: nothing runs on your machine; the worker keeps running when you exit.",
+      "Use `rig task run --next` to create a new run; interactive mode drops you straight into its console.",
+      "Use `--json` when scripts need the full structured record."
+    ]
   },
   {
     name: "inbox",
@@ -9083,7 +9105,7 @@ function renderGroup(group) {
 function renderTopLevelHelp() {
   return [
     `${heading("rig")} ${pc5.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
-    pc5.dim("Current path: select a server, choose a task, submit a run, attach with native Pi, clear inbox gates."),
+    pc5.dim("The loop: pick a task, dispatch an agent, open its Pi console (`rig run attach <id>`) to watch and steer it live, clear inbox gates, merge."),
     "",
     ...TOP_LEVEL_SECTIONS.flatMap((section) => [
       `${pc5.bold(pc5.magenta(`\u25C7 ${section.title}`))} \u2014 ${pc5.dim(section.subtitle)}`,
@@ -9167,7 +9189,7 @@ function printTopLevelHelp(state = {}) {
     commandLine("--dry-run", "Print the command plan without mutating state.")
   ].join(`
 `), "Global options");
-  outro3("init \u2192 task run \u2192 watch \u2192 inbox \u2192 merged.");
+  outro3("init \u2192 task run \u2192 attach (Pi console: watch + steer live) \u2192 inbox \u2192 merged.");
 }
 function printAdvancedHelp() {
   if (!shouldUseClackOutput2()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/cli",
-  "version": "0.0.6-alpha.73",
+  "version": "0.0.6-alpha.75",
   "type": "module",
   "description": "Rig package",
   "license": "UNLICENSED",
@@ -24,13 +24,14 @@
   "dependencies": {
     "@clack/prompts": "^1.2.0",
     "@earendil-works/pi-coding-agent": "0.79.0",
-    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.73",
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.73",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.73",
-    "@rig/pi-rig": "npm:@h-rig/pi-rig@0.0.6-alpha.73",
-    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.73",
-    "@rig/server": "npm:@h-rig/server@0.0.6-alpha.73",
-    "@rig/standard-plugin": "npm:@h-rig/standard-plugin@0.0.6-alpha.73",
+    "@earendil-works/pi-tui": "^0.79.0",
+    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.75",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.75",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.75",
+    "@rig/pi-rig": "npm:@h-rig/pi-rig@0.0.6-alpha.75",
+    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.75",
+    "@rig/server": "npm:@h-rig/server@0.0.6-alpha.75",
+    "@rig/standard-plugin": "npm:@h-rig/standard-plugin@0.0.6-alpha.75",
     "effect": "4.0.0-beta.78",
     "picocolors": "^1.1.1"
   }