@bastani/atomic 0.9.9 → 0.9.10-alpha.1

package/dist/modes/interactive-engine/remote-component.js

@@ -0,0 +1,209 @@
+import { TerminalModeController } from "./terminal-mode-controller.js";
+import { RemoteFrameWidthClamp } from "./remote-frame-clamp.js";
+class RemoteComponent {
+    constructor(componentId, runtime, requestRender, getRows) {
+        this.wantsKeyRelease = true;
+        this.lines = ["Loading remote component…"];
+        this.width = 0;
+        this.requestId = 0;
+        this.appliedRequestId = 0;
+        this.dirty = true;
+        this.disposed = false;
+        this.frameClamp = new RemoteFrameWidthClamp();
+        this.componentId = componentId;
+        this.runtime = runtime;
+        this.requestRender = requestRender;
+        this.getRows = getRows;
+    }
+    render(width) {
+        if (!this.disposed && (this.dirty || width !== this.width)) {
+            this.width = width;
+            this.dirty = false;
+            this.runtime.sendEngineCommand({
+                type: "engine_custom_render",
+                componentId: this.componentId,
+                requestId: ++this.requestId,
+                width,
+                rows: this.getRows(),
+            });
+        }
+        // The engine child re-renders asynchronously; until the fresh frame
+        // arrives, the previous frame may be wrapped for an older terminal
+        // width. Clamp so a resize never replays overflowing lines (pi-tui
+        // crashes on any rendered line wider than the terminal).
+        return this.frameClamp.clamp(this.lines, width);
+    }
+    handleInput(data) {
+        if (this.disposed)
+            return;
+        this.runtime.sendEngineCommand({ type: "engine_custom_input", componentId: this.componentId, data });
+        // Engine commands are delivered in order, so a frame requested now is
+        // rendered by the child only AFTER it has applied this input. Pipelining
+        // the request keeps keypress latency at a single round trip and repaints
+        // components that never self-invalidate, instead of waiting for a
+        // child-side invalidate (or an unrelated refresh) to trigger a frame.
+        this.dirty = true;
+        this.requestRender();
+    }
+    invalidate() {
+        this.dirty = true;
+    }
+    applyFrame(requestId, lines) {
+        if (this.disposed || requestId < this.appliedRequestId)
+            return;
+        this.appliedRequestId = requestId;
+        this.lines = lines;
+        this.requestRender();
+    }
+    requestRemoteRender() {
+        if (this.disposed)
+            return;
+        this.dirty = true;
+        this.requestRender();
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.runtime.sendEngineCommand({ type: "engine_custom_dispose", componentId: this.componentId });
+    }
+}
+function overlayOptions(options) {
+    return options;
+}
+/**
+ * Resolve the real host terminal from the pi-tui TUI handed to the overlay
+ * factory. Optional: some hosts / test seams do not surface `tui.terminal`, in
+ * which case terminal-mode controls harmlessly no-op.
+ */
+function hostTerminal(tui) {
+    const terminal = tui.terminal;
+    return typeof terminal?.write === "function"
+        ? terminal
+        : { write: () => { } };
+}
+export class RemoteComponentController {
+    constructor(runtime, ui) {
+        this.mounted = new Map();
+        this.terminalModes = new TerminalModeController();
+        this.runtime = runtime;
+        this.ui = ui;
+        this.unsubscribe = runtime.onEngineMessage((message) => this.handleMessage(message));
+    }
+    dispose() {
+        this.unsubscribe();
+        this.terminalModes.resetAll();
+        for (const record of this.mounted.values()) {
+            if (record.widgetKey)
+                this.ui.setWidget(record.widgetKey, undefined);
+            record.component.dispose();
+        }
+        this.mounted.clear();
+    }
+    handleMessage(message) {
+        switch (message.type) {
+            case "engine_ready":
+                // A fresh engine generation replaced the child: any terminal modes
+                // the dead generation left on are stale. Reset them so a crashed or
+                // restarted overlay never strands the host TTY in mouse-reporting
+                // or autowrap-off mode; the new generation re-asserts on remount.
+                this.terminalModes.resetAll();
+                break;
+            case "engine_custom_open":
+                this.open(message.componentId, message.overlay, message.deferInlineCustomUiFocus, message.overlayOptions, message.widgetKey, message.widgetPlacement);
+                break;
+            case "engine_custom_close":
+                this.close(message.componentId);
+                break;
+            case "engine_custom_frame":
+                this.mounted.get(message.componentId)?.component.applyFrame(message.requestId, message.lines);
+                break;
+            case "engine_custom_invalidate":
+                this.mounted.get(message.componentId)?.component.requestRemoteRender();
+                break;
+            case "engine_custom_terminal":
+                this.terminalModes.applyControl(message.componentId, message.control);
+                break;
+            case "engine_custom_done": {
+                const record = this.mounted.get(message.componentId);
+                if (record) {
+                    record.engineDone = true;
+                    record.done(message.result);
+                }
+                break;
+            }
+            case "engine_custom_control":
+                this.control(message.componentId, message.action);
+                break;
+        }
+    }
+    open(componentId, overlay, deferInlineCustomUiFocus, options, widgetKey, widgetPlacement) {
+        if (this.mounted.has(componentId))
+            return;
+        if (widgetKey) {
+            let rows = 24;
+            const component = new RemoteComponent(componentId, this.runtime, () => this.ui.requestRender(), () => rows);
+            this.mounted.set(componentId, { component, done: () => { }, engineDone: false, widgetKey });
+            this.ui.setWidget(widgetKey, (tui) => {
+                rows = tui.terminal.rows;
+                return component;
+            }, { placement: widgetPlacement });
+            return;
+        }
+        let mounted;
+        void this.ui.custom((tui, _theme, _keybindings, done) => {
+            const component = new RemoteComponent(componentId, this.runtime, () => this.ui.requestRender(), () => tui.terminal.rows);
+            mounted = { component, done, engineDone: false };
+            this.mounted.set(componentId, mounted);
+            // Bind this component to the real host terminal so buffered/pending
+            // terminal-mode controls (e.g. mouse-scroll reporting the overlay
+            // enabled before the mount frame) apply to the host TTY.
+            this.terminalModes.onMount(componentId, hostTerminal(tui));
+            return component;
+        }, {
+            overlay,
+            deferInlineCustomUiFocus,
+            overlayOptions: overlayOptions(options),
+            onHandle: (handle) => { if (mounted)
+                mounted.handle = handle; },
+        }).catch(() => undefined).finally(() => {
+            this.terminalModes.onUnmount(componentId);
+            const record = this.mounted.get(componentId);
+            if (!record)
+                return;
+            this.mounted.delete(componentId);
+            if (!record.engineDone)
+                record.component.dispose();
+        });
+    }
+    close(componentId) {
+        const record = this.mounted.get(componentId);
+        if (!record)
+            return;
+        this.terminalModes.onUnmount(componentId);
+        this.mounted.delete(componentId);
+        if (record.widgetKey)
+            this.ui.setWidget(record.widgetKey, undefined);
+        record.component.dispose();
+    }
+    control(componentId, action) {
+        const handle = this.mounted.get(componentId)?.handle;
+        if (!handle)
+            return;
+        switch (action) {
+            case "focus":
+                handle.focus();
+                break;
+            case "hide":
+                handle.setHidden(true);
+                break;
+            case "show":
+                handle.setHidden(false);
+                break;
+            case "unfocus":
+                handle.unfocus();
+                break;
+        }
+    }
+}
+//# sourceMappingURL=remote-component.js.map

