agent-sh 0.12.25 → 0.12.27

package/dist/shell/tui-input-view.js

@@ -11,130 +11,171 @@ export class TuiInputView {
     cursorTermCol = 1;
     autocompleteLines = 0;
     surface;
+    frameBuf = null;
     constructor(surface) {
         this.surface = surface ?? new StdoutSurface();
     }
+    // Frame buffering: coalesces all emit() calls until endFrame() into one
+    // surface.write, bracketed by cursor hide/show so intermediate redraw
+    // states never flicker through.
+    beginFrame() {
+        if (this.frameBuf === null)
+            this.frameBuf = "\x1b[?25l";
+    }
+    endFrame() {
+        if (this.frameBuf === null)
+            return;
+        const out = this.frameBuf + "\x1b[?25h";
+        this.frameBuf = null;
+        this.surface.write(out);
+    }
+    emit(s) {
+        if (this.frameBuf !== null)
+            this.frameBuf += s;
+        else
+            this.surface.write(s);
+    }
+    autoFrame(fn) {
+        const owned = this.frameBuf === null;
+        if (owned)
+            this.beginFrame();
+        try {
+            return fn();
+        }
+        finally {
+            if (owned)
+                this.endFrame();
+        }
+    }
     resetCursor() {
         this.cursorRowsBelow = 0;
         this.cursorTermCol = 1;
     }
     enableModeKeys() {
         // Kitty progressive enhancement + bracket paste (Shift+Enter → \x1b[13;2u).
-        this.surface.write("\x1b[>1u\x1b[?2004h");
+        this.emit("\x1b[>1u\x1b[?2004h");
     }
     disableModeKeys() {
-        this.surface.write("\x1b[<u\x1b[?2004l");
+        this.emit("\x1b[<u\x1b[?2004l");
     }
     clearPromptArea() {
-        if (this.cursorRowsBelow > 0) {
-            this.surface.write(`\x1b[${this.cursorRowsBelow}A`);
-        }
-        this.surface.write("\r\x1b[J");
-        this.cursorRowsBelow = 0;
+        this.autoFrame(() => {
+            if (this.cursorRowsBelow > 0) {
+                this.emit(`\x1b[${this.cursorRowsBelow}A`);
+            }
+            this.emit("\r\x1b[J");
+            this.cursorRowsBelow = 0;
+        });
     }
     drawPrompt(vm) {
-        const termW = this.surface.columns;
-        if (this.cursorRowsBelow > 0) {
-            this.surface.write(`\x1b[${this.cursorRowsBelow}A`);
-        }
-        this.surface.write("\r\x1b[J");
-        const infoPrefix = vm.agentInfo.info
-            ? `${vm.agentInfo.info} ${p.success}${vm.indicator}${p.reset} `
-            : `${p.success}${vm.indicator}${p.reset} `;
-        const promptPrefix = infoPrefix + p.warning + p.bold + vm.promptIcon + " " + p.reset;
-        const promptVisLen = visibleLen(infoPrefix) + visibleLen(vm.promptIcon) + 1;
-        const display = vm.showBuffer ? vm.displayText : "";
-        const dCursor = vm.showBuffer ? vm.displayCursor : 0;
-        if (!vm.showBuffer) {
-            this.surface.write(promptPrefix);
-            const N = promptVisLen;
-            this.cursorRowsBelow = N > 0 ? Math.ceil(N / termW) - 1 : 0;
-            this.cursorTermCol = N === 0 ? 1 : (N % termW === 0 ? termW : (N % termW) + 1);
-        }
-        else if (!display.includes("\n")) {
-            // DECSC/DECRC bracket the after-cursor text so the cursor lands mid-line.
-            const before = display.slice(0, dCursor);
-            const after = display.slice(dCursor);
-            this.surface.write(promptPrefix + p.accent + before + p.reset +
-                "\x1b7" +
-                p.accent + after + p.reset +
-                "\x1b8");
-            const cursorVisCol = promptVisLen + visibleLen(before);
-            this.cursorRowsBelow = cursorVisCol > 0 ? Math.ceil(cursorVisCol / termW) - 1 : 0;
-            this.cursorTermCol = cursorVisCol === 0 ? 1 : (cursorVisCol % termW === 0 ? termW : (cursorVisCol % termW) + 1);
-        }
-        else {
-            const lines = display.split("\n");
-            const indent = " ".repeat(promptVisLen);
-            let charsRemaining = dCursor;
-            let cursorLine = 0;
-            for (let li = 0; li < lines.length; li++) {
-                if (charsRemaining <= lines[li].length) {
-                    cursorLine = li;
-                    break;
-                }
-                charsRemaining -= lines[li].length + 1;
-                cursorLine = li + 1;
+        this.autoFrame(() => {
+            const termW = this.surface.columns;
+            if (this.cursorRowsBelow > 0) {
+                this.emit(`\x1b[${this.cursorRowsBelow}A`);
             }
-            let output = "";
-            let cursorRowFromTop = 0;
-            let rowsSoFar = 0;
-            for (let li = 0; li < lines.length; li++) {
-                const prefix = li === 0 ? promptPrefix : indent;
-                const lineText = lines[li];
-                const lineVisLen = promptVisLen + visibleLen(lineText);
-                const lineTermRows = lineVisLen > 0 ? Math.ceil(lineVisLen / termW) : 1;
-                if (li === cursorLine) {
-                    const before = lineText.slice(0, charsRemaining);
-                    const after = lineText.slice(charsRemaining);
-                    output += prefix + p.accent + before + p.reset;
-                    output += "\x1b7";
-                    output += p.accent + after + p.reset;
-                    const beforeVisCol = promptVisLen + visibleLen(before);
-                    cursorRowFromTop = rowsSoFar + (beforeVisCol > 0 ? Math.ceil(beforeVisCol / termW) - 1 : 0);
-                    this.cursorTermCol = beforeVisCol === 0 ? 1 : (beforeVisCol % termW === 0 ? termW : (beforeVisCol % termW) + 1);
+            this.emit("\r\x1b[J");
+            const infoPrefix = vm.agentInfo.info
+                ? `${vm.agentInfo.info} ${p.success}${vm.indicator}${p.reset} `
+                : `${p.success}${vm.indicator}${p.reset} `;
+            const promptPrefix = infoPrefix + p.warning + p.bold + vm.promptIcon + " " + p.reset;
+            const promptVisLen = visibleLen(infoPrefix) + visibleLen(vm.promptIcon) + 1;
+            const display = vm.showBuffer ? vm.displayText : "";
+            const dCursor = vm.showBuffer ? vm.displayCursor : 0;
+            if (!vm.showBuffer) {
+                this.emit(promptPrefix);
+                const N = promptVisLen;
+                this.cursorRowsBelow = N > 0 ? Math.ceil(N / termW) - 1 : 0;
+                this.cursorTermCol = N === 0 ? 1 : (N % termW === 0 ? termW : (N % termW) + 1);
+            }
+            else if (!display.includes("\n")) {
+                // DECSC/DECRC bracket the after-cursor text so the cursor lands mid-line.
+                const before = display.slice(0, dCursor);
+                const after = display.slice(dCursor);
+                this.emit(promptPrefix + p.accent + before + p.reset +
+                    "\x1b7" +
+                    p.accent + after + p.reset +
+                    "\x1b8");
+                const cursorVisCol = promptVisLen + visibleLen(before);
+                this.cursorRowsBelow = cursorVisCol > 0 ? Math.ceil(cursorVisCol / termW) - 1 : 0;
+                this.cursorTermCol = cursorVisCol === 0 ? 1 : (cursorVisCol % termW === 0 ? termW : (cursorVisCol % termW) + 1);
+            }
+            else {
+                const lines = display.split("\n");
+                const indent = " ".repeat(promptVisLen);
+                let charsRemaining = dCursor;
+                let cursorLine = 0;
+                for (let li = 0; li < lines.length; li++) {
+                    if (charsRemaining <= lines[li].length) {
+                        cursorLine = li;
+                        break;
+                    }
+                    charsRemaining -= lines[li].length + 1;
+                    cursorLine = li + 1;
                 }
-                else {
-                    output += prefix + p.accent + lineText + p.reset;
+                let output = "";
+                let cursorRowFromTop = 0;
+                let rowsSoFar = 0;
+                for (let li = 0; li < lines.length; li++) {
+                    const prefix = li === 0 ? promptPrefix : indent;
+                    const lineText = lines[li];
+                    const lineVisLen = promptVisLen + visibleLen(lineText);
+                    const lineTermRows = lineVisLen > 0 ? Math.ceil(lineVisLen / termW) : 1;
+                    if (li === cursorLine) {
+                        const before = lineText.slice(0, charsRemaining);
+                        const after = lineText.slice(charsRemaining);
+                        output += prefix + p.accent + before + p.reset;
+                        output += "\x1b7";
+                        output += p.accent + after + p.reset;
+                        const beforeVisCol = promptVisLen + visibleLen(before);
+                        cursorRowFromTop = rowsSoFar + (beforeVisCol > 0 ? Math.ceil(beforeVisCol / termW) - 1 : 0);
+                        this.cursorTermCol = beforeVisCol === 0 ? 1 : (beforeVisCol % termW === 0 ? termW : (beforeVisCol % termW) + 1);
+                    }
+                    else {
+                        output += prefix + p.accent + lineText + p.reset;
+                    }
+                    if (li < lines.length - 1)
+                        output += "\n";
+                    rowsSoFar += lineTermRows;
                 }
-                if (li < lines.length - 1)
-                    output += "\n";
-                rowsSoFar += lineTermRows;
+                this.emit(output + "\x1b8");
+                this.cursorRowsBelow = cursorRowFromTop;
             }
-            this.surface.write(output + "\x1b8");
-            this.cursorRowsBelow = cursorRowFromTop;
-        }
+        });
     }
     drawAutocomplete(vm) {
         if (vm.items.length === 0)
             return;
-        const lines = [];
-        for (let i = 0; i < vm.items.length; i++) {
-            const item = vm.items[i];
-            const selected = i === vm.selected;
-            if (selected) {
-                lines.push(`  \x1b[7m ${p.accent}${item.name.padEnd(12)}${p.reset}\x1b[7m ${item.description} ${p.reset}`);
+        this.autoFrame(() => {
+            const lines = [];
+            for (let i = 0; i < vm.items.length; i++) {
+                const item = vm.items[i];
+                const selected = i === vm.selected;
+                if (selected) {
+                    lines.push(`  \x1b[7m ${p.accent}${item.name.padEnd(12)}${p.reset}\x1b[7m ${item.description} ${p.reset}`);
+                }
+                else {
+                    lines.push(`   ${p.muted}${item.name.padEnd(12)} ${item.description}${p.reset}`);
+                }
             }
-            else {
-                lines.push(`   ${p.muted}${item.name.padEnd(12)} ${item.description}${p.reset}`);
+            this.emit("\n" + lines.join("\n"));
+            this.autocompleteLines = lines.length;
+            if (this.autocompleteLines > 0) {
+                this.emit(`\x1b[${this.autocompleteLines}A`);
             }
-        }
-        this.surface.write("\n" + lines.join("\n"));
-        this.autocompleteLines = lines.length;
-        if (this.autocompleteLines > 0) {
-            this.surface.write(`\x1b[${this.autocompleteLines}A`);
-        }
-        // Absolute column set — preceding \n may have scrolled, invalidating DECSC.
-        this.surface.write(`\x1b[${this.cursorTermCol}G`);
+            // Absolute column set — preceding \n may have scrolled, invalidating DECSC.
+            this.emit(`\x1b[${this.cursorTermCol}G`);
+        });
     }
     clearAutocomplete() {
         if (this.autocompleteLines <= 0)
             return;
-        // CSI B (cursor down, bounded) so we don't scroll on the last row.
-        for (let i = 0; i < this.autocompleteLines; i++) {
-            this.surface.write("\x1b[B\x1b[2K");
-        }
-        this.surface.write(`\x1b[${this.autocompleteLines}A\x1b[${this.cursorTermCol}G`);
-        this.autocompleteLines = 0;
+        this.autoFrame(() => {
+            // CSI B (cursor down, bounded) so we don't scroll on the last row.
+            for (let i = 0; i < this.autocompleteLines; i++) {
+                this.emit("\x1b[B\x1b[2K");
+            }
+            this.emit(`\x1b[${this.autocompleteLines}A\x1b[${this.cursorTermCol}G`);
+            this.autocompleteLines = 0;
+        });
     }
 }

package/dist/utils/floating-panel.d.ts

@@ -147,7 +147,8 @@ export declare class FloatingPanel {
      *   - `{prefix}:render-border-bottom(ctx: FrameContext) -> string`
      *   - `{prefix}:composite-row(content: string, bgLine: string|null, boxLeft: number, boxW: number, cols: number) -> string`
      *   - `{prefix}:submit(query: string) -> void`
-     *   - `{prefix}:dismiss() -> void`
+     *   - `{prefix}:hide() -> void`    (screen down; conversation state preserved)
+     *   - `{prefix}:reset() -> void`   (conversation state cleared)
      *   - `{prefix}:show() -> void`
      *   - `{prefix}:input(data: string) -> boolean`
      *   - `{prefix}:build-row(content: string, width: number) -> string`
@@ -177,6 +178,9 @@ export declare class FloatingPanel {
     private wrapCacheWidth;
     private passthroughTimer;
     private prevSerialized;
+    private autocompleteItems;
+    private autocompleteIndex;
+    private autocompleteActive;
     constructor(bus: EventBus, config: FloatingPanelConfig, handlers?: HandlerRegistry);
     private registerDefaultHandlers;
     private wireEvents;
@@ -196,8 +200,10 @@ export declare class FloatingPanel {
     hide(): void;
     /** Show the panel again after hide(), preserving conversation. */
     show(): void;
-    /** Fully destroy the panel, resetting all state. */
-    dismiss(): void;
+    /** End the conversation: screen down and all buffered state cleared. */
+    reset(): void;
+    /** Screen-only teardown; conversation state is left untouched. */
+    private teardownToHidden;
     /** Common screen enter logic shared by open() and show(). */
     private enterScreen;
     appendText(text: string): void;
@@ -213,8 +219,14 @@ export declare class FloatingPanel {
     scrollDown(lines?: number): void;
     getInput(): string;
     requestRender(): void;
+    private updateAutocomplete;
+    private applyAutocomplete;
+    private clearAutocomplete;
     private handleIntercept;
-    /** Handle scroll input. Returns true if consumed. */
+    /**
+     * Handle scroll input. Returns true if consumed.
+     * Pass `includeArrows=false` in input phase so arrows reach the editor.
+     */
     private handleScroll;
     private handleInputKey;
     /** Compute box geometry from config + current viewport. */