@timurproko/a1 0.1.8-dev.299 → 0.1.8-dev.332

package/dist/integrations/pi/engine/workflow-controllers.d.ts

@@ -17,5 +17,5 @@ export declare class PiWorkflowControllerPort implements AgentWorkflowPort {
     listWorkflows(): Promise<readonly AgentWorkflowDescriptor[]>;
     executeWorkflow(workflowId: string, input: AgentJsonValue, signal?: AbortSignal): Promise<AgentJsonValue>;
 }
-export declare const PI_BUILTIN_WORKFLOW_ROUTES: readonly ("name" | "share" | "model" | "login" | "logout" | "settings" | "reload" | "compact" | "new" | "resume" | "quit" | "session" | "scoped-models" | "export" | "import" | "copy" | "changelog" | "hotkeys" | "fork" | "clone" | "tree" | "trust" | "debug" | "arminsayshi" | "dementedelves")[];
+export declare const PI_BUILTIN_WORKFLOW_ROUTES: readonly ("name" | "share" | "model" | "login" | "logout" | "settings" | "reload" | "compact" | "new" | "resume" | "quit" | "session" | "tree" | "scoped-models" | "export" | "import" | "copy" | "changelog" | "hotkeys" | "fork" | "clone" | "trust" | "debug" | "arminsayshi" | "dementedelves")[];
 export declare const PI_WORKFLOW_CAPABILITIES: readonly WorkflowCapability[];

package/dist/integrations/pi/engine/workflows.d.ts

@@ -178,7 +178,7 @@ export interface PiWorkflowHost {
         readonly stdout: string;
         readonly stderr: string;
     }>;