package/dist/modes/interactive-engine/remote-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-component.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-component.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Component, OverlayHandle, OverlayOptions, TUI } from \"@earendil-works/pi-tui\";\nimport type { ExtensionUIContext } from \"../../core/extensions/index.ts\";\nimport type { IsolatedInteractiveRuntime } from \"./isolated-runtime.ts\";\nimport type { InteractiveEngineMessage, JsonValue, SerializableOverlayOptions } from \"./protocol.ts\";\nimport { TerminalModeController } from \"./terminal-mode-controller.ts\";\nimport { RemoteFrameWidthClamp } from \"./remote-frame-clamp.ts\";\n\ninterface MountedRemoteComponent {\n\tcomponent: RemoteComponent;\n\tdone: (result: JsonValue | undefined) => void;\n\tengineDone: boolean;\n\thandle?: OverlayHandle;\n\twidgetKey?: string;\n}\n\nclass RemoteComponent implements Component {\n\twantsKeyRelease = true;\n\tprivate lines = [\"Loading remote component…\"];\n\tprivate width = 0;\n\tprivate requestId = 0;\n\tprivate appliedRequestId = 0;\n\tprivate dirty = true;\n\tprivate disposed = false;\n\tprivate readonly frameClamp = new RemoteFrameWidthClamp();\n\n\tprivate readonly componentId: string;\n\tprivate readonly runtime: IsolatedInteractiveRuntime;\n\tprivate readonly requestRender: () => void;\n\tprivate readonly getRows: () => number;\n\n\tconstructor(\n\t\tcomponentId: string,\n\t\truntime: IsolatedInteractiveRuntime,\n\t\trequestRender: () => void,\n\t\tgetRows: () => number,\n\t) {\n\t\tthis.componentId = componentId;\n\t\tthis.runtime = runtime;\n\t\tthis.requestRender = requestRender;\n\t\tthis.getRows = getRows;\n\t}\n\n\trender(width: number): string[] {\n\t\tif (!this.disposed && (this.dirty || width !== this.width)) {\n\t\t\tthis.width = width;\n\t\t\tthis.dirty = false;\n\t\t\tthis.runtime.sendEngineCommand({\n\t\t\t\ttype: \"engine_custom_render\",\n\t\t\t\tcomponentId: this.componentId,\n\t\t\t\trequestId: ++this.requestId,\n\t\t\t\twidth,\n\t\t\t\trows: this.getRows(),\n\t\t\t});\n\t\t}\n\t\t// The engine child re-renders asynchronously; until the fresh frame\n\t\t// arrives, the previous frame may be wrapped for an older terminal\n\t\t// width. Clamp so a resize never replays overflowing lines (pi-tui\n\t\t// crashes on any rendered line wider than the terminal).\n\t\treturn this.frameClamp.clamp(this.lines, width);\n\t}\n\n\thandleInput(data: string): void {\n\t\tif (this.disposed) return;\n\t\tthis.runtime.sendEngineCommand({ type: \"engine_custom_input\", componentId: this.componentId, data });\n\t\t// Engine commands are delivered in order, so a frame requested now is\n\t\t// rendered by the child only AFTER it has applied this input. Pipelining\n\t\t// the request keeps keypress latency at a single round trip and repaints\n\t\t// components that never self-invalidate, instead of waiting for a\n\t\t// child-side invalidate (or an unrelated refresh) to trigger a frame.\n\t\tthis.dirty = true;\n\t\tthis.requestRender();\n\t}\n\n\tinvalidate(): void {\n\t\tthis.dirty = true;\n\t}\n\n\tapplyFrame(requestId: number, lines: string[]): void {\n\t\tif (this.disposed || requestId < this.appliedRequestId) return;\n\t\tthis.appliedRequestId = requestId;\n\t\tthis.lines = lines;\n\t\tthis.requestRender();\n\t}\n\n\trequestRemoteRender(): void {\n\t\tif (this.disposed) return;\n\t\tthis.dirty = true;\n\t\tthis.requestRender();\n\t}\n\n\tdispose(): void {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.runtime.sendEngineCommand({ type: \"engine_custom_dispose\", componentId: this.componentId });\n\t}\n}\n\nfunction overlayOptions(options: SerializableOverlayOptions | undefined): OverlayOptions | undefined {\n\treturn options as OverlayOptions | undefined;\n}\n\n/**\n * Resolve the real host terminal from the pi-tui TUI handed to the overlay\n * factory. Optional: some hosts / test seams do not surface `tui.terminal`, in\n * which case terminal-mode controls harmlessly no-op.\n */\nfunction hostTerminal(tui: TUI): { write(data: string): void } {\n\tconst terminal = (tui as { terminal?: { write?(data: string): void } }).terminal;\n\treturn typeof terminal?.write === \"function\"\n\t\t? (terminal as { write(data: string): void })\n\t\t: { write: () => {} };\n}\n\nexport class RemoteComponentController {\n\tprivate readonly mounted = new Map<string, MountedRemoteComponent>();\n\tprivate readonly unsubscribe: () => void;\n\tprivate readonly terminalModes = new TerminalModeController();\n\n\tprivate readonly runtime: IsolatedInteractiveRuntime;\n\tprivate readonly ui: ExtensionUIContext;\n\n\tconstructor(\n\t\truntime: IsolatedInteractiveRuntime,\n\t\tui: ExtensionUIContext,\n\t) {\n\t\tthis.runtime = runtime;\n\t\tthis.ui = ui;\n\t\tthis.unsubscribe = runtime.onEngineMessage((message) => this.handleMessage(message));\n\t}\n\n\tdispose(): void {\n\t\tthis.unsubscribe();\n\t\tthis.terminalModes.resetAll();\n\t\tfor (const record of this.mounted.values()) {\n\t\t\tif (record.widgetKey) this.ui.setWidget(record.widgetKey, undefined);\n\t\t\trecord.component.dispose();\n\t\t}\n\t\tthis.mounted.clear();\n\t}\n\n\tprivate handleMessage(message: InteractiveEngineMessage): void {\n\t\tswitch (message.type) {\n\t\t\tcase \"engine_ready\":\n\t\t\t\t// A fresh engine generation replaced the child: any terminal modes\n\t\t\t\t// the dead generation left on are stale. Reset them so a crashed or\n\t\t\t\t// restarted overlay never strands the host TTY in mouse-reporting\n\t\t\t\t// or autowrap-off mode; the new generation re-asserts on remount.\n\t\t\t\tthis.terminalModes.resetAll();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_open\":\n\t\t\t\tthis.open(message.componentId, message.overlay, message.deferInlineCustomUiFocus, message.overlayOptions, message.widgetKey, message.widgetPlacement);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_close\":\n\t\t\t\tthis.close(message.componentId);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_frame\":\n\t\t\t\tthis.mounted.get(message.componentId)?.component.applyFrame(message.requestId, message.lines);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_invalidate\":\n\t\t\t\tthis.mounted.get(message.componentId)?.component.requestRemoteRender();\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_terminal\":\n\t\t\t\tthis.terminalModes.applyControl(message.componentId, message.control);\n\t\t\t\tbreak;\n\t\t\tcase \"engine_custom_done\": {\n\t\t\t\tconst record = this.mounted.get(message.componentId);\n\t\t\t\tif (record) {\n\t\t\t\t\trecord.engineDone = true;\n\t\t\t\t\trecord.done(message.result);\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"engine_custom_control\":\n\t\t\t\tthis.control(message.componentId, message.action);\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\tprivate open(\n\t\tcomponentId: string,\n\t\toverlay: boolean,\n\t\tdeferInlineCustomUiFocus: boolean | undefined,\n\t\toptions: SerializableOverlayOptions | undefined,\n\t\twidgetKey?: string,\n\t\twidgetPlacement?: \"aboveEditor\" | \"belowEditor\",\n\t): void {\n\t\tif (this.mounted.has(componentId)) return;\n\t\tif (widgetKey) {\n\t\t\tlet rows = 24;\n\t\t\tconst component = new RemoteComponent(componentId, this.runtime, () => this.ui.requestRender(), () => rows);\n\t\t\tthis.mounted.set(componentId, { component, done: () => {}, engineDone: false, widgetKey });\n\t\t\tthis.ui.setWidget(widgetKey, (tui) => {\n\t\t\t\trows = tui.terminal.rows;\n\t\t\t\treturn component;\n\t\t\t}, { placement: widgetPlacement });\n\t\t\treturn;\n\t\t}\n\t\tlet mounted: MountedRemoteComponent | undefined;\n\t\tvoid this.ui.custom<JsonValue | undefined>(\n\t\t\t(tui, _theme, _keybindings, done) => {\n\t\t\t\tconst component = new RemoteComponent(\n\t\t\t\t\tcomponentId, this.runtime, () => this.ui.requestRender(), () => tui.terminal.rows,\n\t\t\t\t);\n\t\t\t\tmounted = { component, done, engineDone: false };\n\t\t\t\tthis.mounted.set(componentId, mounted);\n\t\t\t\t// Bind this component to the real host terminal so buffered/pending\n\t\t\t\t// terminal-mode controls (e.g. mouse-scroll reporting the overlay\n\t\t\t\t// enabled before the mount frame) apply to the host TTY.\n\t\t\t\tthis.terminalModes.onMount(componentId, hostTerminal(tui));\n\t\t\t\treturn component;\n\t\t\t},\n\t\t\t{\n\t\t\t\toverlay,\n\t\t\t\tdeferInlineCustomUiFocus,\n\t\t\t\toverlayOptions: overlayOptions(options),\n\t\t\t\tonHandle: (handle) => { if (mounted) mounted.handle = handle; },\n\t\t\t},\n\t\t).catch(() => undefined).finally(() => {\n\t\t\tthis.terminalModes.onUnmount(componentId);\n\t\t\tconst record = this.mounted.get(componentId);\n\t\t\tif (!record) return;\n\t\t\tthis.mounted.delete(componentId);\n\t\t\tif (!record.engineDone) record.component.dispose();\n\t\t});\n\t}\n\n\tprivate close(componentId: string): void {\n\t\tconst record = this.mounted.get(componentId);\n\t\tif (!record) return;\n\t\tthis.terminalModes.onUnmount(componentId);\n\t\tthis.mounted.delete(componentId);\n\t\tif (record.widgetKey) this.ui.setWidget(record.widgetKey, undefined);\n\t\trecord.component.dispose();\n\t}\n\n\tprivate control(componentId: string, action: \"focus\" | \"hide\" | \"show\" | \"unfocus\"): void {\n\t\tconst handle = this.mounted.get(componentId)?.handle;\n\t\tif (!handle) return;\n\t\tswitch (action) {\n\t\t\tcase \"focus\": handle.focus(); break;\n\t\t\tcase \"hide\": handle.setHidden(true); break;\n\t\t\tcase \"show\": handle.setHidden(false); break;\n\t\t\tcase \"unfocus\": handle.unfocus(); break;\n\t\t}\n\t}\n}\n"]}

