@timurproko/a1 0.1.8-dev.49ff83a → 0.1.8-dev.508

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

@@ -0,0 +1,248 @@
+import { rawKeyHint, VERSION } from "../startup-public.js";
+import { Spacer, Text, } from "@earendil-works/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";
+export function createPiShellHeader(options = {}) {
+    ensureTheme();
+    let expanded = options.expanded ?? false;
+    const compact = new Text(compactHeaderText(), 1, 0);
+    const full = new Text(expandedHeaderText(), 1, 0);
+    const notices = (options.notices ?? []).map(notice => new Text(noticeText(notice), 1, 0));
+    return {
+        get expanded() { return expanded; },
+        setExpanded(value) { expanded = value; },
+        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),
+                ...notices.flatMap(notice => ["", ...notice.render(width)]),
+                ...new Spacer(1).render(width),
+            ];
+        },
+        invalidate() {
+            compact.invalidate();
+            full.invalidate();
+            for (const notice of notices)
+                notice.invalidate();
+        },
+    };
+}
+export function createPiShellLoadedResources(resources, initialExpanded = false) {
+    ensureTheme();
+    let expanded = initialExpanded;
+    return {
+        setExpanded(value) { expanded = value; },
+        render(width) {
+            const rows = [];
+            const sections = ["Context", "Skills", "Prompts", "Extensions", "Themes"];
+            for (const section of sections) {
+                const entries = resources.filter(entry => entry.section === section && !entry.diagnostic);
+                if (entries.length === 0)
+                    continue;
+                if (rows.length === 0 && section === "Context")
+                    rows.push("");
+                const labels = expanded
+                    ? entries.map(entry => entry.sourcePath ?? entry.label).sort((left, right) => left.localeCompare(right))
+                    : entries.map(entry => entry.label).sort((left, right) => left.localeCompare(right));
+                const body = expanded
+                    ? labels.map(label => piTheme().fg("dim", `  ${label}`)).join("\n")
+                    : piTheme().fg("dim", `  ${labels.join(", ")}`);
+                rows.push(...new Text(`${piTheme().fg("mdHeading", `[${section}]`)}\n${body}`, 0, 0).render(width), "");
+            }
+            const diagnostics = resources.filter(entry => entry.diagnostic);
+            for (const group of ["Skills", "Prompts", "Extensions", "Themes"]) {
+                const entries = diagnostics.filter(entry => entry.section === group);
+                if (entries.length === 0)
+                    continue;
+                const title = group === "Skills" ? "Skill conflicts" : group === "Prompts" ? "Prompt conflicts" : group === "Extensions" ? "Extension issues" : "Theme conflicts";
+                const body = entries.map(entry => `  ${entry.sourcePath ? `${entry.sourcePath}\n    ` : ""}${entry.diagnostic}`).join("\n");
+                rows.push(...new Text(`${piTheme().fg("warning", `[${title}]`)}\n${piTheme().fg("warning", body)}`, 0, 0).render(width), "");
+            }
+            return rows.length === 0 ? rows : [...rows, ""];
+        },
+        invalidate() { },
+    };
+}
+export function createPiShellStatus(view, formatProgressStatus, runtime) {
+    ensureTheme();
+    const statusUi = createTuiFacade(runtime ?? { getColumns: () => 80, getRows: () => 24, requestRender() { } });
+    let workingOverride;
+    let outputPad = PINNED_PI_LAYOUT.outputPad;
+    let progressPresentation = "pinned";
+    let placement = statusPlacement(view, workingOverride);
+    const liveStatusText = () => formatProgressStatus(liveWorkingText(view, workingOverride, progressPresentation));
+    let component = statusComponent(view, statusUi, outputPad, liveStatusText, placement);
+    let signature = statusSignature(view, workingOverride, outputPad, placement, progressPresentation);
+    const rebuild = () => {
+        const nextPlacement = statusPlacement(view, workingOverride);
+        const nextSignature = statusSignature(view, workingOverride, outputPad, nextPlacement, progressPresentation);
+        if (nextSignature === signature)
+            return;
+        // Performance: progress ticks change only the live message; the spinner keeps its frame and timer.
+        if (placement === "live" && nextPlacement === "live" && component instanceof WorkingStatusIndicator
+            && statusSignature(view, workingOverride, outputPad, nextPlacement, progressPresentation, false)
+                === statusSignature(view, workingOverride, outputPad, placement, progressPresentation, false)) {
+            component.setMessage(liveStatusText());
+            signature = nextSignature;
+            return;
+        }
+        if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
+            component.dispose();
+        placement = nextPlacement;
+        signature = nextSignature;
+        component = statusComponent(view, statusUi, outputPad, liveStatusText, 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;
+            rebuild();
+        },
+        setWorkingOverride(message) {
+            workingOverride = message;
+            rebuild();
+        },
+        setOutputPad(padding) {
+            outputPad = padding;
+            rebuild();
+        },
+        setProgressPresentation(presentation) {
+            progressPresentation = presentation;
+            rebuild();
+        },
+        dispose() {
+            if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
+                component.dispose();
+            component = undefined;
+        },
+    };
+}
+export function createPiShellFooter(view, cwd, profile = "pi") {
+    ensureTheme();
+    const footer = new SessionFooter(() => view, cwd, profile);
+    return {
+        render: width => footer.render(width),
+        invalidate: () => footer.invalidate(),
+        update(next) { view = next; },
+        dispose: () => footer.dispose(),
+    };
+}
+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, presentation));
+        },
+    };
+}
+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 "live";
+    if (view.lifecycle === "failed")
+        return "dock";
+    return view.status.workingMessage === null ? "hidden" : "dock";
+}
+// Rationale: the engine publishes the semantic working word and a separate measured percent; bare A1
+// composes them here, while the pinned route keeps the bare word for comparison with Pi.
+function liveWorkingText(view, workingOverride, progressPresentation) {
+    const message = workingOverride ?? view.status.workingMessage ?? "Working";
+    const progress = view.status.workingProgress;
+    return workingOverride === undefined && progressPresentation === "custom-viewport" && typeof progress === "number"
+        ? `${message} (${progress}%)`
+        : message;
+}
+function statusComponent(view, ui, outputPad, liveStatusText, placement) {
+    if (placement === "live") {
+        return new WorkingStatusIndicator(ui, liveStatusText());
+    }
+    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, outputPad, placement, progressPresentation, withMessage = true) {
+    const message = withMessage ? `${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.workingProgress ?? ""}` : "";
+    return `${placement}\u0000${outputPad}\u0000${view.lifecycle}\u0000${progressPresentation}\u0000${message}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
+}
+function queuedInputText(submissions, presentation) {
+    if (submissions.length === 0)
+        return "";
+    const theme = piTheme();
+    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();
+    const instructions = [
+        rawKeyHint("escape", "interrupt"),
+        rawKeyHint("ctrl+c/ctrl+d", "clear/exit"),
+        rawKeyHint("/", "commands"),
+        rawKeyHint("!", "bash"),
+        rawKeyHint("ctrl+o", "more"),
+    ].join(theme.fg("muted", " · "));
+    const logo = theme.bold(theme.fg("accent", "pi")) + theme.fg("dim", ` v${VERSION}`);
+    const compactOnboarding = theme.fg("dim", "Press ctrl+o to show full startup help and loaded resources.");
+    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(bindings) {
+    const keys = bindings === undefined ? undefined : KeybindingsManager.fromOwnedBindings(bindings);
+    const instructions = [
+        rawKeyHint("escape", "to interrupt"),
+        rawKeyHint("ctrl+c", "to clear"),
+        rawKeyHint("ctrl+c twice", "to exit"),
+        rawKeyHint("ctrl+d", "to exit (empty)"),
+        rawKeyHint(process.platform === "win32" ? "" : "ctrl+z", "to suspend"),
+        rawKeyHint("ctrl+k", "to delete to end"),
+        rawKeyHint(keys?.getKeys("app.thinking.cycle").join("/") ?? "shift+tab", "to cycle thinking level"),
+        rawKeyHint("ctrl+p/shift+ctrl+p", "to cycle models"),
+        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"),
+        rawKeyHint("/", "for commands"),
+        rawKeyHint("!", "to run bash"),
+        rawKeyHint("!!", "to run bash (no context)"),
+        rawKeyHint("alt+enter", "to queue follow-up"),
+        rawKeyHint("alt+up", "to edit all queued messages"),
+        rawKeyHint(process.platform === "win32" ? "alt+v" : "ctrl+v", "to paste image (with text fallback)"),
+        rawKeyHint("drop files", "to attach"),
+    ].join("\n");
+    const theme = piTheme();
+    const logo = theme.bold(theme.fg("accent", "pi")) + theme.fg("dim", ` v${VERSION}`);
+    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\n${onboarding}`;
+}
+function noticeText(notice) {
+    const theme = piTheme();
+    if (notice.kind === "info")
+        return theme.fg("dim", notice.message);
+    const prefix = notice.kind === "warning" ? "Warning" : "Error";
+    return theme.fg(notice.kind, `${prefix}: ${notice.message}`);
+}

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

