@timurproko/a1 0.1.8-dev.368 → 0.1.8-dev.402

package/dist/integrations/pi/session-ui/session-shell-root.js

@@ -4,7 +4,9 @@ import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } fro
 import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, isPiPromptStyleCompaction, piShellVisibleWidth, piShellTruncateToWidth, piTheme, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
 import { PiTuiRuntimeAdapter, classifyPiTuiInput, } from "../tui-runtime/index.js";
 import { PromptChipStore } from "./prompt-chips.js";
+import { EditorHyperlinkBudget } from "./editor-hyperlink-budget.js";
 import { SessionViewportController } from "./session-viewport-controller.js";
+import { canPreparePasteInline } from "./paste-text-preparation.js";
 /** Composes backend session state into the owned transcript, viewport, editor, and dock presentation. */
 export class OwnedUiSessionShellRoot {
     editor;
@@ -24,7 +26,9 @@ export class OwnedUiSessionShellRoot {
     #queued;
     #extensionRenderers;
     #imageAssets;
-    #promptChips = new PromptChipStore();
+    #promptChips;
+    #editorHyperlinks = new EditorHyperlinkBudget();
+    #pasteFramingId = 0;
     #customViewport;
     #submittedPromptComposer;
     #viewportController;
@@ -64,6 +68,8 @@ export class OwnedUiSessionShellRoot {
     }, sessionLayout = "pinned", imageAssets) {
         this.#view = view;
         this.#customViewport = sessionLayout === "custom-viewport";
+        this.#promptChips = new PromptChipStore({ isolated: this.#customViewport,
+            ...(handlers.pasteDiagnostics === undefined ? {} : { onEvent: handlers.pasteDiagnostics }) });
         this.#submittedPromptComposer = this.#customViewport
             ? {
                 layout: submittedPromptLayout,
@@ -99,13 +105,25 @@ export class OwnedUiSessionShellRoot {
                     return "";
                 }
             },
