@timurproko/a1 0.1.8-dev.3b54f21 → 0.1.8-dev.407

package/dist/integrations/pi/components/path-word-ranges.d.ts

@@ -0,0 +1,2 @@
+import type { PiShellEditorTextRange } from "./shell-shared-facade.js";
+export declare function promptPathWordRanges(line: string): readonly PiShellEditorTextRange[];

package/dist/integrations/pi/components/path-word-ranges.js

@@ -0,0 +1,37 @@
+const WHITESPACE = /\s/u;
+const DRIVE_ROOT = /^[A-Za-z]:[\\/]/u;
+const UNC_ROOT = /^(?:\\\\|\/\/)[^\\/\s]+[\\/][^\\/\s]+/u;
+const POSIX_ROOT = /^\//u;
+const EXPLICIT_RELATIVE_ROOT = /^(?:\.{1,2}|~)[\\/]/u;
+export function promptPathWordRanges(line) {
+    const ranges = [];
+    let index = 0;
+    while (index < line.length) {
+        while (index < line.length && WHITESPACE.test(line[index] ?? ""))
+            index += 1;
+        if (index >= line.length)
+            break;
+        const start = index;
+        const quote = line[index] === '"' || line[index] === "'" ? line[index] : undefined;
+        if (quote !== undefined) {
+            const closing = line.indexOf(quote, index + 1);
+            if (closing >= 0 && (closing + 1 === line.length || WHITESPACE.test(line[closing + 1] ?? ""))) {
+                if (isExplicitPath(line.slice(index + 1, closing)))
+                    ranges.push({ start, end: closing + 1 });
+                index = closing + 1;
+                continue;
+            }
+        }
+        while (index < line.length && !WHITESPACE.test(line[index] ?? ""))
+            index += 1;
+        if (isExplicitPath(line.slice(start, index)))
+            ranges.push({ start, end: index });
+    }
+    return ranges;
+}
+function isExplicitPath(value) {
+    return DRIVE_ROOT.test(value)
+        || UNC_ROOT.test(value)
+        || POSIX_ROOT.test(value)
+        || EXPLICIT_RELATIVE_ROOT.test(value);
+}

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/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-components.d.ts

@@ -2,5 +2,6 @@ export * from "./shell-shared-facade.js";
 export * from "./shell-editor-autocomplete.js";
 export * from "./shell-selectors-dialogs.js";
 export * from "./shell-presenters-transcript.js";
+export * from "./shell-presenters-info.js";
 export * from "./shell-footer-status.js";
 export * from "./shell-extension-ui.js";

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-components.js

@@ -2,5 +2,6 @@ export * from "./shell-shared-facade.js";
 export * from "./shell-editor-autocomplete.js";
 export * from "./shell-selectors-dialogs.js";
 export * from "./shell-presenters-transcript.js";
+export * from "./shell-presenters-info.js";
 export * from "./shell-footer-status.js";
 export * from "./shell-extension-ui.js";

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

