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

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

@@ -15,27 +15,32 @@ export class PromptChipStore {
     #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;
@@ -95,12 +100,17 @@ export class PromptChipStore {
     }
     async dispose() { await Promise.all([this.#preparation.dispose(), ...this.#stopping]); }
     #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 +124,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,
@@ -142,6 +152,20 @@ 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 => ({
             start: match.index,
@@ -181,7 +205,7 @@ export class PromptChipStore {
     #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-")))
+            if (!expanded.includes(entry.marker) && !expanded.includes(entry.marker.replace("screenshot-", "failed-")))
                 continue;
             if (includeImages && entry.error !== undefined)
                 throw entry.error;

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

@@ -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);
@@ -289,13 +291,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 +312,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 +350,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 +367,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 +507,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 +533,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 +567,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 +635,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 +646,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 +669,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 +688,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") {
-            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") {
+        if (result.outcome === "completed" && (result.command === "new" || result.command === "name" || result.command === "debug")) {
             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 +796,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 +838,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 +847,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 +875,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>;

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

@@ -139,6 +139,7 @@ export class OwnedUiSessionShell {
         }, this.backend.agentDir, {
             getMessageRenderer: customType => this.backend.pinnedMessageRenderer(customType),
             getToolDefinition: toolName => this.backend.pinnedToolDefinition(toolName),
+            getShortcuts: bindings => this.backend.pinnedShortcutDescriptions(bindings),
         }, options.sessionLayout, {
             resolve: assetId => this.backend.resolveTranscriptImage(assetId),
         });
@@ -237,6 +238,17 @@ export class OwnedUiSessionShell {
             ? this.runtime.addPreInputListener(data => {
                 if (options.inputPresentation?.coordination === false)
                     this.#streamPresentation.noteImmediatePresentation();
+                // Compatibility: Pi's fullscreen renderer also intercepts plain Home/End.
+                // Deliver them to the focused owned input before that outer scroll handler;
+                // overlays retain Pi's normal dispatch, and comparison profiles never enter here.
+                if (!this.runtime.hasOverlay() && (this.root.editor.matchesTerminalKey(data, "home")
+                    || this.root.editor.matchesTerminalKey(data, "end"))) {
+                    if (this.root.usesDefaultInputSurface())
+                        this.root.handleViewportPreInput(data, true);
+                    this.root.handleInput(data);
+                    this.runtime.requestRender();
+                    return { consume: true };
+                }
                 // Invariant: an overlay or editor-replacement screen owns its entire pointer
                 // surface. Letting the transcript pre-router inspect those reports
                 // steals settings value menus and numeric +/- controls before the
@@ -793,8 +805,7 @@ export class OwnedUiSessionShell {
     showLoginMethodSelector(providerReference) {
         const method = this.backend.pinnedLoginMethodOptions(providerReference);
         if (method.options.length === 0) {
-            this.root.appendWorkflowResult({ command: "login", outcome: "failed", message: `No authentication methods available for ${providerReference}` });
-            this.runtime.requestRender();
+            this.showLoginProviderSelector(undefined, providerReference);
             return;
         }
         if (method.options.length === 1) {
@@ -836,6 +847,20 @@ export class OwnedUiSessionShell {
             initialFilterMode: context.filterMode,
             ...(initialSelectedId === undefined ? {} : { initialSelectedId }),
             onLabelChange: context.appendLabelChange,
+            onCopy: text => {
+                if (!text) {
+                    this.root.appendWorkflowResult({ command: "tree", outcome: "failed", message: "Selected entry has no text to copy" });
+                    this.runtime.requestRender();
+                    return;
+                }
+                void this.backend.copyWorkflowText(text).then(() => {
+                    this.root.appendWorkflowStatus("Copied selected message to clipboard");
+                    this.runtime.requestRender();
+                }).catch(error => {
+                    this.root.appendWorkflowResult({ command: "tree", outcome: "failed", message: error instanceof Error ? error.message : String(error) });
+                    this.runtime.requestRender();
+                });
+            },
             onCancel: close,
             onSelect: entryId => {
                 close();
@@ -863,10 +888,10 @@ export class OwnedUiSessionShell {
         this.root.setInputSurface(component);
         this.runtime.requestRender();
     }
-    showLoginProviderSelector(authType) {
+    showLoginProviderSelector(authType, initialSearchInput) {
         const options = this.backend.pinnedLoginOptions(authType);
         if (options.length === 0) {
-            this.root.appendWorkflowStatus(authType === "oauth" ? "No subscription providers available." : "No API key providers available.");
+            this.root.appendWorkflowStatus(authType === "oauth" ? "No subscription providers available." : authType === "api_key" ? "No API key providers available." : "No login providers available.");
             this.runtime.requestRender();
             return;
         }
@@ -879,8 +904,9 @@ export class OwnedUiSessionShell {
             void this.runWorkflow({ command: "login", argument: "", selection: id });
         }, () => {
             close();
-            this.showLoginAuthTypeSelector();
-        });
+            if (authType !== undefined)
+                this.showLoginAuthTypeSelector();
+        }, initialSearchInput);
         this.root.setInputSurface(component);
         this.runtime.requestRender();
     }
@@ -961,6 +987,24 @@ export class OwnedUiSessionShell {
         return this.runWorkflow({ command: "quit", argument: "" });
     }
     async runWorkflow(request) {
+        if (request.command === "login" && request.selection !== undefined) {
+            const setup = this.backend.pinnedAmbientAuthentication(request.selection);
+            if (setup) {
+                const close = () => {
+                    this.root.setInputSurface(null);
+                    this.runtime.requestRender();
+                };
+                const dialog = createPiShellLoginDialog({
+                    getColumns: () => this.runtime.viewport().columns,
+                    getRows: () => this.runtime.viewport().rows,
+                    requestRender: () => this.runtime.requestRender(),
+                }, setup.providerId, close, setup.providerName, setup.title);
+                dialog.showInfo(setup.message, [], true);
+                this.root.setInputSurface(dialog);
+                this.runtime.requestRender();
+                return { outcome: "completed", diagnostic: null };
+            }
+        }
         if (request.command === "scoped-models" && request.selection === undefined && request.confirmed === undefined) {
             this.showScopedModelsSelector();
             return { outcome: "completed", diagnostic: null };
@@ -1001,8 +1045,13 @@ export class OwnedUiSessionShell {
             return { outcome: "completed", diagnostic: null };
         }
         if (request.command === "reload") {
+            const blocked = this.backend.reloadBlockedResult();
+            if (blocked) {
+                this.root.appendWorkflowResult(blocked);
+                this.runtime.requestRender();
+                return workflowAdapterResult(blocked);
+            }
             this.root.resetExtensionUi();
-            this.root.resetWorkflowPresentation();
         }
         const shareSurface = request.command === "share"
             ? createPiShellOperationLoader({
@@ -1053,6 +1102,8 @@ export class OwnedUiSessionShell {
             return { outcome: "failed", diagnostic: `Owned controller missing for ${request.command}` };
         }
         if (request.command === "reload" && result.outcome === "completed") {
+            this.root.resetWorkflowPresentation();
+            this.root.editor.reloadKeybindings();
             this.root.editor.setAutocompleteCommands(this.backend.workflowAutocompleteCommands());
         }
         this.root.appendWorkflowResult(result);

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

@@ -28,6 +28,11 @@ export declare class SessionViewportController {
     get hasSelection(): boolean;
     get selectionRevision(): number;
     get presentationRevision(): number;
+    /** Latest reported coordinates; exposed without rendering for frame provenance and evidence. */
+    get pointerPosition(): {
+        readonly column: number;
+        readonly row: number;
+    } | undefined;
     get frame(): TranscriptViewportFrame | null;
     setEditorPointerFrame(frame: {
         readonly rowStart: number;