@namzu/cli 36.3.1 → 36.4.0

package/dist/chunks/{upgrade-C6QUXRLB.js → upgrade-2FXGSXCP.js}

@@ -150,7 +150,7 @@ var productionDeps = {
     const [{ callEndpoint, readEndpoint }, { schedulePaths }, { resolveNamzuHome }] = await Promise.all([
       import("./endpoint-M2DDENPP.js"),
       import("./paths-DXYFKIJU.js"),
-      import("./home-H4GTIYO5.js")
+      import("./home-RAOAISVY.js")
     ]);
     const endpoint = readEndpoint(schedulePaths(resolveNamzuHome()).endpoint);
     if (endpoint) await callEndpoint(endpoint, "drain-and-restart");
@@ -312,4 +312,4 @@ export {
   runNpmUpgrade,
   upgradeCommand
 };
-//# sourceMappingURL=upgrade-C6QUXRLB.js.map
+//# sourceMappingURL=upgrade-2FXGSXCP.js.map

package/dist/chunks/{worktree-KLD2PAMU.js → worktree-FOHNJC3S.js}

@@ -3,26 +3,26 @@ const require = __namzuCreateRequire(import.meta.url);
 import {
   openManagedWorktrees,
   worktreeOpenHint
-} from "./chunk-52OVP5BG.js";
+} from "./chunk-WIPSZYIM.js";
 import {
   EXIT_OK,
   EXIT_USAGE
 } from "./chunk-Y7B67G22.js";
-import "./chunk-FU4GQ7K2.js";
+import "./chunk-KZJUG4HN.js";
 import {
   terminalDisplayText
 } from "./chunk-EEDZOGV4.js";
 import {
   displayConversationTitle
-} from "./chunk-EKUJUPFA.js";
+} from "./chunk-ZSPSXPRH.js";
 import "./chunk-H6B6AROX.js";
-import "./chunk-S6MZK4LD.js";
-import "./chunk-AS7UWXMN.js";
-import "./chunk-ZG6NVROB.js";
+import "./chunk-PAE4DIXR.js";
+import "./chunk-JRVKQITY.js";
+import "./chunk-CYYGWTKF.js";
 import "./chunk-JORONMD3.js";
-import "./chunk-BOV53LZO.js";
-import "./chunk-HKDPP2JF.js";
-import "./chunk-V3ZLK3XQ.js";
+import "./chunk-O5FRXERG.js";
+import "./chunk-IQKT222K.js";
+import "./chunk-5YWWQUJ5.js";
 import {
   __name
 } from "./chunk-76FLAFCG.js";
@@ -113,4 +113,4 @@ __name(createWorktreeCommand, "createWorktreeCommand");
 export {
   createWorktreeCommand
 };
-//# sourceMappingURL=worktree-KLD2PAMU.js.map
+//# sourceMappingURL=worktree-FOHNJC3S.js.map

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   registerAll,
   registerCommand,
   runCli
-} from "./chunks/chunk-M32YRERZ.js";
+} from "./chunks/chunk-XC2EJGYI.js";
 import {
   DoctorRegistry,
   browserEngineCheck,
@@ -26,7 +26,7 @@ import {
   telemetryInstalledCheck,
   tmpdirWritableCheck,
   vaultRegisteredCheck
-} from "./chunks/chunk-GQN64E36.js";
+} from "./chunks/chunk-6RJSJGZF.js";
 import "./chunks/chunk-ZPR4IMRT.js";
 import "./chunks/chunk-AK2U3N2A.js";
 import "./chunks/chunk-SKKWMMFP.js";
@@ -38,19 +38,19 @@ import {
   DEFAULT_CONFIG,
   loadConfig,
   loadConfigWithProvenance
-} from "./chunks/chunk-LYDXPWAZ.js";
+} from "./chunks/chunk-RSRL3R7C.js";
 import {
   createFormatter,
   isFormatName
 } from "./chunks/chunk-KONYGNG6.js";
 import "./chunks/chunk-MZP6SH3M.js";
