@agi-fans/dsh-tui 0.16.0 → 0.17.0

package/lib/session/subagent-tracker.js

@@ -0,0 +1,129 @@
+/**
+ * SubagentTracker — Session/SessionEvent stream -> published TuiSubagentRoster.
+ *
+ * Owns the live SubagentRoster, the epoch that fences the async catalog
+ * listing, and the snapshot-identity dedup that keeps unchanged rosters off
+ * the wire. The controller supplies Harness lookups (depth, agent status,
+ * session list, durable children) and owns where the snapshot lands.
+ */
+import { SubagentRoster } from "./subagent-roster.js";
+export class SubagentTracker {
+    #deps;
+    #roster = new SubagentRoster();
+    #published;
+    #epoch = 0;
+    constructor(deps) {
+        this.#deps = deps;
+    }
+    /** Whether the roster already tracks this session id. */
+    owns(id) {
+        return this.#roster.owns(id);
+    }
+    /** The current published snapshot, or undefined for an empty roster. */
+    snapshot() {
+        return this.#roster.snapshot();
+    }
+    /** Drop all tracked children and invalidate any in-flight catalog listing. */
+    reset() {
+        this.#epoch += 1;
+        this.#roster.reset();
+    }
+    /** Remember a freshly created session when it descends from the root. */
+    noteSession(session) {
+        const depth = this.#deps.depth(session);
+        if (depth === undefined)
+            return;
+        const parentId = session.header.parentSession;
+        this.#roster.remember({
+            id: session.id,
+            ...(parentId === undefined ? {} : { parentId }),
+            depth,
+            phase: this.#deps.agentStatus(session.id) === 'running' ? 'running' : 'starting',
+        });
+        this.#publish();
+    }
+    /** Fold one durable child event into its roster row. */
+    noteEvent(session, event) {
+        const depth = this.#deps.depth(session);
+        if (depth === undefined)
+            return;
+        this.#roster.apply(session, depth, event, this.#deps.agentStatus(session.id));
+        this.#publish();
+    }
+    /** Add the direct children a Session's durable catalog declares. */
+    observeCatalog(session, events) {
+        if (this.#roster.observeCatalog(session.id, events))
+            this.#publish();
+    }
+    /** Apply a live agent-status change, hydrating cold children on first sight. */
+    noteStatus(session, status) {
+        if (this.#roster.owns(session.id)) {
+            this.#roster.setAgentStatus(session.id, status);
+            this.#publish();
+            return;
+        }
+        const depth = this.#deps.depth(session);
+        if (depth === undefined)
+            return;
+        this.#roster.hydrate(session, depth, this.#deps.agentStatus(session.id) ?? status);
+        this.#publish();
+    }
+    /** Mark a disposed session gone so its running tools settle. */
+    noteGone(session) {
+        if (!this.#roster.owns(session.id))
+            return;
+        this.#roster.setAgentStatus(session.id, 'gone');
+        this.#publish();
+    }
+    /**
+     * Rebuild the roster around the active root: live sessions hydrate from
+     * their own events, then the durable catalog lists children that are not
+     * loaded. A stale listing is fenced by the epoch and a root re-check.
+     */
+    sync() {
+        const rootId = this.#deps.rootId();
+        const epoch = this.#epoch + 1;
+        this.#epoch = epoch;
+        if (rootId === undefined) {
+            this.#roster.reset();
+            this.#publish();
+            return;
+        }
+        this.#roster.reset(rootId);
+        for (const session of this.#deps.sessions()) {
+            const depth = this.#deps.depth(session);
+            if (depth === undefined)
+                continue;
+            this.#roster.hydrate(session, depth, this.#deps.agentStatus(session.id));
+        }
+        this.#publish();
+        const listed = this.#deps.listChildren(rootId);
+        if (listed === undefined)
+            return;
+        void listed.then((entries) => {
+            if (epoch !== this.#epoch || this.#deps.rootId() !== rootId)
+                return;
+            for (const entry of entries) {
+                if (entry.kind !== 'child')
+                    continue;
+                this.#roster.remember({
+                    id: entry.id,
+                    depth: 1,
+                    mode: entry.mode,
+                    ...(entry.label === undefined ? {} : { label: entry.label }),
+                    phase: entry.activity === 'running' ? 'running' : 'waiting',
+                });
+            }
+            this.#publish();
+        }, () => undefined);
+    }
+    /** Push the roster when its snapshot identity changed since the last push. */
+    #publish() {
+        const roster = this.#roster.snapshot();
+        if (roster === this.#published)
+            return;
+        this.#published = roster;
+        this.#deps.publish(roster);
+    }
+}
+//# sourceMappingURL=subagent-tracker.js.map

