@timurproko/a1 0.1.8-dev.139 → 0.1.8-dev.151

package/dist/integrations/pi/{owned-ui → session-ui}/session-shell-root.js

@@ -1,7 +1,9 @@
-import { TranscriptViewport, backgroundSgrSpan, composeSubmittedPromptRows, displayWidth, formatSubmittedPromptTime, overlaySpan, submittedPromptLayout, routeMouseInput, scrollForTrackPage, scrollForThumbRow, scrollbarSelectionRows, scrollbarWheelRows, } from "../../../ui/components/index.js";
+import { backgroundSgrSpan, composeSubmittedPromptRows, displayWidth, formatSubmittedPromptTime, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, submittedPromptLayout, stripAnsi, } from "../../../ui/components/index.js";
 import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../engine/index.js";
-import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
+import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, piShellVisibleWidth, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
 import { PiTuiRuntimeAdapter, } from "../tui-runtime/index.js";
+import { PromptChipStore } from "./prompt-chips.js";
+import { SessionViewportController } from "./session-viewport-controller.js";
 export class OwnedUiSessionShellRoot {
     editor;
     header;
@@ -19,20 +21,10 @@ export class OwnedUiSessionShellRoot {
     #footer;
     #queued;
     #extensionRenderers;
+    #promptChips = new PromptChipStore();
     #customViewport;
     #submittedPromptComposer;
-    #viewport = new TranscriptViewport();
-    #viewportConfig = {
-        scrollbarAppearance: "hover",
-        scrollbarStyle: "thin",
-        scrollbarSpeed: "normal",
-    };
-    #dragGrabOffset = null;
-    /** A left-button sequence begun in status/editor/footer chrome is swallowed. */
-    #dockPointerSuppressed = false;
-    #selectionAutoScrollTimer;
-    #selectionAutoScrollPointer;
-    #viewportActivityTimer;
+    #viewportController;
     #componentRuntime;
     #toolsExpanded = false;
     #thinkingVisible = true;
@@ -54,7 +46,11 @@ export class OwnedUiSessionShellRoot {
         this.#view = view;
         this.#customViewport = sessionLayout === "custom-viewport";
         this.#submittedPromptComposer = this.#customViewport
-            ? { layout: submittedPromptLayout, compose: composeSubmittedPromptRows }
+            ? {
+                layout: submittedPromptLayout,
+                compose: (rows, width, source, style) => composeSubmittedPromptRows(rows, width, source, style)
+                    .map(row => nativeHyperlinkStyle(row, nativeTranscriptLinkColor)),
+            }
             : undefined;
         this.#cwd = cwd;
         this.#extensionRenderers = extensionRenderers;
@@ -66,10 +62,39 @@ export class OwnedUiSessionShellRoot {
         this.#queued = createPiQueuedInputStatus(view.editor.queuedSubmissions, this.#customViewport ? "custom-viewport" : "pinned");
         this.editor = createPiShellEditor({
             ...handlers,
+            keybindingProfile: this.#customViewport ? "a1" : "pi",
+            paintEditorSelection: (line, from, to, atomic) => backgroundSgrSpan(line, from, to, atomic ? "\u001b[7m" : "\u001b[27m\u001b[48;2;38;79;120m", atomic ? "\u001b[27m" : "\u001b[49m", piShellVisibleWidth),
+            transformPastedContent: content => this.#promptChips.transformPastedContent(content),
+            editorAtomicRanges: line => this.#promptChips.atomicRanges(line),
+            decorateEditorRow: (row, width) => {
+                const plain = stripAnsi(row);
+                const ranges = this.#promptChips.hyperlinkRanges(plain);
+                if (ranges.length === 0)
+                    return row;
+                const linkResetAndTail = `\u001b]8;;\u001b\\\u001b[24m${" ".repeat(Math.max(0, width - piShellVisibleWidth(row)))}`;
+                // VS15 is zero-column and default-ignorable. It breaks Windows Terminal's
+                // plain-text URL detector only in the held-button paint; semantic text stays exact.
+                const paintRow = this.#viewportController.editorPointerSelecting
+                    ? row.replaceAll("https://", "https:\uFE0E//").replaceAll("http://", "http:\uFE0E//")
+                    : row;
+                const decorated = this.#viewportController.editorPointerSelecting
+                    ? ranges.reduce((result, range) => backgroundSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), "\u001b[4:4m", "\u001b[24m", piShellVisibleWidth), paintRow)
+                    : ranges.reduce((result, range) => hyperlinkSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), range.target, piShellVisibleWidth), row);
+                // Windows Terminal can retain stale native dotted-link cells when a mutable
+                // prompt replaces a longer URL. Explicit non-link spaces overwrite that tail.
+                return `${decorated}${linkResetAndTail}`;
+            },
+            expandCopiedEditorText: text => this.#promptChips.expandCopiedText(text),
             cwd,
             ...(agentDir === undefined ? {} : { agentDir }),
             onToolsExpand: () => this.#setToolsExpanded(!this.#toolsExpanded),
         });
