actoviq-agent-sdk 0.4.12 → 0.4.13

package/dist/src/tui/pendingInput.d.ts

@@ -0,0 +1,17 @@
+export type ActiveInputMode = 'follow-up' | 'steer';
+export interface PendingInputPort {
+    followUp(input: string): void;
+    steer(input: string): void;
+    cancelLatestFollowUp(): string | undefined;
+}
+/** TUI policy adapter; the runtime queue remains owned by AgentSession. */
+export declare function submitActiveInput(port: PendingInputPort, input: string, mode: ActiveInputMode): void;
+/**
+ * Pull the newest queued follow-up into the editor for editing.
+ * Callers must restore it via {@link restoreAbandonedFollowUp} if the user
+ * clears the editor without resubmitting.
+ */
+export declare function recallLatestFollowUp(port: PendingInputPort): string | undefined;
+/** Re-queue a follow-up that was recalled into the editor but abandoned. */
+export declare function restoreAbandonedFollowUp(port: PendingInputPort, recalled: string | null | undefined): void;
+//# sourceMappingURL=pendingInput.d.ts.map

package/dist/src/tui/pendingInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingInput.d.ts","sourceRoot":"","sources":["../../../src/tui/pendingInput.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,GACpB,IAAI,CAGN;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAE/E;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,IAAI,CAIN"}

package/dist/src/tui/pendingInput.js

@@ -0,0 +1,23 @@
+/** TUI policy adapter; the runtime queue remains owned by AgentSession. */
+export function submitActiveInput(port, input, mode) {
+    if (mode === 'steer')
+        port.steer(input);
+    else
+        port.followUp(input);
+}
+/**
+ * Pull the newest queued follow-up into the editor for editing.
+ * Callers must restore it via {@link restoreAbandonedFollowUp} if the user
+ * clears the editor without resubmitting.
+ */
+export function recallLatestFollowUp(port) {
+    return port.cancelLatestFollowUp();
+}
+/** Re-queue a follow-up that was recalled into the editor but abandoned. */
+export function restoreAbandonedFollowUp(port, recalled) {
+    const text = recalled?.trim();
+    if (!text)
+        return;
+    port.followUp(text);
+}
+//# sourceMappingURL=pendingInput.js.map

package/dist/src/tui/pendingInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingInput.js","sourceRoot":"","sources":["../../../src/tui/pendingInput.ts"],"names":[],"mappings":"AAQA,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAC/B,IAAsB,EACtB,KAAa,EACb,IAAqB;IAErB,IAAI,IAAI,KAAK,OAAO;QAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;;QACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC;AACrC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB,CACtC,IAAsB,EACtB,QAAmC;IAEnC,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/src/tui/reasoningDisplay.d.ts

@@ -0,0 +1,13 @@
+/** Owns one reasoning segment independently from transport event boundaries. */
+export declare class ReasoningDisplayState {
+    private activeText;
+    private streamed;
+    get hasActive(): boolean;
+    get hasStreamedContent(): boolean;
+    append(delta: string): void;
+    setCompleteContent(text: string): void;
+    liveLines(width: number, maxRows?: number): string[];
+    complete(): string[];
+    reset(): void;
+}
+//# sourceMappingURL=reasoningDisplay.d.ts.map

package/dist/src/tui/reasoningDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningDisplay.d.ts","sourceRoot":"","sources":["../../../src/tui/reasoningDisplay.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,EAAE;IAU/C,QAAQ,IAAI,MAAM,EAAE;IAUpB,KAAK,IAAI,IAAI;CAId"}

package/dist/src/tui/reasoningDisplay.js

