@addai/node 0.7.0 → 0.8.1

package/README.md

@@ -1,96 +1,96 @@
-# entities-runtime
-
-A standalone Node.js daemon. Install it on any machine, pair with your
-+Ai account, and your account can then run Claude Code / Codex sessions
-on that machine on its behalf — from Vault, from Entity Studio, or from
-anywhere else in +Ai.
-
-## Quick start
-
-```bash
-npx entities-runtime
-```
-
-The first run prints a 5-letter pairing code and a URL:
-
-```
-Pair this runtime with your +Ai account.
-
-  https://vault.add.ai/entity/connect/HDXYC
-
-Enter this code: HDXYC
-```
-
-Open the URL while signed into Vault, enter the code, and the runtime
-starts polling for work. Capabilities (claude, codex, git, node) are
-reported every 30 s.
-
-## Commands
-
-```
-entities-runtime                  run the daemon (foreground)
-entities-runtime status           pairing + capabilities + last-seen
-entities-runtime sessions         recent requests handled (--limit N)
-entities-runtime unpair --yes     disconnect from +Ai
-entities-runtime version          print version
-```
-
-`status` and `sessions` work without the daemon running — they hit
-Supabase directly using the daemon token in
-`~/.entities-runtime/state.json`.
-
-## Architecture
-
-See [`docs/architecture.md`](docs/architecture.md) for the full picture:
-Supabase tables, RPC inventory, request lifecycle, and the cancel-watcher
-flow.
-
-## DiskGuard — Codex scratch-dir disk protection
-
-Each Codex run gets a throwaway `CODEX_HOME` under the OS temp dir
-(`entities-codex-<rand>`). Codex writes its `state_*.sqlite`, logs, caches
-and shell snapshots there — typically 50–350 MB per run. codex-spawn now
-deletes that dir on exit, but a `SIGKILL`, a crash, or an orphan left by a
-previous runtime process can skip that path. On a dedicated host doing
-thousands of runs, those leftovers once grew to ~158 GiB and filled the
-disk (`ENOSPC`, repeated crashes).
-
-**DiskGuard** is the safety net. Like a CCTV DVR overwriting the oldest
-footage when the disk fills, it watches free space on the volume holding
-the temp dir and, when usage crosses a high-water mark, deletes the
-**oldest inactive** scratch dirs — oldest first — until usage drops back
-below a low-water mark, leaving a buffer for the OS. It runs at startup, on
-an interval, and opportunistically right before each new Codex run.
-
-Safety guarantees: it only touches directories directly under the temp root
-whose names match the configured prefix (realpath-validated); it never
-deletes a dir owned by a live session (in-process, or one whose
-`session.lock` PID is still alive) or one younger than the min-age guard;
-and it removes symlink *entries* without following them, so the durable
-`~/.codex` targets behind `sessions`/`auth.json` are never harmed.
-
-Note: DiskGuard can only reclaim space by deleting scratch dirs it owns. If
-a disk is full of *other* data it will evict what it can and log that it
-couldn't reach the target rather than touching anything it doesn't own.
-
-Configure via environment variables (defaults shown):
-
-| Variable | Default | Meaning |
-|---|---|---|
-| `DISKGUARD_ENABLED` | `true` | Master switch for the sweeper. Cleanup-on-exit still runs when `false`. |
-| `DISKGUARD_HIGH_WATER_PCT` | `90` | Start evicting when volume usage reaches this %. |
-| `DISKGUARD_LOW_WATER_PCT` | `80` | Stop evicting once usage drops below this %. Clamped below high-water. |
-| `DISKGUARD_MIN_AGE_MINUTES` | `30` | Never evict a scratch dir younger than this. |
-| `DISKGUARD_CHECK_INTERVAL_SECONDS` | `60` | Periodic sweep cadence. |
-| `DISKGUARD_DRY_RUN` | `false` | Log what would be evicted without deleting anything. |
-| `DISKGUARD_PREFIXES` | `entities-codex-` | Comma-separated dir-name prefixes eligible for eviction. |
-| `DISKGUARD_TEMP_ROOT` | `os.tmpdir()` | Override the watched temp root (mainly for testing). |
-
-## Development
-
-```bash
-npm install
-npm run build
-node dist/cli.js
-npm test        # builds, then runs the node:test suite (see test/)
-```
+# entities-runtime
+
+A standalone Node.js daemon. Install it on any machine, pair with your
++Ai account, and your account can then run Claude Code / Codex sessions
+on that machine on its behalf — from Vault, from Entity Studio, or from
+anywhere else in +Ai.
+
+## Quick start
+
+```bash
+npx entities-runtime
+```
+
+The first run prints a 5-letter pairing code and a URL:
+
+```
+Pair this runtime with your +Ai account.
+
+  https://vault.add.ai/entity/connect/HDXYC
+
+Enter this code: HDXYC
+```
+
+Open the URL while signed into Vault, enter the code, and the runtime
+starts polling for work. Capabilities (claude, codex, git, node) are
+reported every 30 s.
+
+## Commands
+
+```
+entities-runtime                  run the daemon (foreground)
+entities-runtime status           pairing + capabilities + last-seen
+entities-runtime sessions         recent requests handled (--limit N)
+entities-runtime unpair --yes     disconnect from +Ai
+entities-runtime version          print version
+```
+
+`status` and `sessions` work without the daemon running — they hit
+Supabase directly using the daemon token in
+`~/.entities-runtime/state.json`.
+
+## Architecture
+
+See [`docs/architecture.md`](docs/architecture.md) for the full picture:
+Supabase tables, RPC inventory, request lifecycle, and the cancel-watcher
+flow.
+
+## DiskGuard — Codex scratch-dir disk protection
+
+Each Codex run gets a throwaway `CODEX_HOME` under the OS temp dir
+(`entities-codex-<rand>`). Codex writes its `state_*.sqlite`, logs, caches
+and shell snapshots there — typically 50–350 MB per run. codex-spawn now
+deletes that dir on exit, but a `SIGKILL`, a crash, or an orphan left by a
+previous runtime process can skip that path. On a dedicated host doing
+thousands of runs, those leftovers once grew to ~158 GiB and filled the
+disk (`ENOSPC`, repeated crashes).
+
+**DiskGuard** is the safety net. Like a CCTV DVR overwriting the oldest
+footage when the disk fills, it watches free space on the volume holding
+the temp dir and, when usage crosses a high-water mark, deletes the
+**oldest inactive** scratch dirs — oldest first — until usage drops back
+below a low-water mark, leaving a buffer for the OS. It runs at startup, on
+an interval, and opportunistically right before each new Codex run.
+
+Safety guarantees: it only touches directories directly under the temp root
+whose names match the configured prefix (realpath-validated); it never
+deletes a dir owned by a live session (in-process, or one whose
+`session.lock` PID is still alive) or one younger than the min-age guard;
+and it removes symlink *entries* without following them, so the durable
+`~/.codex` targets behind `sessions`/`auth.json` are never harmed.
+
+Note: DiskGuard can only reclaim space by deleting scratch dirs it owns. If
+a disk is full of *other* data it will evict what it can and log that it
+couldn't reach the target rather than touching anything it doesn't own.
+
+Configure via environment variables (defaults shown):
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `DISKGUARD_ENABLED` | `true` | Master switch for the sweeper. Cleanup-on-exit still runs when `false`. |
+| `DISKGUARD_HIGH_WATER_PCT` | `90` | Start evicting when volume usage reaches this %. |
+| `DISKGUARD_LOW_WATER_PCT` | `80` | Stop evicting once usage drops below this %. Clamped below high-water. |
+| `DISKGUARD_MIN_AGE_MINUTES` | `30` | Never evict a scratch dir younger than this. |
+| `DISKGUARD_CHECK_INTERVAL_SECONDS` | `60` | Periodic sweep cadence. |
+| `DISKGUARD_DRY_RUN` | `false` | Log what would be evicted without deleting anything. |
+| `DISKGUARD_PREFIXES` | `entities-codex-` | Comma-separated dir-name prefixes eligible for eviction. |
+| `DISKGUARD_TEMP_ROOT` | `os.tmpdir()` | Override the watched temp root (mainly for testing). |
+
+## Development
+
+```bash
+npm install
+npm run build
+node dist/cli.js
+npm test        # builds, then runs the node:test suite (see test/)
+```