package/dist/modes/interactive-engine/remote-frame-clamp.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Width clamp for frames rendered out-of-process by the isolated interactive
+ * engine.
+ *
+ * Remote components ({@link RemoteRenderer}, {@link RemoteComponent}) request a
+ * re-render from the engine child asynchronously and keep returning the last
+ * applied frame until the fresh one arrives. Across a terminal resize this
+ * replays lines wrapped at the previous width; pi-tui's differential renderer
+ * treats any rendered line wider than the terminal as a fatal invariant
+ * violation and crashes the whole TUI (uncaughtException in doRender).
+ *
+ * Clamping the stale frame to the currently requested width keeps every
+ * returned line legal while the engine catches up; the properly re-wrapped
+ * frame replaces the clamped one as soon as it is applied.
+ *
+ * The result is memoized on (frame identity, width) so steady-state renders
+ * cost one identity check and re-scans happen only on resize or frame change.
+ */
+export declare class RemoteFrameWidthClamp {
+    private source;
+    private width;
+    private clamped;
+    clamp(lines: string[], width: number): string[];
+}
+//# sourceMappingURL=remote-frame-clamp.d.ts.map

package/dist/modes/interactive-engine/remote-frame-clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-frame-clamp.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-frame-clamp.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAqB;IACjC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,OAAO,CAAuB;IAEtC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB9C;CACD"}

