@timurproko/a1 0.1.8-dev.de7821a → 0.2.0

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

@@ -0,0 +1,8 @@
+import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.js";
+import { type KeybindingsConfig } from "./upstream/adjacent/core/keybindings.js";
+import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellProgressStatusPresentation, 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, progressStatus: PiShellProgressStatusPresentation, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
+export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", showLevel?: () => boolean): PiShellViewComponentPort;
+export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport", getKeybindings?: () => KeybindingsConfig): PiShellQueuedInputPort;

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

@@ -0,0 +1,287 @@
+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 { StatusIndicator, 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, progressStatus, 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 = () => progressStatus.text(liveWorkingText(view, workingOverride, progressPresentation), progressPresentation);
+    let component = statusComponent(view, statusUi, outputPad, liveStatusText, placement, progressPresentation, progressStatus);
+    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.
+        const componentMatchesPresentation = progressPresentation === "custom-viewport"
+            ? component instanceof OwnedWorkingStatusIndicator
+            : component instanceof WorkingStatusIndicator;
+        if (placement === "live" && nextPlacement === "live" && component instanceof StatusIndicator && componentMatchesPresentation
+            && 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, progressPresentation, progressStatus);
+    };
+    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", showLevel = () => true) {
+    ensureTheme();
+    const footer = new SessionFooter(() => view, cwd, profile, showLevel);
+    return {
+        render: width => footer.render(width),
+        invalidate: () => footer.invalidate(),
+        update(next) { view = next; },
+        dispose: () => footer.dispose(),
+    };
+}
+export function createPiQueuedInputStatus(submissions, presentation = "pinned", getKeybindings) {
+    let renderedText = queuedInputText(submissions, presentation, getKeybindings?.());
+    const text = new Text(renderedText, 1, 0);
+    const refresh = () => {
+        const next = queuedInputText(submissions, presentation, getKeybindings?.());
+        if (next === renderedText)
+            return;
+        renderedText = next;
+        text.setText(next);
+    };
+    return {
+        render(width) {
+            if (submissions.length === 0)
+                return [];
+            refresh();
+            return text.render(width);
+        },
+        invalidate: () => text.invalidate(),
+        update(next) {
+            submissions = next;
+            refresh();
+        },
+    };
+}
+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;
+}
+class OwnedWorkingStatusIndicator extends StatusIndicator {
+    constructor(ui, message, frame) {
+        let phase = -1;
+        super("working", ui, spinner => {
+            phase += 1;
+            return piTheme().fg("accent", spinner);
+        }, text => frame(text, phase, {
+            muted: value => piTheme().fg("muted", value),
+            accent: value => piTheme().fg("accent", value),
+        }), message);
+    }
+}
+function statusComponent(view, ui, outputPad, liveStatusText, placement, progressPresentation, progressStatus) {
+    if (placement === "live") {
+        return progressPresentation === "custom-viewport"
+            ? new OwnedWorkingStatusIndicator(ui, liveStatusText(), progressStatus.frame)
+            : 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, bindings) {
+    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 keys = KeybindingsManager.fromOwnedBindings(bindings).getKeys("app.message.dequeue");
+    const label = keys.length === 0 ? "Unbound" : keys.map(displayKeybinding).join("/");
+    const dequeueHint = theme.fg("dim", `↳ ${label} 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 displayKeybinding(key) {
+    return key.split("+").map(part => {
+        const display = process.platform === "darwin" && part.toLowerCase() === "alt" ? "option" : part;
+        return display.charAt(0).toUpperCase() + display.slice(1);
+    }).join("+");
+}
+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"),
+        // Invariant: only bare A1 supplies live bindings, and its unbound fallback is the unified `/models` command.
+        rawKeyHint(keys === undefined ? "ctrl+l" : keys.getKeys("app.model.select").join("/") || "/models", "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(keys === undefined ? "alt+up" : keys.getKeys("app.message.dequeue").join("/") || "unbound", "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-hotkey-sections.d.ts

@@ -0,0 +1,7 @@
+import { type PiShellHotkeysPresentation } from "./shell-presenters-info.js";
+export interface PiShellHotkeySection {
+    readonly title: string;
+    readonly rows: readonly string[];
+}
+/** Turns heading-led hotkeys Markdown into reusable grouped-document data before row rendering. */
+export declare function renderPiShellHotkeySections(presentation: PiShellHotkeysPresentation, width: number): readonly PiShellHotkeySection[];

package/dist/integrations/pi/components/shell-hotkey-sections.js

@@ -0,0 +1,29 @@
+import { getMarkdownTheme } from "../startup-public.js";
+import { Markdown } from "@earendil-works/pi-tui";
+import { ensureTheme } from "./shell-shared-facade.js";
+import { hotkeysMarkdown } from "./shell-presenters-info.js";
+/** Turns heading-led hotkeys Markdown into reusable grouped-document data before row rendering. */
+export function renderPiShellHotkeySections(presentation, width) {
+    ensureTheme();
+    const shortcuts = presentation.getShortcuts ?? (() => []);
+    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi");
+    const sections = [];
+    for (const line of markdown.split("\n")) {
+        const heading = /^\*\*(.+)\*\*$/.exec(line)?.[1];
+        if (heading !== undefined)
+            sections.push({ title: heading, lines: [] });
+        else
+            sections.at(-1)?.lines.push(line);
+    }
+    for (const section of sections)
+        while (section.lines.at(-1) === "")
+            section.lines.pop();
+    return sections.map(section => {
+        const rows = [...new Markdown(section.lines.join("\n"), 1, 1, getMarkdownTheme()).render(width)];
+        while (rows[0]?.trim().length === 0)
+            rows.shift();
+        while (rows.at(-1)?.trim().length === 0)
+            rows.pop();
+        return { title: section.title, rows };
+    });
+}

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

@@ -0,0 +1,73 @@
+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;
+    }[];
+    readonly cacheWarming: PiShellCacheWarmingPresentation;
+}
+export interface PiShellCacheWarmingPresentation {
+    readonly mode: string;
+    readonly status?: {
+        readonly state: "inactive" | "scheduled" | "refreshing";
+        readonly reason?: string;
+        readonly nextWarmAt?: number;
+        readonly extensionOverride?: boolean;
+        readonly decision?: {
+            readonly phase: "streaming" | "idle";
+            readonly action: string;
+            readonly warmCost: number;
+            readonly missCost: number;
+            readonly continuationProbability: number;
+            readonly expectedSavings: number;
+            readonly economicsAvailable: boolean;
+        };
+    };
+}
+export 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;
+/** The changelog document rows the feed presenter shows, without its spacer, borders, and heading. */
+export declare function renderPiShellChangelogLines(markdown: string, width: number): readonly string[];
+/** What the hotkeys presenters render: the editor bindings and the extension shortcuts declared over them. */
+export interface PiShellHotkeysPresentation {
+    readonly bindings?: KeybindingsConfig;
+    readonly getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>;
+    readonly profile?: "pi" | "a1";
+}
+export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;
+/** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
+export declare function renderPiShellHotkeysLines(presentation: PiShellHotkeysPresentation, width: number): readonly string[];
+export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1"): string;

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

@@ -0,0 +1,188 @@
+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),
+    ];
+}
+const CACHE_WARMING_MINIMUM_EXPECTED_SAVINGS = 0.05;
+function formatWarmingDollars(value) {
+    return value < 0 ? `-${Math.abs(value).toFixed(3)}` : `${value.toFixed(3)}`;
+}
+function formatWarmingEconomics(decision) {
+    if (!decision.economicsAvailable)
+        return "cache economics unavailable";
+    const probability = Math.round(decision.continuationProbability * 100);
+    const probabilityText = decision.phase === "streaming"
+        ? `${probability}% continuation probability while agent is running`
+        : `${probability}% continuation probability`;
+    const comparison = decision.action === "warm" ? ">=" : "<";
+    return `${probabilityText}, expected savings ${formatWarmingDollars(decision.expectedSavings)} ${comparison} ${CACHE_WARMING_MINIMUM_EXPECTED_SAVINGS.toFixed(3)}`;
+}
+function formatWarmingDecisionTime(nextWarmAt, now) {
+    if (nextWarmAt === undefined || nextWarmAt <= now)
+        return "Decision now";
+    let remainingSeconds = Math.ceil((nextWarmAt - now) / 1000);
+    const hours = Math.floor(remainingSeconds / 3600);
+    remainingSeconds %= 3600;
+    const minutes = Math.floor(remainingSeconds / 60);
+    const seconds = remainingSeconds % 60;
+    const parts = [];
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    if (minutes > 0)
+        parts.push(`${minutes}m`);
+    if (seconds > 0 || parts.length === 0)
+        parts.push(`${seconds}s`);
+    return `Decision in ${parts.join(" ")}`;
+}
+/** The one-line warming status the pinned session report shows; a decision is attached once warming acted. */
+function formatCacheWarmingStatus(status, now = Date.now()) {
+    const decision = status.decision;
+    if (!decision || (status.state === "inactive" && !decision.economicsAvailable && !status.extensionOverride)) {
+        return `Inactive (${status.reason ?? "unknown reason"})`;
+    }
+    const details = status.extensionOverride
+        ? `extension override, ${formatWarmingEconomics(decision)}`
+        : `${formatWarmingEconomics(decision)} -> ${decision.action}`;
+    if (status.state === "inactive")
+        return `Stopped (${details})`;
+    if (status.state === "refreshing")
+        return `Warming cache (${details})`;
+    return `${formatWarmingDecisionTime(status.nextWarmAt, now)} (${details})`;
+}
+export function createPiShellSessionInfo(presentation) {
+    ensureTheme();
+    const { stats, sessionName, cacheWaste, usageBreakdown, cacheWarming } = 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`;
+    const warmingStatus = cacheWarming.status;
+    info += `\n${piTheme().bold("Cache Warming")}\n${piTheme().fg("dim", "Mode:")} ${cacheWarming.mode}\n`;
+    info += `${piTheme().fg("dim", "Status:")} ${warmingStatus ? formatCacheWarmingStatus(warmingStatus) : "Inactive (cache warming unavailable)"}\n`;
+    const warmingDecision = warmingStatus?.decision;
+    if (warmingDecision?.economicsAvailable) {
+        info += `${piTheme().fg("dim", "Cache miss penalty:")} $${warmingDecision.missCost.toFixed(3)}\n`;
+        info += `${piTheme().fg("dim", "Refresh cost:")} $${warmingDecision.warmCost.toFixed(3)}\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(changelogMarkdown(markdown));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}
+/** The changelog document rows the feed presenter shows, without its spacer, borders, and heading. */
+export function renderPiShellChangelogLines(markdown, width) {
+    ensureTheme();
+    return changelogMarkdown(markdown).render(width);
+}
+function changelogMarkdown(markdown) {
+    return new Markdown(markdown.trim() || "No changelog entries found.", 1, 1, getMarkdownTheme());
+}
+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 markdown = hotkeysMarkdown(bindings, getShortcuts, profile);
+    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(hotkeysMarkdownComponent(markdown));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}
+/** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
+export function renderPiShellHotkeysLines(presentation, width) {
+    ensureTheme();
+    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi")).render(width);
+}
+function hotkeysMarkdownComponent(markdown) {
+    return new Markdown(markdown, 1, 1, getMarkdownTheme());
+}
+export function hotkeysMarkdown(bindings, getShortcuts, profile) {
+    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 (`/models`)" : "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"], profile === "a1" ? "Open the Models dialog" : "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 selection or 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) |", ...(profile === "a1" ? ["", "**Models dialog**", "| Key | Action |", "|-----|--------|", "| `Space` | Toggle the selected model in the cycling scope |", "| `Tab` | Switch the all/scoped filter |", row(["app.models.save"], "Save the scope to settings"), row(["app.models.enableAll"], "Scope every listed model"), row(["app.models.clearAll"], "Clear the listed models from the scope"), row(["app.models.toggleProvider"], "Toggle the selected model's provider"), row(["app.models.reorderUp", "app.models.reorderDown"], "Reorder the cycling scope")] : [])].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");
+    }
+    return markdown;
+}

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;