@timurproko/a1 0.1.8-dev.21b95d6 → 0.1.8-dev.226

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

@@ -1,7 +1,8 @@
 import { getSelectListTheme } from "@earendil-works/pi-coding-agent";
-import { CombinedAutocompleteProvider, setKeybindings, } from "#pi-tui";
+import { CombinedAutocompleteProvider, matchesKey, setKeybindings, } from "#pi-tui";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { OwnedEditor } from "./upstream/components/owned-editor.js";
+import { OwnedEditorUxInterception, createPromptSelectionInterceptor, } from "./owned-editor-ux.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { createTuiFacade, ensureTheme, isAutocompleteProvider, } from "./shell-shared-facade.js";
 export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
@@ -31,7 +32,9 @@ export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
 export function createPiShellEditor(options) {
     ensureTheme();
     const tui = createTuiFacade(options);
-    const keybindings = KeybindingsManager.create(options.agentDir);
+    const keybindings = options.keybindingProfile === "a1"
+        ? KeybindingsManager.createForOwnedInput(options.agentDir)
+        : KeybindingsManager.create(options.agentDir);
     setKeybindings(keybindings);
     const editor = new OwnedEditor(tui, {
         borderColor: (value) => piTheme().fg("borderMuted", value),
@@ -40,6 +43,24 @@ export function createPiShellEditor(options) {
         paddingX: PINNED_PI_LAYOUT.editorPaddingX,
         autocompleteMaxVisible: PINNED_PI_LAYOUT.autocompleteMaxVisible,
     });
+    const editorUx = options.keybindingProfile === "a1"
+        ? new OwnedEditorUxInterception([
+            createPromptSelectionInterceptor(editor, keybindings, {
+                copyText: options.onCopyText ?? (() => { }),
+                readClipboardContent: options.readClipboardContent ?? (async () => null),
+                transformPastedContent: options.transformPastedContent ?? (content => content.kind === "text" ? content.text : ""),
+                atomicRanges: options.editorAtomicRanges ?? (() => []),
+                expandCopiedText: options.expandCopiedEditorText ?? (text => text),
+                paintSelection: options.paintEditorSelection ?? (line => line),
+                decorateRow: options.decorateEditorRow ?? (row => row),
+                requestRender: options.requestRender,
+                getRows: options.getRows,
+            }),
+        ], {
+            render: width => editor.render(width),
+            handleInput: data => editor.handleInput(data),
+        })
+        : undefined;
     let thinkingLevel = "off";
     let isBashMode = false;
     const updateBorderColor = () => {
@@ -108,15 +129,28 @@ export function createPiShellEditor(options) {
     if (options.onDequeue !== undefined)
         editor.onAction("app.message.dequeue", options.onDequeue);
     return {
-        render: width => editor.render(width),
-        handleInput: data => editor.handleInput(data),
+        render: width => editorUx?.render(width) ?? editor.render(width),
+        activateKeybindings: () => setKeybindings(keybindings),
+        matchesTerminalKey: (data, key) => matchesKey(data, key),
+        handleInput: data => {
+            if (editorUx === undefined)
+                editor.handleInput(data);
+            else
+                editorUx.handleInput(data);
+        },
         invalidate: () => editor.invalidate(),
         setFocused: focused => {
             editor.focused = focused;
         },
         getText: () => editor.getExpandedText(),
-        setText: text => editor.setText(text),
-        insertText: text => editor.insertTextAtCursor(text),
+        setText: text => {
+            editorUx?.reset();
+            editor.setText(text);
+        },
+        insertText: text => {
+            editorUx?.reset();
+            editor.insertTextAtCursor(text);
+        },
         addToHistory: text => editor.addToHistory(text),
         setSubmitEnabled: enabled => {
             editor.disableSubmit = !enabled;
@@ -124,6 +158,16 @@ export function createPiShellEditor(options) {
         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");
@@ -139,6 +183,10 @@ export function createPiShellEditor(options) {
             thinkingLevel = level;
             updateBorderColor();
         },
+        hasSelection: () => editorUx?.hasSelection() ?? false,
+        ownsPointer: () => editorUx?.ownsPointer() ?? false,
+        handlePointer: event => editorUx?.handlePointer(event) ?? false,
+        pasteClipboard: () => editorUx?.pasteClipboard() ?? false,
     };
 }
 function autocompleteCommand(command, addition) {

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 createPiShellStatus(view: OwnedUiSessionViewModel, formatProgressStatus: (message: string) => string, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
 export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string): PiShellViewComponentPort;
-export declare function createPiQueuedInputStatus(submissions: readonly string[]): PiShellQueuedInputPort;
+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

@@ -67,20 +67,21 @@ 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 component = statusComponent(view, statusUi, workingOverride, outputPad, formatProgressStatus);
+    let signature = statusSignature(view, workingOverride, outputPad);
     const rebuild = () => {
-        const nextSignature = statusSignature(view, workingOverride);
+        const nextSignature = statusSignature(view, workingOverride, outputPad);
         if (nextSignature === signature)
             return;
         if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
             component.dispose();
         signature = nextSignature;
-        component = statusComponent(view, statusUi, workingOverride);
+        component = statusComponent(view, statusUi, workingOverride, outputPad, formatProgressStatus);
     };
     return {
         render: width => component?.render(width) ?? [],
@@ -93,6 +94,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();
@@ -110,34 +115,44 @@ 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) {
-    if (view.lifecycle === "busy")
-        return new WorkingStatusIndicator(ui, workingOverride ?? view.status.workingMessage ?? "Working...");
+function statusComponent(view, ui, workingOverride, outputPad, formatProgressStatus) {
+    if (view.lifecycle === "busy") {
+        return new WorkingStatusIndicator(ui, formatProgressStatus(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 new Text(piTheme().fg("error", view.status.diagnostics.at(-1) ?? "Session failed"), outputPad, 0);
     }
     if (view.status.workingMessage !== null) {
-        return new Text(piTheme().fg("muted", view.status.workingMessage), PINNED_PI_LAYOUT.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) {
+    return `${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();

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

@@ -0,0 +1,36 @@
+import { type PiShellComponentPort } 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 declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
+export declare function createPiShellCollapsedChangelog(): PiShellComponentPort;
+export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;
+export declare function createPiShellHotkeys(): PiShellComponentPort;

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

@@ -0,0 +1,78 @@
+import { DynamicBorder, getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import { Container, Markdown, Spacer, Text } from "#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 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);
+}
+export function createPiShellHotkeys() {
+    ensureTheme();
+    const keys = new KeybindingsManager();
+    const display = (action) => keys.getKeys(action).map(key => key.split("+").map(part => part.charAt(0).toUpperCase() + part.slice(1)).join("+")).join("/");
+    const row = (actions, description) => `| ${actions.map(action => `\`${display(action)}\``).join(" / ")} | ${description} |`;
+    const 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"], "Start of line"), row(["tui.editor.cursorLineEnd"], "End of line"), 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 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,25 @@
+import { AssistantMessageComponent } from "@earendil-works/pi-coding-agent";
+import { type MermaidRenderingMode } from "./upstream/components/mermaid.js";
+import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
+import { type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
+export type { PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
+import { type PiShellExtensionRendererResolver, type PiShellImageAssetResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
+export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer, initialOutputPad?: 0 | 1, initialHideThinkingBlock?: boolean, initialMermaidRenderingMode?: MermaidRenderingMode, initialShowImages?: boolean, initialImageWidthCells?: number, imageAssets?: PiShellImageAssetResolver): PiShellTranscriptComponentPort;
+export declare function 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;