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

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);
@@ -204,6 +206,9 @@ export class OwnedUiSessionShellRoot {
             component.setImagePresentation(showImages, imageWidthCells);
         this.#invalidateTranscriptPresentation();
     }
+    prepareHistoryText(text) {
+        return this.#promptChips.prepareHistoryText(text);
+    }
     preparePromptSubmission(text) {
         return this.#promptChips.prepareSubmission(text);
     }
@@ -286,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;
@@ -308,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,
@@ -347,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;
@@ -361,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;
@@ -482,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);
@@ -504,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({
@@ -535,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.
@@ -603,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;
@@ -614,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) {
@@ -639,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;
         }
@@ -658,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") {
+        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") {
@@ -782,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 {
@@ -826,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);
         }
@@ -836,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();
@@ -881,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

@@ -1,3 +1,4 @@
+import { PromptHistoryController } from "./prompt-history-controller.js";
 import { PRODUCT_TEXT } from "../../../product-identity.js";
 import { boundedCleanup } from "../../../foundation/terminal-cleanup/index.js";
 import { assertOwnedUiCommand, assertPromptImages, ImageAttachmentError } from "../../../contracts/owned-ui/index.js";
@@ -21,6 +22,7 @@ export class OwnedUiSessionShell {
     #unsubscribe;
     #unsubscribePromptSuggestions;
     #promptSuggestions;
+    #promptHistory = null;
     #extensionBridge;
     #stopped;
     #resolveStopped;
@@ -78,6 +80,8 @@ export class OwnedUiSessionShell {
                 replacementSurfaceActive: !this.root.usesDefaultInputSurface(),
             }),
             enableDockInputReuse: options.inputPresentation?.viewportReuse !== false,
+            persistentHistory: this.#customViewport && options.promptHistory !== undefined,
+            ...(options.promptHistory === undefined ? {} : { historyEditor: options.promptHistory.editor }),
             onSubmit: text => { void this.submit(text).catch(() => this.#reportSubmissionError()); },
             onPasteRejected: error => this.#reportSubmissionError(error),
             onInterrupt: () => { void this.interrupt(); },
@@ -98,6 +102,7 @@ export class OwnedUiSessionShell {
             onInputSurfaceChanged: () => {
                 this.root.clearViewportPointerState();
                 promptSuggestionController?.invalidate();
+                this.#promptHistory?.synchronize();
             },
             onCopyText: text => {
                 runtime?.writeControl(`\u001b]52;c;${Buffer.from(text, "utf8").toString("base64")}\u0007`);
@@ -134,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),
         });
@@ -232,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
@@ -309,6 +326,17 @@ export class OwnedUiSessionShell {
                     this.root.setImagePresentation(this.#showImages, this.#imageWidthCells);
                 } },
         });