package/dist/modes/interactive-engine/remote-frame-clamp.js

@@ -0,0 +1,43 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+/**
+ * Width clamp for frames rendered out-of-process by the isolated interactive
+ * engine.
+ *
+ * Remote components ({@link RemoteRenderer}, {@link RemoteComponent}) request a
+ * re-render from the engine child asynchronously and keep returning the last
+ * applied frame until the fresh one arrives. Across a terminal resize this
+ * replays lines wrapped at the previous width; pi-tui's differential renderer
+ * treats any rendered line wider than the terminal as a fatal invariant
+ * violation and crashes the whole TUI (uncaughtException in doRender).
+ *
+ * Clamping the stale frame to the currently requested width keeps every
+ * returned line legal while the engine catches up; the properly re-wrapped
+ * frame replaces the clamped one as soon as it is applied.
+ *
+ * The result is memoized on (frame identity, width) so steady-state renders
+ * cost one identity check and re-scans happen only on resize or frame change.
+ */
+export class RemoteFrameWidthClamp {
+    constructor() {
+        this.width = -1;
+    }
+    clamp(lines, width) {
+        if (this.clamped !== undefined && this.source === lines && this.width === width) {
+            return this.clamped;
+        }
+        let result = lines;
+        if (width > 0) {
+            for (const line of lines) {
+                if (visibleWidth(line) > width) {
+                    result = lines.map((frameLine) => visibleWidth(frameLine) > width ? truncateToWidth(frameLine, width, "") : frameLine);
+                    break;
+                }
+            }
+        }
+        this.source = lines;
+        this.width = width;
+        this.clamped = result;
+        return result;
+    }
+}
+//# sourceMappingURL=remote-frame-clamp.js.map

