deepclause-sdk 0.1.2 → 0.2.1

package/dist/repl/tui/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/picker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIrF,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,mBAAmB;IAWxC,wEAAwE;IACxE,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAO/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,UAAU,IAAI,IAAI;CAGnB"}

package/dist/repl/tui/picker.js

@@ -0,0 +1,43 @@
+/**
+ * A chooser overlay: a titled list the user picks from.
+ *
+ * Used for the model and the reasoning-display setting. It is a plain component so
+ * the host can place it with `tui.showOverlay`; `onSelect`/`onCancel` tell the host
+ * when to take it down. Keys are the list's own (up/down, enter, escape), which is
+ * what pi's pickers use, so nothing has to be re-taught.
+ */
+import { SelectList } from '@earendil-works/pi-tui';
+import { selectListTheme, tuiStyle } from './theme.js';
+export class ChoicePicker {
+    options;
+    list;
+    constructor(options) {
+        this.options = options;
+        this.list = new SelectList(options.items, 12, selectListTheme());
+        if (options.current) {
+            const index = options.items.findIndex((item) => item.value === options.current);
+            if (index >= 0)
+                this.list.setSelectedIndex(index);
+        }
+        this.list.onSelect = (item) => options.onSelect(item);
+        this.list.onCancel = () => options.onCancel();
+    }
+    /** The visible lines, so a host can size the overlay to its content. */
+    get contentHeight() {
+        return 2 + (this.options.hint ? 1 : 0) + Math.min(this.options.items.length, 12);
+    }
+    render(width) {
+        const out = [tuiStyle.title(this.options.title)];
+        if (this.options.hint)
+            out.push(tuiStyle.dim(this.options.hint));
+        out.push(...this.list.render(width));
+        return out;
+    }
+    handleInput(data) {
+        this.list.handleInput(data);
+    }
+    invalidate() {
+        this.list.invalidate();
+    }
+}
+//# sourceMappingURL=picker.js.map

