@timurproko/a1 0.1.8-dev.572 → 0.1.8-dev.581

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

@@ -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;
@@ -374,16 +376,20 @@ 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;
+        const copyAcknowledgement = this.#renderCopyAcknowledgement(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;
+        // Invariant: paint-only feedback may cover either viewport or dock cells, so
+        // ordinary dock-only reuse cannot safely omit its overlay composition.
+        const dockInputCandidate = this.#dockInputCandidate && copyAcknowledgement === undefined;
         // Concurrency: input may change after a keyboard receipt but before its paint.
         // Capture only the live inputs this composition will actually represent.
         const inputSurface = this.#inputSurface;
@@ -441,6 +447,12 @@ export class OwnedUiSessionShellRoot {
                 // Invariant: the control belongs immediately above the complete dock and
                 // floats over transient viewport content rather than consuming a dock row.
                 bottomControlRow: Math.max(0, height - Math.min(height, dockRows.length) - 1),
+                ...(copyAcknowledgement === undefined || height <= 0 ? {} : {
+                    frameOverlay: {
+                        row: Math.max(1, Math.min(height, dockStartRow + dock.inputOffset - 1)),
+                        text: copyAcknowledgement,
+                    },
+                }),
                 theme: this.#viewportTheme,
             });
             this.#fullViewportCompositions += 1;
@@ -497,6 +509,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();
     }
@@ -543,12 +574,30 @@ export class OwnedUiSessionShellRoot {
         const belowWidgets = this.#renderWidgets("belowEditor", width);
         const footer = this.#renderFooter(width);
         const rowsWithoutTransient = [...aboveWidgets, ...input, ...belowWidgets, ...footer];
+        const inputOffset = transientRows.length + aboveWidgets.length;
         return {
             rows: [...transientRows, ...rowsWithoutTransient],
-            editorOffset: transientRows.length + aboveWidgets.length + (body?.rowOffset ?? 0),
+            inputOffset,
+            editorOffset: inputOffset + (body?.rowOffset ?? 0),
             inputRows: body?.rowCount ?? input.length,
         };
     }