package/dist/modes/interactive-engine/remote-frame-clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-frame-clamp.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-frame-clamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,qBAAqB;IAAlC;QAES,UAAK,GAAG,CAAC,CAAC,CAAC;IAuBpB,CAAC;IApBA,KAAK,CAAC,KAAe,EAAE,KAAa;QACnC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACjF,OAAO,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;oBAChC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAChC,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CACnF,CAAC;oBACF,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,MAAM,CAAC;IACf,CAAC;CACD","sourcesContent":["import { truncateToWidth, visibleWidth } from \"@earendil-works/pi-tui\";\n\n/**\n * Width clamp for frames rendered out-of-process by the isolated interactive\n * engine.\n *\n * Remote components ({@link RemoteRenderer}, {@link RemoteComponent}) request a\n * re-render from the engine child asynchronously and keep returning the last\n * applied frame until the fresh one arrives. Across a terminal resize this\n * replays lines wrapped at the previous width; pi-tui's differential renderer\n * treats any rendered line wider than the terminal as a fatal invariant\n * violation and crashes the whole TUI (uncaughtException in doRender).\n *\n * Clamping the stale frame to the currently requested width keeps every\n * returned line legal while the engine catches up; the properly re-wrapped\n * frame replaces the clamped one as soon as it is applied.\n *\n * The result is memoized on (frame identity, width) so steady-state renders\n * cost one identity check and re-scans happen only on resize or frame change.\n */\nexport class RemoteFrameWidthClamp {\n\tprivate source: readonly string[] | undefined;\n\tprivate width = -1;\n\tprivate clamped: string[] | undefined;\n\n\tclamp(lines: string[], width: number): string[] {\n\t\tif (this.clamped !== undefined && this.source === lines && this.width === width) {\n\t\t\treturn this.clamped;\n\t\t}\n\t\tlet result = lines;\n\t\tif (width > 0) {\n\t\t\tfor (const line of lines) {\n\t\t\t\tif (visibleWidth(line) > width) {\n\t\t\t\t\tresult = lines.map((frameLine) =>\n\t\t\t\t\t\tvisibleWidth(frameLine) > width ? truncateToWidth(frameLine, width, \"\") : frameLine,\n\t\t\t\t\t);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tthis.source = lines;\n\t\tthis.width = width;\n\t\tthis.clamped = result;\n\t\treturn result;\n\t}\n}\n"]}

package/dist/modes/interactive-engine/remote-renderer.d.ts

@@ -0,0 +1,59 @@
+import type { Component } from "@earendil-works/pi-tui";
+import type { CustomMessage } from "../../core/messages.ts";
+import type { ToolExecutionComponent } from "../interactive/components/tool-execution.ts";
+import type { IsolatedInteractiveRuntime } from "./isolated-runtime.ts";
+import type { InteractiveEngineCommand } from "./protocol.ts";
+type RenderableToolResult = Parameters<ToolExecutionComponent["updateResult"]>[0];
+declare abstract class RemoteRenderer implements Component {
+    protected readonly componentId: string;
+    private lines;
+    private width;
+    private requestId;
+    private appliedRequestId;
+    private dirty;
+    private disposed;
+    private readonly frameClamp;
+    private readonly unsubscribe;
+    protected readonly runtime: IsolatedInteractiveRuntime;
+    private readonly requestRender;
+    constructor(runtime: IsolatedInteractiveRuntime, requestRender: () => void);
+    render(width: number): string[];
+    invalidate(): void;
+    dispose(): void;
+    protected changed(): void;
+    protected abstract command(requestId: number, width: number): InteractiveEngineCommand;
+    private markDirty;
+}
+export declare class RemoteToolExecutionComponent extends RemoteRenderer {
+    private readonly toolName;
+    private readonly toolCallId;
+    private args;
+    private result;
+    private executionStarted;
+    private argsComplete;
+    private isPartial;
+    private expanded;
+    private showImages;
+    private imageWidthCells;
+    constructor(toolName: string, toolCallId: string, args: unknown, options: {
+        showImages?: boolean;
+        imageWidthCells?: number;
+    }, runtime: IsolatedInteractiveRuntime, requestRender: () => void);
+    updateArgs(args: unknown): void;
+    markExecutionStarted(): void;
+    setArgsComplete(): void;
+    updateResult(result: RenderableToolResult, isPartial?: boolean): void;
+    setExpanded(expanded: boolean): void;
+    setShowImages(show: boolean): void;
+    setImageWidthCells(width: number): void;
+    protected command(requestId: number, width: number): InteractiveEngineCommand;
+}
+export declare class RemoteCustomMessageComponent extends RemoteRenderer {
+    private readonly message;
+    private expanded;
+    constructor(message: CustomMessage<unknown>, runtime: IsolatedInteractiveRuntime, requestRender: () => void);
+    setExpanded(expanded: boolean): void;
+    protected command(requestId: number, width: number): InteractiveEngineCommand;
+}
+export {};
+//# sourceMappingURL=remote-renderer.d.ts.map

package/dist/modes/interactive-engine/remote-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-renderer.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-renderer.ts"],"names":[],"mappings":"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"}

package/dist/modes/interactive-engine/remote-renderer.js