-import "./chunks/chunk-I6CDUPVR.js";
+import "./chunks/chunk-KDOMBH7Q.js";
 import "./chunks/chunk-HE7WUOX2.js";
 import "./chunks/chunk-CHIEVVQ2.js";
 import "./chunks/chunk-GNBMKISG.js";
-import "./chunks/chunk-MBBFX64S.js";
+import "./chunks/chunk-MUUBLY7G.js";
 import "./chunks/chunk-US5ZFPAU.js";
-import "./chunks/chunk-DYUOXP5Q.js";
+import "./chunks/chunk-QZSP4UWJ.js";
 import "./chunks/chunk-6LLJQ3KY.js";
 import "./chunks/chunk-Y7B67G22.js";
 import "./chunks/chunk-FTMTO72X.js";
@@ -63,9 +63,9 @@ import {
 import "./chunks/chunk-U3JIZFOS.js";
 import "./chunks/chunk-TCXFKEYW.js";
 import "./chunks/chunk-JORONMD3.js";
-import "./chunks/chunk-BOV53LZO.js";
-import "./chunks/chunk-HKDPP2JF.js";
-import "./chunks/chunk-V3ZLK3XQ.js";
+import "./chunks/chunk-O5FRXERG.js";
+import "./chunks/chunk-IQKT222K.js";
+import "./chunks/chunk-5YWWQUJ5.js";
 import "./chunks/chunk-76FLAFCG.js";
 export {
   ConfigLoadError,

package/dist/integrations/resident/runner-worker.js

@@ -2,24 +2,24 @@ import { createRequire as __namzuCreateRequire } from 'node:module';
 const require = __namzuCreateRequire(import.meta.url);
 import {
   createResidentSessionStep
-} from "../../chunks/chunk-UFTNEQFN.js";
+} from "../../chunks/chunk-5EDECUGH.js";
 import {
   finishRunner,
   lookupResident,
   readRunner,
   runOwnedResident
-} from "../../chunks/chunk-RBX6RVYO.js";
-import "../../chunks/chunk-E7HLYLD7.js";
-import "../../chunks/chunk-IQBR45AU.js";
-import "../../chunks/chunk-56OUKG5W.js";
+} from "../../chunks/chunk-ZPCQBKVG.js";
+import "../../chunks/chunk-2DECDD7E.js";
+import "../../chunks/chunk-WWTZUAII.js";
+import "../../chunks/chunk-LH4NC5YB.js";
 import "../../chunks/chunk-XEUQN4JC.js";
-import "../../chunks/chunk-QXDKRJZ5.js";
-import "../../chunks/chunk-HSEJGSXE.js";
+import "../../chunks/chunk-K5JGJIJV.js";
+import "../../chunks/chunk-RDFZIPD5.js";
 import {
   cliLogger
-} from "../../chunks/chunk-FU4GQ7K2.js";
+} from "../../chunks/chunk-KZJUG4HN.js";
 import "../../chunks/chunk-EEDZOGV4.js";
-import "../../chunks/chunk-LBH5WVXU.js";
+import "../../chunks/chunk-DHXMHWOW.js";
 import "../../chunks/chunk-FTMTO72X.js";
 import "../../chunks/chunk-LXB3S4IC.js";
 import "../../chunks/chunk-OH6TB27S.js";
@@ -29,17 +29,17 @@ import {
 import "../../chunks/chunk-TCXFKEYW.js";
 import {
   openSessions
-} from "../../chunks/chunk-EKUJUPFA.js";
+} from "../../chunks/chunk-ZSPSXPRH.js";
 import "../../chunks/chunk-H6B6AROX.js";
-import "../../chunks/chunk-S6MZK4LD.js";
-import "../../chunks/chunk-AS7UWXMN.js";
-import "../../chunks/chunk-ZG6NVROB.js";
+import "../../chunks/chunk-PAE4DIXR.js";
+import "../../chunks/chunk-JRVKQITY.js";
+import "../../chunks/chunk-CYYGWTKF.js";
 import "../../chunks/chunk-JORONMD3.js";
