@timurproko/a1 0.2.5-dev.683 → 0.2.5-dev.704

package/dist/app/session-shell/prompt-suggestion-controller.d.ts

@@ -31,6 +31,8 @@ export declare class ContextualPromptSuggestionController {
     invalidate(): void;
     /** Retires only a generating request; a prepared or available suggestion survives the draft edit. */
     abortPending(): void;
+    /** Reasserts retained ghost text after an editor mutation makes the prompt eligible again. */
+    restoreAvailable(): void;
     dispose(): void;
 }
 export declare function samePromptSuggestionIdentity(left: OwnedUiPromptSuggestionIdentity, right: OwnedUiPromptSuggestionIdentity): boolean;

package/dist/app/session-shell/prompt-suggestion-controller.js

@@ -100,6 +100,16 @@ export class ContextualPromptSuggestionController {
         this.#finish(request, "cancelled");
         request.abort.abort();
     }
+    /** Reasserts retained ghost text after an editor mutation makes the prompt eligible again. */
+    restoreAvailable() {
+        if (this.#disposed || !this.#enabled || this.#state.status !== "available")
+            return;
+        const reason = this.options.surface.presentationBlockReason?.(this.#state.identity)
+            ?? (this.options.surface.canPresent(this.#state.identity) ? null : "presentation-unavailable");
+        if (reason !== null || !this.options.surface.present(this.#state.text))
+            return;
+        this.options.surface.requestRender();
+    }
     dispose() {
         this.#disposed = true;
         this.invalidate();

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

@@ -9,7 +9,7 @@ import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES } from
 import { createPiExtensionUiBridge } from "../../integrations/pi/components/shell-extension-ui.js";
 import { createPiShellEditor } from "../../integrations/pi/components/shell-editor-autocomplete.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
-import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 import { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
 import { createPiShellTranscriptComponent, isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, PINNED_PI_LAYOUT, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
@@ -333,6 +333,10 @@ export class OwnedUiSessionShellRoot {
         }
         const promptAccepted = this.#view.lifecycle !== "busy" && view.lifecycle === "busy";
         this.#view = view;
+        // Invariant: the idle new-session confirmation yields to the first truthful live status;
+        // ordinary dock notices deliberately remain visible below Working during a run.
+        if (promptAccepted && this.#dockNotice?.kind === "new-session")
+            this.#dockNotice = undefined;
         if (promptAccepted && this.#imageSubmissionsSending > 0) {
             this.#imageSubmissionsSending = 0;
             this.#syncWorkingOverride();
@@ -657,7 +661,10 @@ export class OwnedUiSessionShellRoot {
             // Compatibility: Pi pads its status text by one cell regardless of the output pad setting.
             return ["", ...renderPiShellStatusText(notice.message, width, PINNED_PI_LAYOUT.outputPad)];
         }
-        return renderPiShellCommandMessage({ kind: notice.kind, message: notice.message }, width, this.#outputPad);
+        return renderPiShellCommandMessage({
+            kind: notice.kind === "new-session" ? "accent" : notice.kind,
+            message: notice.message,
+        }, width, this.#outputPad);
     }
     dismissNotice() {
         if (this.#dockNotice === undefined)
@@ -960,6 +967,12 @@ export class OwnedUiSessionShellRoot {
         }
         if (result.outcome === "completed" && (result.command === "quit" || result.command === "compact"))
             return;
+        if (result.outcome === "completed" && result.command === "new" && this.#customViewport) {
+            // Rationale: bare A1 keeps the replacement session visually empty while preserving Pi's accent notice shape.
+            this.#dockNotice = { kind: "new-session", message: result.message };
+            this.#invalidateChrome();
+            return;
+        }
         if (result.outcome === "completed" && (result.command === "new" || result.command === "name" || result.command === "debug")) {
             this.#lastWorkflowStatusId = undefined;
             const presentation = { kind: result.command, message: result.message, ...(result.detail === undefined ? {} : { detail: result.detail }) };

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

@@ -14,7 +14,7 @@ import { createPiExtensionUiBridge } from "../../integrations/pi/components/shel
 import { createPiShellEditor } from "../../integrations/pi/components/shell-editor-autocomplete.js";
 import { SKILLS_COMMAND_NAME, findSkillByArgument, rewriteSkillsTunnelSubmission, skillPrompt, skillsFromCommands, } from "../../integrations/pi/components/skills-command.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
-import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellSkillsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellSkillsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellPackageUpdateNotice, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
 import { createPiShellTranscriptComponent, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
@@ -188,6 +188,11 @@ export class OwnedUiSessionShell {
             onEditorChange: text => {
                 this.#editorRevision++;
                 promptSuggestionController?.abortPending();
+                if (text.length === 0) {
+                    // Concurrency: the editor synchronizes deletion-owned autocomplete after onChange.
+                    // Reassert retained ghost text in the microtask before Pi emits its scheduled frame.
+                    queueMicrotask(() => promptSuggestionController?.restoreAvailable());
+                }
                 this.root.reconcilePromptImageLimitNotice(text);
             },
             onPromptSuggestionAccepted: () => promptSuggestionController?.accept(),
@@ -280,7 +285,7 @@ export class OwnedUiSessionShell {
             }),
             ...(terminal === undefined ? {} : { terminal: terminal }),
             hardwareCursor: this.backend.view().terminal.hardwareCursor,
-            wheelScrollLines: initialPiSettings.fullscreenWheelScrollLines,
+            ...(this.#customViewport ? {} : { wheelScrollLines: initialPiSettings.fullscreenWheelScrollLines }),
         };
         runtime = new PiTuiRuntimeAdapter(runtimeOptions);
         this.runtime = runtime;
@@ -358,8 +363,15 @@ export class OwnedUiSessionShell {
             ? this.runtime.addPreInputListener(data => {
                 if (inputPresentation?.coordination === false)
                     this.#streamPresentation.noteImmediatePresentation();
-                // Compatibility: route boundary keys before Pi.
+                // Compatibility: route modal paging and boundary keys before Pi's fullscreen handlers.
                 const isDefault = this.root.usesDefaultInputSurface();
+                if (!this.runtime.hasOverlay() && !isDefault
+                    && (this.root.editor.matchesTerminalKey(data, "pageUp")
+                        || this.root.editor.matchesTerminalKey(data, "pageDown"))) {
+                    this.root.handleInput(data);
+                    this.runtime.requestRender();
+                    return { consume: true };
+                }
                 if (!this.runtime.hasOverlay() && (this.root.editor.matchesTerminalKey(data, "home")
                     || this.root.editor.matchesTerminalKey(data, "end")
                     || !isDefault && (this.root.editor.matchesTerminalKey(data, "ctrl+home")
@@ -458,13 +470,14 @@ export class OwnedUiSessionShell {
                         if (typeof value !== "boolean")
                             throw new TypeError("Fullscreen copy-on-select setting is invalid");
                         this.root.setFullscreenCopyOnSelect(value);
-                    } } } : {}),
-            fullscreenWheelScrollLines: { apply: value => {
-                    if (value !== "auto" && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1 || value > 100)) {
-                        throw new TypeError("Fullscreen wheel-scroll distance is invalid");
-                    }
-                    this.runtime.setWheelScrollLines(value);
-                } },
+                    } } } : {
+                fullscreenWheelScrollLines: { apply: (value) => {
+                        if (value !== "auto" && (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1 || value > 100)) {
+                            throw new TypeError("Fullscreen wheel-scroll distance is invalid");
+                        }
+                        this.runtime.setWheelScrollLines(value);
+                    } },
+            }),
         });
         if (this.#customViewport && promptHistory !== undefined) {
             this.#promptHistoryImageSidecar = promptHistory.imageSidecar;
@@ -1065,12 +1078,14 @@ export class OwnedUiSessionShell {
             },
             onCancel: close,
             onSelect: entryId => {
-                close();
                 if (entryId === context.currentLeafId) {
+                    close();
                     this.root.appendWorkflowStatus("Already at this point");
                     this.runtime.requestRender();
                     return;
                 }
+                if (context.skipSummaryPrompt)
+                    close();
                 void this.#completeTreeSelection(entryId, context.skipSummaryPrompt);
             },
         });
@@ -1206,6 +1221,19 @@ export class OwnedUiSessionShell {
     async runWorkflow(request) {
         if (request.command === "quit")
             return this.shutdown();
+        if (this.#customViewport && request.command === "name" && request.argument.trim().length === 0) {
+            void this.#extensionBridge.input("Session Name", "Enter name").then(value => {
+                if (this.#disposed || value === undefined || value.trim().length === 0)
+                    return;
+                return this.runWorkflow({ ...request, argument: value });
+            }).catch(error => {
+                if (this.#disposed)
+                    return;
+                this.root.appendWorkflowResult({ command: "name", outcome: "failed", message: error instanceof Error ? error.message : String(error) });
+                this.runtime.requestRender();
+            });
+            return { outcome: "completed", diagnostic: null };
+        }
         const copyGeneration = request.command === "copy" ? this.backend.sessionBindingGeneration : undefined;
         if (request.command === "login" && request.selection !== undefined) {
             const setup = this.backend.pinnedAmbientAuthentication(request.selection);
@@ -1281,13 +1309,15 @@ export class OwnedUiSessionShell {
             }
             this.root.resetExtensionUi();
         }
-        const shareSurface = request.command === "share"
-            ? createPiShellOperationLoader({
+        const shareDialog = request.command === "share"
+            ? await import("./share-operation.js")
+            : undefined;
+        const shareSurface = shareDialog === undefined ? undefined
+            : (this.#customViewport ? shareDialog.createPiShellShareOperationDialog : shareDialog.createPiShellOperationLoader)({
                 getColumns: () => this.runtime.viewport().columns,
                 getRows: () => this.runtime.viewport().rows,
                 requestRender: () => this.runtime.requestRender(),
-            }, "Creating gist...")
-            : undefined;
+            }, "Creating gist…");
         const operationSurface = shareSurface ?? (request.command === "reload" ? createPiShellReloadBox() : undefined);
         const now = this.#reloadPresentation?.now ?? Date.now;
         const shownAt = now();
@@ -1343,7 +1373,17 @@ export class OwnedUiSessionShell {
             this.root.editor.reloadKeybindings();
             this.#installAutocompleteCommands();
         }
-        this.root.appendWorkflowResult(result);
+        if (request.command === "tree" && result.outcome === "completed") {
+            if (result.detail && !this.root.editor.getText().trim())
+                this.root.editor.setText(result.detail);
+            this.root.resumeViewportFollowing();
+        }
+        if (shareDialog !== undefined && this.#customViewport && result.outcome === "completed" && result.detail !== undefined) {
+            this.root.appendWorkflowStatus(shareDialog.renderPiShellShareResult(result.message, result.detail));
+        }
+        else {
+            this.root.appendWorkflowResult(result);
+        }
         this.runtime.requestRender();
         return workflowAdapterResult(result);
     }
@@ -1782,6 +1822,19 @@ export class OwnedUiSessionShell {
         const removeInterruptWatch = this.runtime.addInputListener(data => {
             if (!data.includes(INTERRUPT))
                 return undefined;
+            // Protocol: route hosts decide whether one interrupt closes their app. Raw-input forwarding
+            // is required because Pi handles Ctrl+C before the fullscreen overlay receives normal input.
+            const consumedBySurface = surface.handleInput(INTERRUPT);
+            if (surface.isClosed()) {
+                armedAt = 0;
+                closeSurface();
+                return { consume: true };
+            }
+            if (consumedBySurface) {
+                armedAt = 0;
+                this.runtime.requestRender();
+                return { consume: true };
+            }
             const now = Date.now();
             if (armedAt !== 0 && now - armedAt <= INTERRUPT_CHORD_MS) {
                 armedAt = 0;
@@ -1970,7 +2023,7 @@ export class OwnedUiSessionShell {
         }
         return this.#submitSkillPrompt(skillPrompt(skill.name, separator < 0 ? "" : trimmed.slice(separator + 1)), text);
     }
-    // Rationale: the engine expands "/skill:<name> args" itself; history keeps the form the user typed so recall restores the invocation.
+    // Rationale: engine expands skill arguments; history retains typed input for recall.
     #submitSkillPrompt(prompt, typed) {
         this.#rememberInput(typed, "slash");
         this.root.resumeViewportFollowing();
@@ -1981,29 +2034,33 @@ export class OwnedUiSessionShell {
             text: prompt,
         });
     }
+    #treeSummary() {
+        return new Promise(resolve => {
+            this.root.setInputSurface(createPiShellExtensionSelector("Summarize Branch?", ["No summary", "Summarize", "Summarize with custom prompt"], resolve, () => resolve(undefined)), true, "opaque");
+            this.runtime.requestRender();
+        });
+    }
     async #completeTreeSelection(entryId, skipSummaryPrompt) {
         let summarize = false;
         let customInstructions;
         if (!skipSummaryPrompt) {
             while (true) {
-                const choice = await this.#extensionBridge.context.select("Summarize branch?", [
-                    "No summary",
-                    "Summarize",
-                    "Summarize with custom prompt",
-                ]);
+                const choice = await this.#treeSummary();
                 if (choice === undefined) {
                     await this.showTreeSelector(entryId);
                     return;
                 }
                 summarize = choice !== "No summary";
                 if (choice === "Summarize with custom prompt") {
-                    customInstructions = await this.#extensionBridge.context.editor("Custom summarization instructions", "");
+                    customInstructions = await this.#extensionBridge.input("Custom Summarization Instructions", "", { retainSurfaceOnSettle: true });
                     if (customInstructions === undefined)
                         continue;
                 }
                 break;
             }
         }
+        this.root.setInputSurface(null);
+        this.runtime.requestRender();
         const result = await this.runWorkflow({
             command: "tree",
             argument: "",

package/dist/app/session-shell/share-operation.d.ts

@@ -0,0 +1,3 @@
+import { createPiShellOperationLoader, createPiShellShareOperationDialog } from "../../integrations/pi/components/index.js";
+export { createPiShellOperationLoader, createPiShellShareOperationDialog };
+export declare function renderPiShellShareResult(message: string, gistUrl: string): string;

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

@@ -0,0 +1,11 @@
+import { createPiShellOperationLoader, createPiShellShareOperationDialog, piShellHyperlink, piTheme, } from "../../integrations/pi/components/index.js";
+import { nativeHyperlinkStyle } from "../../ui/components/index.js";
+export { createPiShellOperationLoader, createPiShellShareOperationDialog };
+export function renderPiShellShareResult(message, gistUrl) {
+    const theme = piTheme();
+    const match = /^Share URL: (\S+)$/u.exec(message);
+    const linked = match === null
+        ? theme.fg("dim", message)
+        : `${theme.fg("dim", "Share URL: ")}${piShellHyperlink(match[1])}`;
+    return nativeHyperlinkStyle(`${linked}\n${theme.fg("dim", "Gist: ")}${piShellHyperlink(gistUrl)}`, text => theme.fg("mdLink", text));
+}

package/dist/composition/owned-ui.js

@@ -44,6 +44,8 @@ export async function composeOwnedUi(options = {}) {
             configDir: resolveProductPaths().configDir,
             profileId: options.profileId,
             agentProvider: () => adapter.settingsPort(),
+            hiddenAgentSettingIds: ["fullscreenWheelScrollLines"],
+            agentSettingLabelOverrides: { fullscreenCopyOnSelect: "Copy on select" },
         });
     let releaseNotes = null;
     let releaseNotesFailure;

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

@@ -131,7 +131,7 @@ function pinnedTheme() {
         bold: (text) => piTheme().bold(text),
         plain: (text) => text,
         disabled: (text) => faint(piTheme().fg("dim", text)),
-        highlight: (text) => `\u001b[48;2;82;82;82m\u001b[97m${text}\u001b[39m\u001b[49m`,
+        highlight: (text) => piTheme().bg("selectedBg", text),
         panel: (text) => `\u001b[48;2;55;55;55m${text}\u001b[49m`,
     };
 }

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

@@ -4,6 +4,16 @@ export interface SemanticShortcutHint {
     readonly action: string;
     readonly actionFirst?: boolean;
 }
+/** Canonical dismissal guidance for every A1-rendered dialog surface. */
+export declare const DIALOG_CLOSE_SHORTCUT_HINT: Readonly<{
+    key: string;
+    action: string;
+}>;
+/** Canonical return guidance for a nested step within a dialog surface. */
+export declare const DIALOG_BACK_SHORTCUT_HINT: Readonly<{
+    key: string;
+    action: string;
+}>;
 export interface ShortcutHintRoles {
     key(label: string): string;
     action(name: string): string;
@@ -11,7 +21,7 @@ export interface ShortcutHintRoles {
 /** Applies the common display casing to each named key and letter in a shortcut label. */
 export declare function displayShortcutKeyLabel(label: string): string;
 /** Renders the canonical semantic shortcut row independently of either presentation framework. */
-export declare function renderSemanticShortcutHints(entries: readonly SemanticShortcutHint[], roles: ShortcutHintRoles, indent?: number): string;
+export declare function renderSemanticShortcutHints(entries: readonly SemanticShortcutHint[], roles: ShortcutHintRoles, indent?: number, separator?: string): string;
 export interface PresentationComponentPort {
     render(width: number): readonly string[];
     invalidate(): void;

package/dist/contracts/presentation/index.js

@@ -1,3 +1,7 @@
+/** Canonical dismissal guidance for every A1-rendered dialog surface. */
+export const DIALOG_CLOSE_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "close" });
+/** Canonical return guidance for a nested step within a dialog surface. */
+export const DIALOG_BACK_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "back" });
 const SHORTCUT_KEY_NAMES = Object.freeze({
     alt: "Alt", backspace: "Backspace", cmd: "Cmd", ctrl: "Ctrl", delete: "Delete", down: "Down", end: "End",
     enter: "Enter", esc: "Esc", escape: "Escape", home: "Home", insert: "Insert", left: "Left", meta: "Meta",
@@ -16,7 +20,7 @@ export function displayShortcutKeyLabel(label) {
     }).join("+")).join("/");
 }
 /** Renders the canonical semantic shortcut row independently of either presentation framework. */
-export function renderSemanticShortcutHints(entries, roles, indent = 0) {
+export function renderSemanticShortcutHints(entries, roles, indent = 0, separator = "  ") {
     const rendered = entries.flatMap(entry => {
         if (entry.key === "" || (entry.key !== undefined && entry.key.trim().length === 0))
             return [];
@@ -26,7 +30,7 @@ export function renderSemanticShortcutHints(entries, roles, indent = 0) {
         const action = roles.action(entry.action);
         return [entry.actionFirst ? `${action} ${key}` : `${key} ${action}`];
     });
-    return `${" ".repeat(Math.max(0, indent))}${rendered.join("  ")}`;
+    return `${" ".repeat(Math.max(0, indent))}${rendered.join(separator)}`;
 }
 export function assertPresentationComponent(component) {
     requiredFunctions(component, ["render", "invalidate"], "presentation component");

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

@@ -1,7 +1,8 @@
-const ACCENT = "\u001b[38;2;138;190;183m";
-const BORDER = "\u001b[38;2;95;135;255m";
-const MUTED = "\u001b[38;2;128;128;128m";
-const DIM = "\u001b[38;2;102;102;102m";
+import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel } from "../../contracts/presentation/index.js";
+const ACCENT = "\u001b[38;2;167;152;215m";
+const BORDER = "\u001b[38;2;97;133;204m";
+const MUTED = "\u001b[38;2;157;165;169m";
+const DIM = "\u001b[38;2;126;136;142m";
 const RESET_FG = "\u001b[39m";
 const BOLD = "\u001b[1m";
 const RESET_BOLD = "\u001b[22m";
@@ -13,7 +14,8 @@ export function renderProjectTrustDialog(cwd, options, selected, terminalWidth,
     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));
-    const hint = ` ${DIM}↑/↓${MUTED} to navigate  ${DIM}Enter${MUTED} to select  ${DIM}Esc${MUTED} to exit${RESET_FG}`;
+    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}`);
     const preferred = [rule, title, path, "", ...explanation, "", ...choices, "", hint, rule];
     if (preferred.length <= terminalRows)

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

@@ -29,8 +29,8 @@ export interface ReferenceScreenOptions {
  * Presents one read-only document full screen between two accent rules: the bold
  * title leads the scrolled rows, the shared scrollbar rail runs beside them, and
  * the hint line closes the frame. Rows come from a provider per content width and
- * are cached until the width changes; the screen closes on Escape and leaves the
- * interrupt chord to its host.
+ * are cached until the width changes; Escape closes locally, while an opted-in
+ * host closes on Ctrl+C before dispatching it into the screen.
  */
 export declare class ReferenceScreenApp implements UiApp {
     #private;

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

@@ -1,4 +1,5 @@
-import { GLOBAL_SCOPE, PLAIN_THEME, RAIL_COLUMNS, ShortcutRegistry, ScrollbarRails, assertNoShortcutConflicts, displayWidth, layoutList, padToWidth, renderGroupHeader, renderShortcutHints, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarWheelRows, truncateToWidth, withScrollbarRail, } from "../../ui/components/index.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT } from "../../contracts/presentation/index.js";
+import { GLOBAL_SCOPE, PLAIN_THEME, RAIL_COLUMNS, ShortcutRegistry, ScrollbarRails, assertNoShortcutConflicts, displayWidth, layoutList, padToWidth, renderGroupHeader, renderShortcutHintsWithClose, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarWheelRows, truncateToWidth, withScrollbarRail, } from "../../ui/components/index.js";
 const SCOPE = "reference-screen";
 /** Rows above the document: the top rule. */
 const HEADER_ROWS = 1;
@@ -9,14 +10,17 @@ const SCROLL_LINGER_MS = 900;
 const SCROLL_LINGER_REPAINT_MS = 925;
 const LOADING_NOTICE = "Loading…";
 export const REFERENCE_SCREEN_SHORTCUTS = new ShortcutRegistry();
-// Compatibility: Ctrl+C remains the A1 interrupt chord here rather than a close key.
-REFERENCE_SCREEN_SHORTCUTS.declare({ key: "escape", scope: GLOBAL_SCOPE, description: "Close", section: "Screen", hint: { keys: "esc", does: "close" } }, "close");
 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");
 REFERENCE_SCREEN_SHORTCUTS.declare({ key: "pageUp", scope: SCOPE, description: "Up a page", section: "Navigate" }, "page-up");
 REFERENCE_SCREEN_SHORTCUTS.declare({ key: "pageDown", scope: SCOPE, description: "Down a page", section: "Navigate" }, "page-down");
 REFERENCE_SCREEN_SHORTCUTS.declare({ key: "home", scope: SCOPE, description: "First row", section: "Navigate" }, "first");
 REFERENCE_SCREEN_SHORTCUTS.declare({ key: "end", scope: SCOPE, description: "Last row", section: "Navigate" }, "last");
+// Compatibility: Ctrl+C remains the A1 interrupt chord here rather than a visible close key.
+REFERENCE_SCREEN_SHORTCUTS.declare({
+    key: "escape", scope: GLOBAL_SCOPE, description: "Close", section: "Screen",
+    hint: { keys: DIALOG_CLOSE_SHORTCUT_HINT.key, does: DIALOG_CLOSE_SHORTCUT_HINT.action },
+}, "close");
 assertNoShortcutConflicts(REFERENCE_SCREEN_SHORTCUTS.assemble());
 const KEYS = {
     "\u001b[A": "up",
@@ -36,8 +40,8 @@ const KEYS = {
  * Presents one read-only document full screen between two accent rules: the bold
  * title leads the scrolled rows, the shared scrollbar rail runs beside them, and
  * the hint line closes the frame. Rows come from a provider per content width and
- * are cached until the width changes; the screen closes on Escape and leaves the
- * interrupt chord to its host.
+ * are cached until the width changes; Escape closes locally, while an opted-in
+ * host closes on Ctrl+C before dispatching it into the screen.
  */
 export class ReferenceScreenApp {
     id;
@@ -135,7 +139,7 @@ export class ReferenceScreenApp {
         const withRail = withScrollbarRail(body.slice(0, bodyHeight), geometry, contentWidth, theme, { presentation });
         const hint = this.#interruptArmed
             ? theme.fg("dim", " press ctrl+c again to exit a1")
-            : renderShortcutHints(REFERENCE_SCREEN_SHORTCUTS.hintEntries(SCOPE), theme, 1);
+            : renderShortcutHintsWithClose(REFERENCE_SCREEN_SHORTCUTS.hintEntries(SCOPE), theme, rect.width, 1);
         // 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.

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

@@ -2,7 +2,7 @@ import type { AppHostServices, UiApp } from "../../ui/apps/index.js";
 import { ShortcutRegistry, type PaneInputResult, type PaneMouseEvent, type PaneRect } from "../../ui/components/index.js";
 import type { OwnedSettingsManager } from "../../ui/settings/index.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
-type Action = "move-up" | "move-down" | "block-up" | "block-down" | "first" | "last" | "page-up" | "page-down" | "previous-value" | "next-value" | "activate" | "open-filter" | "close" | "part-previous" | "part-next" | "part-change";
+type Action = "move-up" | "move-down" | "block-up" | "block-down" | "first" | "last" | "page-up" | "page-down" | "previous-value" | "next-value" | "activate" | "open-filter" | "close" | "undo" | "part-previous" | "part-next" | "part-change";
 export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
 /**
  * The settings screen. Rows, sticky headers, scrolling, and the keymap come from