+        this.#viewportController = new SessionViewportController({
+            enabled: this.#customViewport,
+            editor: this.editor,
+            requestRender: force => this.#componentRuntime.requestRender(force),
+            hasEditorLinks: () => this.#promptChips.hyperlinkRanges(this.editor.getText()).length > 0,
+        });
         this.editor.setThinkingLevel(view.thinkingLevel);
         this.#inputSurface = this.editor;
         for (const block of view.transcript) {
@@ -84,6 +109,9 @@ export class OwnedUiSessionShellRoot {
             this.#documentLayouts.clear();
         });
     }
+    preparePromptSubmission(text) {
+        return this.#promptChips.prepareSubmission(text);
+    }
     update(view) {
         if (view.diagnostics.length !== this.#view.diagnostics.length
             || view.diagnostics.some((diagnostic, index) => diagnostic.sequence !== this.#view.diagnostics[index]?.sequence)) {
@@ -121,31 +149,44 @@ export class OwnedUiSessionShellRoot {
         this.#documentLayouts.clear();
     }
     render(width) {
-        if (!this.#customViewport)
+        if (!this.#customViewport) {
+            this.#viewportController.setEditorPointerFrame(undefined);
             return [...this.#renderDocument(width), ...this.#renderDock(width)];
+        }
         const height = Math.max(0, this.#componentRuntime.getRows());
         const dock = this.#renderDockLayout(width);
-        const availableWithoutStatus = Math.max(0, height - Math.min(height, dock.rowsWithoutStatus.length));
+        const availableWithoutTransient = Math.max(0, height - Math.min(height, dock.rowsWithoutTransient.length));
         // Ordinary transcript content uses the full terminal width. The rail is an
         // overlay, not a lost wrapping cell. Submitted prompts alone retain the
         // intentional final gutter after their right-aligned timestamp.
         const documentWidth = width;
         let document = this.#renderDocumentLayout(documentWidth);
-        const statusRows = dock.statusRows;
-        // v2 pins Working only while the complete transcript still fits. Once the
-        // transcript overflows, status joins the scrollable document tail so it
-        // naturally leaves the screen when the user scrolls up.
-        // Pi presents pending messages before Working. Keep status in the dock while
-        // a queue exists so moving overflowing status into the document cannot
-        // reverse that semantic order; it returns to v2 scrolling once the queue clears.
-        const pinStatus = this.#view.editor.queuedSubmissions.length > 0
-            || document.rows.length + statusRows.length <= availableWithoutStatus;
-        const dockRows = pinStatus ? dock.rows : dock.rowsWithoutStatus;
-        if (!pinStatus)
-            document = { ...document, rows: [...document.rows, ...statusRows] };
-        this.#viewport.setConfig(this.#viewportConfig);
-        return this.#viewport.compose({
+        // Keep queued steering/follow-up messages and Working together in Pi's
+        // semantic order while content fits. Once the transcript overflows, move
+        // the complete transient group into its tail so every row naturally
+        // scrolls away and the detached viewport can use the full space above the
+        // stable editor/footer dock.
+        const pinTransient = document.rows.length + dock.transientRows.length <= availableWithoutTransient;
+        const dockRows = pinTransient ? dock.rows : dock.rowsWithoutTransient;
+        const selectableDocumentRowCount = document.rows.length;
+        if (!pinTransient)
+            document = { ...document, rows: [...document.rows, ...dock.transientRows] };
+        const dockStartRow = height - dockRows.length + 1;
+        const editorOffset = pinTransient ? dock.editorOffsetWithTransient : dock.editorOffsetWithoutTransient;
+        this.#viewportController.setEditorPointerFrame(this.usesDefaultInputSurface()
+            ? {
+                rowStart: dockStartRow + editorOffset,
+                rowEnd: dockStartRow + editorOffset + dock.inputRows - 1,
+            }
+            : undefined);
+        return this.#viewportController.compose({
             documentRows: document.rows,
+            ...(this.#viewportController.transcriptPointerSelecting
+                ? { paintDocumentRow: heldNativeHyperlinkStyle }
+                : {}),
+            // Overflowing queued and Working rows scroll with the transcript but
+            // remain status chrome: selection and copying stop at the real document tail.
+            selectableDocumentRowCount,
             dockRows,
             promptAnchors: document.promptAnchors,
             width,
@@ -172,236 +213,23 @@ export class OwnedUiSessionShellRoot {
         }).rows;
     }
     setViewportConfig(config) {
-        if (config.scrollbarAppearance !== this.#viewportConfig.scrollbarAppearance)
+        if (this.#viewportController.setConfig(config))
             this.#documentLayouts.clear();
-        this.#viewportConfig = config;
-        this.#viewport.setConfig(config);
-        this.#componentRuntime.requestRender();
     }
     resumeViewportFollowing() {
-        if (!this.#customViewport)
-            return;
-        this.#stopSelectionAutoScroll();
-        const selectionChanged = this.#viewport.clearSelection();
-        const scrolled = this.#viewport.scrollToEnd();
-        if (scrolled)
-            this.#scheduleViewportActivityExpiry();
-        if (scrolled || selectionChanged)
-            this.#componentRuntime.requestRender();
+        this.#viewportController.resumeFollowing();
     }
     noteCompletedAssistantMessage() {
-        if (!this.#customViewport || !this.#viewport.noteNewMessage())
-            return;
-        this.#componentRuntime.requestRender();
+        this.#viewportController.noteCompletedAssistantMessage();
     }
     resetViewport() {
-        if (this.#viewportActivityTimer !== undefined)
-            clearTimeout(this.#viewportActivityTimer);
-        this.#viewportActivityTimer = undefined;
-        this.#stopSelectionAutoScroll();
-        this.#viewport.reset();
+        this.#viewportController.reset();
     }
     clearViewportPointerState() {
-        if (this.#viewportActivityTimer !== undefined)
-            clearTimeout(this.#viewportActivityTimer);
-        this.#viewportActivityTimer = undefined;
-        this.#dragGrabOffset = null;
-        this.#dockPointerSuppressed = false;
-        this.#stopSelectionAutoScroll();
-        this.#viewport.clearSelection();
-        this.#viewport.clearTransient();
+        this.#viewportController.clearPointerState();
     }
     handleViewportPreInput(data, allowWheel = true, now = Date.now()) {
-        if (!this.#customViewport || this.#viewport.frame === null)
-            return { data, consumed: false };
-        if (data === "\u0003") {
-            const copyText = this.#viewport.selectedText();
-            if (copyText !== null && copyText.length > 0) {
-                this.#viewport.clearSelection();
-                this.#componentRuntime.requestRender();
-                return { data: "", consumed: true, copyText };
-            }
-        }
-        if (allowWheel && ALT_END_INPUTS.has(data) && !this.#viewport.followingEnd) {
-            this.#viewport.scrollToEnd(now);
-            this.#scheduleViewportActivityExpiry();
-            this.#componentRuntime.requestRender();
-            return { data: "", consumed: true };
-        }
-        if (allowWheel && ALT_HOME_INPUTS.has(data)) {
-            if (this.#viewport.scrollToPreviousPrompt(now)) {
-                this.#scheduleViewportActivityExpiry();
-                this.#componentRuntime.requestRender();
-            }
-            return { data: "", consumed: true };
-        }
-        const frame = this.#viewport.frame;
-        let repaint = false;
-        let activity = false;
-        const routed = routeMouseInput(data, event => {
-            const hits = frame.hits;
-            const overRail = hits.rail !== null
-                && event.column === hits.rail.column
-                && event.row >= hits.rail.rowStart
-                && event.row < hits.rail.rowStart + hits.rail.trackHeight;
-            const overSticky = hits.sticky !== null && event.row === hits.sticky.row && event.column <= hits.sticky.width;
-            const overBottom = hits.bottom !== null && event.row === hits.bottom.row
-                && event.column >= hits.bottom.columnStart && event.column <= hits.bottom.columnEnd;
-            if (event.kind === "motion") {
-                this.#viewport.setRailHovered(overRail);
-                this.#viewport.setStickyHovered(overSticky);
-                this.#viewport.setBottomHovered(overBottom);
-                repaint = true;
-                if (this.#dockPointerSuppressed)
-                    return true;
-                // Once a left-button selection starts, its release—not the button bits
-                // on an intermediate motion report—ends ownership. Some terminals emit
-                // no-button motion while busy frames are being coalesced; accepting it
-                // keeps the drag continuous instead of apparently freezing.
-                if (this.#viewport.selectionActive) {
-                    this.#viewport.extendSelection(event.column, event.row, now, false);
-                    this.#updateSelectionAutoScroll(event.column, event.row, hits.viewportHeight);
-                    activity = true;
-                    return true;
-                }
-                if (this.#dragGrabOffset !== null && hits.rail !== null) {
-                    const target = scrollForThumbRow(hits.rail.geometry, event.row - hits.rail.rowStart - this.#dragGrabOffset);
-                    this.#viewport.scrollTo(target, now);
-                    activity = true;
-                    return true;
-                }
-                return overRail || overSticky || overBottom;
-            }
-            if (event.kind === "wheel-up" || event.kind === "wheel-down") {
-                if (!allowWheel || event.row < 1 || event.row > hits.viewportHeight)
-                    return false;
-                const distance = scrollbarWheelRows(this.#viewportConfig.scrollbarSpeed);
-                this.#viewport.scrollBy(event.kind === "wheel-up" ? -distance : distance, now);
-                activity = true;
-                repaint = true;
-                return true;
-            }
-            if (event.kind === "press") {
-                if (event.button !== 0)
-                    return false;
-                this.#stopSelectionAutoScroll();
-                if (this.#viewport.clearSelection())
-                    repaint = true;
-                if (overBottom) {
-                    this.#viewport.scrollToEnd(now);
-                    activity = true;
-                    repaint = true;
-                    return true;
-                }
-                if (overSticky && hits.sticky !== null) {
-                    this.#viewport.scrollTo(hits.sticky.target, now);
-                    activity = true;
-                    repaint = true;
-                    return true;
-                }
-                if (overRail && hits.rail !== null) {
-                    const trackRow = event.row - hits.rail.rowStart;
-                    const geometry = hits.rail.geometry;
-                    if (trackRow >= geometry.thumbTop && trackRow < geometry.thumbTop + geometry.thumbHeight) {
-                        this.#dragGrabOffset = trackRow - geometry.thumbTop;
-                        this.#viewport.setRailDragging(true);
-                    }
-                    else {
-                        this.#viewport.scrollTo(scrollForTrackPage(geometry, trackRow, frame.scrollTop, hits.viewportHeight), now);
-                    }
-                    activity = true;
-                    repaint = true;
-                    return true;
-                }
-                if (event.row > hits.viewportHeight) {
-                    // Status, editor, widgets, and footer are controls rather than
-                    // transcript. Consume the complete drag so Pi's fullscreen fallback
-                    // selection cannot paint those rows.
-                    this.#dockPointerSuppressed = true;
-                    return true;
-                }
-                if (event.row >= 1 && event.row <= hits.viewportHeight && event.column <= frame.contentWidth) {
-                    this.#viewport.pressSelection(event.column, event.row, now);
-                    repaint = true;
-                    return true;
-                }
-                return false;
-            }
-            if (event.kind === "release") {
-                if (this.#viewport.releaseSelection()) {
-                    this.#stopSelectionAutoScroll();
-                    repaint = true;
-                    return true;
-                }
-                if (this.#dragGrabOffset !== null) {
-                    this.#dragGrabOffset = null;
-                    this.#viewport.setRailDragging(false);
-                    repaint = true;
-                    return true;
-                }
-                if (this.#dockPointerSuppressed) {
-                    this.#dockPointerSuppressed = false;
-                    return true;
-                }
-            }
-            return false;
-        });
-        if (activity)
-            this.#scheduleViewportActivityExpiry();
-        if (repaint)
-            this.#componentRuntime.requestRender();
-        return routed;
-    }
-    #updateSelectionAutoScroll(column, row, viewportHeight) {
-        const beyondEdge = row <= 1 || row > viewportHeight;
-        if (!beyondEdge) {
-            this.#stopSelectionAutoScroll();
-            return;
-        }
-        this.#selectionAutoScrollPointer = { column, row };
-        if (this.#selectionAutoScrollTimer !== undefined)
-            return;
-        this.#selectionAutoScrollTimer = setTimeout(() => this.#selectionAutoScrollTick(), SELECTION_AUTO_SCROLL_INTERVAL_MS);
-        this.#selectionAutoScrollTimer.unref?.();
-    }
-    #selectionAutoScrollTick() {
-        this.#selectionAutoScrollTimer = undefined;
-        const pointer = this.#selectionAutoScrollPointer;
-        if (pointer === undefined || !this.#viewport.selectionActive) {
-            this.#stopSelectionAutoScroll();
-            return;
-        }
-        const before = this.#viewport.scrollTop;
-        const rowsPerTick = scrollbarSelectionRows(this.#viewportConfig.scrollbarSpeed);
-        for (let row = 0; row < rowsPerTick; row += 1) {
-            const previous = this.#viewport.scrollTop;
-            this.#viewport.extendSelection(pointer.column, pointer.row);
-            if (this.#viewport.scrollTop === previous)
-                break;
-        }
-        if (this.#viewport.scrollTop === before) {
-            this.#stopSelectionAutoScroll();
-            return;
-        }
-        this.#componentRuntime.requestRender();
-        this.#scheduleViewportActivityExpiry();
-        this.#selectionAutoScrollTimer = setTimeout(() => this.#selectionAutoScrollTick(), SELECTION_AUTO_SCROLL_INTERVAL_MS);
-        this.#selectionAutoScrollTimer.unref?.();
-    }
-    #stopSelectionAutoScroll() {
-        if (this.#selectionAutoScrollTimer !== undefined)
-            clearTimeout(this.#selectionAutoScrollTimer);
-        this.#selectionAutoScrollTimer = undefined;
-        this.#selectionAutoScrollPointer = undefined;
-    }
-    #scheduleViewportActivityExpiry() {
-        if (this.#viewportActivityTimer !== undefined)
-            clearTimeout(this.#viewportActivityTimer);
-        this.#viewportActivityTimer = setTimeout(() => {
-            this.#viewportActivityTimer = undefined;
-            this.#componentRuntime.requestRender();
-        }, 925);
-        this.#viewportActivityTimer.unref?.();
+        return this.#viewportController.handlePreInput(data, allowWheel, now);
     }
     #renderDock(width) {
         return this.#renderDockLayout(width).rows;
@@ -409,15 +237,20 @@ export class OwnedUiSessionShellRoot {
     #renderDockLayout(width) {
         const queued = this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width);
         const statusRows = this.#renderStatus(width);
+        const transientRows = [...queued, ...statusRows];
         const aboveWidgets = this.#renderWidgets("aboveEditor", width);
         const input = this.#inputSurface.render(width);
         const belowWidgets = this.#renderWidgets("belowEditor", width);
         const footer = this.#renderFooter(width);
+        const rowsWithoutTransient = [...aboveWidgets, ...input, ...belowWidgets, ...footer];
         return {
-            rows: [...queued, ...statusRows, ...aboveWidgets, ...input, ...belowWidgets, ...footer],
-            rowsWithoutStatus: [...queued, ...aboveWidgets, ...input, ...belowWidgets, ...footer],
-            statusRows,
-            stableBottomRows: aboveWidgets.length + input.length + belowWidgets.length + footer.length,
+            rows: [...transientRows, ...rowsWithoutTransient],
+            rowsWithoutTransient,
+            transientRows,
+            stableBottomRows: rowsWithoutTransient.length,
+            editorOffsetWithTransient: transientRows.length + aboveWidgets.length,
+            editorOffsetWithoutTransient: aboveWidgets.length,
+            inputRows: input.length,
         };
     }
     layoutRoot() {
@@ -501,7 +334,7 @@ export class OwnedUiSessionShellRoot {
                 continue;
             const blockWidth = this.#customViewport
                 && block?.kind === "user"
-                && this.#viewportConfig.scrollbarAppearance !== "hidden"
+                && this.#viewportController.config.scrollbarAppearance !== "hidden"
                 && width > 1
                 ? width - 1
                 : width;
@@ -560,13 +393,19 @@ export class OwnedUiSessionShellRoot {
         const component = this.#transcript.get(id);
         if (component === undefined)
             return [];
+        const render = () => {
+            const rows = component.render(width);
+            if (!this.#customViewport || block?.kind === "user")
+                return rows;
+            return rows.map(row => nativeHyperlinkStyle(row, nativeTranscriptLinkColor));
+        };
         if (block === undefined || block.status !== "finalized")
-            return component.render(width);
+            return render();
         let byWidth = this.#renderedRows.get(id);
         const cached = byWidth?.get(width);
         if (cached?.revision === block.revision)
             return cached.rows;
-        const rows = component.render(width);
+        const rows = render();
         if (byWidth === undefined) {
             byWidth = new Map();
             this.#renderedRows.set(id, byWidth);
@@ -942,11 +781,12 @@ export class OwnedUiSessionShellRoot {
         this.invalidate();
     }
 }
-const SELECTION_AUTO_SCROLL_INTERVAL_MS = 30;
-const ALT_END_INPUTS = new Set(["\u001b[1;3F", "\u001b[4;3~", "\u001b[8;3~"]);
-const ALT_HOME_INPUTS = new Set(["\u001b[1;3H", "\u001b[1;3~", "\u001b[7;3~"]);
 const SCROLLBAR_CELL_RESET = "\u001b[22;23;24;25;27;28;29;39;54;55m";
 const TERMINAL_BACKGROUND = /\u001b\[(?:4[0-9]|10[0-7]|48(?:[;:][0-9;:]*)?)m/g;
+/** Web URLs use link blue; file targets retain A1's cyan interactive accent. */
+function nativeTranscriptLinkColor(text, target) {
+    return piTheme().fg(/^file:/iu.test(target) ? "accent" : "mdLink", text);
+}
 /** Repaint a source prompt with viewport chrome while preserving text, links, and foreground roles. */
 function withoutTerminalBackground(text) {
     return text.replace(TERMINAL_BACKGROUND, "");

package/dist/integrations/pi/{owned-ui → session-ui}/session-shell.d.ts

@@ -16,7 +16,7 @@ export declare class OwnedUiSessionShell {
     waitUntilStopped(): Promise<void>;
     submit(text: string): Promise<AdapterCommandResult>;
     clearOrExit(now?: number): Promise<AdapterCommandResult>;
-    interrupt(): Promise<AdapterCommandResult>;
+    interrupt(now?: number): Promise<AdapterCommandResult>;
     abort(): Promise<AdapterCommandResult>;
     retry(): Promise<AdapterCommandResult>;
     compact(): Promise<AdapterCommandResult>;

package/dist/integrations/pi/{owned-ui → session-ui}/session-shell.js

@@ -2,6 +2,7 @@ import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput } from "../../..
 import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../engine/index.js";
 import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
 import { PiTuiRuntimeAdapter, } from "../tui-runtime/index.js";
+import { preloadSystemClipboard, readSystemClipboardContent, writeSystemClipboardText, } from "./system-clipboard.js";
 import { OwnedUiSessionShellRoot, shellResourceEntries, } from "./session-shell-root.js";
 export { OwnedUiSessionShellRoot } from "./session-shell-root.js";
 export class OwnedUiSessionShell {
@@ -27,6 +28,7 @@ export class OwnedUiSessionShell {
     #unsubscribeSettings;
     #compactionQueue = [];
     #lastClearTime = 0;
+    #lastEscapeTime = 0;
     #activeLoginDialog;
     #sessionGeneration;
     constructor(options) {
@@ -35,14 +37,17 @@ export class OwnedUiSessionShell {
         this.#cwd = options.cwd;
         this.#routeHost = options.routeHost ?? null;
         this.#customViewport = options.sessionLayout === "custom-viewport";
+        if (this.#customViewport && options.clipboard === undefined)
+            preloadSystemClipboard();
         this.#stopped = new Promise(resolve => {
             this.#resolveStopped = resolve;
         });
         let runtime;
+        let pendingClipboardWrite = Promise.resolve();
         this.root = new OwnedUiSessionShellRoot(this.backend.view(), options.cwd, {
             getColumns: () => runtime?.viewport().columns ?? options.terminal?.columns ?? 80,
             getRows: () => runtime?.viewport().rows ?? options.terminal?.rows ?? 24,
-            requestRender: () => runtime?.requestRender(),
+            requestRender: force => runtime?.requestRender(force),
             onSubmit: text => { void this.submit(text); },
             onInterrupt: () => { void this.interrupt(); },
             onClear: () => { void this.clearOrExit(); },
@@ -57,6 +62,23 @@ export class OwnedUiSessionShell {
             onMessageCopy: () => { void this.runWorkflow({ command: "copy", argument: "" }); },
             onFollowUp: () => { void this.queueFollowUp(); },
             onDequeue: () => this.restoreQueuedInput(),
+            onCopyText: text => {
+                runtime?.writeControl(`\u001b]52;c;${Buffer.from(text, "utf8").toString("base64")}\u0007`);
+                const write = options.clipboard === undefined
+                    ? writeSystemClipboardText(text)
+                    : options.clipboard.writeText?.(text) ?? Promise.resolve();
+                pendingClipboardWrite = write.catch(() => { });
+            },
+            readClipboardContent: async () => {
+                await pendingClipboardWrite;
+                if (options.clipboard === undefined)
+                    return readSystemClipboardContent();
+                const image = await options.clipboard.readImage?.();
+                if (image !== null && image !== undefined)
+                    return { kind: "image", ...image };
+                const text = await options.clipboard.readText();
+                return text === null ? null : { kind: "text", text };
+            },
         }, {
             ...options.startup,
             resources: options.startup?.resources ?? shellResourceEntries(this.backend),
@@ -98,7 +120,7 @@ export class OwnedUiSessionShell {
         const applyViewportSettings = () => {
             const snapshot = options.viewportSettings?.snapshot();
             this.root.setViewportConfig(snapshot ?? {
-                scrollbarAppearance: "hover",
+                scrollbarAppearance: "auto",
                 scrollbarStyle: "thin",
                 scrollbarSpeed: "normal",
             });
@@ -182,16 +204,18 @@ export class OwnedUiSessionShell {
         return this.#stopped;
     }
     async submit(text) {
-        const input = text.trim();
-        if (!input)
+        const displayInput = text.trim();
+        if (!displayInput)
             return { outcome: "completed", diagnostic: null };
-        if (input.startsWith("/"))
-            return this.#slashCommand(input);
+        if (displayInput.startsWith("/"))
+            return this.#slashCommand(displayInput);
+        const prepared = this.root.preparePromptSubmission(displayInput);
+        const input = prepared.text.trim();
         if (input.startsWith("!")) {
             const excludeFromContext = input.startsWith("!!");
             const command = input.slice(excludeFromContext ? 2 : 1).trim();
             if (command) {
-                this.root.editor.addToHistory(input);
+                this.root.editor.addToHistory(displayInput);
                 try {
                     const result = await this.backend.executeBashWorkflow(command, excludeFromContext);
                     const workflow = {
@@ -213,20 +237,21 @@ export class OwnedUiSessionShell {
             }
         }
         if (this.view().status.workingMessage?.startsWith("Compacting") === true) {
-            this.root.editor.addToHistory(input);
+            this.root.editor.addToHistory(displayInput);
             this.#compactionQueue.push({ text: input, type: "steer" });
             this.root.appendWorkflowResult({ command: "compact", outcome: "completed", message: `Queued during compaction: ${input}` });
             this.runtime.requestRender();
             return { outcome: "completed", diagnostic: null };
         }
         const type = this.view().lifecycle === "busy" ? "steer" : "prompt";
-        this.root.editor.addToHistory(input);
+        this.root.editor.addToHistory(displayInput);
         this.root.resumeViewportFollowing();
         return this.#execute({
             type,
             correlationId: this.#correlation(type),
             sessionId: this.backend.sessionId,
             text: input,
+            ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
         });
     }
     async clearOrExit(now = Date.now()) {
@@ -237,14 +262,29 @@ export class OwnedUiSessionShell {
         this.runtime.requestRender();
         return { outcome: "completed", diagnostic: null };
     }
-    async interrupt() {
+    async interrupt(now = Date.now()) {
         if (this.view().lifecycle === "busy")
             return this.abort();
-        if (this.root.editor.getText().length > 0) {
+        if (this.root.editor.getText().trim().length > 0) {
             this.root.editor.setText("");
             return { outcome: "completed", diagnostic: null };
         }
-        return { outcome: "rejected", diagnostic: "nothing to interrupt" };
+        // Match Pi: with an empty editor, two escapes inside 500 ms open the
+        // configured session navigator. The first escape intentionally does not
+        // interrupt or mutate the prompt.
+        const action = this.backend.pinnedSettingsSnapshot().doubleEscapeAction;
+        if (action === "none")
+            return { outcome: "rejected", diagnostic: "nothing to interrupt" };
+        if (now - this.#lastEscapeTime < 500) {
+            this.#lastEscapeTime = 0;
+            if (action === "tree")
+                this.showTreeSelector();
+            else
+                this.showForkSelector();
+            return { outcome: "completed", diagnostic: null };
+        }
+        this.#lastEscapeTime = now;
+        return { outcome: "completed", diagnostic: null };
     }
     async abort() {
         return this.#execute(this.#simple("abort"));