-import "../../chunks/chunk-BOV53LZO.js";
-import "../../chunks/chunk-HKDPP2JF.js";
+import "../../chunks/chunk-O5FRXERG.js";
+import "../../chunks/chunk-IQKT222K.js";
 import {
   resolveNamzuHome
-} from "../../chunks/chunk-V3ZLK3XQ.js";
+} from "../../chunks/chunk-5YWWQUJ5.js";
 import {
   __name
 } from "../../chunks/chunk-76FLAFCG.js";

package/dist/integrations/subagents/activity-label.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A live label for each background agent that is running.
+ *
+ * Every {@link LABEL_INTERVAL_MS} a running background agent is asked, once and
+ * with no tools, to say in three to five words what it is doing right now. The
+ * answer is shown in the rail's description column in place of the sentence it
+ * was launched with, and goes away when the agent ends. The query never blocks
+ * the agent: it is a separate request, one at a time per agent, and a failed or
+ * malformed answer is dropped and the previous label stays.
+ *
+ * Timing is a plain interval so a test drives it with fake timers.
+ */
+import type { SubagentActivity, SubagentActivityMonitor } from './activity.js';
+/** Least time between two labels of one agent. */
+export declare const LABEL_INTERVAL_MS = 30000;
+/** An agent with fewer messages than this has not done enough to describe. */
+export declare const LABEL_MIN_MESSAGES = 3;
+/** Longest label kept. */
+export declare const LABEL_MAX_CHARS = 100;
+/**
+ * The instruction for the one-turn query. Written for this host.
+ */
+export declare const LABEL_INSTRUCTION: string;
+/** One accepted line, or undefined when the reply cannot be used. */
+export declare function validateLabel(reply: string): string | undefined;
+/** The request body for one label: the task, what the agent did lately, and the last label. */
+export declare function labelPrompt(agent: SubagentActivity): string;
+/** What the host supplies: one tool-less request on the agent's own model. */
+export type AskForLabel = (agent: SubagentActivity, instruction: string, body: string, signal: AbortSignal) => Promise<{
+    readonly text: string;
+} | undefined>;
+export interface ActivityLabeler {
+    stop(): void;
+}
+export declare function startActivityLabeler(options: {
+    readonly activity: SubagentActivityMonitor;
+    readonly ask: AskForLabel;
+    readonly intervalMs?: number;
+}): ActivityLabeler;
+//# sourceMappingURL=activity-label.d.ts.map

package/dist/integrations/subagents/activity-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-label.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/activity-label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAE9E,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,QAAS,CAAA;AACvC,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,IAAI,CAAA;AACnC,0BAA0B;AAC1B,eAAO,MAAM,eAAe,MAAM,CAAA;AAKlC;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAMlB,CAAA;AAEZ,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM/D;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAqB3D;AAaD,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,CACzB,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,KACf,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAAA;AAEnD,MAAM,WAAW,eAAe;IAC/B,IAAI,IAAI,IAAI,CAAA;CACZ;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAA;IAC1C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B,GAAG,eAAe,CA6ClB"}

package/dist/integrations/subagents/activity.d.ts