@@ -0,0 +1,297 @@
+import { getSelectListTheme } from "@earendil-works/pi-coding-agent";
+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, 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 = [
+    { name: "settings", description: "Open settings menu" },
+    { name: "model", description: "Select model (opens selector UI)", argumentHint: "<provider/model>" },
+    { name: "scoped-models", description: "Enable/disable models for Ctrl+P cycling" },
+    { name: "export", description: "Export session (HTML default, or specify path: .html/.jsonl)" },
+    { name: "import", description: "Import and resume a session from a JSONL file" },
+    { name: "share", description: "Share session as a secret GitHub gist" },
+    { name: "copy", description: "Copy last agent message to clipboard" },
+    { name: "name", description: "Set session display name" },
+    { name: "session", description: "Show session info and stats" },
+    { name: "changelog", description: "Show changelog entries" },
+    { name: "hotkeys", description: "Show all keyboard shortcuts" },
+    { name: "fork", description: "Create a new fork from a previous user message" },
+    { name: "clone", description: "Duplicate the current session at the current position" },
+    { name: "tree", description: "Navigate session tree (switch branches)" },
+    { name: "trust", description: "Save project trust decision for future sessions" },
+    { name: "login", description: "Configure provider authentication", argumentHint: "<provider>" },
+    { name: "logout", description: "Remove provider authentication" },
+    { name: "new", description: "Start a new session" },
+    { name: "compact", description: "Manually compact the session context" },
+    { name: "resume", description: "Resume a different session" },
+    { name: "reload", description: "Reload keybindings, extensions, skills, prompts, themes, and context files" },
+    { name: "quit", description: "Quit pi" },
+];
+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);
+    setKeybindings(keybindings);
+    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) => 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 ? {
+            ...(inputPresentation === undefined ? {} : { inputPresentation }),
+            styleSuggestion: options.promptPresentation.styleSuggestion,
+            styleSuggestionCaret: options.promptPresentation.styleSuggestionCaret,
+        } : {}),
+    });
+    const editorUx = options.keybindingProfile === "a1"
+        ? new OwnedEditorUxInterception([
+            createPromptSelectionInterceptor(editor, keybindings, {
+                copyText: options.onCopyText ?? (() => { }),
+                readClipboardContent: options.readClipboardContent ?? (async () => null),
+                ...(options.beginClipboardPaste === undefined ? {} : { beginClipboardPaste: options.beginClipboardPaste }),
+                ...(options.beginTextPaste === undefined ? {} : { beginTextPaste: options.beginTextPaste }),
+                ...(options.deferTextPaste === undefined ? {} : { deferTextPaste: options.deferTextPaste }),
+                ...(options.onPasteRejected === undefined ? {} : { onPasteRejected: options.onPasteRejected }),
+                ...(options.onPasteInput === undefined ? {} : { onPasteInput: options.onPasteInput }),
+                transformPastedContent: options.transformPastedContent ?? (content => content.kind === "text" ? content.text : ""),
+                atomicRanges: options.editorAtomicRanges ?? (() => []),
+                hiddenRanges: options.editorHiddenRanges ?? (() => []),
+                expandCopiedText: options.expandCopiedEditorText ?? (text => text),
+                paintSelection: options.paintEditorSelection ?? (line => line),
+                decorateRow: options.decorateEditorRow ?? (row => row),
+                requestRender: options.requestRender,
+                getRows: options.getRows,
+                ...(inputPresentation === undefined ? {} : { promptGeometry: (width, padding) => inputPresentation.geometry(width, padding) }),
+            }),
+        ], {
+            render: width => editor.render(width),
+            handleInput: data => editor.handleInput(data),
+        })
+        : undefined;
+    let thinkingLevel = "off";
+    let isBashMode = false;
+    const updateBorderColor = () => {
+        editor.borderColor = inputPresentation !== undefined
+            ? text => inputPresentation.styleRule(text)
+            : isBashMode ? piTheme().getBashModeBorderColor() : piTheme().getThinkingBorderColor(thinkingLevel);
+        tui.requestRender();
+    };
+    let autocompleteProvider;
+    const setAutocompleteCommands = (commands) => {
+        const additions = new Map(commands.map(command => [command.name, command]));
+        const builtInNames = new Set(PINNED_PI_BUILTIN_SLASH_COMMANDS.map(command => command.name));
+        const builtIns = PINNED_PI_BUILTIN_SLASH_COMMANDS.map(command => autocompleteCommand(command, additions.get(command.name)));
+        const resources = commands.filter(command => !builtInNames.has(command.name)).map(command => autocompleteCommand(command));
+        autocompleteProvider = new CombinedAutocompleteProvider([...builtIns, ...resources], options.cwd ?? process.cwd());
+        editor.setAutocompleteProvider(autocompleteProvider);
+    };
+    setAutocompleteCommands(options.autocompleteCommands ?? []);
+    let submitHandler = options.onSubmit;
+    let interruptHandler = options.onInterrupt ?? (() => { });
+    editor.onSubmit = text => submitHandler(text);
+    editor.onChange = text => {
+        const nextBashMode = text.trimStart().startsWith("!");
+        if (nextBashMode !== isBashMode) {
+            isBashMode = nextBashMode;
+            updateBorderColor();
+        }
+        options.onChange?.(text);
+    };
+    if (options.onInterrupt !== undefined) {
+        editor.onEscape = () => interruptHandler();
+        editor.onAction("app.interrupt", () => interruptHandler());
+    }
+    if (options.onClear !== undefined)
+        editor.onAction("app.clear", options.onClear);
+    if (options.onExit !== undefined) {
+        editor.onCtrlD = options.onExit;
+        editor.onAction("app.exit", options.onExit);
+    }
+    if (options.onSuspend !== undefined)
+        editor.onAction("app.suspend", options.onSuspend);
+    if (options.onExternalEditor !== undefined)
+        editor.onAction("app.editor.external", options.onExternalEditor);
+    if (options.onPasteImage !== undefined) {
+        editor.onPasteImage = options.onPasteImage;
+        editor.onAction("app.clipboard.pasteImage", options.onPasteImage);
+    }
+    if (options.onExtensionShortcut !== undefined)
+        editor.onExtensionShortcut = options.onExtensionShortcut;
+    if (options.onModelSelect !== undefined)
+        editor.onAction("app.model.select", options.onModelSelect);
+    if (options.onModelCycle !== undefined) {
+        editor.onAction("app.model.cycleForward", () => options.onModelCycle?.("forward"));
+        editor.onAction("app.model.cycleBackward", () => options.onModelCycle?.("backward"));
+    }
+    if (options.onThinkingCycle !== undefined)
+        editor.onAction("app.thinking.cycle", options.onThinkingCycle);
+    if (options.onThinkingToggle !== undefined)
+        editor.onAction("app.thinking.toggle", options.onThinkingToggle);
+    if (options.onToolsExpand !== undefined)
+        editor.onAction("app.tools.expand", options.onToolsExpand);
+    if (options.onMessageCopy !== undefined)
+        editor.onAction("app.message.copy", options.onMessageCopy);
+    if (options.onFollowUp !== undefined)
+        editor.onAction("app.message.followUp", options.onFollowUp);
+    if (options.onDequeue !== undefined)
+        editor.onAction("app.message.dequeue", options.onDequeue);
+    if (options.onPromptSuggestionAccepted !== undefined) {
+        editor.onPromptSuggestionAccepted = options.onPromptSuggestionAccepted;
+    }
+    let bodyGeometry = { rowOffset: 0, rowCount: 0 };
+    return {
+        ...(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
+                editorUx.handleInput(data);
+        },
+        invalidate: () => editor.invalidate(),
+        setFocused: focused => {
+            editor.focused = focused;
+        },
+        getText: () => editor.getExpandedText(),
+        setText: text => {
+            editorUx?.reset();
+            editor.setText(text);
+        },
+        insertText: text => {
+            editorUx?.reset();
+            editor.insertTextAtCursor(text);
+        },
+        addToHistory: text => editor.addToHistory(text),
+        ...(editor.recall === undefined ? {} : { recall: editor.recall, historyReplacement: PROMPT_HISTORY_EDITOR_REPLACEMENT }),
+        setSubmitEnabled: enabled => {
+            editor.disableSubmit = !enabled;
+        },
+        setSubmitHandler: handler => { submitHandler = handler; },
+        setInterruptHandler: handler => { interruptHandler = handler; },
+        setAutocompleteCommands,
+        setPaddingX(padding) {
+            editor.setPaddingX(padding);
+            editor.invalidate();
+            tui.requestRender();
+        },
+        setAutocompleteMaxVisible(maxVisible) {
+            editor.setAutocompleteMaxVisible(maxVisible);
+            editor.invalidate();
+            tui.requestRender();
+        },
+        addAutocompleteProvider(factory) {
+            if (typeof factory !== "function")
+                throw new TypeError("extension autocomplete factory must be a function");
+            const candidate = Reflect.apply(factory, undefined, [autocompleteProvider]);
+            if (!isAutocompleteProvider(candidate))
+                throw new TypeError("extension autocomplete factory returned a malformed provider");
+            autocompleteProvider = candidate;
+            editor.setAutocompleteProvider(autocompleteProvider);
+        },
+        setThinkingLevel(level) {
+            if (thinkingLevel === level)
+                return;
+            thinkingLevel = level;
+            updateBorderColor();
+        },
+        setPromptSuggestion(text) {
+            editor.setPromptSuggestion(text);
+            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,
+        pasteClipboard: () => editorUx?.pasteClipboard() ?? false,
+        cancelPendingPastes: () => editorUx?.cancelPendingPastes(),
+    };
+}
+function autocompleteCommand(command, addition) {
+    const argumentOptions = addition?.argumentOptions ?? command.argumentOptions;
+    return {
+        ...command,
+        ...addition,
+        ...(argumentOptions === undefined ? {} : {
+            getArgumentCompletions: (prefix) => {
+                const normalized = prefix.toLowerCase();
+                return argumentOptions
+                    .filter(option => option.id.toLowerCase().includes(normalized) || option.label.toLowerCase().includes(normalized))
+                    .map(option => ({
+                    value: option.id,
+                    label: option.label,
+                    ...(option.description === undefined ? {} : { description: option.description }),
+                }));
+            },
+        }),
+    };
+}

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-extension-ui.d.ts