@@ -0,0 +1,45 @@
+import { A, wrapToWidth } from './ansi.js';
+/** Owns one reasoning segment independently from transport event boundaries. */
+export class ReasoningDisplayState {
+    activeText = '';
+    streamed = false;
+    get hasActive() {
+        return this.activeText.trim().length > 0;
+    }
+    get hasStreamedContent() {
+        return this.streamed;
+    }
+    append(delta) {
+        if (!delta)
+            return;
+        this.activeText += delta;
+        this.streamed = true;
+    }
+    setCompleteContent(text) {
+        if (!this.hasActive && text.trim())
+            this.activeText = text;
+    }
+    liveLines(width, maxRows = 6) {
+        const condensed = this.activeText.replace(/\s+/g, ' ').trim();
+        if (!condensed)
+            return [];
+        const contentWidth = Math.max(width - 4, 16);
+        const lines = wrapToWidth(condensed, contentWidth).map((line, index) => (`${A.dim}${index === 0 ? '∴ ' : '  '}${line}${A.reset}`));
+        return lines.slice(Math.max(lines.length - maxRows, 0));
+    }
+    complete() {
+        const condensed = this.activeText.replace(/\s+/g, ' ').trim();
+        if (!condensed)
+            return [];
+        const words = condensed.split(/\s+/u).length;
+        const detail = words > 1 ? `${words} words` : `${[...condensed].length} chars`;
+        this.activeText = '';
+        this.streamed = false;
+        return [`${A.dim}∴ Thinking · ${detail} · collapsed${A.reset}`];
+    }
+    reset() {
+        this.activeText = '';
+        this.streamed = false;
+    }
+}
+//# sourceMappingURL=reasoningDisplay.js.map

package/dist/src/tui/reasoningDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoningDisplay.js","sourceRoot":"","sources":["../../../src/tui/reasoningDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE3C,gFAAgF;AAChF,MAAM,OAAO,qBAAqB;IACxB,UAAU,GAAG,EAAE,CAAC;IAChB,QAAQ,GAAG,KAAK,CAAC;IAEzB,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,kBAAkB,CAAC,IAAY;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IAC7D,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,OAAO,GAAG,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CACtE,GAAG,CAAC,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CACxD,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ;QACN,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QAC7C,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,QAAQ,CAAC;QAC/E,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,gBAAgB,MAAM,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;CACF"}

package/dist/src/tui/screen.d.ts

@@ -5,10 +5,18 @@ export interface ScreenOutput {
     on?(event: 'resize', listener: () => void): unknown;
     off?(event: 'resize', listener: () => void): unknown;
 }
