@timurproko/a1 0.2.7-dev.1270 → 0.2.7-dev.1276

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

@@ -1,4 +1,6 @@
 import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput } from "../../ui/components/mouse.js";
+import { renderModalBackdrop } from "../../ui/components/spans.js";
+import { padToWidth } from "../../ui/components/text.js";
 import { readVisibleHyperlinks } from "../../ui/components/visible-hyperlinks.js";
 import { pinnedLayoutRoot, } from "./session-shell-root.js";
 /** The size and render request a Pi component reads from the terminal it is shown on, read on every call. */
@@ -37,7 +39,7 @@ export function sessionTerminalHostOptions(options) {
 export class OwnedUiTerminalHost {
     runtime;
     #customViewport;
-    #runtimeFactory;
+    #presentation;
     #damageTerminal;
     #quitOutro;
     #presenters = new Set();
@@ -51,7 +53,7 @@ export class OwnedUiTerminalHost {
     #ending;
     constructor(options) {
         this.#customViewport = options.layout === "custom-viewport";
-        this.#runtimeFactory = options.presentation.terminalRuntime;
+        this.#presentation = options.presentation;
         this.#quitOutro = options.quitOutro;
         const input = options.input;
         let damageTerminal;
@@ -73,8 +75,9 @@ export class OwnedUiTerminalHost {
                 mouse: false,
                 consumeUnhandledMouse: true,
                 onOverlayGeometry: surfaces => this.#active?.setOverlaySurfaces(surfaces),
+                paintModalBackdrop: renderModalBackdrop,
                 decorateTerminal: (terminal) => {
-                    damageTerminal = this.#runtimeFactory.createDamageTerminal(terminal, {
+                    damageTerminal = this.#presentation.terminalRuntime.createDamageTerminal(terminal, {
                         regionalScroll: process.env.TERM !== "dumb",
                         inspectHyperlinks: readVisibleHyperlinks,
                         onResize: () => this.#active?.noteImmediatePresentation(),
@@ -84,7 +87,7 @@ export class OwnedUiTerminalHost {
                 },
                 ...(input?.coordination === false ? {} : {
                     inputCoordination: {
-                        classify: (data, focusedOverlay) => this.#runtimeFactory.classifyInput(data, focusedOverlay ?? this.#active?.inputCoordinationSurface() ?? "opaque"),
+                        classify: (data, focusedOverlay) => this.#presentation.terminalRuntime.classifyInput(data, focusedOverlay ?? this.#active?.inputCoordinationSurface() ?? "opaque"),
                         onReceipt: () => this.#active?.noteImmediatePresentation(),
                         ...(input?.scheduler === undefined ? {} : { scheduler: input.scheduler }),
                     },
@@ -100,7 +103,7 @@ export class OwnedUiTerminalHost {
             hardwareCursor: options.hardwareCursor,
             ...(options.wheelScrollLines === undefined ? {} : { wheelScrollLines: options.wheelScrollLines }),
         };
-        this.runtime = this.#runtimeFactory.createRuntime(runtimeOptions);
+        this.runtime = this.#presentation.terminalRuntime.createRuntime(runtimeOptions);
         this.#damageTerminal = damageTerminal ?? null;
         const background = this.#customViewport ? options.backgroundSettings : undefined;
         if (background !== undefined)
@@ -285,7 +288,14 @@ export class OwnedUiTerminalHost {
     #showOverlay(presenter, component, options) {
         const owned = this.#overlays.get(presenter) ?? new Set();
         this.#overlays.set(presenter, owned);
-        const overlay = new PresenterOverlay(this.runtime.showOverlay(component, options), () => this.#active === presenter, () => owned.delete(overlay));
+        const overlay = new PresenterOverlay(this.runtime.showOverlay(this.#customViewport && options?.modal ? {
+            ...component,
+            render: width => component.render(width).map(line => (this.#presentation.floatingDialogSurface ?? (text => text))(`\u001b[22;39;49m${padToWidth(line, width)}`)),
+            invalidate: () => component.invalidate(),
+            handleInput: data => component.handleInput?.(data),
+            setFocused: focused => component.setFocused?.(focused),
+            dispose: () => component.dispose?.(),
+        } : component, options), () => this.#active === presenter, () => owned.delete(overlay));
         overlay.syncVisibility();
         owned.add(overlay);
         return overlay;
@@ -338,6 +348,7 @@ export class OwnedUiTerminalHost {
             closed = true;
             removeSurfacePreInput();
             removeInterruptWatch();
+            surface.close();
             this.#setPointerReporting(false);
             overlay?.hide();
             if (notify)
@@ -345,7 +356,7 @@ export class OwnedUiTerminalHost {
         };
         removeInterruptWatch = runtime.addInputListener(data => {
             // Compatibility: a kitty-keyboard child reports Ctrl+C as a CSI-u sequence rather than the byte.
-            if (!attached() || !data.includes(INTERRUPT) && this.#runtimeFactory.legacyKeyInput(data) !== INTERRUPT)
+            if (!attached() || overlay?.isFocused() !== true || !data.includes(INTERRUPT) && this.#presentation.terminalRuntime.legacyKeyInput(data) !== INTERRUPT)
                 return undefined;
             // Protocol: route hosts decide whether one interrupt closes their app. Raw-input forwarding
             // is required because Pi handles Ctrl+C before the fullscreen overlay receives normal input.
@@ -378,7 +389,7 @@ export class OwnedUiTerminalHost {
         // at the pre-input boundary so dropdowns, value hover, and numeric +/- work,
         // and consume even unhandled reports so settings content is never selected.
         const routeMouse = data => {
-            if (!attached())
+            if (!attached() || overlay?.isFocused() !== true)
                 return undefined;
             const { events, rest } = parseMouseInput(data);
             if (events.length === 0)
@@ -404,7 +415,7 @@ export class OwnedUiTerminalHost {
                 for (const event of events)
                     surface.handleMouse(event);
                 // Invariant: owned screens see legacy key bytes whether the terminal reports legacy or kitty keys.
-                const key = rest.length > 0 ? this.#runtimeFactory.legacyKeyInput(rest) : "";
+                const key = rest.length > 0 ? this.#presentation.terminalRuntime.legacyKeyInput(rest) : "";
                 if (key.length > 0)
                     surface.handleInput(key);
                 if (surface.isClosed()) {
@@ -426,7 +437,7 @@ export class OwnedUiTerminalHost {
             anchor: "top-left",
             inputCoordination: "owned",
         });
-        return { hide: () => closeSurface(false) };
+        return { hide: () => closeSurface(false), close: () => closeSurface(true) };
     }
     // Invariant: the snapshot is synchronous; the outro module itself loads only at quit.
     #captureQuitOutroFrame() {
@@ -472,7 +483,7 @@ export class OwnedUiTerminalHost {
                 write: data => this.runtime.writeControl(data),
                 ...(capture.settings.canvasBackgroundAnsi === null
                     ? {}
-                    : { canvas: { ansi: capture.settings.canvasBackgroundAnsi, rebase: this.#runtimeFactory.rebaseDefaultBackground } }),
+                    : { canvas: { ansi: capture.settings.canvasBackgroundAnsi, rebase: this.#presentation.terminalRuntime.rebaseDefaultBackground } }),
                 ...(outro.now === undefined ? {} : { now: outro.now }),
                 ...(outro.sleep === undefined ? {} : { sleep: outro.sleep }),
                 ...(outro.seed === undefined ? {} : { seed: outro.seed }),

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

@@ -110,7 +110,11 @@ export class ViewportPointerGestures {
             viewport.setRailHovered(false);
             viewport.setStickyHovered(false);
             this.#position = undefined;
-            owner.component.handleInput?.(report);
+            if (owner.component.handleLocalMouse !== undefined) {
+                owner.component.handleLocalMouse({ ...event, column: event.column - owner.columnStart + 1, row: event.row - owner.rowStart + 1 });
+            }
+            else
+                owner.component.handleInput?.(report);
             outcome.repaint = true;
             return true;
         }

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

@@ -53,6 +53,18 @@ export class WorkflowOutput {
         this.#appendAnchored(width => this.#ports.components.info.commandMessage(presentation, width, this.#ports.outputPad()));
     }
     appendResult(result, errorCode) {
+        // Rationale: model state already repaints the footer; only actionable diagnostics need another surface.
+        if (this.#ports.customViewport && result.outcome === "completed"
+            && result.presentation?.kind === "model-change") {
+            for (const message of result.messages ?? []) {
+                if (message.kind !== "status")
+                    this.appendMessage(message, errorCode);
+            }
+            if (result.messages === undefined && (result.messageKind === "warning" || result.messageKind === "error")) {
+                this.appendMessage({ kind: result.messageKind, message: result.message }, errorCode);
+            }
+            return;
+        }
         if (result.messages !== undefined) {
             for (const message of result.messages)
                 this.appendMessage(message, errorCode);

package/dist/app/session-shell/workflow-router.d.ts

@@ -2,11 +2,11 @@ import type { OwnedUiCommandResult, OwnedUiWorkflowRequest } from "../../contrac
 /** The owned selectors a workflow can open in place of asking the engine to choose. */
 export interface WorkflowSelectors {
     showScopedModelsSelector(): void;
-    showModelsDialog(initialQuery?: string): void;
+    showModelsDialog(initialQuery?: string): void | Promise<void>;
     showModelSelector(initialSearchInput?: string): void;
     showForkSelector(): void;
     showThinkingSelector(): Promise<void>;
-    showTrustSelector(): void;
+    showTrustSelector(): void | Promise<void>;
     showSettingsSelector(): void;
     showSessionSelector(): Promise<void>;
     showLoginAuthTypeSelector(): void;

package/dist/composition/owned-ui.js

@@ -44,21 +44,9 @@ export async function composeOwnedUi(options = {}) {
         });
     // Invariant: bare A1 owns the settings-driven ports; the comparison profile receives none of them.
     const bareSettings = bare ? settings : null;
-    const projectTrustPrompt = options.projectTrustPrompt;
     // Invariant: process-wide engine state has one owner. The host installs the HTTP dispatcher, applies
     // the theme singletons, and announces startup notices once; every session is created through it.
-    const host = await (options.createEngineHost ?? (async (hostOptions) => createPiEngineHost(hostOptions)))({
-        productMode,
-        availableThemes: () => getAvailablePiThemes().map(theme => theme.name),
-        announceStartupChangelog: !bare,
-        theme: {
-            base: bare ? "dark" : "engine-configured",
-            accentColor: bareSettings?.value("accentColor") ?? "purple",
-            packageBorderProjection: bare,
-            apply: { base: applyConfiguredPiTheme, accentColor: setPiAccentColor, packageBorderProjection: setPiPackageBorderProjectionEnabled },
-        },
-        ...(projectTrustPrompt === undefined ? {} : { projectTrustPrompt }),
-    });
+    const host = await (options.createEngineHost ?? createPiEngineHost)(engineHostOptions(options, productMode, bareSettings));
     const sessionForkPrompt = options.sessionForkPrompt;
     try {
         backend = await host.create({
@@ -247,6 +235,22 @@ function bareShellPorts(settings, generator, diagnostics) {
         },
     };
 }
+function engineHostOptions(options, productMode, settings) {
+    const bare = productMode === "bare";
+    return {
+        productMode,
+        availableThemes: () => getAvailablePiThemes().map(theme => theme.name),
+        ...(bare ? { workflowHost: { reserveExport: async (id, format) => (await import("../foundation/lifecycle/user-exports.js")).reserveUserExport(id, format) } } : {}),
+        announceStartupChangelog: !bare,
+        theme: {
+            base: bare ? "dark" : "engine-configured",
+            accentColor: settings?.value("accentColor") ?? "purple",
+            packageBorderProjection: bare,
+            apply: { base: applyConfiguredPiTheme, accentColor: setPiAccentColor, packageBorderProjection: setPiPackageBorderProjectionEnabled },
+        },
+        ...(options.projectTrustPrompt === undefined ? {} : { projectTrustPrompt: options.projectTrustPrompt }),
+    };
+}
 async function createPromptHistoryConfiguration(settings, backend, bare) {
     const limit = settings?.value("promptHistoryMaxItems") ?? 100;
     const scope = settings?.value("promptHistoryScope") ?? "unique";

package/dist/composition/settings-route-host.js

@@ -92,6 +92,7 @@ async function loadReferenceSurface(settings, route, title, document, options) {
         id,
         title,
         document: content,
+        ...(route === "session" ? { presentation: "dialog" } : {}),
         scrollSettings: () => ({
             scrollbarAppearance: settings.value("scrollbarAppearance"),
             scrollbarStyle: settings.value("scrollbarStyle"),

package/dist/contracts/owned-ui/session-presenters.d.ts

@@ -80,6 +80,6 @@ export interface OwnedUiSessionPresenters {
     /** `navigate` completes a selection that leaves the current leaf, including any summary prompt. */
     openTreeSelector(host: OwnedUiDialogHost, navigate: (entryId: string, skipSummaryPrompt: boolean) => void, initialSelectedId?: string): Promise<void>;
     openSettingsSelector(host: OwnedUiDialogHost): void;
-    openModelsDialog(host: OwnedUiDialogHost, initialQuery?: string): void;
+    openModelsDialog(host: OwnedUiDialogHost, initialQuery?: string): void | Promise<void>;
     openScopedModelsSelector(host: OwnedUiDialogHost): void;
 }

package/dist/contracts/owned-ui/session-workflows.d.ts

@@ -108,7 +108,9 @@ export interface OwnedUiCacheWarmingPresentation {
         };
     };
 }
-export type OwnedUiWorkflowPresentation = OwnedUiSessionInfoPresentation;
+export type OwnedUiWorkflowPresentation = OwnedUiSessionInfoPresentation | {
+    readonly kind: "model-change";
+};
 export type OwnedUiWorkflowMessageKind = "status" | "warning" | "error" | "accent" | "silent";
 export interface OwnedUiWorkflowMessage {
     readonly kind: Exclude<OwnedUiWorkflowMessageKind, "silent">;

package/dist/contracts/owned-ui/shell-components.d.ts

@@ -14,9 +14,19 @@ export interface OwnedUiShellKeybindingsHost {
     reload(): void;
 }
 export interface OwnedUiShellComponentPort {
+    readonly ready?: Promise<void>;
     render(width: number): readonly string[];
+    /** Bounds scrollable replacement inputs within the dock. */
+    renderInDock?(width: number, maxHeight: number): readonly string[];
     invalidate(): void;
     handleInput?(data: string): void;
+    /** Pointer input in one-based component-local coordinates, when supported. */
+    handleLocalMouse?(event: {
+        readonly kind: "press" | "release" | "motion" | "wheel-up" | "wheel-down";
+        readonly button: number;
+        readonly column: number;
+        readonly row: number;
+    }): void;
     setFocused?(focused: boolean): void;
     dispose?(): void;
 }
@@ -53,6 +63,8 @@ export interface OwnedUiShellEditorPort extends OwnedUiShellComponentPort {
     /** Restores the shared keybindings if anything replaced the active registry; a no-op when it is already active. */
     activateKeybindings(): void;
     keybindingConfig(): OwnedUiShellKeybindings;
+    /** Resolves application-host actions against the same active declarations as editor dispatch. */
+    matchesAction?(data: string, action: "owned.apps.open"): boolean;
     reloadKeybindings(): void;
     /** Uses the vendor's terminal decoder rather than assuming one terminal escape spelling. */
     matchesTerminalKey(data: string, key: "home" | "end" | "pageUp" | "pageDown" | "ctrl+home" | "ctrl+end" | "alt+home" | "ctrl+v"): boolean;

package/dist/contracts/presentation/component.d.ts

@@ -2,6 +2,13 @@ export interface PresentationComponentPort {
     render(width: number): readonly string[];
     invalidate(): void;
     handleInput?(data: string): void;
+    /** Optional pointer input in one-based component-local coordinates. */
+    handleLocalMouse?(event: {
+        readonly kind: "press" | "release" | "motion" | "wheel-up" | "wheel-down";
+        readonly button: number;
+        readonly column: number;
+        readonly row: number;
+    }): void;
     setFocused?(focused: boolean): void;
     dispose?(): void;
 }

package/dist/contracts/presentation/index.d.ts

@@ -22,6 +22,8 @@ export declare const DIALOG_BACK_SHORTCUT_HINT: Readonly<{
 }>;
 /** Global inset inherited by every semantic row inside an A1-owned dialog frame. */
 export declare const DIALOG_CONTENT_PADDING_X = 1;
+/** Wraps choice navigation, leaving empty lists at a safe index. */
+export declare function wrapChoiceIndex(index: number, delta: number, count: number): number;
 export interface DialogFrameGeometry {
     readonly frameWidth: number;
     readonly contentPaddingX: number;

package/dist/contracts/presentation/index.js

@@ -6,6 +6,10 @@ export const DIALOG_CLOSE_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "c
 export const DIALOG_BACK_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "back" });
 /** Global inset inherited by every semantic row inside an A1-owned dialog frame. */
 export const DIALOG_CONTENT_PADDING_X = 1;
+/** Wraps choice navigation, leaving empty lists at a safe index. */
+export function wrapChoiceIndex(index, delta, count) {
+    return count > 0 ? ((index + delta) % count + count) % count : 0;
+}
 /** Shared full-width-rule/content-width geometry for string and component dialog renderers. */
 export function dialogFrameGeometry(width) {
     const frameWidth = Math.max(0, width);

package/dist/contracts/presentation/progress-palette.generated.d.ts

@@ -1,6 +1,6 @@
 /**
  * Generated by scripts/pi/sync-progress-palette.ts from A1's named accent projection
- * over pinned Pi 1.5.0 (MIT), commit f9a26365568127461c47a07a37dcb42c140a3ac5. Do not edit directly.
+ * over pinned Pi 1.5.1 (MIT), commit dd30101cfc5b0609411dd80b6f93adbc14db14cf. Do not edit directly.
  */
 export declare const SHARED_PROGRESS_PALETTE: Readonly<{
     blue: {
@@ -8,20 +8,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -30,20 +34,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -52,20 +60,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -74,20 +86,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -96,20 +112,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };
@@ -118,20 +138,24 @@ export declare const SHARED_PROGRESS_PALETTE: Readonly<{
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
         light: {
             truecolor: {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
             "256color": {
                 accent: string;
                 border: string;
+                selectedBg: string;
             };
         };
     };

package/dist/contracts/presentation/progress-palette.generated.js

@@ -1,139 +1,6 @@
 /**
  * Generated by scripts/pi/sync-progress-palette.ts from A1's named accent projection
- * over pinned Pi 1.5.0 (MIT), commit f9a26365568127461c47a07a37dcb42c140a3ac5. Do not edit directly.
+ * over pinned Pi 1.5.1 (MIT), commit dd30101cfc5b0609411dd80b6f93adbc14db14cf. Do not edit directly.
  */
-export const SHARED_PROGRESS_PALETTE = Object.freeze({
-    "blue": {
-        "dark": {
-            "truecolor": {
-                "accent": "\u001b[38;2;130;160;241m",
-                "border": "\u001b[38;2;116;102;197m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;111m",
-                "border": "\u001b[38;5;98m"
-            }
-        },
-        "light": {
-            "truecolor": {
-                "accent": "\u001b[38;2;63;96;226m",
-                "border": "\u001b[38;2;83;67;154m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;62m",
-                "border": "\u001b[38;5;60m"
-            }
-        }
-    },
-    "purple": {
-        "dark": {
-            "truecolor": {
-                "accent": "\u001b[38;2;167;152;215m",
-                "border": "\u001b[38;2;105;115;167m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;140m",
-                "border": "\u001b[38;5;61m"
-            }
-        },
-        "light": {
-            "truecolor": {
-                "accent": "\u001b[38;2;116;89;180m",
-                "border": "\u001b[38;2;68;77;130m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;97m",
-                "border": "\u001b[38;5;60m"
-            }
-        }
-    },
-    "cyan": {
-        "dark": {
-            "truecolor": {
-                "accent": "\u001b[38;2;93;179;186m",
-                "border": "\u001b[38;2;74;128;146m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;73m",
-                "border": "\u001b[38;5;66m"
-            }
-        },
-        "light": {
-            "truecolor": {
-                "accent": "\u001b[38;2;40;122;129m",
-                "border": "\u001b[38;2;40;89;106m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;30m",
-                "border": "\u001b[38;5;23m"
-            }
-        }
-    },
-    "green": {
-        "dark": {
-            "truecolor": {
-                "accent": "\u001b[38;2;104;183;141m",
-                "border": "\u001b[38;2;75;132;120m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;72m",
-                "border": "\u001b[38;5;66m"
-            }
-        },
-        "light": {
-            "truecolor": {
-                "accent": "\u001b[38;2;51;126;88m",
-                "border": "\u001b[38;2;41;93;82m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;65m",
-                "border": "\u001b[38;5;23m"
-            }
-        }
-    },
-    "orange": {
-        "dark": {
-            "truecolor": {
-                "accent": "\u001b[38;2;231;135;83m",
-                "border": "\u001b[38;2;178;89;79m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;173m",
-                "border": "\u001b[38;5;131m"
-            }
-        },
-        "light": {
-            "truecolor": {
-                "accent": "\u001b[38;2;174;80;16m",
-                "border": "\u001b[38;2;133;57;49m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;130m",
-                "border": "\u001b[38;5;95m"
-            }
-        }
-    },
-    "pink": {
-        "dark": {
-            "truecolor": {
-                "accent": "\u001b[38;2;223;122;199m",
-                "border": "\u001b[38;2;150;91;171m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;176m",
-                "border": "\u001b[38;5;97m"
-            }
-        },
-        "light": {
-            "truecolor": {
-                "accent": "\u001b[38;2;178;56;153m",
-                "border": "\u001b[38;2;114;61;131m"
-            },
-            "256color": {
-                "accent": "\u001b[38;5;132m",
-                "border": "\u001b[38;5;60m"
-            }
-        }
-    }
-});
+export const SHARED_PROGRESS_PALETTE = Object.freeze({ "blue": { "dark": { "truecolor": { "accent": "\u001b[38;2;130;160;241m", "border": "\u001b[38;2;116;102;197m", "selectedBg": "\u001b[48;2;52;57;69m" }, "256color": { "accent": "\u001b[38;5;111m", "border": "\u001b[38;5;98m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;63;96;226m", "border": "\u001b[38;2;83;67;154m", "selectedBg": "\u001b[48;2;243;244;246m" }, "256color": { "accent": "\u001b[38;5;62m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "purple": { "dark": { "truecolor": { "accent": "\u001b[38;2;167;152;215m", "border": "\u001b[38;2;105;115;167m", "selectedBg": "\u001b[48;2;58;56;66m" }, "256color": { "accent": "\u001b[38;5;140m", "border": "\u001b[38;5;61m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;116;89;180m", "border": "\u001b[38;2;68;77;130m", "selectedBg": "\u001b[48;2;243;243;245m" }, "256color": { "accent": "\u001b[38;5;97m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } }, "cyan": { "dark": { "truecolor": { "accent": "\u001b[38;2;93;179;186m", "border": "\u001b[38;2;74;128;146m", "selectedBg": "\u001b[48;2;48;60;61m" }, "256color": { "accent": "\u001b[38;5;73m", "border": "\u001b[38;5;66m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;40;122;129m", "border": "\u001b[38;2;40;89;106m", "selectedBg": "\u001b[48;2;241;244;244m" }, "256color": { "accent": "\u001b[38;5;30m", "border": "\u001b[38;5;23m", "selectedBg": "\u001b[48;5;255m" } } }, "green": { "dark": { "truecolor": { "accent": "\u001b[38;2;104;183;141m", "border": "\u001b[38;2;75;132;120m", "selectedBg": "\u001b[48;2;50;60;54m" }, "256color": { "accent": "\u001b[38;5;72m", "border": "\u001b[38;5;66m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;51;126;88m", "border": "\u001b[38;2;41;93;82m", "selectedBg": "\u001b[48;2;242;244;243m" }, "256color": { "accent": "\u001b[38;5;65m", "border": "\u001b[38;5;23m", "selectedBg": "\u001b[48;5;255m" } } }, "orange": { "dark": { "truecolor": { "accent": "\u001b[38;2;231;135;83m", "border": "\u001b[38;2;178;89;79m", "selectedBg": "\u001b[48;2;67;54;48m" }, "256color": { "accent": "\u001b[38;5;173m", "border": "\u001b[38;5;131m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;174;80;16m", "border": "\u001b[38;2;133;57;49m", "selectedBg": "\u001b[48;2;245;243;242m" }, "256color": { "accent": "\u001b[38;5;130m", "border": "\u001b[38;5;95m", "selectedBg": "\u001b[48;5;255m" } } }, "pink": { "dark": { "truecolor": { "accent": "\u001b[38;2;223;122;199m", "border": "\u001b[38;2;150;91;171m", "selectedBg": "\u001b[48;2;65;53;62m" }, "256color": { "accent": "\u001b[38;5;176m", "border": "\u001b[38;5;97m", "selectedBg": "\u001b[48;5;59m" } }, "light": { "truecolor": { "accent": "\u001b[38;2;178;56;153m", "border": "\u001b[38;2;114;61;131m", "selectedBg": "\u001b[48;2;245;243;245m" }, "256color": { "accent": "\u001b[38;5;132m", "border": "\u001b[38;5;60m", "selectedBg": "\u001b[48;5;255m" } } } });
 export const SHARED_PROGRESS_ACCENT_ANSI = SHARED_PROGRESS_PALETTE.blue.dark.truecolor.accent;

package/dist/contracts/presentation/terminal.d.ts

@@ -68,6 +68,8 @@ export interface TerminalOverlayOptions {
     readonly margin?: TerminalOverlayMargin | number;
     readonly visible?: (columns: number, rows: number) => boolean;
     readonly nonCapturing?: boolean;
+    /** An owned floating panel; the host supplies its surface and dims the completed backdrop. */
+    readonly modal?: boolean;
     /** A1-owned input scheduling declaration; omitted extension overlays fail closed. */
     readonly inputCoordination?: Exclude<TerminalInputSurfaceKind, "editor">;
 }
@@ -141,6 +143,8 @@ export interface TerminalRuntimeOptions {
     readonly root: TerminalComponentPort;
     /** Bare viewport only: painted overlays in back-to-front order; null while geometry is stale. */
     readonly onOverlayGeometry?: (surfaces: readonly TerminalPointerSurface[] | null) => void;
+    /** Presentation policy applied after composition around the topmost owned floating panel. */
+    readonly paintModalBackdrop?: (lines: readonly string[], width: number, height: number, panel: TerminalPointerSurface) => string[];
     readonly mode?: "regular" | "fullscreen";
     readonly layoutRoot?: TerminalLayoutNode;
     readonly terminal?: TerminalPort;

package/dist/contracts/presentation/theme.d.ts

@@ -42,5 +42,7 @@ export interface ShellPresentationPorts {
     canvasBackground(style: CanvasBackgroundStyle): string | null;
     /** Columns the pinned comparison layout pads command output with. */
     readonly pinnedOutputPad: 0 | 1;
+    /** Live color-capability-aware background for owned floating panels only. */
+    readonly floatingDialogSurface?: (text: string) => string;
     readonly terminalRuntime: TerminalRuntimeFactory;
 }

package/dist/features/owned-ui/project-trust-dialog.d.ts

@@ -1,2 +1,2 @@
 /** Fixed startup-safe rendering only; project-derived presentation is forbidden before trust resolves. */
-export declare function renderProjectTrustDialog(cwd: string, options: readonly string[], selected: number, terminalWidth: number, terminalRows: number, accent: string, border: string): readonly string[];
+export declare function renderProjectTrustDialog(cwd: string, options: readonly string[], selected: number, terminalWidth: number, terminalRows: number, accent: string, border: string, selectedBg: string): readonly string[];