@timurproko/a1 0.2.6-dev.727 → 0.2.6-dev.734

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

@@ -0,0 +1,55 @@
+/**
+ * Presenters for the selectors and transcript renderers whose inputs are engine objects. The shell opens them
+ * through this port and never holds those objects; the Pi session presenters owner implements it.
+ */
+import type { OwnedUiCommandResult, OwnedUiWorkflowRequest, OwnedUiWorkflowResult } from "./session-workflows.js";
+/** A component that replaces the prompt editor while a selector is open. */
+export interface OwnedUiInputSurface {
+    render(width: number): readonly string[];
+    invalidate(): void;
+    handleInput?(data: string): void;
+    setFocused?(focused: boolean): void;
+    dispose?(): void;
+}
+/** The shell's side of a presenter: where the selector is shown and how its choices reach the session. */
+export interface OwnedUiDialogHost {
+    /** True once the shell is disposed; a presenter that awaited stops before showing anything. */
+    readonly disposed: boolean;
+    setInputSurface(surface: OwnedUiInputSurface | null): void;
+    requestRender(): void;
+    viewport(): {
+        readonly columns: number;
+        readonly rows: number;
+    };
+    appendWorkflowStatus(text: string): void;
+    appendWorkflowResult(result: OwnedUiWorkflowResult): void;
+    runWorkflow(request: OwnedUiWorkflowRequest): Promise<OwnedUiCommandResult>;
+    /** Present only where the shell holds frames while an optional selector module loads. */
+    beginPresentationHold?(): () => void;
+    /** Present only where the surface can change TUI mode; false means overlays block the switch. */
+    switchTuiMode?(mode: "regular" | "fullscreen"): boolean;
+}
+/** One extension shortcut row in the hotkeys document. */
+export interface OwnedUiShortcutDescription {
+    readonly key: string;
+    readonly description: string;
+}
+/**
+ * Extension renderer lookups for transcript components. Renderers are opaque objects that only the component
+ * adapter inspects and validates; the shell passes this port through without reading them.
+ */
+export interface OwnedUiTranscriptRendererPort {
+    getMessageRenderer(customType: string): object | undefined;
+    getToolRenderers(toolName: string): object | undefined;
+    getShortcuts(bindings: Readonly<Record<string, string | readonly string[] | undefined>>): readonly OwnedUiShortcutDescription[];
+}
+export interface OwnedUiSessionPresenters {
+    transcriptRenderers(): OwnedUiTranscriptRendererPort;
+    openModelSelector(host: OwnedUiDialogHost, initialSearchInput?: string): void;
+    openSessionSelector(host: OwnedUiDialogHost, onExit: () => void): Promise<void>;
+    /** `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;
+    openScopedModelsSelector(host: OwnedUiDialogHost): void;
+}

package/dist/contracts/owned-ui/session-presenters.js

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

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

@@ -0,0 +1,342 @@
+/**
+ * Payloads that cross the session backend port: workflow requests and results, catalog and
+ * settings snapshots, resource summaries, and the slash-command names the shell routes. Every
+ * declaration is plain data, so a backend other than pinned Pi can produce it.
+ */
+import type { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES } from "./extension-ui.js";
+import type { OwnedUiCommandOutcome, OwnedUiThinkingLevel } from "./model.js";
+/** Every workflow command the session engine advertises, in its own catalog order. */
+export declare const OWNED_UI_WORKFLOW_COMMAND_NAMES: readonly ["settings", "model", "tree", "thinking", "scoped-models", "export", "import", "share", "copy", "name", "session", "changelog", "hotkeys", "fork", "clone", "trust", "login", "logout", "new", "compact", "resume", "reload", "quit"];
+/** Routes the engine answers but never advertises. */
+export declare const OWNED_UI_HIDDEN_COMMAND_NAMES: readonly ["debug", "arminsayshi", "dementedelves"];
+/** The one bare-A1 model command; it replaces the `model` and `scoped-models` routes there. */
+export declare const OWNED_UI_MODELS_COMMAND_NAME: "models";
+export type OwnedUiWorkflowCommandName = typeof OWNED_UI_WORKFLOW_COMMAND_NAMES[number];
+export type OwnedUiHiddenWorkflowCommandName = typeof OWNED_UI_HIDDEN_COMMAND_NAMES[number];
+export type OwnedUiModelsCommandName = typeof OWNED_UI_MODELS_COMMAND_NAME;
+export type OwnedUiWorkflowRoute = OwnedUiWorkflowCommandName | OwnedUiHiddenWorkflowCommandName | OwnedUiModelsCommandName;
+/** Which settings surface a backend serves; hidden-in-bare effects are unbindable in bare mode. */
+export type OwnedUiSessionProductMode = "bare" | "comparison";
+export interface OwnedUiWorkflowOption {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
+export interface OwnedUiAuthenticationProviderStatus {
+    readonly type: "oauth" | "api_key";
+    readonly source?: string;
+}
+export interface OwnedUiAuthenticationProviderOption extends OwnedUiWorkflowOption {
+    readonly providerId: string;
+    readonly authType: "oauth" | "api_key";
+    readonly status?: OwnedUiAuthenticationProviderStatus;
+}
+/** A provider configured outside the engine, which the login route explains instead of running. */
+export interface OwnedUiAmbientAuthentication {
+    readonly providerId: string;
+    readonly providerName: string;
+    readonly title: string;
+    readonly message: string;
+}
+export interface OwnedUiWorkflowRequest {
+    readonly command: OwnedUiWorkflowRoute;
+    readonly argument: string;
+    readonly selection?: string;
+    /** For the model route: also persist the selection as the default model. The bare `models` route always persists. */
+    readonly persist?: boolean;
+    readonly confirmed?: boolean;
+    /** Recovery cwd selected after an import/resume source cwd is unavailable. */
+    readonly cwdOverride?: string;
+    /** Cancellation for an owned operation surface such as `/share`. */
+    readonly signal?: AbortSignal;
+    readonly treeSummary?: {
+        readonly summarize: boolean;
+        readonly customInstructions?: string;
+    };
+}
+export type OwnedUiWorkflowOutcome = "completed" | "cancelled" | "failed" | "requires-selection" | "requires-confirmation";
+export interface OwnedUiSessionInfoPresentation {
+    readonly kind: "session-info";
+    readonly sessionName?: string;
+    readonly stats: {
+        readonly sessionFile?: string;
+        readonly sessionId: string;
+        readonly userMessages: number;
+        readonly assistantMessages: number;
+        readonly toolCalls: number;
+        readonly toolResults: number;
+        readonly totalMessages: number;
+        readonly tokens: {
+            readonly input: number;
+            readonly output: number;
+            readonly cacheRead: number;
+            readonly cacheWrite: number;
+            readonly total: number;
+        };
+        readonly cost: number;
+    };
+    readonly cacheWaste: {
+        readonly missedTokens: number;
+        readonly missedCost: number;
+        readonly missCount: number;
+    };
+    readonly usageBreakdown: readonly {
+        readonly key: string;
+        readonly cost: number;
+        readonly tokens: number;
+    }[];
+    readonly cacheWarming: OwnedUiCacheWarmingPresentation;
+}
+/** The engine's prompt-cache warming mode and, once warming has acted, the decision behind it. */
+export interface OwnedUiCacheWarmingPresentation {
+    readonly mode: string;
+    readonly status?: {
+        readonly state: "inactive" | "scheduled" | "refreshing";
+        readonly reason?: string;
+        readonly nextWarmAt?: number;
+        readonly extensionOverride?: boolean;
+        readonly decision?: {
+            readonly phase: "streaming" | "idle";
+            readonly action: string;
+            readonly warmCost: number;
+            readonly missCost: number;
+            readonly continuationProbability: number;
+            readonly expectedSavings: number;
+            readonly economicsAvailable: boolean;
+        };
+    };
+}
+export type OwnedUiWorkflowPresentation = OwnedUiSessionInfoPresentation;
+export type OwnedUiWorkflowMessageKind = "status" | "warning" | "error" | "accent" | "silent";
+export interface OwnedUiWorkflowMessage {
+    readonly kind: Exclude<OwnedUiWorkflowMessageKind, "silent">;
+    readonly message: string;
+}
+export interface OwnedUiWorkflowResult {
+    readonly command: OwnedUiWorkflowRoute;
+    readonly outcome: OwnedUiWorkflowOutcome;
+    readonly message: string;
+    /** Explicit presentation semantics; never inferred from message prefixes. */
+    readonly messageKind?: OwnedUiWorkflowMessageKind;
+    /** Ordered messages for truthful partial-success outcomes. */
+    readonly messages?: readonly OwnedUiWorkflowMessage[];
+    readonly detail?: string;
+    readonly selectorTitle?: string;
+    readonly options?: readonly OwnedUiWorkflowOption[];
+    readonly presentation?: OwnedUiWorkflowPresentation;
+}
+export interface OwnedUiWorkflowAutocompleteCommand {
+    readonly name: string;
+    readonly description?: string;
+    readonly argumentHint?: string;
+    readonly argumentOptions?: readonly OwnedUiWorkflowOption[];
+    readonly source: "builtin" | "prompt" | "skill" | "extension";
+}
+export interface OwnedUiWorkflowInteractionRequest {
+    readonly type: "text" | "secret" | "manual-code" | "select";
+    readonly message: string;
+    readonly placeholder?: string;
+    readonly options?: readonly {
+        readonly id: string;
+        readonly label: string;
+    }[];
+}
+export interface OwnedUiWorkflowLoginStart {
+    readonly providerId: string;
+    readonly providerName: string;
+    readonly authType: "oauth" | "api_key";
+}
+export type OwnedUiWorkflowLoginNotification = {
+    readonly type: "auth_url";
+    readonly url: string;
+    readonly instructions?: string;
+} | {
+    readonly type: "device_code";
+    readonly verificationUri: string;
+    readonly userCode: string;
+} | {
+    readonly type: "info";
+    readonly message: string;
+    readonly links?: readonly {
+        readonly label?: string;
+        readonly url: string;
+    }[];
+} | {
+    readonly type: "waiting" | "progress";
+    readonly message: string;
+};
+/** The shell's side of an interactive workflow such as `/login`. */
+export interface OwnedUiWorkflowInteractionHost {
+    startLogin?(request: OwnedUiWorkflowLoginStart): void;
+    prompt(request: OwnedUiWorkflowInteractionRequest): Promise<string | null>;
+    notify(event: OwnedUiWorkflowLoginNotification): void;
+    /** Deliver a post-login status or warning after the authentication dialog closes. */
+    publish?(message: OwnedUiWorkflowMessage): void;
+    finishLogin?(): void;
+}
+export interface OwnedUiBashWorkflowResult {
+    readonly command: string;
+    readonly output: string;
+    readonly exitCode: number | undefined;
+    readonly cancelled: boolean;
+    readonly truncated: boolean;
+    readonly excludeFromContext: boolean;
+}
+export interface OwnedUiScopedModelDescriptor {
+    readonly provider: string;
+    readonly id: string;
+    readonly name: string;
+}
+export interface OwnedUiScopedModelsContext {
+    readonly models: readonly OwnedUiScopedModelDescriptor[];
+    readonly enabledModelIds: readonly string[] | null;
+}
+export interface OwnedUiScopedModelsRefreshResult extends OwnedUiScopedModelsContext {
+    readonly status: string;
+    readonly statusKind: "success" | "warning";
+}
+/** What the bare-A1 Models dialog reads: the authenticated catalog and the explicit session and persisted scopes, kept apart. */
+export interface OwnedUiModelsContext {
+    readonly models: readonly OwnedUiScopedModelDescriptor[];
+    /** `provider/id` of the active model, or null before one is set. */
+    readonly activeModelId: string | null;
+    /** Ordered `provider/id` references the session cycles; empty is the all-model fallback, not an explicit full scope. */
+    readonly sessionScopeIds: readonly string[];
+    /** The persisted `enabledModels` patterns resolved against the catalog, in order; unmatched patterns stay verbatim. */
+    readonly persistedScopeIds: readonly string[];
+}
+export interface OwnedUiModelsRefreshResult {
+    readonly models: readonly OwnedUiScopedModelDescriptor[];
+    readonly status: string;
+    readonly statusKind: "success" | "warning";
+}
+export interface OwnedUiProjectTrustUpdate {
+    readonly path: string;
+    readonly decision: boolean | null;
+}
+export interface OwnedUiProjectTrustContext {
+    readonly cwd: string;
+    readonly savedDecision: {
+        readonly path: string;
+        readonly decision: boolean;
+    } | null;
+    readonly projectTrusted: boolean;
+    readonly trustOptions: readonly {
+        readonly label: string;
+        readonly trusted: boolean;
+        readonly updates: readonly OwnedUiProjectTrustUpdate[];
+        readonly savedPath?: string;
+    }[];
+}
+export interface OwnedUiSessionResumeMetadata {
+    readonly sessionId: string;
+    readonly sessionDir: string;
+    readonly usesDefaultSessionDir: boolean;
+}
+/** Settings-level thinking: the session's levels plus `max`, which only models that map it offer. */
+export type OwnedUiSettingsThinkingLevel = OwnedUiThinkingLevel | "max";
+/** The engine settings the shell reads to configure itself and to seed its settings surfaces. */
+export interface OwnedUiSessionSettingsSnapshot {
+    readonly autoCompact: boolean;
+    readonly showImages: boolean;
+    readonly imageWidthCells: number;
+    readonly autoResizeImages: boolean;
+    readonly blockImages: boolean;
+    readonly enableSkillCommands: boolean;
+    readonly steeringMode: "all" | "one-at-a-time";
+    readonly followUpMode: "all" | "one-at-a-time";
+    readonly transport: "sse" | "websocket" | "websocket-cached" | "auto";
+    readonly httpIdleTimeoutMs: number;
+    readonly cacheWarmingMode: "off" | "streaming" | "idle";
+    readonly thinkingLevel: OwnedUiSettingsThinkingLevel;
+    readonly availableThinkingLevels: readonly OwnedUiSettingsThinkingLevel[];
+    /** The stored global default the selector offers to restore; the session's level may differ. */
+    readonly defaultThinkingLevel: OwnedUiSettingsThinkingLevel;
+    /** Per-model thinking overrides keyed `provider/modelId`. */
+    readonly modelThinkingLevels: Readonly<Record<string, string>>;
+    /** `provider/modelId` of the persisted default model, or the engine's "not set" wording. */
+    readonly defaultModel: string;
+    readonly currentTheme: string;
+    readonly terminalTheme: "dark" | "light";
+    readonly availableThemes: readonly string[];
+    readonly hideThinkingBlock: boolean;
+    readonly mermaidRenderingMode: "off" | "final" | "streaming";
+    readonly showCacheMissNotices: boolean;
+    readonly collapseChangelog: boolean;
+    readonly enableInstallTelemetry: boolean;
+    readonly doubleEscapeAction: "fork" | "tree" | "none";
+    readonly treeFilterMode: "default" | "no-tools" | "user-only" | "labeled-only" | "all";
+    readonly showHardwareCursor: boolean;
+    readonly editorPaddingX: number;
+    readonly outputPad: 0 | 1;
+    readonly autocompleteMaxVisible: number;
+    readonly quietStartup: boolean | "header";
+    readonly defaultProjectTrust: "ask" | "always" | "never";
+    readonly clearOnShrink: boolean;
+    readonly showTerminalProgress: boolean;
+    readonly tuiMode: "regular" | "fullscreen";
+    readonly fullscreenExitOutput: "transcript" | "resume-hint";
+    readonly fullscreenScrollbar: "hidden" | "auto" | "always";
+    readonly fullscreenCopyOnSelect: boolean;
+    readonly fullscreenWheelScrollLines: number | "auto";
+    readonly warnings: {
+        readonly anthropicExtraUsage?: boolean;
+    };
+}
+export type OwnedUiJsonValue = null | boolean | number | string | readonly OwnedUiJsonValue[] | {
+    readonly [key: string]: OwnedUiJsonValue;
+};
+/** The layer that installs a setting's live effect. */
+export type OwnedUiSettingOwner = "agent" | "shell" | "terminal" | "startup" | "shutdown" | "installation";
+/** Engine settings whose live effect an owner may bind. */
+export type OwnedUiSessionSettingKey = "autoCompact" | "showImages" | "imageWidthCells" | "autoResizeImages" | "blockImages" | "enableSkillCommands" | "steeringMode" | "followUpMode" | "transport" | "httpIdleTimeoutMs" | "cacheWarmingMode" | "modelThinkingLevels" | "theme" | "hideThinkingBlock" | "mermaidRenderingMode" | "showCacheMissNotices" | "collapseChangelog" | "enableInstallTelemetry" | "quietStartup" | "defaultProjectTrust" | "doubleEscapeAction" | "treeFilterMode" | "showHardwareCursor" | "editorPaddingX" | "outputPad" | "autocompleteMaxVisible" | "clearOnShrink" | "showTerminalProgress" | "tuiMode" | "fullscreenExitOutput" | "fullscreenScrollbar" | "fullscreenCopyOnSelect" | "fullscreenWheelScrollLines" | "warnings";
+export interface OwnedUiSettingEffectHandler {
+    /** Install one value in the active owner. Handlers must be idempotent and reversible. */
+    apply(value: OwnedUiJsonValue): void | Promise<void>;
+}
+export type OwnedUiSettingOwnerHandlers = Partial<Record<OwnedUiSessionSettingKey, OwnedUiSettingEffectHandler>>;
+/** How the backend settled one owned UI command. */
+export interface OwnedUiCommandResult {
+    readonly outcome: OwnedUiCommandOutcome;
+    readonly diagnostic: string | null;
+}
+export interface OwnedUiResourceSummary {
+    readonly kind: "skill" | "prompt-template" | "agent-context" | "system-prompt" | "theme";
+    readonly id: string;
+    readonly label: string;
+    readonly sourcePath: string | null;
+    readonly diagnostic: string | null;
+}
+export interface OwnedUiExtensionSourceSummary {
+    readonly source: string;
+    readonly scope: "user" | "project" | "temporary";
+    readonly origin: "package" | "top-level";
+    readonly baseDir: string | null;
+}
+export interface OwnedUiExtensionResourceSummary {
+    readonly kind: "extension";
+    readonly id: string;
+    readonly sourcePath: string | null;
+    readonly resolvedPath: string | null;
+    readonly sourceInfo: OwnedUiExtensionSourceSummary | null;
+    readonly loaded: boolean;
+    readonly hidden: boolean;
+    readonly diagnostic: string | null;
+}
+/** Whether the owned extension UI bridge is bound to the current session, and the contract it offers. */
+export interface OwnedUiVisualExtensionSupport {
+    readonly available: boolean;
+    readonly contractComplete: true;
+    readonly contractVersion: typeof OWNED_UI_EXTENSION_CONTRACT_VERSION;
+    readonly binding: "bound" | "unbound";
+    readonly uiCallbacks: typeof OWNED_UI_EXTENSION_UI_CALLBACKS;
+    readonly uiProperties: typeof OWNED_UI_EXTENSION_UI_PROPERTIES;
+    readonly renderCallbacks: typeof OWNED_UI_EXTENSION_RENDER_CALLBACKS;
+    readonly diagnostic: string;
+}
+/** A newer release found by the startup check. */
+export interface OwnedUiReleaseUpdate {
+    readonly version: string;
+    readonly command: string;
+    readonly changelogUrl: string | null;
+}

package/dist/contracts/owned-ui/session-workflows.js

@@ -0,0 +1,30 @@
+/** Every workflow command the session engine advertises, in its own catalog order. */
+export const OWNED_UI_WORKFLOW_COMMAND_NAMES = [
+    "settings",
+    "model",
+    "tree",
+    "thinking",
+    "scoped-models",
+    "export",
+    "import",
+    "share",
+    "copy",
+    "name",
+    "session",
+    "changelog",
+    "hotkeys",
+    "fork",
+    "clone",
+    "trust",
+    "login",
+    "logout",
+    "new",
+    "compact",
+    "resume",
+    "reload",
+    "quit",
+];
+/** Routes the engine answers but never advertises. */
+export const OWNED_UI_HIDDEN_COMMAND_NAMES = ["debug", "arminsayshi", "dementedelves"];
+/** The one bare-A1 model command; it replaces the `model` and `scoped-models` routes there. */
+export const OWNED_UI_MODELS_COMMAND_NAME = "models";

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

@@ -1,6 +1,6 @@
 import { DIALOG_BACK_SHORTCUT_HINT, DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
-import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, numericValues, RAIL_COLUMNS, renderDialogPanel, renderSteppedDialogPanel, renderEmptyState, renderGroupHeader, renderInputRow, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, isThumbRow, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
-import { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
+import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, blockJumpTarget, numericValues, RAIL_COLUMNS, renderDialogPanel, renderSteppedDialogPanel, renderEmptyState, renderGroupHeader, renderInputRow, renderListRow, renderNote, renderShortcutHintsWithClose, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, truncateToWidth, valueColumnFor, valueMenuFrame, blockRowSpan, displayWidth, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, layoutList, moveSelection, rowKey, scrollForSelection, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, ScrollbarRails, scrollbarWheelRows, selectableIndexes, } from "../../ui/components/index.js";
+import { SETTINGS_APP_ID } from "./settings-route.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
 const SCOPE = SETTINGS_APP_ID;
 const SETTINGS_TOP_RULE_ROWS = 1;
@@ -265,8 +265,10 @@ export class SettingsApp {
                 const row = rows[selected];
                 if (row?.kind === "element" && row.value.structured)
                     this.#openStructured(row.value);
-                else
+                else if (row?.kind === "element" && typeof this.#shownValue(row.value) === "number")
                     this.#cycle(rows, selected, 1);
+                else
+                    this.#openMenu(rows, selected, true);
                 return { consumed: true };
             }
             case "move-up":
@@ -334,11 +336,11 @@ export class SettingsApp {
                 return { consumed: true, render: false };
             if (overRow === null) {
                 // Invariant: a press anywhere else dismisses the menu rather than acting through it.
-                this.#menu = null;
+                this.#closeMenu(menu);
                 return { consumed: true };
             }
             const value = menu.choices[overRow];
-            this.#menu = null;
+            this.#closeMenu(menu);
             if (value !== undefined)
                 this.#apply(menu.entry, value);
             return { consumed: true };
@@ -442,7 +444,7 @@ export class SettingsApp {
             clearTimeout(this.#activityTimer);
         this.#activityTimer = undefined;
     }
-    #openMenu(rows, selected) {
+    #openMenu(rows, selected, selectCurrent = false) {
         const row = rows[selected];
         if (row === undefined || row.kind !== "element")
             return;
@@ -461,9 +463,30 @@ export class SettingsApp {
             return;
         }
         const current = shown === null ? 0 : Math.max(0, entry.choices.indexOf(shown));
-        // Invariant: the opening press targeted the setting value, not an option. Keep the
-        // effective value as the keyboard origin without painting it as pointer-picked.
-        this.#menu = { entry, current, anchorKey: `${entry.backend}:${entry.id}`, choices: entry.choices, index: -1 };
+        const anchorKey = `${entry.backend}:${entry.id}`;
+        // Compatibility: pointer opening already brightens the source value. Enter borrows that
+        // same value-region state for the life of its menu rather than inventing a keyboard color.
+        if (selectCurrent) {
+            this.#hoverKey = anchorKey;
+            this.#hoverRegion = "value";
+        }
+        // Invariant: pointer opening stays inactive because it targeted the setting value, while
+        // Enter explicitly starts keyboard choice navigation at the value already in effect.
+        this.#menu = {
+            entry,
+            current,
+            anchorKey,
+            choices: entry.choices,
+            keyboardOpened: selectCurrent,
+            index: selectCurrent ? current : -1,
+        };
+    }
+    #closeMenu(menu) {
+        this.#menu = null;
+        if (!menu.keyboardOpened || this.#hoverKey !== menu.anchorKey)
+            return;
+        this.#hoverKey = null;
+        this.#hoverRegion = "label";
     }
     // Rationale: a structured setting opens as its own flag list rather than a value menu.
     #openStructured(entry) {
@@ -640,12 +663,12 @@ export class SettingsApp {
             return { consumed: false };
         const key = KEYS[data] ?? data;
         if (SETTINGS_SHORTCUTS.resolve(key, SCOPE) === "undo") {
-            this.#menu = null;
+            this.#closeMenu(menu);
             this.#undo();
             return { consumed: true };
         }
         if (key === "escape") {
-            this.#menu = null;
+            this.#closeMenu(menu);
             return { consumed: true };
         }
         if (key === "up" || key === "down") {
@@ -656,7 +679,7 @@ export class SettingsApp {
         }
         else if (key === "enter") {
             const value = menu.choices[menu.index];
-            this.#menu = null;
+            this.#closeMenu(menu);
             if (value !== undefined)
                 this.#apply(menu.entry, value);
         }
@@ -1084,9 +1107,6 @@ function changeFailure(outcome) {
 function labelOf(entry) {
     return entry.label ?? humanizeLabel(entry.id);
 }
-function isStepper(entry, shown = entry.value) {
-    return typeof shown === "number" && entry.editable;
-}
 /** Where a setting's number may go: what the engine states, or what it offers. */
 function rangeOf(entry) {
     return { minimum: entry.minimum, maximum: entry.maximum, values: numericValues(entry.choices) };

package/dist/foundation/release/bootstrap.js

@@ -2,7 +2,6 @@ import { spawn } from "node:child_process";
 import { restoreAfterOwnedExit } from "../terminal-cleanup/index.js";
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { connect } from "node:net";
-import { platform } from "node:os";
 import { resolve } from "node:path";
 import { selectCohortLaunch } from "./cohort-selection.js";
 import { selectOrdinaryLaunchReleaseId } from "./ordinary-launch-selection.js";
@@ -16,7 +15,7 @@ import { selectUpdateLaunchRelease } from "./update-launch.js";
 import { consumeMaterializationProof, materializeRelease, readCertifiedReleaseManifest, readMaterializedRelease, resolveReleaseEntryPoint, verifyMaterializedRelease } from "./release-store.js";
 import { scheduleReleaseCleanup } from "./release-gc.js";
 import { createRestartSeal, readRestartCertifiedRelease, releaseCertificationDocument } from "./restart-certification.js";
-import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
+import { PRODUCT_TEXT } from "../../product-identity.js";
 import { markStartupPhase } from "../startup/index.js";
 import { launchContractTarget, readLaunchContext, withLaunchContext } from "../launch-context/index.js";
 const RELEASE_RESELECTION_MESSAGE = "a1-release-reselection";

package/dist/foundation/release/release-gc.js

@@ -3,7 +3,7 @@ import { spawn } from "node:child_process";
 import { lstat, mkdir, open, readFile, readdir, realpath, rename, rm, stat } from "node:fs/promises";
 import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-import { CohortStateStore, planProtectedReleases, } from "./cohort-state.js";
+import { CohortStateStore, } from "./cohort-state.js";
 import { liveReleaseIds } from "./endpoints.js";
 import { resolveProductPaths } from "../lifecycle/index.js";
 import { RELEASE_MANIFEST_FILENAME } from "./release-store.js";

package/dist/foundation/release/update.js

@@ -790,10 +790,6 @@ async function canonicalImmutableRoot(dataDir, releaseRoot) {
 function samePath(left, right) {
     return process.platform === "win32" ? resolve(left).toLowerCase() === resolve(right).toLowerCase() : resolve(left) === resolve(right);
 }
-function isContainedBy(parent, child) {
-    const pathFromParent = relative(parent, child);
-    return pathFromParent.length > 0 && pathFromParent !== ".." && !pathFromParent.startsWith(`..${sep}`) && !isAbsolute(pathFromParent);
-}
 function unsuccessfulCode(code) { return code === null || code === 0 ? 1 : code; }
 function formatExitCode(code) { return code === null ? "unknown" : String(code); }
 function errorMessage(error) { return error instanceof Error ? error.message : String(error); }

package/dist/foundation/storage/control-store.js

@@ -308,18 +308,6 @@ export class ControlStore {
     close() {
         this.database.close();
     }
-    #transaction(operation) {
-        this.database.exec("BEGIN IMMEDIATE");
-        try {
-            const result = operation();
-            this.database.exec("COMMIT");
-            return result;
-        }
-        catch (error) {
-            this.database.exec("ROLLBACK");
-            throw error;
-        }
-    }
 }
 function launchInstanceFromRow(row) {
     const instance = {

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

@@ -39,26 +39,10 @@ function requireBlock(block, kind) {
 function blockPayload(block) {
     return isRecord(block.payload) ? block.payload : {};
 }
-function blockProvider(block) {
-    return stringPayload(blockPayload(block), "provider") ?? "openai";
-}
-function blockModel(block) {
-    return stringPayload(blockPayload(block), "model") ?? "gpt-5";
-}
 function stringPayload(payload, key) {
     const value = payload[key];
     return typeof value === "string" && value.length > 0 ? value : undefined;
 }
-function emptyUsage() {
-    return {
-        input: 0,
-        output: 0,
-        cacheRead: 0,
-        cacheWrite: 0,
-        totalTokens: 0,
-        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
-    };
-}
 function isRecord(value) {
     return typeof value === "object" && value !== null;
 }

package/dist/integrations/pi/components/index.d.ts

@@ -3,11 +3,11 @@ export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-edit
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
 export type { PiComponentConformanceReport, PiComponentConformanceResult } from "./conformance.js";
 export { createPiShellOperationLoader, createPiShellShareOperationDialog, type PiShellOperationLoaderPort, } from "./share-operation-dialog.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, createPiKeybindingsHost, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export type { PiShellHotkeySection } from "./shell-hotkey-sections.js";
-export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";
-export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiAccentColor, currentPiThemeName, derivePiAccentProjection, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, getPiSelectListTheme, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, setPiAccentColor, setPiPackageBorderProjectionEnabled, stopPiThemeWatcher, } from "./theme.js";
+export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiKeybindingsHost, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";
+export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiAccentColor, currentPiThemeName, derivePiAccentProjection, derivePiCanvasBackground, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, getPiSelectListTheme, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piCanvasBackgroundAnsi, piTheme, resolvePiThemeSetting, setPiAccentColor, setPiPackageBorderProjectionEnabled, stopPiThemeWatcher, } from "./theme.js";
 export type { PiAccentProjection, PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
 export type { PiThemeRuntimePort, PiThemeSettingsPort } from "./upstream/theme/theme-controller.js";