@@ -0,0 +1,123 @@
+import { RemoteFrameWidthClamp } from "./remote-frame-clamp.js";
+let nextRemoteRendererId = 0;
+function jsonValue(value) {
+    if (value === undefined)
+        return null;
+    const encoded = JSON.stringify(value);
+    return encoded === undefined ? null : JSON.parse(encoded);
+}
+class RemoteRenderer {
+    constructor(runtime, requestRender) {
+        this.componentId = `remote_renderer_${++nextRemoteRendererId}`;
+        this.lines = ["Loading isolated renderer…"];
+        this.width = 0;
+        this.requestId = 0;
+        this.appliedRequestId = 0;
+        this.dirty = true;
+        this.disposed = false;
+        this.frameClamp = new RemoteFrameWidthClamp();
+        this.runtime = runtime;
+        this.requestRender = requestRender;
+        this.unsubscribe = runtime.onEngineMessage((message) => {
+            if (!("componentId" in message) || message.componentId !== this.componentId)
+                return;
+            if (message.type === "engine_custom_frame") {
+                if (message.requestId < this.appliedRequestId)
+                    return;
+                this.appliedRequestId = message.requestId;
+                this.lines = message.lines;
+                this.requestRender();
+            }
+            else if (message.type === "engine_custom_invalidate") {
+                this.markDirty();
+            }
+        });
+    }
+    render(width) {
+        if (!this.disposed && (this.dirty || width !== this.width)) {
+            this.width = width;
+            this.dirty = false;
+            this.runtime.sendEngineCommand(this.command(++this.requestId, width));
+        }
+        // The engine child re-renders asynchronously; until the fresh frame
+        // arrives, the previous frame may be wrapped for an older terminal
+        // width. Clamp so a resize never replays overflowing lines (pi-tui
+        // crashes on any rendered line wider than the terminal).
+        return this.frameClamp.clamp(this.lines, width);
+    }
+    invalidate() { this.markDirty(); }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.unsubscribe();
+        this.runtime.sendEngineCommand({ type: "engine_render_dispose", componentId: this.componentId });
+    }
+    changed() {
+        this.markDirty();
+        this.requestRender();
+    }
+    markDirty() { this.dirty = true; }
+}
+export class RemoteToolExecutionComponent extends RemoteRenderer {
+    constructor(toolName, toolCallId, args, options, runtime, requestRender) {
+        super(runtime, requestRender);
+        this.executionStarted = false;
+        this.argsComplete = false;
+        this.isPartial = true;
+        this.expanded = false;
+        this.toolName = toolName;
+        this.toolCallId = toolCallId;
+        this.args = args;
+        this.showImages = options.showImages ?? true;
+        this.imageWidthCells = options.imageWidthCells ?? 60;
+    }
+    updateArgs(args) { this.args = args; this.changed(); }
+    markExecutionStarted() { this.executionStarted = true; this.changed(); }
+    setArgsComplete() { this.argsComplete = true; this.changed(); }
+    updateResult(result, isPartial = false) {
+        this.result = result;
+        this.isPartial = isPartial;
+        this.changed();
+    }
+    setExpanded(expanded) { this.expanded = expanded; this.changed(); }
+    setShowImages(show) { this.showImages = show; this.changed(); }
+    setImageWidthCells(width) { this.imageWidthCells = Math.max(1, Math.floor(width)); this.changed(); }
+    command(requestId, width) {
+        return {
+            type: "engine_tool_render",
+            componentId: this.componentId,
+            requestId,
+            width,
+            toolName: this.toolName,
+            toolCallId: this.toolCallId,
+            args: jsonValue(this.args),
+            result: this.result ? jsonValue(this.result) : undefined,
+            executionStarted: this.executionStarted,
+            argsComplete: this.argsComplete,
+            isPartial: this.isPartial,
+            expanded: this.expanded,
+            showImages: this.showImages,
+            imageWidthCells: this.imageWidthCells,
+        };
+    }
+}
+export class RemoteCustomMessageComponent extends RemoteRenderer {
+    constructor(message, runtime, requestRender) {
+        super(runtime, requestRender);
+        this.expanded = false;
+        this.message = message;
+    }
+    setExpanded(expanded) { this.expanded = expanded; this.changed(); }
+    command(requestId, width) {
+        return {
+            type: "engine_message_render",
+            componentId: this.componentId,
+            requestId,
+            width,
+            message: jsonValue(this.message),
+            expanded: this.expanded,
+        };
+    }
+}
+//# sourceMappingURL=remote-renderer.js.map

