@timurproko/a1 0.1.8-dev.335 → 0.1.8-dev.368

package/dist/features/prompt-history/store.js

@@ -3,6 +3,7 @@ import { chmodSync, closeSync, lstatSync, mkdirSync, openSync, statSync } from "
 import { dirname } from "node:path";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
 import { assertPromptHistorySubmission, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_TEXT_BYTES } from "../../contracts/owned-ui/index.js";
+import { collectImageChipIdentifiers, PromptImageSidecar } from "./image-sidecar.js";
 export class HistoryStorageError extends Error {
     code;
     certainty;
@@ -17,11 +18,13 @@ export class PromptHistoryStore {
     path;
     profileId;
     #database;
-    constructor(path, profileId, limit) {
+    #sidecar;
+    constructor(path, profileId, limit, imagesDir) {
         this.path = path;
         this.profileId = profileId;
         if (!Number.isInteger(limit) || limit < 10 || limit > 100 || limit % 10 !== 0)
             throw new HistoryStorageError("schema");
+        this.#sidecar = imagesDir === undefined ? undefined : new PromptImageSidecar(imagesDir);
         mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
         if (lstatSync(dirname(path)).isSymbolicLink())
             throw new HistoryStorageError("unavailable");
@@ -67,6 +70,10 @@ export class PromptHistoryStore {
             this.#database.close();
             throw error;
         }
+        // Rationale: opportunistically reclaim any sidecar whose row was pruned in a prior process
+        // crash or by another concurrent opener. Bounded by the number of files on disk minus the
+        // surviving reference set; failures are swallowed to preserve honest history behavior.
+        this.#sweepOrphanedSidecars();
     }
     record(input) {
         assertPromptHistorySubmission(input);
@@ -133,11 +140,48 @@ export class PromptHistoryStore {
     #prune(limit) {
         const rows = this.#database.prepare("SELECT sequence,bytes FROM prompts ORDER BY sequence DESC").all();
         let bytes = 0;
+        const dropped = [];
         for (const [index, row] of rows.entries()) {
             bytes += Number(row.bytes);
             if (index >= limit || bytes > PROMPT_HISTORY_MAX_TEXT_BYTES)
-                this.#database.prepare("DELETE FROM prompts WHERE sequence=?").run(row.sequence);
+                dropped.push(row.sequence);
         }
+        if (dropped.length === 0)
+            return;
+        // Invariant: sidecar reap uses text still referenced by SURVIVING rows so a row still
+        // referencing an id shared with a pruned row keeps the file. Collect surviving ids before
+        // deleting so a concurrent snapshot cannot see a live row whose sidecar is already gone.
+        const droppedTexts = dropped.map(sequence => this.#database.prepare("SELECT text FROM prompts WHERE sequence=?").get(sequence)?.text).filter((value) => typeof value === "string");
+        for (const sequence of dropped)
+            this.#database.prepare("DELETE FROM prompts WHERE sequence=?").run(sequence);
+        if (this.#sidecar === undefined)
+            return;
+        const survivingIds = this.#collectReferencedIdentifiers();
+        for (const text of droppedTexts) {
+            for (const id of collectImageChipIdentifiers(text)) {
+                if (!survivingIds.has(id))
+                    this.#sidecar.unlink(id);
+            }
+        }
+    }
+    #collectReferencedIdentifiers() {
+        const identifiers = new Set();
+        const rows = this.#database.prepare("SELECT text FROM prompts").all();
+        for (const row of rows) {
+            if (typeof row.text !== "string")
+                continue;
+            for (const id of collectImageChipIdentifiers(row.text))
+                identifiers.add(id);
+        }
+        return identifiers;
+    }
+    #sweepOrphanedSidecars() {
+        if (this.#sidecar === undefined)
+            return;
+        try {
+            this.#sidecar.sweep(this.#collectReferencedIdentifiers());
+        }
+        catch { /* Rationale: sidecar sweep never blocks history readiness. */ }
     }
     #checkSize(maintain = false) {
         let size = 0;

package/dist/features/prompt-history/worker.js

@@ -6,7 +6,7 @@ if (port !== null) {
     let store;
     let chain = Promise.resolve();
     const options = workerData;
-    const open = retry(() => { store = new PromptHistoryStore(options.path, options.profileId, options.limit); });
+    const open = retry(() => { store = new PromptHistoryStore(options.path, options.profileId, options.limit, options.imagesDir); });
     void open.then(() => port.postMessage({ id: 0, ok: true }), error => port.postMessage({ id: 0, ok: false, code: classifyHistoryError(error) }));
     port.on("message", (request) => {
         chain = chain.then(async () => {

package/dist/features/prompt-suggestions/diagnostics.d.ts

@@ -0,0 +1,18 @@
+import { type SuggestionDiagnosticObserver, type SuggestionDiagnosticRecord } from "../../contracts/owned-ui/index.js";
+export interface SuggestionDiagnosticCaptureOptions {
+    readonly enabled?: boolean;
+    /** Explicit local destination, or an injected sink for deterministic I/O tests. */
+    readonly destination?: string;
+    readonly writeSnapshot?: (snapshot: string) => Promise<void>;
+}
+/** Bounded metadata snapshots; one in-flight write and one replaceable latest snapshot. */
+export declare class SuggestionDiagnosticCapture implements SuggestionDiagnosticObserver {
+    #private;
+    readonly options: SuggestionDiagnosticCaptureOptions;
+    constructor(options?: SuggestionDiagnosticCaptureOptions);
+    record(record: SuggestionDiagnosticRecord): void;
+    snapshot(): readonly SuggestionDiagnosticRecord[];
+    /** Explicit evidence boundary, never awaited by input or rendering. */
+    flush(): Promise<void>;
+    dispose(): void;
+}

package/dist/features/prompt-suggestions/diagnostics.js

@@ -0,0 +1,82 @@
+import { writeFile } from "node:fs/promises";
+import { SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS, } from "../../contracts/owned-ui/index.js";
+/** Bounded metadata snapshots; one in-flight write and one replaceable latest snapshot. */
+export class SuggestionDiagnosticCapture {
+    options;
+    #records = [];
+    #pending;
+    #writing;
+    #disposed = false;
+    #write;
+    constructor(options = {}) {
+        this.options = options;
+        this.#write = options.writeSnapshot ?? (options.destination === undefined ? undefined
+            : snapshot => writeFile(options.destination, snapshot, { encoding: "utf8", mode: 0o600 }));
+    }
+    record(record) {
+        if (!this.options.enabled || this.#disposed)
+            return;
+        const safe = sanitize(record);
+        if (safe === null)
+            return;
+        this.#records.push(safe);
+        if (this.#records.length > 128)
+            this.#records.shift();
+        let snapshot = this.#serialize();
+        while (Buffer.byteLength(snapshot, "utf8") > 65_536) {
+            this.#records.shift();
+            snapshot = this.#serialize();
+        }
+        if (this.#write) {
+            this.#pending = snapshot;
+            this.#pump();
+        }
+    }
+    snapshot() { return this.#records.map(record => ({ ...record })); }
+    /** Explicit evidence boundary, never awaited by input or rendering. */
+    async flush() {
+        while (this.#writing)
+            await this.#writing;
+    }
+    dispose() {
+        this.#disposed = true;
+        this.#records = [];
+        this.#pending = undefined;
+    }
+    #serialize() { return JSON.stringify({ schema: "prompt-suggestion-diagnostics-v1", records: this.#records }); }
+    #pump() {
+        if (this.#writing || this.#pending === undefined || !this.#write || this.#disposed)
+            return;
+        const snapshot = this.#pending;
+        this.#pending = undefined;
+        this.#writing = Promise.resolve().then(() => this.#write(snapshot)).catch(() => {
+            // Security: do not retain or display raw filesystem/provider errors.
+        }).finally(() => {
+            this.#writing = undefined;
+            this.#pump();
+        });
+    }
+}
+function sanitize(record) {
+    if (!SUGGESTION_DIAGNOSTIC_EVENTS.includes(record.event))
+        return null;
+    const reasoning = ["ordinary", "off", "minimal", "low", "medium", "high", "xhigh", "max", "unavailable"].includes(record.reasoning)
+        ? record.reasoning : "unavailable";
+    const reason = record.reason !== undefined && SUGGESTION_DECISION_REASONS.includes(record.reason) ? record.reason : undefined;
+    // Security: explicit projection prevents arbitrary extra fields, including raw error payloads, from escaping.
+    return {
+        event: record.event, ...(reason === undefined ? {} : { reason }),
+        session: boundedNumber(record.session), run: boundedNumber(record.run), response: boundedNumber(record.response),
+        request: boundedNumber(record.request), provider: identifier(record.provider), model: identifier(record.model),
+        reasoning, elapsedMs: boundedNumber(record.elapsedMs),
+    };
+}
+function boundedNumber(value) {
+    return Number.isFinite(value) ? Math.min(Number.MAX_SAFE_INTEGER, Math.max(0, Math.floor(value))) : 0;
+}
+function identifier(value) {
+    // Security: identifiers are metadata, not display names or arbitrary JSON. Reject controls/path-shaped values.
+    if (typeof value !== "string" || /[\p{C}\\\s]/u.test(value) || value.includes(":") || value.startsWith("/"))
+        return "redacted";
+    return value.slice(0, 64);
+}

package/dist/features/prompt-suggestions/index.d.ts

@@ -0,0 +1 @@
+export * from "./diagnostics.js";

package/dist/features/prompt-suggestions/index.js

@@ -0,0 +1 @@
+export * from "./diagnostics.js";

package/dist/integrations/pi/components/owned-editor-ux.d.ts

@@ -59,6 +59,14 @@ export interface PromptSelectionUxOptions {
     readonly requestRender: () => void;
     readonly getRows: () => number;
     /** Presentation-only columns reserved before semantic editor text. */
-    readonly promptPrefixWidth?: number;
+    readonly promptGeometry?: (width: number, padding: number) => {
+        readonly prefixWidth: number;
+        readonly innerWidth: number;
+        readonly paddingX: number;
+        readonly contentWidth: number;
+        readonly layoutWidth: number;
+    };
 }
 export declare function createPromptSelectionInterceptor(editor: Editor, keybindings: KeybindingsManager, options: PromptSelectionUxOptions): OwnedEditorUxInterceptor;
+/** Shares the existing atomic-aware body layout with prompt/menu composition. */
+export declare function editorVisualLineCount(editor: Editor, width: number): number | undefined;

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -230,18 +230,17 @@ class PromptSelectionInterceptor {
     }
     #renderVisible(width, next) {
         const rows = next().map(row => row.replaceAll(ATOMIC_SPACE_SENTINEL, " "));
-        const maxPadding = Math.max(0, Math.floor((width - 1) / 2));
-        const padding = Math.min(this.editor.getPaddingX(), maxPadding);
-        const prefixWidth = this.options.promptPrefixWidth ?? 0;
-        const innerWidth = Math.max(1, width - prefixWidth);
-        const contentWidth = Math.max(1, innerWidth - padding * 2);
-        const layoutWidth = Math.max(1, contentWidth - (padding ? 0 : 1));
+        const shared = this.options.promptGeometry?.(width, this.editor.getPaddingX());
+        const padding = shared?.paddingX ?? Math.min(this.editor.getPaddingX(), Math.max(0, Math.floor((width - 1) / 2)));
+        const prefixWidth = shared?.prefixWidth ?? 0;
+        const contentWidth = shared?.contentWidth ?? Math.max(1, width - padding * 2);
+        const layoutWidth = shared?.layoutWidth ?? Math.max(1, contentWidth - (padding ? 0 : 1));
         const visualLines = editorVisualLineMap(this.editor, layoutWidth)
             ?? buildVisualLineMap(editorState(this.editor).lines, layoutWidth);
         const scrollOffset = this.editor.interaction?.scrollOffset() ?? numericProperty(this.editor, "scrollOffset");
         const maxVisibleLines = Math.max(5, Math.floor(this.options.getRows() * 0.3));
         const textRows = Math.max(0, Math.min(visualLines.length - scrollOffset, maxVisibleLines, rows.length - 2));
-        this.#geometry = { width, padding, layoutWidth, visualLines, scrollOffset, textRows, hiddenRanges: [] };
+        this.#geometry = { width, padding, prefixWidth, layoutWidth, visualLines, scrollOffset, textRows, hiddenRanges: [] };
         if (this.#atomicFocus() !== undefined) {
             for (let row = 0; row < rows.length; row += 1) {
                 rows[row] = (rows[row] ?? "").replaceAll(CURSOR_MARKER, "");
@@ -376,7 +375,7 @@ class PromptSelectionInterceptor {
             return undefined;
         const line = (geometry.lines ?? editorState(this.editor).lines)[visual.logicalLine] ?? "";
         const segment = line.slice(visual.startCol, visual.startCol + visual.length);
-        const displayColumn = Math.max(0, column - 1 - geometry.padding - (this.options.promptPrefixWidth ?? 0));
+        const displayColumn = Math.max(0, column - 1 - geometry.padding - geometry.prefixWidth);
         return {
             line: visual.logicalLine,
             col: restoreColumn(visual.startCol + indexAtDisplayWidth(segment, displayColumn), geometry.hiddenRanges[visual.logicalLine] ?? []),
@@ -900,6 +899,10 @@ function numericProperty(target, key) {
     const value = Object.getOwnPropertyDescriptor(target, key)?.value;
     return typeof value === "number" ? value : 0;
 }
+/** Shares the existing atomic-aware body layout with prompt/menu composition. */
+export function editorVisualLineCount(editor, width) {
+    return editorVisualLineMap(editor, width)?.length;
+}
 function editorVisualLineMap(editor, width) {
     if (editor.interaction !== undefined)
         return editor.interaction.visualLines(width);

package/dist/integrations/pi/components/prompt-input-port.d.ts

@@ -0,0 +1,18 @@
+export interface PiShellPromptInputGeometry {
+    readonly prefixWidth: number;
+    readonly innerWidth: number;
+    readonly paddingX: number;
+    readonly contentWidth: number;
+    readonly layoutWidth: number;
+}
+export interface PiShellPromptInputBody {
+    readonly rows: readonly string[];
+    readonly topRule?: string | undefined;
+    readonly bottomRule?: string | undefined;
+    readonly after?: readonly string[];
+}
+export interface PiShellPromptInputPresentation {
+    geometry(width: number, padding?: number): PiShellPromptInputGeometry;
+    styleRule(text: string): string;
+    render(width: number, body: (innerWidth: number) => PiShellPromptInputBody, ruled?: boolean, padding?: number): string[];
+}

package/dist/integrations/pi/components/prompt-input-port.js

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

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -1,9 +1,9 @@
 import { getSelectListTheme } from "@earendil-works/pi-coding-agent";
-import { CombinedAutocompleteProvider, matchesKey, setKeybindings, } from "#pi-tui";
+import { CombinedAutocompleteProvider, matchesKey, setKeybindings, visibleWidth, } from "#pi-tui";
 import { PROMPT_HISTORY_EDITOR_REPLACEMENT } from "../../../contracts/owned-ui/index.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { OwnedEditor } from "./upstream/components/owned-editor.js";
-import { OwnedEditorUxInterception, createPromptSelectionInterceptor, } from "./owned-editor-ux.js";
+import { OwnedEditorUxInterception, createPromptSelectionInterceptor, editorVisualLineCount, } from "./owned-editor-ux.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { createTuiFacade, ensureTheme, isAutocompleteProvider, } from "./shell-shared-facade.js";
 export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
@@ -33,6 +33,7 @@ export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
 export function createPiShellEditor(options) {
     ensureTheme();
     const tui = createTuiFacade(options);
+    const inputPresentation = options.keybindingProfile === "a1" ? options.promptPresentation?.input : undefined;
     const keybindings = options.keybindingProfile === "a1"
         ? KeybindingsManager.createForOwnedInput(options.agentDir)
         : KeybindingsManager.create(options.agentDir);
@@ -40,20 +41,33 @@ export function createPiShellEditor(options) {
     if (options.persistentHistory === true && options.keybindingProfile === "a1" && options.historyEditor === undefined) {
         throw new Error("Persistent history requires the loaded owned editor");
     }
+    const scrollInfo = { emitted: false, counter: undefined };
+    const selectListTheme = getSelectListTheme();
     const EditorClass = options.keybindingProfile === "a1" && options.persistentHistory === true ? options.historyEditor : OwnedEditor;
     const editor = new EditorClass(tui, {
-        borderColor: (value) => piTheme().fg("borderMuted", value),
-        selectList: getSelectListTheme(),
+        borderColor: (value) => inputPresentation === undefined ? piTheme().fg("borderMuted", value) : inputPresentation.styleRule(value),
+        selectList: options.keybindingProfile !== "a1" ? selectListTheme : {
+            ...selectListTheme,
+            scrollInfo: text => {
+                // Protocol: the pinned list emits its final counter row through this callback.
+                scrollInfo.emitted = true;
+                scrollInfo.counter = /^  \((\d+\/\d+)\)$/u.exec(text)?.[1];
+                return selectListTheme.scrollInfo(text);
+            },
+        },
     }, keybindings, {
         paddingX: PINNED_PI_LAYOUT.editorPaddingX,
         autocompleteMaxVisible: PINNED_PI_LAYOUT.autocompleteMaxVisible,
         persistentHistory: options.persistentHistory === true,
         styleHistoryLabel: text => piTheme().fg("dim", text),
+        ...(options.keybindingProfile === "a1" ? {
+            terminalRows: options.getRows,
+            getVisualLineCount: (width) => editorVisualLineCount(editor, width),
+        } : {}),
         ...(options.keybindingProfile === "a1" && options.promptPresentation !== undefined ? {
-            promptPrefix: options.promptPresentation.prefix,
+            ...(inputPresentation === undefined ? {} : { inputPresentation }),
             styleSuggestion: options.promptPresentation.styleSuggestion,
             styleSuggestionCaret: options.promptPresentation.styleSuggestionCaret,
-            terminalRows: options.getRows,
         } : {}),
     });
     const editorUx = options.keybindingProfile === "a1"
@@ -70,7 +84,7 @@ export function createPiShellEditor(options) {
                 decorateRow: options.decorateEditorRow ?? (row => row),
                 requestRender: options.requestRender,
                 getRows: options.getRows,
-                ...(options.promptPresentation === undefined ? {} : { promptPrefixWidth: 2 }),
+                ...(inputPresentation === undefined ? {} : { promptGeometry: (width, padding) => inputPresentation.geometry(width, padding) }),
             }),
         ], {
             render: width => editor.render(width),
@@ -80,9 +94,9 @@ export function createPiShellEditor(options) {
     let thinkingLevel = "off";
     let isBashMode = false;
     const updateBorderColor = () => {
-        editor.borderColor = isBashMode
-            ? piTheme().getBashModeBorderColor()
-            : piTheme().getThinkingBorderColor(thinkingLevel);
+        editor.borderColor = inputPresentation !== undefined
+            ? text => inputPresentation.styleRule(text)
+            : isBashMode ? piTheme().getBashModeBorderColor() : piTheme().getThinkingBorderColor(thinkingLevel);
         tui.requestRender();
     };
     let autocompleteProvider;
@@ -147,13 +161,43 @@ export function createPiShellEditor(options) {
     if (options.onPromptSuggestionAccepted !== undefined) {
         editor.onPromptSuggestionAccepted = options.onPromptSuggestionAccepted;
     }
+    let bodyGeometry = { rowOffset: 0, rowCount: 0 };
     return {
-        render: width => editorUx?.render(width) ?? editor.render(width),
+        ...(editorUx === undefined ? {} : { bodyGeometry: () => bodyGeometry }),
+        render: width => {
+            scrollInfo.emitted = false;
+            scrollInfo.counter = undefined;
+            const rows = editorUx?.render(width) ?? editor.render(width);
+            if (editorUx === undefined)
+                return rows;
+            const rowCount = editor.getRenderedBodyRowCount();
+            const menu = rows.slice(rowCount, scrollInfo.emitted ? -1 : undefined);
+            const label = scrollInfo.counter === undefined ? "" : `${scrollInfo.counter} `;
+            // Compatibility: match the history border's four-cell inset and dim label style.
+            const counterBorder = label.length > 0 && 4 + visibleWidth(label) <= width
+                ? editor.borderColor("─── ") + piTheme().fg("dim", label)
+                    + editor.borderColor("─".repeat(width - 4 - visibleWidth(label)))
+                : editor.borderColor("─".repeat(width));
+            // Rationale: when the menu is open, drop the plain top border above the
+            // menu and instead show the counter on the border directly above the input
+            // prompt (the body's own top border row), mirroring the history header.
+            const bodyRows = menu.length === 0
+                ? rows.slice(0, rowCount)
+                : [counterBorder, ...rows.slice(1, rowCount)];
+            bodyGeometry = { rowOffset: menu.length, rowCount };
+            // Invariant: decorate/select in body coordinates first, then move the whole menu.
+            // Completion state, sizing, styles, and pagination still belong to the editor.
+            return [...menu, ...bodyRows];
+        },
         activateKeybindings: () => setKeybindings(keybindings),
         keybindingConfig: () => keybindings.getEffectiveConfig(),
         reloadKeybindings: () => { keybindings.reload(); setKeybindings(keybindings); },
         matchesTerminalKey: (data, key) => matchesKey(data, key),
         handleInput: data => {
+            // Compatibility: an unassigned reverse Tab must not clear selection or reach autocomplete fallback.
+            if (editorUx !== undefined && matchesKey(data, "shift+tab")
+                && !Object.values(keybindings.getEffectiveConfig()).some(keys => (Array.isArray(keys) ? keys : [keys]).some(key => key !== undefined && matchesKey(data, key))))
+                return;
             if (editorUx === undefined)
                 editor.handleInput(data);
             else
@@ -210,6 +254,17 @@ export function createPiShellEditor(options) {
             editor.invalidate();
         },
         canPresentPromptSuggestion: () => editor.canPresentPromptSuggestion(),
+        promptSuggestionBlockReason: () => {
+            if (!editor.focused)
+                return "not-focused";
+            if (editor.disableSubmit)
+                return "not-ready";
+            if (editor.getText().length > 0)
+                return "draft";
+            if (editor.isShowingAutocomplete())
+                return "autocomplete";
+            return editor.canPresentPromptSuggestion() ? null : "prompt-mode";
+        },
         hasSelection: () => editorUx?.hasSelection() ?? false,
         ownsPointer: () => editorUx?.ownsPointer() ?? false,
         handlePointer: event => editorUx?.handlePointer(event) ?? false,

package/dist/integrations/pi/components/shell-footer-status.d.ts

@@ -3,5 +3,5 @@ import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellQueu
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
 export declare function createPiShellStatus(view: OwnedUiSessionViewModel, formatProgressStatus: (message: string) => string, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
-export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string): PiShellViewComponentPort;
+export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1"): PiShellViewComponentPort;
 export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport"): PiShellQueuedInputPort;

package/dist/integrations/pi/components/shell-footer-status.js

@@ -1,6 +1,7 @@
 import { rawKeyHint, VERSION } from "@earendil-works/pi-coding-agent";
 import { Spacer, Text, } from "#pi-tui";
 import { SessionFooter } from "./upstream/components/session-footer.js";
+import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { WorkingStatusIndicator } from "./upstream/components/status-indicator.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { createTuiFacade, ensureTheme, } from "./shell-shared-facade.js";
@@ -16,6 +17,8 @@ export function createPiShellHeader(options = {}) {
         render(width) {
             if (options.quiet)
                 return [];
+            if (expanded && options.getKeybindings !== undefined)
+                full.setText(expandedHeaderText(options.getKeybindings()));
             return [
                 ...new Spacer(1).render(width),
                 ...(expanded ? full : compact).render(width),
@@ -111,9 +114,9 @@ export function createPiShellStatus(view, formatProgressStatus, runtime) {
         },
     };
 }
-export function createPiShellFooter(view, cwd) {
+export function createPiShellFooter(view, cwd, profile = "pi") {
     ensureTheme();
-    const footer = new SessionFooter(() => view, cwd);
+    const footer = new SessionFooter(() => view, cwd, profile);
     return {
         render: width => footer.render(width),
         invalidate: () => footer.invalidate(),
@@ -184,7 +187,8 @@ function compactHeaderText() {
     const onboarding = theme.fg("dim", "Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.");
     return `${logo}\n${instructions}\n${compactOnboarding}\n\n${onboarding}`;
 }
-function expandedHeaderText() {
+function expandedHeaderText(bindings) {
+    const keys = bindings === undefined ? undefined : KeybindingsManager.fromOwnedBindings(bindings);
     const instructions = [
         rawKeyHint("escape", "to interrupt"),
         rawKeyHint("ctrl+c", "to clear"),
@@ -192,9 +196,9 @@ function expandedHeaderText() {
         rawKeyHint("ctrl+d", "to exit (empty)"),
         rawKeyHint(process.platform === "win32" ? "" : "ctrl+z", "to suspend"),
         rawKeyHint("ctrl+k", "to delete to end"),
-        rawKeyHint("shift+tab", "to cycle thinking level"),
+        rawKeyHint(keys?.getKeys("app.thinking.cycle").join("/") ?? "shift+tab", "to cycle thinking level"),
         rawKeyHint("ctrl+p/shift+ctrl+p", "to cycle models"),
-        rawKeyHint("ctrl+l", "to select model"),
+        rawKeyHint(keys === undefined ? "ctrl+l" : keys.getKeys("app.model.select").join("/") || "/model", "to select model"),
         rawKeyHint("ctrl+o", "to expand tools"),
         rawKeyHint("ctrl+t", "to expand thinking"),
         rawKeyHint("ctrl+g", "for external editor"),

package/dist/integrations/pi/components/shell-presenters-info.js

@@ -86,12 +86,17 @@ function shortcutDisplay(key) {
 }
 export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi") {
     ensureTheme();
-    const keys = new KeybindingsManager(bindings);
+    const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(bindings) : new KeybindingsManager(bindings);
     // Compatibility: the owned viewport consumes these physical chords before editor actions.
     const display = (action) => keys.getKeys(action)
         .filter(key => profile !== "a1" || (key !== "ctrl+home" && key !== "ctrl+end"))
         .map(shortcutDisplay).join("/");
-    const row = (actions, description) => `| ${actions.map(action => `\`${display(action)}\``).join(" / ")} | ${description} |`;
+    const row = (actions, description) => `| ${actions.map(action => {
+        const label = display(action);
+        return profile === "a1" && label.length === 0
+            ? action === "app.model.select" ? "Unbound (`/model`)" : "Unbound"
+            : `\`${label}\``;
+    }).join(" / ")} | ${description} |`;
     let markdown = ["**Navigation**", "| Key | Action |", "|-----|--------|", row(["tui.editor.cursorUp", "tui.editor.cursorDown", "tui.editor.cursorLeft", "tui.editor.cursorRight"], "Move cursor / browse history"), row(["tui.editor.cursorWordLeft", "tui.editor.cursorWordRight"], "Move by word"), row(["tui.editor.cursorLineStart"], profile === "a1" ? "Start of prompt line" : "Start of line"), row(["tui.editor.cursorLineEnd"], profile === "a1" ? "End of prompt line" : "End of line"), ...(profile === "a1" ? ["| `Ctrl+Home` | Start of content |", "| `Ctrl+End` | End of content / follow output |"] : []), row(["tui.editor.jumpForward"], "Jump forward to character"), row(["tui.editor.jumpBackward"], "Jump backward to character"), row(["tui.editor.pageUp", "tui.editor.pageDown"], "Scroll by page"), "", "**Editing**", "| Key | Action |", "|-----|--------|", row(["tui.input.submit"], "Send message"), row(["tui.input.newLine"], `New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""}`), row(["tui.editor.deleteWordBackward"], "Delete word backwards"), row(["tui.editor.deleteWordForward"], "Delete word forwards"), row(["tui.editor.deleteToLineStart"], "Delete to start of line"), row(["tui.editor.deleteToLineEnd"], "Delete to end of line"), row(["tui.editor.yank"], "Paste the most-recently-deleted text"), row(["tui.editor.yankPop"], "Cycle through the deleted text after pasting"), row(["tui.editor.undo"], "Undo"), "", "**Other**", "| Key | Action |", "|-----|--------|", row(["tui.input.tab"], "Path completion / accept autocomplete"), row(["app.interrupt"], "Cancel autocomplete / abort streaming"), row(["app.clear"], "Clear editor (first) / exit (second)"), row(["app.exit"], "Exit (when editor is empty)"), row(["app.suspend"], "Suspend to background"), row(["app.thinking.cycle"], "Cycle thinking level"), row(["app.model.cycleForward", "app.model.cycleBackward"], "Cycle models"), row(["app.model.select"], "Open model selector"), row(["app.tools.expand"], "Toggle tool output expansion"), row(["app.thinking.toggle"], "Toggle thinking block visibility"), row(["app.editor.external"], "Edit message in external editor"), row(["app.message.copy"], "Copy last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], "Paste image or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |"].join("\n");
     const shortcuts = getShortcuts(bindings ?? keys.getEffectiveConfig());
     if (shortcuts.length > 0) {

package/dist/integrations/pi/components/shell-presenters-transcript.d.ts

@@ -2,9 +2,13 @@ import { AssistantMessageComponent } from "@earendil-works/pi-coding-agent";
 import { type MermaidRenderingMode } from "./upstream/components/mermaid.js";
 import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 import { type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
-export type { PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
+export { isPiPromptStyleCompaction, type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
 import { type PiShellExtensionRendererResolver, type PiShellImageAssetResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
-export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer, initialOutputPad?: 0 | 1, initialHideThinkingBlock?: boolean, initialMermaidRenderingMode?: MermaidRenderingMode, initialShowImages?: boolean, initialImageWidthCells?: number, imageAssets?: PiShellImageAssetResolver): PiShellTranscriptComponentPort;
+export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer, initialOutputPad?: 0 | 1, initialHideThinkingBlock?: boolean, initialMermaidRenderingMode?: MermaidRenderingMode, initialShowImages?: boolean, initialImageWidthCells?: number, imageAssets?: PiShellImageAssetResolver, presentation?: {
+    readonly getColumns: () => number;
+    readonly getRows: () => number;
+    readonly changed: () => void;
+}): PiShellTranscriptComponentPort;
 export declare function renderPiShellTranscriptBlock(block: OwnedUiTranscriptBlock, width: number, cwd: string): readonly string[];
 /**
  * Pinned Pi's CLI prints startup diagnostics with `reportDiagnostics` before