@timurproko/a1 0.2.6 → 0.2.7-dev.1222

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];

package/dist/integrations/pi/components/shell-presenters-info.d.ts

@@ -68,11 +68,14 @@ export interface PiShellHotkeysPresentation {
     readonly bindings?: KeybindingsConfig;
     readonly getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>;
     readonly profile?: "pi" | "a1";
+    readonly residentTabs?: boolean;
 }
-export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;
+export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1", residentTabs?: boolean): PiShellComponentPort;
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export declare function renderPiShellHotkeysLines(presentation: PiShellHotkeysPresentation, width: number): readonly string[];
-export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1"): string;
+/** The global tab declarations the hotkeys document lists, straight from the feature's declarations. */
+export declare const TAB_HOTKEYS: readonly (readonly [string, string | null, string])[];
+export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1", residentTabs?: boolean): string;
 /**
  * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
  * borders around a bold warning title, the muted update instruction with the

package/dist/integrations/pi/components/shell-presenters-info.js

@@ -1,6 +1,7 @@
 import { DynamicBorder } from "../startup-public.js";
 import { Container, getCapabilities, hyperlink, Markdown, Spacer, Text, visibleWidth } from "@earendil-works/pi-tui";
 import { PRODUCT_TEXT } from "../../../product-identity.js";
+import { projectResidentTabShortcuts, RESIDENT_TAB_GLOBAL_SHORTCUTS } from "../../../features/resident-tab/index.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { getPiHotkeysMarkdownTheme, getPiMarkdownTheme, paintPiBorder, PINNED_PI_LAYOUT, piTheme } from "./theme.js";
 import { componentPort, ensureTheme, formatSessionTokens } from "./shell-shared-facade.js";
@@ -147,9 +148,9 @@ function shortcutDisplay(key) {
         return label.charAt(0).toUpperCase() + label.slice(1);
     }).join("+")).join("/");
 }
-export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi") {
+export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi", residentTabs = false) {
     ensureTheme();
-    const markdown = hotkeysMarkdown(bindings, getShortcuts, profile);
+    const markdown = hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs);
     const container = new Container();
     container.addChild(new Spacer(1));
     container.addChild(new DynamicBorder(paintPiBorder));
@@ -162,12 +163,14 @@ export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export function renderPiShellHotkeysLines(presentation, width) {
     ensureTheme();
-    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi")).render(width);
+    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi", presentation.residentTabs)).render(width);
 }
 function hotkeysMarkdownComponent(markdown) {
     return new Markdown(markdown, 1, 1, getPiHotkeysMarkdownTheme());
 }
-export function hotkeysMarkdown(bindings, getShortcuts, profile) {
+/** The global tab declarations the hotkeys document lists, straight from the feature's declarations. */
+export const TAB_HOTKEYS = RESIDENT_TAB_GLOBAL_SHORTCUTS.map(shortcut => [shortcut.id, shortcut.defaultKey, shortcut.description]);
+export function hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs = false) {
     const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(bindings) : new KeybindingsManager(bindings);
     // Compatibility: the owned viewport consumes these physical chords before editor actions.
     const display = (action) => keys.getKeys(action)
@@ -180,6 +183,17 @@ export function hotkeysMarkdown(bindings, getShortcuts, profile) {
             : `\`${label}\``;
     }).join(" / ")} | ${description} |`;
     let markdown = ["**Navigation**", "| Key | Action |", "|-----|--------|", row(["tui.editor.cursorUp", "tui.editor.cursorDown", "tui.editor.cursorLeft", "tui.editor.cursorRight"], "Move cursor / browse history"), row(["tui.editor.cursorWordLeft", "tui.editor.cursorWordRight"], "Move by word"), row(["tui.editor.cursorLineStart"], profile === "a1" ? "Start of prompt line" : "Start of line"), row(["tui.editor.cursorLineEnd"], profile === "a1" ? "End of prompt line" : "End of line"), ...(profile === "a1" ? ["| `Ctrl+Home` | Start of content |", "| `Ctrl+End` | End of content / follow output |"] : []), row(["tui.editor.jumpForward"], "Jump forward to character"), row(["tui.editor.jumpBackward"], "Jump backward to character"), row(["tui.editor.pageUp", "tui.editor.pageDown"], "Scroll by page"), "", "**Editing**", "| Key | Action |", "|-----|--------|", row(["tui.input.submit"], "Send message"), row(["tui.input.newLine"], `New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""}`), row(["tui.editor.deleteWordBackward"], "Delete word backwards"), row(["tui.editor.deleteWordForward"], "Delete word forwards"), row(["tui.editor.deleteToLineStart"], "Delete to start of line"), row(["tui.editor.deleteToLineEnd"], "Delete to end of line"), row(["tui.editor.yank"], "Paste the most-recently-deleted text"), row(["tui.editor.yankPop"], "Cycle through the deleted text after pasting"), row(["tui.editor.undo"], "Undo"), "", "**Other**", "| Key | Action |", "|-----|--------|", row(["tui.input.tab"], "Path completion / accept autocomplete"), row(["app.interrupt"], "Cancel autocomplete / abort streaming"), row(["app.clear"], "Clear editor (first) / exit (second)"), row(["app.exit"], "Exit (when editor is empty)"), row(["app.suspend"], "Suspend to background"), row(["app.thinking.cycle"], "Cycle thinking level"), row(["app.model.cycleForward", "app.model.cycleBackward"], "Cycle models"), row(["app.model.select"], profile === "a1" ? "Open the Models dialog" : "Open model selector"), row(["app.tools.expand"], "Toggle tool output expansion"), row(["app.thinking.toggle"], "Toggle thinking block visibility"), row(["app.editor.external"], "Edit message in external editor"), row(["app.message.copy"], "Copy selection or last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], profile === "a1" ? "Paste image or text from clipboard" : "Paste files on macOS, images, or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |", ...(profile === "a1" ? ["", "**Models dialog**", "| Key | Action |", "|-----|--------|", "| `Space` | Toggle the selected model in the cycling scope |", "| `Tab` | Switch the all/scoped filter |", row(["app.models.save"], "Save the scope to settings"), row(["app.models.enableAll"], "Scope every listed model"), row(["app.models.clearAll"], "Clear the listed models from the scope"), row(["app.models.toggleProvider"], "Toggle the selected model's provider"), row(["app.models.reorderUp", "app.models.reorderDown"], "Reorder the cycling scope")] : [])].join("\n");
+    if (profile === "a1" && residentTabs) {
+        // Invariant: the Tabs section shows the same projection the resident shell dispatches: the
+        // effective A1 declarations keep their keys and earlier tab declarations keep duplicates.
+        const projection = projectResidentTabShortcuts({ configured: bindings, reserved: keys.getEffectiveConfig() });
+        markdown += "\n\n**Tabs**\n| Key | Action |\n|-----|--------|\n";
+        markdown += RESIDENT_TAB_GLOBAL_SHORTCUTS.map(shortcut => {
+            const assigned = projection.assignments[shortcut.id];
+            const label = assigned === null ? "Unbound" : `\`${shortcutDisplay(assigned)}\``;
+            return `| ${label} | ${shortcut.description} |`;
+        }).join("\n");
+    }
     const shortcuts = getShortcuts(bindings ?? keys.getEffectiveConfig());
     if (shortcuts.length > 0) {
         markdown += "\n\n**Extensions**\n| Key | Action |\n|-----|--------|\n";

package/dist/integrations/pi/components/shell-presenters-transcript.js

@@ -4,7 +4,7 @@ import { SkillInvocationMessageComponent } from "./upstream/components/skill-inv
 import { piToolArguments as toolArguments, updatePiToolResult as updateToolResult } from "./tool-result-adapter.js";
 import { createTranscriptImageResolver } from "./transcript-image-resolver.js";
 import { createMermaidMarkdownTransformer } from "./upstream/components/mermaid.js";
-import { Container, Image, Spacer, Text, } from "@earendil-works/pi-tui";
+import { Container, getCapabilities, Image, Spacer, Text, } from "@earendil-works/pi-tui";
 import { createPiSubmittedPromptComponent, isPiPromptStyleCompaction, } from "./submitted-prompt-adapter.js";
 export { isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp } from "./submitted-prompt-adapter.js";
 import { getPiMarkdownTheme, PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
@@ -127,7 +127,10 @@ function withTranscriptImages(component, block, assets, showImages, imageWidthCe
         return component;
     const container = new Container();
     container.addChild(component);
+    const imageProtocolUnavailable = getCapabilities().images === null;
     for (const reference of references) {
+        if (showImages && imageProtocolUnavailable)
+            continue;
         container.addChild(new Spacer(1));
         const asset = assets?.resolve(reference.assetId) ?? null;
         if (!showImages) {

package/dist/integrations/pi/components/shell-selectors-dialogs.js

@@ -3,7 +3,7 @@ import { EarendilAnnouncementComponent } from "./upstream/components/earendil-an
 import { ExtensionSelectorComponent } from "./upstream/components/extension-selector.js";
 import { Box, Container, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
 import { ScopedModelsSelectorComponent } from "./upstream/components/scoped-models-selector.js";
-import { addPiModalSelectFooter, adoptPiModalFrame, adoptPiModalHeader } from "./modal-frame.js";
+import { addPiModalSelectFooter, adoptPiModalFrame, adoptPiModalHeader, adoptPiModalSearchInput } from "./modal-frame.js";
 import { ModelsDialogComponent } from "./models-dialog.js";
 import { TrustSelectorComponent } from "./upstream/components/trust-selector.js";
 import { canonicalizePiSettingsHint, DIALOG_CLOSE_SHORTCUT_HINT, PINNED_PI_LAYOUT, getPiSelectListTheme, paintPiBorder, piTheme, renderPiModalShortcutHints, } from "./theme.js";
@@ -66,6 +66,7 @@ export function createPiShellSettingsSelector(options) {
         onAutocompleteMaxVisibleChange: change("onAutocompleteMaxVisibleChange"),
         onQuietStartupChange: change("onQuietStartupChange"),
         onDefaultProjectTrustChange: change("onDefaultProjectTrustChange"),
+        onSessionShareDestinationChange: change("onSessionShareDestinationChange"),
         onClearOnShrinkChange: change("onClearOnShrinkChange"),
         onShowTerminalProgressChange: change("onShowTerminalProgressChange"),
         onTuiModeChange: change("onTuiModeChange"),
@@ -95,6 +96,7 @@ export function createPiShellSettingsSelector(options) {
 export function createPiShellModelSelector(options) {
     ensureTheme();
     const selector = new ModelSelectorComponent(createTuiFacade(options.runtime), options.currentModel, options.modelRuntime, options.scopedModels, options.onSelect, options.onCancel, options.initialSearchInput, options.onSelectAsDefault, options.defaultModel);
+    adoptPiModalSearchInput(selector, selector.getSearchInput());
     adoptPiModalFrame(selector, { topIndex: 0, bottomIndex: selector.children.length - 1 });
     return componentPort(selector);
 }
@@ -234,6 +236,8 @@ export function createPiShellAuthProviderSelector(mode, providers, onSelect, onC
         if (selected)
             onSelect(selected.id);
     }, onCancel, initialSearchInput);
+    // Provenance: OAuth selector slot is top rule, spacer, title, spacer, then its search Input.
+    adoptPiModalSearchInput(selector, selector.children[4]);
     addPiModalSelectFooter(selector);
     const preInsetContent = [selector.children[2], selector.children[6]];
     const header = adoptPiModalHeader(selector, 0, 2);

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -64,6 +64,8 @@ export interface PiShellEditorPort extends PiShellComponentPort {
     canPresentPromptSuggestion(): boolean;
     promptSuggestionBlockReason?(): SuggestionDecision;
     hasSelection(): boolean;
+    /** Exact expanded semantic editor selection without mutating or collapsing it. */
+    selectedText?(): string | undefined;
     ownsPointer(): boolean;
     handlePointer(event: PiShellEditorPointerEvent): boolean;
     pasteClipboard(): boolean;
@@ -159,9 +161,18 @@ export interface PiShellPasteReservation {
 }
 export interface PiShellEditorOptions {
     readonly persistentHistory?: boolean;
+    /** Configures the shared interactive input for a caller narrower than the agent prompt. */
+    readonly inputCapabilities?: {
+        readonly singleLine?: boolean;
+        readonly paste?: boolean;
+        readonly autocomplete?: boolean;
+        readonly placeholder?: string;
+    };
     readonly historyEditor?: HistoryEditorConstructor;
     /** Bare A1 adds ergonomic aliases while comparison profiles retain Pi defaults. */
     readonly keybindingProfile?: "pi" | "a1";
+    /** Resident Agents expose Settings and the changelog as utility tabs instead of slash commands. */
+    readonly hideUtilityTabCommands?: boolean;
     /** The process's shared keybindings; its profile must match `keybindingProfile`. */
     readonly keybindings?: PiKeybindingsHost;
     readonly getColumns: () => number;
@@ -185,7 +196,7 @@ export interface PiShellEditorOptions {
     readonly onFollowUp?: (() => void) | undefined;
     readonly onDequeue?: (() => void) | undefined;
     readonly onPromptSuggestionAccepted?: (text: string) => void;
-    readonly onCopyText?: (text: string) => void;
+    readonly onCopyText?: (text: string, cut: boolean) => void;
     readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
     readonly beginClipboardPaste?: () => PiShellPasteReservation;
     readonly beginTextPaste?: (text: string) => PiShellPasteReservation;

package/dist/integrations/pi/components/skills-dialog.js

@@ -1,6 +1,6 @@
 import { DynamicBorder } from "../startup-public.js";
 import { Container, getKeybindings, Input, Spacer, Text } from "@earendil-works/pi-tui";
-import { addPiModalHeader, adoptPiModalFrame } from "./modal-frame.js";
+import { addPiModalHeader, addPiModalSearchInput, adoptPiModalFrame } from "./modal-frame.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT, paintPiBorder, PINNED_PI_LAYOUT, piTheme, renderPiModalListRow, renderPiModalShortcutHints, } from "./theme.js";
 import { componentPort, ensureTheme, piShellTruncateToWidth, piShellVisibleWidth } from "./shell-shared-facade.js";
 import { skillMatchesQuery } from "./skills-command.js";
@@ -50,7 +50,7 @@ class SkillsSelectorComponent extends Container {
         this.#searchInput.onSubmit = () => this.#selectCurrent();
         const header = addPiModalHeader(this, new DynamicBorder(paintPiBorder), new Text(piTheme().fg("accent", piTheme().bold("Skills")), 0, 0));
         this.addChild(new Spacer(1));
-        this.addChild(this.#searchInput);
+        addPiModalSearchInput(this, this.#searchInput);
         this.addChild(new Spacer(1));
         this.addChild(this.#listContainer);
         this.addChild(new Spacer(1));

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
  * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling, unbound model

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
  * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling, unbound model
@@ -9,7 +9,7 @@
  * Deviations: keybindings-public-config-boundary, owned-level-cycle-shortcut,
  * owned-input-keybinding-aliases, owned-session-tree-dialog, owned-dialog-ctrl-c-cancel.
  */
-import { matchesKey, TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@earendil-works/pi-tui";
+import { Key, matchesKey, TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@earendil-works/pi-tui";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { getAgentDir } from "../../../../startup-public.js";
@@ -278,14 +278,27 @@ const KEYBINDING_NAME_MIGRATIONS = {
 function isLegacyKeybindingName(key) {
     return key in KEYBINDING_NAME_MIGRATIONS;
 }
+const KEYBINDING_MODIFIERS = ["ctrl", "shift", "alt", "super"];
+const BASE_KEY_PATTERN = `(?:[a-z0-9]|${Object.values(Key)
+    .flatMap((value) => (typeof value === "string" ? [value.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&")] : []))
+    .join("|")})`;
+const DUPLICATE_MODIFIER_PATTERN = KEYBINDING_MODIFIERS
+    .map((modifier) => `${modifier}\\+.*${modifier}\\+`)
+    .join("|");
+const KEY_ID_PATTERN = new RegExp(`^(?!.*(?:${DUPLICATE_MODIFIER_PATTERN}))(?:(?:${KEYBINDING_MODIFIERS.join("|")})\\+){0,4}${BASE_KEY_PATTERN}$`);
+function isKeyId(value) {
+    return typeof value === "string" && KEY_ID_PATTERN.test(value);
+}
 function toKeybindingsConfig(value) {
     const config = {};
     for (const [key, binding] of Object.entries(value)) {
-        if (typeof binding === "string") {
+        if (key === "$schema")
+            continue;
+        if (isKeyId(binding)) {
             config[key] = binding;
             continue;
         }
-        if (Array.isArray(binding) && binding.every((entry) => typeof entry === "string")) {
+        if (Array.isArray(binding) && binding.every(isKeyId)) {
             config[key] = binding;
         }
     }

package/dist/integrations/pi/components/upstream/assets/earendil-image.json

@@ -1,8 +1,8 @@
 {
     "sourcePackage": "@earendil-works/pi-coding-agent",
-    "sourceVersion": "1.1.0",
+    "sourceVersion": "1.4.0",
     "upstreamRepository": "https://github.com/earendil-works/pi.git",
-    "upstreamCommit": "abe508e1b89912adde45528136c3221eb69acdd7",
+    "upstreamCommit": "4a080252f06caf63a525d7873c5d94d3c23887e0",
     "sourcePath": "dist/modes/interactive/assets/clankolas.png",
     "sourceSha256": "169acd0dfe6fbb8d8742ed24a3fc654fd0b2e2d4223c733249c5493723f1b72d",
     "license": "MIT",

package/dist/integrations/pi/components/upstream/components/countdown-timer.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/countdown-timer.ts.
  * Modifications: Mechanical source port with ECMAScript private fields; imports remain on the public
  * Pi TUI package root.

package/dist/integrations/pi/components/upstream/components/earendil-announcement.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/earendil-announcement.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries. The unchanged image is loaded lazily from its attributed,

package/dist/integrations/pi/components/upstream/components/extension-editor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,

package/dist/integrations/pi/components/upstream/components/extension-editor.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,

package/dist/integrations/pi/components/upstream/components/extension-input.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/extension-input.ts.
  * Modifications: Mechanical port: remap public imports, use ECMAScript private fields, and route the
  * bare-A1 instruction row and chrome through the shared semantic shortcut and compact padded

package/dist/integrations/pi/components/upstream/components/extension-selector.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/extension-selector.ts.
  * Modifications: Mechanical port: remap public imports, use ECMAScript private fields, and route the
  * bare-A1 instruction row and chrome through the shared semantic shortcut and compact padded

package/dist/integrations/pi/components/upstream/components/mermaid.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/mermaid.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries; behavior remains acceptance-tested.

package/dist/integrations/pi/components/upstream/components/owned-editor.d.ts

@@ -1,13 +1,13 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input
- * frame, transient contextual-suggestion branch, and explicit body geometry for selection and
- * above-prompt autocomplete with a one-cell outer gutter. Bare A1 also clears a sole top-level
- * slash-command search on Escape and completes a selected or exact completed tunnel command with `:`
- * and reopens the menu on its tunnel rows, and synchronously retains then refreshes an exact top-level
- * command menu after Tab applies its row.
+ * frame, configurable empty-input placeholder branch, transient contextual-suggestion branch, and
+ * explicit body geometry for selection and above-prompt autocomplete with a one-cell outer gutter.
+ * Bare A1 also clears a sole top-level slash-command search on Escape and completes a selected or
+ * exact completed tunnel command with `:` and reopens the menu on its tunnel rows, and synchronously
+ * retains then refreshes an exact top-level command menu after Tab applies its row.
  * Deviations: owned-shared-input-frame, above-prompt-autocomplete-placement,
  * clear-command-search-on-escape, command-tunnel-colon-completion, keep-command-menu-open-after-tab.
  */
@@ -21,6 +21,8 @@ export interface OwnedEditorOptions extends EditorOptions {
     readonly inputPresentation?: PiShellPromptInputPresentation;
     readonly styleSuggestion?: (text: string) => string;
     readonly styleSuggestionCaret?: (text: string) => string;
+    /** Non-accepting empty-input guidance rendered through the shared suggestion presentation. */
+    readonly placeholder?: string;
     readonly terminalRows?: () => number;
     /** Reuses the editor's established atomic-aware visual layout when available. */
     readonly getVisualLineCount?: (width: number) => number | undefined;