@@ -73,6 +73,37 @@ export interface SubagentActivity {
     /** Tool executions started so far, counted once per execution. */
     readonly toolCalls?: number;
     readonly description: string;
+    /**
+     * A short live label of what the agent is doing now (3-5 words), written by
+     * a periodic one-turn query on the agent's own context. Absent until the
+     * first one is accepted; the rail prefers it to `description` while the
+     * agent runs.
+     */
+    readonly summary?: string;
+    /**
+     * Messages sent to this running agent that it has not yet taken in: they
+     * are delivered at its next tool round, and the rail shows `N queued`
+     * until one completes. Absent when none are waiting.
+     */
+    readonly queued?: number;
+    /** Continued from its own transcript by a later message; it was launched earlier. */
+    readonly resumed?: boolean;
+    /** Launched with `run_in_background`: the rail drops it the moment it completes. */
+    readonly background?: boolean;
+    /**
+     * A launch the parent waited on whose wait ended before the agent did (the
+     * operator sent a message). It finishes on its own afterwards, so it
+     * reports when it ends the way a background agent does; one that finished
+     * inside the wait handed its result back to the parent inline and says
+     * nothing more.
+     */
+    readonly released?: boolean;
+    /**
+     * Who stopped it, when it ended as `cancelled`: the operator (rail, Esc,
+     * Ctrl+C), or the conversation's own agent (`cancel_agent`). Absent when
+     * nobody recorded it.
+     */
+    readonly stoppedBy?: 'user' | 'parent';
     readonly prompt: string;
     /** Direct tool batch that launched this concurrent sibling cohort. */
     readonly batchId: string;
@@ -194,6 +225,7 @@ export interface BeginSubagentInput {
     readonly agentId: string;
     readonly model?: string;
     readonly description: string;
+    readonly background?: boolean;
     readonly prompt: string;
     readonly batchId?: string;
     readonly toolUseId?: string;
@@ -326,7 +358,19 @@ export declare class SubagentActivityMonitor implements SubagentActivitySource {
      * matching record (already pruned, or never tracked) is a silent no-op:
      * there is no row left to explain what was sent.
      */
-    recordMessage(taskId: string, text: string, direction: SubagentMessageDirection): void;
+    recordMessage(taskId: string, text: string, direction: SubagentMessageDirection, kind?: 'queued' | 'started'): void;
+    /**
+     * Records who is stopping a running agent, so the line that closes it can
+     * say. The first answer stands; an agent that has ended is left alone.
+     */
+    markStopped(viewId: string, by: 'user' | 'parent'): void;
+    /** The parent's wait on this agent ended before it did; see {@link SubagentActivity.released}. */
+    markReleased(viewId: string): void;
+    /**
+     * Sets the live label of a running agent (see `activity-label.ts`). Ignored
+     * once the agent has ended, and for an unknown row.
+     */
+    setSummary(viewId: string, label: string): void;
     /**
      * Retains one line of PARENT-authored commentary for the rail to show.
      *

package/dist/integrations/subagents/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/activity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/activity.ts"],"names":[],"mappings":"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"}

package/dist/integrations/subagents/label-ledger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Where the tokens of a live-label request are counted.
+ *
+ * The label of a running agent (`activity-label.ts`) is one more provider
+ * request the turn causes, and the turn's token ledger is the account of what a
+ * turn spends. A request made outside it would be spend the person's limit
+ * never sees. The reference counts these requests with the rest of the session
+ * (its `agent_summary` calls go through the same cost tracker), so this does
+ * too, with the ledger's own public API and no addition to it:
+ *
+ * - a small allowance is reserved from the turn's root account for the one
+ *   request, as a child account bound to its own turn id, so it can run beside
+ *   the agents and the parent's own request;
+ * - the request is opened on that account and closed with the usage the
+ *   provider reported;
+ * - the account is settled either way, which hands what it did not spend back.
+ *
+ * It never blocks real work. A label is skipped when the turn's allowance is
+ * nearly gone or the root account is busy with a request of its own, and a
+ * request that fails is closed as spending nothing rather than as unknown
+ * spend, which would stop every later request of a limited turn.
+ */
+import { type SessionId, type SessionTokenBudget, type TokenUsage } from '@namzu/sdk';
+/** Most one label request may use from a limited turn. */
+export declare const LABEL_REQUEST_ALLOWANCE_TOKENS = 8000;
+/** What the request produced and what the provider said it cost. */
+export interface LabelRequestResult<T> {
+    readonly value: T;
+    readonly usage: TokenUsage;
+}
+/**
+ * Runs `request` against a reserved account of `budget`, and counts it.
+ *
+ * `estimatedPromptTokens` is what is charged when the request is cancelled
+ * after it was sent and no usage came back, the way the SDK charges a request
+ * the person cancelled. Resolves `undefined` when there was no room for it.
+ */
+export declare function chargeLabelRequest<T>(input: {
+    readonly budget: SessionTokenBudget;
+    readonly sessionId: SessionId;
+    readonly estimatedPromptTokens: number;
+    readonly signal: AbortSignal;
+    readonly request: () => Promise<LabelRequestResult<T>>;
+}): Promise<T | undefined>;
+//# sourceMappingURL=label-ledger.d.ts.map

package/dist/integrations/subagents/label-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-ledger.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/label-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACN,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAEf,MAAM,YAAY,CAAA;AAEnB,0DAA0D;AAC1D,eAAO,MAAM,8BAA8B,OAAQ,CAAA;AAUnD,oEAAoE;AACpE,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE;IAClD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAA;CACtD,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CA6CzB"}

package/dist/integrations/subagents/runtime.d.ts

@@ -50,6 +50,13 @@ export interface DelegatedModel {
     readonly effort?: ReasoningEffort;
 }
 export interface SubagentRuntimeOptions {
+    /**
+     * Tools every child gets beside its roster, whatever that roster was
+     * narrowed to. Set by the runtime itself, never by a host: a file's
+     * allowlist or the read-only roster must not take away the one way a child
+     * can say something to the conversation.
+     */
+    readonly childExtraTools?: () => readonly Toolset[];
     /** Resolve the actual invoking turn; reject calls whose parent no longer exists. */
     readonly resolveParent: (turnId: TurnId) => Promise<SubagentParent>;
     readonly cwd: string;
@@ -199,7 +206,22 @@ export interface SubagentMessageReceipt {
     readonly parentNotice: string;
     readonly auditWarning?: string;
 }
+/** A message a running child sent to the main conversation. */
+export interface SubagentMessage {
+    readonly parentSessionId: string;
+    readonly viewId: string;
+    readonly agentId: string;
+    readonly description: string;
+    readonly taskId?: string;
+    readonly text: string;
+}
 export interface SubagentRuntime {
+    /**
+     * Hear the messages running children send to the main conversation. A child
+     * has the tool to send one only while somebody listens, so a host that
+     * cannot show or deliver it never promises a child it will.
+     */
+    onChildMessage(listener: (message: SubagentMessage) => void): () => void;
     /** One immutable scheduler context per actual parent turn. */
     gatewayForTurn(turnId: TurnId): Promise<TaskScheduler>;
     /** The same inbox the parent query drains after a delegation yields. */
@@ -264,5 +286,5 @@ export interface SubagentRuntime {
  * Stand up the AgentManager + gateway + `Agent` tool. Returns the tool to
  * register on the parent and the gateway to pass to `query({ taskScheduler })`.
  */
-export declare function createSubagentRuntime(opts: SubagentRuntimeOptions): Promise<SubagentRuntime>;
+export declare function createSubagentRuntime(input: SubagentRuntimeOptions): Promise<SubagentRuntime>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/integrations/subagents/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/integrations/subagents/runtime.ts"],"names":[],"mappings":"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"}

package/dist/tui/AgentExplorer.d.ts

@@ -48,14 +48,15 @@ export declare const AGENT_RAIL_WINDOW = 5;
 /** How long a finished agent stays on the rail before it leaves. */
 export declare const AGENT_RAIL_FINISHED_LINGER_MS = 30000;
 /**
- * The agents the rail lists: everything running, plus whatever finished less
- * than {@link AGENT_RAIL_FINISHED_LINGER_MS} ago, oldest launch first.
+ * The agents the rail lists: everything running, plus a failed or stopped
+ * agent for {@link AGENT_RAIL_FINISHED_LINGER_MS} after it ended, oldest
+ * launch first. A background agent that completed is not listed at all.
  *
  * Saved children (`replayed`) never appear — they ended in another process,
  * and the rail says what is moving now; the cockpit still lists them. An
  * agent the operator already cleared with `x` stays off the rail.
  */
-export declare function railAgents(agents: readonly SubagentActivity[], now: number, dismissed?: ReadonlySet<string>): readonly SubagentActivity[];
+export declare function railAgents(agents: readonly SubagentActivity[], now: number, dismissed?: ReadonlySet<string>, pinned?: string | null): readonly SubagentActivity[];
 /**
  * Milliseconds until the next finished agent leaves the rail, or undefined
  * when none is waiting to leave. App sleeps exactly this long instead of
@@ -70,6 +71,8 @@ export declare function railActionFor(agent: SubagentActivity): 'stop' | 'clear'
  * started.
  */
 export declare function railStatusText(agent: SubagentActivity, now: number): string;
+/** `2 queued`: messages sent to the agent that it has not taken in yet. */
+export declare function railQueuedText(agent: SubagentActivity): string | undefined;
 /** What a workflow row shows about how the group ended; `running` until every member has settled. */
 export type RailWorkflowStatus = 'running' | 'completed' | 'failed' | 'stopped';
 /**
@@ -160,19 +163,29 @@ export interface AgentTaskPanelProps {
     /** Clock for tests; the panel otherwise ticks once a second. */
     readonly now?: number;
 }
+/** What an agent row says in its description column: what it is doing now, else what it was asked to do. */
+export declare function railDescription(agent: SubagentActivity): string;
 /**
- * The agents rail: a `main` row, then one row per running or recently
- * finished sub-agent, drawn under the footer line.
+ * The agents rail: a blank row, then a `main` row, one row per running or
+ * recently failed sub-agent, and one per workflow, drawn under the footer
+ * line.
  *
  * ```
+ *
  *   ● main
- *   ○ general-purpose  Mine the UI reference            12s · ↓ 3.2k tokens
+ *   ◯ count-words        Read(a.txt)                       12s · ↓ 3.2k tokens
+ *   ◯ release-audit      ▰▰▰▰▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱▱  1/4 · 35s · ↓ 12.5k tokens
  * ```
  *
- * `●` marks the transcript on screen, `○` the others; an agent's bullet turns
- * green or red only once it has finished. Not a modal: the composer stays
+ * The first cell of a row is the pointer slot and the bullet sits two cells in,
+ * directly under the first glyph of the mode line above (the rail reaches one
+ * cell into the app's margin to put it there), and rows stop two cells short
+ * of the right edge. `●` marks the transcript on screen, `◯` the others. No
+ * accent colour: the pointer and bullets take the row's own colour, and only a
+ * finished row's bullet turns green or red. Not a modal: the composer stays
  * mounted above and keeps taking input until the operator presses ↓ on an
- * empty composer to move into the rail.
+ * empty composer to move into the rail. The key line for the focused row is
+ * not drawn here; it takes the place of the mode line (see {@link railHint}).
  */
 export declare function AgentTaskPanel({ agents, workflows, terminalColumns, compact, selectedIndex, viewingId, now: nowOverride, }: AgentTaskPanelProps): import("react/jsx-runtime").JSX.Element;
 /**
@@ -182,8 +195,21 @@ export declare function AgentTaskPanel({ agents, workflows, terminalColumns, com
  * `main`; `compact` is the one-row form and always keeps it.
  */
 export declare function railShowsMain(agentCount: number, viewingId?: string | null, compact?: boolean): boolean;
-/** The key line shown under the rail while it has the keyboard. */
-export declare function railHint(selected: SubagentActivity | RailWorkflow | undefined, columns: number): string;
+/** The chord that stops every running agent from the rail. */
+export declare const RAIL_STOP_ALL_CHORD = "ctrl+x ctrl+k";
+/**
+ * The key line for the focused rail row. It takes the place of the footer's
+ * mode line while the rail has the keyboard (the rows stay where they are),
+ * and says only what the row can do:
+ *
+ * - an agent or workflow row: `Enter to view · x to stop` (`x to clear` once
+ *   it has finished), plus `ctrl+x ctrl+k to stop all agents` when more than
+ *   one agent runs and the line is at least 90 columns wide;
+ * - `main`, or nothing selected: `↑/↓ to select · Enter to view`.
+ *
+ * Esc leaves the rail but is not advertised here.
+ */
+export declare function railHint(selected: SubagentActivity | RailWorkflow | undefined, columns: number, runningAgents?: number, viewedId?: string): string;
 export type AgentCockpitFocus = 'workflows' | 'phases' | 'agents';
 export interface AgentWorkflow {
     readonly id: string;
@@ -246,7 +272,12 @@ export declare function phaseCount(phase: Pick<AgentPhase, 'agents'>): string;
  * a single group.
  */
 export declare function cockpitEntryFocus(workflow: AgentWorkflow): 'phases' | 'agents';
-/** Rows one list level can show; shared with the key handler so paging matches the screen. */
+/**
+ * Rows of list the detail dialog shows at once: 14 on a tall screen, fewer on
+ * a short one, never fewer than 4. The dialog is this many rows of list
+ * whether it holds two items or none, so it does not change height as agents
+ * come and go. Shared with the key handler so paging matches the screen.
+ */
 export declare function workflowDetailPageSize(terminalRows: number): number;
 interface WorkflowDetailProps {
     readonly workflow: AgentWorkflow;
@@ -259,9 +290,25 @@ interface WorkflowDetailProps {
     readonly now: number;
 }
 /**
- * The detail of one workflow, as the reference's dialog shows it: a header
- * with the workflow's name and totals, then ONE list at a time. Level 1 is
- * the phases, in order; level 2 is the agents of the selected phase.
+ * `↑ 1–8 of 14 ↓`: which rows of a longer list the box shows. An arrow is
+ * drawn on the side that has more, a space on the side that does not. Set in
+ * the box's bottom border, one per list (REA fns vt/Bo/Zt, chunk-t32eta2x.js).
+ */
+export declare function windowTag(window: {
+    readonly start: number;
+    readonly items: readonly unknown[];
+}, total: number): string;
+/**
+ * The detail of one workflow, as a frameless dialog: a rule across the top, the
+ * workflow's name, then its description on the left and `done/total agents ·
+ * elapsed` on the right, then the lists.
+ *
+ * From 64 columns the lists sit side by side in one box: the phases on the left
+ * (`✔`/`✘` or the phase's number, its title, `done/total`), and the agents of the
+ * selected phase on the right (status glyph, label, `model · tokens`, elapsed
+ * flush right). Level 1 puts the pointer on the phases, level 2 on the agents.
+ * Below 64 columns the same two lists are stacked: one at a time, the phases at
+ * level 1 and the selected phase's agents at level 2.
  */
 export declare function WorkflowDetail({ workflow, phases, selectedPhaseIndex, selectedAgentIndex, level, terminalRows, terminalColumns, now, }: WorkflowDetailProps): import("react/jsx-runtime").JSX.Element;
 export declare function agentCockpitIsWide(terminalColumns: number): boolean;
@@ -284,6 +331,27 @@ export interface AgentTranscriptProps {
 }
 /** Child screen; leave two parent footer rows and one terminal cursor row free. */
 export declare function AgentTranscript({ agent, tailOffset, terminalRows, terminalColumns, compact, navigationHint, escapeTo, }: AgentTranscriptProps): import("react/jsx-runtime").JSX.Element;
+/** Rows the viewed agent's transcript gets: what is left once the composer, footer line and rail are drawn. */
+export declare function agentViewPageRows(terminalRows: number, railRows: number): number;
+/** How far a viewed transcript can be scrolled back from its tail. */
+export declare function maxAgentViewTailOffset(agent: SubagentActivity, pageRows: number, terminalColumns: number): number;
+export interface AgentViewProps {
+    readonly agent: SubagentActivity;
+    /** Display rows skipped back from the live tail. */
+    readonly tailOffset: number;
+    readonly pageRows: number;
+    readonly terminalColumns: number;
+    /** One plain sentence about the last message that could not be sent. */
+    readonly notice?: string | undefined;
+}
+/**
+ * The transcript of the agent being viewed, drawn as part of the main screen:
+ * no box, no header, no tail counter. The agent's own prompt and what you sent
+ * it read as your rows (`❯`), what it said as `●`; its state is on the rail row
+ * below, and the one main composer under this stays live. Bottom-aligned, so the
+ * newest row sits against the composer.
+ */
+export declare function AgentView({ agent, tailOffset, pageRows, terminalColumns, notice, }: AgentViewProps): import("react/jsx-runtime").JSX.Element;
 export declare function agentPickerPageSize(terminalRows: number, _wide?: boolean): number;
 export declare function agentTranscriptPageSize(terminalRows: number, reservedRows?: number): number;
 export declare function maxAgentTranscriptTailOffset(agent: SubagentActivity, terminalRows: number, terminalColumns: number): number;