+        if (this.#customViewport && options.promptHistory !== undefined) {
+            this.#promptHistory = new PromptHistoryController({
+                editor: this.root.editor,
+                store: options.promptHistory.store,
+                limit: options.promptHistory.limit,
+                fallback: this.view().transcript.flatMap(block => block.kind === "user" ? [block.text] : []),
+                active: () => this.root.usesDefaultInputSurface(),
+                render: () => this.runtime.requestRender(),
+                failure: message => this.root.addExtensionNotification(message, "warning"),
+            });
+        }
         this.#extensionBridge = createPiExtensionUiBridge({
             runtime: {
                 getColumns: () => this.runtime.viewport().columns,
@@ -419,6 +447,7 @@ export class OwnedUiSessionShell {
             return;
         this.#started = true;
         this.runtime.start();
+        this.#promptHistory?.start();
         this.#syncTerminalProgress(this.view());
         if (this.#customViewport)
             this.#setPointerReporting(true);
@@ -472,6 +501,16 @@ export class OwnedUiSessionShell {
         for (const item of this.#waitingImages.values())
             item.controller.abort();
     }
+    #rememberInput(text, kind) {
+        this.root.editor.addToHistory(text);
+        if (this.#promptHistory !== null) {
+            const reusable = this.root.prepareHistoryText(text);
+            if (reusable.length === 0)
+                this.#promptHistory.rememberRecovery(text);
+            else
+                this.#promptHistory.capture(reusable, kind, this.#cwd, this.backend.sessionId);
+        }
+    }
     async #submit(text) {
         this.#promptSuggestions?.invalidate();
         const displayInput = text.trim();
@@ -486,7 +525,7 @@ export class OwnedUiSessionShell {
             const excludeFromContext = input.startsWith("!!");
             const command = input.slice(excludeFromContext ? 2 : 1).trim();
             if (command) {
-                this.root.editor.addToHistory(displayInput);
+                this.#rememberInput(displayInput, "bash");
                 try {
                     const result = await this.backend.executeBashWorkflow(command, excludeFromContext);
                     const workflow = {
@@ -508,7 +547,7 @@ export class OwnedUiSessionShell {
             }
         }
         if (this.view().status.workingMessage?.startsWith("Compacting") === true) {
-            this.root.editor.addToHistory(displayInput);
+            this.#rememberInput(displayInput, "steer");
             this.#compactionQueue.push({
                 text: input,
                 draft: displayInput,
@@ -520,7 +559,7 @@ export class OwnedUiSessionShell {
             return { outcome: "completed", diagnostic: null };
         }
         const type = this.view().lifecycle === "busy" ? "steer" : "prompt";
-        this.root.editor.addToHistory(displayInput);
+        this.#rememberInput(displayInput, type);
         this.root.resumeViewportFollowing();
         return this.#execute({
             type,
@@ -633,7 +672,7 @@ export class OwnedUiSessionShell {
         const prepared = this.root.preparePromptSubmission(displayInput);
         assertPromptImages(prepared.images);
         const text = prepared.text.trim();
-        this.root.editor.addToHistory(displayInput);
+        this.#rememberInput(displayInput, "follow-up");
         if (this.root.editor.getText() === draft)
             this.root.editor.setText("");
         this.root.resumeViewportFollowing();
@@ -766,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) {
@@ -809,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();
@@ -836,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;
         }
@@ -852,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();
     }
@@ -934,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 };
@@ -974,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({
@@ -1026,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);
@@ -1157,6 +1235,8 @@ export class OwnedUiSessionShell {
             failures.push(error);
         } };
         let pasteCleanup = Promise.resolve();
+        let historyCleanup = Promise.resolve(true);
+        attempt(() => { historyCleanup = this.#promptHistory?.close() ?? Promise.resolve(true); });
         attempt(() => { pasteCleanup = this.root.disposePendingPastes(); });
         attempt(() => this.root.clearViewportPointerState());
         attempt(() => this.#setPointerReporting(false, true));
@@ -1182,6 +1262,9 @@ export class OwnedUiSessionShell {
         attempt(() => this.#extensionBridge.dispose());
         // Invariant: terminal restoration precedes any potentially stalled backend teardown.
         await this.runtime.dispose().catch(error => failures.push(error));
+        const historySaved = await historyCleanup.catch(() => false);
+        if (!historySaved)
+            this.runtime.writeAfterStop("Prompt history could not finish saving before exit.\n");
         await boundedCleanup(() => pasteCleanup).catch(error => failures.push(error));
         await boundedCleanup(() => this.backend.unbindExtensionUi()).catch(error => failures.push(error));
         if (failures.length > 0)
@@ -1219,6 +1302,7 @@ export class OwnedUiSessionShell {
             this.root.resetPendingPastes();
             this.#promptSuggestions?.invalidate();
             this.#sessionGeneration = this.backend.sessionGeneration;
+            this.#promptHistory?.reset(view.transcript.flatMap(block => block.kind === "user" ? [block.text] : []));
             this.#activeLoginDialog = undefined;
             this.#extensionBridge.reset();
             // Invariant: a replaced session takes its transient viewport and owned-route state with it.
@@ -1377,7 +1461,7 @@ export class OwnedUiSessionShell {
         if (isWorkflowRoute(name))
             return this.runWorkflow({ command: name, argument });
         // Compatibility: unknown slash input, prompt templates, skills, and extension commands remain Pi prompt input.
-        this.root.editor.addToHistory(text);
+        this.#rememberInput(text, "slash");
         this.root.resumeViewportFollowing();
         return this.#execute({
             type: this.view().lifecycle === "busy" ? "steer" : "prompt",
@@ -1523,6 +1607,7 @@ export class OwnedUiSessionShell {
         catch {
             // Security: dispatch might already have reached the provider. Never retry automatically.
             this.root.editor.addToHistory(draft);
+            this.#promptHistory?.rememberRecovery(draft);
             this.#reportSubmissionError(undefined, "Submission failed; delivery is uncertain. Check the conversation before retrying. Press Up to recover the draft.");
             return { outcome: "failed", diagnostic: "submission delivery is uncertain" };
         }
@@ -1540,6 +1625,7 @@ export class OwnedUiSessionShell {
     }
     #recoverSubmission(draft, revision, error) {
         this.root.editor.addToHistory(draft);
+        this.#promptHistory?.rememberRecovery(draft);
         // Concurrency: never overwrite input typed (even typed and cleared) after this submission.
         if (revision === this.#editorRevision && this.root.editor.getText().length === 0)
             this.root.editor.setText(draft);

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;

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

@@ -60,6 +60,10 @@ export class SessionViewportController {
     get presentationRevision() {
         return this.#presentationRevision;
     }
+    /** Latest reported coordinates; exposed without rendering for frame provenance and evidence. */
+    get pointerPosition() {
+        return this.#pointerPosition;
+    }
     get frame() {
         return this.#viewport.frame;
     }
@@ -159,6 +163,23 @@ export class SessionViewportController {
             this.#requestHyperlinkCleanup();
             this.#requestRender(true);
         }
+        // Invariant: content shortcuts never reach the prompt, even before the first frame
+        // or when scrolling is a no-op. Plain Home/End remain editor line navigation.
+        if (allowWheel && this.#editor.matchesTerminalKey(data, "ctrl+home")) {
+            if (this.#viewport.scrollTo(0, now)) {
+                this.#scheduleActivityExpiry();
+                this.#requestRender();
+            }
+            return { data: "", consumed: true };
+        }
+        if (allowWheel && this.#editor.matchesTerminalKey(data, "ctrl+end")) {
+            if (!this.#viewport.followingEnd) {
+                this.#viewport.scrollToEnd(now);
+                this.#scheduleActivityExpiry();
+                this.#requestRender();
+            }
+            return { data: "", consumed: true };
+        }
         if (this.#viewport.frame === null) {
             // Invariant: a not-yet-painted A1 screen is not Pi's selection surface.
             return routeMouseInput(data, event => {
@@ -183,21 +204,6 @@ export class SessionViewportController {
                 }
             }
         }
-        if (allowWheel && this.#editor.matchesTerminalKey(data, "home")) {
-            if (this.#viewport.scrollTo(0, now)) {
-                this.#scheduleActivityExpiry();
-                this.#requestRender();
-            }
-            return { data: "", consumed: true };
-        }
-        if (allowWheel && this.#editor.matchesTerminalKey(data, "end")) {
-            if (!this.#viewport.followingEnd) {
-                this.#viewport.scrollToEnd(now);
-                this.#scheduleActivityExpiry();
-                this.#requestRender();
-            }
-            return { data: "", consumed: true };
-        }
         if (allowWheel && (SHIFT_UP_INPUTS.has(data) || SHIFT_DOWN_INPUTS.has(data))) {
             const scrolled = SHIFT_UP_INPUTS.has(data)
                 ? this.#viewport.scrollToPreviousPrompt(now)