toolroll 0.9.59 → 0.9.61

package/dist/server/console.css

@@ -30,83 +30,28 @@
     font-family: "Geist Mono"; font-style: normal; font-weight: 600;
     font-display: swap; src: url("/fonts/geist-mono-600.woff2") format("woff2");
   }
-  /* One palette for every page (2026-09-27): neutral grey and paper with
-   * one chart magenta, light by day and dark after hours. The device decides unless
-   * the person pins a theme (html[data-theme], set from their cookie). The
-   * console's older token names map onto it, so the React workspace, the
-   * server-rendered pages and the pre-script fallback all paint the same. */
+  /* Signal's colour, shadow, radius, type and spacing tokens (--so-*) are
+   * generated by youi into src/design/tokens.css, light and dark, and the
+   * server prepends that sheet to this one (chrome.ts STYLE). Edit them in the
+   * design-language repo, never here. The device decides the scheme unless the
+   * person pins one (html[data-theme], set from their cookie). What follows are
+   * the console's older names: views onto those tokens, never a second ramp. */
   :root {
-    color-scheme: light;
-
-    --so-ground: #efefef; --so-paper: #ffffff; --so-sidebar: #efefef; --so-raised: #f5f5f5;
-    --so-ink: #171717; --so-muted: #666666; --so-line: #e6e6e6; --so-input-line: #d4d4d4;
-    --so-accent: #171717; --so-accent-hover: #383838; --so-accent-text: #171717; --so-on-accent: #ffffff; --so-soft: #f2f2f2;
-    --so-nav-ink: #525252; --so-nav-hover: #e4e4e4; --so-nav-current: #ffffff; --so-nav-current-ink: #171717;
-    --so-signal: #171717; --so-signal-hover: #383838; --so-on-signal: #ffffff; --so-signal-soft: #e8e8e8;
-    --so-danger: #c4320a; --so-danger-soft: #feebe7; --so-success: #218358; --so-success-soft: #e6f6eb;
-    --so-warning: #ab6400; --so-warning-soft: #fff4d5; --so-info: #0d74ce; --so-info-soft: #e6f4fe;
-    --so-neutral-ink: #525252; --so-neutral-soft: #f0f0f0; --so-live: #0d74ce;
-    --so-attention: var(--so-signal); --so-on-attention: var(--so-on-signal); --so-attention-soft: var(--so-signal-soft);
-    --so-sheet-shadow: 0 0 0 1px rgb(0 0 0 / .06), 0 1px 2px rgb(0 0 0 / .04), 0 4px 12px -6px rgb(0 0 0 / .06);
-    --so-pill-shadow: 0 0 0 1px rgb(0 0 0 / .06), 0 1px 2px rgb(0 0 0 / .06);
-    --so-overlay: rgb(0 0 0 / .32); --so-shadow-overlay: 0 0 0 1px rgb(0 0 0 / .08), 0 24px 48px -12px rgb(0 0 0 / .22);
-    --so-selection: #d4d4d4; --so-scroll: #cfcfcf; --so-code-bg: #fafafa; --so-user-bubble: #f2f2f2;
-
     --background: var(--so-ground); --foreground: var(--so-ink); --card: var(--so-paper);
     --muted: var(--so-raised); --muted-foreground: var(--so-muted); --border: var(--so-line); --input: var(--so-input-line);
     --primary: var(--so-accent); --primary-foreground: var(--so-on-accent); --secondary: var(--so-raised); --secondary-foreground: var(--so-ink);
     --accent: var(--so-soft); --destructive: var(--so-danger); --destructive-strong: var(--so-danger); --destructive-soft: var(--so-danger-soft);
     --success: var(--so-success); --success-soft: var(--so-success-soft); --warning: var(--so-warning); --warning-soft: var(--so-warning-soft);
     --running: var(--so-info); --running-soft: var(--so-info-soft); --ring: var(--so-signal);
-    /* Magenta means one thing: a person is needed (approve, answer, decide). */
+    /* The accent means one thing: a person is needed (approve, answer, decide). */
     --brand: var(--so-attention); --brand-foreground: var(--so-on-attention); --brand-soft: var(--so-attention-soft);
     --glass: var(--so-paper); --glass-strong: var(--so-paper); --glass-border: var(--so-line); --glass-highlight: transparent;
     --ambient-one: transparent; --ambient-two: transparent; --user-message: var(--so-user-bubble);
     --surface: var(--so-paper); --ok: var(--so-success); --danger: var(--so-danger); --fg-muted: var(--so-muted);
     --shadow: none; --shadow-overlay: var(--so-shadow-overlay);
     --radius: 0.625rem;
-    --so-ease-out: cubic-bezier(.23, 1, .32, 1);
-    --font-sans: "Geist", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
-    --font-mono: "Geist Mono", ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, monospace;
-    /* Phone spacing steps (760px and narrower): side gutter, gap under the
-       header, gap between page blocks, between rows, and inside a card. */
-    --so-phone-gutter: 16px; --so-phone-gap: 12px; --so-phone-block: 14px; --so-phone-row: 8px; --so-phone-card: 12px;
-  }
-  @media (prefers-color-scheme: dark) {
-    :root:not([data-theme="light"]) {
-      color-scheme: dark;
-
-    --so-ground: #0b0b0b; --so-paper: #161616; --so-sidebar: #0b0b0b; --so-raised: #1c1c1c;
-    --so-ink: #ededed; --so-muted: #a1a1a1; --so-line: #262626; --so-input-line: #363636;
-    --so-accent: #ededed; --so-accent-hover: #ffffff; --so-accent-text: #ededed; --so-on-accent: #0a0a0a; --so-soft: #1f1f1f;
-    --so-nav-ink: #a1a1a1; --so-nav-hover: #171717; --so-nav-current: #1f1f1f; --so-nav-current-ink: #ededed;
-    --so-signal: #ededed; --so-signal-hover: #ffffff; --so-on-signal: #0a0a0a; --so-signal-soft: #2e2e2e;
-    --so-danger: #ff977d; --so-danger-soft: rgb(255 151 125 / .12); --so-success: #3dd68c; --so-success-soft: rgb(61 214 140 / .12);
-    --so-warning: #ffca16; --so-warning-soft: rgb(255 202 22 / .12); --so-info: #70b8ff; --so-info-soft: rgb(112 184 255 / .12);
-    --so-neutral-ink: #b4b4b4; --so-neutral-soft: #1f1f1f; --so-live: #70b8ff;
-    --so-attention: var(--so-signal); --so-on-attention: var(--so-on-signal); --so-attention-soft: var(--so-signal-soft);
-    --so-sheet-shadow: 0 0 0 1px #262626, 0 1px 2px rgb(0 0 0 / .4);
-    --so-pill-shadow: 0 0 0 1px #2a2a2a, 0 1px 2px rgb(0 0 0 / .5);
-    --so-overlay: rgb(0 0 0 / .6); --so-shadow-overlay: 0 0 0 1px #2e2e2e, 0 24px 48px -12px rgb(0 0 0 / .7);
-    --so-selection: #3a3a3a; --so-scroll: #333333; --so-code-bg: #111111; --so-user-bubble: #202020;
-    }
-  }
-  :root[data-theme="dark"] {
-    color-scheme: dark;
-
-    --so-ground: #0b0b0b; --so-paper: #161616; --so-sidebar: #0b0b0b; --so-raised: #1c1c1c;
-    --so-ink: #ededed; --so-muted: #a1a1a1; --so-line: #262626; --so-input-line: #363636;
-    --so-accent: #ededed; --so-accent-hover: #ffffff; --so-accent-text: #ededed; --so-on-accent: #0a0a0a; --so-soft: #1f1f1f;
-    --so-nav-ink: #a1a1a1; --so-nav-hover: #171717; --so-nav-current: #1f1f1f; --so-nav-current-ink: #ededed;
-    --so-signal: #ededed; --so-signal-hover: #ffffff; --so-on-signal: #0a0a0a; --so-signal-soft: #2e2e2e;
-    --so-danger: #ff977d; --so-danger-soft: rgb(255 151 125 / .12); --so-success: #3dd68c; --so-success-soft: rgb(61 214 140 / .12);
-    --so-warning: #ffca16; --so-warning-soft: rgb(255 202 22 / .12); --so-info: #70b8ff; --so-info-soft: rgb(112 184 255 / .12);
-    --so-neutral-ink: #b4b4b4; --so-neutral-soft: #1f1f1f; --so-live: #70b8ff;
-    --so-attention: var(--so-signal); --so-on-attention: var(--so-on-signal); --so-attention-soft: var(--so-signal-soft);
-    --so-sheet-shadow: 0 0 0 1px #262626, 0 1px 2px rgb(0 0 0 / .4);
-    --so-pill-shadow: 0 0 0 1px #2a2a2a, 0 1px 2px rgb(0 0 0 / .5);
-    --so-overlay: rgb(0 0 0 / .6); --so-shadow-overlay: 0 0 0 1px #2e2e2e, 0 24px 48px -12px rgb(0 0 0 / .7);
-    --so-selection: #3a3a3a; --so-scroll: #333333; --so-code-bg: #111111; --so-user-bubble: #202020;
+    --font-sans: var(--so-font-sans);
+    --font-mono: var(--so-font-mono);
   }
   * { box-sizing: border-box; }
   /* Touch: no grey flash on a tap, no double-tap zoom wait on a control,

package/dist/server/live.d.ts

@@ -20,6 +20,9 @@ export type LiveRoom = {
 } | {
     kind: "team";
     conversation: string | null;
+} | {
+    kind: "agent";
+    run: number;
 };
 /** A room's name, read strictly: anything else is not a room. */
 export declare function parseLiveRoom(name: string): LiveRoom | null;