+export interface DynamicCursorPosition {
+    /** Zero-based source line passed to setDynamic. */
+    line: number;
+    /** Zero-based visible terminal column. */
+    column: number;
+}
 export declare class TuiScreen {
     private readonly out;
     private dynamicLines;
     private dynamicVisualCount;
+    private parkedRow;
+    private parkedColumn;
     private started;
     private readonly resizeListener;
     constructor(out: ScreenOutput);
@@ -20,9 +28,11 @@ export declare class TuiScreen {
     /** Print lines permanently into scrollback above the dynamic region. */
     appendStatic(lines: readonly string[]): void;
     /** Replace the dynamic bottom region. Lines are pre-wrapped to width. */
-    setDynamic(lines: readonly string[]): void;
+    setDynamic(lines: readonly string[], cursor?: DynamicCursorPosition): void;
     private redraw;
     private redrawChangedLines;
     private buildDynamicPaint;
+    private moveToTop;
+    private moveFromTopToParkedCursor;
 }
 //# sourceMappingURL=screen.d.ts.map

package/dist/src/tui/screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../src/tui/screen.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACpD,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACtD;AAED,qBAAa,SAAS;IAMR,OAAO,CAAC,QAAQ,CAAC,GAAG;IALhC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAEzB,GAAG,EAAE,YAAY;IAE9C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;IAOb,0EAA0E;IAC1E,IAAI,IAAI,IAAI;IASZ,wEAAwE;IACxE,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAc5C,yEAAyE;IACzE,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAmB1C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;CAa1B"}
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../src/tui/screen.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACpD,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,SAAS;IAQR,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAEzB,GAAG,EAAE,YAAY;IAE9C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;IAOb,0EAA0E;IAC1E,IAAI,IAAI,IAAI;IAWZ,wEAAwE;IACxE,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAa5C,yEAAyE;IACzE,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAyC1E,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,yBAAyB;CAMlC"}

package/dist/src/tui/screen.js

@@ -1,15 +1,10 @@
 /**
- * Scrollback-friendly renderer for the Hadamard TUI, mirroring Claude Code's
- * default REPL model (Ink <Static> + dynamic bottom region) without React:
+ * Scrollback-friendly renderer for the Hadamard TUI:
  *
- * - Transcript lines are printed permanently into the normal terminal
- *   scrollback (`appendStatic`).
- * - A bottom dynamic region (status line, prompt bar, menus, dialogs) is
- *   redrawn in place (`setDynamic`).
- *
- * The real terminal cursor stays hidden and parked at the top-left of the
- * dynamic region; the input caret is drawn as an inverse-video cell by the
- * caller. That single invariant keeps erase/redraw bookkeeping trivial.
+ * - Transcript lines are printed permanently into normal scrollback.
+ * - A bottom dynamic region is redrawn in place.
+ * - The hidden real cursor is parked at the input caret. Terminals and IMEs
+ *   use that position even while the TUI draws its own inverse-video caret.
  */
 import { wrapToWidth } from './ansi.js';
 const HIDE_CURSOR = '\x1b[?25l';
@@ -22,6 +17,8 @@ export class TuiScreen {
     out;
     dynamicLines = [];
     dynamicVisualCount = 0;
+    parkedRow = 0;
+    parkedColumn = 0;
     started = false;
     resizeListener = () => this.redraw();
     constructor(out) {
@@ -46,48 +43,69 @@ export class TuiScreen {
             return;
         this.started = false;
         this.out.off?.('resize', this.resizeListener);
-        this.out.write(CLEAR_DOWN + SHOW_CURSOR);
+        this.out.write(this.moveToTop() + CLEAR_DOWN + SHOW_CURSOR);
         this.dynamicLines = [];
         this.dynamicVisualCount = 0;
+        this.parkedRow = 0;
+        this.parkedColumn = 0;
     }
     /** Print lines permanently into scrollback above the dynamic region. */
     appendStatic(lines) {
         if (lines.length === 0)
             return;
         const wrapped = [];
-        for (const line of lines) {
+        for (const line of lines)
             wrapped.push(...wrapToWidth(line, this.width));
-        }
-        this.out.write(CLEAR_DOWN +
-            wrapped.join('\n') +
-            '\n' +
-            this.buildDynamicPaint());
+        this.out.write(this.moveToTop()
+            + CLEAR_DOWN
+            + wrapped.join('\n')
+            + '\n'
+            + this.buildDynamicPaint());
     }
     /** Replace the dynamic bottom region. Lines are pre-wrapped to width. */
-    setDynamic(lines) {
+    setDynamic(lines, cursor) {
         const wrapped = [];
-        for (const line of lines) {
-            wrapped.push(...wrapToWidth(line, this.width));
+        let cursorRow = 0;
+        let cursorColumn = 0;
+        for (let index = 0; index < lines.length; index += 1) {
+            const start = wrapped.length;
+            const parts = wrapToWidth(lines[index], this.width);
+            wrapped.push(...parts);
+            if (cursor && cursor.line === index) {
+                cursorRow = start + Math.floor(Math.max(cursor.column, 0) / this.width);
+                cursorColumn = Math.max(cursor.column, 0) % this.width;
+            }
         }
-        // Keep the region within the viewport so cursor-up math stays valid.
         const maxRows = this.height - 1;
-        const nextLines = wrapped.slice(0, maxRows);
-        if (sameLines(this.dynamicLines, nextLines))
+        const startRow = cursor && wrapped.length > maxRows
+            ? Math.min(Math.max(cursorRow - maxRows + 1, 0), wrapped.length - maxRows)
+            : 0;
+        const nextLines = wrapped.slice(startRow, startRow + maxRows);
+        const nextParkedRow = cursor
+            ? Math.max(0, Math.min(cursorRow - startRow, Math.max(nextLines.length - 1, 0)))
+            : 0;
+        const nextParkedColumn = cursor ? Math.min(cursorColumn, this.width - 1) : 0;
+        if (sameLines(this.dynamicLines, nextLines)
+            && this.parkedRow === nextParkedRow
+            && this.parkedColumn === nextParkedColumn)
             return;
         const previousLines = this.dynamicLines;
+        const previousParkedRow = this.parkedRow;
         this.dynamicLines = nextLines;
+        this.parkedRow = nextParkedRow;
+        this.parkedColumn = nextParkedColumn;
         if (previousLines.length === nextLines.length && nextLines.length > 0) {
-            this.redrawChangedLines(previousLines);
+            this.redrawChangedLines(previousLines, previousParkedRow);
         }
         else {
-            this.redraw();
+            this.redraw(previousParkedRow);
         }
     }
-    redraw() {
-        this.out.write(CLEAR_DOWN + this.buildDynamicPaint());
+    redraw(previousParkedRow = this.parkedRow) {
+        this.out.write(this.moveToTop(previousParkedRow) + CLEAR_DOWN + this.buildDynamicPaint());
     }
-    redrawChangedLines(previousLines) {
-        let output = SAVE_CURSOR;
+    redrawChangedLines(previousLines, previousParkedRow) {
+        let output = this.moveToTop(previousParkedRow) + SAVE_CURSOR;
         for (let index = 0; index < this.dynamicLines.length; index += 1) {
             if (previousLines[index] === this.dynamicLines[index])
                 continue;
@@ -96,7 +114,7 @@ export class TuiScreen {
                 output += `\x1b[${index}B`;
             output += `\r${this.dynamicLines[index]}${CLEAR_LINE_RIGHT}`;
         }
-        output += RESTORE_CURSOR;
+        output += RESTORE_CURSOR + this.moveFromTopToParkedCursor();
         this.out.write(output);
     }
     buildDynamicPaint() {
@@ -105,11 +123,23 @@ export class TuiScreen {
             return '';
         }
         this.dynamicVisualCount = this.dynamicLines.length;
-        // Park the cursor back at the start of the region (column 1, top row).
         let output = this.dynamicLines.join('\n') + '\r';
-        if (this.dynamicVisualCount > 1) {
-            output += `\x1b[${this.dynamicVisualCount - 1}A`;
-        }
+        const rowsUp = this.dynamicVisualCount - 1 - this.parkedRow;
+        if (rowsUp > 0)
+            output += `\x1b[${rowsUp}A`;
+        if (this.parkedColumn > 0)
+            output += `\x1b[${this.parkedColumn}C`;
+        return output;
+    }
+    moveToTop(row = this.parkedRow) {
+        return `\r${row > 0 ? `\x1b[${row}A` : ''}`;
+    }
+    moveFromTopToParkedCursor() {
+        let output = '\r';
+        if (this.parkedRow > 0)
+            output += `\x1b[${this.parkedRow}B`;
+        if (this.parkedColumn > 0)
+            output += `\x1b[${this.parkedColumn}C`;
         return output;
     }
 }

package/dist/src/tui/screen.js.map

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

package/dist/src/types.d.ts

@@ -151,6 +151,13 @@ export interface CreateToolOptions<Input = any, Output = any> {
     examples?: Array<Record<string, unknown>>;
     isReadOnly?: (input?: Input) => boolean;
     isDestructive?: (input?: Input) => boolean;
+    /**
+     * Plan-mode-only read-only classification (S1b §9.5): evaluated only in
+     * plan mode when the tool is otherwise unclassified — lets the Agent tool
+     * allow delegations to read-only subagents without changing default-mode
+     * behavior.
+     */
+    isPlanReadOnly?: (input?: Input) => boolean;
     requiresUserInteraction?: () => boolean;
     isConcurrencySafe?: () => boolean;
     checkPermissions?: (context: {
@@ -192,6 +199,13 @@ export interface AgentToolDefinition<Input = any, Output = any> {
     examples?: Array<Record<string, unknown>>;
     isReadOnly?: (input?: Input) => boolean;
     isDestructive?: (input?: Input) => boolean;
+    /**
+     * Plan-mode-only read-only classification (S1b §9.5): evaluated only in
+     * plan mode when the tool is otherwise unclassified — lets the Agent tool
+     * allow delegations to read-only subagents without changing default-mode
+     * behavior.
+     */
+    isPlanReadOnly?: (input?: Input) => boolean;
     requiresUserInteraction?: () => boolean;
     isConcurrencySafe?: () => boolean;
     checkPermissions?: (context: {
@@ -273,6 +287,8 @@ export interface ResolvedToolAdapter {
     execute: (input: unknown, context: ToolExecutionContext, onProgress?: ToolCallProgress) => Promise<ResolvedToolExecutionResult>;
     isReadOnly?: (input?: unknown) => boolean;
     isDestructive?: (input?: unknown) => boolean;
+    /** Plan-mode-only read-only classification (S1b §9.5). */
+    isPlanReadOnly?: (input?: unknown) => boolean;
     requiresUserInteraction?: () => boolean;
     isConcurrencySafe?: () => boolean;
     interruptBehavior?: 'cancel' | 'block';
@@ -405,8 +421,32 @@ export interface HadamardAgentDefinition {
     description: string;
     systemPrompt?: string;
     model?: string;
+    /** Referenced provider/bridge config name (unified store, S1a) — the definition runs on this config's own model client instead of inheriting the session's. */
+    bridgeConfig?: string;
+    /**
+     * Delegation runtime (09 Aug 2026): absent or 'hadamard' = in-process SDK;
+     * an external CLI runtime id ('claude' | 'pi' | 'codex' | …) routes Agent/Task
+     * delegations to that CLI via the bridge runner. Main-chat activation ignores
+     * this field (the main chat runtime comes from the active config).
+     */
+    runtime?: string;
+    /**
+     * Prompt composition (S1a): `extend` = built-in base prompt + body appended
+     * (profile semantics); `replace` = body is the complete system prompt
+     * (.md semantics). Definitions loaded from .md default to `replace`.
+     */
+    promptMode?: 'extend' | 'replace';
     effort?: HadamardRunEffort;
     permissionMode?: HadamardPermissionMode;
+    temperature?: number;
+    topP?: number;
+    maxTokens?: number;
+    /** Run timeout (ms) for runs under this definition. */
+    timeoutMs?: number;
+    /** `workspace` (default): project workspace only; `full`: unrestricted filesystem. */
+    workspaceAccess?: 'workspace' | 'full';
+    /** Whether the Agent/Task tool may delegate to this definition (default true). `false` = main-chat-only agent. */
+    subagent?: boolean;
     maxToolIterations?: number;
     maxTurns?: number;
     metadata?: Record<string, unknown>;
@@ -433,6 +473,10 @@ export interface HadamardAgentDefinitionSummary {
     name: string;
     description: string;
     model?: string;
+    /** Present when the definition pins a provider config (unified store). */
+    bridgeConfig?: string;
+    /** False = main-chat-only agent (not delegatable via the Agent/Task tool). */
+    subagent?: boolean;
     effort?: HadamardRunEffort;
     permissionMode?: HadamardPermissionMode;
     maxToolIterations?: number;
@@ -614,6 +658,27 @@ export interface HadamardInvokedSkillRecord {
     agent?: string;
     skillRoot?: string;
 }
+/** One-shot external-CLI delegation request (agent runtime routing, 09 Aug 2026). */
+export interface ExternalAgentRunRequest {
+    /** External runtime id (e.g. 'claude', 'codex'); never 'hadamard' here. */
+    runtime: string;
+    /** Definition name — used in error messages. */
+    agentName: string;
+    prompt: string;
+    systemPrompt?: string;
+    cwd: string;
+    signal?: AbortSignal;
+    model?: string;
+    /** Definition-pinned permission mode; the runner maps it to bridge semantics. */
+    permissionMode?: string;
+    homeDir?: string;
+}
+export interface ExternalAgentRunResult {
+    text: string;
+    sessionId?: string;
+    durationMs?: number;
+    numTurns?: number;
+}
 export interface CreateAgentSdkOptions {
     homeDir?: string;
     apiKey?: string;
@@ -646,6 +711,12 @@ export interface CreateAgentSdkOptions {
     agentDirectories?: string[];
     loadDefaultAgentDirectories?: boolean;
     disableDefaultAgents?: boolean;
+    /**
+     * Override the external-CLI delegation runner (definitions with
+     * `runtime` ≠ 'hadamard'). Defaults to the bridge runner in
+     * runtime/externalAgentRunner.ts; inject a stub in tests.
+     */
+    externalAgentRunner?: (request: ExternalAgentRunRequest) => Promise<ExternalAgentRunResult>;
     maxSubagentDepth?: number;
     maxSubagentFanout?: number;
     skills?: HadamardSkillDefinition[];
@@ -770,6 +841,12 @@ export interface AgentRunOptions {
     /** Override the model client for this run — used by the /model router for cross-provider routing. */
     modelApi?: CreateAgentSdkOptions['modelApi'];
     maxTokens?: number;
+    /** Per-run tool-iteration cap; overrides the SDK config cap for this run. */
+    maxToolIterations?: number;
+    /** Restrict the effective default/custom tool catalog to these names. */
+    allowedTools?: string[];
+    /** Apply Agent filesystem/process confinement for this run. */
+    workspaceAccess?: 'workspace' | 'full';
     temperature?: number;
     topP?: number;
     toolChoice?: ToolChoice;
@@ -2394,7 +2471,32 @@ export interface WorktreeInfo {
  * convergence (the `panel` capability). `panel` and `analysis` are retained as
  * backward-compatible aliases that route to the same engine.
  */
-export type ModelTeamMode = 'panel-analysis' | 'panel' | 'analysis' | 'reviewer' | 'executor-reviewer' | 'graph';
+export type ModelTeamMode = 'panel-analysis' | 'panel' | 'analysis' | 'reviewer' | 'executor-reviewer' | 'graph' | 'workflow';
+/**
+ * Unified typed reference to an execution target (reference model redesign).
+ * Schemas persist the reference, not a copied provider/baseURL/apiKey snapshot;
+ * runtime resolution expands a ref via `resolveTargetRef`
+ * (`src/manager/resolveTargetRef.ts`).
+ *
+ * There is deliberately no `router` kind: routers cannot be route/execution
+ * targets (nested classification chains and cycles are disallowed).
+ *
+ * For `{ kind: 'model' }`, an empty `config` string marks a "raw model ref":
+ * a legacy target whose originating bridge config is unknown — resolution then
+ * falls back to whatever legacy provider/baseURL/apiKey fields sit next to the
+ * ref (or to session defaults).
+ */
+export type AgentTargetRef = {
+    kind: 'model';
+    config: string;
+    model: string;
+} | {
+    kind: 'agent';
+    name: string;
+} | {
+    kind: 'team';
+    name: string;
+};
 /** A node in a workflow squad's execution tree. */
 export interface WorkflowNode {
     id: string;
@@ -2407,6 +2509,23 @@ export interface WorkflowNode {
     condition?: string;
     runtime?: string;
     model?: string;
+    /** Agent nodes: specialist system prompt (separate from the task `prompt`). */
+    systemPrompt?: string;
+    /** Agent nodes: core-tool whitelist. Absent → no tools (legacy workflow behavior). */
+    allowedTools?: string[];
+    /** Per-node run timeout (ms). Omit → squad default. */
+    timeoutMs?: number;
+    /** Per-node ReAct tool-iteration cap. Omit or ≤0 = unlimited. */
+    maxIterations?: number;
+    /** `workspace` (default): project workspace only; `full`: unrestricted filesystem. */
+    workspaceAccess?: 'workspace' | 'full';
+    /**
+     * Typed reference to this agent node's executor (saved agent profile, team,
+     * or config-scoped model). When present, runtime resolution prefers it over
+     * the legacy inline `model` field. Absent on legacy nodes — lazy migration
+     * only fills it when the target is clearly resolvable.
+     */
+    targetRef?: AgentTargetRef;
     /** Children: branch=[if,else], parallel=all, agent=[] or one sequential continuation. */
     children: WorkflowNode[];
 }
@@ -2440,6 +2559,14 @@ export interface TeamMember {
      * `full`: unrestricted filesystem access (same as the main agent).
      */
     workspaceAccess?: 'workspace' | 'full';
+    /**
+     * Typed reference to this member's execution target (saved agent profile or
+     * config-scoped model). Runtime resolution prefers it over the legacy
+     * by-value model fields when present.
+     */
+    targetRef?: AgentTargetRef;
+    /** Core-tool whitelist for this member. Absent → the squad's default toolset. */
+    allowedTools?: string[];
 }
 export interface TeamReviewEdge {
     /** Reviewer member id/name/role. */
@@ -2481,6 +2608,14 @@ export interface TeamGraphNode extends Omit<TeamMember, 'model'> {
     type?: 'react' | 'single' | 'team';
     /** When `type === 'team'`, name of the persisted team definition to invoke. */
     teamRef?: string;
+    /**
+     * Typed reference to this node's execution target. Lazy migration on load
+     * turns `type: 'team'` + `teamRef` into `{ kind: 'team', name: teamRef }`;
+     * nodes with only a raw `model` keep `targetRef` absent (the legacy by-value
+     * fields remain the fallback) since the originating config is not knowable.
+     * Runtime resolution prefers `targetRef` when present.
+     */
+    targetRef?: AgentTargetRef;
     /** Return ports only — `void` (return 0) or structured `payload`. */
     returnMode?: TeamGraphReturnMode;
     /** Return ports in `payload` mode — template for the structured return value. */
@@ -2594,9 +2729,10 @@ export interface TeamDefinition {
      * Squad kind — drives which editor the GUI shows. Absent → 'graph' (back-compat).
      * - `graph`: collaboration graph (Task → agents → Return), the existing editor.
      * - `workflow`: linear/tree work-flow node editor (Phase 3 — visual work tree).
-     * - `subagent`: a single configured agent (prompt + tools + workspace + runtime).
+     * - `agent`: a single configured agent (prompt + tools + workspace + runtime).
+     * - `subagent`: legacy alias of `agent` (still accepted when loading).
      */
-    squadType?: 'graph' | 'workflow' | 'subagent';
+    squadType?: 'graph' | 'workflow' | 'agent' | 'subagent';
     /** Workflow squad only: the execution tree. */
     workflowTree?: WorkflowNode;
     /** Panel members (panel-analysis / its `panel`+`analysis` aliases). */
@@ -2716,6 +2852,11 @@ export interface TeamAskOptions {
     context?: string;
     /** Working directory the team members operate over. */
     workDir?: string;
+    /** Hadamard data root input for personal Agents/configs/teams. */
+    homeDir?: string;
+    /** Caller model/client used by inherit-session-model Agent targets. */
+    model?: string;
+    modelApi?: ModelApi;
     /** Receives progress events as the team deliberates. */
     onEvent?: (event: TeamEvent) => void;
     /** Permission policy inherited by every member runtime. Defaults to `default`, never bypass. */
@@ -2730,6 +2871,8 @@ export interface TeamAskOptions {
      * appends its own ref before invoking the sub-team.
      */
     teamStack?: string[];
+    /** Maximum Graph/Workflow definitions allowed in one nested execution chain. Defaults to 16. */
+    maxTeamNestingDepth?: number;
 }
 export interface TeamResult {
     answer: string;
@@ -2772,6 +2915,10 @@ export interface GraphTeamResult extends TeamResult {
     /** Convergence loop rounds (v3 graphs with loop edges). */
     graphRounds?: number;
 }
+/** `workflow` mode result. It retains the common graph-era report/status shape for API compatibility. */
+export interface WorkflowTeamResult extends Omit<GraphTeamResult, 'mode'> {
+    mode: 'workflow';
+}
 /** @deprecated Runtime always returns {@link GraphTeamResult}. Kept for type compatibility. */
 export type ReviewerResult = GraphTeamResult & {
     report?: string;
@@ -2781,7 +2928,7 @@ export type ReviewerResult = GraphTeamResult & {
 export type AnalysisResult = GraphTeamResult & {
     rounds?: number;
 };
-export type ModelTeamResult = GraphTeamResult;
+export type ModelTeamResult = GraphTeamResult | WorkflowTeamResult;
 /** A model target: a model id plus optional per-target provider config. */
 export interface RouterModelRef {
     model: string;
@@ -2801,6 +2948,16 @@ export interface RouterRoute extends RouterModelRef {
     role?: string;
     /** Optional richer description of the specialist's strengths, for the leader to weigh. */
     description?: string;
+    /** Preferred effort for this route's run; omit to keep session/default effort. */
+    effort?: HadamardRunEffort;
+    /**
+     * Typed execution target for this route. Lazily migrated on load from the
+     * legacy by-value fields: a route whose role/name matches a saved agent
+     * profile becomes `{ kind: 'agent', name }`; a model-only route becomes
+     * `{ kind: 'model', config: '', model }` (empty config = raw legacy model
+     * ref). Saves always write `target` while keeping the legacy fields.
+     */
+    target?: AgentTargetRef;
 }
 /**
  * A router profile = a Leader/Dispatch configuration under `/model`. The
@@ -2814,10 +2971,18 @@ export interface RouterProfile {
     description?: string;
     /** The leader: classifies each turn and dispatches it to a specialist route. */
     routerModel: RouterModelRef;
+    /** Typed identity for the leader's model configuration. */
+    routerModelTarget?: AgentTargetRef;
     /** The specialist roster the leader dispatches among. */
     routes: RouterRoute[];
     /** Used when the leader matches no route. Defaults to the first route. */
     fallback?: RouterModelRef;
+    /**
+     * Typed fallback target (allows fallback to a saved agent). Lazily migrated
+     * on load from the legacy `fallback` model ref; `fallback` is kept as the
+     * legacy by-value copy for back-compat.
+     */
+    fallbackTarget?: AgentTargetRef;
     /** Optional custom leader/dispatch-prompt prefix. */
     classificationPrompt?: string;
 }
@@ -2831,6 +2996,8 @@ export interface RouterDecision {
     classification: string;
     /** Whether the classifier matched a configured route (vs fell back). */
     matched: boolean;
+    /** The matched route's preferred effort (routes only; fallback carries none). */
+    effort?: HadamardRunEffort;
 }
 export interface ModelPricing {
     input: number;