@@ -1,5 +1,5 @@
 import { type ExtensionUIContext } from "@earendil-works/pi-coding-agent";
-import type { OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayOptions } from "../owned-ui-contracts/index.js";
+import type { OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayOptions } from "../../../contracts/owned-ui/index.js";
 import { type PiShellComponentPort, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export interface PiExtensionUiBridgeHost {
     readonly runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/shell-footer-status.d.ts

@@ -1,7 +1,7 @@
-import type { OwnedUiSessionViewModel } from "../owned-ui-contracts/index.js";
+import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.js";
 import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellQueuedInputPort, type PiShellHeaderPort, type PiShellResourceEntry, type PiShellLoadedResourcesPort, type PiShellHeaderOptions, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
-export declare function createPiShellStatus(view: OwnedUiSessionViewModel, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
-export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string): PiShellViewComponentPort;
-export declare function createPiQueuedInputStatus(submissions: readonly string[]): PiShellQueuedInputPort;
+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, profile?: "pi" | "a1"): PiShellViewComponentPort;
+export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport"): PiShellQueuedInputPort;

package/dist/{src/foundation/pi-component-adapter → 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),
@@ -67,23 +70,30 @@ export function createPiShellLoadedResources(resources, initialExpanded = false)
         invalidate() { },
     };
 }