package/dist/autostart-mac.js

@@ -79,36 +79,36 @@ function buildPlist(spec) {
     const env = Object.entries(spec.env)
         .map(([k, v]) => `      <key>${esc(k)}</key>\n      <string>${esc(v)}</string>`)
         .join('\n');
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-  <dict>
-    <key>Label</key>
-    <string>${esc(spec.label)}</string>
-    <key>ProgramArguments</key>
-    <array>
-${args}
-    </array>
-    <key>RunAtLoad</key>
-    <true/>
-    <key>KeepAlive</key>
-    <true/>
-    <key>ThrottleInterval</key>
-    <integer>10</integer>
-    <key>ProcessType</key>
-    <string>Interactive</string>
-    <key>WorkingDirectory</key>
-    <string>${esc(spec.workingDirectory)}</string>
-    <key>StandardOutPath</key>
-    <string>${esc(spec.logPath)}</string>
-    <key>StandardErrorPath</key>
-    <string>${esc(spec.logPath)}</string>
-    <key>EnvironmentVariables</key>
-    <dict>
-${env}
-    </dict>
-  </dict>
-</plist>
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>Label</key>
+    <string>${esc(spec.label)}</string>
+    <key>ProgramArguments</key>
+    <array>
+${args}
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+    <key>ProcessType</key>
+    <string>Interactive</string>
+    <key>WorkingDirectory</key>
+    <string>${esc(spec.workingDirectory)}</string>
+    <key>StandardOutPath</key>
+    <string>${esc(spec.logPath)}</string>
+    <key>StandardErrorPath</key>
+    <string>${esc(spec.logPath)}</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+${env}
+    </dict>
+  </dict>
+</plist>
 `;
 }
 /** Pull ProgramArguments back out of a plist we wrote, for `status`. */

package/dist/autostart-win.js

@@ -128,56 +128,56 @@ function buildVbs(cmdPath) {
  * a second daemon.
  */
 function buildTaskXml(spec) {
-    return `<?xml version="1.0" encoding="UTF-16"?>
-<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
-  <RegistrationInfo>
-    <Date>${xmlEsc(spec.createdAt)}</Date>
-    <Author>@addai/node</Author>
-    <Description>Runs this +Ai Node so entities can reach it. Created by \`ainode startup enable\`.</Description>
-  </RegistrationInfo>
-  <Triggers>
-    <LogonTrigger>
-      <Enabled>true</Enabled>
-      <UserId>${xmlEsc(spec.userId)}</UserId>
-      <Repetition>
-        <Interval>PT5M</Interval>
-        <StopAtDurationEnd>false</StopAtDurationEnd>
-      </Repetition>
-    </LogonTrigger>
-  </Triggers>
-  <Principals>
-    <Principal id="Author">
-      <UserId>${xmlEsc(spec.userId)}</UserId>
-      <LogonType>InteractiveToken</LogonType>
-      <RunLevel>LeastPrivilege</RunLevel>
-    </Principal>
-  </Principals>
-  <Settings>
-    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
-    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
-    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
-    <AllowHardTerminate>true</AllowHardTerminate>
-    <StartWhenAvailable>true</StartWhenAvailable>
-    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
-    <IdleSettings>
-      <StopOnIdleEnd>false</StopOnIdleEnd>
-      <RestartOnIdle>false</RestartOnIdle>
-    </IdleSettings>
-    <AllowStartOnDemand>true</AllowStartOnDemand>
-    <Enabled>true</Enabled>
-    <Hidden>false</Hidden>
-    <RunOnlyIfIdle>false</RunOnlyIfIdle>
-    <WakeToRun>false</WakeToRun>
-    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
-    <Priority>7</Priority>
-  </Settings>
-  <Actions Context="Author">
-    <Exec>
-      <Command>${xmlEsc(spec.wscriptPath)}</Command>
-      <Arguments>"${xmlEsc(spec.vbsPath)}"</Arguments>
-    </Exec>
-  </Actions>
-</Task>
+    return `<?xml version="1.0" encoding="UTF-16"?>
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo>
+    <Date>${xmlEsc(spec.createdAt)}</Date>
+    <Author>@addai/node</Author>
+    <Description>Runs this +Ai Node so entities can reach it. Created by \`ainode startup enable\`.</Description>
+  </RegistrationInfo>
+  <Triggers>
+    <LogonTrigger>
+      <Enabled>true</Enabled>
+      <UserId>${xmlEsc(spec.userId)}</UserId>
+      <Repetition>
+        <Interval>PT5M</Interval>
+        <StopAtDurationEnd>false</StopAtDurationEnd>
+      </Repetition>
+    </LogonTrigger>
+  </Triggers>
+  <Principals>
+    <Principal id="Author">
+      <UserId>${xmlEsc(spec.userId)}</UserId>
+      <LogonType>InteractiveToken</LogonType>
+      <RunLevel>LeastPrivilege</RunLevel>
+    </Principal>
+  </Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <AllowHardTerminate>true</AllowHardTerminate>
+    <StartWhenAvailable>true</StartWhenAvailable>
+    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>
+    <IdleSettings>
+      <StopOnIdleEnd>false</StopOnIdleEnd>
+      <RestartOnIdle>false</RestartOnIdle>
+    </IdleSettings>
+    <AllowStartOnDemand>true</AllowStartOnDemand>
+    <Enabled>true</Enabled>
+    <Hidden>false</Hidden>
+    <RunOnlyIfIdle>false</RunOnlyIfIdle>
+    <WakeToRun>false</WakeToRun>
+    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
+    <Priority>7</Priority>
+  </Settings>
+  <Actions Context="Author">
+    <Exec>
+      <Command>${xmlEsc(spec.wscriptPath)}</Command>
+      <Arguments>"${xmlEsc(spec.vbsPath)}"</Arguments>
+    </Exec>
+  </Actions>
+</Task>
 `;
 }
 function schtasks(args) {

package/dist/cli.js

@@ -192,23 +192,23 @@ async function main() {
         case 'help':
         case '--help':
         case '-h':
-            console.log(`ainode v${index_1.VERSION}
-
-usage:
-  ainode                    run this +Ai Node — daemon + live dashboard
-  ainode harnesses          install / log in agent harnesses (interactive)
-  ainode startup enable     start this node whenever you log in
-  ainode startup disable    stop starting at login
-  ainode startup status     where the startup entry is and what it runs
-  ainode unpair --yes       disconnect from +Ai
-  ainode version            print version
-
-Piped or headless output falls back to plain log lines. Set AINODE_NO_TUI=1
-to force that on a terminal. \`ainode run --ensure\` starts a node only if one
-isn't already running — what the Windows startup task uses.
-
-Pair the node by running it with no args and following the prompt
-to vault.add.ai/entity/connect/<CODE>.
+            console.log(`ainode v${index_1.VERSION}
+
+usage:
+  ainode                    run this +Ai Node — daemon + live dashboard
+  ainode harnesses          install / log in agent harnesses (interactive)
+  ainode startup enable     start this node whenever you log in
+  ainode startup disable    stop starting at login
+  ainode startup status     where the startup entry is and what it runs
+  ainode unpair --yes       disconnect from +Ai
+  ainode version            print version
+
+Piped or headless output falls back to plain log lines. Set AINODE_NO_TUI=1
+to force that on a terminal. \`ainode run --ensure\` starts a node only if one
+isn't already running — what the Windows startup task uses.
+
+Pair the node by running it with no args and following the prompt
+to vault.add.ai/entity/connect/<CODE>.
 `);
             return;
     }

package/dist/session-runner.js

@@ -2198,6 +2198,21 @@ async function runRequest(req) {
     catch {
         /* drive manifest is best-effort — never block a run */
     }
+    // Living Presence: entities that carry the entity-self MCP narrate their work on
+    // table records via its `report_status` tool. Injected HERE — the one place every
+    // spawn path reads (req.system_prompt) — so it reaches EVERY session, board and
+    // channel from a single source, never per-board. Gated on the tool actually being
+    // installed, so it can't confuse entities that don't have it.
+    if (installed.mcps?.some((m) => m.slug === 'entity-self-mcp')) {
+        const livingPresence = [
+            'LIVING PRESENCE — narrate your work so people can see what you are doing in real time.',
+            'Whenever you are working on a specific table record (a card / task / row), call the `report_status` tool at your real milestones: when you claim/start it (status "working", a low progress, a short human note like "Reviewing"), at each checkpoint (bump progress + update the note), if you get stuck and need a human (status "blocked", note why), and when you finish (status "done"). ALWAYS pass the record_id you are working on; if you are working on several records at once, report each separately with its own record_id so they never overwrite each other. This is lightweight — a handful of milestone updates per task; progress is a rough milestone percent (0-100), not a precise measurement.',
+        ].join('\n');
+        req.system_prompt =
+            req.system_prompt && req.system_prompt.trim().length > 0
+                ? `${req.system_prompt}\n\n${livingPresence}`
+                : livingPresence;
+    }
     // Same for the entity's long-term memory: try the +Ai Memory semantic pack
     // (T6's entity-memory-pack edge function) first — it replaces the flat
     // DocFlows title list with a curated recall block for memory_v2-flagged

package/dist/tui/dashboard.d.ts

@@ -7,7 +7,15 @@ export interface DashboardState {
     /** Recent requests, newest first — the NOW band reads the live ones off
      *  the top and the idle line reads the most recent finish. */
     recent: RequestRow[];
+    /** Cursor position in the menu. */
     sel: number;
+    /** Id of the selected live run, or null when the cursor is in the menu.
+     *  Pinned by id rather than by index because the band reorders under the
+     *  cursor: a new run is prepended the moment it starts, and an index would
+     *  quietly leave you pointing at a different run than the one you chose. */
+    nowSelId: string | null;
+    /** Live rows the last render could fit — what bounds the cursor. */
+    nowRows: number;
     spin: number;
     pid: number | null;
     startedAt: number | null;
@@ -35,6 +43,19 @@ export declare const MENU: Array<{
 /** Live rows the NOW band shows before it starts counting the rest. */
 export declare const MAX_NOW_ROWS = 6;
 export declare function liveRequests(rows: RequestRow[]): RequestRow[];
+/** The live rows the band actually draws — the only ones the cursor can reach.
+ *  Everything past the cap lives on the Activity screen. A short terminal
+ *  draws fewer than MAX_NOW_ROWS, and the cursor must not run off into rows
+ *  that are not on screen, so the last render's row count is what bounds it. */
+export declare function selectableNow(st: DashboardState): RequestRow[];
+/**
+ * Where the cursor is in the NOW band, or -1 for "in the menu".
+ *
+ * Derived from the pinned id on every read, so a run that finishes while
+ * selected drops the cursor back to the menu rather than silently moving it
+ * onto whichever run took that row.
+ */
+export declare function nowIndex(st: DashboardState): number;
 /**
  * The node's own state, as a label.
  *

package/dist/tui/dashboard.js

@@ -8,6 +8,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_NOW_ROWS = exports.MENU = void 0;
 exports.liveRequests = liveRequests;
+exports.selectableNow = selectableNow;
+exports.nowIndex = nowIndex;
 exports.stateLabel = stateLabel;
 exports.autostartLine = autostartLine;
 exports.fmtCount = fmtCount;
@@ -29,6 +31,26 @@ exports.MAX_NOW_ROWS = 6;
 function liveRequests(rows) {
     return rows.filter(r => request_row_1.ACTIVE.has(r.status));
 }
+/** The live rows the band actually draws — the only ones the cursor can reach.
+ *  Everything past the cap lives on the Activity screen. A short terminal
+ *  draws fewer than MAX_NOW_ROWS, and the cursor must not run off into rows
+ *  that are not on screen, so the last render's row count is what bounds it. */
+function selectableNow(st) {
+    const cap = Math.max(1, Math.min(exports.MAX_NOW_ROWS, st.nowRows || exports.MAX_NOW_ROWS));
+    return liveRequests(st.recent).slice(0, cap);
+}
+/**
+ * Where the cursor is in the NOW band, or -1 for "in the menu".
+ *
+ * Derived from the pinned id on every read, so a run that finishes while
+ * selected drops the cursor back to the menu rather than silently moving it
+ * onto whichever run took that row.
+ */
+function nowIndex(st) {
+    if (!st.nowSelId)
+        return -1;
+    return selectableNow(st).findIndex(r => r.id === st.nowSelId);
+}
 /**
  * The node's own state, as a label.
  *
@@ -128,7 +150,10 @@ function lastFinished(rows) {
 }
 function nowLines(st, width, rows) {
     const live = liveRequests(st.recent);
-    const out = [`  ${(0, render_1.bold)('Now')}`];
+    const heading = live.length
+        ? `  ${(0, render_1.bold)('Now')}  ${(0, render_1.dim)('↑ to select · ⏎ to watch')}`
+        : `  ${(0, render_1.bold)('Now')}`;
+    const out = [heading];
     if (live.length === 0) {
         const last = lastFinished(st.recent);
         out.push(last
@@ -138,7 +163,9 @@ function nowLines(st, width, rows) {
     }
     out.push((0, request_row_1.requestHeader)(width));
     const shown = live.slice(0, Math.max(1, rows));
-    shown.forEach(r => out.push((0, request_row_1.requestLine)(r, st.now, false, width, st.spin)));
+    st.nowRows = shown.length;
+    const cursor = nowIndex(st);
+    shown.forEach((r, i) => out.push((0, request_row_1.requestLine)(r, st.now, i === cursor, width, st.spin)));
     if (live.length > shown.length) {
         out.push((0, render_1.dim)(`     +${live.length - shown.length} more running`));
     }
@@ -153,8 +180,11 @@ function renderDashboard(st, width, height) {
     // The shortcut letters line up in a column of their own, so the eye can
     // find them without reading the hints.
     const hintWidth = Math.max(...exports.MENU.map(m => m.hint.length)) + 2;
+    // One cursor on screen at a time: while it is up in the NOW band the menu
+    // shows no selection, or the eye reads two.
+    const inNow = nowIndex(st) >= 0;
     const menu = exports.MENU.map((m, i) => {
-        const selected = i === st.sel;
+        const selected = !inNow && i === st.sel;
         const label = selected ? (0, render_1.bold)(m.label.padEnd(11)) : m.label.padEnd(11);
         const cursor = selected ? (0, render_1.cyan)('❯') : ' ';
         const badge = m.key === 'logs' && st.logCount ? `${st.logCount} lines` : '';
@@ -162,7 +192,7 @@ function renderDashboard(st, width, height) {
     });
     const foot = (0, app_1.footerHint)([
         { keys: '↑↓', label: 'move' },
-        { keys: '⏎', label: 'open' },
+        { keys: '⏎', label: inNow ? 'watch this run' : 'open' },
         { keys: 's', label: st.autostart?.enabled ? 'startup off' : 'startup on' },
         { keys: 'r', label: 'refresh' },
         { keys: '?', label: 'keys' },
@@ -202,6 +232,11 @@ function createDashboardScreen(deps) {
         if (recent.length)
             st.recent = recent;
         st.offline = deps.data.offline();
+        // A selected run that has finished is no longer in the band. nowIndex
+        // already reads that as "cursor is in the menu"; drop the id too so the
+        // state doesn't keep pointing at a run nobody can see.
+        if (st.nowSelId && !selectableNow(st).some(r => r.id === st.nowSelId))
+            st.nowSelId = null;
         // Reads a file (and, on Windows, a cached schtasks query) — cheap enough
         // to ride the same poll, so the header can't disagree with reality after
         // someone changes it from Studio or the CLI.
@@ -242,6 +277,43 @@ function createDashboardScreen(deps) {
         // line — a note that never clears becomes furniture.
         setTimeout(() => { st.autostartNote = null; deps.host.redraw(); }, 8000).unref?.();
     };
+    /**
+     * One cursor over two stacked lists: the NOW band sits above the menu, so
+     * ↑ off the top of the menu lands on the LAST live row (the one nearest the
+     * menu) and ↓ off the bottom of the band returns to the first menu item.
+     * Reading the screen top to bottom, the cursor moves the way the eye does.
+     */
+    const moveUp = () => {
+        const live = selectableNow(st);
+        const i = nowIndex(st);
+        if (i < 0) {
+            // In the menu. Step up inside it first; only leave from the top row.
+            if (st.sel > 0) {
+                st.sel -= 1;
+                return;
+            }
+            if (live.length)
+                st.nowSelId = live[live.length - 1].id;
+            return;
+        }
+        if (i > 0)
+            st.nowSelId = live[i - 1].id;
+    };
+    const moveDown = () => {
+        const live = selectableNow(st);
+        const i = nowIndex(st);
+        if (i < 0) {
+            st.sel = Math.min(exports.MENU.length - 1, st.sel + 1);
+            return;
+        }
+        // Past the last live row is the menu, entered at its first item.
+        if (i >= live.length - 1) {
+            st.nowSelId = null;
+            st.sel = 0;
+            return;
+        }
+        st.nowSelId = live[i + 1].id;
+    };
     return {
         id: 'dashboard',
         title: '+Ai Node',
@@ -258,8 +330,8 @@ function createDashboardScreen(deps) {
             return true;
         },
         keys: () => [
-            { keys: '↑↓ / jk', label: 'move between destinations' },
-            { keys: '⏎', label: 'open the selected destination' },
+            { keys: '↑↓ / jk', label: 'move — up from the menu into the live runs' },
+            { keys: '⏎', label: 'open the destination, or watch the selected run' },
             { keys: 'a', label: 'activity — full request history' },
             { keys: 'h', label: 'harnesses — install / log in agent CLIs' },
             { keys: 'l', label: 'logs — daemon output' },
@@ -268,12 +340,12 @@ function createDashboardScreen(deps) {
         ],
         async onKey(key) {
             if (key.name === 'up' || key.name === 'k') {
-                st.sel = Math.max(0, st.sel - 1);
+                moveUp();
                 deps.host.redraw();
                 return;
             }
             if (key.name === 'down' || key.name === 'j') {
-                st.sel = Math.min(exports.MENU.length - 1, st.sel + 1);
+                moveDown();
                 deps.host.redraw();
                 return;
             }
@@ -298,6 +370,12 @@ function createDashboardScreen(deps) {
                 return;
             }
             if (key.name === 'return') {
+                // A selected run wins over the menu: the cursor is visibly on it.
+                const live = selectableNow(st)[nowIndex(st)];
+                if (live) {
+                    deps.openTranscript(live);
+                    return;
+                }
                 const target = exports.MENU[st.sel]?.key;
                 if (target === 'harnesses')
                     deps.openHarnesses();

package/dist/tui/run.js

@@ -192,7 +192,7 @@ async function runDashboard(opts) {
     // the daemon log file, so nothing is lost by watching.
     const logs = (0, console_capture_1.captureConsole)({ logFile: paths_1.RUNTIME_LOG_FILE });
     const state = {
-        self: null, stats: null, recent: [], sel: 0, spin: 0,
+        self: null, stats: null, recent: [], sel: 0, nowSelId: null, nowRows: 0, spin: 0,
         pid: opts.pid, startedAt: opts.startedAt,
         inflight: 0, paired: (0, store_1.isPaired)(), viewerMode: opts.viewerMode,
         offline: false, now: Date.now(), version: opts.version,