@timurproko/a1 0.2.7-dev.1275 → 0.2.7-dev.1285

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.1 (MIT), commit dd30101cfc5b0609411dd80b6f93adbc14db14cf. Do not edit directly.
+ * over pinned Pi 1.5.2 (MIT), commit b4afdddf44e059c67ccf5097e5317d913521b470. 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/progress-spinner.d.ts

@@ -0,0 +1,7 @@
+/** Owned indeterminate-progress styles; Current delegates to the pinned loader's dot frames. */
+export type ProgressSpinnerStyle = "none" | "current" | "circle" | "diamond" | "square";
+/** Profile-scoped live spinner choice, borrowed by owned status and operation components. */
+export interface ProgressSpinnerSource {
+    readonly snapshot: () => ProgressSpinnerStyle;
+    readonly onChange: (listener: () => void) => () => void;
+}

package/dist/contracts/presentation/progress-spinner.js

@@ -0,0 +1 @@
+export {};

package/dist/features/launch/session-context.d.ts

@@ -3,6 +3,10 @@ export { PRIMARY_SESSION_AGENT_ID } from "../../foundation/lifecycle/index.js";
 export type SessionContextRequest = {
     readonly action: "link-worktree";
     readonly path: string;
+} | {
+    readonly action: "enter-worktree";
+    readonly branch: string;
+    readonly base?: string;
 } | {
     readonly action: "unlink-worktree";
 } | {
@@ -11,6 +15,7 @@ export type SessionContextRequest = {
 export type SessionContextOutcome = {
     readonly kind: "linked";
     readonly cwd: string;
+    readonly branch: string;
 } | {
     readonly kind: "unlinked";
 } | {
@@ -20,5 +25,8 @@ export type SessionContextOutcome = {
 export interface SessionContextRuntime {
     readonly runtimeId: string;
     readonly inspectProcess: (pid: number) => Promise<ProcessIdentity | null>;
+    readonly dataDir?: string;
+    readonly signal?: AbortSignal;
+    readonly retryBudgetMs?: number;
 }
 export declare function updateSessionRepositoryContext(identity: SessionRepositoryIdentity, request: SessionContextRequest, runtime: SessionContextRuntime): Promise<SessionContextOutcome>;

package/dist/features/launch/session-context.js

@@ -1,13 +1,22 @@
-import { clearSessionRepositoryContext, listSessionRepositoryWorktrees, setSessionRepositoryContext, } from "../../foundation/lifecycle/index.js";
+import { clearSessionRepositoryContext, enterSessionRepositoryWorktree, listSessionRepositoryWorktrees, retrySessionCoordination, setSessionRepositoryContext, } from "../../foundation/lifecycle/index.js";
 export { PRIMARY_SESSION_AGENT_ID } from "../../foundation/lifecycle/index.js";
 export async function updateSessionRepositoryContext(identity, request, runtime) {
-    const options = { runtimeId: runtime.runtimeId, inspectProcess: runtime.inspectProcess };
-    if (request.action === "unlink-worktree") {
-        await clearSessionRepositoryContext(identity, options);
-        return { kind: "unlinked" };
-    }
-    if (request.action === "worktrees") {
-        return { kind: "worktrees", entries: await listSessionRepositoryWorktrees(identity, options) };
-    }
-    return { kind: "linked", cwd: (await setSessionRepositoryContext(identity, request.path, options)).cwd };
+    const options = {
+        runtimeId: runtime.runtimeId, inspectProcess: runtime.inspectProcess,
+        ...(runtime.dataDir === undefined ? {} : { dataDir: runtime.dataDir }),
+        ...(runtime.signal === undefined ? {} : { signal: runtime.signal }),
+    };
+    return await retrySessionCoordination(async () => {
+        if (request.action === "enter-worktree") {
+            return { kind: "linked", ...await enterSessionRepositoryWorktree(identity, request.branch, request.base, options) };
+        }
+        if (request.action === "unlink-worktree") {
+            await clearSessionRepositoryContext(identity, options);
+            return { kind: "unlinked" };
+        }
+        if (request.action === "worktrees") {
+            return { kind: "worktrees", entries: await listSessionRepositoryWorktrees(identity, options) };
+        }
+        return { kind: "linked", ...await setSessionRepositoryContext(identity, request.path, options) };
+    }, runtime.retryBudgetMs ?? 8_000, runtime.signal);
 }

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

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

@@ -4,12 +4,16 @@ import { GLOBAL_SCOPE, PLAIN_THEME, RAIL_COLUMNS, ShortcutRegistry, ScrollbarRai
 const SCOPE = "reference-screen";
 /** Rows above the document: the top rule. */
 const HEADER_ROWS = 1;
-/** Rows below the document: the bottom rule and the hint line. */
+/** Base rows below the document: the bottom rule and the hint line. */
 const FOOTER_ROWS = 2;
 // Compatibility: the transcript rail stays lit this long after a scroll, and repaints just after.
 const SCROLL_LINGER_MS = 900;
 const SCROLL_LINGER_REPAINT_MS = 925;
 const LOADING_NOTICE = "Loading…";
+/** Keeps document rendering and paging on the same height after reserving dialog footer spacing. */
+function referenceBodyHeight(height, dialog) {
+    return Math.max(0, height - HEADER_ROWS - FOOTER_ROWS - (dialog ? 1 : 0));
+}
 export const REFERENCE_SCREEN_SHORTCUTS = new ShortcutRegistry();
 REFERENCE_SCREEN_SHORTCUTS.declare({ key: "up", scope: SCOPE, description: "Scroll up", section: "Navigate", hint: { keys: "↑↓", does: "scroll" } }, "up");
 REFERENCE_SCREEN_SHORTCUTS.declare({ key: "down", scope: SCOPE, description: "Scroll down", section: "Navigate", hint: { keys: "↑↓", does: "scroll" } }, "down");
@@ -47,6 +51,7 @@ const KEYS = {
 export class ReferenceScreenApp {
     id;
     #title;
+    #dialog;
     #document;
     #scrollSettings;
     #selection;
@@ -66,6 +71,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);
@@ -93,7 +99,7 @@ export class ReferenceScreenApp {
         const settings = this.#scrollSettings();
         const reservesRail = settings.scrollbarAppearance !== "hidden";
         const contentWidth = reservesRail ? Math.max(0, rect.width - RAIL_COLUMNS) : rect.width;
-        const bodyHeight = Math.max(0, rect.height - HEADER_ROWS - FOOTER_ROWS);
+        const bodyHeight = referenceBodyHeight(rect.height, this.#dialog);
         const content = this.#content(contentWidth, theme);
         const body = [];
         const visibleDocumentRows = [];
@@ -158,7 +164,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(""));
     }
@@ -185,10 +192,10 @@ export class ReferenceScreenApp {
                 this.#scrollBy(1);
                 return { consumed: true };
             case "page-up":
-                this.#scrollBy(-Math.max(1, host.getSize().height - HEADER_ROWS - FOOTER_ROWS));
+                this.#scrollBy(-Math.max(1, referenceBodyHeight(host.getSize().height, this.#dialog)));
                 return { consumed: true };
             case "page-down":
-                this.#scrollBy(Math.max(1, host.getSize().height - HEADER_ROWS - FOOTER_ROWS));
+                this.#scrollBy(Math.max(1, referenceBodyHeight(host.getSize().height, this.#dialog)));
                 return { consumed: true };
             case "first":
                 this.#scroll = 0;

package/dist/features/owned-ui/session-fork-prompt.d.ts

@@ -5,4 +5,5 @@ export declare function createConsoleSessionForkPrompt(options?: {
     readonly output?: Writable;
 }): (request: {
     readonly sourceCwd: string;
-}) => Promise<boolean>;
+    readonly fallbackCwd?: string;
+}) => Promise<boolean | "continue" | "fork" | "cancel">;

package/dist/features/owned-ui/session-fork-prompt.js

@@ -3,14 +3,17 @@ import { createInterface } from "node:readline";
 export function createConsoleSessionForkPrompt(options = {}) {
     const input = options.input ?? process.stdin;
     const output = options.output ?? process.stdout;
-    return async ({ sourceCwd }) => {
-        output.write(`Session found in different project: ${sourceCwd}\n`);
+    return async ({ sourceCwd, fallbackCwd }) => {
+        const recovering = fallbackCwd !== undefined;
+        output.write(recovering
+            ? `Session cwd does not exist: ${sourceCwd}\n1. Continue in ${fallbackCwd} (asks again next time)\n2. Fork into ${fallbackCwd} (new session ID, original kept)\n3. Cancel\n`
+            : `Session found in different project: ${sourceCwd}\n`);
         const wasFlowing = input.readableFlowing;
         const readline = createInterface({ input, output });
         try {
             return await new Promise((resolve, reject) => {
                 const finish = (accepted) => { cleanup(); resolve(accepted); };
-                const cancel = () => finish(false);
+                const cancel = () => finish(recovering ? "cancel" : false);
                 const fail = (error) => { cleanup(); reject(error); };
                 const cleanup = () => {
                     readline.off("close", cancel);
@@ -20,8 +23,11 @@ export function createConsoleSessionForkPrompt(options = {}) {
                 readline.once("close", cancel);
                 readline.once("SIGINT", cancel);
                 input.once("error", fail);
-                readline.question("Fork this session into current directory? [y/N] ", answer => {
-                    finish(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+                readline.question(recovering ? "Choose Continue, Fork, or Cancel [1/2/3]: " : "Fork this session into current directory? [y/N] ", answer => {
+                    const choice = answer.trim().toLowerCase();
+                    finish(recovering
+                        ? choice === "1" || choice === "continue" ? "continue" : choice === "2" || choice === "fork" ? "fork" : "cancel"
+                        : choice === "y" || choice === "yes");
                 });
             });
         }

package/dist/features/owned-ui/settings-app.d.ts

@@ -22,5 +22,5 @@ export declare class SettingsApp implements UiApp {
     onClose(_host: AppHostServices): void;
     render(rect: PaneRect, host: AppHostServices): readonly string[];
     onInput(data: string, host: AppHostServices): PaneInputResult;
-    onMouse(event: PaneMouseEvent, _host: AppHostServices): PaneInputResult;
+    onMouse(event: PaneMouseEvent, host: AppHostServices): PaneInputResult;
 }

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

@@ -1,6 +1,7 @@
-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 { SettingsSpinnerPreview } from "./settings-spinner-preview.js";
 import { SettingsEdits, replaceRecord, sameRecord } from "./settings-edits.js";
 import { SETTINGS_APP_ID } from "./settings-route.js";
 import { dialogWindow, modelDialogKey, modelDialogLines } from "./settings-model-dialog.js";
@@ -111,6 +112,8 @@ export class SettingsApp {
         void this.#session.load().then(() => host.requestRender());
     }
     onClose(_host) {
+        this.#menu?.preview?.dispose();
+        this.#menu = null;
         this.#edits.close();
         this.#search.input?.setFocused(false);
         this.#search.input = null;
@@ -235,12 +238,12 @@ export class SettingsApp {
                 else if (row?.kind === "element" && typeof this.#edits.shown(row.value) === "number")
                     this.#cycle(rows, selected, 1);
                 else
-                    this.#openMenu(rows, selected, true);
+                    this.#openMenu(rows, selected, host, true);
                 return { consumed: true };
             }
             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":
@@ -276,7 +279,7 @@ export class SettingsApp {
                 return { consumed: false };
         }
     }
-    onMouse(event, _host) {
+    onMouse(event, host) {
         const searchPointer = handleSettingsSearchPointer(this.#search, event, this.#panelTopForFrame);
         if (searchPointer !== null)
             return searchPointer;
@@ -367,14 +370,14 @@ export class SettingsApp {
                 else if (this.#hoverRegion === "plus")
                     this.#cycle(rows, index, 1);
                 else if (this.#hoverRegion === "value")
-                    this.#openMenu(rows, index);
+                    this.#openMenu(rows, index, host);
             }
             return { consumed: true };
         }
         const changed = previousKey !== this.#hoverKey || previousRegion !== this.#hoverRegion || rail.changed;
         return { consumed: event.kind !== "motion", render: changed };
     }
-    #openMenu(rows, selected, selectCurrent = false) {
+    #openMenu(rows, selected, host, selectCurrent = false) {
         const row = rows[selected];
         if (row === undefined || row.kind !== "element")
             return;
@@ -406,10 +409,12 @@ export class SettingsApp {
             anchorKey,
             choices: entry.choices,
             keyboardOpened: selectCurrent,
+            preview: entry.backend === "a1" && entry.id === "spinnerStyle" ? new SettingsSpinnerPreview(() => host.requestRender()) : null,
             index: current,
         };
     }
     #closeMenu(menu) {
+        menu.preview?.dispose();
         this.#menu = null;
         if (!menu.keyboardOpened || this.#hoverKey !== menu.anchorKey)
             return;
@@ -472,10 +477,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 +534,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 +582,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();
@@ -720,14 +725,16 @@ export class SettingsApp {
         const menu = this.#menu;
         const anchor = menu === null ? undefined : this.#frameRows.find(candidate => candidate.key === menu.anchorKey);
         if (menu === null || anchor === undefined) {
+            menu?.preview?.dispose();
             this.#menuFrame = null;
             return lines;
         }
         const state = {
             choices: menu.choices.map(choice => displaySettingValue(menu.entry, choice)),
-            ...(menu.entry.id === "accentColor" ? {
-                previews: menu.choices.map(choice => theme.accentPreview?.(String(choice), "■") ?? ""),
-            } : {}),
+            ...(menu.preview !== null ? { previews: menu.preview.frames(menu.choices, menu.index, theme) }
+                : menu.entry.id === "accentColor" ? {
+                    previews: menu.choices.map(choice => theme.accentPreview?.(String(choice), "■") ?? ""),
+                } : {}),
             current: this.#edits.shown(menu.entry) === null ? null : displaySettingValue(menu.entry, this.#edits.shown(menu.entry)),
             index: menu.index,
         };

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/features/owned-ui/settings-spinner-preview.d.ts

@@ -0,0 +1,9 @@
+import type { UiTheme } from "../../ui/components/index.js";
+import type { OwnedUiSettingValue } from "../../ui/settings/index.js";
+/** One dropdown's focused spinner animation; unselected choices keep their representative frame. */
+export declare class SettingsSpinnerPreview {
+    #private;
+    constructor(requestRender: () => void);
+    frames(choices: readonly OwnedUiSettingValue[], selected: number, theme: UiTheme): readonly string[];
+    dispose(): void;
+}

package/dist/features/owned-ui/settings-spinner-preview.js

@@ -0,0 +1,29 @@
+import { isProgressSpinnerStyle, progressSpinnerFrame, PROGRESS_SPINNER_INTERVAL_MS, } from "../../ui/components/index.js";
+/** One dropdown's focused spinner animation; unselected choices keep their representative frame. */
+export class SettingsSpinnerPreview {
+    #requestRender;
+    #phase = 0;
+    #timer;
+    constructor(requestRender) {
+        this.#requestRender = requestRender;
+    }
+    frames(choices, selected, theme) {
+        const focused = choices[selected];
+        const animated = isProgressSpinnerStyle(focused) && focused !== "none";
+        if (animated && this.#timer === undefined) {
+            this.#timer = setInterval(() => { this.#phase += 1; this.#requestRender(); }, PROGRESS_SPINNER_INTERVAL_MS);
+            this.#timer.unref?.();
+        }
+        else if (!animated)
+            this.dispose();
+        return choices.map((choice, index) => {
+            const frame = isProgressSpinnerStyle(choice) ? progressSpinnerFrame(choice, index === selected ? this.#phase : 0) : "";
+            return frame === "" ? "" : theme.fg("accent", frame);
+        });
+    }
+    dispose() {
+        if (this.#timer !== undefined)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+    }
+}

package/dist/features/session-naming/context.d.ts

@@ -0,0 +1,17 @@
+import type { OwnedUiTranscriptBlock } from "../../contracts/owned-ui/index.js";
+export interface SessionNamingContext {
+    readonly cwd: string;
+    readonly branch: string | null;
+    readonly revision: string;
+}
+export declare function isGenericSessionName(value: string): boolean;
+export interface SessionNamingTask {
+    readonly prompt: string;
+    readonly hints: string;
+    readonly discussion: readonly {
+        readonly role: "user" | "assistant";
+        readonly text: string;
+    }[];
+    readonly fallback: string;
+}
+export declare function sessionNamingTask(prompt: string, promptId: string, context: SessionNamingContext, transcript: readonly OwnedUiTranscriptBlock[], allowUnanchored: boolean): SessionNamingTask;