package/lib/session/subagent-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-tracker.js","sourceRoot":"","sources":["../../src/session/subagent-tracker.ts"],"names":[],"mappings":"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"}

package/lib/session/update-check.js

@@ -1,21 +1,8 @@
 /** Cached, transport-neutral npm update decision. */
-function numericVersion(version) {
-    const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(version);
-    if (match?.[1] === undefined || match[2] === undefined || match[3] === undefined)
-        return undefined;
-    return [Number(match[1]), Number(match[2]), Number(match[3])];
-}
+import { compareVersions } from "./version-compare.js";
 /** Whether a registry version is newer than the running package. */
 export function isNewerVersion(candidate, current) {
-    const left = numericVersion(candidate);
-    const right = numericVersion(current);
-    if (left === undefined || right === undefined)
-        return false;
-    for (let index = 0; index < left.length; index += 1) {
-        if ((left[index] ?? 0) !== (right[index] ?? 0))
-            return (left[index] ?? 0) > (right[index] ?? 0);
-    }
-    return false;
+    return compareVersions(candidate, current) > 0;
 }
 /** Resolve the latest version through a bounded cache and return only actionable updates. */
 export async function checkForUpdate(options) {

package/lib/session/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/session/update-check.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAOrD,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAClG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC3D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACjG,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAOpC;IACC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;IACxC,IAAI,aAAqB,CAAA;IACzB,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/E,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1F,CAAC"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../src/session/update-check.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAOtD,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;AAChD,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAOpC;IACC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;IACxC,IAAI,aAAqB,CAAA;IACzB,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/E,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAA;QAC3C,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1F,CAAC"}

package/lib/session/version-compare.d.ts

@@ -0,0 +1,3 @@
+/** Three-part numeric version comparison shared by update checks and release notes. */
+/** Compare two `major.minor.patch` versions; unparsable inputs compare equal. */
+export declare function compareVersions(left: string, right: string): number;

package/lib/session/version-compare.js