-            ...(this.#customViewport ? { beginClipboardPaste: () => this.#promptChips.beginPaste(this.editor.getText(), signal => handlers.readClipboardContent?.(signal) ?? Promise.resolve(null), error => handlers.onPasteRejected?.(error), () => handlers.requestRender()) } : {}),
+            ...(this.#customViewport ? {
+                beginClipboardPaste: () => this.#promptChips.beginPaste(this.editor.getText(), handlers.captureClipboardPaste?.() ?? { kind: "provided", read: signal => handlers.readClipboardContent?.(signal) ?? Promise.resolve(null) }, error => handlers.onPasteRejected?.(error), () => handlers.requestRender()),
+                onPasteInput: bytes => {
+                    try {
+                        handlers.pasteDiagnostics?.({ request: --this.#pasteFramingId, phase: "framing", bytes, atMs: performance.now(), pending: 0, transport: "terminal" });
+                    }
+                    catch { /* Invariant: payload-free diagnostics cannot interfere with the input path. */ }
+                },
+                deferTextPaste: text => !canPreparePasteInline(text),
+                beginTextPaste: text => this.#promptChips.beginPaste(this.editor.getText(), { kind: "text", text }, error => handlers.onPasteRejected?.(error)),
+            } : {}),
             editorAtomicRanges: line => this.#promptChips.atomicRanges(line),
             editorHiddenRanges: line => this.#promptChips.hiddenRanges(line),
-            decorateEditorRow: (row, width) => {
+            decorateEditorRow: (row, width, rowIndex) => {
+                if (rowIndex === 0)
+                    this.#editorHyperlinks.reset();
                 const plain = stripAnsi(row);
                 const ranges = this.#promptChips.hyperlinkRanges(plain);
-                if (ranges.length === 0)
+                if (ranges.length === 0 || !this.#editorHyperlinks.takeCleanup())
                     return row;
                 const linkResetAndTail = `\u001b]8;;\u001b\\\u001b[24m${" ".repeat(Math.max(0, width - piShellVisibleWidth(row)))}`;
                 // Platform: VS15 is zero-column and default-ignorable. It breaks Windows Terminal's
@@ -115,7 +133,7 @@ export class OwnedUiSessionShellRoot {
                     : 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);
+                    : ranges.filter(range => this.#editorHyperlinks.take(range.target)).reduce((result, range) => hyperlinkSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), range.target, piShellVisibleWidth), row);
                 // Platform: 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}`;
@@ -611,6 +629,7 @@ export class OwnedUiSessionShellRoot {
                     firstRow,
                     lastRow: Math.max(firstRow, rows.length - 1),
                     sourceRow: pinnedPromptSourceRow(block, blockRows[0], blockWidth),
+                    prominentSourceRow: blockRows[0],
                 });
             }
         }
@@ -1103,7 +1122,7 @@ function nativeTranscriptLinkColor(text, target) {
 function withoutTerminalBackground(text) {
     return text.replace(TERMINAL_BACKGROUND, "");
 }
-/** A pinned timestamp is content now, not secondary transcript metadata. */
+/** Preserve the established prompt foreground for quiet and hovered pinned timestamps. */
 function pinnedPromptSourceRow(block, sourceRow, width) {
     if (typeof block.payload !== "object" || block.payload === null)
         return sourceRow;

package/dist/integrations/pi/session-ui/session-shell.js

@@ -1,3 +1,6 @@
+import { ResponseCopyCoordinator } from "./response-copy-coordinator.js";
+import { createResponseCopyExecutor, hasAsyncClipboardOutput, responseCopyDestination } from "./response-copy-transport.js";
+import { MAX_COPY_CONTROL_BYTES } from "./response-copy-protocol.js";
 import { PromptHistoryController } from "./prompt-history-controller.js";
 import { PRODUCT_TEXT } from "../../../product-identity.js";
 import { boundedCleanup } from "../../../foundation/terminal-cleanup/index.js";
@@ -37,6 +40,8 @@ export class OwnedUiSessionShell {
     #disposed = false;
     #pointerReporting = false;
     #customViewport;
+    #responseCopy;
+    #unbindClipboardWriter;
     #damageTerminal;
     #streamPresentation;
     #removeViewportPreInput;
@@ -72,6 +77,52 @@ export class OwnedUiSessionShell {
         let streamPresentation;
         let pendingClipboardWrite = Promise.resolve();
         let promptSuggestionController = null;
+        const terminalCopy = options.terminal !== undefined || hasAsyncClipboardOutput();
+        this.#responseCopy = this.#customViewport ? new ResponseCopyCoordinator({
+            execute: options.responseCopy?.execute ?? createResponseCopyExecutor({
+                ...(options.terminal === undefined && options.clipboard === undefined ? {} : { destination: "terminal" }),
+                ...(options.clipboard?.writeText === undefined ? {} : { writeText: (text, signal) => options.clipboard.writeText(text, signal) }),
+                ...(terminalCopy ? { terminal: { submit: async (control, signal) => {
+                            if (signal.aborted || this.#disposed || !runtime?.active)
+                                throw new Error("Copy canceled");
+                            // Performance: never grow the real terminal's pending buffer with another clipboard payload.
+                            if (options.terminal === undefined && process.stdout.writableLength + control.length > MAX_COPY_CONTROL_BYTES) {
+                                throw new Error("Clipboard terminal is busy");
+                            }
+                            runtime.writeControl(control);
+                        } } } : {}),
+            }),
+            ...(options.responseCopy?.onEvent === undefined ? {} : { onEvent: options.responseCopy.onEvent }),
+            onFailure: result => {
+                if (this.#disposed || !runtime?.active)
+                    return;
+                this.root.appendWorkflowStatus(result.outcome === "timed-out" ? "Copy timed out; the clipboard did not respond."
+                    : result.failure === "size" ? "Selection exceeds this clipboard route's size limit."
+                        : "Could not copy the selection; the clipboard is unavailable.");
+                runtime.requestRender();
+            },
+        }) : null;
+        const readClipboard = async (signal) => {
+            if (signal.aborted)
+                throw new ImageAttachmentError("image-canceled");
+            if (options.clipboard === undefined)
+                return runImageWorker({ kind: "clipboard" }, signal);
+            try {
+                const image = await options.clipboard.readImage?.(signal);
+                if (image !== null && image !== undefined) {
+                    const canonical = await runImageWorker({ kind: "canonicalize", source: image }, signal);
+                    if (canonical !== null)
+                        return { kind: "image", ...canonical };
+                }
+            }
+            catch (error) {
+                if (error instanceof ImageAttachmentError)
+                    throw error;
+                // Compatibility: an unavailable image reader can still provide text.
+            }
+            const text = await options.clipboard.readText(signal);
+            return text === null ? null : { kind: "text", text };
+        };
         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,
@@ -107,34 +158,35 @@ export class OwnedUiSessionShell {
                 this.#promptHistory?.synchronize();
             },
             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(() => { });
+                if (this.#responseCopy !== null) {
+                    void this.#responseCopy.submitText(text);
+                    return;
+                }
+                const write = () => {
+                    if (this.#disposed)
+                        return Promise.resolve();
+                    runtime?.writeControl(`\u001b]52;c;${Buffer.from(text, "utf8").toString("base64")}\u0007`);
+                    return options.clipboard === undefined ? writeSystemClipboardText(text)
+                        : options.clipboard.writeText?.(text) ?? Promise.resolve();
+                };
+                // Compatibility: comparison profiles retain their existing clipboard path.
+                pendingClipboardWrite = write().catch(() => { });
             },
             readClipboardContent: async (signal = new AbortController().signal) => {
                 await pendingClipboardWrite;
-                if (signal.aborted)
-                    throw new ImageAttachmentError("image-canceled");
-                if (options.clipboard === undefined)
-                    return runImageWorker({ kind: "clipboard" }, signal);
-                try {
-                    const image = await options.clipboard.readImage?.(signal);
-                    if (image !== null && image !== undefined) {
-                        const canonical = await runImageWorker({ kind: "canonicalize", source: image }, signal);
-                        if (canonical !== null)
-                            return { kind: "image", ...canonical };
-                    }
-                }
-                catch (error) {
-                    if (error instanceof ImageAttachmentError)
-                        throw error;
-                    // Compatibility: an unavailable native image reader can still provide clipboard text.
-                }
-                const text = await options.clipboard.readText(signal);
-                return text === null ? null : { kind: "text", text };
+                return readClipboard(signal);
+            },
+            captureClipboardPaste: () => {
+                const before = this.#responseCopy?.capturePasteBarrier() ?? (async () => true);
+                if (options.clipboard !== undefined)
+                    return { kind: "provided", read: readClipboard, before };
+                if (responseCopyDestination(process.env) === "terminal")
+                    return {
+                        kind: "provided", before, read: async () => { throw new ImageAttachmentError("paste-unavailable"); },
+                    };
+                return { kind: "native", before };
             },
+            ...(options.pasteDiagnostics === undefined ? {} : { pasteDiagnostics: options.pasteDiagnostics }),
         }, {
             ...options.startup,
             resources: options.startup?.resources ?? shellResourceEntries(this.backend),
@@ -261,8 +313,8 @@ export class OwnedUiSessionShell {
                     this.runtime.renderNow();
                 }
                 const routed = this.root.handleViewportPreInput(data, true, Date.now(), this.root.usesDefaultInputSurface() && !this.runtime.hasFocusedOverlay());
-                if (routed.copyText !== undefined) {
-                    this.runtime.writeControl(`\u001b]52;c;${Buffer.from(routed.copyText, "utf8").toString("base64")}\u0007`);
+                if (routed.copySelection !== undefined) {
+                    void this.#responseCopy?.submit(routed.copySelection, pendingClipboardWrite);
                 }
                 if (!routed.consumed)
                     return routed.data === data ? undefined : { data: routed.data };
@@ -431,6 +483,14 @@ export class OwnedUiSessionShell {
             if (event.type === "session-lifecycle" && event.lifecycle === "stopped")
                 this.#resolveStopped?.();
         });
+        this.#unbindClipboardWriter = this.#responseCopy === null ? () => { } : this.backend.bindClipboardWriter(async (text) => {
+            const result = await this.#responseCopy.submitText(text);
+            if (result.outcome === "delivered")
+                return true;
+            if (result.outcome === "submitted-unverified")
+                return false;
+            throw new Error(result.outcome === "timed-out" ? "Clipboard delivery timed out" : "Clipboard delivery could not be completed");
+        });
         if (this.backend.view().lifecycle === "stopped")
             this.#resolveStopped?.();
     }
@@ -873,10 +933,15 @@ export class OwnedUiSessionShell {
                     this.runtime.requestRender();
                     return;
                 }
-                void this.backend.copyWorkflowText(text).then(() => {
-                    this.root.appendWorkflowStatus("Copied selected message to clipboard");
+                const generation = this.backend.sessionBindingGeneration;
+                void this.backend.copyWorkflowText(text).then(acknowledged => {
+                    if (this.#disposed || generation !== this.backend.sessionBindingGeneration)
+                        return;
+                    this.root.appendWorkflowStatus(acknowledged ? "Copied selected message to clipboard" : "Submitted selected message to clipboard");
                     this.runtime.requestRender();
                 }).catch(error => {
+                    if (this.#disposed || generation !== this.backend.sessionBindingGeneration)
+                        return;
                     this.root.appendWorkflowResult({ command: "tree", outcome: "failed", message: error instanceof Error ? error.message : String(error) });
                     this.runtime.requestRender();
                 });
@@ -1007,6 +1072,7 @@ export class OwnedUiSessionShell {
         return this.runWorkflow({ command: "quit", argument: "" });
     }
     async runWorkflow(request) {
+        const copyGeneration = request.command === "copy" ? this.backend.sessionBindingGeneration : undefined;
         if (request.command === "login" && request.selection !== undefined) {
             const setup = this.backend.pinnedAmbientAuthentication(request.selection);
             if (setup) {
@@ -1095,6 +1161,9 @@ export class OwnedUiSessionShell {
                 this.runtime.requestRender();
             }
         }
+        if (copyGeneration !== undefined && (this.#disposed || copyGeneration !== this.backend.sessionBindingGeneration)) {
+            return workflowAdapterResult({ command: "copy", outcome: "cancelled", message: "" });
+        }
         if (result.outcome === "requires-selection" && request.command === "model") {
             if (result.messages !== undefined) {
                 for (const message of result.messages)
@@ -1246,6 +1315,7 @@ export class OwnedUiSessionShell {
         if (this.#disposed)
             return;
         this.#disposed = true;
+        this.#responseCopy?.dispose();
         this.#cancelWaitingImages();
         const failures = [];
         const attempt = (action) => { try {
@@ -1274,6 +1344,7 @@ export class OwnedUiSessionShell {
             fullscreenExitText = this.runtime.mode !== "fullscreen" ? ""
                 : exitMode === "resume-hint" ? resumeHint : [exitTranscript, resumeHint].filter(Boolean).join("\n\n");
         });
+        attempt(() => this.#unbindClipboardWriter());
         attempt(() => this.#unbindPiSettings());
         attempt(() => this.#unbindTerminalSettings());
         attempt(() => this.#unbindShutdownSettings());
@@ -1316,6 +1387,7 @@ export class OwnedUiSessionShell {
         this.#streamPresentation.noteImmediatePresentation();
         const view = this.view();
         if (this.backend.sessionGeneration !== this.#sessionGeneration) {
+            this.#responseCopy?.reset();
             this.#cancelWaitingImages();
             this.root.resetPendingPastes();
             this.#promptSuggestions?.invalidate();

package/dist/integrations/pi/session-ui/session-viewport-controller.d.ts

@@ -1,6 +1,6 @@
 import { type PiTuiPointerSurface } from "../tui-runtime/index.js";
 import type { OwnedUiViewportSettings } from "../../../contracts/owned-ui/index.js";
-import { type TranscriptViewportFrame, type TranscriptViewportFrameInput } from "../../../ui/components/index.js";
+import { type SelectionCopySnapshot, type TranscriptViewportFrame, type TranscriptViewportFrameInput } from "../../../ui/components/index.js";
 import type { PiShellEditorPort } from "../components/index.js";
 export interface SessionViewportControllerOptions {
     readonly enabled: boolean;
@@ -13,7 +13,7 @@ export interface SessionViewportControllerOptions {
 export interface SessionViewportInputResult {
     readonly data: string;
     readonly consumed: boolean;
-    readonly copyText?: string;
+    readonly copySelection?: SelectionCopySnapshot;
 }
 /**
  * Owns the stateful interaction policy of the bare-A1 session viewport. The

package/dist/integrations/pi/session-ui/session-viewport-controller.js

@@ -249,11 +249,12 @@ export class SessionViewportController {
                     this.#requestRender();
             }
             else {
-                const copyText = this.#viewport.selectedText();
-                if (copyText !== null && copyText.length > 0) {
+                const copySelection = this.#viewport.captureSelectedText();
+                if (copySelection !== null) {
                     this.#viewport.clearSelection();
+                    this.#stopSelectionAutoScroll();
                     this.#requestRender();
-                    return { data: "", consumed: true, copyText };
+                    return { data: "", consumed: true, copySelection };
                 }
             }
         }

package/dist/integrations/pi/session-ui/system-clipboard.d.ts

@@ -11,10 +11,10 @@ export declare function preloadSystemClipboard(): void;
  * private clipboard module. Failures are deliberately non-fatal: a denied or
  * unavailable clipboard simply makes the paste action a no-op.
  */
-export declare function readSystemClipboardContent(signal?: AbortSignal): Promise<PiShellClipboardContent | null>;
+export declare function readSystemClipboardContent(signal?: AbortSignal, strict?: boolean): Promise<PiShellClipboardContent | null>;
 export declare function readSystemClipboardImage(reader: SystemClipboardImageReader): Promise<{
     readonly data: string;
     readonly mimeType: string;
 } | null>;
-export declare function readSystemClipboardText(signal?: AbortSignal): Promise<string | null>;
+export declare function readSystemClipboardText(signal?: AbortSignal, strict?: boolean): Promise<string | null>;
 export declare function writeSystemClipboardText(text: string): Promise<void>;

package/dist/integrations/pi/session-ui/system-clipboard.js

@@ -15,13 +15,13 @@ export function preloadSystemClipboard() {
  * private clipboard module. Failures are deliberately non-fatal: a denied or
  * unavailable clipboard simply makes the paste action a no-op.
  */
-export async function readSystemClipboardContent(signal) {
+export async function readSystemClipboardContent(signal, strict = false) {
     await pendingClipboardWrite;
     const native = await nativeClipboard();
     if (native !== null) {
         try {
             if (process.platform === "win32" && native.availableFormats().some(isFileDropFormat)) {
-                const files = await readSystemClipboardText(signal);
+                const files = await readSystemClipboardText(signal, strict);
                 if (files !== null)
                     return { kind: "text", text: files };
             }
@@ -35,7 +35,7 @@ export async function readSystemClipboardContent(signal) {
             // Compatibility: fall through to text and platform readers.
         }
     }
-    const text = await readSystemClipboardText(signal);
+    const text = await readSystemClipboardText(signal, strict);
     return text === null ? null : { kind: "text", text };
 }
 export async function readSystemClipboardImage(reader) {
@@ -74,7 +74,7 @@ export async function readSystemClipboardImage(reader) {
     }
     return null;
 }
-export async function readSystemClipboardText(signal) {
+export async function readSystemClipboardText(signal, strict = false) {
     // Concurrency: Ctrl+C/Ctrl+X and Ctrl+V can arrive in adjacent input turns. Serialize the
     // read behind our native write so paste never observes the previous value.
     await pendingClipboardWrite;
@@ -85,6 +85,8 @@ export async function readSystemClipboardText(signal) {
                 const text = await native.getText();
                 if (text.length > 0)
                     return text;
+                if (strict)
+                    return null;
             }
             catch {
                 // Compatibility: fall through to the platform command.
@@ -97,12 +99,17 @@ export async function readSystemClipboardText(signal) {
             "$t=Get-Clipboard -Raw -ErrorAction SilentlyContinue",
             "if ($null -ne $t -and $t.Length -gt 0) {[Console]::Out.Write($t)} else {$f=Get-Clipboard -Format FileDropList -ErrorAction SilentlyContinue; if ($f) {[Console]::Out.Write(($f | ForEach-Object {$_.FullName}) -join [Environment]::NewLine)}}",
         ].join("; ");
-        return execClipboard("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], signal);
+        return execClipboard("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], signal, strict);
     }
     if (process.platform === "darwin")
-        return execClipboard("pbpaste", [], signal);
-    return (await execClipboard("wl-paste", ["--no-newline", "--type", "text"], signal))
-        ?? execClipboard("xclip", ["-selection", "clipboard", "-o"], signal);
+        return execClipboard("pbpaste", [], signal, strict);
+    try {
+        const value = await execClipboard("wl-paste", ["--no-newline", "--type", "text"], signal, strict);
+        if (strict || value !== null)
+            return value;
+    }
+    catch { /* Compatibility: X11 may be available when the Wayland command is not. */ }
+    return execClipboard("xclip", ["-selection", "clipboard", "-o"], signal, strict);
 }
 export function writeSystemClipboardText(text) {
     const write = async () => {
@@ -128,14 +135,22 @@ function nativeClipboard() {
 function isFileDropFormat(format) {
     return /(?:filedrop|hdrop|shell idlist)/iu.test(format);
 }
-function execClipboard(command, args, signal) {
-    return new Promise(resolve => {
+function execClipboard(command, args, signal, strict = false) {
+    if (signal?.aborted)
+        return strict ? Promise.reject(new ImageAttachmentError("paste-timeout")) : Promise.resolve(null);
+    return new Promise((resolve, reject) => {
         execFile(command, args, {
             encoding: "utf8",
             maxBuffer: MAX_CLIPBOARD_BYTES,
             timeout: 5_000,
             windowsHide: true,
+            ...(strict ? { killSignal: "SIGKILL" } : {}),
             ...(signal === undefined ? {} : { signal }),
-        }, (error, stdout) => resolve(error || stdout.length === 0 ? null : stdout));
+        }, (error, stdout) => {
+            if (error && strict)
+                reject(new ImageAttachmentError("paste-unavailable"));
+            else
+                resolve(error || stdout.length === 0 ? null : stdout);
+        });
     });
 }

package/dist/integrations/pi/tui-runtime/adapter.js

@@ -34,7 +34,9 @@ class ComponentBridge {
         this.traceComposition?.("composition-start");
         try {
             const lines = [...this.port.render(width)];
-            const overflow = lines.findIndex(line => visibleWidth(line) > width);
+            // Protocol: Kitty APC carries pixels, not columns. Still validate every ordinary cell
+            // around the payload instead of exempting the entire image-bearing row from width checks.
+            const overflow = lines.findIndex(line => visibleWidth(line.replace(/\u001b_G[^\u001b]*\u001b\\/g, "")) > width);
             if (overflow >= 0) {
                 throw new RangeError(`Pi TUI component row ${overflow} exceeds available width ${width}`);
             }

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

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-09-13T13:11:55.967Z",
+  "builtAt": "2026-09-14T18:48:36.221Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "9db1726bbe3fc2e8292f2ead1e7e9d0fd4d7d0dc9217b372582bf354b0f565dc",

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

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-13T13:12:46.201Z",
+  "builtAt": "2026-09-14T18:48:19.618Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "d8cda6b0c7cb36c0cc41e90802aceebf6c02eaebbc08a83d7d963d2e918dbd7a",

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

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-13T13:12:19.326Z",
+  "builtAt": "2026-09-14T18:49:01.865Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "e6a7be98f08249e90a59466be1c132959a55a80830b000a660724da4d572887a",
+    "sha256": "711c72395a5bd9efb4a302df595a7f38ed4cfafb8968426ebb2ed75a39cf1502",
     "size": 177664
   },
   "provenance": {

package/dist/product-identity.d.ts

@@ -1,4 +1,4 @@
-declare const ENVIRONMENT_KEYS: readonly ["configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "paneId", "probeTrace", "processGuardianPath", "profileHome", "runtimeDir", "startupTrace", "suggestionDiagnostics", "terminalSessionId"];
+declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "paneId", "probeTrace", "processGuardianPath", "profileHome", "runtimeDir", "startupTrace", "suggestionDiagnostics", "terminalSessionId"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile"];
 declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];

package/dist/product-identity.js

@@ -1,6 +1,6 @@
 import rawIdentity from "./product-identity.json" with { type: "json" };
 const ENVIRONMENT_KEYS = [
-    "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint",
+    "clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint",
     "paneId", "probeTrace", "processGuardianPath", "profileHome", "runtimeDir", "startupTrace", "suggestionDiagnostics", "terminalSessionId",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];

package/dist/product-identity.json

@@ -10,6 +10,7 @@
         "temporaryPrefix": "a1-"
     },
     "environment": {
+        "clipboardDiagnostics": "A1_CLIPBOARD_DIAGNOSTICS",
         "configDir": "A1_CONFIG_DIR",
         "dataDir": "A1_DATA_DIR",
         "databasePath": "A1_DATABASE_PATH",

package/dist/ui/components/index.d.ts

@@ -9,6 +9,7 @@ export * from "./mouse.js";
 export * from "./pane.js";
 export * from "./progress-status.js";
 export * from "./revision.js";
+export * from "./selection-copy.js";
 export * from "./scrollbar.js";
 export * from "./shortcuts.js";
 export * from "./spans.js";

package/dist/ui/components/index.js

@@ -9,6 +9,7 @@ export * from "./mouse.js";
 export * from "./pane.js";
 export * from "./progress-status.js";
 export * from "./revision.js";
+export * from "./selection-copy.js";
 export * from "./scrollbar.js";
 export * from "./shortcuts.js";
 export * from "./spans.js";

package/dist/ui/components/selection-copy.d.ts

@@ -0,0 +1,24 @@
+import { type OrderedTextSelection, type TextSelectionLineContent } from "./text-selection.js";
+/** Bound selected-source retention independently of history length and encoded payload size. */
+export declare const MAX_COPY_SOURCE_UNITS: number;
+export declare const MAX_COPY_ROWS = 65536;
+export type SelectionCopyPrompt = "first" | "continuation" | undefined;
+export interface SelectionCopyRow {
+    readonly text: string;
+    readonly prompt?: "first" | "continuation";
+}
+/** Immutable selected rows only; safe to transfer to an isolated text preparer. */
+export interface SelectionCopySnapshot {
+    readonly selection: OrderedTextSelection;
+    readonly revision: number;
+    /** Prompt copy/cut already supplies exact expanded text; do not apply transcript chrome stripping. */
+    readonly literal?: boolean;
+    readonly rows: readonly SelectionCopyRow[];
+    readonly sourceUnits: number;
+    readonly captureMs?: number;
+    readonly rejected?: "size";
+}
+/** Shares the viewport's semantic chrome exclusions with isolated copy preparation. */
+export declare function selectionCopyLineContent(text: string, prompt: SelectionCopyPrompt): TextSelectionLineContent;
+/** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
+export declare function selectionCopyRowText(snapshot: Pick<SelectionCopySnapshot, "selection" | "literal">, row: SelectionCopyRow, index: number): string;

package/dist/ui/components/selection-copy.js

@@ -0,0 +1,39 @@
+import { textSelectionText, usefulTextLineContent } from "./text-selection.js";
+import { stripAnsi } from "./text.js";
+/** Bound selected-source retention independently of history length and encoded payload size. */
+export const MAX_COPY_SOURCE_UNITS = 32 * 1024 * 1024;
+export const MAX_COPY_ROWS = 65_536;
+/** Shares the viewport's semantic chrome exclusions with isolated copy preparation. */
+export function selectionCopyLineContent(text, prompt) {
+    const plain = stripAnsi(text);
+    if (prompt !== undefined) {
+        if (prompt === "first") {
+            const timestamp = /\s+\d{2}:\d{2}\s*$/.exec(plain);
+            if (timestamp !== null)
+                return usefulTextLineContent(plain.slice(0, timestamp.index), 3);
+        }
+        return usefulTextLineContent(plain, 3);
+    }
+    const from = plain.trim().length === 0 || (plain.startsWith(" ") && !plain.startsWith("  ")) ? 2 : 1;
+    if (plain.trim().length === 0)
+        return { from, to: from + 1 };
+    return usefulTextLineContent(plain, from);
+}
+/** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
+export function selectionCopyRowText(snapshot, row, index) {
+    if (snapshot.literal)
+        return row.text;
+    let plain = stripAnsi(row.text);
+    if (row.prompt === "first") {
+        const timestamp = /\s+\d{2}:\d{2}\s*$/.exec(plain);
+        if (timestamp !== null)
+            plain = plain.slice(0, timestamp.index);
+    }
+    const from = row.prompt !== undefined ? 3 : plain.startsWith(" ") && !plain.startsWith("  ") ? 2 : 1;
+    // Performance: trailing chrome is excluded before extraction; full-row copy need not measure every grapheme.
+    plain = plain.trimEnd();
+    return textSelectionText({
+        start: { line: 0, column: index === snapshot.selection.start.line ? snapshot.selection.start.column : 0 },
+        end: { line: 0, column: index === snapshot.selection.end.line ? snapshot.selection.end.column : Number.MAX_SAFE_INTEGER },
+    }, [plain], () => ({ from }));
+}

package/dist/ui/components/spans.d.ts

@@ -2,9 +2,12 @@
  * Replaces the visible columns `[from, to)` of `line` with `span`, preserving
  * the styling before it and re-asserting whatever was still open afterwards, so
  * the tail keeps the colour it had. A wide character straddling either edge is
- * replaced by spaces rather than split.
+ * replaced by spaces rather than split. Opt into the replaced cell's boundary
+ * style for background-preserving overlays; the span still owns its decoration.
  */
-export declare function overlaySpan(line: string, from: number, to: number, span: string): string;
+export declare function overlaySpan(line: string, from: number, to: number, span: string, options?: {
+    readonly inheritStartStyle?: boolean;
+}): string;
 /** Wraps visible columns `[from,to)` in an explicit OSC 8 hyperlink. */
 export declare function hyperlinkSgrSpan(line: string, from: number, to: number, target: string, widthOf?: (text: string) => number): string;
 /** Returns the OSC 8 target painted at a zero-based visible terminal column. */