@timurproko/a1 0.1.8-dev.563 → 0.1.8-dev.573

package/README.md

@@ -24,13 +24,15 @@ npm install -g @timurproko/a1@0.1.8-dev.107
 
 ```sh
 a1                                      # launch A1 (profile: ~/.a1/agent)
-a1 --help                               # show all commands (short form: a1 -h)
-a1 --version                            # show the version (short form: a1 -v)
+a1 help                                 # show all commands
+a1 version                              # show the version
 a1 update                               # install the newest stable release
 a1 update --develop                     # install the current development preview
 a1 update --develop 107                 # install numbered preview 107
 a1 update --develop 0.1.8-dev.107       # install that exact preview
 a1 update --models                      # refresh A1's model catalogs
+a1 update --extensions                  # update every installed package
+a1 update npm:pi-mcp-adapter            # update one package
 ```
 
 Stable builds print only their installed version. Development builds also show the
@@ -47,17 +49,17 @@ Unsupported commands exit quietly without launching anything. The removed
 
 ## Extensions
 
-Pi extension packages install into A1's own profile (`~/.a1/agent`), so bare `a1`
-loads them and `a1 pi` does not. Sources are Pi's: `npm:`, git, or a
-local path.
+Pi-compatible extension packages install into A1's own profile (`~/.a1/agent`), so
+bare `a1` loads them and the `a1 pi` comparison profile does not. Sources use Pi's
+`npm:`, git, or local-path grammar.
 
 ```sh
-a1 pi install npm:pi-mcp-adapter   # install a package
-a1 pi remove npm:pi-mcp-adapter    # remove it (alias: a1 pi uninstall)
-a1 pi list                         # list installed packages
-a1 pi update --extensions          # update every installed package
-a1 pi update npm:pi-mcp-adapter    # update one
-a1 pi update --models              # refresh A1's model catalogs
+a1 install npm:pi-mcp-adapter      # install a package
+a1 remove npm:pi-mcp-adapter       # remove it (alias: a1 uninstall)
+a1 list                            # list installed packages
+a1 update --extensions             # update every installed package
+a1 update npm:pi-mcp-adapter       # update one
+a1 update --models                 # refresh A1's model catalogs
 ```
 
 A1 pins the Pi runtime carried by each release, so Pi self-update forms are refused.

package/dist/app/session-shell/prompt-chips.js

@@ -1,12 +1,11 @@
 import { randomBytes } from "node:crypto";
 import path from "node:path";
 import { canonicalizeClipboardImage } from "./clipboard-image.js";
-import { assertImageEncodedSize, assertPromptImages, ImageAttachmentError } from "../../contracts/owned-ui/index.js";
+import { assertImageEncodedSize, assertPromptImages, canonicalPromptChipMatches, ImageAttachmentError, replaceCanonicalPromptChips, } from "../../contracts/owned-ui/index.js";
 import { ImagePreparationClient } from "./image-preparation-client.js";
 import { preparePasteText } from "./paste-text-preparation.js";
 import { pathChipTag } from "./path-chip-presentation.js";
 import { PastePreparationClient } from "./paste-preparation-client.js";