@@ -0,0 +1,21 @@
+/** Three-part numeric version comparison shared by update checks and release notes. */
+function versionParts(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/u.exec(version);
+    if (match?.[1] === undefined || match[2] === undefined || match[3] === undefined)
+        return undefined;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+/** Compare two `major.minor.patch` versions; unparsable inputs compare equal. */
+export function compareVersions(left, right) {
+    const a = versionParts(left);
+    const b = versionParts(right);
+    if (a === undefined || b === undefined)
+        return 0;
+    for (let index = 0; index < a.length; index += 1) {
+        const difference = (a[index] ?? 0) - (b[index] ?? 0);
+        if (difference !== 0)
+            return difference;
+    }
+    return 0;
+}
+//# sourceMappingURL=version-compare.js.map

package/lib/session/version-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.js","sourceRoot":"","sources":["../../src/session/version-compare.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAClG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAA;IAChD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QACpD,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,CAAA;IACzC,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC"}

package/lib/views/event-views.d.ts

@@ -1,118 +1,18 @@
 /**
- * Transcript state machine: SessionEvent -> display blocks, and the pure
- * view that composes blocks + status + input into a render frame.
-
- * applyEvent is the single writer of TranscriptState; renderView is the
- * single reader. windowTranscript clips the body the way OMP's ScrollView
- * does. Both are pure so the whole rendering pipeline is testable without
- * a terminal.
+ * Transcript fold: SessionEvent/StreamDelta -> TranscriptState.
+ *
+ * applyEvent is the single writer of TranscriptState; replayEvents folds an
+ * immutable log without repeatedly copying its growing block array. Both are
+ * pure so the whole fold is testable without a terminal. Rendering lives in
+ * transcript-render.ts; consumers keep importing this module, which re-exports
+ * both halves.
  * @module @agi-fans/dsh-tui
  */
-import type { StreamChunk, ToolCallId, UserMessage } from '@deepseek-ai/dsh-llm';
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
-import type { AutocompleteItem, SlashCommand } from './autocomplete.ts';
-import { type HistorySearchState } from './history-search.ts';
-import type { Frame, TranscriptScroll } from '../chrome/renderer.ts';
-import { type CopySelectorState } from './copy-selector.ts';
-import { type SettingsState } from './settings-list.ts';
-import { type TrajectoryState } from './trajectory.ts';
-import { type AgentHubState } from './agent-hub.ts';
-import { type PromptSelectorState } from './prompt-selector.ts';
-import { type StatusBarConfig, type StatusPreset } from '../chrome/status-config.ts';
-import { type Theme, type ThemeName } from '../chrome/theme.ts';
-import type { TuiInspectedSubagent, TuiLoopStatus, TuiRecentSession, TuiSessionControls, TuiSessionStats, TuiSubagentRoster, TuiSubmission } from '../definition.ts';
-import { type TuiToolPresentation } from '../chrome/tool-renderers.ts';
-import { type ToolInfo } from '../chrome/tools-list.ts';
-import type { WelcomeTip } from '../chrome/welcome-tips.ts';
-import type { MotionMode } from '../session/tui-settings.ts';
-type TodoItem = Extract<SessionEvent, {
-    type: 'todo/write';
-}>['data']['todos'][number];
-/** Display state of one tool invocation. */
-export type ToolBlockStatus = 'running' | 'ok' | 'error';
-/** One rendered block of the transcript. */
-export type Block = {
-    kind: 'user';
-    text: string;
-} | {
-    kind: 'assistant';
-    turn: number;
-    step: number;
-    text: string;
-    reasoning: string;
-    streaming: boolean;
-    interrupted?: boolean;
-} | {
-    kind: 'tool';
-    callId: ToolCallId;
-    name: string;
-    args: string;
-    status: ToolBlockStatus;
-    output: string;
-    partial?: boolean;
-    presentation?: TuiToolPresentation;
-} | {
-    kind: 'toolCatalog';
-    tools: readonly ToolInfo[];
-} | {
-    kind: 'commandOutput';
-    command: string;
-    text: string;
-} | {
-    kind: 'notice';
-    level: 'info' | 'warning' | 'error';
-    text: string;
-    framed?: boolean;
-};
-/** Live session activity controlling the composer and activity row. */
-export type SessionStatus = 'idle' | 'running' | 'compacting';
-/** Mutable-free transcript state produced by applyEvent. */
-export interface TranscriptState {
-    /** Ordered display blocks (user, assistant, tool). */
-    blocks: Block[];
-    /** Whole-agent liveness for the status line. */
-    status: SessionStatus;
-    /** The most recent turn number. */
-    turn: number;
-    /** Latest whole Todo projection emitted by the Harness for this turn. */
-    todos: TodoItem[];
-    /** Lifecycle id of a manual compact command currently owning the UI. */
-    compactCommandId: string | undefined;
-    /**
-     * Durable compaction in flight: its identity, the shadow price its summary
-     * reported, and the status to restore when it settles. Automatic compaction
-     * runs inside an open turn, so the restored status is usually `running`.
-     */
-    compaction: {
-        id: string;
-        events: number;
-        tokens: number;
-        resume: SessionStatus;
-    } | undefined;
-    /** Durable follow-up turns waiting in the Harness-owned agent inbox. */
-    nextTurnInbox: UserMessage[];
-    /** Durable steering/context waiting for a later step (kept for splice fidelity). */
-    nextStepInbox: UserMessage[];
-    /**
-     * Text of the turn that ended in failure, held until the next submission.
-     * The transcript keeps its own error notice, but that row scrolls away while
-     * the composer stays fixed, so a failed turn would otherwise leave an
-     * apparently idle screen behind.
-     */
-    turnError: string | undefined;
-}
-/** Empty starting state. */
-export declare function initialTranscript(): TranscriptState;
-/**
- * One live assistant stream delta: a chunk folded with the owning attempt's
- * turn/step (live frames carry neither durable seq nor turn/step; the bridge
- * records them from the attempt's start frame).
- */
-export interface StreamDelta {
-    readonly turn: number;
-    readonly step: number;
-    readonly chunk: StreamChunk;
-}
+import type { TuiToolPresentation } from '../chrome/tool-renderers.ts';
+import { type StreamDelta, type TranscriptState } from './transcript-types.ts';
+export * from './transcript-types.ts';
+export * from './transcript-render.ts';
 /**
  * Fold one live assistant stream chunk into the transcript state. Durable
  * settlement still arrives as `assistant/message` (or `assistant/attempt`
@@ -133,162 +33,3 @@ export declare function applyEvent(state: TranscriptState, event: SessionEvent,
  */
 export declare function replayEvents(events: readonly SessionEvent[], presentations?: ReadonlyMap<number, TuiToolPresentation>): TranscriptState;
 /** View options: terminal geometry and live input state. */
-export interface ViewOptions {
-    /** Terminal width in columns. */
-    width: number;
-    /** Terminal height in rows; the view keeps the frame inside it. */
-    height: number;
-    /** Model name for the fixed footer. */
-    model: string;
-    /** Effective reasoning effort for the selected model, including adapter defaults. */
-    reasoningEffort?: string;
-    /** Folded session title; rendered only when the footer's `session` item is enabled. */
-    sessionTitle?: string;
-    /** Current input buffer text. */
-    input: string;
-    /** Cursor column inside the input buffer (0-based, before the prefix). */
-    inputCursor: number;
-    /** Number of client-owned image drafts represented by input markers. */
-    inputImages?: number;
-    /** Composer submissions accepted while the active turn is still running. */
-    queuedSubmissions?: readonly TuiSubmission[];
-    /** Whether to emit color SGR sequences. */
-    colors: boolean;
-    /** Working directory shown in the footer. */
-    pwd?: string;
-    /** Git branch shown in the footer. */
-    branch?: string;
-    /** Product version painted on the welcome title. */
-    version?: string;
-    /** Product name painted on the welcome title. */
-    appName?: string;
-    /** Spinner phase while a turn or tool is running. */
-    spinnerFrame?: number;
-    /** Animation policy for streaming, activity marks, and the working label. */
-    motion?: MotionMode;
-    /** 24-bit color; defaults to off so tests stay deterministic. */
-    trueColor?: boolean;
-    /** Shipped palette; defaults to dark. */
-    themeName?: ThemeName;
-    /** Slash-command popup sitting under the editor. */
-    autocomplete?: {
-        items: readonly AutocompleteItem[];
-        selected: number;
-    };
-    /** Ctrl+R history-search overlay; replaces the editor while open. */
-    historySearch?: HistorySearchState;
-    /** `/settings` overlay; replaces the editor while open. */
-    settings?: SettingsState;
-    /** `/copy` picker overlay; replaces the editor while open. */
-    copySelector?: CopySelectorState;
-    /** `/trajectory` full-screen event ledger. */
-    trajectory?: TrajectoryState;
-    /** Keyboard-first full-screen descendant roster and inspector. */
-    agentHub?: AgentHubState;
-    /** Human-interaction selector; replaces the normal editor while active. */
-    promptSelector?: PromptSelectorState;
-    /** Effective local + agent-scoped slash command catalog. */
-    commands?: readonly SlashCommand[];
-    /** Durable rows shown in the welcome card. */
-    recentSessions?: readonly TuiRecentSession[];
-    /** Startup-stable sample of hints shown in the welcome card. */
-    welcomeTips?: readonly WelcomeTip[];
-    /** Whole-session figures rendered in the footer's telemetry row. */
-    sessionStats?: TuiSessionStats;
-    /** Harness-owned collaboration and permission state. Permission paints on the composer cap. */
-    sessionControls?: TuiSessionControls;
-    /** Process-local repeated-prompt state rendered beside model controls. */
-    loopStatus?: TuiLoopStatus;
-    /** Live descendant-subagent roster rendered above the composer. */
-    subagents?: TuiSubagentRoster;
-    /** Composer-boundary launcher focus entered with Down on an empty draft. */
-    subagentLauncherFocused?: boolean;
-    /** Descendant whose transcript is currently filling the viewport. */
-    inspected?: TuiInspectedSubagent;
-    /** Visible groups, order, and label style for the status line. */
-    statusBar?: StatusBarConfig;
-    /** Legacy status preset accepted while direct render callers migrate. */
-    statusPreset?: StatusPreset;
-    /**
-     * First transcript row to show (0 = top). Omit or pass +Infinity to pin
-     * the window to the latest lines — the OMP follow-tail default.
-     */
-    scrollStart?: number;
-    /** Open one transcript block at its first row instead of following the tail. */
-    focusBlock?: number;
-    /**
-     * Active transcript search. Matching block rows containing the query paint
-     * inverse; `matches` are block indexes in render order and `focus` selects
-     * the one the caller has scrolled to.
-     */
-    transcriptSearch?: {
-        query: string;
-        matches: readonly number[];
-        focus: number;
-        editing: boolean;
-    };
-    /**
-     * When true, tool blocks paint their full output (OMP `ctrl+o`). Default
-     * is the collapsed preview of {@link TOOL_COLLAPSED_LINES} rows.
-     */
-    toolsExpanded?: boolean;
-    /** Individual tool calls expanded by the user. */
-    expandedTools?: ReadonlySet<string>;
-}
-/** Collapsed tool-output preview height (OMP `DEFAULT_TERMINAL_PREVIEW_LINES`). */
-export declare const TOOL_COLLAPSED_LINES = 10;
-export declare const TOOL_INPUT_COLLAPSED_LINES = 3;
-/**
- * Render one transcript block to display lines. Pure; shared by the tty view
- * and the non-tty plain printer.
- * @param block - the block to render.
- * @param theme - active theme.
- * @param width - terminal width in columns.
- * @param spinnerFrame - activity spinner phase for running tools.
- * @param toolsExpanded - paint full tool output instead of the collapsed preview.
- * @returns display lines (already width-fitted).
- */
-export declare function blockLines(block: Block, theme: Theme, width: number, spinnerFrame?: number, toolsExpanded?: boolean): string[];
-/** Plain text of one block, used by transcript search and match painting. */
-export declare function blockSearchText(block: Block): string;
-/** Rows moved per Shift+Arrow (OMP ScrollView `fastScrollLines`). */
-export declare const TRANSCRIPT_FAST_SCROLL = 5;
-/**
- * Window `body` into `budget` rows with ↑/↓ overflow markers.
- * `start` is the first body row to keep; non-finite values pin to the tail.
- */
-export declare function windowTranscript(body: readonly string[], budget: number, start: number, theme: Theme): TranscriptScroll & {
-    lines: string[];
-};
-/** Maximum number of queued composer submissions kept visible above the editor. */
-export declare const QUEUED_SUBMISSION_PREVIEW = 3;
-/** Maximum number of Todo items kept visible above the composer. */
-export declare const TODO_PREVIEW = 5;
-/** Maximum number of descendant subagents kept visible above the composer. */
-export declare const SUBAGENT_PREVIEW = 5;
-/** Compact, unframed Todo tree placed above queued messages. */
-export declare function renderTodos(todos: readonly TodoItem[], theme: Theme, width: number): string[];
-/** Compact, unframed descendant-subagent tree placed above Todos. */
-export declare function renderSubagents(roster: TuiSubagentRoster | undefined, theme: Theme, width: number, spinnerFrame?: number, inspectedId?: string, launcherFocused?: boolean): string[];
-/** Persistent inspect chrome: stays visible while the child transcript scrolls. */
-export declare function renderInspectBanner(inspected: TuiInspectedSubagent | undefined, theme: Theme, width: number, spinnerFrame?: number): string[];
-/**
- * One fixed row above the composer for a turn that ended in failure.
- *
- * The transcript keeps its own error notice, but transcript rows scroll into
- * native history while the composer stays put: without this row a turn that
- * failed while the user was reading elsewhere leaves an apparently idle screen.
- * The row is bounded to a single line so it cannot squeeze the transcript.
- */
-export declare function renderTurnError(text: string, theme: Theme, width: number): string[];
-/** Compact, unframed pending-message view placed immediately above the composer. */
-export declare function renderQueuedSubmissions(submissions: readonly TuiSubmission[], theme: Theme, width: number, inbox?: readonly UserMessage[]): string[];
-/**
- * Compose the welcome card, transcript, working row, and rounded editor into
- * one frame — the oh-my-pi surface.
- * @param state - transcript state.
- * @param options - terminal geometry and input state.
- * @returns the frame to hand to a renderer.
- */
-export declare function renderView(state: TranscriptState, options: ViewOptions): Frame;
-export {};