package/dist/modes/interactive-engine/remote-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-renderer.js","sourceRoot":"","sources":["../../../src/modes/interactive-engine/remote-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Component } from \"@earendil-works/pi-tui\";\nimport type { CustomMessage } from \"../../core/messages.ts\";\nimport type { ToolExecutionComponent } from \"../interactive/components/tool-execution.ts\";\nimport type { IsolatedInteractiveRuntime } from \"./isolated-runtime.ts\";\nimport type { InteractiveEngineCommand, JsonObject, JsonValue } from \"./protocol.ts\";\nimport { RemoteFrameWidthClamp } from \"./remote-frame-clamp.ts\";\n\ntype RenderableToolResult = Parameters<ToolExecutionComponent[\"updateResult\"]>[0];\n\nlet nextRemoteRendererId = 0;\n\nfunction jsonValue(value: unknown): JsonValue {\n\tif (value === undefined) return null;\n\tconst encoded = JSON.stringify(value);\n\treturn encoded === undefined ? null : JSON.parse(encoded) as JsonValue;\n}\n\nabstract class RemoteRenderer implements Component {\n\tprotected readonly componentId = `remote_renderer_${++nextRemoteRendererId}`;\n\tprivate lines = [\"Loading isolated renderer…\"];\n\tprivate width = 0;\n\tprivate requestId = 0;\n\tprivate appliedRequestId = 0;\n\tprivate dirty = true;\n\tprivate disposed = false;\n\tprivate readonly frameClamp = new RemoteFrameWidthClamp();\n\tprivate readonly unsubscribe: () => void;\n\n\tprotected readonly runtime: IsolatedInteractiveRuntime;\n\tprivate readonly requestRender: () => void;\n\n\tconstructor(\n\t\truntime: IsolatedInteractiveRuntime,\n\t\trequestRender: () => void,\n\t) {\n\t\tthis.runtime = runtime;\n\t\tthis.requestRender = requestRender;\n\t\tthis.unsubscribe = runtime.onEngineMessage((message) => {\n\t\t\tif (!(\"componentId\" in message) || message.componentId !== this.componentId) return;\n\t\t\tif (message.type === \"engine_custom_frame\") {\n\t\t\t\tif (message.requestId < this.appliedRequestId) return;\n\t\t\t\tthis.appliedRequestId = message.requestId;\n\t\t\t\tthis.lines = message.lines;\n\t\t\t\tthis.requestRender();\n\t\t\t} else if (message.type === \"engine_custom_invalidate\") {\n\t\t\t\tthis.markDirty();\n\t\t\t}\n\t\t});\n\t}\n\n\trender(width: number): string[] {\n\t\tif (!this.disposed && (this.dirty || width !== this.width)) {\n\t\t\tthis.width = width;\n\t\t\tthis.dirty = false;\n\t\t\tthis.runtime.sendEngineCommand(this.command(++this.requestId, width));\n\t\t}\n\t\t// The engine child re-renders asynchronously; until the fresh frame\n\t\t// arrives, the previous frame may be wrapped for an older terminal\n\t\t// width. Clamp so a resize never replays overflowing lines (pi-tui\n\t\t// crashes on any rendered line wider than the terminal).\n\t\treturn this.frameClamp.clamp(this.lines, width);\n\t}\n\n\tinvalidate(): void { this.markDirty(); }\n\n\tdispose(): void {\n\t\tif (this.disposed) return;\n\t\tthis.disposed = true;\n\t\tthis.unsubscribe();\n\t\tthis.runtime.sendEngineCommand({ type: \"engine_render_dispose\", componentId: this.componentId });\n\t}\n\n\tprotected changed(): void {\n\t\tthis.markDirty();\n\t\tthis.requestRender();\n\t}\n\n\tprotected abstract command(requestId: number, width: number): InteractiveEngineCommand;\n\n\tprivate markDirty(): void { this.dirty = true; }\n}\n\nexport class RemoteToolExecutionComponent extends RemoteRenderer {\n\tprivate readonly toolName: string;\n\tprivate readonly toolCallId: string;\n\tprivate args: unknown;\n\tprivate result: RenderableToolResult | undefined;\n\tprivate executionStarted = false;\n\tprivate argsComplete = false;\n\tprivate isPartial = true;\n\tprivate expanded = false;\n\tprivate showImages: boolean;\n\tprivate imageWidthCells: number;\n\n\tconstructor(\n\t\ttoolName: string,\n\t\ttoolCallId: string,\n\t\targs: unknown,\n\t\toptions: { showImages?: boolean; imageWidthCells?: number },\n\t\truntime: IsolatedInteractiveRuntime,\n\t\trequestRender: () => void,\n\t) {\n\t\tsuper(runtime, requestRender);\n\t\tthis.toolName = toolName;\n\t\tthis.toolCallId = toolCallId;\n\t\tthis.args = args;\n\t\tthis.showImages = options.showImages ?? true;\n\t\tthis.imageWidthCells = options.imageWidthCells ?? 60;\n\t}\n\n\tupdateArgs(args: unknown): void { this.args = args; this.changed(); }\n\tmarkExecutionStarted(): void { this.executionStarted = true; this.changed(); }\n\tsetArgsComplete(): void { this.argsComplete = true; this.changed(); }\n\tupdateResult(result: RenderableToolResult, isPartial = false): void {\n\t\tthis.result = result;\n\t\tthis.isPartial = isPartial;\n\t\tthis.changed();\n\t}\n\tsetExpanded(expanded: boolean): void { this.expanded = expanded; this.changed(); }\n\tsetShowImages(show: boolean): void { this.showImages = show; this.changed(); }\n\tsetImageWidthCells(width: number): void { this.imageWidthCells = Math.max(1, Math.floor(width)); this.changed(); }\n\n\tprotected command(requestId: number, width: number): InteractiveEngineCommand {\n\t\treturn {\n\t\t\ttype: \"engine_tool_render\",\n\t\t\tcomponentId: this.componentId,\n\t\t\trequestId,\n\t\t\twidth,\n\t\t\ttoolName: this.toolName,\n\t\t\ttoolCallId: this.toolCallId,\n\t\t\targs: jsonValue(this.args),\n\t\t\tresult: this.result ? jsonValue(this.result) as JsonObject : undefined,\n\t\t\texecutionStarted: this.executionStarted,\n\t\t\targsComplete: this.argsComplete,\n\t\t\tisPartial: this.isPartial,\n\t\t\texpanded: this.expanded,\n\t\t\tshowImages: this.showImages,\n\t\t\timageWidthCells: this.imageWidthCells,\n\t\t};\n\t}\n}\n\nexport class RemoteCustomMessageComponent extends RemoteRenderer {\n\tprivate readonly message: CustomMessage<unknown>;\n\tprivate expanded = false;\n\tconstructor(\n\t\tmessage: CustomMessage<unknown>,\n\t\truntime: IsolatedInteractiveRuntime,\n\t\trequestRender: () => void,\n\t) {\n\t\tsuper(runtime, requestRender);\n\t\tthis.message = message;\n\t}\n\n\tsetExpanded(expanded: boolean): void { this.expanded = expanded; this.changed(); }\n\n\tprotected command(requestId: number, width: number): InteractiveEngineCommand {\n\t\treturn {\n\t\t\ttype: \"engine_message_render\",\n\t\t\tcomponentId: this.componentId,\n\t\t\trequestId,\n\t\t\twidth,\n\t\t\tmessage: jsonValue(this.message) as JsonObject,\n\t\t\texpanded: this.expanded,\n\t\t};\n\t}\n}\n"]}

