@timurproko/a1 0.2.7-dev.1221 → 0.2.7-dev.1222

package/dist/features/owned-ui/reference-document-selection.js

@@ -0,0 +1,179 @@
+import { COPY_ACKNOWLEDGEMENT_DURATION_MS, copyAcknowledgementText, displayWidth, extendTextSelection, orderedTextSelection, overlaySpan, paintTextSelection, padToWidth, pressTextSelection, releaseTextSelection, stripAnsi, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, truncateToWidth, usefulTextLineContent, } from "../../ui/components/index.js";
+const INTERRUPT = "\u0003";
+class CopyAcknowledgement {
+    #message;
+    #timer;
+    paint(line, finalRow, width, theme) {
+        if (!finalRow || this.#message === undefined || width === 0)
+            return line;
+        const message = truncateToWidth(theme.fg("accent", this.#message), width);
+        return overlaySpan(line, width - displayWidth(message), width, message, { inheritStartStyle: true });
+    }
+    show(characters, requestRender) {
+        this.#message = copyAcknowledgementText(characters);
+        this.#clearTimer();
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            this.#message = undefined;
+            requestRender();
+        }, COPY_ACKNOWLEDGEMENT_DURATION_MS);
+        this.#timer.unref?.();
+        requestRender();
+    }
+    clear() {
+        this.#clearTimer();
+        this.#message = undefined;
+    }
+    #clearTimer() {
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+    }
+}
+/** Selection state for an opted-in read-only reference document. */
+export class ReferenceDocumentSelection {
+    #copyOnSelect;
+    #copyText;
+    #selection;
+    #click;
+    #frame;
+    #acknowledgement = new CopyAcknowledgement();
+    constructor(options) {
+        this.#copyOnSelect = options.copyOnSelect;
+        this.#copyText = options.copyText;
+    }
+    get selecting() {
+        return this.#selection?.selecting === true;
+    }
+    get hasSelection() {
+        return orderedTextSelection(this.#selection) !== undefined;
+    }
+    updateFrame(frame) {
+        const previous = this.#frame;
+        if (this.#selection !== undefined && previous !== undefined && !selectionStillMaps(this.#selection, previous.documentRows, frame.documentRows)) {
+            this.#selection = undefined;
+            this.#click = undefined;
+        }
+        this.#frame = frame;
+    }
+    paintVisibleRow(visibleRow, line, theme) {
+        const frame = this.#frame;
+        const documentRow = frame?.visibleDocumentRows[visibleRow];
+        const ordered = orderedTextSelection(this.#selection);
+        const width = frame?.contentWidth ?? 0;
+        let painted = padToWidth(line, width);
+        if (documentRow !== undefined && ordered !== undefined
+            && documentRow >= ordered.start.line && documentRow <= ordered.end.line) {
+            const from = documentRow === ordered.start.line ? ordered.start.column : 0;
+            const to = documentRow === ordered.end.line ? ordered.end.column : width;
+            painted = paintTextSelection(painted, Math.max(0, from), Math.min(width, to));
+        }
+        return this.#acknowledgement.paint(painted, visibleRow === (frame?.visibleDocumentRows.length ?? 0) - 1, width, theme);
+    }
+    handleInput(data) {
+        if (data === INTERRUPT && this.hasSelection) {
+            this.#submitSelection();
+            this.#selection = undefined;
+            this.#click = undefined;
+            return { consumed: true, cleared: true };
+        }
+        if (this.#selection === undefined)
+            return { consumed: false, cleared: false };
+        this.#selection = undefined;
+        this.#click = undefined;
+        return { consumed: false, cleared: true };
+    }
+    handleMouse(event, requestRender) {
+        const frame = this.#frame;
+        if (frame === undefined)
+            return { consumed: false, changed: false };
+        if (event.kind === "motion" && this.selecting) {
+            const row = documentRowAt(frame, event.row, true);
+            if (row === undefined)
+                return { consumed: true, changed: false };
+            this.#extend(row, event.column);
+            return { consumed: true, changed: true };
+        }
+        if (event.kind === "release" && this.selecting) {
+            this.#selection = releaseTextSelection(this.#selection);
+            const copiedCharacters = this.hasSelection && this.#copyOnSelect() ? this.#submitSelection() : undefined;
+            if (copiedCharacters !== undefined && requestRender !== undefined) {
+                this.#acknowledgement.show(copiedCharacters, requestRender);
+            }
+            return { consumed: true, changed: true };
+        }
+        if (event.kind !== "press" || event.button !== 0)
+            return { consumed: false, changed: false };
+        const row = documentRowAt(frame, event.row, false);
+        if (row === undefined || event.column < 1 || event.column > frame.contentWidth) {
+            const changed = this.#selection !== undefined;
+            this.#selection = undefined;
+            this.#click = undefined;
+            return { consumed: false, changed };
+        }
+        const source = frame.documentRows[row] ?? "";
+        const pressed = pressTextSelection({
+            line: row,
+            column: event.column,
+            contentWidth: frame.contentWidth,
+            lineText: source,
+            lineContent: usefulTextLineContent(source),
+            ...(this.#click === undefined ? {} : { previousClick: this.#click }),
+        });
+        this.#selection = pressed.selection;
+        this.#click = pressed.click;
+        return { consumed: true, changed: true };
+    }
+    clear() {
+        this.#selection = undefined;
+        this.#click = undefined;
+        this.#frame = undefined;
+        this.#acknowledgement.clear();
+    }
+    #extend(row, column) {
+        const selection = this.#selection;
+        const frame = this.#frame;
+        if (selection?.selecting !== true || frame === undefined)
+            return;
+        const targetColumn = selection.fullRow
+            ? textSelectionLineExtendColumn(selection, row, frame.contentWidth)
+            : Math.max(1, Math.min(column, frame.contentWidth));
+        this.#selection = extendTextSelection(selection, selection.fullRow
+            ? { line: row, column: targetColumn }
+            : textSelectionPointAt(row, targetColumn, frame.documentRows[row] ?? ""));
+    }
+    #submitSelection() {
+        const frame = this.#frame;
+        const ordered = orderedTextSelection(this.#selection);
+        if (frame === undefined || ordered === undefined)
+            return undefined;
+        const text = textSelectionText(ordered, frame.documentRows, line => usefulTextLineContent(frame.documentRows[line] ?? "")).trim();
+        if (text.length === 0 || this.#copyText(text) === false)
+            return undefined;
+        return text.length;
+    }
+}
+function documentRowAt(frame, screenRow, clampToDocument) {
+    const visible = frame.visibleDocumentRows;
+    let index = screenRow - frame.bodyRowStart;
+    if (!clampToDocument)
+        return visible[index];
+    index = Math.max(0, Math.min(index, visible.length - 1));
+    if (visible[index] !== undefined)
+        return visible[index];
+    const defined = visible.flatMap(row => row === undefined ? [] : [row]);
+    if (defined.length === 0)
+        return undefined;
+    return screenRow < frame.bodyRowStart ? defined[0] : defined.at(-1);
+}
+function selectionStillMaps(selection, previous, next) {
+    const first = Math.min(selection.anchor.line, selection.head.line);
+    const last = Math.max(selection.anchor.line, selection.head.line);
+    if (last >= previous.length || last >= next.length)
+        return false;
+    for (let line = first; line <= last; line += 1) {
+        if (stripAnsi(previous[line] ?? "") !== stripAnsi(next[line] ?? ""))
+            return false;
+    }
+    return true;
+}

package/dist/features/owned-ui/reference-screen-app.d.ts

@@ -1,4 +1,5 @@
 import type { OwnedUiViewportSettings } from "../../contracts/owned-ui/index.js";
+import { type ReferenceDocumentSelectionOptions } from "./reference-document-selection.js";
 import type { AppHostServices, UiApp } from "../../ui/apps/index.js";
 import { ShortcutRegistry, type PaneInputResult, type PaneMouseEvent, type PaneRect } from "../../ui/components/index.js";
 type Action = "up" | "down" | "page-up" | "page-down" | "first" | "last" | "close";
@@ -26,6 +27,8 @@ export interface ReferenceScreenOptions {
     readonly scrollSettings: () => OwnedUiViewportSettings;
     /** The screen is a resident tab, such as the Changelog tab: it offers no screen-level close. */
     readonly pinned?: boolean;
+    /** Enables owned text selection for document routes that explicitly opt in. */
+    readonly selection?: ReferenceDocumentSelectionOptions;
 }
 /**
  * Presents one read-only document full screen between two accent rules: the bold
@@ -42,6 +45,6 @@ export declare class ReferenceScreenApp implements UiApp {
     onClose(_host: AppHostServices): void;
     render(rect: PaneRect, host: AppHostServices): readonly string[];
     onInput(data: string, host: AppHostServices): PaneInputResult;
-    onMouse(event: PaneMouseEvent, _host: AppHostServices): PaneInputResult;
+    onMouse(event: PaneMouseEvent, host: AppHostServices): PaneInputResult;
 }
 export {};

package/dist/features/owned-ui/reference-screen-app.js

@@ -1,3 +1,4 @@
+import { ReferenceDocumentSelection } from "./reference-document-selection.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
 import { GLOBAL_SCOPE, PLAIN_THEME, RAIL_COLUMNS, ShortcutRegistry, ScrollbarRails, assertNoShortcutConflicts, displayWidth, layoutList, padToWidth, renderGroupHeader, renderShortcutHintsWithClose, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarWheelRows, truncateToWidth, withScrollbarRail, } from "../../ui/components/index.js";
 const SCOPE = "reference-screen";
@@ -49,6 +50,7 @@ export class ReferenceScreenApp {
     #document;
     #scrollSettings;
     #pinned;
+    #selection;
     #scroll = 0;
     #interruptArmed = false;
     #failure = null;
@@ -58,7 +60,6 @@ export class ReferenceScreenApp {
     #rails = new ScrollbarRails();
     // Rationale: the rail as drawn in the last frame, or null when nothing can be pointed at.
     #railFrame = null;
-    #bodyHeight = 0;
     // Invariant: a scroll lights the rail until this time; the timer repaints once it has passed.
     #activeUntil = 0;
     #activityTimer;
@@ -69,6 +70,7 @@ export class ReferenceScreenApp {
         this.#document = options.document;
         this.#scrollSettings = options.scrollSettings;
         this.#pinned = options.pinned === true;
+        this.#selection = options.selection === undefined ? undefined : new ReferenceDocumentSelection(options.selection);
     }
     onActivate(host) {
         const ready = this.#document.ready;
@@ -85,6 +87,7 @@ export class ReferenceScreenApp {
     onClose(_host) {
         this.#clearActivityTimer();
         this.#rails.clear();
+        this.#selection?.clear();
     }
     render(rect, host) {
         const theme = host.theme ?? PLAIN_THEME;
@@ -93,9 +96,9 @@ export class ReferenceScreenApp {
         const reservesRail = settings.scrollbarAppearance !== "hidden";
         const contentWidth = reservesRail ? Math.max(0, rect.width - RAIL_COLUMNS) : rect.width;
         const bodyHeight = Math.max(0, rect.height - HEADER_ROWS - FOOTER_ROWS);
-        this.#bodyHeight = bodyHeight;
         const content = this.#content(contentWidth, theme);
         const body = [];
+        const visibleDocumentRows = [];
         let contentLength;
         let viewportLength = bodyHeight;
         if (content.kind === "sections") {
@@ -115,10 +118,22 @@ export class ReferenceScreenApp {
             for (let index = this.#scroll; index < this.#scroll + bodyHeight; index++) {
                 const row = content.rows[index] ?? "";
                 body.push(displayWidth(row) > contentWidth ? truncateToWidth(row, contentWidth) : row);
+                visibleDocumentRows.push(index < content.rows.length ? index : undefined);
             }
         }
         while (body.length < bodyHeight)
             body.push("");
+        while (visibleDocumentRows.length < bodyHeight)
+            visibleDocumentRows.push(undefined);
+        this.#selection?.updateFrame({
+            bodyRowStart: HEADER_ROWS + 1,
+            contentWidth,
+            documentRows: content.kind === "flat" ? content.rows : [],
+            visibleDocumentRows,
+        });
+        const paintedBody = this.#selection === undefined
+            ? body
+            : body.map((row, index) => this.#selection.paintVisibleRow(index, row, theme));
         const now = Date.now();
         // Rationale: every way of scrolling ends in this frame, so a moved document is noticed here
         // once rather than at each wheel, drag, and key branch.
@@ -138,7 +153,7 @@ export class ReferenceScreenApp {
         this.#railFrame = reservesRail && geometry !== null
             ? { rail: { key: this.id, column: rect.width, rowStart: HEADER_ROWS, trackHeight: geometry.trackHeight }, geometry, page: viewportLength }
             : null;
-        const withRail = withScrollbarRail(body.slice(0, bodyHeight), geometry, contentWidth, theme, { presentation });
+        const withRail = withScrollbarRail(paintedBody.slice(0, bodyHeight), geometry, contentWidth, theme, { presentation });
         const hint = this.#interruptArmed
             ? theme.fg("dim", " press ctrl+c again to exit a1")
             : renderShortcutHintsWithClose(this.#hintEntries(), theme, rect.width, 1);
@@ -150,11 +165,19 @@ export class ReferenceScreenApp {
         return frame.slice(0, rect.height).concat(Array(Math.max(0, rect.height - frame.length)).fill(""));
     }
     onInput(data, host) {
+        const explicitCopy = data === "\u0003" ? this.#selection?.handleInput(data) : undefined;
+        if (explicitCopy?.consumed === true)
+            return { consumed: true };
         const action = REFERENCE_SCREEN_SHORTCUTS.resolve(KEYS[data] ?? data, SCOPE);
-        if (action === null)
+        if (action === null) {
+            const cleared = explicitCopy?.cleared ?? (this.#selection?.handleInput(data).cleared === true);
+            if (cleared)
+                host.requestRender();
             return { consumed: false };
+        }
         switch (action) {
             case "close":
+                this.#selection?.handleInput(data);
                 if (!this.#pinned)
                     host.close();
                 return { consumed: true };
@@ -165,10 +188,10 @@ export class ReferenceScreenApp {
                 this.#scrollBy(1);
                 return { consumed: true };
             case "page-up":
-                this.#scrollBy(-Math.max(1, this.#bodyHeight));
+                this.#scrollBy(-Math.max(1, host.getSize().height - HEADER_ROWS - FOOTER_ROWS));
                 return { consumed: true };
             case "page-down":
-                this.#scrollBy(Math.max(1, this.#bodyHeight));
+                this.#scrollBy(Math.max(1, host.getSize().height - HEADER_ROWS - FOOTER_ROWS));
                 return { consumed: true };
             case "first":
                 this.#scroll = 0;
@@ -178,17 +201,25 @@ export class ReferenceScreenApp {
                 return { consumed: true };
         }
     }
-    onMouse(event, _host) {
+    onMouse(event, host) {
         if (event.kind === "wheel-up" || event.kind === "wheel-down") {
             // Invariant: the whole screen owns wheel scrolling; it must not depend on the pointer's row.
             const distance = scrollbarWheelRows(this.#scrollSettings().scrollbarSpeed);
             this.#scrollBy(event.kind === "wheel-down" ? distance : -distance);
             return { consumed: true };
         }
+        if (this.#selection?.selecting === true) {
+            const selection = this.#selection.handleMouse(event, () => host.requestRender());
+            if (selection.consumed)
+                return { consumed: true, render: selection.changed };
+        }
         const rail = this.#railPointer(event);
         if (rail.owned)
             return { consumed: true };
-        return { consumed: event.kind !== "motion", render: rail.changed };
+        const selection = this.#selection?.handleMouse(event, () => host.requestRender());
+        if (selection?.consumed === true)
+            return { consumed: true, render: selection.changed || rail.changed };
+        return { consumed: event.kind !== "motion", render: selection?.changed === true || rail.changed };
     }
     // Rationale: the rail takes its share of a pointer report first: hover, a thumb drag, or a
     // track page. Owned means the document must not see the report; changed means the rail looks different.

package/dist/features/owned-ui/settings-app.d.ts

@@ -22,6 +22,7 @@ export declare class SettingsApp implements UiApp {
         readonly searchInputFactory: SettingsSearchInputFactory;
         readonly copyText?: (text: string) => void;
         readonly configurePlusMenu?: (() => boolean) | null;
+        readonly dialogPanel?: (text: string) => string;
     });
     onActivate(host: AppHostServices): void;
     onClose(_host: AppHostServices): void;

package/dist/features/owned-ui/settings-app.js

@@ -1,5 +1,5 @@
 import { DIALOG_BACK_SHORTCUT_HINT, DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
-import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, numericValues, RAIL_COLUMNS, renderDialogPanel, renderSteppedDialogPanel, renderEmptyState, renderGroupHeader, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, formatLocalTime, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
+import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, numericValues, RAIL_COLUMNS, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, renderEmptyState, renderGroupHeader, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, formatLocalTime, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
 import { PLUS_MENU_SETTING_ID, PlusMenuDialog } from "./plus-menu-dialog.js";
 import { SETTINGS_APP_ID } from "./settings-route.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
@@ -125,7 +125,11 @@ export class SettingsApp {
      */
     constructor(session, options) {
         this.#session = session;
-        this.#options = { pinned: options.pinned === true, configurePlusMenu: options.configurePlusMenu ?? null };
+        this.#options = {
+            pinned: options.pinned === true,
+            configurePlusMenu: options.configurePlusMenu ?? null,
+            dialogPanel: options.dialogPanel ?? null,
+        };
         this.#search = {
             input: null,
             scrollBefore: null,
@@ -148,12 +152,11 @@ export class SettingsApp {
     }
     render(rect, host) {
         const theme = host.theme ?? PLAIN_THEME;
-        const rows = this.#rows();
-        const selected = indexOfKey(rows, this.#selectedKey);
+        const rows = this.#rows(), selected = indexOfKey(rows, this.#selectedKey);
         const footer = this.#footerLines(rect.width, theme);
-        // Invariant: the shared search input and structured panel each begin with their own standard rule.
-        // That rule replaces the ordinary content/footer divider instead of stacking beneath it.
-        const dividerRows = this.#search.input === null && this.#structured === null ? SETTINGS_FOOTER_DIVIDER_ROWS : 0;
+        // Invariant: search owns its ruled footer. Configure dialogs float over the complete ordinary
+        // Settings frame, so the standing divider and guidance remain visible in the dimmed backdrop.
+        const dividerRows = this.#search.input === null ? SETTINGS_FOOTER_DIVIDER_ROWS : 0;
         const topRows = Math.min(SETTINGS_TOP_RULE_ROWS, rect.height);
         const contentHeight = Math.max(0, rect.height - topRows - dividerRows - footer.length);
         let titleRows = this.#scroll <= 0 ? Math.min(SETTINGS_TITLE_ROWS, contentHeight) : 0;
@@ -246,7 +249,8 @@ export class SettingsApp {
         });
         const rule = theme.fg("border", "─".repeat(Math.max(0, rect.width)));
         const frame = this.#withMenu([rule, ...withRail, ...(dividerRows === 0 ? [] : [rule]), ...footer], selected, layout, valueColumn, theme, rect, reservesRail ? RAIL_COLUMNS : 0);
-        return frame.slice(0, rect.height).concat(Array(Math.max(0, rect.height - frame.length)).fill(""));
+        const complete = frame.slice(0, rect.height).concat(Array(Math.max(0, rect.height - frame.length)).fill("")), open = this.#structured, dialogTheme = this.#options.dialogPanel === null ? theme : { ...theme, panel: this.#options.dialogPanel };
+        return open === null ? complete : renderCenteredDialogOverlay(complete, this.#dialogLines(open, configureDialogWidth(rect.width), rect.height, dialogTheme), rect, dialogTheme);
     }
     onInput(data, host) {
         if (data === "\u0003" && this.#search.input === null)
@@ -983,9 +987,9 @@ export class SettingsApp {
         this.#menuFrame = frame;
         return renderValueMenu(lines, state, frame, theme);
     }
-    #dialogLines(open, width, theme) {
+    #dialogLines(open, width, height, theme) {
         if (open.modelDialog)
-            return this.#modelDialogLines(open, width, theme);
+            return this.#modelDialogLines(open, width, height, theme);
         if (open.plusMenu !== null)
             return open.plusMenu.lines(open.record, width, theme);
         const rows = open.flags.map(key => {
@@ -997,9 +1001,10 @@ export class SettingsApp {
                 ...(declared?.description === undefined ? {} : { description: declared.description }),
             };
         });
-        return renderDialogPanel({ title: labelOf(open.entry), rows, index: open.index, hint: SETTINGS_SHORTCUTS.hintEntries(DIALOG_SCOPE) }, width, theme);
+        const visible = dialogWindow(rows, open.index, configureDialogChoiceCapacity(height, false, configureDialogTextRows(rows[open.index]?.description ?? "", width)));
+        return renderDialogPanel({ title: labelOf(open.entry), rows: visible.rows, index: visible.index, hint: SETTINGS_SHORTCUTS.hintEntries(DIALOG_SCOPE) }, width, theme);
     }
-    #modelDialogLines(open, width, theme) {
+    #modelDialogLines(open, width, height, theme) {
         if (open.step === "model") {
             const flags = this.#filteredModelFlags(open);
             const stored = structuredValue(open.entry, open.record);
@@ -1009,12 +1014,13 @@ export class SettingsApp {
                     ...modelLabelParts(flag.label ?? humanizeLabel(flag.key)),
                     value: stored[flag.key] === undefined ? "" : String(stored[flag.key]),
                 }));
-            const visible = dialogWindow(allRows, open.index, 10);
+            const description = "Select a model to configure";
+            const visible = dialogWindow(allRows, open.index, configureDialogChoiceCapacity(height, true, configureDialogTextRows(description, width)));
             return renderSteppedDialogPanel({
                 title: "Thinking Level",
                 step: 1,
                 steps: 2,
-                description: "Select a model to configure",
+                description,
                 ...(open.filter === null ? {} : { input: open.filter }),
                 rows: visible.rows,
                 index: visible.index,
@@ -1027,21 +1033,19 @@ export class SettingsApp {
             label: choice.value === current ? `✓ ${choice.label}` : choice.label,
             value: choice.description,
         }));
-        const visible = dialogWindow(allRows, open.index, 10);
+        const description = `Select default thinking level for ${selected?.label ?? open.modelKey ?? "model"}`;
+        const visible = dialogWindow(allRows, open.index, configureDialogChoiceCapacity(height, false, configureDialogTextRows(description, width)));
         return renderSteppedDialogPanel({
             title: "Thinking Level",
             step: 2,
             steps: 2,
-            description: `Select default thinking level for ${selected?.label ?? open.modelKey ?? "model"}`,
+            description,
             rows: visible.rows,
             index: visible.index,
             hint: MODEL_SHORTCUTS.hintEntries(MODEL_LEVEL_SCOPE),
         }, width, theme);
     }
     #footerLines(width, theme) {
-        const open = this.#structured;
-        if (open !== null)
-            return this.#dialogLines(open, width, theme);
         // Rationale: standing guidance is more useful than transient feedback; failures still
         // roll back without displacing the Settings interaction contract.
         const entries = SETTINGS_SHORTCUTS.hintEntries(SCOPE).filter(entry => !this.#options.pinned

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -67,7 +67,7 @@ class PromptSelectionInterceptor {
     #lastClick;
     #redoStack = [];
     #selectionRevision = 0;
-    #pasteGeneration = 0;
+    #pasteState = { generation: 0, preview: undefined };
     #terminalPaste;
     #wordDirection;
     #geometry;
@@ -81,6 +81,7 @@ class PromptSelectionInterceptor {
         installAtomicSegmentation(editor, options.atomicRanges, () => this.#wordDirection);
     }
     handleInput(data, next) {
+        this.#pasteState.preview = undefined;
         if (this.options.pasteEnabled === false ? discardTerminalPaste(this, data, value => this.handleInput(value, next)) : this.#handleTerminalPaste(data, next))
             return;
         if (this.keybindings.matches(data, "owned.editor.selectAll")) {
@@ -195,7 +196,26 @@ class PromptSelectionInterceptor {
             this.#redoStack = [];
     }
     render(width, next) {
+        const preview = this.#pasteState.preview;
         const state = editorState(this.editor);
+        if (preview !== undefined && this.editor.getText() === preview.reservedText
+            && this.#selectionRevision === preview.revision
+            && samePosition(this.#cursor(), preview.reservedCursor)
+            && this.#selection === undefined) {
+            // Invariant: painting does not commit the reserved edit.
+            const original = { lines: [...state.lines], cursor: this.#cursor(), selection: this.#selection };
+            this.#pasteState.preview = undefined;
+            try {
+                this.#setRenderState(preview.lines, preview.cursor);
+                this.#selection = preview.selection;
+                return this.render(width, next);
+            }
+            finally {
+                this.#setRenderState(original.lines, original.cursor);
+                this.#selection = original.selection;
+                this.#pasteState.preview = preview;
+            }
+        }
         const hidden = state.lines.map(line => this.options.hiddenRanges?.(line) ?? []);
         if (!hidden.some(ranges => ranges.length > 0))
             return this.#renderVisible(width, next);
@@ -277,6 +297,7 @@ class PromptSelectionInterceptor {
         return rows.map((row, index) => this.options.decorateRow(row, width, index));
     }
     reset() {
+        this.#pasteState.preview = undefined;
         this.#selection = undefined;
         this.#pointerSelecting = false;
         this.#lastClick = undefined;
@@ -285,7 +306,8 @@ class PromptSelectionInterceptor {
         this.#selectionRevision += 1;
     }
     cancelPendingPastes() {
-        this.#pasteGeneration += 1;
+        this.#pasteState.generation += 1;
+        this.#pasteState.preview = undefined;
         this.#terminalPaste = undefined;
         DISABLED_TERMINAL_PASTES.delete(this);
     }
@@ -309,6 +331,14 @@ class PromptSelectionInterceptor {
     handlePointer(event) {
         if (event.button !== 0)
             return false;
+        if (this.#pasteState.preview !== undefined) {
+            this.#pasteState.preview = undefined;
+            // Invariant: preview coordinates cannot address a hidden marker.
+            this.#geometry = undefined;
+            this.#pointerSelecting = event.kind === "press";
+            this.#requestRender();
+            return true;
+        }
         if (event.kind === "press")
             return this.#pointerPress(event.column, event.row);
         if (event.kind === "motion") {
@@ -539,17 +569,30 @@ class PromptSelectionInterceptor {
         const begin = source === undefined ? this.options.beginClipboardPaste
             : this.options.beginTextPaste === undefined ? undefined : () => this.options.beginTextPaste(source);
         if (begin !== undefined) {
-            const generation = this.#pasteGeneration;
+            const generation = this.#pasteState.generation;
             const restore = this.#orderedSelection() === undefined ? "" : this.#selectedText();
             const paste = begin();
             this.#redoStack = [];
-            if (this.#orderedSelection() !== undefined)
+            const selected = this.#orderedSelection();
+            if (selected !== undefined) {
+                const lines = [...editorState(this.editor).lines];
+                const cursor = this.#cursor();
+                const selection = this.#selection;
+                const current = this.editor.getText();
+                const from = positionOffset(lines, selected.start);
+                const to = positionOffset(lines, selected.end);
+                const reservedText = current.slice(0, from) + normalizeInsertedText(paste.marker) + current.slice(to);
                 this.#replaceSelection(paste.marker);
+                this.#pasteState.preview = { marker: paste.marker, reservedText, lines, cursor, selection,
+                    reservedCursor: this.#cursor(), revision: this.#selectionRevision };
+            }
             else
                 this.editor.insertTextAtCursor(paste.marker);
             this.#requestRender();
             const replace = (text) => {
-                if (generation === this.#pasteGeneration)
+                if (this.#pasteState.preview?.marker === paste.marker)
+                    this.#pasteState.preview = undefined;
+                if (generation === this.#pasteState.generation)
                     this.#replacePasteMarker(paste.marker, paste.isCurrent?.() === false ? restore : text || restore);
                 paste.complete?.();
             };

package/dist/integrations/pi/engine/workflow-runner.js

@@ -443,7 +443,7 @@ export class PiWorkflowRunner {
             case "copy": {
                 const text = requireCapability(session.getLastAssistantText, "getLastAssistantText").call(session);
                 if (typeof text !== "string" || text.length === 0)
-                    return workflowResult(request.command, "failed", "No agent messages to copy yet.");
+                    return workflowResult(request.command, "completed", "", undefined, "silent");
                 const acknowledged = await this.copyWorkflowText(text);
                 return workflowResult(request.command, "completed", acknowledged ? "Copied last agent message to clipboard" : "Submitted last agent message to clipboard");
             }

package/dist/native/darwin-arm64/manifest.json

@@ -7,7 +7,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:16:03.705Z",
+  "builtAt": "2026-10-28T17:55:49.435Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "a87eaaffcd986b624c8b044b756446cc1bdaf4334a1775b97820542fe34f9fb7",

package/dist/native/darwin-arm64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "arm64",
   "target": "aarch64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:18:47.307Z",
+  "builtAt": "2026-10-28T17:59:01.060Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "2c9107be459d3cce4f154eb34fd839b34d784a82b280d9f56896908d1e7cb1bf",
-    "size": 6001744
+    "sha256": "5f1a93ca9a050c2769a4e322f4d765b00f2ccc9451bcde7ac978b573ee544bef",
+    "size": 6019328
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/native/darwin-x64/manifest.json

@@ -7,7 +7,7 @@
   "platform": "darwin",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:16:10.391Z",
+  "builtAt": "2026-10-28T17:55:56.614Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "783a65f0de287a1c02cd5429dbe97bc8633f4cc8a7b92e3e961180b9bdcff814",

package/dist/native/darwin-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:20:46.993Z",
+  "builtAt": "2026-10-28T18:01:29.016Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "b3dfb167c40179f65bb381bfd701f97bce42ee99bf935ae98c99e4a5bd4c7f01",
-    "size": 6552896
+    "sha256": "5b2b2de17a50a371271c32546cc3c89bc6b16a96c39a534174fe5bb4ca1d60d6",
+    "size": 6562120
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/native/linux-x64/manifest.json

@@ -7,7 +7,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:15:51.475Z",
+  "builtAt": "2026-10-28T17:55:36.629Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "118e5954e3864672bd8482ab7edf419cb27dcdf2533720316979b7f5cc5a53a5",