-const CHIP_PATTERN = /\[(?:paste #\d+ (?:\+\d+ lines|\d+ chars)|📷 [^\]]+|📁 [^\]]+|📄 [^\]]+|🖼 {1,2}[^\]]+|🔗 [^\]]+)\]/gu;
 const URL_SUBSTRING_PATTERN = /https?:\/\/[^\s\u0000-\u001f\u007f\]]+/giu;
 const IMAGE_CHIP_IDENTIFIER_PATTERN = /^\[📷 screenshot-([a-f0-9]+)(?:-resized)?\]$/u;
 const URL_DISPLAY_LENGTH = 40;
@@ -259,10 +258,9 @@ export class PromptChipStore {
         return ranges.sort((left, right) => left.start - right.start);
     }
     atomicRanges(line) {
-        return [...line.matchAll(CHIP_PATTERN)].filter(match => !match[0].startsWith("[paste #") || this.#chips.has(match[0])).map(match => ({
-            start: match.index,
-            end: match.index + match[0].length,
-        }));
+        return canonicalPromptChipMatches(line)
+            .filter(match => !match.text.startsWith("[paste #") || this.#chips.has(match.text))
+            .map(match => ({ start: match.start, end: match.end }));
     }
     hyperlinkRanges(text) {
         const ranges = [];
@@ -306,8 +304,8 @@ export class PromptChipStore {
     imageChipAttachments(text) {
         const results = [];
         const seen = new Set();
-        for (const match of text.matchAll(CHIP_PATTERN)) {
-            const tag = match[0];
+        for (const match of canonicalPromptChipMatches(text)) {
+            const tag = match.text;
             if (seen.has(tag))
                 continue;
             const chip = this.#chips.get(tag);
@@ -338,39 +336,32 @@ export class PromptChipStore {
         // Rationale: resolve image chip tags in-place before further classification. Sidecar hits
         // register a live image chip; misses silently strip the tag (no placeholder, no notice) per
         // the durability contract.
-        CHIP_PATTERN.lastIndex = 0;
-        const resolvedImages = text.replace(CHIP_PATTERN, tag => {
-            const identifier = imageChipIdentifier(tag);
+        const resolvedImages = replaceCanonicalPromptChips(text, match => {
+            const identifier = imageChipIdentifier(match.text);
             if (identifier === null)
-                return tag;
+                return match.text;
             const attachment = resolveImage(identifier);
             if (attachment === null)
                 return "";
-            this.#chips.set(tag, { kind: "image", tag, image: attachment });
-            return tag;
+            this.#chips.set(match.text, { kind: "image", tag: match.text, image: attachment });
+            return match.text;
         });
         // Rationale: split around any surviving image tags so paste-time classification runs on the
         // intervening prose exactly as it would on a fresh clipboard payload, plus a substring URL
         // scan so embedded links become atomic chips even in the middle of surrounding text.
-        CHIP_PATTERN.lastIndex = 0;
         const segments = [];
         let cursor = 0;
-        for (const match of resolvedImages.matchAll(CHIP_PATTERN)) {
-            const index = match.index ?? cursor;
-            if (index > cursor)
-                segments.push(resolvedImages.slice(cursor, index));
-            segments.push(match[0]);
-            cursor = index + match[0].length;
+        for (const match of canonicalPromptChipMatches(resolvedImages)) {
+            if (match.start > cursor)
+                segments.push(resolvedImages.slice(cursor, match.start));
+            segments.push(match.text);
+            cursor = match.end;
         }
         if (cursor < resolvedImages.length)
             segments.push(resolvedImages.slice(cursor));
-        CHIP_PATTERN.lastIndex = 0;
         return segments.map(segment => {
-            if (segment.length === 0 || CHIP_PATTERN.test(segment)) {
-                CHIP_PATTERN.lastIndex = 0;
+            if (segment.length === 0 || canonicalPromptChipMatches(segment).length > 0)
                 return segment;
-            }
-            CHIP_PATTERN.lastIndex = 0;
             // Invariant: preserve original whitespace framing so the concatenated recall value
             // remains stable across rehydration.
             const leading = segment.match(/^\s+/)?.[0] ?? "";
@@ -434,7 +425,8 @@ export class PromptChipStore {
             return chip.kind === "url" ? chip.url : chip.path;
         };
         // Invariant: scan only draft tokens (and resolved reservation tokens), never emitted payloads.
-        const expanded = text.replace(CHIP_PATTERN, tag => {
+        const expanded = replaceCanonicalPromptChips(text, match => {
+            const tag = match.text;
             const entry = this.#pending.get(tag) ?? this.#pending.get(tag.replace("failed-", "screenshot-"));
             if (entry === undefined)
                 return resolveChip(tag);
@@ -442,7 +434,7 @@ export class PromptChipStore {
                 throw entry.error;
             if (includeImages && entry.replacement === undefined)
                 throw new ImageAttachmentError("image-pending");
-            return entry.replacement === undefined ? tag : entry.replacement.replace(CHIP_PATTERN, resolveChip);
+            return entry.replacement === undefined ? tag : replaceCanonicalPromptChips(entry.replacement, replacement => resolveChip(replacement.text));
         });
         return { text: expanded, images };
     }

package/dist/app/session-shell/session-shell-root.d.ts

@@ -229,6 +229,8 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     viewportTransientTailRowCount(): number;
     hasActiveSelection(): boolean;
     setViewportConfig(config: OwnedUiViewportSettings): void;
+    setFullscreenCopyOnSelect(enabled: boolean): void;
+    showCopyAcknowledgement(message: string): void;
     resumeViewportFollowing(): void;
     noteCompletedAssistantMessage(): void;
     /** A new session binding owns new mounts even when it reuses semantic invocation ids. */

package/dist/app/session-shell/session-shell-root.js

@@ -3,7 +3,7 @@ import { caretCell } from "../../ui/components/line-input.js";
 import { PromptInput, promptArrow } from "../../ui/components/prompt-input.js";
 import { composeSubmittedPromptRows, formatSubmittedPromptTime, submittedPromptLayout, } from "../../ui/components/submitted-prompt.js";
 import { backgroundSgrSpan, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, } from "../../ui/components/spans.js";
-import { progressStatusText } from "../../ui/components/progress-status.js";
+import { progressStatusFrame, progressStatusText } from "../../ui/components/progress-status.js";
 import { displayWidth, faint, stripAnsi } from "../../ui/components/text.js";
 import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES } from "../../integrations/pi/engine/workflows.js";
 import { createPiExtensionUiBridge } from "../../integrations/pi/components/shell-extension-ui.js";
@@ -62,6 +62,8 @@ export class OwnedUiSessionShellRoot {
     #lastWorkflowStatusId;
     // Invariant: the notice is dock chrome, never transcript content; the custom viewport alone uses it.
     #dockNotice;
+    #copyAcknowledgement;
+    #copyAcknowledgementTimer;
     #inputSurface;
     #inputSurfaceCoordination = "editor";
     #dockInputReuseEnabled;
@@ -106,10 +108,12 @@ export class OwnedUiSessionShellRoot {
             ...(this.#customViewport ? { getKeybindings: () => this.editor.keybindingConfig() } : {}),
         });
         this.resources = createPiShellLoadedResources(startup.resources ?? [], startup.expanded ?? false);
-        this.#status = createPiShellStatus(view, progressStatusText, handlers);
+        this.#status = createPiShellStatus(view, {
+            text: (message, mode) => progressStatusText(message, mode === "custom-viewport" ? "…" : "..."),
+            frame: progressStatusFrame,
+        }, handlers);
         this.#status.setProgressPresentation(this.#customViewport ? "custom-viewport" : "pinned");
         this.#footer = createPiShellFooter(this.#viewWithExtensionStatuses(view), cwd, this.#customViewport ? "a1" : "pi", () => this.#footerLevel);
-        this.#queued = createPiQueuedInputStatus(view.editor.queuedSubmissions, this.#customViewport ? "custom-viewport" : "pinned");
         this.editor = createPiShellEditor({
             ...handlers,
             keybindingProfile: this.#customViewport ? "a1" : "pi",
@@ -183,6 +187,7 @@ export class OwnedUiSessionShellRoot {
             },
             ...(handlers.onPromptSuggestionAccepted === undefined ? {} : { onPromptSuggestionAccepted: handlers.onPromptSuggestionAccepted }),
         });
+        this.#queued = createPiQueuedInputStatus(view.editor.queuedSubmissions, this.#customViewport ? "custom-viewport" : "pinned", this.#customViewport ? () => this.editor.keybindingConfig() : undefined);
         this.#viewportController = new SessionViewportController({
             enabled: this.#customViewport,
             editor: this.editor,
@@ -371,13 +376,14 @@ export class OwnedUiSessionShellRoot {
         }
         const height = Math.max(0, this.#componentRuntime.getRows());
         const dock = this.#renderDockLayout(width);
-        // Invariant: 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;
+        // Invariant: auto/always own one stable final-column gutter. Every scrollable
+        // surface ends before it; the dock remains full-width and hidden mode returns it.
+        const documentWidth = this.#viewportController.config.scrollbarAppearance === "hidden"
+            ? width
+            : Math.max(1, width - 1);
         const document = this.#renderDocumentLayout(documentWidth);
-        const steeringRows = this.#renderQueued(width);
-        const statusRows = this.#renderStatus(width);
+        const steeringRows = this.#renderQueued(documentWidth);
+        const statusRows = this.#renderStatus(documentWidth);
         const transientSignature = transientRowsSignature(steeringRows, statusRows);
         const snapshot = this.#visibleViewportSnapshot;
         const dockInputCandidate = this.#dockInputCandidate;
@@ -494,6 +500,25 @@ export class OwnedUiSessionShellRoot {
         if (this.#viewportController.setConfig(config))
             this.#documentLayouts.clear();
     }
+    setFullscreenCopyOnSelect(enabled) {
+        this.#viewportController.setCopyOnSelect(enabled);
+    }
+    showCopyAcknowledgement(message) {
+        this.#clearCopyAcknowledgement(false);
+        this.#copyAcknowledgement = message;
+        const timer = setTimeout(() => {
+            if (this.#copyAcknowledgementTimer !== timer)
+                return;
+            this.#copyAcknowledgementTimer = undefined;
+            this.#copyAcknowledgement = undefined;
+            this.#invalidateChrome();
+            this.#componentRuntime.requestRender();
+        }, COPY_ACKNOWLEDGEMENT_DURATION_MS);
+        timer.unref?.();
+        this.#copyAcknowledgementTimer = timer;
+        this.#invalidateChrome();
+        this.#componentRuntime.requestRender();
+    }
     resumeViewportFollowing() {
         this.#viewportController.resumeFollowing();
     }
@@ -534,18 +559,36 @@ export class OwnedUiSessionShellRoot {
         const statusRows = this.#customViewport ? this.#status.renderDock(width) : this.#renderStatus(width);
         const transientRows = [...queued, ...statusRows, ...this.#renderDockNotice(width)];
         const aboveWidgets = this.#renderWidgets("aboveEditor", width);
+        const copyAcknowledgement = this.#renderCopyAcknowledgement(width);
         const input = this.#inputSurface.render(width);
         // Invariant: pointer rows describe the body, not the autocomplete block now preceding it.
         const body = this.usesDefaultInputSurface() ? this.editor.bodyGeometry?.() : undefined;
         const belowWidgets = this.#renderWidgets("belowEditor", width);
         const footer = this.#renderFooter(width);
-        const rowsWithoutTransient = [...aboveWidgets, ...input, ...belowWidgets, ...footer];
+        const rowsWithoutTransient = [...aboveWidgets, ...copyAcknowledgement, ...input, ...belowWidgets, ...footer];
         return {
             rows: [...transientRows, ...rowsWithoutTransient],
-            editorOffset: transientRows.length + aboveWidgets.length + (body?.rowOffset ?? 0),
+            editorOffset: transientRows.length + aboveWidgets.length + copyAcknowledgement.length + (body?.rowOffset ?? 0),
             inputRows: body?.rowCount ?? input.length,
         };
     }
+    #renderCopyAcknowledgement(width) {
+        if (this.#copyAcknowledgement === undefined || width <= 0)
+            return [];
+        const text = piShellTruncateToWidth(this.#copyAcknowledgement, width);
+        return [`${" ".repeat(Math.max(0, width - piShellVisibleWidth(text)))}${piTheme().fg("accent", text)}`];
+    }
+    #clearCopyAcknowledgement(requestRender) {
+        if (this.#copyAcknowledgementTimer !== undefined)
+            clearTimeout(this.#copyAcknowledgementTimer);
+        this.#copyAcknowledgementTimer = undefined;
+        if (this.#copyAcknowledgement === undefined)
+            return;
+        this.#copyAcknowledgement = undefined;
+        this.#invalidateChrome();
+        if (requestRender)
+            this.#componentRuntime.requestRender();
+    }
     #renderDockNotice(width) {
         const notice = this.#dockNotice;
         if (notice === undefined)
@@ -651,12 +694,9 @@ export class OwnedUiSessionShellRoot {
                 continue;
             const promptLike = block !== undefined
                 && (block.kind === "user" || this.#customViewport && isPiPromptStyleCompaction(block));
-            const blockWidth = this.#customViewport
-                && promptLike
-                && this.#viewportController.config.scrollbarAppearance !== "hidden"
-                && width > 1
-                ? width - 1
-                : width;
+            // Invariant: the custom viewport has already removed its rail gutter from this width.
+            // Prompt-like and ordinary blocks therefore share one right content edge.
+            const blockWidth = width;
             const blockRows = this.#blockRows(id, block, blockWidth);
             if (promptLike) {
                 // Compatibility: the first natural prompt gets one breathing row at the document top.
@@ -927,6 +967,7 @@ export class OwnedUiSessionShellRoot {
     }
     resetWorkflowPresentation() {
         this.#dockNotice = undefined;
+        this.#clearCopyAcknowledgement(false);
         for (const id of this.#workflowStatusAnchors.keys()) {
             this.#transcript.get(id)?.dispose?.();
             this.#transcript.delete(id);
@@ -1035,6 +1076,7 @@ export class OwnedUiSessionShellRoot {
         this.#inputSurface.setFocused?.(focused);
     }
     dispose() {
+        this.#clearCopyAcknowledgement(false);
         this.clearViewportPointerState();
         this.#themeUnsubscribe();
         this.header.dispose?.();
@@ -1186,6 +1228,7 @@ export class OwnedUiSessionShellRoot {
         this.invalidate();
     }
 }
+const COPY_ACKNOWLEDGEMENT_DURATION_MS = 1_000;
 const SCROLLBAR_CELL_RESET = "\u001b[22;23;24;25;27;28;29;39;54;55m";
 const KITTY_IMAGE_CONTROL = /\u001b_G[\s\S]*?\u001b\\/g;
 const ITERM_IMAGE_CONTROL = /\u001b]1337;File=[^\u0007]*(?:\u0007|\u001b\\)/g;

package/dist/app/session-shell/session-shell.js

@@ -61,6 +61,7 @@ export class OwnedUiSessionShell {
     #responseCopy;
     // Rationale: only an executor this shell created owns a spare copy helper worth warming and disposing.
     #copyExecutor;
+    #copyIntentSequence = 0;
     #unbindClipboardWriter;
     #damageTerminal;
     #quitOutro;
@@ -235,6 +236,10 @@ export class OwnedUiSessionShell {
             root: this.root,
             mode: tuiMode,
             ...(this.#customViewport ? {
+                // Invariant: the owned shell enables and routes mouse reports itself. Pi's
+                // enclosing fullscreen renderer must never establish a competing white selection.
+                mouse: false,
+                consumeUnhandledMouse: true,
                 onOverlayGeometry: surfaces => this.root.setViewportOverlaySurfaces(surfaces),
                 decorateTerminal: (terminal) => {
                     damageTerminal = new DamageAwareTerminalAdapter(terminal, {
@@ -356,7 +361,17 @@ export class OwnedUiSessionShell {
                 }
                 const routed = this.root.handleViewportPreInput(data, true, Date.now(), this.root.usesDefaultInputSurface() && !this.runtime.hasFocusedOverlay());
                 if (routed.copySelection !== undefined) {
-                    void this.#responseCopy?.submit(routed.copySelection, pendingClipboardWrite);
+                    const snapshot = routed.copySelection;
+                    const acknowledgement = copyAcknowledgement(snapshot);
+                    const intent = ++this.#copyIntentSequence;
+                    void this.#responseCopy?.submit(snapshot, pendingClipboardWrite).then(result => {
+                        if (this.#disposed || !runtime.active || intent !== this.#copyIntentSequence
+                            || result.outcome !== "delivered" && result.outcome !== "submitted-unverified")
+                            return;
+                        if (acknowledgement.hasNonWhitespace) {
+                            this.root.showCopyAcknowledgement(`copied ${acknowledgement.characters} chars to clipboard`);
+                        }
+                    });
                 }
                 if (!routed.consumed)
                     return routed.data === data ? undefined : { data: routed.data };
@@ -378,6 +393,7 @@ export class OwnedUiSessionShell {
         this.root.setEditorPaddingX(initialPiSettings.editorPaddingX);
         this.root.setAutocompleteMaxVisible(initialPiSettings.autocompleteMaxVisible);
         this.root.setOutputPad(initialPiSettings.outputPad);
+        this.root.setFullscreenCopyOnSelect(initialPiSettings.fullscreenCopyOnSelect);
         this.root.setHideThinkingBlock(initialPiSettings.hideThinkingBlock);
         this.root.setMermaidRenderingMode(initialPiSettings.mermaidRenderingMode);
         this.#showImages = initialPiSettings.showImages;
@@ -421,6 +437,11 @@ export class OwnedUiSessionShell {
                     this.#imageWidthCells = value;
                     this.root.setImagePresentation(this.#showImages, this.#imageWidthCells);
                 } },
+            ...(this.#customViewport ? { fullscreenCopyOnSelect: { apply: (value) => {
+                        if (typeof value !== "boolean")
+                            throw new TypeError("Fullscreen copy-on-select setting is invalid");
+                        this.root.setFullscreenCopyOnSelect(value);
+                    } } } : {}),
         });
         if (this.#customViewport && promptHistory !== undefined) {
             this.#promptHistoryImageSidecar = promptHistory.imageSidecar;
@@ -1516,6 +1537,7 @@ export class OwnedUiSessionShell {
     }
     async #dispose() {
         this.#disposed = true;
+        this.#copyIntentSequence += 1;
         // Invariant: the outro frame is what the terminal shows now, before any cleanup writes.
         const outroFrame = this.#captureQuitOutroFrame();
         this.#responseCopy?.dispose();
@@ -1656,6 +1678,7 @@ export class OwnedUiSessionShell {
         this.#streamPresentation.noteImmediatePresentation();
         const view = this.view();
         if (this.backend.sessionGeneration !== this.#sessionGeneration) {
+            this.#copyIntentSequence += 1;
             this.#responseCopy?.reset();
             this.#cancelWaitingImages();
             this.root.resetPendingPastes();
@@ -2072,6 +2095,17 @@ export class OwnedUiSessionShell {
 function isCoalescedStreamBlock(kind) {
     return kind === "assistant" || kind === "thinking" || kind === "tool-call" || kind === "tool-result";
 }
+function copyAcknowledgement(snapshot) {
+    if (snapshot.literal !== true)
+        return { characters: snapshot.sourceUnits, hasNonWhitespace: true };
+    let characters = Math.max(0, snapshot.rows.length - 1);
+    let hasNonWhitespace = false;
+    for (const row of snapshot.rows) {
+        characters += row.text.length;
+        hasNonWhitespace ||= /\S/u.test(row.text);
+    }
+    return { characters, hasNonWhitespace };
+}
 export function formatSessionResumeCommand(metadata) {
     const args = [PRODUCT_TEXT.commandName];
     if (!metadata.usesDefaultSessionDir)

package/dist/app/session-shell/session-viewport-controller.d.ts

@@ -39,6 +39,7 @@ export declare class SessionViewportController {
         readonly column: number;
         readonly row: number;
     } | undefined;
+    setCopyOnSelect(enabled: boolean): void;
     get frame(): TranscriptViewportFrame | null;
     setEditorPointerFrame(frame: {
         readonly rowStart: number;

package/dist/app/session-shell/session-viewport-controller.js

@@ -28,12 +28,14 @@ export class SessionViewportController {
     #inputSurfacePending = false;
     #overlays = [];
     #pointerOwner;
-    // Invariant: a left-button sequence begun in dock chrome remains owned by the dock.
+    // Invariant: a right-click editor gesture remains owned by the dock.
     #dockPointerSuppressed = false;
-    // Invariant: a left-button sequence begun in non-selectable transcript tail chrome is held there.
+    // Invariant: a gesture begun on an explicit control remains owned by that control.
     #tailPointerSuppressed = false;
     // Invariant: editor selection remains true only while its left button is held.
     #editorPointerSelecting = false;
+    // Invariant: no-drag editor presses replay on release; distinct motion promotes frame selection.
+    #pendingEditorClick;
     // Invariant: pointer routing uses the most recently composed editor rows.
     #editorPointerFrame;
     #selectionAutoScrollTimer;
@@ -42,6 +44,7 @@ export class SessionViewportController {
     #hoveredHyperlinkKey;
     #lastRequestedSelectionRevision = -1;
     #presentationRevision = 0;
+    #copyOnSelect = true;
     #activityTimer;
     constructor(options) {
         this.#enabled = options.enabled;
@@ -77,6 +80,9 @@ export class SessionViewportController {
     get pointerPosition() {
         return this.#pointerPosition;
     }
+    setCopyOnSelect(enabled) {
+        this.#copyOnSelect = enabled;
+    }
     get frame() {
         return this.#viewport.frame;
     }
@@ -112,9 +118,19 @@ export class SessionViewportController {
             this.#cancelGesture();
         this.#viewport.setConfig(this.#config);
         const selectionRevision = this.#viewport.selectionRevision;
+        const coveredSurfaces = [
+            ...(this.#overlays ?? []),
+            ...(this.#inputSurface === undefined ? [] : [this.#inputSurface]),
+        ];
+        const coveredCells = coveredSurfaces.flatMap(surface => Array.from({ length: Math.max(0, surface.rowEnd - surface.rowStart + 1) }, (_value, index) => ({
+            row: surface.rowStart + index,
+            columnStart: surface.columnStart,
+            columnEnd: surface.columnEnd,
+        })));
         const frame = this.#viewport.compose({
             ...input,
             ...(this.#pointerPosition === undefined ? {} : { pointerPosition: this.#pointerPosition }),
+            ...(coveredCells.length === 0 ? {} : { coveredCells }),
         });
         // Concurrency: if selection changed during composition, this frame truthfully carries
         // the older revision and exactly one ordinary follow-up render publishes the latest.
@@ -167,6 +183,7 @@ export class SessionViewportController {
         this.#clearActivityTimer();
         this.#stopSelectionAutoScroll();
         this.#editorPointerSelecting = false;
+        this.#pendingEditorClick = undefined;
         this.#editorPointerFrame = undefined;
         this.#pointerPosition = undefined;
         this.#hoveredHyperlinkKey = undefined;
@@ -183,6 +200,7 @@ export class SessionViewportController {
         this.#dockPointerSuppressed = false;
         this.#tailPointerSuppressed = false;
         this.#editorPointerSelecting = false;
+        this.#pendingEditorClick = undefined;
         this.#editorPointerFrame = undefined;
         this.#pointerPosition = undefined;
         this.#hoveredHyperlinkKey = undefined;
@@ -302,6 +320,7 @@ export class SessionViewportController {
         let repaint = false;
         let forceRepaint = false;
         let activity = false;
+        let completedCopy;
         const routed = routeMouseInput(data, (event, report) => {
             const hits = frame.hits;
             const overModal = this.#modalAt(event.column, event.row);
@@ -375,6 +394,10 @@ export class SessionViewportController {
                     return true;
                 if (this.#viewport.selectionActive) {
                     this.#viewport.extendSelection(event.column, event.row, now, false);
+                    if (this.#pendingEditorClick !== undefined
+                        && (event.column !== this.#pendingEditorClick.column || event.row !== this.#pendingEditorClick.row)) {
+                        this.#pendingEditorClick = undefined;
+                    }
                     this.#updateSelectionAutoScroll(event.column, event.row, hits.viewportHeight);
                     activity = true;
                     return true;
@@ -415,17 +438,20 @@ export class SessionViewportController {
                     return false;
                 this.#dockPointerSuppressed = false;
                 this.#tailPointerSuppressed = false;
+                this.#pendingEditorClick = undefined;
                 this.#stopSelectionAutoScroll();
                 if (this.#viewport.clearSelection())
                     repaint = true;
                 if (overBottom) {
                     this.#viewport.scrollToEnd(now);
+                    this.#tailPointerSuppressed = true;
                     activity = true;
                     repaint = true;
                     return true;
                 }
                 if (overSticky && hits.sticky !== null) {
                     this.#viewport.scrollTo(hits.sticky.target, now);
+                    this.#tailPointerSuppressed = true;
                     activity = true;
                     repaint = true;
                     return true;
@@ -439,35 +465,19 @@ export class SessionViewportController {
                     }
                     else {
                         this.#viewport.scrollTo(scrollForTrackPage(geometry, trackRow, frame.scrollTop, hits.viewportHeight), now);
+                        this.#tailPointerSuppressed = true;
                     }
                     activity = true;
                     repaint = true;
                     return true;
                 }
-                if (editorFrame !== undefined && event.row >= editorFrame.rowStart && event.row <= editorFrame.rowEnd) {
-                    const handled = this.#editor.handlePointer({
-                        kind: "press",
-                        button: event.button,
-                        column: event.column,
-                        row: event.row - editorFrame.rowStart + 1,
-                    });
-                    if (!handled)
-                        this.#dockPointerSuppressed = true;
-                    this.#editorPointerSelecting = handled;
-                    repaint = true;
-                    return true;
-                }
-                if (event.row > hits.viewportHeight) {
-                    this.#dockPointerSuppressed = true;
-                    return true;
-                }
-                if (event.row >= 1 && event.row <= hits.viewportHeight && event.column <= frame.contentWidth) {
-                    if (!this.#viewport.pressSelection(event.column, event.row, now)) {
-                        // Invariant: empty rows and transient tail rows must never start Pi selection.
-                        this.#tailPointerSuppressed = true;
-                        repaint = true;
-                        return true;
+                if (event.row >= 1 && event.row <= frame.rows.length && event.column <= frame.descriptor.width) {
+                    if (editorFrame !== undefined && event.row >= editorFrame.rowStart && event.row <= editorFrame.rowEnd) {
+                        this.#pendingEditorClick = { column: event.column, row: event.row };
                     }
+                    // Invariant: frame selection includes transient and dock rows without changing
+                    // semantic ownership; no-drag editor presses replay on release.
+                    this.#viewport.pressSelection(event.column, event.row, now);
                     repaint = true;
                     return true;
                 }
@@ -490,6 +500,17 @@ export class SessionViewportController {
                 }
                 if (this.#viewport.releaseSelection()) {
                     this.#stopSelectionAutoScroll();
+                    const pendingEditorClick = this.#pendingEditorClick;
+                    this.#pendingEditorClick = undefined;
+                    if (pendingEditorClick !== undefined && this.#editorPointerFrame !== undefined) {
+                        this.#viewport.clearSelection();
+                        const editorRow = pendingEditorClick.row - this.#editorPointerFrame.rowStart + 1;
+                        this.#editor.handlePointer({ kind: "press", button: 0, column: pendingEditorClick.column, row: editorRow });
+                        this.#editor.handlePointer({ kind: "release", button: 0, column: pendingEditorClick.column, row: editorRow });
+                    }
+                    else if (this.#copyOnSelect) {
+                        completedCopy = this.#viewport.captureSelectedText() ?? undefined;
+                    }
                     // Platform: restore OSC 8 links only after the held-button selection paint has
                     // ended, then overwrite any terminal-cached hover cells immediately.
                     forceRepaint = true;
@@ -519,7 +540,7 @@ export class SessionViewportController {
             this.#lastRequestedSelectionRevision = this.#viewport.selectionRevision;
             this.#requestRender(forceRepaint);
         }
-        return routed;
+        return completedCopy === undefined ? routed : { ...routed, copySelection: completedCopy };
     }
     #modalAt(column, row) {
         const contains = (surface) => column >= surface.columnStart && column <= surface.columnEnd
@@ -534,13 +555,13 @@ export class SessionViewportController {
             .find(candidate => column - 1 >= candidate.from && column - 1 < candidate.to);
         return range === undefined ? undefined : JSON.stringify([row, range]);
     }
-    #updateSelectionAutoScroll(column, row, viewportHeight) {
-        const beyondEdge = row <= 1 || row > viewportHeight;
+    #updateSelectionAutoScroll(column, row, frameHeight) {
+        const beyondEdge = row <= 1 || row >= frameHeight;
         if (!beyondEdge) {
             this.#stopSelectionAutoScroll();
             return;
         }
-        this.#selectionAutoScrollPointer = { column, row };
+        this.#selectionAutoScrollPointer = { column, row, direction: row <= 1 ? -1 : 1 };
         if (this.#selectionAutoScrollTimer !== undefined)
             return;
         this.#selectionAutoScrollTimer = setTimeout(() => this.#selectionAutoScrollTick(), SELECTION_AUTO_SCROLL_INTERVAL_MS);
@@ -557,7 +578,8 @@ export class SessionViewportController {
         const rowsPerTick = scrollbarSelectionRows(this.#config.scrollbarSpeed);
         for (let row = 0; row < rowsPerTick; row += 1) {
             const previous = this.#viewport.scrollTop;
-            this.#viewport.extendSelection(pointer.column, pointer.row);
+            this.#viewport.scrollBy(pointer.direction);
+            this.#viewport.extendSelection(pointer.column, pointer.row, undefined, false);
             if (this.#viewport.scrollTop === previous)
                 break;
         }

package/dist/cli/dispatch.d.ts

@@ -2,7 +2,7 @@ import { type InteractiveLaunchIntent, type LaunchProfileId, type SessionSelecti
 import type { CliCapabilities } from "./capabilities.js";
 import type { PackageCommandRequest } from "./packages.js";
 import type { SessionContextRequest } from "./session-context.js";
-import { type PackageCliVerb, type PackageSyntaxDiagnostic } from "./package-messages.js";
+import { type PackageCliVerb, type PackageCommandNamespace, type PackageSyntaxDiagnostic } from "./package-messages.js";
 export type UpdateChannel = "stable" | "next";
 export interface CliHandlers {
     readonly launch: (intent: InteractiveLaunchIntent) => Promise<number>;
@@ -25,9 +25,11 @@ export type CliCommand = {
 } | {
     readonly kind: "package-help";
     readonly verb: PackageCliVerb;
+    readonly namespace: PackageCommandNamespace;
 } | {
     readonly kind: "package-error";
     readonly diagnostic: PackageSyntaxDiagnostic;
+    readonly namespace: PackageCommandNamespace;
 } | {
     readonly kind: "launch";
     readonly profileId: LaunchProfileId;