package/dist/modes/interactive-engine/session-picker-host.d.ts

@@ -0,0 +1,25 @@
+import type { ExtensionUIContext } from "../../core/extensions/index.ts";
+import type { IsolatedInteractiveRuntime } from "./isolated-runtime.ts";
+/**
+ * Host-side half of the engine session picker channel.
+ *
+ * Mounts a REAL `SessionSelectorComponent` in the terminal host when the engine
+ * child opens a picker, so arrow-key navigation, search, and repaints are
+ * zero-IPC (unlike remote-rendered `ctx.ui.custom` components, which round-trip
+ * every keypress). Only semantic events cross the protocol: the child pushes
+ * open/update/error/close, the host sends select/cancel/delete. Deletion is
+ * child-owned — the host never removes a row locally; it waits for the child's
+ * `update` (row removed) or `error` reply.
+ */
+export declare class SessionPickerHostController {
+    private readonly mounted;
+    private readonly unsubscribe;
+    private readonly runtime;
+    private readonly ui;
+    constructor(runtime: IsolatedInteractiveRuntime, ui: ExtensionUIContext);
+    dispose(): void;
+    private handleMessage;
+    private open;
+    private disposeAll;
+}
+//# sourceMappingURL=session-picker-host.d.ts.map

package/dist/modes/interactive-engine/session-picker-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-picker-host.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive-engine/session-picker-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAwB,MAAM,gCAAgC,CAAC;AAM/F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAGxE;;;;;;;;;;GAUG;AACH,qBAAa,2BAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;IAExC,YAAY,OAAO,EAAE,0BAA0B,EAAE,EAAE,EAAE,kBAAkB,EAItE;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,IAAI;IAkBZ,OAAO,CAAC,UAAU;CAIlB"}

package/dist/modes/interactive-engine/session-picker-host.js

@@ -0,0 +1,75 @@
+import { mountHostSessionPicker, sessionInfoFromPickerRow, } from "../interactive/components/host-session-picker.js";
+/**
+ * Host-side half of the engine session picker channel.
+ *
+ * Mounts a REAL `SessionSelectorComponent` in the terminal host when the engine
+ * child opens a picker, so arrow-key navigation, search, and repaints are
+ * zero-IPC (unlike remote-rendered `ctx.ui.custom` components, which round-trip
+ * every keypress). Only semantic events cross the protocol: the child pushes
+ * open/update/error/close, the host sends select/cancel/delete. Deletion is
+ * child-owned — the host never removes a row locally; it waits for the child's
+ * `update` (row removed) or `error` reply.
+ */
+export class SessionPickerHostController {
+    constructor(runtime, ui) {
+        this.mounted = new Map();
+        this.runtime = runtime;
+        this.ui = ui;
+        this.unsubscribe = runtime.onEngineMessage((message) => this.handleMessage(message));
+    }
+    dispose() {
+        this.unsubscribe();
+        this.disposeAll();
+    }
+    handleMessage(message) {
+        switch (message.type) {
+            case "engine_ready":
+                // A fresh engine generation replaced the child: its pickers are gone
+                // and the componentIds are meaningless to the new generation, so
+                // unmount silently (no cancel command).
+                this.disposeAll();
+                break;
+            case "engine_session_picker_open":
+                this.open(message.componentId, message.sessions, message.showRenameHint === true);
+                break;
+            case "engine_session_picker_update":
+                this.mounted.get(message.componentId)?.setRows(message.sessions.map(sessionInfoFromPickerRow));
+                break;
+            case "engine_session_picker_error":
+                this.mounted.get(message.componentId)?.showError(message.message);
+                break;
+            case "engine_session_picker_close": {
+                const mount = this.mounted.get(message.componentId);
+                if (!mount)
+                    break;
+                this.mounted.delete(message.componentId);
+                mount.close();
+                break;
+            }
+        }
+    }
+    open(componentId, sessions, showRenameHint) {
+        if (this.mounted.has(componentId))
+            return;
+        const mount = mountHostSessionPicker(this.ui, sessions.map(sessionInfoFromPickerRow), showRenameHint, {
+            onSelect: (path) => {
+                this.mounted.delete(componentId);
+                this.runtime.sendEngineCommand({ type: "engine_session_picker_select", componentId, path });
+            },
+            onCancel: () => {
+                this.mounted.delete(componentId);
+                this.runtime.sendEngineCommand({ type: "engine_session_picker_cancel", componentId });
+            },
+            onDelete: (path) => {
+                this.runtime.sendEngineCommand({ type: "engine_session_picker_delete", componentId, path });
+            },
+        });
+        this.mounted.set(componentId, mount);
+    }
+    disposeAll() {
+        for (const mount of this.mounted.values())
+            mount.close();
+        this.mounted.clear();
+    }
+}
+//# sourceMappingURL=session-picker-host.js.map