@timurproko/a1 0.2.6 → 0.2.7-dev.1221

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -39,6 +39,14 @@ export class OwnedEditorUxInterception {
     hasSelection() {
         return this.interceptors.some(interceptor => interceptor.hasSelection?.() === true);
     }
+    selectedText() {
+        for (const interceptor of this.interceptors) {
+            const selected = interceptor.selectedText?.();
+            if (selected !== undefined)
+                return selected;
+        }
+        return undefined;
+    }
     ownsPointer() {
         return this.interceptors.some(interceptor => interceptor.ownsPointer?.() === true);
     }
@@ -73,7 +81,7 @@ class PromptSelectionInterceptor {
         installAtomicSegmentation(editor, options.atomicRanges, () => this.#wordDirection);
     }
     handleInput(data, next) {
-        if (this.#handleTerminalPaste(data, next))
+        if (this.options.pasteEnabled === false ? discardTerminalPaste(this, data, value => this.handleInput(value, next)) : this.#handleTerminalPaste(data, next))
             return;
         if (this.keybindings.matches(data, "owned.editor.selectAll")) {
             this.#selectAll();
@@ -88,18 +96,19 @@ class PromptSelectionInterceptor {
             return;
         }
         if (this.keybindings.matches(data, "tui.input.copy") && this.hasSelection()) {
-            this.options.copyText(this.options.expandCopiedText(this.#selectedText()));
+            this.options.copyText(this.options.expandCopiedText(this.#selectedText()), false);
             this.#collapseCopiedSelection();
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.cut") && this.hasSelection()) {
-            this.options.copyText(this.options.expandCopiedText(this.#selectedText()));
+            this.options.copyText(this.options.expandCopiedText(this.#selectedText()), true);
             if (!this.#deleteSelection())
                 this.#deleteAtomicFocus();
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.paste")) {
-            this.pasteClipboard();
+            if (this.options.pasteEnabled !== false)
+                this.pasteClipboard();
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.redo")) {
@@ -124,7 +133,7 @@ class PromptSelectionInterceptor {
                 this.#deleteSelection();
                 return;
             }
-            const inserted = insertedText(data);
+            const inserted = editorInsertedText(data);
             if (inserted !== undefined) {
                 this.#replaceSelection(inserted);
                 return;
@@ -272,16 +281,25 @@ class PromptSelectionInterceptor {
         this.#pointerSelecting = false;
         this.#lastClick = undefined;
         this.#redoStack = [];
+        DISABLED_TERMINAL_PASTES.delete(this);
         this.#selectionRevision += 1;
     }
     cancelPendingPastes() {
         this.#pasteGeneration += 1;
         this.#terminalPaste = undefined;
+        DISABLED_TERMINAL_PASTES.delete(this);
     }
     hasSelection() {
         return this.#activeRange() !== undefined;
     }
+    selectedText() {
+        return this.#activeRange() === undefined
+            ? undefined
+            : this.options.expandCopiedText(this.#selectedText());
+    }
     pasteClipboard() {
+        if (this.options.pasteEnabled === false)
+            return false;
         this.#pasteFromClipboard();
         return true;
     }
@@ -920,7 +938,73 @@ function isEditorSegment(value) {
     const input = Reflect.get(value, "input");
     return typeof segment === "string" && typeof index === "number" && typeof input === "string";
 }
-function insertedText(data) {
+const DISABLED_TERMINAL_PASTES = new WeakMap();
+function discardTerminalPaste(owner, data, forward) {
+    const startMarker = "\x1b[200~";
+    const endMarker = "\x1b[201~";
+    const state = DISABLED_TERMINAL_PASTES.get(owner) ?? { startTail: "", bodyTail: null };
+    if (state.bodyTail !== null) {
+        const framed = state.bodyTail + data;
+        const end = framed.indexOf(endMarker);
+        if (end < 0) {
+            state.bodyTail = delimiterTail(framed, endMarker);
+            DISABLED_TERMINAL_PASTES.set(owner, state);
+            return true;
+        }
+        DISABLED_TERMINAL_PASTES.delete(owner);
+        const remaining = framed.slice(end + endMarker.length);
+        if (remaining.length > 0)
+            forward(remaining);
+        return true;
+    }
+    const hadStartTail = state.startTail.length > 0;
+    const candidate = state.startTail + data;
+    state.startTail = "";
+    const start = candidate.indexOf(startMarker);
+    if (start >= 0) {
+        if (start > 0)
+            forward(candidate.slice(0, start));
+        const framed = candidate.slice(start + startMarker.length);
+        const end = framed.indexOf(endMarker);
+        if (end < 0) {
+            state.bodyTail = delimiterTail(framed, endMarker);
+            DISABLED_TERMINAL_PASTES.set(owner, state);
+        }
+        else {
+            DISABLED_TERMINAL_PASTES.delete(owner);
+            const remaining = framed.slice(end + endMarker.length);
+            if (remaining.length > 0)
+                forward(remaining);
+        }
+        return true;
+    }
+    const partial = delimiterTail(candidate, startMarker);
+    // Compatibility: standalone Escape still cancels; marker fragments stay pending.
+    if (partial.length > 1) {
+        const before = candidate.slice(0, candidate.length - partial.length);
+        if (before.length > 0)
+            forward(before);
+        state.startTail = partial;
+        DISABLED_TERMINAL_PASTES.set(owner, state);
+        return true;
+    }
+    DISABLED_TERMINAL_PASTES.delete(owner);
+    if (hadStartTail) {
+        forward(candidate);
+        return true;
+    }
+    return false;
+}
+function delimiterTail(text, delimiter) {
+    const limit = Math.min(text.length, delimiter.length - 1);
+    for (let length = limit; length > 0; length -= 1) {
+        const suffix = text.slice(text.length - length);
+        if (delimiter.startsWith(suffix))
+            return suffix;
+    }
+    return "";
+}
+export function editorInsertedText(data) {
     if (!data || data.includes("\u001b[200~"))
         return undefined;
     const kitty = decodeKittyPrintable(data);

package/dist/integrations/pi/components/resources/builtin-themes.d.ts

@@ -1,8 +1,8 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.1.0 (MIT),
- * commit abe508e1b89912adde45528136c3221eb69acdd7.
- * Upstream dark.json SHA-256: c11a588b714d35300293079b425fb09a3693d4b2d453585d211b08163c648b75
- * Upstream light.json SHA-256: f590c51c2bc8b238891efd0e983473ed2e2a6487b6692cc1d4b2845165e703f7
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.4.0 (MIT),
+ * commit 4a080252f06caf63a525d7873c5d94d3c23887e0.
+ * Upstream dark.json SHA-256: e1f96982f8cb7d2a48eca7db03c9cb282cb1e14a243680cd855638ecd6a251b6
+ * Upstream light.json SHA-256: 2dee6a4be7f765e7fd7728166b7ebf8c29e4ce313f8ec6b38ae50699e3abc2f3
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.
  */
 export declare const BUILTIN_THEME_RESOURCES: Readonly<{

package/dist/integrations/pi/components/resources/builtin-themes.js

@@ -1,8 +1,8 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.1.0 (MIT),
- * commit abe508e1b89912adde45528136c3221eb69acdd7.
- * Upstream dark.json SHA-256: c11a588b714d35300293079b425fb09a3693d4b2d453585d211b08163c648b75
- * Upstream light.json SHA-256: f590c51c2bc8b238891efd0e983473ed2e2a6487b6692cc1d4b2845165e703f7
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.4.0 (MIT),
+ * commit 4a080252f06caf63a525d7873c5d94d3c23887e0.
+ * Upstream dark.json SHA-256: e1f96982f8cb7d2a48eca7db03c9cb282cb1e14a243680cd855638ecd6a251b6
+ * Upstream light.json SHA-256: 2dee6a4be7f765e7fd7728166b7ebf8c29e4ce313f8ec6b38ae50699e3abc2f3
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.
  */
 export const BUILTIN_THEME_RESOURCES = Object.freeze({

package/dist/integrations/pi/components/share-operation-dialog.d.ts

@@ -1,6 +1,8 @@
 import { type PiShellComponentPort, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export interface PiShellOperationLoaderPort extends PiShellComponentPort {
     readonly signal: AbortSignal;
+    /** Relabels the running operation; the pinned comparison loader keeps its first label. */
+    readonly setMessage?: (message: string) => void;
 }
 export declare function createPiShellShareOperationDialog(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellOperationLoaderPort;
 export declare function createPiShellOperationLoader(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellOperationLoaderPort;

package/dist/integrations/pi/components/share-operation-dialog.js

@@ -18,6 +18,7 @@ class ShareOperationDialog {
         ], new DynamicBorder(paintPiBorder));
     }
     get signal() { return this.#loader.signal; }
+    setMessage(message) { this.#loader.setMessage(message); }
     invalidate() { this.#frame.invalidate(); }
     render(width) { return this.#frame.render(width); }
     handleInput(data) { this.#loader.handleInput(data); }
@@ -26,7 +27,7 @@ class ShareOperationDialog {
 export function createPiShellShareOperationDialog(runtime, message) {
     ensureTheme();
     const dialog = new ShareOperationDialog(runtime, message);
-    return { ...componentPort(dialog), signal: dialog.signal };
+    return { ...componentPort(dialog), signal: dialog.signal, setMessage: message => dialog.setMessage(message) };
 }
 export function createPiShellOperationLoader(runtime, message) {
     ensureTheme();

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -5,6 +5,8 @@ import { OwnedEditorUxInterception, createPromptSelectionInterceptor, editorVisu
 import { PINNED_PI_LAYOUT, getPiSelectListTheme, piTheme, renderPiListSelection, } from "./theme.js";
 import { createPiKeybindingsHost, createTuiFacade, ensureTheme, isAutocompleteProvider, } from "./shell-shared-facade.js";
 import { SKILLS_COMMAND_NAME, collapseSkillCommands, createSkillsTunnelProvider, } from "./skills-command.js";
+/** The built-in commands resident A1 serves from its tab bar instead: utility tabs, and the tab rename for `/name`. */
+const RESIDENT_UTILITY_TAB_COMMANDS = new Set(["settings", "changelog", "name"]);
 /** A selected autocomplete row: its arrow/primary column, then the aligned description. */
 const SELECTED_DESCRIBED_ROW = /^(→ .*?\S)(\s{2,}.*)$/u;
 const INPUT_COUNTER_INSET = 3;
@@ -62,6 +64,8 @@ export function createPiShellEditor(options) {
     ensureTheme();
     const tui = createTuiFacade(options);
     const inputPresentation = options.keybindingProfile === "a1" ? options.promptPresentation?.input : undefined;
+    const inputCapabilities = options.inputCapabilities ?? {};
+    const autocompleteEnabled = inputCapabilities.autocomplete !== false;
     // Invariant: the process shares one manager; a standalone editor gets its own host for its profile.
     const host = options.keybindings ?? createPiKeybindingsHost({
         profile: options.keybindingProfile ?? "pi",
@@ -74,7 +78,7 @@ export function createPiShellEditor(options) {
     }
     const scrollInfo = { emitted: false, counter: undefined };
     const selectListTheme = getPiSelectListTheme();
-    let tunnelSkills = [];
+    const autocomplete = { provider: emptyAutocompleteProvider(), skills: [] };
     const EditorClass = options.keybindingProfile === "a1" && options.persistentHistory === true ? options.historyEditor : OwnedEditor;
     const editor = new EditorClass(tui, {
         borderColor: (value) => inputPresentation === undefined ? piTheme().fg("borderMuted", value) : inputPresentation.styleRule(value),
@@ -100,13 +104,14 @@ export function createPiShellEditor(options) {
         ...(options.keybindingProfile === "a1" ? {
             terminalRows: options.getRows,
             getVisualLineCount: (width) => editorVisualLineCount(editor, width),
-            clearCommandSearchOnEscape: true,
-            commandTunnels: () => tunnelSkills.length === 0 ? [] : [SKILLS_COMMAND_NAME],
+            clearCommandSearchOnEscape: autocompleteEnabled,
+            commandTunnels: () => !autocompleteEnabled || autocomplete.skills.length === 0 ? [] : [SKILLS_COMMAND_NAME],
         } : {}),
         ...(options.keybindingProfile === "a1" && options.promptPresentation !== undefined ? {
             ...(inputPresentation === undefined ? {} : { inputPresentation }),
             styleSuggestion: options.promptPresentation.styleSuggestion,
             styleSuggestionCaret: options.promptPresentation.styleSuggestionCaret,
+            ...(inputCapabilities.placeholder === undefined ? {} : { placeholder: inputCapabilities.placeholder }),
         } : {}),
     });
     const editorUx = options.keybindingProfile === "a1"
@@ -117,6 +122,7 @@ export function createPiShellEditor(options) {
                 ...(options.beginClipboardPaste === undefined ? {} : { beginClipboardPaste: options.beginClipboardPaste }),
                 ...(options.beginTextPaste === undefined ? {} : { beginTextPaste: options.beginTextPaste }),
                 ...(options.deferTextPaste === undefined ? {} : { deferTextPaste: options.deferTextPaste }),
+                pasteEnabled: inputCapabilities.paste !== false,
                 ...(options.onPasteRejected === undefined ? {} : { onPasteRejected: options.onPasteRejected }),
                 ...(options.onPasteInput === undefined ? {} : { onPasteInput: options.onPasteInput }),
                 transformPastedContent: options.transformPastedContent ?? (content => content.kind === "text" ? content.text : ""),
@@ -142,36 +148,7 @@ export function createPiShellEditor(options) {
             : isBashMode ? piTheme().getBashModeBorderColor() : piTheme().getThinkingBorderColor(thinkingLevel);
         tui.requestRender();
     };
-    let autocompleteProvider;
-    const builtInCatalog = options.keybindingProfile === "a1" ? OWNED_BUILTIN_SLASH_COMMANDS : PINNED_PI_BUILTIN_SLASH_COMMANDS;
-    const setAutocompleteCommands = (installed) => {
-        // Invariant: collapse is a bare-A1 presentation; the comparison profile installs the pinned list.
-        const collapsed = options.keybindingProfile === "a1" && options.skillsPresentation?.() === "collapse"
-            ? collapseSkillCommands(installed)
-            : { commands: installed, skills: [] };
-        tunnelSkills = collapsed.skills;
-        const commands = collapsed.commands;
-        const additions = new Map(commands.map(command => [command.name, command]));
-        const builtInNames = new Set(builtInCatalog.map(command => command.name));
-        const builtIns = builtInCatalog.flatMap(command => [
-            autocompleteCommand(command, additions.get(command.name)),
-            // Rationale: the collapsed browser is a primary bare-A1 command, not a resource after quit.
-            ...(command.name === "settings" && collapsed.collapsedCommand !== undefined
-                ? [autocompleteCommand(collapsed.collapsedCommand)]
-                : []),
-        ]);
-        // Invariant: built-in additions and the promoted collapsed browser never reappear as resources.
-        const resources = commands
-            .filter(command => command.name !== collapsed.collapsedCommand?.name && command.source !== "builtin" && !builtInNames.has(command.name))
-            .map(command => autocompleteCommand(command));
-        const catalog = [...builtIns, ...resources];
-        const combined = new CombinedAutocompleteProvider(catalog, options.cwd ?? process.cwd());
-        const tunnelAware = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
-        autocompleteProvider = options.keybindingProfile === "a1"
-            ? createDelimiterReadyCommandProvider(tunnelAware, catalog)
-            : tunnelAware;
-        editor.setAutocompleteProvider(autocompleteProvider);
-    };
+    const setAutocompleteCommands = autocompleteCommandSetter(options, editor, autocomplete, autocompleteEnabled);
     setAutocompleteCommands(options.autocompleteCommands ?? []);
     let submitHandler = options.onSubmit;
     let interruptHandler = options.onInterrupt ?? (() => { });
@@ -258,6 +235,9 @@ export function createPiShellEditor(options) {
         reloadKeybindings: () => host.reload(),
         matchesTerminalKey: (data, key) => matchesKey(data, key),
         handleInput: data => {
+            if (inputCapabilities.singleLine === true
+                && (keybindings.matches(data, "tui.input.newLine") || keybindings.matches(data, "tui.input.submit")))
+                return;
             // Compatibility: an unassigned reverse Tab must not clear selection or reach autocomplete fallback.
             if (editorUx !== undefined && matchesKey(data, "shift+tab")
                 && !Object.values(keybindings.getEffectiveConfig()).some(keys => (Array.isArray(keys) ? keys : [keys]).some(key => key !== undefined && matchesKey(data, key))))
@@ -315,13 +295,15 @@ export function createPiShellEditor(options) {
             tui.requestRender();
         },
         addAutocompleteProvider(factory) {
+            if (!autocompleteEnabled)
+                return;
             if (typeof factory !== "function")
                 throw new TypeError("extension autocomplete factory must be a function");
-            const candidate = Reflect.apply(factory, undefined, [autocompleteProvider]);
+            const candidate = Reflect.apply(factory, undefined, [autocomplete.provider]);
             if (!isAutocompleteProvider(candidate))
                 throw new TypeError("extension autocomplete factory returned a malformed provider");
-            autocompleteProvider = candidate;
-            editor.setAutocompleteProvider(autocompleteProvider);
+            autocomplete.provider = candidate;
+            editor.setAutocompleteProvider(autocomplete.provider);
         },
         setThinkingLevel(level) {
             if (thinkingLevel === level)
@@ -346,12 +328,52 @@ export function createPiShellEditor(options) {
             return editor.canPresentPromptSuggestion() ? null : "prompt-mode";
         },
         hasSelection: () => editorUx?.hasSelection() ?? false,
+        selectedText: () => editorUx?.selectedText(),
         ownsPointer: () => editorUx?.ownsPointer() ?? false,
         handlePointer: event => editorUx?.handlePointer(event) ?? false,
         pasteClipboard: () => editorUx?.pasteClipboard() ?? false,
         cancelPendingPastes: () => editorUx?.cancelPendingPastes(),
     };
 }
+function autocompleteCommandSetter(options, editor, state, enabled) {
+    const builtInCatalog = (options.keybindingProfile === "a1" ? OWNED_BUILTIN_SLASH_COMMANDS : PINNED_PI_BUILTIN_SLASH_COMMANDS)
+        .filter(command => !options.hideUtilityTabCommands || !RESIDENT_UTILITY_TAB_COMMANDS.has(command.name));
+    return installed => {
+        if (!enabled) {
+            state.provider = emptyAutocompleteProvider();
+            editor.setAutocompleteProvider(state.provider);
+            return;
+        }
+        // Invariant: collapse is a bare-A1 presentation; the comparison profile installs the pinned list.
+        const collapsed = options.keybindingProfile === "a1" && options.skillsPresentation?.() === "collapse"
+            ? collapseSkillCommands(installed)
+            : { commands: installed, skills: [] };
+        state.skills = collapsed.skills;
+        const additions = new Map(collapsed.commands.map(command => [command.name, command]));
+        const builtInNames = new Set(builtInCatalog.map(command => command.name));
+        const builtIns = builtInCatalog.flatMap(command => [
+            autocompleteCommand(command, additions.get(command.name)),
+            // Rationale: the collapsed browser is a primary bare-A1 command, not a resource after quit.
+            ...(command.name === "settings" && collapsed.collapsedCommand !== undefined
+                ? [autocompleteCommand(collapsed.collapsedCommand)] : []),
+        ]);
+        const resources = collapsed.commands
+            .filter(command => command.name !== collapsed.collapsedCommand?.name && command.source !== "builtin" && !builtInNames.has(command.name))
+            .map(command => autocompleteCommand(command));
+        const catalog = [...builtIns, ...resources];
+        const combined = new CombinedAutocompleteProvider(catalog, options.cwd ?? process.cwd());
+        const tunnelAware = state.skills.length === 0 ? combined : createSkillsTunnelProvider(combined, state.skills);
+        state.provider = options.keybindingProfile === "a1" ? createDelimiterReadyCommandProvider(tunnelAware, catalog) : tunnelAware;
+        editor.setAutocompleteProvider(state.provider);
+    };
+}
+function emptyAutocompleteProvider() {
+    return {
+        getSuggestions: async () => null,
+        applyCompletion: (lines, cursorLine, cursorCol) => ({ lines, cursorLine, cursorCol }),
+        shouldTriggerFileCompletion: () => false,
+    };
+}
 /** Bare A1 leaves an applied catalog command ready for `:`, a user-entered space, or submission. */
 function createDelimiterReadyCommandProvider(base, commands) {
     const commandNames = new Set(commands.map(command => command.name));

package/dist/integrations/pi/components/shell-extension-ui.js

@@ -15,22 +15,8 @@ export function createPiExtensionUiBridge(host) {
     const keybindings = KeybindingsManager.create(host.agentDir);
     const disposers = new Set();
     let customEditorFactory;
-    let activeSurface;
-    let activeCancel;
-    const closeSurface = (surface) => {
-        if (surface !== undefined && activeSurface !== surface)
-            return;
-        activeSurface = undefined;
-        host.setInputSurface(null);
-        host.runtime.requestRender();
-    };
-    const mountSurface = (surface) => {
-        if (activeSurface !== undefined && activeSurface !== surface)
-            activeSurface.dispose?.();
-        activeSurface = surface;
-        host.setInputSurface(surface);
-        host.runtime.requestRender();
-    };
+    const dialogs = createExtensionDialogStack(host);
+    const overlayCancels = new Set();
     const trackAbort = (signal, cancel) => {
         if (signal === undefined)
             return () => { };
@@ -54,26 +40,24 @@ export function createPiExtensionUiBridge(host) {
             if (settled)
                 return;
             settled = true;
-            if (activeCancel === cancel)
-                activeCancel = undefined;
             untrack();
-            const ownedSurface = activeSurface === surface;
-            if (retainSurfaceOnSettle && ownedSurface)
-                activeSurface = undefined;
-            else
-                closeSurface(surface);
-            if (ownedSurface)
-                host.setProgramStatusBlocked(undefined);
+            if (surface !== undefined) {
+                const retained = retainSurfaceOnSettle && dialogs.isOnly(surface);
+                // Rationale: like pinned Pi, a settled dialog is disposed so its countdown stops, unless it stays painted.
+                if (!retained)
+                    surface.dispose?.();
+                dialogs.remove(surface, retained);
+            }
             resolve(value);
         };
         const cancel = () => finish(undefined);
-        surface = create(finish, cancel);
+        const created = create(finish, cancel);
+        surface = created;
         untrack = trackAbort(options?.signal, cancel);
-        if (!settled) {
-            activeCancel = cancel;
-            mountSurface(surface);
-            host.setProgramStatusBlocked(blocked);
-        }
+        if (!settled)
+            dialogs.push({ surface: created, blocked, cancel });
+        else
+            created.dispose?.();
     });
     const createFactoryComponent = (factory, ...arguments_) => {
         if (typeof factory !== "function")
@@ -148,28 +132,26 @@ export function createPiExtensionUiBridge(host) {
             let settled = false;
             let surface;
             let overlay;
-            const done = (value) => {
-                if (settled)
-                    return;
-                settled = true;
-                if (activeCancel === cancelCustom)
-                    activeCancel = undefined;
-                overlay?.hide();
-                if (surface !== undefined)
-                    closeSurface(surface);
-                resolve(value);
-            };
-            const cancelCustom = () => {
+            const close = (settle) => {
                 if (settled)
                     return;
                 settled = true;
-                if (activeCancel === cancelCustom)
-                    activeCancel = undefined;
-                overlay?.hide();
-                if (surface !== undefined)
-                    closeSurface(surface);
-                Reflect.apply(resolve, undefined, []);
+                overlayCancels.delete(cancelCustom);
+                // Invariant: remove this dialog or overlay, not the topmost one; another may have opened above it.
+                if (overlay !== undefined)
+                    overlay.hide();
+                else if (surface !== undefined)
+                    dialogs.remove(surface);
+                settle();
+                if (overlay === undefined) {
+                    try {
+                        surface?.dispose?.();
+                    }
+                    catch { /* Rationale: a settled dialog's dispose failure must not leak. */ }
+                }
             };
+            const done = (value) => close(() => resolve(value));
+            const cancelCustom = () => close(() => Reflect.apply(resolve, undefined, []));
             let created;
             try {
                 created = Reflect.apply(factory, undefined, [tui, piTheme(), keybindings, done]);
@@ -187,19 +169,18 @@ export function createPiExtensionUiBridge(host) {
                     return;
                 }
                 surface = withPiDialogCancel(componentPort(component), cancelCustom);
-                activeCancel = cancelCustom;
                 if (options?.overlay) {
                     const overlayOptions = typeof options.overlayOptions === "function" ? options.overlayOptions() : options.overlayOptions;
+                    overlayCancels.add(cancelCustom);
                     overlay = host.showOverlay(surface, overlayOptions);
                     options.onHandle?.(publicOverlayHandle(overlay));
                 }
                 else
-                    mountSurface(surface);
+                    dialogs.push({ surface, blocked: undefined, cancel: cancelCustom });
             }).catch(error => {
-                if (activeCancel === cancelCustom)
-                    activeCancel = undefined;
-                if (surface !== undefined)
-                    closeSurface(surface);
+                overlayCancels.delete(cancelCustom);
+                if (surface !== undefined && overlay === undefined)
+                    dialogs.remove(surface);
                 reject(error);
             });
         }),
@@ -251,11 +232,9 @@ export function createPiExtensionUiBridge(host) {
         setToolsExpanded: expanded => host.setToolsExpanded(expanded),
     };
     const reset = () => {
-        const cancel = activeCancel;
-        activeCancel = undefined;
-        cancel?.();
-        activeSurface?.dispose?.();
-        activeSurface = undefined;
+        dialogs.cancelAll();
+        for (const cancel of [...overlayCancels])
+            cancel();
         host.setInputSurface(null);
         host.setProgramStatusBlocked(undefined);
     };
@@ -276,6 +255,46 @@ export function createPiExtensionUiBridge(host) {
         },
     };
 }
+/**
+ * Pinned Pi's extension dialog stack over the shell's single input slot. The last entry is visible; closing it shows
+ * the previous one with its program status, and a covered dialog stays answerable, so no dialog promise is left pending.
+ */
+function createExtensionDialogStack(host) {
+    const dialogs = [];
+    const showTop = () => {
+        const top = dialogs.at(-1);
+        host.setInputSurface(top?.surface ?? null);
+        host.setProgramStatusBlocked(top?.blocked);
+        host.runtime.requestRender();
+    };
+    return {
+        push(dialog) {
+            dialogs.push(dialog);
+            showTop();
+        },
+        /** Only removing the visible dialog changes the slot; a retained last surface stays painted without its status. */
+        remove(surface, retainSurface = false) {
+            const index = dialogs.findIndex(dialog => dialog.surface === surface);
+            if (index === -1)
+                return;
+            dialogs.splice(index, 1);
+            if (index !== dialogs.length)
+                return;
+            if (!retainSurface || dialogs.length > 0)
+                return showTop();
+            host.setProgramStatusBlocked(undefined);
+            host.runtime.requestRender();
+        },
+        isOnly: (surface) => dialogs.length === 1 && dialogs[0].surface === surface,
+        /** Rationale: unlike pinned Pi, which drops stacked dialogs unresolved, A1 settles each as cancelled, top first. */
+        cancelAll() {
+            for (const dialog of [...dialogs].reverse())
+                dialog.cancel();
+            for (const dialog of dialogs.splice(0))
+                dialog.surface.dispose?.();
+        },
+    };
+}
 function extensionError(surface, error) {
     return `Extension ${surface} failed: ${error instanceof Error ? error.message : String(error)}`;
 }

package/dist/integrations/pi/components/shell-footer-status.d.ts

@@ -4,5 +4,5 @@ import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellProg
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
 export declare function createPiShellStatus(view: OwnedUiSessionViewModel, progressStatus: PiShellProgressStatusPresentation, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
-export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", showLevel?: () => boolean): PiShellViewComponentPort;
+export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", showLevel?: () => boolean, showSessionName?: boolean): PiShellViewComponentPort;
 export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport", getKeybindings?: () => KeybindingsConfig): PiShellQueuedInputPort;

package/dist/integrations/pi/components/shell-footer-status.js

@@ -7,7 +7,7 @@ import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { StatusIndicator, WorkingStatusIndicator } from "./upstream/components/status-indicator.js";
 import { protectPiPromptChipPresentation } from "./prompt-chip-presentation.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
-import { createTuiFacade, ensureTheme, } from "./shell-shared-facade.js";
+import { createTuiFacade, ensureTheme, piShellTruncateToWidth, piShellVisibleWidth, } from "./shell-shared-facade.js";
 export function createPiShellHeader(options = {}) {
     ensureTheme();
     let expanded = options.expanded ?? false;
@@ -107,9 +107,9 @@ export function createPiShellStatus(view, progressStatus, runtime) {
         component = statusComponent(view, statusUi, outputPad, liveStatusText, placement, progressPresentation, progressStatus);
     };
     return {
-        render: width => component?.render(width) ?? [],
+        render: width => appendInstalledUpdateStatus(component?.render(width) ?? [], width, view),
         renderDock: width => placement === "dock" ? component?.render(width) ?? [] : [],
-        renderLive: width => placement === "live" ? component?.render(width) ?? [] : [],
+        renderLive: width => appendInstalledUpdateStatus(placement === "live" ? component?.render(width) ?? [] : [], width, view),
         placement: () => placement,
         invalidate: () => component?.invalidate(),
         update(next) {
@@ -136,9 +136,9 @@ export function createPiShellStatus(view, progressStatus, runtime) {
         },
     };
 }
-export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () => true) {
+export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () => true, showSessionName = true) {
     ensureTheme();
-    const footer = new SessionFooter(() => view, cwd, profile, showLevel);
+    const footer = new SessionFooter(() => view, cwd, profile, showLevel, showSessionName);
     return {
         render: width => footer.render(width),
         invalidate: () => footer.invalidate(),
@@ -228,6 +228,22 @@ function statusSignature(view, workingOverride, outputPad, placement, progressPr
     const message = withMessage ? `${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.workingProgress ?? ""}` : "";
     return `${placement}\u0000${outputPad}\u0000${view.lifecycle}\u0000${progressPresentation}\u0000${message}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
 }
+function appendInstalledUpdateStatus(rows, width, view) {
+    if (width <= 0 || !view.diagnostics.some(diagnostic => diagnostic.code === "release-update-installed"))
+        return rows;
+    const theme = piTheme();
+    const full = `${theme.fg("success", "Update installed")} ${theme.fg("muted", "·")} ${theme.fg("accent", "Restart to update")}`;
+    const status = piShellTruncateToWidth(full, width);
+    const statusWidth = piShellVisibleWidth(status);
+    const target = rows.findLastIndex(row => piShellVisibleWidth(row.trimEnd()) > 0);
+    if (target < 0)
+        return [`${" ".repeat(Math.max(0, width - statusWidth))}${status}`];
+    const base = (rows[target] ?? "").trimEnd();
+    const gap = width - piShellVisibleWidth(base) - statusWidth;
+    if (gap >= 2)
+        return rows.map((row, index) => index === target ? `${base}${" ".repeat(gap)}${status}` : row);
+    return [...rows.slice(0, target + 1), `${" ".repeat(Math.max(0, width - statusWidth))}${status}`, ...rows.slice(target + 1)];
+}
 function queuedInputChipWrapping(text, presentation, width) {
     return presentation === "custom-viewport"
         ? protectPiPromptChipPresentation(text, width)

package/dist/integrations/pi/components/shell-hotkey-sections.js

@@ -6,7 +6,7 @@ import { hotkeysMarkdown } from "./shell-presenters-info.js";
 export function renderPiShellHotkeySections(presentation, width) {
     ensureTheme();
     const shortcuts = presentation.getShortcuts ?? (() => []);
-    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi");
+    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi", presentation.residentTabs);
     const sections = [];
     for (const line of markdown.split("\n")) {
         const heading = /^\*\*(.+)\*\*$/.exec(line)?.[1];