package/dist/server/live.js

@@ -1,3 +1,6 @@
+import { randomBytes } from "node:crypto";
+import { boardRunOf, holdAgentView, releaseAgentView } from "../agent-board.js";
+import { agentRunFingerprint } from "../agents-board.js";
 import { createLiveRooms, LiveConnection } from "../live-bus.js";
 import { reproveRemote } from "../operate-remote.js";
 import { rowVisible } from "../project.js";
@@ -8,7 +11,7 @@ import { adapterPolicy } from "./route-policy.js";
 import { requestContext } from "./request-context.js";
 /** A page asks for a few rooms at once: its workspace, what it shows, its conversation. */
 export const LIVE_ROOMS_PER_PAGE = 5;
-const ROOM_NAME = /^(workspace|task|flow|chat|team)(?::([^?]{1,400}))?(?:\?([^#]{0,600}))?$/;
+const ROOM_NAME = /^(workspace|task|flow|chat|team|agent)(?::([^?]{1,400}))?(?:\?([^#]{0,600}))?$/;
 /** At most one workspace nudge a second: a burst of writes is one re-read, the first heard at once. */
 const WORKSPACE_SETTLE_MS = 1_000;
 /** A running reply's preview: at most one snapshot every 80 ms; the last one always goes out. */
@@ -45,6 +48,8 @@ export function parseLiveRoom(name) {
             if (key !== null || !only("conversation"))
                 return null;
             return { kind, conversation: params.get("conversation") || null };
+        case "agent":
+            return key !== null && /^[1-9][0-9]{0,9}$/.test(key) && query === undefined ? { kind, run: Number(key) } : null;
     }
     return null;
 }
@@ -61,6 +66,8 @@ export function createLiveHandlers(runtime, live) {
         return cursor === null ? null : String(cursor);
     }, null, { bus: live.bus });
     const chatViewers = new Set();
+    // One agent's open view (Agents board): what it shows, keyed by the exact run.
+    const agentRooms = createLiveRooms(run => agentRunFingerprint(store, run), null, { bus: live.bus });
     /** The same session, still signed in, from the cookie and the account (never this request's context). */
     const readBrowser = (request, who) => {
         const again = identify(request, false);
@@ -177,7 +184,7 @@ export function createLiveHandlers(runtime, live) {
         if ([...url.searchParams.keys()].some(key => key !== "room") || names.length === 0 || names.length > LIVE_ROOMS_PER_PAGE || new Set(names).size !== names.length)
             return json(response, 400, { error: "room" });
         const rooms = names.map(name => ({ name, room: parseLiveRoom(name) }));
-        if (rooms.some(one => one.room === null) || rooms.filter(one => one.room?.kind === "workspace").length > 1 || rooms.filter(one => one.room?.kind === "chat").length > 1 || rooms.filter(one => one.room?.kind === "team").length > 1)
+        if (rooms.some(one => one.room === null) || rooms.filter(one => one.room?.kind === "agent").length > 1 || rooms.filter(one => one.room?.kind === "workspace").length > 1 || rooms.filter(one => one.room?.kind === "chat").length > 1 || rooms.filter(one => one.room?.kind === "team").length > 1)
             return json(response, 400, { error: "room" });
         // Admit every room before the stream opens, with the answers each page's own stream gave.
         const joins = [];
@@ -198,6 +205,31 @@ export function createLiveHandlers(runtime, live) {
                     // A sign-out or a narrowed account stops it.
                     valid: () => signedIn() && rowVisible(liveCeiling(), repo) && store.accountCanAccess(who.name, repo) }));
             }
+            else if (room.kind === "agent") {
+                const browser = who;
+                const run = store.getRun(room.run);
+                const repo = run === null ? null : store.refForId(run.taskRef)?.repo ?? null;
+                if (run === null || repo === null || !visible(repo) || !store.accountCanAccess(who.name, repo))
+                    return json(response, 404, { error: "run" });
+                // A repair is its build's own activity: its room is the build's.
+                const signedIn = sameBrowser(request, browser), runId = boardRunOf(store, run.id), view = randomBytes(12).toString("hex");
+                // The watch is a short lease in the database, renewed on every keep-alive and released when the page goes:
+                // the process that sends chat pings reads it there (agent-board.ts watchingAgent).
+                const watch = () => { try {
+                    holdAgentView(store, view, who.name, runId, clock());
+                }
+                catch { /* a missed renewal only lets a ping through */ } };
+                joins.push(connection => {
+                    watch();
+                    connection.onKeepAlive(watch);
+                    connection.onClose(() => { try {
+                        releaseAgentView(store, view, clock());
+                    }
+                    catch { /* it lapses on its own */ } });
+                    agentRooms.join(runId, { name: who.name, room: name, connection,
+                        valid: () => signedIn() && rowVisible(liveCeiling(), repo) && store.accountCanAccess(who.name, repo) });
+                });
+            }
             else if (room.kind === "flow") {
                 const browser = who;
                 const flow = store.getFlow(room.flow);
@@ -302,6 +334,7 @@ export function createLiveHandlers(runtime, live) {
             detachChat();
             workspaceRooms.close();
             teamRooms.close();
+            agentRooms.close();
             for (const viewer of [...chatViewers])
                 viewer.connection.close();
         },

package/dist/server/pages.js

@@ -21,7 +21,8 @@ import { run as execRun } from "../exec.js";
 import { computeGaps } from "../gaps.js";
 import { LEDGER_CSV_HEADER, ledgerCsvRows } from "../ledger-csv.js";
 import { ledgerBody } from "../ledger-view.js";
-import { readLiveWindow } from "../live.js";
+import { agentRowOf, agentsBoardOf, agentFactsFor, sealedDiffOf } from "../agents-board.js";
+import { markAgentSeen } from "../agent-board.js";
 import { prometheusMetrics } from "../metrics.js";
 import { readMonitoring } from "../monitoring-settings.js";
 import { targetOf } from "../monitoring.js";
@@ -374,42 +375,64 @@ export function createPagesHandlers(runtime) {
             now,
         }));
     }
-    // The multiplexer in the console (peek): one pane per live run the
-    // ceiling admits, each fed by the run page's own transcript poller
-    // (the byte-offset JSON protocol — text into textContent, never
-    // markup). The pane SET is re-checked on a slow cadence; when it
-    // changes the page reloads rather than swapping pollers mid-flight.
+    // Peek became the Agents board: one place to check on every running agent (agents-board.ts).
     async function peekPage(ctx) {
-        const { url, response, project } = ctx;
-        const live = store.liveRuns(clock()).filter(run => runVisible(run));
-        if (url.searchParams.get("fragment") === "1") {
-            return respond(response, 200, "application/json", JSON.stringify({ runs: live.map(run => run.id) }));
-        }
+        return redirect(ctx.response, "/agents");
+    }
+    /** What the board says after a Reply or a steer, in fixed words (never text from the address). */
+    const AGENT_SAID = {
+        replied: { tone: "info", text: "Reply sent. The agent reads it at its next check." },
+        steered: { tone: "info", text: "Note sent. The agent reads it at its next check." },
+        "reply-closed": { tone: "error", text: "That question was already answered." },
+        "reply-stale": { tone: "error", text: "This attempt ended before your reply, so nothing was sent." },
+        "reply-invalid": { tone: "error", text: "Write a reply of up to 1,500 characters." },
+    };
+    // The Agents board (one place to check on running agents): rows by state, and the opened agent's live view.
+    async function agentsPage(ctx) {
+        const { url, who, response, project } = ctx;
         const now = clock();
-        const panes = live.map(run => {
-            const window = options.localRunner === undefined ? null : readLiveWindow(evidenceRoot, run.id, 0);
-            const tail = window !== null && window.ok ? window.text.split("\n").filter(one => one !== "").slice(-40).join("\n") : "";
-            const stage = run.phase !== null ? run.phase.replace(/-/g, " ") : run.providerStartedAt === null ? "preparing workspace" : "the agent is working";
-            return joinHtml([
-                html `<section class="card peek-pane" data-run="${run.id}">`,
-                html `<p class="row"><a href="/r/${run.id}" class="mono">#${run.id}</a> <a href="${taskHref(run.taskId)}"><strong>${run.title}</strong></a>${projectChip(run.repo)} <span class="right meta mono">${run.runner} \u00b7 ${run.role} \u00b7 ${stage} \u00b7 ${relativeAge(run.startedAt, now)}</span></p>`,
-                options.localRunner === undefined
-                    ? html `<p class="meta">The transcript is readable on the machine that runs the worker \u2014 start the console there with <code>toolroll up</code></p>`
-                    : html `<pre class="recap plan-doc live-pane" id="live-transcript-${run.id}" data-initial-offset="0">${tail}</pre><p class="meta" id="live-transcript-${run.id}-state"></p>`,
-                html `</section>`,
-            ], "\n");
-        });
-        const script = (options.localRunner === undefined ? "" : live.map(run => transcriptScript(`/r/${run.id}`, `live-transcript-${run.id}`)).join("")) +
-            `(function(){var seen=${JSON.stringify(live.map(run => run.id))};function check(){if(document.hidden){setTimeout(check,12000);return;}` +
-            `fetch("/peek?fragment=1",{redirect:"manual",cache:"no-store"}).then(function(r){return r.ok?r.json():null;})` +
-            `.then(function(d){if(d&&Array.isArray(d.runs)&&JSON.stringify(d.runs)!==JSON.stringify(seen)){location.reload();return;}setTimeout(check,12000);})` +
-            `.catch(function(){setTimeout(check,12000);});}setTimeout(check,12000);})();`;
-        return sendScreen(response, 200, screen("peek", joinHtml([
-            html `<h1>Peek</h1>`,
-            panes.length === 0
-                ? html `<p class="meta">No agent is working right now \u2014 this page follows them the moment one starts</p>`
-                : joinHtml(panes, "\n"),
-        ], "\n"), { chrome: chromeFor(project, "runs"), functional: { script, fetches: true } }));
+        const access = workAccess();
+        const asked = url.searchParams.get("run");
+        let selected = null;
+        if (asked !== null && /^[1-9][0-9]{0,9}$/.test(asked)) {
+            const run = store.getRun(Number(asked));
+            const facts = run === null || !runVisible(run) ? null : agentFactsFor(store, run.id, access, who.name);
+            if (facts !== null) {
+                // Opening a finished agent is viewing it: it leaves this person's unread Done.
+                if (facts.outcome !== null && markAgentSeen(store, who.name, facts.runId, now))
+                    facts.seen = true;
+                const live = facts.outcome === null;
+                const sealed = live ? null : sealedDiffOf(store, evidenceRoot, facts.runId);
+                // A reply's own word first; otherwise the note that the agent asked past the questions cap.
+                const said = AGENT_SAID[url.searchParams.get("said") ?? ""] ?? (facts.questionNote === null ? null : { tone: "info", text: facts.questionNote });
+                selected = {
+                    ...agentRowOf(store, facts, now, evidenceRoot), live,
+                    question: live && facts.question !== null ? { ...facts.question, action: `${taskHref(facts.taskId)}/reply` } : null,
+                    transcript: options.localRunner === undefined ? null : `/r/${facts.runId}?fragment=transcript`,
+                    // The live look at its checkout needs this machine's runner and pool, as the run page's does.
+                    peek: live && options.localRunner !== undefined && options.poolRoot !== undefined ? `/r/${facts.runId}?fragment=peek` : null,
+                    files: (sealed?.files ?? []).slice(0, 30).map(one => ({ path: one.path, added: one.additions, removed: one.deletions })),
+                    filesMore: Math.max(0, (sealed?.fileCount ?? 0) - 30),
+                    steer: live ? { action: `${taskHref(facts.taskId)}/steer`, run: facts.runId } : null,
+                    canAct: who.role === "approver" && !store.isDemo(),
+                    taskHref: taskHref(facts.taskId),
+                    // The run's own address: a finished result opens on its result page, anything else on its record.
+                    resultHref: live ? null : `/r/${facts.runId}`,
+                    room: `agent:${facts.runId}`, said,
+                };
+            }
+        }
+        const groups = agentsBoardOf(store, now, access, who.name, evidenceRoot);
+        const view = { kind: "agents", groups, selected,
+            empty: groups.length === 0 ? "No agents in the last day. They show here the moment one starts." : null };
+        const fallback = joinHtml([
+            html `<h1>Agents</h1>`,
+            groups.length === 0 ? html `<p class="meta">${view.empty ?? ""}</p>` : joinHtml(groups.map(group => joinHtml([
+                html `<h2>${group.label}</h2>`,
+                ...group.rows.map(row => html `<p class="row"><a href="${row.href}"><strong>${row.title}</strong></a> <span class="meta">${[row.label, row.line].filter(Boolean).join(" \u00b7 ")}</span></p>`),
+            ], "\n")), "\n"),
+        ], "\n");
+        return sendScreen(response, 200, screen("Agents", fallback, { chrome: chromeFor(project, "runs"), workspace: { view } }));
     }
     async function fleetPage(ctx) {
         const { url, who, response, project } = ctx;
@@ -901,6 +924,7 @@ export function createPagesHandlers(runtime) {
         "activity": activityPage,
         "system": systemScreen,
         "peek": peekPage,
+        "agents": agentsPage,
         "fleet": fleetPage,
         "ledger.export": ledgerExport,
         "menu": menuPage,

package/dist/server/render-chat.js

@@ -494,7 +494,7 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
         reserve: { label: "Worker assignment", action: payload["worker"] === null ? "release" : "reserve", icon: html `<circle cx="12" cy="8" r="4"/><path d="M4 21a8 8 0 0 1 16 0"/>` },
         hold: { label: "Pause work", action: "hold", icon: html `<rect x="6" y="4" width="4" height="16" rx="1"/><rect x="14" y="4" width="4" height="16" rx="1"/>` },
         unhold: { label: "Resume work", action: "release hold", icon: html `<path d="m7 4 13 8-13 8z"/>` },
-        steer: { label: "Guidance for next attempt", action: "add guidance", icon: html `<path d="M5 12h14"/><path d="m13 6 6 6-6 6"/>` },
+        steer: { label: "Guidance for the agent", action: "add guidance", icon: html `<path d="M5 12h14"/><path d="m13 6 6 6-6 6"/>` },
         scope: { label: "Scope revision", action: "save scope", icon: html `<path d="M12 20h9"/><path d="M16.5 3.5a2.1 2.1 0 0 1 3 3L8 18l-4 1 1-4z"/>` },
         answer: { label: "Decision answer", action: "confirm answer", icon: html `<path d="M9.1 9a3 3 0 1 1 5.8 1c0 2-3 2-3 4"/><path d="M12 18h.01"/><circle cx="12" cy="12" r="9"/>` },
         cancel: { label: "Cancel task", action: "open task", icon: html `<path d="m15 9-6 6"/><path d="m9 9 6 6"/><circle cx="12" cy="12" r="9"/>` },
@@ -570,9 +570,21 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
     else if (view.kind === "unhold") {
         what = html `<h3>Release <a href="${taskHref(task)}">${task}</a> from its hold</h3>${facts(["project", mono(repoId)])}`;
     }
+    else if (view.kind === "steer" && payload["mode"] === "pause") {
+        const taskTitle = text("taskTitle") || task;
+        what = html `<h3>Pause <a href="${taskHref(task)}">${taskTitle}</a></h3>${facts(["project", mono(repoId)])}<p class="meta proposal-disclosure">Its current turn stops and the build keeps running; its next note continues it.</p>`;
+    }
+    else if (view.kind === "steer" && payload["mode"] === "resume") {
+        const taskTitle = text("taskTitle") || task;
+        what = html `<h3>Resume <a href="${taskHref(task)}">${taskTitle}</a></h3>${facts(["project", mono(repoId)])}<p class="meta proposal-disclosure">It goes on where it stopped. No note is sent.</p>`;
+    }
+    else if (view.kind === "steer" && payload["mode"] === "pause-and-steer") {
+        const taskTitle = text("taskTitle") || task;
+        what = html `<h3>Pause <a href="${taskHref(task)}">${taskTitle}</a> and send a note</h3><p class="proposal-summary">${text("note")}</p>${facts(["project", mono(repoId)])}<p class="meta proposal-disclosure">Its current turn stops first. The task’s scope doesn’t change.</p>`;
+    }
     else if (view.kind === "steer") {
         const taskTitle = text("taskTitle") || task;
-        what = html `<h3>Guide <a href="${taskHref(task)}">${taskTitle}</a>'s next attempt</h3><p class="proposal-summary">${text("note")}</p>${facts(["when", "next attempt"], ["project", mono(repoId)])}<p class="meta proposal-disclosure">This guides the next attempt without changing the task’s scope. It does not interrupt work already running.</p>`;
+        what = html `<h3>Guidance for <a href="${taskHref(task)}">${taskTitle}</a></h3><p class="proposal-summary">${text("note")}</p>${facts(["project", mono(repoId)])}<p class="meta proposal-disclosure">A running agent reads it when it next checks for notes; otherwise the next attempt does. The task’s scope doesn’t change.</p>`;
     }
     else if (view.kind === "agents") {
         // The agents card (v48): exactly what changes, in the same words the

package/dist/server/render-tasks.d.ts

@@ -264,10 +264,18 @@ export declare function taskStatusCard(status: DisplayStatus & {
     diagnostics?: WorkStatus["diagnostics"];
 }, taskId: string, dispatch: DispatchDiagnosis | null, runId: number | null, approvalAction?: boolean): Html;
 export declare function checkProgressHtml(progress: CheckProgress | null, id?: string): Html;
-export declare function taskControlDetailsHtml(control: TaskControlView, taskId: string, csrf: string, surface: "task" | "chat", inert?: boolean, stopElsewhere?: boolean): Html;
+export declare function taskControlDetailsHtml(control: TaskControlView, taskId: string, csrf: string, surface: "task" | "chat", inert?: boolean, stopElsewhere?: boolean, livePause?: LivePauseFact | null): Html;
 /** `stopElsewhere`: the Building card already carries this exact run's Stop, so the control card keeps only its details.
  * `csrf` is only a guard now: an empty one (a read-only surface) renders no forms; postForm writes the field. */
-export declare function taskControlHtml(control: TaskControlView, taskId: string, csrf: string, surface: "task" | "chat", inert?: boolean, stopElsewhere?: boolean): Html;
+/** Live steering: the Claude build that takes Pause right now, its latest pause (null: none, or it continued), and
+ * until when a paused build can wait before it ends (null: no idle limit). */
+export type LivePauseFact = {
+    run: number;
+    state: "pausing" | "paused" | null;
+    until?: string | null;
+    limitMs?: number | null;
+};
+export declare function taskControlHtml(control: TaskControlView, taskId: string, csrf: string, surface: "task" | "chat", inert?: boolean, stopElsewhere?: boolean, livePause?: LivePauseFact | null): Html;
 /** The resume confirmation (v52): the exact run restated, what resuming
  * does and does not do, the gate that would still keep work from
  * starting, and the password typed again. */
@@ -489,6 +497,8 @@ export declare function taskBodyParts(data: {
     liveRunId?: number | null;
     /** What the agent did last on that live run, and when (task-activity.ts). */
     activity?: RunActivity | null;
+    /** Live steering: the Claude build that takes Pause right now, and its latest pause (null: none, or it continued). */
+    livePause?: LivePauseFact | null;
     /** Workers that are both alive and authorized for this task's project. */
     worker?: {
         answering: number;
@@ -570,6 +580,8 @@ export declare function taskBodyParts(data: {
     } | null;
     /** Operator steering notes (arc 1), delivery state included. */
     steering?: SteerNote[];
+    /** A build's agent is running now and reads new notes when it next checks for them (v120). */
+    steeringLive?: boolean;
     /** The publication grant the publisher would act under — from
      * publicationGrantFor(repo) only; null when none, or no project. */
     grant?: PublicationGrant | null;

package/dist/server/render-tasks.js

@@ -34,8 +34,10 @@ import { runCostWords } from "../summary.js";
 import {} from "../task-control.js";
 import { assignmentStageOf, demoChecksOf, stageOfCode, stageOfDispatch, STATUS_MORE, taskStatusOf } from "../task-status.js";
 import { buildProgressOf, dispatchActionLabel, earlierAttemptsWords, receiptPublicationWords, resultStatusOf, REVIEW_TOKENS, workStatusOf } from "../workspace-ui.js";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
+import { TEXT_LIMITS } from "../text-limits.js";
 import { isOverdue, oneLineOf, projectChip, regionScript, safePrUrl, screen, SENSITIVE_INPUT, sentenceCase, shortDigest, transcriptScript, whenTime } from "./chrome.js";
+import { steerDestinationWords, steerStandingParts } from "../steer-status.js";
 import { reviewHref, taskChatHref, taskHref } from "./http.js";
 import { coordinatorProposalsSection } from "./render-chat.js";
 import { completionReceiptCard, criterionMatrixHtml, evidenceWords, homePhaseWords, incidentWords, needsCheck, pullRequestCardHtml, reasonWords, receiptStatusOf, repairChainHtml, reportItemsHtml, reviewRetryPanel, runNoun, runOutcomeBadge, semanticCoverageHtml, terminalDiffCard, verificationExplanation, verificationRecovered } from "./render-results.js";
@@ -807,14 +809,26 @@ export function checkProgressHtml(progress, id = "check-progress") {
         : Object.values(progress.suites).every(one => one.state === "passed") ? "passed" : "unknown";
     return html `<p id="${id}" class="check-progress mono" data-check-progress data-final="${state}" role="status" aria-live="polite">${progress.line}</p>`;
 }
-export function taskControlDetailsHtml(control, taskId, csrf, surface, inert = false, stopElsewhere = false) {
-    const card = taskControlHtml(control, taskId, csrf, surface, inert, stopElsewhere);
+export function taskControlDetailsHtml(control, taskId, csrf, surface, inert = false, stopElsewhere = false, livePause = null) {
+    const card = taskControlHtml(control, taskId, csrf, surface, inert, stopElsewhere, livePause);
     return control.kind === "paused" || control.kind === "review-stopped" || control.kind === "stopping"
         ? html `<details id="task-control-details"><summary>${control.kind === "paused" ? "Preserved work and resume" : "Stop details"}</summary>${card}</details>` : card;
 }
-/** `stopElsewhere`: the Building card already carries this exact run's Stop, so the control card keeps only its details.
- * `csrf` is only a guard now: an empty one (a read-only surface) renders no forms; postForm writes the field. */
-export function taskControlHtml(control, taskId, csrf, surface, inert = false, stopElsewhere = false) {
+/** Pause and Pause and steer beside the task page's Stop (live steering): the same exact run, each form under its own
+ * request id so a repeated submit is the same request. Pause hides once asked; a paused build says until when it can
+ * wait and offers Resume, or the note to continue with. */
+function pauseFormsHtml(taskId, livePause) {
+    const form = (fields, button, control, extra = {}) => postForm(`${taskHref(taskId)}/pause`, html `${fields}${button}`, { attrs: { class: "inline task-control-form", "data-task-control": control }, returnTo: "task", hidden: { run: livePause.run, request: `web-${randomUUID()}`, ...extra } });
+    const paused = livePause.state === "paused";
+    const until = livePause.until ?? null, limitMs = livePause.limitMs ?? null;
+    return joinHtml([
+        paused ? html `<p class="meta" role="status" data-live-pause="paused">${until === null || limitMs === null ? "Paused." : html `Paused. It can wait until ${whenTime(until)} (${Math.max(1, Math.round(limitMs / 60_000))} min) before it ends.`}</p>` : "",
+        livePause.state === null ? form(html ``, html `<button type="submit" class="task-control-button">Pause</button>`, "pause") : "",
+        paused ? form(html ``, html `<button type="submit" class="task-control-button">Resume</button>`, "resume", { mode: "resume" }) : "",
+        form(html `<input type="text" name="note" required maxlength="${TEXT_LIMITS.note}" placeholder="${paused ? "note to continue with" : "note for the agent"}" aria-label="${paused ? "note to continue with" : "note for the agent"}">`, html `<button type="submit" class="task-control-button">${paused ? "Continue" : "Pause and steer"}</button>`, "pause-and-steer"),
+    ]);
+}
+export function taskControlHtml(control, taskId, csrf, surface, inert = false, stopElsewhere = false, livePause = null) {
     if (control.kind === "none")
         return html ``;
     const guarded = csrf !== "" && !inert;
@@ -832,6 +846,7 @@ export function taskControlHtml(control, taskId, csrf, surface, inert = false, s
         return joinHtml([
             html `<section class="card task-control" id="task-control" data-task-control="stop" data-control-run="${control.run}" aria-label="stop this attempt">`,
             html `<div class="task-control-copy"><details><summary>Stop details · ${role(control)} #${control.run}</summary><p class="meta">Stopping ends only this attempt's own processes. Its branch, uncommitted work, evidence, and decisions stay preserved; other tasks keep running.</p></details></div>`,
+            stopElsewhere || !guarded || livePause === null || livePause.run !== control.run ? "" : pauseFormsHtml(taskId, livePause),
             stopElsewhere ? "" : guarded
                 ? runForm("stop", "inline task-control-form task-stop-form", html `<button type="submit" class="danger task-control-button">Stop</button>`)
                 : html `<button type="button" class="danger task-control-button" disabled>Stop</button>`,
@@ -1370,24 +1385,21 @@ export function taskBodyParts(data) {
         }
         return box("problem", "Dispatch unknown", "Refresh this task before relying on its scheduler state.", "unknown");
     })();
-    // Operator steering (arc 1): notes for the agent, each wearing exactly
-    // where it stands — waiting, attached, proven delivered, or superseded.
+    // Operator steering (arc 1, v120): notes for the agent, each wearing the
+    // same words the CLI and the lead use — read (and when), waiting for the
+    // running agent, bound for the next attempt, or ended unread.
     const steering = data.steering ?? [];
-    const steerState = (one) => one.authorshipState !== "verified"
-        ? "recorded before steering required a credential — never delivered"
-        : one.supersededAt !== null
-            ? "the task ended before this landed"
-            : one.deliveredAt !== null
-                ? `reached build #${one.attachedRun}`
-                : one.attachedRun !== null
-                    ? `attached to build #${one.attachedRun} — delivery not yet proven`
-                    : "waiting for the next attempt";
+    const steeringLive = data.steeringLive === true;
+    const steerState = (one) => {
+        const { words, readAt } = steerStandingParts(one, steeringLive);
+        return readAt === null ? html `${words}` : html `${words} ${whenTime(readAt)}`;
+    };
     const steerRows = steering.length === 0 ? "" : joinHtml(steering.map(one => html `<p class="row"><span class="meta">${one.author} · ${whenTime(one.createdAt)} · ${steerState(one)}</span> ${one.note}</p>`), "\n");
     const steerForm = data.csrf === "" || task.state === "done" || task.state === "cancelled"
         ? ""
         : joinHtml([
-            postForm(`${taskHref(task.id)}/steer`, html `<input type="text" name="note" placeholder="guidance for the next attempt" aria-label="steering note" style="width:100%;max-width:28rem"><button type="submit">Steer</button>`, { attrs: { class: "row" } }),
-            html `<p class="meta">Lands when the next attempt starts — a running agent is not interrupted, and a note cannot widen the approved scope</p>`,
+            postForm(`${taskHref(task.id)}/steer`, html `<input type="text" name="note" placeholder="guidance for the agent" aria-label="steering note" style="width:100%;max-width:28rem"><button type="submit">Steer</button>`, { attrs: { class: "row" } }),
+            html `<p class="meta">${steerDestinationWords(steeringLive)} A note can't widen the approved scope.</p>`,
         ]);
     const steeringCard = steerRows === "" && steerForm === "" ? "" : html `<h2>Steering</h2>${steerRows}${steerForm}`;
     const holds = data.holds.length === 0
@@ -1896,7 +1908,7 @@ export function taskBodyParts(data) {
     const statusHtml = html `${data.assignment != null && assignmentOptions !== null ? assignmentSummaryHtml(data.assignment, assignmentOptions) : receiptLeads ? completionReceiptCard(data.completion.receipt, task.id, "task", status) : taskStatusCard(status, task.id, data.dispatch ?? null, liveRunId, approveForm !== "" && data.dispatch?.action === "approve-scope")}${checkProgressHtml(data.checkProgress ?? null)}`;
     // The exact-run control (v52), directly under the scheduler's answer:
     // the one place a person stops or resumes THIS attempt.
-    const controlHtml = taskControlDetailsHtml(data.control ?? { kind: "none" }, task.id, data.csrf, "task");
+    const controlHtml = taskControlDetailsHtml(data.control ?? { kind: "none" }, task.id, data.csrf, "task", false, false, data.livePause ?? null);
     const previousResult = data.completion?.receipt == null || receiptLeads ? null : {
         title: data.assignment != null && task.state === "done" ? "Result" : "Previous result",
         html: (completionReceiptCard(data.completion.receipt, task.id, "task", data.assignment == null ? receiptStatusOf(data.completion.receipt) : assignmentStatusOf(data.assignment), data.assignment ?? null, data.assignment == null)),
@@ -2177,6 +2189,11 @@ export function taskBodyParts(data) {
     // The Building card carries Stop for the build it describes (the same form), in place of a second card below it.
     const stop = building && data.control?.kind === "stop" && data.control.run === liveRun.id && data.csrf !== ""
         ? { action: `${taskHref(task.id)}/stop`, run: data.control.run } : null;
+    // Pause and Pause and steer sit beside that Stop, for the same run, when it is a Claude build that takes live input.
+    // Each form carries its own request id, so a repeated submit is the same request and the two never collide.
+    const pause = stop !== null && data.livePause?.run === stop.run
+        ? { action: `${taskHref(task.id)}/pause`, run: stop.run, state: data.livePause.state, requests: [`web-${randomUUID()}`, `web-${randomUUID()}`, `web-${randomUUID()}`],
+            until: data.livePause.until ?? null, limitMs: data.livePause.limitMs ?? null } : null;
     // The Building card keeps its way to the build's own record (/r/<id>), whatever act it shows.
     const record = building ? { label: `Build #${liveRun.id} record`, href: `/r/${liveRun.id}` } : null;
     const earlier = earlierStopped.length === 0 ? null : {
@@ -2206,6 +2223,7 @@ export function taskBodyParts(data) {
         // One quiet line under the step: what the agent did last, and when.
         activity: liveRun === undefined ? null : data.activity ?? null,
         stop,
+        pause,
         record,
         earlier,
         approval: fragmentString(approvalHtml),

package/dist/server/route-table.js

@@ -129,7 +129,8 @@ get("people", "people.page", "/people", { limited: "unscoped", ...free });
 get("pages", "system", "/system");
 get("tasks", "tasks", "/tasks", { limited: "collection" });
 get("tasks", "queue", "/queue");
-get("pages", "peek", "/peek");
+get("pages", "peek", "/peek", free);
+get("pages", "agents", "/agents", { limited: "unscoped", ...free });
 get("pages", "fleet", "/fleet", free);
 get("tasks", "tasks.new", "/tasks/new", { limited: "collection", ...free });
 get("tasks", "task.page", `^\\/t\\/${TASK}$`, { project: "task", limited: "resource", ...free, sample: "/t/one" });
@@ -330,6 +331,7 @@ post("tasks", "task.act.plan-edit", `^\\/t\\/${TASK}\\/plan-edit$`, { project: "
 post("tasks", "task.act.next", `^\\/t\\/${TASK}\\/next$`, { project: "task", limited: "resource", sample: "/t/one/next" });
 post("tasks", "task.act.reopen", `^\\/t\\/${TASK}\\/reopen$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/reopen" });
 post("tasks", "task.act.steer", `^\\/t\\/${TASK}\\/steer$`, { project: "task", limited: "resource", sample: "/t/one/steer" });
+post("tasks", "task.act.reply", `^\\/t\\/${TASK}\\/reply$`, { project: "task", limited: "resource", sample: "/t/one/reply" });
 post("tasks", "task.act.accept-proof", `^\\/t\\/${TASK}\\/accept-proof$`, { project: "task", limited: "resource", sample: "/t/one/accept-proof" });
 post("tasks", "task.act.accept-revision", `^\\/t\\/${TASK}\\/accept-revision$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/accept-revision" });
 post("tasks", "task.act.reject-revision", `^\\/t\\/${TASK}\\/reject-revision$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/reject-revision" });
@@ -339,6 +341,7 @@ post("tasks", "task.act.complete", `^\\/t\\/${TASK}\\/complete$`, { project: "ta
 post("tasks", "task.act.merge", `^\\/t\\/${TASK}\\/merge$`, { project: "task", limited: "resource", sample: "/t/one/merge", ...approver("Only an approver can merge.") });
 post("tasks", "task.act.confirm-stopped", `^\\/t\\/${TASK}\\/confirm-stopped$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/confirm-stopped", ...approver("Only an approver can confirm a build stopped.") });
 post("tasks", "task.act.stop", `^\\/t\\/${TASK}\\/stop$`, { project: "task", limited: "resource", sample: "/t/one/stop" });
+post("tasks", "task.act.pause", `^\\/t\\/${TASK}\\/pause$`, { project: "task", limited: "resource", sample: "/t/one/pause" });
 post("tasks", "task.act.resume-arm", `^\\/t\\/${TASK}\\/resume-arm$`, { project: "task", limited: "resource", sample: "/t/one/resume-arm" });
 post("tasks", "task.act.resume", `^\\/t\\/${TASK}\\/resume$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/resume" });
 for (const one of ["block", "unblock", "repair-dependency", "follow-up"])

package/dist/server/settings.js

@@ -105,6 +105,7 @@ import { removeSsoSettings, saveSsoSettings, SSO_CALLBACK, ssoChangeWords } from
 import { ssoSettingsHtml } from "../sso-ui.js";
 import { lastSweep, saveSweep, storageSweepOff } from "../storage-sweep.js";
 import { storageHtml } from "../storage-ui.js";
+import { landedSummary } from "../landed-cleanup.js";
 import { bytesWords, parseCleanup } from "../storage.js";
 import { isDigestTime, RESULT_SCREENSHOTS } from "../store.js";
 import { checkTeamsCredentials, clearTeamsCredentials, loadTeamsCredentials, saveTeamsCredentials, TeamsError } from "../teams-api.js";
@@ -398,7 +399,7 @@ ${connectionHtml(asked, connection, task)}${command === null ? "" : html `<p>On
             return refuse(response, who, 403, "An instance operator looks after storage.", "/settings");
         const plan = await checkoutPlan(store, storagePool(databaseFile), now, { manual: true });
         const sweep = { last: lastSweep(store), off: storageSweepOff() };
-        return sendScreen(response, 200, screen("Storage", html `<p><a href="/settings">Settings</a></p><h1>Storage</h1>${(storageHtml({ plan, csrf: who.session.csrf, sweep }, { said: url.searchParams.get("said"), problem: url.searchParams.get("problem") }))}`, { chrome: chromeFor(project, "settings") }));
+        return sendScreen(response, 200, screen("Storage", html `<p><a href="/settings">Settings</a></p><h1>Storage</h1>${(storageHtml({ plan, csrf: who.session.csrf, sweep, landed: landedSummary(store) }, { said: url.searchParams.get("said"), problem: url.searchParams.get("problem") }))}`, { chrome: chromeFor(project, "settings") }));
     }
     // Settings → Projects → Pull requests: one project's setup. Off, the checks run on open, so the page says
     // exactly what turning on would do, or what to fix first.

package/dist/server/task-views.js

@@ -418,6 +418,15 @@ export function createTaskViews(runtime) {
                 const found = runtime.store.runsFor(ref.id).find(one => runIsLive(one));
                 return found === undefined ? null : found.id;
             })(),
+            // Live steering: the Claude build that takes Pause right now, and where its latest pause stands.
+            livePause: (() => {
+                const run = ref === null ? null : runtime.store.liveInputRun(ref.id, now);
+                if (run === null)
+                    return null;
+                const pause = runtime.store.livePauseOf(run);
+                const until = pause?.pausedAt == null || pause.limitMs === null ? null : new Date(Date.parse(pause.pausedAt) + pause.limitMs).toISOString();
+                return { run, state: pause?.state ?? null, until, limitMs: pause?.limitMs ?? null };
+            })(),
             worker: (() => {
                 const runners = runtime.store.listRunners().filter(one => one.retiredAt === null);
                 const eligible = ref?.repo === null || ref?.repo === undefined
@@ -473,6 +482,7 @@ export function createTaskViews(runtime) {
                 return { rows, decisions: decisionsFor(runtime.store, rows), now };
             })(),
             steering: ref === null ? [] : runtime.store.listSteerNotes(ref.id),
+            steeringLive: ref !== null && runtime.store.steeringLiveBuild(ref.id, now) !== null,
             // "publishes as" reads ONLY publicationGrantFor(repo) — the grant
             // the publisher would act under — never listGrants(), which is
             // dispatch authority (slice 1c).