-    readChangelog(): Promise<string>;
+    readChangelog(sinceVersion?: string): Promise<string>;
 }
 export interface PiBashWorkflowResult {
     readonly command: string;

package/dist/integrations/pi/session-ui/prompt-chips.d.ts

@@ -11,7 +11,7 @@ export interface PreparedPrompt {
 /** Owns semantic chips and bounded pending paste references; cancels background work on reset or disposal. */
 export declare class PromptChipStore {
     #private;
-    beginPaste(currentText: string, read: (signal: AbortSignal) => Promise<PiShellClipboardContent | null>, onError: (error: unknown) => void): {
+    beginPaste(currentText: string, read: (signal: AbortSignal) => Promise<PiShellClipboardContent | null>, onError: (error: unknown) => void, onImage?: () => void): {
         marker: string;
         result: Promise<string>;
     };
@@ -21,6 +21,8 @@ export declare class PromptChipStore {
     resetPastes(text: string): string;
     dispose(): Promise<void>;
     transformPastedContent(content: PiShellClipboardContent, currentText?: string): string;
+    /** Hide provisional clipboard identities until the read identifies an actual image. */
+    hiddenRanges(line: string): readonly PiShellEditorTextRange[];
     atomicRanges(line: string): readonly PiShellEditorTextRange[];
     hyperlinkRanges(text: string): readonly {
         start: number;

package/dist/integrations/pi/session-ui/prompt-chips.js

@@ -5,37 +5,45 @@ import { fileURLToPath } from "node:url";
 import { canonicalizeClipboardImage } from "./clipboard-image.js";
 import { assertImageEncodedSize, assertPromptImages, ImageAttachmentError } from "../../../contracts/owned-ui/index.js";
 import { ImagePreparationClient } from "./image-preparation-client.js";
-const CHIP_PATTERN = /\[(?:📷 [^\]]+|📁 [^\]]+|📄 [^\]]+|🖼 {1,2}[^\]]+|🔗 [^\]]+)\]/gu;
+import { prepareTextPaste } from "./text-paste.js";
+const CHIP_PATTERN = /\[(?:paste #\d+ (?:\+\d+ lines|\d+ chars)|📷 [^\]]+|📁 [^\]]+|📄 [^\]]+|🖼 {1,2}[^\]]+|🔗 [^\]]+)\]/gu;
 const IMAGE_EXTENSION = /\.(?:jpe?g|png|webp|gif|bmp|tiff?)$/iu;
 const URL_PATTERN = /^https?:\/\/[^\s\u0000-\u001f\u007f]+$/iu;
 const URL_DISPLAY_LENGTH = 40;
 /** Owns semantic chips and bounded pending paste references; cancels background work on reset or disposal. */
 export class PromptChipStore {
     #chips = new Map();
+    // Invariant: clearing the editor never recycles a recoverable text chip's identity.
+    #textCounter = 0;
     #pending = new Map();
     #preparation = new ImagePreparationClient();
     #stopping = new Set();
-    beginPaste(currentText, read, onError) {
-        const marker = `[📷 preparing-${randomBytes(5).toString("hex")}]`;
+    beginPaste(currentText, read, onError, onImage = () => { }) {
+        const id = randomBytes(5).toString("hex");
+        // Invariant: reserve paste identity immediately, but only display a screenshot after identifying an image.
+        const marker = `[📷 screenshot-${id}]`;
         const job = this.#preparation.start(async (signal) => {
             const content = await read(signal);
             entry.kind = content?.kind === "image" ? "image" : "text";
-            if (content?.kind === "image" && this.#imageCount(currentText) >= 8)
-                throw new ImageAttachmentError("image-count");
+            if (content?.kind === "image") {
+                onImage();
+                if (this.#imageCount(currentText) >= 8)
+                    throw new ImageAttachmentError("image-count");
+            }
             return content;
         });
         const entry = { marker, job, references: 0, kind: "unknown", completion: job.result.then(content => {
                 if (content === null)
                     return "";
                 if (content.kind === "image") {
-                    return this.#addPreparedImage(content);
+                    return this.#addPreparedImage(content, id);
                 }
                 return this.transformPastedContent(content);
             }).catch(error => {
                 entry.error = error instanceof ImageAttachmentError ? error : new ImageAttachmentError("image-codec");
                 if (entry.error.code !== "image-canceled" && entry.references === 0)
                     onError(entry.error);
-                return marker.replace("preparing-", "failed-");
+                return marker.replace("screenshot-", "failed-");
             }).then(replacement => {
                 entry.replacement = replacement;
                 return replacement;
@@ -93,14 +101,23 @@ export class PromptChipStore {
                 entry.job.cancel();
         return remaining;
     }
-    async dispose() { await Promise.all([this.#preparation.dispose(), ...this.#stopping]); }
+    async dispose() {
+        await Promise.all([this.#preparation.dispose(), ...this.#stopping]);
+        this.#chips.clear();
+        this.#pending.clear();
+    }
     #imageCount(text) {
-        const regular = [...this.#chips.values()].filter(chip => chip.kind === "image" && text.includes(chip.tag)).length;
-        return regular + [...this.#pending.values()].filter(entry => entry.kind !== "text" && (text.includes(entry.marker) || text.includes(entry.marker.replace("preparing-", "failed-")))).length;
+        const tags = new Set([...this.#chips.values()].filter(chip => chip.kind === "image" && text.includes(chip.tag)).map(chip => chip.tag));
+        for (const entry of this.#pending.values()) {
+            if (entry.kind !== "text" && (text.includes(entry.marker) || text.includes(entry.marker.replace("screenshot-", "failed-")))) {
+                // Invariant: a ready screenshot can retain its pending label but still occupies only one slot.
+                tags.add(entry.replacement ?? entry.marker);
+            }
+        }
+        return tags.size;
     }
-    #addPreparedImage(image) {
-        const suffix = image.mimeType === "image/jpeg" ? "jpg" : image.mimeType.split("/")[1] ?? "png";
-        const tag = `[📷 screenshot-${randomBytes(5).toString("hex")}${image.transformed ? "-resized" : ""}.${suffix}]`;
+    #addPreparedImage(image, id) {
+        const tag = `[📷 screenshot-${id}${image.transformed ? "-resized" : ""}]`;
         const attachment = Object.freeze({ type: "image", data: image.data, mimeType: image.mimeType });
         assertPromptImages([attachment]);
         this.#chips.set(tag, { kind: "image", tag, image: attachment });
@@ -114,7 +131,7 @@ export class PromptChipStore {
                 return "";
             assertPromptImages([...this.prepareSubmission(currentText).images, { type: "image", ...image }]);
             const id = randomBytes(5).toString("hex");
-            const tag = `[📷 screenshot-${id}.png]`;
+            const tag = `[📷 screenshot-${id}]`;
             this.#chips.set(tag, {
                 kind: "image",
                 tag,
@@ -131,8 +148,14 @@ export class PromptChipStore {
             return this.#recordUnique({ kind: "url", tag: `[🔗 ${label}]`, label, url });
         }
         const paths = pathsFromClipboard(text);
-        if (paths.length === 0)
-            return text;
+        if (paths.length === 0) {
+            const paste = prepareTextPaste(text);
+            if (paste.label === undefined)
+                return paste.text;
+            const tag = `[paste #${++this.#textCounter} ${paste.label}]`;
+            this.#chips.set(tag, Object.freeze({ kind: "text", tag, text: paste.text }));
+            return tag;
+        }
         return paths.map(item => {
             const label = pathLabel(item.fullPath);
             if (item.kind === "folder") {
@@ -142,8 +165,22 @@ export class PromptChipStore {
             return this.#recordUnique({ kind: "file", tag: `[${icon} ${label}]`, path: item.fullPath });
         }).join("");
     }
+    /** Hide provisional clipboard identities until the read identifies an actual image. */
+    hiddenRanges(line) {
+        const ranges = [];
+        for (const entry of this.#pending.values()) {
+            if (entry.kind === "image")
+                continue;
+            let from = 0;
+            while ((from = line.indexOf(entry.marker, from)) >= 0) {
+                ranges.push({ start: from, end: from + entry.marker.length });
+                from += entry.marker.length;
+            }
+        }
+        return ranges.sort((left, right) => left.start - right.start);
+    }
     atomicRanges(line) {
-        return [...line.matchAll(CHIP_PATTERN)].map(match => ({
+        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,
         }));
@@ -172,41 +209,41 @@ export class PromptChipStore {
         return this.#replaceResolvable(text, false).text;
     }
     prepareHistoryText(text) {
-        return this.#replaceResolvable(text, false).text.replace(CHIP_PATTERN, tag => this.#chips.get(tag)?.kind === "image" ? "" : tag).trim();
+        return this.#replaceResolvable(text, false, true).text.trim();
     }
     prepareSubmission(text) {
         const expanded = this.#replaceResolvable(text, true);
         return { text: expanded.text, images: expanded.images };
     }
-    #replaceResolvable(text, includeImages) {
-        let expanded = text;
-        for (const entry of this.#pending.values()) {
-            if (!expanded.includes(entry.marker) && !expanded.includes(entry.marker.replace("preparing-", "failed-")))
-                continue;
-            if (includeImages && entry.error !== undefined)
-                throw entry.error;
-            if (includeImages && entry.replacement === undefined)
-                throw new ImageAttachmentError("image-pending");
-            if (entry.replacement !== undefined)
-                expanded = expanded.replaceAll(entry.marker, entry.replacement);
-        }
+    #replaceResolvable(text, includeImages, omitImages = false) {
         const images = [];
         const seenImages = new Set();
-        for (const match of expanded.matchAll(CHIP_PATTERN)) {
-            const tag = match[0];
+        const resolveChip = (tag) => {
             const chip = this.#chips.get(tag);
             if (chip === undefined)
-                continue;
+                return tag;
+            if (chip.kind === "text")
+                return chip.text;
             if (chip.kind === "image") {
                 if (includeImages && !seenImages.has(tag)) {
                     images.push(chip.image);
                     seenImages.add(tag);
                 }
-                continue;
+                return omitImages ? "" : tag;
             }
-            const value = chip.kind === "url" ? chip.url : chip.path;
-            expanded = expanded.replaceAll(tag, value);
-        }
+            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 entry = this.#pending.get(tag) ?? this.#pending.get(tag.replace("failed-", "screenshot-"));
+            if (entry === undefined)
+                return resolveChip(tag);
+            if (includeImages && entry.error !== undefined)
+                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 { text: expanded, images };
     }
     #recordUnique(chip) {

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

@@ -10,7 +10,6 @@ export declare class PromptHistoryController {
         fallback: readonly string[];
         active(): boolean;
         render(): void;
-        failure(message: string): void;
     };
     constructor(options: {
         editor: PiShellEditorPort;
@@ -19,7 +18,6 @@ export declare class PromptHistoryController {
         fallback: readonly string[];
         active(): boolean;
         render(): void;
-        failure(message: string): void;
     });
     start(): void;
     capture(text: string, kind: PromptHistoryKind, cwd: string, sessionId: string): void;

package/dist/integrations/pi/session-ui/prompt-history-controller.js

@@ -20,11 +20,9 @@ export class PromptHistoryController {
         this.#snapshot = { revision: 0, limit: options.limit, entries: [] };
         this.#fallback = boundedTexts([...options.fallback].reverse(), options.limit);
         this.#unsubscribeSnapshot = this.#subscribeSnapshot();
-        this.#unsubscribeFailure = options.store.onFailure(code => {
+        this.#unsubscribeFailure = options.store.onFailure(() => {
             if (this.#disposed)
                 this.#closeFailed = true;
-            else
-                options.failure(`Prompt history ${code}; current-session recall remains available.`);
         });
         this.#unsubscribe = [
             options.editor.recall.observe(() => {
@@ -57,10 +55,7 @@ export class PromptHistoryController {
             if (this.#snapshot.entries.some(entry => entry.submissionId === id))
                 this.#local.delete(id);
             this.synchronize();
-        }).catch(() => {
-            if (!this.#disposed)
-                this.options.failure("Prompt history unavailable; current-session recall remains available.");
-        });
+        }).catch(() => { });
     }
     rememberRecovery(text) {
         if (this.#disposed || !text.trim())
@@ -111,7 +106,7 @@ export class PromptHistoryController {
                 return;
             this.#snapshot = snapshot;
             for (const [id, entry] of this.#local) {
-                if (entry.committed)
+                if (entry.committed || snapshot.entries.some(saved => saved.submissionId === id))
                     this.#local.delete(id);
             }
             this.synchronize();

package/dist/integrations/pi/session-ui/session-shell-root.d.ts

@@ -70,7 +70,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly getRows: () => number;
         readonly requestRender: (force?: boolean) => void;
         readonly onViewportFrame?: (frame: TranscriptViewportFrame) => void;
-        readonly requestHyperlinkCleanup?: () => void;
+        readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
         readonly enableDockInputReuse?: boolean;
         readonly persistentHistory?: boolean;
         readonly historyEditor?: import("../components/index.js").HistoryEditorConstructor;
@@ -116,6 +116,31 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     applyTranscriptBlock(block: OwnedUiSessionViewModel["transcript"][number]): void;
     render(width: number): readonly string[];
     viewportFrameDescriptor(): TranscriptViewportFrameDescriptor | null;
+    /** Read-only, payload-free evidence; observing a pending frame must never render or repair it. */
+    viewportPresentationEvidence(): {
+        candidate: boolean;
+        candidateRevision: number | null;
+        currentRevision: number;
+        composedRevision: number | null;
+        currentPointer: {
+            readonly column: number;
+            readonly row: number;
+        } | null;
+        composedPointer: {
+            readonly column: number;
+            readonly row: number;
+        } | null;
+        frameId: number | null;
+        bottom: {
+            readonly row: number;
+            readonly columnStart: number;
+            readonly columnEnd: number;
+        } | null;
+        followingEnd: boolean;
+        scrollTop: number;
+        maxScroll: number;
+        cause: "detached" | "initial" | "steady" | "dock-input" | "follow-shift" | "geometry-change" | null;
+    };
     /** Visible non-selectable Steering, alignment, and Working rows, for rendering evidence. */
     viewportTransientTailRowCount(): number;
     hasActiveSelection(): boolean;

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

@@ -1,6 +1,6 @@
 import { PROMPT_GLYPH, backgroundSgrSpan, caretCell, composeSubmittedPromptRows, displayWidth, faint, formatSubmittedPromptTime, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, progressStatusText, submittedPromptLayout, stripAnsi, } from "../../../ui/components/index.js";
 import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../engine/index.js";
-import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, 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, piShellVisibleWidth, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
+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, piShellVisibleWidth, 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 { SessionViewportController } from "./session-viewport-controller.js";
@@ -45,7 +45,8 @@ export class OwnedUiSessionShellRoot {
     #inputSurfaceCoordination = "editor";
     #dockInputReuseEnabled;
     #dockInputCandidate = false;
-    #dockInputSnapshot;
+    // Invariant: receipt-time eligibility is evidence, never authorization for composition-time reuse.
+    #dockInputRevision;
     #visibleViewportSnapshot;
     #fullViewportCompositions = 0;
     #dockOnlyViewportCompositions = 0;
@@ -94,8 +95,9 @@ export class OwnedUiSessionShellRoot {
                     return "";
                 }
             },
-            ...(this.#customViewport ? { beginClipboardPaste: () => this.#promptChips.beginPaste(this.editor.getText(), signal => handlers.readClipboardContent?.(signal) ?? Promise.resolve(null), error => handlers.onPasteRejected?.(error)) } : {}),
+            ...(this.#customViewport ? { beginClipboardPaste: () => this.#promptChips.beginPaste(this.editor.getText(), signal => handlers.readClipboardContent?.(signal) ?? Promise.resolve(null), error => handlers.onPasteRejected?.(error), () => handlers.requestRender()) } : {}),
             editorAtomicRanges: line => this.#promptChips.atomicRanges(line),
+            editorHiddenRanges: line => this.#promptChips.hiddenRanges(line),
             decorateEditorRow: (row, width) => {
                 const plain = stripAnsi(row);
                 const ranges = this.#promptChips.hyperlinkRanges(plain);
@@ -136,7 +138,7 @@ export class OwnedUiSessionShellRoot {
             enabled: this.#customViewport,
             editor: this.editor,
             requestRender: force => this.#componentRuntime.requestRender(force),
-            requestHyperlinkCleanup: () => handlers.requestHyperlinkCleanup?.(),
+            requestHyperlinkCleanup: rows => handlers.requestHyperlinkCleanup?.(rows),
             hasEditorLinks: () => this.#promptChips.hyperlinkRanges(this.editor.getText()).length > 0,
         });
         // Performance: stable painter identities let the neutral viewport retain row-level
@@ -256,6 +258,10 @@ export class OwnedUiSessionShellRoot {
      * walk of the whole transcript.
      */
     applyTranscriptBlock(block) {
+        const current = this.#blocksById.get(block.id);
+        // Invariant: a full-view/final presentation may preempt queued partials. Never revive an older revision.
+        if (current !== undefined && (current.revision > block.revision || current.status === "finalized" && block.status === "live"))
+            return;
         this.#blocksById.set(block.id, block);
         const component = this.#transcript.get(block.id);
         if (component === undefined) {
@@ -289,13 +295,12 @@ export class OwnedUiSessionShellRoot {
         const transientSignature = transientRowsSignature(steeringRows, statusRows);
         const snapshot = this.#visibleViewportSnapshot;
         const dockInputCandidate = this.#dockInputCandidate;
-        const dockInputSnapshot = dockInputCandidate ? this.#dockInputSnapshot : undefined;
-        const dockInputTransientSignature = dockInputCandidate
-            ? dockInputSnapshot?.transientSignature ?? transientSignature
-            : transientSignature;
-        // Invariant: pending Steering and live Working rows share one non-selectable
-        // viewport tail; only non-working status, widgets, input, and footer stay docked.
-        const scrollRows = [...document.rows, ...steeringRows, ...statusRows];
+        // Concurrency: input may change after a keyboard receipt but before its paint.
+        // Capture only the live inputs this composition will actually represent.
+        const viewportRevision = this.#viewportController.presentationRevision;
+        const selectionRevision = this.#viewportController.selectionRevision;
+        const pointerPosition = this.#viewportController.pointerPosition;
+        const inputSurface = this.#inputSurface;
         const dockRows = dock.rows;
         const selectableDocumentRowCount = document.rows.length;
         const dockStartRow = height - dockRows.length + 1;
@@ -311,28 +316,27 @@ export class OwnedUiSessionShellRoot {
             && snapshot !== undefined
             && snapshot.width === width
             && snapshot.height === height
-            && snapshot.documentRows === (dockInputSnapshot?.documentRows ?? scrollRows)
-            && snapshot.transientSignature === dockInputTransientSignature
-            && snapshot.promptAnchors === (dockInputSnapshot?.promptAnchors ?? document.promptAnchors)
+            && snapshot.documentRows === document.rows
+            && snapshot.transientSignature === transientSignature
+            && snapshot.promptAnchors === document.promptAnchors
             && snapshot.dockLength === dockRows.length
-            && snapshot.inputSurface === (dockInputSnapshot?.inputSurface ?? this.#inputSurface)
-            && snapshot.viewportRevision === (dockInputSnapshot?.viewportRevision ?? this.#viewportController.presentationRevision)
-            && snapshot.selectionRevision === (dockInputSnapshot?.selectionRevision ?? this.#viewportController.selectionRevision)
+            && snapshot.inputSurface === inputSurface
+            && snapshot.viewportRevision === viewportRevision
+            && snapshot.selectionRevision === selectionRevision
             ? this.#viewportController.composeDockOnly(dockRows, width, height)
             : null;
-        // Performance: a spinner tick or queue update can race the input-triggered
-        // render. Recompute the complete transient signature before reusing rows.
-        if (frame !== null && dockInputTransientSignature !== transientSignature)
-            frame = null;
         if (frame === null) {
             frame = this.#viewportController.compose({
-                documentRows: scrollRows,
+                // Performance: do not copy the complete document on unchanged dock-only input.
+                // Steering and Working retain their one non-selectable viewport-tail ownership.
+                documentRows: [...document.rows, ...steeringRows, ...statusRows],
                 ...(this.#viewportController.transcriptPointerSelecting
                     ? { paintDocumentRow: heldNativeHyperlinkStyle }
                     : {}),
                 // Invariant: selection and copying stop at the real document tail; Steering,
                 // fitting alignment, and live Working remain transient presentation chrome.
                 selectableDocumentRowCount,
+                ...(document.liveTailStartRow === undefined ? {} : { liveTailStartRow: document.liveTailStartRow }),
                 bottomAlignedTailRowCount: statusRows.length,
                 dockRows,
                 promptAnchors: document.promptAnchors,
@@ -350,13 +354,16 @@ export class OwnedUiSessionShellRoot {
         this.#visibleViewportSnapshot = {
             width,
             height,
-            documentRows: scrollRows,
+            documentRows: document.rows,
             transientSignature,
             promptAnchors: document.promptAnchors,
             dockLength: dockRows.length,
-            inputSurface: this.#inputSurface,
-            viewportRevision: this.#viewportController.presentationRevision,
-            selectionRevision: this.#viewportController.selectionRevision,
+            inputSurface,
+            // Invariant: a callback during composition cannot bless older rows with its
+            // newer revision. Its ordinary pending render will publish the newer state.
+            viewportRevision,
+            selectionRevision: frame.descriptor.selectionRevision,
+            pointerPosition,
         };
         this.#onViewportFrame?.(frame);
         return frame.rows;
@@ -364,6 +371,25 @@ export class OwnedUiSessionShellRoot {
     viewportFrameDescriptor() {
         return this.#viewportController.frame?.descriptor ?? null;
     }
+    /** Read-only, payload-free evidence; observing a pending frame must never render or repair it. */
+    viewportPresentationEvidence() {
+        const frame = this.#viewportController.frame;
+        const snapshot = this.#visibleViewportSnapshot;
+        return {
+            candidate: this.#dockInputCandidate,
+            candidateRevision: this.#dockInputCandidate ? this.#dockInputRevision ?? null : null,
+            currentRevision: this.#viewportController.presentationRevision,
+            composedRevision: snapshot?.viewportRevision ?? null,
+            currentPointer: this.#viewportController.pointerPosition ?? null,
+            composedPointer: snapshot?.pointerPosition ?? null,
+            frameId: frame?.descriptor.frameId ?? null,
+            bottom: frame?.hits.bottom ?? null,
+            followingEnd: frame?.followingEnd ?? true,
+            scrollTop: frame?.scrollTop ?? 0,
+            maxScroll: frame?.maxScroll ?? 0,
+            cause: frame?.descriptor.cause ?? null,
+        };
+    }
     /** Visible non-selectable Steering, alignment, and Working rows, for rendering evidence. */
     viewportTransientTailRowCount() {
         return this.#viewportController.frame?.hits.transientTail.length ?? 0;
@@ -485,6 +511,10 @@ export class OwnedUiSessionShellRoot {
             ...resourceRows,
         ];
         const promptAnchors = [];
+        // Rationale: a block that is still streaming re-renders every row it owns, so the frame
+        // reports where its rows begin. Damage-aware painting uses that to tell a live block's
+        // own reflow apart from a repaint that reaches settled rows.
+        let liveTailStartRow;
         for (let index = 0; index < this.#transcriptOrder.length; index += 1) {
             const id = this.#transcriptOrder[index];
             const block = this.#blocksById.get(id);
@@ -507,6 +537,9 @@ export class OwnedUiSessionShellRoot {
                     rows.push("");
             }
             const firstRow = rows.length;
+            if (liveTailStartRow === undefined && block !== undefined && block.status !== "finalized") {
+                liveTailStartRow = firstRow;
+            }
             rows.push(...blockRows);
             if (block?.kind === "user" && blockRows[0] !== undefined) {
                 promptAnchors.push({
@@ -538,7 +571,7 @@ export class OwnedUiSessionShellRoot {
             text: diagnostic.message,
             payload: {},
         }, width, this.#cwd)));
-        const layout = { rows: Object.freeze(rows), promptAnchors: Object.freeze(promptAnchors) };
+        const layout = { rows: Object.freeze(rows), promptAnchors: Object.freeze(promptAnchors), liveTailStartRow };
         if (this.#extensionHeader === null) {
             this.#documentLayouts.set(width, layout);
             // Performance: the custom viewport commonly probes full width and reserved-rail width.
@@ -606,7 +639,7 @@ export class OwnedUiSessionShellRoot {
         }
         const id = this.#appendAnchoredWorkflowComponent(width => [
             "",
-            ...renderPiShellStatusText(this.#workflowStatusMessages.get(id) ?? message, width, this.#outputPad),
+            ...renderPiShellStatusText(this.#workflowStatusMessages.get(id) ?? message, width),
         ]);
         this.#workflowStatusMessages.set(id, message);
         this.#lastWorkflowStatusId = id;
@@ -617,10 +650,8 @@ export class OwnedUiSessionShellRoot {
             return;
         }
         this.#lastWorkflowStatusId = undefined;
-        const prefix = message.kind === "warning" ? "Warning" : message.kind === "error" ? "Error" : undefined;
-        const color = message.kind === "accent" ? "accent" : message.kind;
-        const text = prefix === undefined ? message.message : `${prefix}: ${message.message}`;
-        this.#appendAnchoredWorkflowComponent(() => ["", ` ${piTheme().fg(color, text)}`]);
+        const presentation = { kind: message.kind, message: message.message };
+        this.#appendAnchoredWorkflowComponent(width => renderPiShellCommandMessage(presentation, width, this.#outputPad));
     }
     appendWorkflowResult(result) {
         if (result.messages !== undefined) {
@@ -642,7 +673,7 @@ export class OwnedUiSessionShellRoot {
         }
         if (result.command === "hotkeys" && result.outcome === "completed") {
             this.#lastWorkflowStatusId = undefined;
-            const hotkeys = createPiShellHotkeys();
+            const hotkeys = createPiShellHotkeys(this.editor.keybindingConfig(), bindings => this.#extensionRenderers.getShortcuts?.(bindings) ?? [], this.#customViewport ? "a1" : "pi");
             this.#appendAnchoredWorkflowComponent(width => hotkeys.render(width), () => hotkeys.dispose?.());
             return;
         }
@@ -661,26 +692,10 @@ export class OwnedUiSessionShellRoot {
         }
         if (result.outcome === "completed" && (result.command === "quit" || result.command === "compact"))
             return;
-        if (result.command === "new" && result.outcome === "completed") {
-            this.appendWorkflowMessage({ kind: "accent", message: result.message });
-            return;
-        }
-        if (result.command === "name" && result.outcome === "completed") {
+        if (result.outcome === "completed" && (result.command === "new" || result.command === "name" || result.command === "debug")) {
             this.#lastWorkflowStatusId = undefined;
-            this.#appendAnchoredWorkflowComponent(() => [
-                ...(result.detail ? ["", ` ${piTheme().fg("warning", `Warning: ${result.detail}`)}`] : []),
-                "",
-                ` ${piTheme().fg("dim", result.message)}`,
-            ]);
-            return;
-        }
-        if (result.command === "debug" && result.outcome === "completed") {
-            this.#lastWorkflowStatusId = undefined;
-            this.#appendAnchoredWorkflowComponent(() => [
-                "",
-                ` ${piTheme().fg("accent", result.message)}`,
-                ...(result.detail ? [` ${piTheme().fg("muted", result.detail)}`] : []),
-            ]);
+            const presentation = { kind: result.command, message: result.message, ...(result.detail === undefined ? {} : { detail: result.detail }) };
+            this.#appendAnchoredWorkflowComponent(width => renderPiShellCommandMessage(presentation, width, this.#outputPad));
             return;
         }
         if (result.command === "arminsayshi" && result.outcome === "completed") {
@@ -785,9 +800,7 @@ export class OwnedUiSessionShellRoot {
             this.appendWorkflowStatus(message);
             return;
         }
-        this.#lastWorkflowStatusId = undefined;
-        const prefix = type === "warning" ? "Warning" : "Error";
-        this.#appendAnchoredWorkflowComponent(() => ["", ` ${piTheme().fg(type, `${prefix}: ${message}`)}`]);
+        this.appendWorkflowMessage({ kind: type, message });
     }
     extensionFooterData() {
         return {
@@ -829,8 +842,7 @@ export class OwnedUiSessionShellRoot {
     handleInput(data) {
         this.#dockInputCandidate = this.#customViewport && this.#dockInputReuseEnabled
             && classifyPiTuiInput(data, this.#inputSurfaceCoordination) === "safe";
-        if (this.#dockInputCandidate)
-            this.#captureDockInputSnapshot();
+        this.#dockInputRevision = this.#dockInputCandidate ? this.#viewportController.presentationRevision : undefined;
         try {
             this.#inputSurface.handleInput?.(data);
         }
@@ -839,23 +851,6 @@ export class OwnedUiSessionShellRoot {
             throw error;
         }
     }
-    #captureDockInputSnapshot() {
-        const width = Math.max(1, this.#componentRuntime.getColumns());
-        const steeringRows = this.#renderQueued(width);
-        const statusRows = this.#renderStatus(width);
-        const transientSignature = transientRowsSignature(steeringRows, statusRows);
-        const snapshot = this.#visibleViewportSnapshot;
-        this.#dockInputSnapshot = snapshot === undefined
-            ? undefined
-            : {
-                documentRows: snapshot.documentRows,
-                transientSignature,
-                promptAnchors: snapshot.promptAnchors,
-                inputSurface: this.#inputSurface,
-                viewportRevision: this.#viewportController.presentationRevision,
-                selectionRevision: this.#viewportController.selectionRevision,
-            };
-    }
     invalidate() {
         this.header.invalidate();
         this.resources.invalidate();
@@ -884,7 +879,7 @@ export class OwnedUiSessionShellRoot {
         this.#documentLayouts.clear();
         this.#visibleViewportSnapshot = undefined;
         this.#dockInputCandidate = false;
-        this.#dockInputSnapshot = undefined;
+        this.#dockInputRevision = undefined;
         if (this.#inputSurface !== this.editor)
             this.#inputSurface.dispose?.();
         this.#extensionHeader?.dispose?.();

package/dist/integrations/pi/session-ui/session-shell.d.ts

@@ -37,7 +37,7 @@ export declare class OwnedUiSessionShell {
     showLoginMethodSelector(providerReference: string): void;
     showTreeSelector(initialSelectedId?: string): void;
     showLoginAuthTypeSelector(): void;
-    showLoginProviderSelector(authType: "oauth" | "api_key"): void;
+    showLoginProviderSelector(authType?: "oauth" | "api_key", initialSearchInput?: string): void;
     showSessionSelector(): void;
     showSettingsSelector(): void;
     shutdown(): Promise<AdapterCommandResult>;