@timurproko/a1 0.2.7-dev.809 → 0.2.7-dev.820

package/README.md

@@ -185,13 +185,15 @@ a1 update npm:pi-mcp-adapter
 
 ## Develop
 
+A source build needs Node.js, npm, git, and Rustup. Windows additionally needs Visual Studio or Visual Studio Build Tools with the **Desktop development with C++** workload, MSVC x64/x86 tools, and a Windows SDK; Visual Studio Code is not required. A1 discovers installed Rustup and Visual Studio tools and initializes them for build children, so Git Bash and ordinary PowerShell do not need manual `PATH` or developer-shell setup. It never installs these tools or accepts their licenses automatically.
+
 Install exact locked dependencies:
 
 ```text
 npm ci
 ```
 
-Compile TypeScript and the process guardian into `dist`:
+Compile TypeScript and the native addons into `dist`:
 
 ```text
 npm run build
@@ -221,7 +223,7 @@ Complete non-physical suite:
 npm run test:full
 ```
 
-Report Node, npm, git, Rust, and dependency readiness:
+Report Node, npm, git, Rust, dependency, and Windows C++ readiness. Missing Windows tools are listed in setup order; after installing them, rerun the same build command:
 
 ```text
 npm run doctor

package/dist/app/session-shell/resident-tab-coordinator.d.ts

@@ -1,18 +1,15 @@
 import type { OwnedUiEvent, PromptHistoryImageSidecarPort } from "../../contracts/owned-ui/index.js";
 import type { SessionConcern } from "./session-concern.js";
 import type { OwnedUiShellEngineOptions, OwnedUiSessionShellRoot } from "./session-shell-root.js";
-import type { OwnedUiPresenterTerminal } from "./shell-host.js";
 export type ResidentTabOptions = NonNullable<OwnedUiShellEngineOptions["residentTab"]>;
 export interface ResidentTabCoordinatorPorts {
     readonly root: Pick<OwnedUiSessionShellRoot, "appendWorkflowStatus" | "rehydrateHistoryText" | "editor">;
-    readonly terminal: Pick<OwnedUiPresenterTerminal, "requestRender">;
-    readonly disposed: () => boolean;
 }
 /**
- * The session presenter's side of a resident tab: recovered input, the progress and stall status
- * it reports to the strip, prompt admission and correlation through the recovery journal, draft
- * checkpoints, detach on quit, and the graceful stop when the presenter is released. Outside a
- * resident tab every operation is a no-op.
+ * The session presenter's side of a resident tab: recovered input, the idle status it reports to
+ * the strip, prompt admission and correlation through the recovery journal, draft checkpoints,
+ * detach on quit, and the graceful stop when the presenter is released. Outside a resident tab
+ * every operation is a no-op.
  */
 export declare class ResidentTabCoordinator implements SessionConcern {
     #private;
@@ -23,8 +20,8 @@ export declare class ResidentTabCoordinator implements SessionConcern {
     closeOwnedRoute(route: string): void;
     /** Puts the prompts and draft a previous tab process left unfinished back into the editor. */
     restoreInput(imageSidecar?: PromptHistoryImageSidecarPort): void;
-    /** Tracks working, idle, and stalled status from session events and arms the stall notice. */
-    observeProgress(event: OwnedUiEvent): void;
+    /** Reports idle to the strip whenever the session leaves its busy lifecycle. */
+    observeLifecycle(event: OwnedUiEvent): void;
     /** Journals a prompt before it is sent; undefined outside a resident tab. Rejects when the journal cannot sync. */
     admit(input: Parameters<NonNullable<ResidentTabOptions["admit"]>>[0]): Promise<{
         readonly id: string;

package/dist/app/session-shell/resident-tab-coordinator.js

@@ -1,18 +1,12 @@
-const PROGRESS_EVENTS = new Set([
-    "transcript-block", "session-view", "assistant-message-completed", "agent-run-started",
-]);
 /**
- * The session presenter's side of a resident tab: recovered input, the progress and stall status
- * it reports to the strip, prompt admission and correlation through the recovery journal, draft
- * checkpoints, detach on quit, and the graceful stop when the presenter is released. Outside a
- * resident tab every operation is a no-op.
+ * The session presenter's side of a resident tab: recovered input, the idle status it reports to
+ * the strip, prompt admission and correlation through the recovery journal, draft checkpoints,
+ * detach on quit, and the graceful stop when the presenter is released. Outside a resident tab
+ * every operation is a no-op.
  */
 export class ResidentTabCoordinator {
     #options;
     #ports;
-    #progressTimer;
-    #working = false;
-    #stalled = false;
     constructor(options, ports) {
         this.#options = options;
         this.#ports = ports;
@@ -51,40 +45,10 @@ export class ResidentTabCoordinator {
             root.appendWorkflowStatus("Recovered the editor draft from the previous tab process.");
         }
     }
-    /** Tracks working, idle, and stalled status from session events and arms the stall notice. */
-    observeProgress(event) {
-        const resident = this.#options;
-        const seconds = resident?.stallNoticeSeconds;
-        if (resident === undefined || seconds === undefined)
-            return;
-        if (event.type === "session-lifecycle") {
-            this.#working = event.lifecycle === "busy";
-            if (!this.#working) {
-                this.#clearTimer();
-                this.#stalled = false;
-                resident.reportStatus?.("idle");
-                return;
-            }
-        }
-        else if (!this.#working || !PROGRESS_EVENTS.has(event.type)) {
-            return;
-        }
-        if (this.#stalled) {
-            this.#stalled = false;
-            resident.reportStatus?.("working");
-        }
-        this.#clearTimer();
-        this.#progressTimer = setTimeout(() => {
-            this.#progressTimer = undefined;
-            if (this.#ports.disposed() || !this.#working)
-                return;
-            this.#stalled = true;
-            resident.reportStatus?.("stalled");
-            const minutes = Math.max(1, Math.round(seconds / 60));
-            this.#ports.root.appendWorkflowStatus(`No progress for ${minutes} min — Esc interrupts · use the tab restart action to restart`);
-            this.#ports.terminal.requestRender();
-        }, seconds * 1_000);
-        this.#progressTimer.unref?.();
+    /** Reports idle to the strip whenever the session leaves its busy lifecycle. */
+    observeLifecycle(event) {
+        if (event.type === "session-lifecycle" && event.lifecycle !== "busy")
+            this.#options?.reportStatus?.("idle");
     }
     /** Journals a prompt before it is sent; undefined outside a resident tab. Rejects when the journal cannot sync. */
     admit(input) {
@@ -109,12 +73,5 @@ export class ResidentTabCoordinator {
     gracefulStop(sessionFile) {
         return this.#options?.gracefulStop?.(sessionFile) ?? Promise.resolve();
     }
-    dispose() {
-        this.#clearTimer();
-    }
-    #clearTimer() {
-        if (this.#progressTimer !== undefined)
-            clearTimeout(this.#progressTimer);
-        this.#progressTimer = undefined;
-    }
+    dispose() { }
 }

package/dist/app/session-shell/response-copy-transport.d.ts

@@ -22,6 +22,19 @@ export interface ResponseCopyTerminal {
 }
 /** Never substitute a remote host's native clipboard for the terminal user's clipboard. */
 export declare function responseCopyDestination(env: NodeJS.ProcessEnv): "native" | "terminal";
+/**
+ * Spawn options for one operating-system clipboard writer.
+ * Platform: on POSIX the writer is detached into its own process group, as pinned Pi 1.4 does, so a writer
+ * that daemonizes to keep serving the clipboard is not stopped when Ctrl+Z sends SIGTSTP to the shell's group.
+ */
+export declare function platformClipboardWriteOptions(signal: AbortSignal, platform?: NodeJS.Platform): {
+    signal: AbortSignal;
+    windowsHide: boolean;
+    timeout: number;
+    killSignal: "SIGKILL";
+    maxBuffer: number;
+    detached: boolean;
+};
 /** Isolates preparation and native clipboard access; only the owner may submit terminal controls. */
 export declare function createResponseCopyExecutor(options?: {
     readonly terminal?: ResponseCopyTerminal;

package/dist/app/session-shell/response-copy-transport.js

@@ -21,6 +21,21 @@ function platformClipboardCommands() {
         { command: "xclip", args: ["-selection", "clipboard", "-in"] },
     ];
 }
+/**
+ * Spawn options for one operating-system clipboard writer.
+ * Platform: on POSIX the writer is detached into its own process group, as pinned Pi 1.4 does, so a writer
+ * that daemonizes to keep serving the clipboard is not stopped when Ctrl+Z sends SIGTSTP to the shell's group.
+ */
+export function platformClipboardWriteOptions(signal, platform = process.platform) {
+    return {
+        signal,
+        windowsHide: true,
+        timeout: PLATFORM_WRITE_TIMEOUT_MS,
+        killSignal: "SIGKILL",
+        maxBuffer: 1_024,
+        detached: platform !== "win32",
+    };
+}
 async function writePlatformClipboardText(text, signal) {
     for (const route of platformClipboardCommands()) {
         if (signal.aborted)
@@ -33,13 +48,7 @@ async function writePlatformClipboardText(text, signal) {
                 settled = true;
                 resolve(value);
             };
-            const child = execFile(route.command, [...route.args], {
-                signal,
-                windowsHide: true,
-                timeout: PLATFORM_WRITE_TIMEOUT_MS,
-                killSignal: "SIGKILL",
-                maxBuffer: 1_024,
-            }, error => done(error === null));
+            const child = execFile(route.command, [...route.args], platformClipboardWriteOptions(signal), error => done(error === null));
             child.once("error", () => done(false));
             if (child.stdin === null) {
                 child.kill("SIGKILL");

package/dist/app/session-shell/session-shell-root.d.ts

@@ -47,8 +47,7 @@ export interface OwnedUiShellEngineOptions {
     readonly residentTab?: {
         requestDetach(): Promise<boolean>;
         closeOwnedRoute?(route: string): void;
-        reportStatus?(status: "working" | "idle" | "stalled"): void;
-        readonly stallNoticeSeconds?: number;
+        reportStatus?(status: "working" | "idle"): void;
         admit?(input: {
             readonly sessionId: string;
             readonly sessionFile: string | null;

package/dist/app/session-shell/session-shell.js

@@ -251,7 +251,7 @@ export class OwnedUiSessionPresenter {
             // Invariant: the presenter owns its root (theme subscription and helper clients) and disposes it once the
             // terminal no longer renders it.
             constructed.push(() => this.root.dispose());
-            this.#resident = new ResidentTabCoordinator(options.engine.residentTab, { root: this.root, terminal: this.#terminal, disposed: () => this.#disposed });
+            this.#resident = new ResidentTabCoordinator(options.engine.residentTab, { root: this.root });
             constructed.push(() => this.#resident.dispose());
             const startupRoute = options.engine.startupRoute;
             this.#dialogs = new SessionDialogCoordinator({
@@ -366,7 +366,7 @@ export class OwnedUiSessionPresenter {
                         this.#stop.settleAfter(() => this.dispose());
                     return;
                 }
-                this.#resident.observeProgress(event);
+                this.#resident.observeLifecycle(event);
                 // Performance: a streamed chunk names one block, and touching only that block is what keeps the
                 // cost of a chunk the same in a long session as in a new one. Everything else
                 // resynchronizes the view, which is cheap next to re-reading the transcript.

package/dist/app/session-shell/session-viewport-controller.js

@@ -322,8 +322,8 @@ export class SessionViewportController {
                     this.#requestRender();
             }
         }
-        const previousPrompt = SHIFT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
-        if (editorActive && allowWheel && (previousPrompt || SHIFT_DOWN_INPUTS.has(data))) {
+        const previousPrompt = PROMPT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
+        if (editorActive && allowWheel && (previousPrompt || PROMPT_DOWN_INPUTS.has(data))) {
             const scrolled = previousPrompt
                 ? this.#viewport.scrollToPreviousPrompt(now)
                 : this.#viewport.scrollToNextPrompt(now);
@@ -670,5 +670,7 @@ export class SessionViewportController {
 }
 const SELECTION_AUTO_SCROLL_INTERVAL_MS = 30;
 const EDITOR_LINK_DELETION_INPUTS = new Set(["\b", "\u007f", "\u001b[3~"]);
-const SHIFT_UP_INPUTS = new Set(["\u001b[1;2A"]);
-const SHIFT_DOWN_INPUTS = new Set(["\u001b[1;2B"]);
+// Platform: Windows Terminal may consume Shift+Arrow for native selection. Ctrl+Arrow matches
+// solo A1's Windows binding while retaining Shift+Arrow whenever the terminal delivers it.
+const PROMPT_UP_INPUTS = new Set(["\u001b[1;2A", "\u001b[1;5A"]);
+const PROMPT_DOWN_INPUTS = new Set(["\u001b[1;2B", "\u001b[1;5B"]);

package/dist/composition/owned-ui.js

@@ -50,7 +50,7 @@ export async function composeOwnedUi(options = {}) {
             namespace: PRODUCT_IDENTITY.commandName,
             legacyConfigDir: productPaths.configDir,
             agentProvider: () => backend.settingsPort(),
-            ...(options.hideTabSettings ? { hiddenOwnedSettingIds: ["tabsAutoName"] } : {}),
+            ...(options.hideTabSettings ? { hiddenOwnedSettingIds: ["tabsAutoName", "tabsPosition"] } : {}),
             hiddenAgentSettingIds: ["fullscreenWheelScrollLines"],
             agentSettingLabelOverrides: { fullscreenCopyOnSelect: "Copy on select" },
         });
@@ -221,7 +221,6 @@ export async function composeOwnedUi(options = {}) {
                                 void tabBridge.requestClose();
                         },
                         reportStatus: status => tabBridge.status(status),
-                        stallNoticeSeconds: 300,
                         admit: input => tabRecovery.admit({ ...input, incarnation: options.tab.incarnation }),
                         dispatched: () => tabRecovery.dispatched(),
                         correlated: (submissionId, entryId) => correlateResidentTabSubmission(tabRecovery, backend, submissionId, entryId),

package/dist/features/owned-ui/settings-app.js

@@ -1026,7 +1026,7 @@ export class SettingsApp {
         const input = this.#filter;
         if (input === null)
             return [status];
-        return [...renderInputRow(input, width, { placeholder: SEARCH_PLACEHOLDER, theme }).lines, status];
+        return [...renderInputRow(input, width, { placeholder: SEARCH_PLACEHOLDER, promptGlyph: "", theme }).lines, status];
     }
 }
 function modelLabelParts(label) {

package/dist/foundation/release/progress-palette.generated.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.3.0
- * (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0. Do not edit directly.
+ * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.4.0
+ * (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0. Do not edit directly.
  */
 export declare const SHARED_PROGRESS_ACCENT_ANSI = "\u001B[38;2;167;152;215m";

package/dist/foundation/release/progress-palette.generated.js

@@ -1,5 +1,5 @@
 /**
- * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.3.0
- * (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0. Do not edit directly.
+ * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.4.0
+ * (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0. Do not edit directly.
  */
 export const SHARED_PROGRESS_ACCENT_ANSI = "\u001b[38;2;167;152;215m";

package/dist/foundation/resident-tabs/bridge-client.d.ts

@@ -1,4 +1,4 @@
-export type ResidentTabStatus = "starting" | "working" | "needs-input" | "done-unseen" | "done" | "aborted" | "error" | "idle" | "unresponsive" | "stalled" | "crashed" | "restarting" | "failed";
+export type ResidentTabStatus = "starting" | "working" | "needs-input" | "done-unseen" | "done" | "aborted" | "error" | "idle" | "unresponsive" | "crashed" | "restarting" | "failed";
 export interface TabBridgeCredentials {
     readonly tabId: string;
     readonly token: string;

package/dist/foundation/resident-tabs/bridge-client.js

@@ -80,7 +80,7 @@ export class TabBridgeClient {
     }
     status(state, degraded = false, pendingRequests = 0, queuedInput = 0) {
         this.#latestStatus = { state, degraded, accent: this.#accent, pendingRequests, queuedInput };
-        const recoveryState = state === "unresponsive" || state === "stalled" || state === "crashed" || state === "restarting" || state === "failed";
+        const recoveryState = state === "unresponsive" || state === "crashed" || state === "restarting" || state === "failed";
         if (recoveryState && !this.#supports("recovery-status"))
             return;
         this.#send("bridge.status", {

package/dist/foundation/resident-tabs/settings.d.ts

@@ -7,7 +7,6 @@ export interface ResidentTabLaunchSettings {
     readonly maxConcurrentStarts: number;
     readonly prewarmCount: number;
     readonly unresponsiveRestartSeconds: number;
-    readonly stallNoticeSeconds: number;
 }
 /** Read only resident-launch values before any UI or extension module is loaded. */
 export declare function readResidentTabLaunchSettings(profileDir: string, namespace?: string, legacyConfigDir?: string, profileId?: string): Promise<ResidentTabLaunchSettings>;

package/dist/foundation/resident-tabs/settings.js

@@ -11,7 +11,6 @@ const DEFAULTS = Object.freeze({
     maxConcurrentStarts: RESIDENT_TABS_MAX_CONCURRENT_STARTS,
     prewarmCount: RESIDENT_TABS_PREWARM_COUNT,
     unresponsiveRestartSeconds: 120,
-    stallNoticeSeconds: 300,
 });
 /** Read only resident-launch values before any UI or extension module is loaded. */
 export async function readResidentTabLaunchSettings(profileDir, namespace = "a1", legacyConfigDir, profileId = namespace) {
@@ -55,6 +54,5 @@ function resolveLaunchValues(document, migrations) {
         maxConcurrentStarts: RESIDENT_TABS_MAX_CONCURRENT_STARTS,
         prewarmCount: RESIDENT_TABS_PREWARM_COUNT,
         unresponsiveRestartSeconds: DEFAULTS.unresponsiveRestartSeconds,
-        stallNoticeSeconds: DEFAULTS.stallNoticeSeconds,
     };
 }

package/dist/foundation/startup/startup-descriptor.js

@@ -10,7 +10,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   ],
   "generatedArtifact": {
     "path": "dist/integrations/pi/startup-public.js",
-    "sha256": "bca69314139a5503ccfc0678ffc86f3b7160f57a6ca55c86239b6587d3f627a3"
+    "sha256": "e065933fe374d7953c5aac0ff1735fa47d119ab97551e955c2a65e8c2df667eb"
   },
   "dependencyLayerIdentity": {
     "source": "A1_RELEASE_LAYERS",
@@ -19,7 +19,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   "compileCacheNamespace": {
     "strategy": "node-abi-version-and-ordered-layer-sha256-v1"
   },
-  "identity": "163053e701440c93391663404f0d4ae96c74f66773fa0ca99f98c39b68a5d37b"
+  "identity": "5c1afab4657c251b840e042279290bd1fa03ce608bc81bc6e7eaf8d332486eef"
 });
 
 export function loadDeclaredStartupGraph() {

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

@@ -1,6 +1,6 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.3.0 (MIT),
- * commit 71023aec1546d6d677a65669c5665c0927ce0dd0.
+ * 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.

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

@@ -1,6 +1,6 @@
 /**
- * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.3.0 (MIT),
- * commit 71023aec1546d6d677a65669c5665c0927ce0dd0.
+ * 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.

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/upstream/adjacent/core/keybindings.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.3.0 (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0,
+ * 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.3.0 (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0,
+ * 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/assets/earendil-image.json

@@ -1,8 +1,8 @@
 {
     "sourcePackage": "@earendil-works/pi-coding-agent",
-    "sourceVersion": "1.3.0",
+    "sourceVersion": "1.4.0",
     "upstreamRepository": "https://github.com/earendil-works/pi.git",
-    "upstreamCommit": "71023aec1546d6d677a65669c5665c0927ce0dd0",
+    "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.3.0 (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0,
+ * 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.3.0 (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0,
+ * 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.3.0 (MIT), commit 71023aec1546d6d677a65669c5665c0927ce0dd0,
+ * 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,