-export function createPiShellStatus(view, runtime) {
+export function createPiShellStatus(view, formatProgressStatus, runtime) {
     ensureTheme();
     const statusUi = createTuiFacade(runtime ?? { getColumns: () => 80, getRows: () => 24, requestRender() { } });
     let workingOverride;
-    let component = statusComponent(view, statusUi, workingOverride);
-    let signature = statusSignature(view, workingOverride);
+    let outputPad = PINNED_PI_LAYOUT.outputPad;
+    let placement = statusPlacement(view, workingOverride);
+    let component = statusComponent(view, statusUi, workingOverride, outputPad, formatProgressStatus, placement);
+    let signature = statusSignature(view, workingOverride, outputPad, placement);
     const rebuild = () => {
-        const nextSignature = statusSignature(view, workingOverride);
+        const nextPlacement = statusPlacement(view, workingOverride);
+        const nextSignature = statusSignature(view, workingOverride, outputPad, nextPlacement);
         if (nextSignature === signature)
             return;
         if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
             component.dispose();
+        placement = nextPlacement;
         signature = nextSignature;
-        component = statusComponent(view, statusUi, workingOverride);
+        component = statusComponent(view, statusUi, workingOverride, outputPad, formatProgressStatus, placement);
     };
     return {
         render: width => component?.render(width) ?? [],
+        renderDock: width => placement === "dock" ? component?.render(width) ?? [] : [],
+        renderLive: width => placement === "live" ? component?.render(width) ?? [] : [],
+        placement: () => placement,
         invalidate: () => component?.invalidate(),
         update(next) {
             view = next;
@@ -93,6 +103,10 @@ export function createPiShellStatus(view, runtime) {
             workingOverride = message;
             rebuild();
         },
+        setOutputPad(padding) {
+            outputPad = padding;
+            rebuild();
+        },
         dispose() {
             if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
                 component.dispose();
@@ -100,9 +114,9 @@ export function createPiShellStatus(view, 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(),
@@ -110,34 +124,54 @@ export function createPiShellFooter(view, cwd) {
         dispose: () => footer.dispose(),
     };
 }
-export function createPiQueuedInputStatus(submissions) {
-    const text = new Text(queuedInputText(submissions), 1, 0);
+export function createPiQueuedInputStatus(submissions, presentation = "pinned") {
+    const text = new Text(queuedInputText(submissions, presentation), 1, 0);
     return {
         render: width => submissions.length === 0 ? [] : text.render(width),
         invalidate: () => text.invalidate(),
         update(next) {
             submissions = next;
-            text.setText(queuedInputText(next));
+            text.setText(queuedInputText(next, presentation));
         },
     };
 }
-function statusComponent(view, ui, workingOverride) {
+function statusPlacement(view, workingOverride) {
+    // Invariant: live spinner placement follows semantic lifecycle, not text. An extension
+    // override is visible only when its lifecycle is busy, so a stale override cannot spin
+    // after completion or make an idle informational status scrollable.
     if (view.lifecycle === "busy")
-        return new WorkingStatusIndicator(ui, workingOverride ?? view.status.workingMessage ?? "Working...");
-    if (view.lifecycle === "failed") {
-        return new Text(piTheme().fg("error", view.status.diagnostics.at(-1) ?? "Session failed"), PINNED_PI_LAYOUT.outputPad, 0);
+        return "live";
+    if (view.lifecycle === "failed")
+        return "dock";
+    return view.status.workingMessage === null ? "hidden" : "dock";
+}
+function statusComponent(view, ui, workingOverride, outputPad, formatProgressStatus, placement) {
+    if (placement === "live") {
+        return new WorkingStatusIndicator(ui, formatProgressStatus(workingOverride ?? view.status.workingMessage ?? "Working"));
     }
-    if (view.status.workingMessage !== null) {
-        return new Text(piTheme().fg("muted", view.status.workingMessage), PINNED_PI_LAYOUT.outputPad, 0);
+    if (placement === "dock") {
+        if (view.lifecycle === "failed") {
+            return new Text(piTheme().fg("error", view.status.diagnostics.at(-1) ?? "Session failed"), outputPad, 0);
+        }
+        return new Text(piTheme().fg("muted", view.status.workingMessage), outputPad, 0);
     }
     return undefined;
 }
-function statusSignature(view, workingOverride) {
-    return `${view.lifecycle}\u0000${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
+function statusSignature(view, workingOverride, outputPad, placement) {
+    return `${placement}\u0000${outputPad}\u0000${view.lifecycle}\u0000${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
 }
-function queuedInputText(submissions) {
+function queuedInputText(submissions, presentation) {
+    if (submissions.length === 0)
+        return "";
     const theme = piTheme();
-    return submissions.map(submission => theme.fg("muted", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`)).join("\n");
+    if (presentation === "pinned") {
+        return submissions.map(submission => theme.fg("muted", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`)).join("\n");
+    }
+    const messages = submissions.map(submission => theme.fg("dim", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`));
+    const dequeueHint = theme.fg("dim", "↳ Alt+Up to edit all queued messages");
+    // Compatibility: the custom viewport matches Pi's interactive queue presentation while the
+    // comparison shell remains byte-for-byte compatible with its pinned fixture.
+    return ["", ...messages, dequeueHint].join("\n");
 }
 function compactHeaderText() {
     const theme = piTheme();
@@ -153,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"),
@@ -161,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.d.ts

@@ -0,0 +1,43 @@
+import { type KeybindingsConfig } from "#pi-tui";
+import { type PiShellComponentPort, type PiShellExtensionRendererResolver } from "./shell-shared-facade.js";
+export interface PiShellSessionInfoPresentation {
+    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;
+    }[];
+}
+export declare function renderPiShellStatusText(message: string, width: number, outputPad?: 0 | 1): readonly string[];
+export interface PiShellCommandMessagePresentation {
+    readonly kind: "error" | "warning" | "accent" | "new" | "name" | "debug";
+    readonly message: string;
+    readonly detail?: string;
+}
+export declare function renderPiShellCommandMessage(presentation: PiShellCommandMessagePresentation, width: number, outputPad?: 0 | 1): readonly string[];
+export declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
+export declare function createPiShellCollapsedChangelog(): PiShellComponentPort;
+export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;
+export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;