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

package/dist/features/owned-ui/project-trust-dialog.js

@@ -6,12 +6,12 @@ const BOLD = "\u001b[1m";
 const RESET_BOLD = "\u001b[22m";
 const EXPLANATION = "This allows to load project settings and resources, install missing project packages, and execute project extensions.";
 /** Fixed startup-safe rendering only; project-derived presentation is forbidden before trust resolves. */
-export function renderProjectTrustDialog(cwd, options, selected, terminalWidth, terminalRows, accent, border) {
+export function renderProjectTrustDialog(cwd, options, selected, terminalWidth, terminalRows, accent, border, selectedBg) {
     const width = Math.max(1, terminalWidth);
     const rule = `${border}${"─".repeat(width)}${RESET_FG}`;
-    const title = ` ${BOLD}${accent}Trust project folder?${RESET_FG}${RESET_BOLD}`;
+    const title = ` ${BOLD}${accent}Trust Project Folder?${RESET_FG}${RESET_BOLD}`;
     const path = ` ${MUTED}${sanitize(cwd)}${RESET_FG}`;
-    const choices = options.map((label, index) => choice(label, selected === index, accent));
+    const choices = options.map((label, index) => choice(label, selected === index, accent, selectedBg));
     const closeKey = displayShortcutKeyLabel(DIALOG_CLOSE_SHORTCUT_HINT.key);
     const hint = ` ${DIM}↑↓${MUTED} navigate  ${DIM}Enter${MUTED} select  ${DIM}${closeKey}${MUTED} ${DIALOG_CLOSE_SHORTCUT_HINT.action}${RESET_FG}`;
     const explanation = wrap(EXPLANATION, Math.max(1, width - 2)).map(line => ` ${line}`);
@@ -33,8 +33,8 @@ export function renderProjectTrustDialog(cwd, options, selected, terminalWidth,
         return choiceWindow(choices, selected, 2);
     return [choices[selected] ?? choices[0] ?? ""];
 }
-function choice(label, selected, accent) {
-    return selected ? ` ${accent}→ ${label}${RESET_FG}` : `   ${label}`;
+function choice(label, selected, accent, selectedBg) {
+    return selected ? ` ${selectedBg}${accent}→ ${RESET_FG}${label}\u001b[49m` : `   ${label}`;
 }
 function choiceWindow(choices, selected, capacity) {
     const start = Math.min(Math.max(0, selected - Math.floor(capacity / 2)), Math.max(0, choices.length - capacity));

package/dist/features/owned-ui/project-trust-prompt.js

@@ -67,7 +67,7 @@ export function createConsoleProjectTrustPrompt(options = {}) {
         const render = () => {
             const width = Math.max(renderBareDialog ? 1 : 20, output.columns ?? 80);
             const rows = Math.max(1, output.rows ?? 24);
-            const lines = (renderBareDialog?.(cwd, choices.map(choice => choice.label), selected, width, rows, palette.accent, palette.border) ?? [
+            const lines = (renderBareDialog?.(cwd, choices.map(choice => choice.label), selected, width, rows, palette.accent, palette.border, palette.selectedBg) ?? [
                 `${BOLD}${ACCENT}Trust project folder?${RESET_FG}${RESET_BOLD}`,
                 cwd,
                 "",
@@ -205,5 +205,5 @@ function clipAnsiSafe(line, width) {
         index += 1;
         visible += 1;
     }
-    return `${output}${RESET_FG}${RESET_BOLD}`;
+    return `${output}${RESET_FG}${RESET_BOLD}${line.includes("\u001b[48;") ? "\u001b[49m" : ""}`;
 }

package/dist/features/owned-ui/reference-screen-app.d.ts

@@ -23,6 +23,8 @@ export interface ReferenceScreenOptions {
     readonly id: string;
     readonly title: string;
     readonly document: ReferenceDocumentProvider;
+    /** In-place documents put their shortcut row inside the bottom rule like other dock dialogs. */
+    readonly presentation?: "screen" | "dialog";
     /** The reader's scroll settings, read on every frame so a live change is honored. */
     readonly scrollSettings: () => OwnedUiViewportSettings;
     /** Enables owned text selection for document routes that explicitly opt in. */

package/dist/features/owned-ui/reference-screen-app.js

@@ -47,6 +47,7 @@ const KEYS = {
 export class ReferenceScreenApp {
     id;
     #title;
+    #dialog;
     #document;
     #scrollSettings;
     #selection;
@@ -66,6 +67,7 @@ export class ReferenceScreenApp {
     constructor(options) {
         this.id = options.id;
         this.#title = options.title;
+        this.#dialog = options.presentation === "dialog";
         this.#document = options.document;
         this.#scrollSettings = options.scrollSettings;
         this.#selection = options.selection === undefined ? undefined : new ReferenceDocumentSelection(options.selection);
@@ -158,7 +160,8 @@ export class ReferenceScreenApp {
         // Compatibility: the v2 reference screen frames its document between two border-coloured rules.
         const rule = theme.fg("border", "─".repeat(rect.width));
         // Invariant: dialog chrome shares the title's one-cell inset; document content keeps its own layout.
-        const frame = [rule, ...withRail, rule, padToWidth(hint, rect.width)];
+        const footer = padToWidth(hint, rect.width);
+        const frame = this.#dialog ? [rule, ...withRail, footer, rule] : [rule, ...withRail, rule, footer];
         // Invariant: a rectangle too small for the chrome still gets exactly its rows, top first.
         return frame.slice(0, rect.height).concat(Array(Math.max(0, rect.height - frame.length)).fill(""));
     }

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

@@ -1,4 +1,4 @@
-import { DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, wrapChoiceIndex } from "../../contracts/presentation/index.js";
 import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, numericValues, RAIL_COLUMNS, renderCenteredDialogOverlay, renderDialogPanel, renderEmptyState, renderGroupHeader, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, humanizeLabel, humanizeTitle, indexOfKey, layoutList, moveSelection, rowKey, scrollForSelection, scrollbarGeometry, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
 import { SettingsScrollRail } from "./settings-scroll-rail.js";
 import { SettingsEdits, replaceRecord, sameRecord } from "./settings-edits.js";
@@ -240,7 +240,7 @@ export class SettingsApp {
             }
             case "move-up":
             case "move-down":
-                this.#select(rows, moveSelection(rows, selected, action === "move-down" ? 1 : -1));
+                this.#select(rows, moveSelection(rows, selected, action === "move-down" ? 1 : -1, true));
                 return { consumed: true };
             case "page-up":
             case "page-down":
@@ -472,10 +472,10 @@ export class SettingsApp {
                 this.#structured = null;
                 return { consumed: true };
             case "part-previous":
-                open.index = Math.max(0, open.index - 1);
+                open.index = wrapChoiceIndex(open.index, -1, open.flags.length);
                 return { consumed: true };
             case "part-next":
-                open.index = Math.min(open.flags.length - 1, open.index + 1);
+                open.index = wrapChoiceIndex(open.index, 1, open.flags.length);
                 return { consumed: true };
             case "part-change":
                 this.#toggleFlag(open.index);
@@ -529,7 +529,7 @@ export class SettingsApp {
             // Compatibility: the keyboard starts from the value in effect rather than from the top.
             menu.index = menu.index < 0
                 ? menu.current
-                : Math.min(menu.choices.length - 1, Math.max(0, menu.index + (key === "down" ? 1 : -1)));
+                : wrapChoiceIndex(menu.index, key === "down" ? 1 : -1, menu.choices.length);
         }
         else if (key === "enter") {
             const value = menu.choices[menu.index];
@@ -577,7 +577,7 @@ export class SettingsApp {
                     this.#jump(rows, target);
                 return { consumed: true };
             }
-            this.#select(rows, moveSelection(rows, selected, forward ? 1 : -1));
+            this.#select(rows, moveSelection(rows, selected, forward ? 1 : -1, true));
             return { consumed: true };
         }
         const before = input.getText();

package/dist/features/owned-ui/settings-model-dialog.js

@@ -1,4 +1,4 @@
-import { DIALOG_BACK_SHORTCUT_HINT, DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
+import { DIALOG_BACK_SHORTCUT_HINT, DIALOG_CLOSE_SHORTCUT_HINT, wrapChoiceIndex } from "../../contracts/presentation/index.js";
 import { LineInput, ShortcutRegistry, assertNoShortcutConflicts, configureDialogChoiceCapacity, configureDialogTextRows, handleLineInputKey, humanizeLabel, renderSteppedDialogPanel, } from "../../ui/components/index.js";
 import { changeFailure, structuredValue } from "./settings-edits.js";
 import { SETTINGS_APP_ID } from "./settings-route.js";
@@ -28,7 +28,7 @@ export function modelDialogKey(open, data, key, actions) {
             return { consumed: true };
         }
         if (action === "previous" || action === "next") {
-            open.index = Math.min(Math.max(0, flags.length - 1), Math.max(0, open.index + (action === "next" ? 1 : -1)));
+            open.index = wrapChoiceIndex(open.index, action === "next" ? 1 : -1, flags.length);
             return { consumed: true };
         }
         if (action === "select") {
@@ -61,7 +61,7 @@ export function modelDialogKey(open, data, key, actions) {
         return { consumed: true };
     }
     if (action === "previous" || action === "next") {
-        open.index = Math.min(Math.max(0, choices.length - 1), Math.max(0, open.index + (action === "next" ? 1 : -1)));
+        open.index = wrapChoiceIndex(open.index, action === "next" ? 1 : -1, choices.length);
         return { consumed: true };
     }
     if (action === "select") {

package/dist/foundation/lifecycle/user-exports.d.ts

@@ -0,0 +1,5 @@
+/** Exclusively reserve a default export; failure cleanup may remove only this same regular file. */
+export declare function reserveUserExport(sessionId: string, format: "html" | "jsonl", home?: string): Promise<{
+    readonly path: string;
+    failed(): Promise<void>;
+}>;

package/dist/foundation/lifecycle/user-exports.js

@@ -0,0 +1,37 @@
+import { randomUUID } from "node:crypto";
+import { lstat, mkdir, open, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { PRODUCT_IDENTITY } from "../../product-identity.js";
+/** Persistent user-owned exports; development data/config overrides never relocate user files. */
+function resolveUserExportsDirectory(home = process.env[PRODUCT_IDENTITY.environment.profileHome] ?? homedir()) {
+    if (!isAbsolute(home) || home.includes("\0"))
+        throw new TypeError("User export home must be absolute");
+    return resolve(home, dirname(PRODUCT_IDENTITY.state.piAgentProfile), "exports");
+}
+/** Exclusively reserve a default export; failure cleanup may remove only this same regular file. */
+export async function reserveUserExport(sessionId, format, home) {
+    const directory = resolveUserExportsDirectory(home);
+    const parent = dirname(directory);
+    await mkdir(parent, { recursive: true });
+    if (!(await lstat(parent)).isDirectory())
+        throw new Error("User export directory must not traverse a link");
+    await mkdir(directory, { recursive: true });
+    if (!(await lstat(directory)).isDirectory())
+        throw new Error("User export directory must not traverse a link");
+    const id = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 80) || "session";
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const path = join(directory, `${PRODUCT_IDENTITY.filesystem.slug}-session-${stamp}-${id}-${randomUUID()}.${format}`);
+    const file = await open(path, "wx", 0o600);
+    const identity = await file.stat();
+    await file.close();
+    return {
+        path,
+        async failed() {
+            const current = await lstat(path).catch(error => { if (error.code !== "ENOENT")
+                throw error; });
+            if (current?.isFile() && current.dev === identity.dev && current.ino === identity.ino)
+                await unlink(path);
+        },
+    };
+}

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": "97a7715b6a24a7449ecb61d3581e27396ebde40d3d2d0b6f701415c82e74f6b2"
+    "sha256": "e6a12f0ec3c5f2ada12bb29f8a02584f0724b37d107c29608b6629a4196cca13"
   },
   "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": "c1f84ec1184782905d628eba21b4c0e62c643e0a37481d4bb42e47e768d5d48f"
+  "identity": "1823698969cb8a551539b6351a7ba7b0756121369e6f9bf898347080d7892ece"
 });
 
 export function loadDeclaredStartupGraph() {

package/dist/integrations/pi/components/deferred-selector.d.ts

@@ -0,0 +1,6 @@
+import type { PiShellSkillsSelectorOptions } from "./skills-dialog.js";
+import type { OwnedUiShellComponentPort } from "../../../contracts/owned-ui/index.js";
+/** Defers optional selector code while retaining focus, early input and cancellation. */
+export declare function deferredSelector(load: () => Promise<OwnedUiShellComponentPort>, cancel: () => void): OwnedUiShellComponentPort;
+/** Keeps Skills outside first-prompt loading. */
+export declare function createPiShellSkillsSelector(options: PiShellSkillsSelectorOptions): OwnedUiShellComponentPort;

package/dist/integrations/pi/components/deferred-selector.js

@@ -0,0 +1,40 @@
+/** Defers optional selector code while retaining focus, early input and cancellation. */
+export function deferredSelector(load, cancel) {
+    let delegate;
+    let closed = false;
+    let focused = false;
+    let failure;
+    const pending = [];
+    const ready = load().then(component => {
+        if (closed) {
+            component.dispose?.();
+            return;
+        }
+        delegate = component;
+        delegate.setFocused?.(focused);
+        for (const key of pending.splice(0)) {
+            if (!closed)
+                delegate.handleInput?.(key);
+        }
+    }).catch(() => { if (!closed)
+        failure = "Selector unavailable — Esc close"; });
+    return {
+        ready,
+        render: width => delegate?.render(width) ?? (failure === undefined ? [] : [failure.slice(0, width)]),
+        invalidate: () => delegate?.invalidate(),
+        handleInput: data => {
+            if (delegate !== undefined)
+                delegate.handleInput?.(data);
+            else if (data === "\u001b" || data === "\u0003")
+                cancel();
+            else if (pending.length < 32)
+                pending.push(data);
+        },
+        setFocused: value => { focused = value; delegate?.setFocused?.(value); },
+        dispose: () => { closed = true; pending.length = 0; delegate?.dispose?.(); },
+    };
+}
+/** Keeps Skills outside first-prompt loading. */
+export function createPiShellSkillsSelector(options) {
+    return deferredSelector(() => import("./skills-dialog.js").then(module => module.createPiShellSkillsSelector(options)), options.onCancel);
+}

package/dist/integrations/pi/components/login-dialog-loader.d.ts

@@ -0,0 +1,3 @@
+import type { OwnedUiShellLoginDialogPort as Login } from "../../../contracts/owned-ui/index.js";
+/** Queues optional login calls. */
+export declare function deferredLoginDialog(...args: Parameters<typeof import("./upstream/components/login-dialog.js").createThemedLoginDialog>): Login;

package/dist/integrations/pi/components/login-dialog-loader.js

@@ -0,0 +1,57 @@
+/** Queues optional login calls. */
+export function deferredLoginDialog(...args) {
+    const [runtime, , complete] = args;
+    let dialog, closed = false, focused = false, failed = false;
+    const pending = [];
+    const rejects = new Set();
+    const rejectAll = (message) => { for (const reject of rejects)
+        reject(new Error(message)); rejects.clear(); pending.length = 0; };
+    const ready = import("./upstream/components/login-dialog.js").then(module => {
+        if (closed)
+            return;
+        dialog = module.createThemedLoginDialog(...args);
+        dialog.setFocused?.(focused);
+        for (const action of pending.splice(0)) {
+            if (!closed)
+                action(dialog);
+        }
+    }).catch(() => { failed = true; rejectAll("Login unavailable"); }).finally(() => { if (!closed)
+        runtime.requestRender(); });
+    const call = (action) => { if (!closed && !failed) {
+        if (dialog)
+            action(dialog);
+        else
+            pending.push(action);
+    } };
+    const dispose = () => { closed = true; dialog?.dispose?.(); rejectAll("Login cancelled"); };
+    const answer = (action) => new Promise((resolve, reject) => {
+        if (closed || failed) {
+            reject(new Error("Login unavailable"));
+            return;
+        }
+        rejects.add(reject);
+        call(target => { rejects.delete(reject); void action(target).then(resolve, reject); });
+    });
+    return {
+        ready, dispose,
+        render: width => dialog?.render(width) ?? (failed ? ["Login unavailable — Esc close".slice(0, width)] : []),
+        invalidate: () => dialog?.invalidate(),
+        setFocused: value => { focused = value; dialog?.setFocused?.(value); },
+        handleInput: data => {
+            if (!dialog && (data === "\u001b" || data === "\u0003")) {
+                dispose();
+                complete(false, "Login cancelled");
+            }
+            else
+                call(target => target.handleInput?.(data));
+        },
+        showAuth: (url, instructions) => call(target => target.showAuth(url, instructions)),
+        showDeviceCode: info => call(target => target.showDeviceCode(info)),
+        showManualInput: message => answer(target => target.showManualInput(message)),
+        showPrompt: (message, placeholder) => answer(target => target.showPrompt(message, placeholder)),
+        showDetails: lines => call(target => target.showDetails(lines)),
+        showInfo: (message, links) => call(target => target.showInfo(message, links)),
+        showWaiting: message => call(target => target.showWaiting(message)),
+        showProgress: message => call(target => target.showProgress(message)),
+    };
+}

package/dist/integrations/pi/components/login-links.d.ts

@@ -0,0 +1,6 @@
+/** Login effects accept web URLs only; controls are encoded before any hyperlink or launcher sees them. */
+export declare function loginWebUrl(value: string): string | undefined;
+/** Keeps untrusted non-web instructions printable without granting them a hyperlink target. */
+export declare function loginLink(value: string, label?: string): string;
+/** Best-effort browser request with argv boundaries, no shell, and no dependency on the project cwd. */
+export declare function openLoginBrowser(value: string): void;

package/dist/integrations/pi/components/login-links.js

@@ -0,0 +1,31 @@
+import { spawn } from "node:child_process";
+import { hyperlink, replaceControlCharacters } from "@earendil-works/pi-tui";
+/** Login effects accept web URLs only; controls are encoded before any hyperlink or launcher sees them. */
+export function loginWebUrl(value) {
+    try {
+        const url = new URL(value);
+        return ["http:", "https:"].includes(url.protocol) ? url.href : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Keeps untrusted non-web instructions printable without granting them a hyperlink target. */
+export function loginLink(value, label) {
+    const url = loginWebUrl(value);
+    const text = replaceControlCharacters(label ?? url ?? value);
+    return url === undefined ? text : hyperlink(text, url);
+}
+/** Best-effort browser request with argv boundaries, no shell, and no dependency on the project cwd. */
+export function openLoginBrowser(value) {
+    const url = loginWebUrl(value);
+    if (url === undefined)
+        return;
+    const platform = process.platform;
+    const executable = platform === "win32" ? "rundll32" : platform === "darwin" ? "open" : "xdg-open";
+    const args = platform === "win32" ? ["url.dll,FileProtocolHandler", url] : [url];
+    try {
+        spawn(executable, args, { stdio: "ignore", detached: true, cwd: "/" }).on("error", () => { }).unref();
+    }
+    catch { /* Compatibility: a failed browser launch never interrupts provider authentication. */ }
+}

package/dist/integrations/pi/components/login-text.d.ts

@@ -0,0 +1,7 @@
+import { type Component } from "@earendil-works/pi-tui";
+type LoginTextRole = "accent" | "muted" | "warning" | "success" | "error" | "dim" | "text";
+/** Preserves authored line breaks without replaying control payloads. */
+export declare function loginPlainText(value: string): string;
+/** A zero-inset login row that resolves its semantic role against the live theme on every frame. */
+export declare function loginText(text: string | (() => string), role?: LoginTextRole, bold?: boolean): Component;
+export {};

package/dist/integrations/pi/components/login-text.js

@@ -0,0 +1,17 @@
+import { Text, replaceControlCharacters } from "@earendil-works/pi-tui";
+import { piTheme } from "./theme.js";
+/** Preserves authored line breaks without replaying control payloads. */
+export function loginPlainText(value) {
+    return value.split("\n").map(line => replaceControlCharacters(line)).join("\n");
+}
+/** A zero-inset login row that resolves its semantic role against the live theme on every frame. */
+export function loginText(text, role = "muted", bold = false) {
+    return {
+        render(width) {
+            const theme = piTheme();
+            const value = typeof text === "string" ? loginPlainText(text) : text();
+            return new Text(theme.fg(role, bold ? theme.bold(value) : value), 0, 0).render(width);
+        },
+        invalidate() { },
+    };
+}

package/dist/integrations/pi/components/modal-frame.d.ts

@@ -1,5 +1,10 @@
 import { Container, Input, type Component, type Focusable } from "@earendil-works/pi-tui";
+import type { OwnedUiShellComponentPort } from "../../../contracts/owned-ui/index.js";
 export declare const PI_MODAL_CONTENT_PADDING_X = 1;
+/** Applies standard primary/metadata roles without changing a pinned row's text or clipping. */
+export declare function renderPiModalSelectedPrimary(row: string, width: number, labels: readonly string[]): string;
+/** Standardizes internal legacy model/message choices without changing their controller or metadata. */
+export declare function standardInternalChoicePort(port: OwnedUiShellComponentPort, metadata?: boolean): OwnedUiShellComponentPort;
 /** Paints the standard Pi Input prompt as a live-themed dialog-search marker. */
 export declare function renderPiModalSearchInput(input: Input, width: number): string[];
 /** Replaces one explicitly identified direct Input child with the standard search presentation. */

package/dist/integrations/pi/components/modal-frame.js

@@ -1,7 +1,35 @@
-import { Container, Input, Spacer, Text, } from "@earendil-works/pi-tui";
+import { Container, Input, Spacer, Text, sliceByColumn, stripTerminalSequences, visibleWidth, } from "@earendil-works/pi-tui";
 import { DIALOG_CONTENT_PADDING_X, dialogFrameGeometry, insetDialogContent } from "../../../contracts/presentation/index.js";
-import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalShortcutHints } from "./theme.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalShortcutHints, renderPiModalListRow } from "./theme.js";
 export const PI_MODAL_CONTENT_PADDING_X = DIALOG_CONTENT_PADDING_X;
+/** Applies standard primary/metadata roles without changing a pinned row's text or clipping. */
+export function renderPiModalSelectedPrimary(row, width, labels) {
+    const plain = stripTerminalSequences(row).trimEnd();
+    if (!plain.startsWith(" → "))
+        return row;
+    const primary = labels.filter(label => plain.slice(3).startsWith(label))
+        .sort((left, right) => visibleWidth(right) - visibleWidth(left))[0];
+    const length = primary === undefined ? Math.max(0, visibleWidth(plain) - 3) : visibleWidth(primary);
+    const label = stripTerminalSequences(sliceByColumn(row, 3, length));
+    const suffix = sliceByColumn(row, 3 + length, Math.max(0, visibleWidth(plain) - 3 - length));
+    const theme = piTheme();
+    return ` ${renderPiModalListRow(`${theme.fg("accent", "→ ")}${theme.fg("text", label)}${theme.fg("muted", stripTerminalSequences(suffix))}`, Math.max(0, width - 1), true)}`;
+}
+/** Standardizes internal legacy model/message choices without changing their controller or metadata. */
+export function standardInternalChoicePort(port, metadata = false) {
+    return { ...port, render: width => port.render(width).map(row => {
+            const match = /^(\s*)[→›] (.*)$/u.exec(stripTerminalSequences(row).trimEnd());
+            if (match === null)
+                return row;
+            const indent = visibleWidth(match[1]);
+            const marker = metadata ? sliceByColumn(row, indent + 2, 2) : "";
+            const label = metadata ? match[2].slice(2).split(/ \[| \(/u, 1)[0] : match[2];
+            const suffixStart = indent + 2 + (metadata ? 2 : 0) + visibleWidth(label);
+            const suffix = metadata ? sliceByColumn(row, suffixStart, Math.max(0, visibleWidth(row) - suffixStart)).trimEnd() : "";
+            const theme = piTheme();
+            return `${match[1]}${renderPiModalListRow(`${theme.fg("accent", "→ ")}${marker}${theme.fg("text", label)}${suffix}`, Math.max(0, width - indent), true)}`;
+        }) };
+}
 /** Paints the standard Pi Input prompt as a live-themed dialog-search marker. */
 export function renderPiModalSearchInput(input, width) {
     return input.render(width).map(row => {

package/dist/integrations/pi/components/models-dialog-loader.d.ts

@@ -0,0 +1,11 @@
+import type { OwnedUiShellComponentPort } from "../../../contracts/owned-ui/index.js";
+import type { ModelsDialogConfig, ModelsDialogCallbacks, ModelsDialogModel } from "./models-dialog.js";
+interface DeferredModelsDialogPort extends OwnedUiShellComponentPort {
+    readonly ready: Promise<void>;
+    updateModels(models: readonly ModelsDialogModel[]): void;
+    setRefreshStatus(message: string, kind: "muted" | "success" | "warning"): void;
+    dirty(): boolean;
+}
+/** Captures input immediately while keeping the optional Models controller outside the startup graph. */
+export declare function createDeferredModelsDialog(options: ModelsDialogConfig & ModelsDialogCallbacks): DeferredModelsDialogPort;
+export {};

package/dist/integrations/pi/components/models-dialog-loader.js

@@ -0,0 +1,45 @@
+/** Captures input immediately while keeping the optional Models controller outside the startup graph. */
+export function createDeferredModelsDialog(options) {
+    let dialog;
+    let closed = false;
+    let focused = false;
+    let models = options.models;
+    let status;
+    let failure;
+    const pending = [];
+    const ready = import("./models-dialog.js").then(({ ModelsDialogComponent }) => {
+        if (closed)
+            return;
+        dialog = new ModelsDialogComponent({ ...options, models }, options);
+        dialog.focused = focused;
+        if (status !== undefined)
+            dialog.setRefreshStatus(...status);
+        for (const data of pending.splice(0)) {
+            if (!closed)
+                dialog.handleInput(data);
+        }
+        options.requestRender();
+    }).catch(() => { if (!closed) {
+        failure = "Models unavailable — Esc close";
+        options.requestRender();
+    } });
+    return {
+        ready,
+        render: width => dialog?.render(width) ?? (failure === undefined ? [] : [failure.slice(0, width)]),
+        handleInput: data => {
+            if (dialog !== undefined)
+                dialog.handleInput(data);
+            else if (data === "\u001b" || data === "\u0003")
+                options.onCancel();
+            else if (pending.length < 32)
+                pending.push(data);
+        },
+        invalidate: () => dialog?.invalidate(),
+        setFocused: value => { focused = value; if (dialog !== undefined)
+            dialog.focused = value; },
+        dispose: () => { closed = true; pending.length = 0; dialog?.dispose(); },
+        updateModels: next => { models = next; dialog?.updateModels(next); },
+        setRefreshStatus: (message, kind) => { status = [message, kind]; dialog?.setRefreshStatus(message, kind); },
+        dirty: () => dialog?.dirty ?? false,
+    };
+}

package/dist/integrations/pi/components/models-dialog.d.ts

@@ -19,6 +19,8 @@ export interface ModelsDialogConfig {
     readonly refreshStatus?: string;
 }
 export interface ModelsDialogCallbacks {
+    /** Live terminal height; omitted component consumers retain the ordinary 24-row budget. */
+    viewportHeight?(): number;
     /** Enter on a row: the shell switches through its workflow and closes the dialog on success. */
     onSelect(modelId: string): void;
     /** Every scope or order edit, session-only. */

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

@@ -208,20 +208,25 @@ export class ModelsDialogComponent {
         const push = (line = "") => { lines.push(truncateToWidth(line, width)); };
         const rows = this.#rows();
         this.#clampSelection(rows);
+        const height = this.#callbacks.viewportHeight?.() ?? 24;
+        const compact = height < 13;
+        const capacity = Math.max(1, Math.min(MAX_VISIBLE_ROWS, height - (compact ? 7 : 13)));
         push(theme.fg("dim", "Filter: ")
             + theme.fg(this.#filter === "all" ? "mdHeading" : "dim", "all")
             + theme.fg("dim", " | ")
             + theme.fg(this.#filter === "scoped" ? "mdHeading" : "dim", "scoped"));
-        push();
+        if (!compact)
+            push();
         for (const line of renderPiModalSearchInput(this.#input, width))
             push(line);
-        push();
+        if (!compact)
+            push();
         if (rows.length === 0) {
             push(theme.fg("muted", `  ${this.#emptyText()}`));
         }
         else {
-            const startIndex = Math.max(0, Math.min(this.#selectedIndex - Math.floor(MAX_VISIBLE_ROWS / 2), rows.length - MAX_VISIBLE_ROWS));
-            const endIndex = Math.min(startIndex + MAX_VISIBLE_ROWS, rows.length);
+            const startIndex = Math.max(0, Math.min(this.#selectedIndex - Math.floor(capacity / 2), rows.length - capacity));
+            const endIndex = Math.min(startIndex + capacity, rows.length);
             for (let index = startIndex; index < endIndex; index += 1) {
                 const row = rows[index];
                 const selected = index === this.#selectedIndex;
@@ -234,15 +239,16 @@ export class ModelsDialogComponent {
                 const active = row.fullId === this.#activeModelId ? ` ${theme.fg("success", "✓")}` : "";
                 push(renderPiModalListRow(`${prefix}${marker} ${label} ${provider}${active}`, width, selected));
             }
-            if (startIndex > 0 || endIndex < rows.length)
+            if (!compact && (startIndex > 0 || endIndex < rows.length))
                 push(theme.fg("muted", `  (${this.#selectedIndex + 1}/${rows.length})`));
             const selectedRow = rows[this.#selectedIndex];
-            if (selectedRow) {
+            if (selectedRow && !compact) {
                 push();
                 push(theme.fg("muted", `  Model Name: ${selectedRow.model.name}`));
             }
         }
-        push();
+        if (!compact)
+            push();
         if (this.#refreshStatus !== undefined)
             push(theme.fg(this.#refreshStatus.kind, `  ${this.#refreshStatus.message}`));
         push(renderHintsWithClose(this.#hints(), width));

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.5.0 (MIT),
- * commit f9a26365568127461c47a07a37dcb42c140a3ac5.
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.5.1 (MIT),
+ * commit dd30101cfc5b0609411dd80b6f93adbc14db14cf.
  * 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.5.0 (MIT),
- * commit f9a26365568127461c47a07a37dcb42c140a3ac5.
+ * Attributed owned theme resources adapted from @earendil-works/pi-coding-agent 1.5.1 (MIT),
+ * commit dd30101cfc5b0609411dd80b6f93adbc14db14cf.
  * Upstream dark.json SHA-256: e1f96982f8cb7d2a48eca7db03c9cb282cb1e14a243680cd855638ecd6a251b6
  * Upstream light.json SHA-256: 2dee6a4be7f765e7fd7728166b7ebf8c29e4ce313f8ec6b38ae50699e3abc2f3
  * Modifications: removed upstream schema/export metadata; runtime color data is unchanged.