@@ -0,0 +1,43 @@
+import { type KeybindingsConfig } from "@earendil-works/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;

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

@@ -0,0 +1,114 @@
+import { DynamicBorder, getMarkdownTheme } from "../startup-public.js";
+import { Container, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
+import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
+import { PINNED_PI_LAYOUT, piTheme } from "./theme.js";
+import { componentPort, ensureTheme, formatSessionTokens } from "./shell-shared-facade.js";
+export function renderPiShellStatusText(message, width, outputPad = PINNED_PI_LAYOUT.outputPad) {
+    ensureTheme();
+    return new Text(piTheme().fg("dim", message), outputPad, 0).render(width);
+}
+export function renderPiShellCommandMessage(presentation, width, outputPad = PINNED_PI_LAYOUT.outputPad) {
+    ensureTheme();
+    const { kind, message, detail } = presentation;
+    const prefix = kind === "error" ? "Error: " : kind === "warning" ? "Warning: " : "";
+    const color = kind === "name" ? "dim" : kind === "error" || kind === "warning" ? kind : "accent";
+    const content = piTheme().fg(color, `${prefix}${message}`)
+        + (kind === "debug" && detail ? `\n${piTheme().fg("muted", detail)}` : "");
+    // Compatibility: pinned errors honor outputPad; warnings and command notices retain
+    // one-cell padding. New-session/debug notices also own one vertical padding row.
+    const text = new Text(content, kind === "error" ? outputPad : 1, kind === "new" || kind === "debug" ? 1 : 0);
+    return [
+        ...(kind === "name" && detail ? renderPiShellCommandMessage({ kind: "warning", message: detail }, width) : []),
+        ...new Spacer(1).render(width),
+        ...text.render(width),
+    ];
+}
+export function createPiShellSessionInfo(presentation) {
+    ensureTheme();
+    const { stats, sessionName, cacheWaste, usageBreakdown } = presentation;
+    let info = `${piTheme().bold("Session Info")}\n\n`;
+    if (sessionName)
+        info += `${piTheme().fg("dim", "Name:")} ${sessionName}\n`;
+    info += `${piTheme().fg("dim", "File:")} ${stats.sessionFile ?? "In-memory"}\n${piTheme().fg("dim", "ID:")} ${stats.sessionId}\n\n`;
+    info += `${piTheme().bold("Messages")}\n${piTheme().fg("dim", "Total:")} ${stats.totalMessages}\n${piTheme().fg("dim", "User:")} ${stats.userMessages}\n`;
+    info += `${piTheme().fg("dim", "Assistant:")} ${stats.assistantMessages}\n${piTheme().fg("dim", "Tools:")} ${stats.toolCalls} calls, ${stats.toolResults} results\n\n`;
+    info += `${piTheme().bold("Tokens")}\n`;
+    const { input, cacheRead, cacheWrite } = stats.tokens;
+    const promptTokens = input + cacheRead + cacheWrite;
+    info += `${piTheme().fg("dim", "Input:")} ${promptTokens.toLocaleString()}\n`;
+    if (promptTokens > 0 && (cacheRead > 0 || cacheWrite > 0)) {
+        info += `  ${piTheme().fg("dim", "Cached:")} ${cacheRead.toLocaleString()} ${piTheme().fg("dim", `(${((cacheRead / promptTokens) * 100).toFixed(1)}%)`)}\n`;
+        const written = cacheWrite > 0 ? ` ${piTheme().fg("dim", `(${cacheWrite.toLocaleString()} written to cache)`)}` : "";
+        info += `  ${piTheme().fg("dim", "Uncached:")} ${(input + cacheWrite).toLocaleString()}${written}\n`;
+    }
+    info += `${piTheme().fg("dim", "Output:")} ${stats.tokens.output.toLocaleString()}\n${piTheme().fg("dim", "Total:")} ${stats.tokens.total.toLocaleString()}\n`;
+    if (stats.cost > 0 || cacheWaste.missedTokens > 0) {
+        info += `\n${piTheme().bold("Cost")}\n${piTheme().fg("dim", "Total:")} $${stats.cost.toFixed(3)}`;
+        if (usageBreakdown.length > 1)
+            for (const entry of usageBreakdown)
+                info += `\n  ${piTheme().fg("dim", `${entry.key}:`)} $${entry.cost.toFixed(3)} ${piTheme().fg("dim", `(${formatSessionTokens(entry.tokens)} tokens)`)}`;
+        if (cacheWaste.missedTokens > 0) {
+            const detail = `${cacheWaste.missedTokens.toLocaleString()} tokens, ${cacheWaste.missCount === 1 ? "1 miss" : `${cacheWaste.missCount} misses`}`;
+            info += cacheWaste.missedCost >= 0.0001 ? `\n${piTheme().fg("dim", "Cache Re-billed:")} $${cacheWaste.missedCost.toFixed(3)} ${piTheme().fg("dim", `(${detail})`)}` : `\n${piTheme().fg("dim", "Cache Re-billed:")} ${detail}`;
+        }
+    }
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new Text(info, 1, 0));
+    return componentPort(container);
+}
+export function createPiShellCollapsedChangelog() {
+    ensureTheme();
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder());
+    container.addChild(new Text(`${piTheme().bold(piTheme().fg("accent", "What's New"))}\n${piTheme().fg("muted", "Run /changelog to view the full release notes.")}`, 1, 0));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}
+export function createPiShellChangelog(markdown) {
+    ensureTheme();
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder());
+    container.addChild(new Text(piTheme().bold(piTheme().fg("accent", "What's New")), 1, 0));
+    container.addChild(new Spacer(1));
+    container.addChild(new Markdown(markdown.trim() || "No changelog entries found.", 1, 1, getMarkdownTheme()));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}
+function shortcutDisplay(key) {
+    // Platform: pinned Pi labels Alt as Option on macOS, including extension shortcuts.
+    return key.split("/").map(binding => binding.split("+").map(part => {
+        const label = process.platform === "darwin" && part.toLowerCase() === "alt" ? "option" : part;
+        return label.charAt(0).toUpperCase() + label.slice(1);
+    }).join("+")).join("/");
+}
+export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi") {
+    ensureTheme();
+    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 => {
+        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) {
+        markdown += "\n\n**Extensions**\n| Key | Action |\n|-----|--------|\n";
+        markdown += shortcuts.map(shortcut => `| \`${shortcutDisplay(shortcut.key)}\` | ${shortcut.description} |`).join("\n");
+    }
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder());
+    container.addChild(new Text(piTheme().bold(piTheme().fg("accent", "Keyboard Shortcuts")), 1, 0));
+    container.addChild(new Spacer(1));
+    container.addChild(new Markdown(markdown, 1, 1, getMarkdownTheme()));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}

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

@@ -0,0 +1,29 @@
+import { AssistantMessageComponent } from "../startup-public.js";
+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 { isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, 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, 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
+ * the banner: the whole line, prefix included, in chalk's basic ANSI severity
+ * colour — not the theme's tokens — with info lines dim and unprefixed.
+ */
+export declare function renderPiShellStartupDiagnostic(diagnostic: {
+    readonly severity: "info" | "warning" | "error";
+    readonly message: string;
+}, width: number): readonly string[];
+/**
+ * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
+ * borders around a bold warning title, the muted update instruction with the
+ * accent command, and the package list.
+ */
+export declare function renderPiShellPackageUpdateNotice(packages: readonly string[], width: number): readonly string[];
+type PiAssistantMessage = NonNullable<ConstructorParameters<typeof AssistantMessageComponent>[0]>;
+export declare function validatedAssistantMessage(block: OwnedUiTranscriptBlock): PiAssistantMessage;