+    #renderCopyAcknowledgement(width) {
+        if (this.#copyAcknowledgement === undefined || width <= 0)
+            return undefined;
+        return piTheme().fg("accent", piShellTruncateToWidth(this.#copyAcknowledgement, width));
+    }
+    #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)
@@ -654,12 +703,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.
@@ -930,6 +976,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);
@@ -1038,6 +1085,7 @@ export class OwnedUiSessionShellRoot {
         this.#inputSurface.setFocused?.(focused);
     }
     dispose() {
+        this.#clearCopyAcknowledgement(false);
         this.clearViewportPointerState();
         this.#themeUnsubscribe();
         this.header.dispose?.();
@@ -1189,6 +1237,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, {
@@ -357,11 +362,15 @@ export class OwnedUiSessionShell {
                 const routed = this.root.handleViewportPreInput(data, true, Date.now(), this.root.usesDefaultInputSurface() && !this.runtime.hasFocusedOverlay());
                 if (routed.copySelection !== undefined) {
                     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
+                        if (this.#disposed || !runtime.active || intent !== this.#copyIntentSequence
                             || result.outcome !== "delivered" && result.outcome !== "submitted-unverified")
                             return;
-                        runtime.showFlash(`Copied ${snapshot.sourceUnits} character${snapshot.sourceUnits === 1 ? "" : "s"} to clipboard`);
+                        if (acknowledgement.hasNonWhitespace) {
+                            this.root.showCopyAcknowledgement(`copied ${acknowledgement.characters} chars to clipboard`);
+                        }
                     });
                 }
                 if (!routed.consumed)
@@ -384,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;
@@ -427,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;
@@ -1522,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();
@@ -1662,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();
@@ -2078,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

@@ -44,6 +44,7 @@ export class SessionViewportController {
     #hoveredHyperlinkKey;
     #lastRequestedSelectionRevision = -1;
     #presentationRevision = 0;
+    #copyOnSelect = true;
     #activityTimer;
     constructor(options) {
         this.#enabled = options.enabled;
@@ -79,6 +80,9 @@ export class SessionViewportController {
     get pointerPosition() {
         return this.#pointerPosition;
     }
+    setCopyOnSelect(enabled) {
+        this.#copyOnSelect = enabled;
+    }
     get frame() {
         return this.#viewport.frame;
     }
@@ -504,7 +508,7 @@ export class SessionViewportController {
                         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 {
+                    else if (this.#copyOnSelect) {
                         completedCopy = this.#viewport.captureSelectedText() ?? undefined;
                     }
                     // Platform: restore OSC 8 links only after the held-button selection paint has

package/dist/contracts/owned-ui/index.d.ts

@@ -5,6 +5,8 @@ export type { OwnedUiBlockStatus, OwnedUiCommand, OwnedUiCommandOutcome, OwnedUi
 export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifecycle.js";
 export { ImageAttachmentError, MAX_CLIPBOARD_TEXT_BYTES, MAX_IMAGE_DATA_BYTES, MAX_PROMPT_IMAGES, assertImageEncodedSize, assertPromptImages, } from "./image-attachments.js";
 export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCandidate } from "./prompt-suggestions.js";
+export { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
+export type { PromptChipTextMatch, PromptChipWrapProtection } from "./prompt-chips.js";
 export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
 export type { SuggestionDecision, SuggestionDecisionReason, SuggestionDiagnosticEvent, SuggestionDiagnosticObserver, SuggestionDiagnosticRecord, } from "./suggestion-diagnostics.js";
 export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";

package/dist/contracts/owned-ui/index.js

@@ -3,6 +3,7 @@ export { OWNED_UI_CONTRACT_VERSION } from "./model.js";
 export { acceptsTranscriptUpdate, transcriptToolState } from "./transcript-lifecycle.js";
 export { ImageAttachmentError, MAX_CLIPBOARD_TEXT_BYTES, MAX_IMAGE_DATA_BYTES, MAX_PROMPT_IMAGES, assertImageEncodedSize, assertPromptImages, } from "./image-attachments.js";
 export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCandidate } from "./prompt-suggestions.js";
+export { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
 export { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
 export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
 export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";

package/dist/contracts/owned-ui/prompt-chips.d.ts

@@ -0,0 +1,15 @@
+export interface PromptChipTextMatch {
+    readonly text: string;
+    readonly start: number;
+    readonly end: number;
+}
+export interface PromptChipWrapProtection {
+    readonly text: string;
+    restore(rendered: string): string;
+}
+/** Finds canonical prompt-chip labels without requiring their process-local backing values. */
+export declare function canonicalPromptChipMatches(text: string): readonly PromptChipTextMatch[];
+/** Replaces only canonical prompt-chip labels while preserving every intervening source byte. */
+export declare function replaceCanonicalPromptChips(text: string, replacement: (match: PromptChipTextMatch) => string): string;
+/** Protects fitting chip labels for Markdown wrapping and restores their exact visible source text. */
+export declare function protectPromptChipWrapping(text: string): PromptChipWrapProtection;

package/dist/contracts/owned-ui/prompt-chips.js

@@ -0,0 +1,59 @@
+const PROMPT_CHIP_PATTERN = /\[(?:paste #\d+ (?:\+\d+ lines|\d+ chars)|📷 [^\]]+|📁 [^\]]+|📄 [^\]]+|🖼 {1,2}[^\]]+|🔗 [^\]]+)\]/gu;
+const ZERO_WIDTH_MARKERS = ["\u2060", "\u200b", "\u200c", "\u200d", "\ufeff"];
+/** Finds canonical prompt-chip labels without requiring their process-local backing values. */
+export function canonicalPromptChipMatches(text) {
+    return [...text.matchAll(PROMPT_CHIP_PATTERN)].map(match => ({
+        text: match[0], start: match.index, end: match.index + match[0].length,
+    }));
+}
+/** Replaces only canonical prompt-chip labels while preserving every intervening source byte. */
+export function replaceCanonicalPromptChips(text, replacement) {
+    return text.replace(PROMPT_CHIP_PATTERN, (value, offset) => replacement({
+        text: value, start: offset, end: offset + value.length,
+    }));
+}
+/** Protects fitting chip labels for Markdown wrapping and restores their exact visible source text. */
+export function protectPromptChipWrapping(text) {
+    const matches = canonicalPromptChipMatches(text);
+    if (matches.length === 0)
+        return { text, restore: identity };
+    const spaceMarker = unusedPrivateMarker(text);
+    const boundaryMarker = unusedZeroWidthMarker(text);
+    let protectedText = "", cursor = 0;
+    for (const match of matches) {
+        protectedText += text.slice(cursor, match.start);
+        // Rationale: adjacent chips need a temporary break opportunity or Markdown treats the complete run as one word.
+        if (match.start === cursor && cursor > 0)
+            protectedText += `${boundaryMarker} `;
+        protectedText += match.text.replaceAll(" ", spaceMarker);
+        cursor = match.end;
+    }
+    protectedText += text.slice(cursor);
+    return {
+        text: protectedText,
+        restore: rendered => rendered
+            .replaceAll(`${boundaryMarker} `, "")
+            .replaceAll(boundaryMarker, "")
+            .replaceAll(spaceMarker, " "),
+    };
+}
+function unusedPrivateMarker(text) {
+    for (let codePoint = 0xe000; codePoint <= 0xf8ff; codePoint++) {
+        const marker = String.fromCodePoint(codePoint);
+        if (!text.includes(marker))
+            return marker;
+    }
+    throw new Error("Prompt chip text exhausts the private presentation marker range");
+}
+function unusedZeroWidthMarker(text) {
+    for (const marker of ZERO_WIDTH_MARKERS)
+        if (!text.includes(marker))
+            return marker;
+    for (const left of ZERO_WIDTH_MARKERS) {
+        for (const right of ZERO_WIDTH_MARKERS)
+            if (!text.includes(left + right))
+                return left + right;
+    }
+    throw new Error("Prompt chip text exhausts the zero-width presentation marker range");
+}
+function identity(value) { return value; }

package/dist/contracts/owned-ui/validation.js

@@ -353,7 +353,7 @@ export function assertOwnedUiStatusView(status) {
     assertBoundedText(status.title, "owned-UI status title", MAX_LABEL_LENGTH);
     assertOptionalText(status.workingMessage, "owned-UI working message", MAX_MESSAGE_LENGTH);
     if (status.workingProgress !== undefined && status.workingProgress !== null) {
-        assertIntegerInRange(status.workingProgress, 0, 99, "owned-UI working progress");
+        assertIntegerInRange(status.workingProgress, 0, 100, "owned-UI working progress");
     }
     assertCollection(status.diagnostics, "owned-UI status diagnostics", MAX_STATUS_DIAGNOSTICS);
     for (const diagnostic of status.diagnostics) {

package/dist/integrations/pi/components/index.d.ts

@@ -10,6 +10,7 @@ export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeIns
 export type { PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
 export type { PiThemeRuntimePort, PiThemeSettingsPort } from "./upstream/theme/theme-controller.js";
+export { PI_MODAL_CONTENT_PADDING_X, PiModalFrame, PiModalHeader, addPiModalHeader, adoptPiModalFrame, adoptPiModalHeader, } from "./modal-frame.js";
 export { ModelsDialogComponent } from "./models-dialog.js";
 export type { ModelsDialogCallbacks, ModelsDialogConfig, ModelsDialogFilter, ModelsDialogModel } from "./models-dialog.js";
 export { CountdownTimer } from "./upstream/components/countdown-timer.js";

package/dist/integrations/pi/components/index.js

@@ -5,6 +5,7 @@ export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, compone
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
+export { PI_MODAL_CONTENT_PADDING_X, PiModalFrame, PiModalHeader, addPiModalHeader, adoptPiModalFrame, adoptPiModalHeader, } from "./modal-frame.js";
 export { ModelsDialogComponent } from "./models-dialog.js";
 export { CountdownTimer } from "./upstream/components/countdown-timer.js";
 export { ExtensionEditorComponent } from "./upstream/components/extension-editor.js";

package/dist/integrations/pi/components/modal-frame.d.ts

@@ -0,0 +1,41 @@
+import { Container, type Component } from "@earendil-works/pi-tui";
+export declare const PI_MODAL_CONTENT_PADDING_X = 1;
+/** The semantic top rule/title pair used while a modal assembles its frame. */
+export declare class PiModalHeader implements Component {
+    readonly rule: Component;
+    readonly title: Component;
+    constructor(rule: Component, title: Component);
+    invalidate(): void;
+    render(width: number): string[];
+}
+/**
+ * Complete framed-modal chrome. Rules remain frame-wide; every semantic content component renders
+ * in the same one-cell-smaller rectangle and receives the same left inset.
+ */
+export declare class PiModalFrame implements Component {
+    #private;
+    constructor(topRule: Component, content: readonly Component[], bottomRule: Component, fullWidthContent?: readonly Component[], preInsetContent?: readonly Component[]);
+    invalidate(): void;
+    render(width: number): string[];
+}
+/** Add compact titled-modal chrome while a component assembles its semantic body. */
+export declare function addPiModalHeader(container: Container, rule: Component, title: Component): PiModalHeader;
+export interface PiModalFrameAdoption {
+    readonly topIndex: number;
+    readonly bottomIndex: number;
+    readonly header?: PiModalHeader;
+    readonly fullWidthContent?: readonly Component[];
+    /** Public pinned children that already own the same one-cell outer inset. */
+    readonly preInsetContent?: readonly Component[];
+}
+/**
+ * Replace explicitly identified structural modal children with the shared padded frame. Callers
+ * identify semantic rules/components; rendered text is never inspected or rewritten.
+ */
+export declare function adoptPiModalFrame(container: Container, adoption: PiModalFrameAdoption): PiModalFrame;
+/**
+ * Adopt a public component's semantic rule/title children at the bare-A1 boundary. Only an optional
+ * structural Spacer between those explicitly identified children is accepted; rendered text is
+ * never inspected or rewritten. The pinned comparison profile does not call this adapter.
+ */
+export declare function adoptPiModalHeader(container: Container, ruleIndex: number, titleIndex: number): PiModalHeader;