package/dist/repl/tui/picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.js","sourceRoot":"","sources":["../../../src/repl/tui/picker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAmC,MAAM,wBAAwB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAcvD,MAAM,OAAO,YAAY;IACN,OAAO,CAAsB;IAC7B,IAAI,CAAa;IAElC,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YAChF,IAAI,KAAK,IAAI,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,wEAAwE;IACxE,IAAI,aAAa;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/repl/tui/renderer.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Component renderer for the fullscreen TUI.
+ *
+ * It implements the same surface as `ReplRenderer` so the CLI's dispatch code is
+ * unchanged, but it emits *components* where a component earns its keep:
+ *
+ * - a tool call becomes a `DmlToolPane` (collapsible, with its own status),
+ * - streamed assistant text becomes a live `Markdown` block, so prose renders as
+ *   it arrives instead of one line at a time,
+ * - the model-call indicator moves to the dock (`onWorking`), where a `Loader`
+ *   cannot be flushed away by unrelated output the way a transcript line could.
+ *
+ * Everything else is delegated to a `ReplRenderer` whose output is funnelled into
+ * the document, so the existing formatting — output, logs, errors, usage,
+ * compaction, solutions, user/steer blocks — is reused rather than reinvented.
+ */
+import type { DMLBinding, DMLEvent } from '../../types.js';
+import { type ReplRendererOptions } from '../render.js';
+import { TranscriptDocument } from './document.js';
+export interface TuiRendererOptions extends ReplRendererOptions {
+    document: TranscriptDocument;
+    /**
+     * Show or hide the working indicator. The dock owns the `Loader`; the renderer
+     * only reports the state, so the indicator does not depend on which event
+     * happened to arrive last.
+     */
+    onWorking?: (label: string | null) => void;
+}
+export declare class TuiRenderer {
+    /** Kept for parity with `ReplRenderer`; the TUI is always rich. */
+    readonly mode: "rich";
+    private readonly document;
+    private readonly text;
+    private readonly onWorking?;
+    /** Whether activity events (and therefore frame labels) are shown. */
+    private readonly showEvents;
+    /** Tool panes in order, so the last one can be expanded on demand. */
+    private readonly panes;
+    private currentPane?;
+    private stream?;
+    /** The live (unterminated) line written by the delegated renderer. */
+    private pending;
+    /**
+     * What was emitted last: a text block or a component.
+     *
+     * The line renderer already separates its own blocks, but it cannot see the
+     * components (panes, streamed markdown) that never pass through it — so text
+     * followed by a component, or the reverse, ran together. Any blank requested here
+     * collapses with one the line renderer adds, so this cannot double them.
+     */
+    private lastBlock;
+    constructor(options: TuiRendererOptions);
+    /** Keep unlike output apart: one blank line between a text block and a component. */
+    private separate;
+    /**
+     * Close any open streamed-text block.
+     *
+     * Called at a turn boundary by the host, which knows when a prompt was submitted
+     * even if the run that was streaming never reported `finished` (an interrupted
+     * turn, for instance).
+     */
+    endTextBlock(): void;
+    /** Expand or collapse the most recent tool pane (ctrl+o). */
+    toggleLastPane(): boolean;
+    render(event: DMLEvent): void;
+    private renderToolCall;
+    private newStreamBlock;
+    /** Finish the live block, so later text starts a new one. */
+    private endStream;
+    /**
+     * Feed the delegated renderer's output into the document, mirroring the line
+     * sink the readline path uses: `\r` replaces the live line, `\n` commits it, and
+     * `ESC[K`/`ESC[J` are dropped because the pending line already replaces it.
+     */
+    private writeDocumentText;
+    /**
+     * While the TUI is live everything goes through the document. The CLI calls
+     * this again on the way out (to "restore stdout" for the exit footer), and that
+     * is exactly when output should stop being a component and go to the terminal
+     * again — otherwise the footer is written into a viewport that has been torn
+     * down and the user never sees it.
+     */
+    setSink(sink?: (text: string) => void, errorSink?: (text: string) => void): void;
+    setImageSink(sink?: (lines: string[]) => void): void;
+    setSuppressInputPrompt(suppress: boolean): void;
+    setReasoningMode(mode: 'off' | 'summary' | 'full'): void;
+    getReasoningMode(): 'off' | 'summary' | 'full';
+    getWidth(): number;
+    setWidth(width: number): void;
+    writeLine(text?: string): void;
+    writeErrorLine(text: string): void;
+    listing(text: string): string;
+    image(lines: string[]): void;
+    solution(bindings: DMLBinding[], terminator?: string, prefix?: string, maxValue?: number): void;
+    flush(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/repl/tui/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA2CnD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5C;AAED,qBAAa,WAAW;IACtB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiC;IAC5D,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,sEAAsE;IACtE,OAAO,CAAC,OAAO,CAAM;IACrB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS,CAAyC;gBAE9C,OAAO,EAAE,kBAAkB;IAmBvC,qFAAqF;IACrF,OAAO,CAAC,QAAQ;IAOhB;;;;;;OAMG;IACH,YAAY,IAAI,IAAI;IAIpB,6DAA6D;IAC7D,cAAc,IAAI,OAAO;IAQzB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IA0C7B,OAAO,CAAC,cAAc;IA8BtB,OAAO,CAAC,cAAc;IAMtB,6DAA6D;IAC7D,OAAO,CAAC,SAAS;IAIjB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKhF,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,IAAI;IASpD,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAI/C,gBAAgB,CAAC,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAIxD,gBAAgB,IAAI,KAAK,GAAG,SAAS,GAAG,MAAM;IAI9C,QAAQ,IAAI,MAAM;IAIlB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,SAAS,CAAC,IAAI,SAAK,GAAG,IAAI;IAI1B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK7B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAK5B,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,SAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAK3F,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;CAGhB"}

package/dist/repl/tui/renderer.js

@@ -0,0 +1,289 @@
+/**
+ * Component renderer for the fullscreen TUI.
+ *
+ * It implements the same surface as `ReplRenderer` so the CLI's dispatch code is
+ * unchanged, but it emits *components* where a component earns its keep:
+ *
+ * - a tool call becomes a `DmlToolPane` (collapsible, with its own status),
+ * - streamed assistant text becomes a live `Markdown` block, so prose renders as
+ *   it arrives instead of one line at a time,
+ * - the model-call indicator moves to the dock (`onWorking`), where a `Loader`
+ *   cannot be flushed away by unrelated output the way a transcript line could.
+ *
+ * Everything else is delegated to a `ReplRenderer` whose output is funnelled into
+ * the document, so the existing formatting — output, logs, errors, usage,
+ * compaction, solutions, user/steer blocks — is reused rather than reinvented.
+ */
+import { Markdown } from '@earendil-works/pi-tui';
+import { framePrefix, ReplRenderer } from '../render.js';
+import { markdownTheme } from './theme.js';
+import { DmlToolPane } from './tool-pane.js';
+/** Events that produce no transcript output of their own. */
+const QUIET_EVENTS = new Set(['model_call', 'finished', 'meta_result', 'usage']);
+/** A markdown block whose text grows as the model streams. */
+class StreamingBlock {
+    buffer = '';
+    markdown;
+    /** The frame's indentation, so nested answers stay inside the tree. */
+    prefix;
+    constructor(prefix) {
+        this.prefix = prefix;
+        this.markdown = new Markdown('', 0, 0, markdownTheme());
+    }
+    setPrefix(prefix) {
+        this.prefix = prefix;
+    }
+    append(chunk) {
+        this.buffer += chunk;
+        this.markdown.setText(this.buffer);
+    }
+    get isEmpty() {
+        return this.buffer.trim() === '';
+    }
+    render(width) {
+        const lines = this.markdown.render(Math.max(1, width - this.prefix.length));
+        if (!this.prefix)
+            return lines;
+        return lines.map((line) => (line === '' ? line : `${this.prefix}${line}`));
+    }
+    invalidate() {
+        this.markdown.invalidate();
+    }
+}
+export class TuiRenderer {
+    /** Kept for parity with `ReplRenderer`; the TUI is always rich. */
+    mode = 'rich';
+    document;
+    text;
+    onWorking;
+    /** Whether activity events (and therefore frame labels) are shown. */
+    showEvents;
+    /** Tool panes in order, so the last one can be expanded on demand. */
+    panes = [];
+    currentPane;
+    stream;
+    /** The live (unterminated) line written by the delegated renderer. */
+    pending = '';
+    /**
+     * What was emitted last: a text block or a component.
+     *
+     * The line renderer already separates its own blocks, but it cannot see the
+     * components (panes, streamed markdown) that never pass through it — so text
+     * followed by a component, or the reverse, ran together. Any blank requested here
+     * collapses with one the line renderer adds, so this cannot double them.
+     */
+    lastBlock = 'none';
+    constructor(options) {
+        this.document = options.document;
+        this.onWorking = options.onWorking;
+        this.showEvents = options.events !== false;
+        this.text = new ReplRenderer({
+            mode: 'rich',
+            color: options.color,
+            verbose: options.verbose,
+            stream: options.stream,
+            events: options.events,
+            reasoning: options.reasoning,
+            markdown: options.markdown,
+        });
+        this.text.setSink((text) => this.writeDocumentText(text), (text) => this.writeDocumentText(text));
+    }
+    /** Keep unlike output apart: one blank line between a text block and a component. */
+    separate(kind) {
+        if (this.lastBlock !== 'none' && this.lastBlock !== kind) {
+            this.document.appendText('');
+        }
+        this.lastBlock = kind;
+    }
+    /**
+     * Close any open streamed-text block.
+     *
+     * Called at a turn boundary by the host, which knows when a prompt was submitted
+     * even if the run that was streaming never reported `finished` (an interrupted
+     * turn, for instance).
+     */
+    endTextBlock() {
+        this.endStream();
+    }
+    /** Expand or collapse the most recent tool pane (ctrl+o). */
+    toggleLastPane() {
+        const pane = this.panes[this.panes.length - 1];
+        if (!pane)
+            return false;
+        pane.toggle();
+        this.document.onChange?.();
+        return true;
+    }
+    render(event) {
+        switch (event.type) {
+            case 'tool_call':
+                this.renderToolCall(event);
+                return;
+            case 'model_call':
+                this.onWorking?.(event.modelCallState === 'started' ? 'working…' : null);
+                return;
+            case 'stream':
+                if (event.content) {
+                    if (!this.stream)
+                        this.separate('component');
+                    this.stream ??= this.newStreamBlock(framePrefix(event, this.showEvents));
+                    this.stream.append(event.content);
+                    this.document.onChange?.();
+                }
+                return;
+            case 'answer':
+            case 'error':
+                this.endStream();
+                // An aborted run may never report the model call as completed, so clear
+                // the dock spinner here or it animates forever after an interrupt.
+                this.onWorking?.(null);
+                this.separate('text');
+                this.text.render(event);
+                return;
+            case 'finished':
+                // A run ended. Without closing the block, the next turn's streamed text is
+                // appended to this one and renders *above* the prompt the user just typed,
+                // because the block sits earlier in the transcript.
+                if ((event.depth ?? 0) === 0) {
+                    this.endStream();
+                    this.onWorking?.(null);
+                }
+                return;
+            default:
+                // Events that render nothing must not add a separator, or switching models
+                // or finishing a turn would open a gap.
+                if (!QUIET_EVENTS.has(event.type))
+                    this.separate('text');
+                this.text.render(event);
+        }
+    }
+    renderToolCall(event) {
+        const name = event.toolName ?? 'tool';
+        const state = event.toolState ?? 'running';
+        const prefix = framePrefix(event, this.showEvents);
+        if (state === 'starting' || !this.currentPane) {
+            this.endStream();
+            this.separate('component');
+            this.currentPane = new DmlToolPane({ toolName: name, args: event.toolArgs ?? {}, prefix });
+            this.panes.push(this.currentPane);
+            this.document.appendComponent(this.currentPane);
+            this.onWorking?.(`${name}…`);
+        }
+        else {
+            // A `completed` event can carry the frame metadata the start event lacked.
+            this.currentPane.setPrefix(prefix);
+            if (event.toolArgs)
+                this.currentPane.setArgs(event.toolArgs);
+        }
+        if (state === 'completed' || state === 'failed') {
+            this.currentPane.setResult(event.toolResult ?? event.toolSummary ?? '', state === 'completed', event.toolDurationMs);
+            this.onWorking?.(null);
+            this.currentPane = undefined;
+            this.document.onChange?.();
+        }
+    }
+    newStreamBlock(prefix) {
+        const block = new StreamingBlock(prefix);
+        this.document.appendComponent(block);
+        return block;
+    }
+    /** Finish the live block, so later text starts a new one. */
+    endStream() {
+        this.stream = undefined;
+    }
+    /**
+     * Feed the delegated renderer's output into the document, mirroring the line
+     * sink the readline path uses: `\r` replaces the live line, `\n` commits it, and
+     * `ESC[K`/`ESC[J` are dropped because the pending line already replaces it.
+     */
+    writeDocumentText(chunk) {
+        let index = 0;
+        while (index < chunk.length) {
+            const char = chunk[index];
+            if (char === '\r') {
+                this.pending = '';
+                this.document.setPending('');
+                index += 1;
+                continue;
+            }
+            if (char === '\n') {
+                this.document.appendText(this.pending);
+                this.pending = '';
+                this.document.setPending('');
+                index += 1;
+                continue;
+            }
+            if (char === '\u001b' && chunk[index + 1] === '[') {
+                const match = /^\u001b\[[0-9;]*[JK]/.exec(chunk.slice(index));
+                if (match) {
+                    index += match[0].length;
+                    continue;
+                }
+            }
+            this.pending += char;
+            this.document.setPending(this.pending);
+            index += 1;
+        }
+    }
+    // ---- ReplRenderer-compatible surface ----
+    /**
+     * While the TUI is live everything goes through the document. The CLI calls
+     * this again on the way out (to "restore stdout" for the exit footer), and that
+     * is exactly when output should stop being a component and go to the terminal
+     * again — otherwise the footer is written into a viewport that has been torn
+     * down and the user never sees it.
+     */
+    setSink(sink, errorSink) {
+        if (!sink)
+            return;
+        this.text.setSink(sink, errorSink);
+    }
+    setImageSink(sink) {
+        this.text.setImageSink(sink
+            ? (lines) => {
+                this.endStream();
+                sink(lines);
+            }
+            : undefined);
+    }
+    setSuppressInputPrompt(suppress) {
+        this.text.setSuppressInputPrompt(suppress);
+    }
+    setReasoningMode(mode) {
+        this.text.setReasoningMode(mode);
+    }
+    getReasoningMode() {
+        return this.text.getReasoningMode();
+    }
+    getWidth() {
+        return this.text.getWidth();
+    }
+    setWidth(width) {
+        this.text.setWidth(width);
+    }
+    writeLine(text = '') {
+        this.text.writeLine(text);
+    }
+    writeErrorLine(text) {
+        this.text.writeErrorLine(text);
+    }
+    listing(text) {
+        this.endStream();
+        return this.text.listing(text);
+    }
+    image(lines) {
+        this.endStream();
+        this.text.image(lines);
+    }
+    solution(bindings, terminator, prefix = '', maxValue) {
+        this.endStream();
+        this.text.solution(bindings, terminator, prefix, maxValue);
+    }
+    flush() {
+        this.text.flush();
+    }
+    dispose() {
+        this.text.dispose();
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/repl/tui/renderer.js.map

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

package/dist/repl/tui/services-panel.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Live services panel: a dock row for the session's subagents.
+ *
+ * Renders nothing when hidden. When visible it always renders, so
+ * `/ps --watch` with no subagents says so instead of leaving a blank row.
+ *
+ * Two modes, toggled with `/ps --watch` and `/ps --watch --logs`:
+ *  - `summary` — one row per process with state, activity, queue and usage;
+ *  - `logs`    — the process list over a full-width rule, then a chronological
+ *                follow of each subagent's streamed output, reasoning, tool
+ *                calls and answers.
+ */
+import { type Component } from '@earendil-works/pi-tui';
+import type { ProcessInfo, ProcessLogEntry } from '../processes.js';
+export type ServicesPanelMode = 'summary' | 'logs';
+export interface ServicesPanelOptions {
+    getProcesses: () => ProcessInfo[];
+    getLog: () => ProcessLogEntry[];
+    isVisible: () => boolean;
+    mode: () => ServicesPanelMode;
+    /** Current harness version, to mark a process running older code. */
+    currentHarnessVersion?: () => string;
+    /** Rows of log shown in logs mode (default 16). */
+    maxLogLines?: number;
+}
+export declare class ServicesPanel implements Component {
+    private readonly options;
+    constructor(options: ServicesPanelOptions);
+    render(width: number): string[];
+    private renderSummary;
+    private renderLogs;
+    private formatLogLine;
+    invalidate(): void;
+}
+//# sourceMappingURL=services-panel.d.ts.map

package/dist/repl/tui/services-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services-panel.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/services-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAgB,MAAM,iBAAiB,CAAC;AAGlF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,WAAW,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,iBAAiB,CAAC;IAC9B,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC;IACrC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAwBD,qBAAa,aAAc,YAAW,SAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE1D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAW/B,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,aAAa;IAiBrB,UAAU,IAAI,IAAI;CAGnB"}

package/dist/repl/tui/services-panel.js

@@ -0,0 +1,108 @@
+/**
+ * Live services panel: a dock row for the session's subagents.
+ *
+ * Renders nothing when hidden. When visible it always renders, so
+ * `/ps --watch` with no subagents says so instead of leaving a blank row.
+ *
+ * Two modes, toggled with `/ps --watch` and `/ps --watch --logs`:
+ *  - `summary` — one row per process with state, activity, queue and usage;
+ *  - `logs`    — the process list over a full-width rule, then a chronological
+ *                follow of each subagent's streamed output, reasoning, tool
+ *                calls and answers.
+ */
+import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+import { dim, tuiStyle } from './theme.js';
+const ACTIVE = ['running', 'runnable', 'waiting', 'input'];
+const NAME_WIDTH = 12;
+function stateLabel(state) {
+    return state === 'input' ? 'input' : state;
+}
+function processSummaryLine(processes) {
+    if (processes.length === 0)
+        return 'nothing is running';
+    const active = processes.filter((process) => ACTIVE.includes(process.state)).length;
+    const attention = processes.some((process) => process.state === 'input');
+    const names = processes
+        .slice(0, 6)
+        .map((process) => `${process.name} ${stateLabel(process.state)}`)
+        .join(' · ');
+    const more = processes.length > 6 ? ` · +${processes.length - 6}` : '';
+    return `${processes.length} process${processes.length === 1 ? '' : 'es'}`
+        + `${active > 0 ? ` · ${active} active` : ''}`
+        + `${attention ? ' · needs input' : ''}`
+        + ` · ${names}${more}`;
+}
+export class ServicesPanel {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    render(width) {
+        if (!this.options.isVisible())
+            return [];
+        const columns = Math.max(1, width);
+        const rule = dim('─'.repeat(columns));
+        const processes = this.options.getProcesses();
+        const header = dim(`⚙ services — ${processSummaryLine(processes)}`);
+        if (this.options.mode() === 'logs')
+            return this.renderLogs(columns, processes, rule, header);
+        return [rule, header, ...this.renderSummary(columns, processes)];
+    }
+    renderSummary(columns, processes) {
+        if (processes.length === 0) {
+            return [dim('  /spawn <goal> to start a subagent')];
+        }
+        return processes.map((process) => {
+            const usage = process.usage.totalTokens > 0 ? ` · ${process.usage.totalTokens} tok` : '';
+            const activity = process.currentActivity ? ` · ${process.currentActivity}` : '';
+            const error = process.error ? ` (${process.error})` : '';
+            const mail = process.mailboxDepth > 0 ? ` · ${process.mailboxDepth} queued` : '';
+            const current = this.options.currentHarnessVersion?.();
+            const stale = current && process.harnessVersion && process.harnessVersion !== current;
+            const code = process.harnessVersion
+                ? ` · code ${process.harnessVersion.slice(0, 7)}${stale ? '*' : ''}`
+                : '';
+            const text = `  ${process.name}  ${stateLabel(process.state)}${error}${activity}${mail}${code}${usage}`;
+            const painted = ACTIVE.includes(process.state) ? text : dim(text);
+            return truncateToWidth(painted, columns, '…');
+        });
+    }
+    renderLogs(columns, processes, rule, header) {
+        const log = this.options.getLog();
+        if (processes.length === 0 && log.length === 0) {
+            return [rule, header, dim('  /spawn <goal> to start a subagent')];
+        }
+        const max = this.options.maxLogLines ?? 16;
+        const slice = log.slice(-max);
+        // Entries first (top-down), then pad to a stable height so the panel does
+        // not jump as output arrives.
+        const rows = [];
+        for (const entry of slice) {
+            rows.push(truncateToWidth(this.formatLogLine(entry), columns, '…'));
+        }
+        for (let i = slice.length; i < max; i += 1)
+            rows.push('');
+        // Rule above (separates from the transcript), process header, rule, log.
+        return [rule, header, rule, ...rows];
+    }
+    formatLogLine(entry) {
+        const raw = entry.name.length > NAME_WIDTH ? `${entry.name.slice(0, NAME_WIDTH - 1)}…` : entry.name;
+        const padding = ' '.repeat(Math.max(0, NAME_WIDTH - visibleWidth(raw)));
+        const label = dim(`${raw}${padding}`);
+        // A component line must not contain a newline: a multi-line answer/result
+        // would otherwise break the layout.
+        const body = entry.text.replace(/\s*\n\s*/g, ' ↵ ');
+        const prefix = entry.kind === 'reasoning' ? '~ ' : '';
+        const text = `${prefix}${body}`;
+        const styled = entry.kind === 'output' || entry.kind === 'stream'
+            ? text
+            : entry.kind === 'reasoning'
+                ? dim(text)
+                : tuiStyle.accent(text);
+        return `  ${label}  ${styled}`;
+    }
+    invalidate() {
+        // Stateless: reads the host on each render.
+    }
+}
+//# sourceMappingURL=services-panel.js.map

package/dist/repl/tui/services-panel.js.map

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

package/dist/repl/tui/status-bar.d.ts

@@ -1,8 +1,10 @@
 /**
  * Fixed status bar for the REPL TUI (pi-style footer).
  *
- * Two lines: workspace/session/backend, then token totals, context usage for
- * the active frame slot, and the current model (with reasoning level).
+ * One row: where the harness lives and what it is doing on the left, the model on
+ * the right, and the token/context counters in between. Anything that does not fit
+ * is dropped whole, in priority order (see `render`), so a narrow terminal loses
+ * detail instead of showing truncated fragments.
  */
 import { type Component } from '@earendil-works/pi-tui';
 import { type ReplStatusSnapshot } from '../status.js';
@@ -16,6 +18,8 @@ export interface StatusBarOptions {
     isFrozen?: () => boolean;
     /** True while a turn is running (so the user knows they can steer). */
     isRunning?: () => boolean;
+    /** Compact subagent status, e.g. `⚙ desk 2/3`; omitted when none run. */
+    processLabel?: () => string | undefined;
 }
 export declare class StatusBarComponent implements Component {
     private readonly options;

package/dist/repl/tui/status-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-bar.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/status-bar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,kBAAkB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B;AAmBD,qBAAa,kBAAmB,YAAW,SAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAEtD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAmB/B,UAAU,IAAI,IAAI;CAGnB"}
+{"version":3,"file":"status-bar.d.ts","sourceRoot":"","sources":["../../../src/repl/tui/status-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,kBAAkB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACzC;AA2DD,qBAAa,kBAAmB,YAAW,SAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAEtD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAiC/B,UAAU,IAAI,IAAI;CAGnB"}