@timurproko/a1 0.1.8-dev.235df0e → 0.1.8-dev.260

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

@@ -1,146 +1,106 @@
 import { AssistantMessageComponent, BashExecutionComponent, CompactionSummaryMessageComponent, CustomMessageComponent, DynamicBorder, getMarkdownTheme, parseSkillBlock, ToolExecutionComponent, UserMessageComponent, } from "@earendil-works/pi-coding-agent";
-import { SkillInvocationMessageComponent, } from "./upstream/components/skill-invocation-message.js";
-import { Container, Markdown, Spacer, Text, } from "#pi-tui";
-import { PRODUCT_TEXT } from "../../product-identity.js";
-import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
+import { SkillInvocationMessageComponent } from "./upstream/components/skill-invocation-message.js";
+import { createMermaidMarkdownTransformer } from "./upstream/components/mermaid.js";
+import { Container, Image, Spacer, Text, } from "#pi-tui";
+import { PRODUCT_TEXT } from "../../../product-identity.js";
+import { createPiSubmittedPromptComponent, } from "./submitted-prompt-adapter.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
-import { componentPort, createTuiFacade, ensureTheme, formatSessionTokens, isRecord, } from "./shell-shared-facade.js";
-export function renderPiShellStatusText(message, width) {
-    ensureTheme();
-    return new Text(piTheme().fg("dim", message), PINNED_PI_LAYOUT.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`;
-    info += `${piTheme().fg("dim", "ID:")} ${stats.sessionId}\n\n`;
-    info += `${piTheme().bold("Messages")}\n`;
-    info += `${piTheme().fg("dim", "Total:")} ${stats.totalMessages}\n`;
-    info += `${piTheme().fg("dim", "User:")} ${stats.userMessages}\n`;
-    info += `${piTheme().fg("dim", "Assistant:")} ${stats.assistantMessages}\n`;
-    info += `${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)) {
-        const hitRate = piTheme().fg("dim", `(${((cacheRead / promptTokens) * 100).toFixed(1)}%)`);
-        info += `  ${piTheme().fg("dim", "Cached:")} ${cacheRead.toLocaleString()} ${hitRate}\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`;
-    info += `${piTheme().fg("dim", "Total:")} ${stats.tokens.total.toLocaleString()}\n`;
-    if (stats.cost > 0 || cacheWaste.missedTokens > 0) {
-        info += `\n${piTheme().bold("Cost")}\n`;
-        info += `${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 missLabel = cacheWaste.missCount === 1 ? "1 miss" : `${cacheWaste.missCount} misses`;
-            const detail = `${cacheWaste.missedTokens.toLocaleString()} tokens, ${missLabel}`;
-            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 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);
-}
-export function createPiShellTranscriptComponent(initial, cwd, extensions) {
+import { componentPort, createTuiFacade, ensureTheme, isRecord, } from "./shell-shared-facade.js";
+export function createPiShellTranscriptComponent(initial, cwd, extensions, submittedPrompt, initialOutputPad = PINNED_PI_LAYOUT.outputPad, initialHideThinkingBlock = false, initialMermaidRenderingMode = "off", initialShowImages = true, initialImageWidthCells = 80, imageAssets) {
     ensureTheme();
     let block = initial;
     let expanded = false;
-    let component = transcriptComponent(block, cwd, expanded, extensions);
+    let outputPad = initialOutputPad;
+    let hideThinkingBlock = initialHideThinkingBlock;
+    let mermaidRenderingMode = initialMermaidRenderingMode;
+    let showImages = initialShowImages;
+    let imageWidthCells = initialImageWidthCells;
+    const rebuild = () => withTranscriptImages(transcriptComponent(block, cwd, expanded, extensions, submittedPrompt, outputPad, hideThinkingBlock, mermaidRenderingMode, showImages, imageWidthCells), block, imageAssets, showImages, imageWidthCells);
+    let component = rebuild();
     return {
         get id() { return block.id; },
         get revision() { return block.revision; },
-        render: width => component.render(width),
+        render: width => renderWithOutputPad(component, block.kind, width, outputPad),
         invalidate: () => component.invalidate(),
         update(next) {
             if (next.id !== block.id)
                 throw new TypeError("Pi transcript component identity cannot change");
             const previous = block;
             block = next;
-            if (!updateTranscriptComponent(component, previous, next, expanded)) {
-                component = transcriptComponent(block, cwd, expanded, extensions);
-            }
+            if (!updateTranscriptComponent(component, previous, next, expanded))
+                component = rebuild();
         },
         setExpanded(next) {
             if (expanded === next)
                 return;
             expanded = next;
-            if ("setExpanded" in component && typeof component.setExpanded === "function") {
+            if ("setExpanded" in component && typeof component.setExpanded === "function")
                 component.setExpanded(expanded);
+            else
+                component = rebuild();
+        },
+        setOutputPad(padding) {
+            if (outputPad === padding)
+                return;
+            outputPad = padding;
+            component = rebuild();
+        },
+        setHideThinkingBlock(hidden) {
+            if (hideThinkingBlock === hidden)
+                return;
+            hideThinkingBlock = hidden;
+            component = rebuild();
+        },
+        setMermaidRenderingMode(mode) {
+            if (mermaidRenderingMode === mode)
+                return;
+            mermaidRenderingMode = mode;
+            component = rebuild();
+        },
+        setImagePresentation(show, width) {
+            showImages = show;
+            imageWidthCells = width;
+            if (component instanceof ToolExecutionComponent) {
+                component.setShowImages(show);
+                component.setImageWidthCells(width);
             }
-            else {
-                component = transcriptComponent(block, cwd, expanded, extensions);
-            }
+            else
+                component = rebuild();
         },
     };
 }
+function withTranscriptImages(component, block, assets, showImages, imageWidthCells) {
+    const references = block.imageReferences ?? [];
+    if (references.length === 0)
+        return component;
+    const container = new Container();
+    container.addChild(component);
+    for (const reference of references) {
+        container.addChild(new Spacer(1));
+        const asset = assets?.resolve(reference.assetId) ?? null;
+        if (!showImages) {
+            container.addChild(new Text(piTheme().fg("muted", `[Image hidden: ${reference.mimeType}, ${reference.byteLength} bytes]`), 1, 0));
+        }
+        else if (asset === null) {
+            container.addChild(new Text(piTheme().fg("warning", `[Image unavailable: ${reference.mimeType}]`), 1, 0));
+        }
+        else {
+            container.addChild(new Image(asset.data, asset.mimeType, {
+                fallbackColor: text => piTheme().fg("muted", text),
+            }, { maxWidthCells: imageWidthCells, filename: reference.assetId }));
+        }
+    }
+    return container;
+}
+function renderWithOutputPad(component, kind, width, outputPad) {
+    const rows = component.render(width);
+    if (outputPad !== 0 || (kind !== "tool-call" && kind !== "tool-result" && kind !== "bash"))
+        return rows;
+    return rows.map(row => row.startsWith(" ") ? row.slice(1) : row);
+}
 export function renderPiShellTranscriptBlock(block, width, cwd) {
     ensureTheme();
-    return transcriptComponent(block, cwd, true).render(width);
+    return transcriptComponent(block, cwd, true, undefined, undefined, PINNED_PI_LAYOUT.outputPad, false, "off", true, 80).render(width);
 }
 /**
  * Pinned Pi's CLI prints startup diagnostics with `reportDiagnostics` before
@@ -175,12 +135,12 @@ export function renderPiShellPackageUpdateNotice(packages, width) {
     container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
     return container.render(width);
 }
-function transcriptComponent(block, cwd, expanded, extensions) {
+function transcriptComponent(block, cwd, expanded, extensions, submittedPrompt, outputPad, hideThinkingBlock, mermaidRenderingMode, showImages, imageWidthCells) {
     switch (block.kind) {
         case "user": {
             const skill = parseSkillBlock(block.text);
             if (!skill)
-                return new UserMessageComponent(block.text);
+                return submittedPrompt ? createPiSubmittedPromptComponent(block, submittedPrompt) : new UserMessageComponent(block.text);
             const invocation = new SkillInvocationMessageComponent(skill, getMarkdownTheme());
             invocation.setExpanded(expanded);
             if (!skill.userMessage)
@@ -193,10 +153,10 @@ function transcriptComponent(block, cwd, expanded, extensions) {
         }
         case "assistant":
         case "thinking":
-            return assistantComponent(block);
+            return assistantComponent(block, outputPad, hideThinkingBlock, mermaidRenderingMode);
         case "tool-call":
         case "tool-result": {
-            const component = toolComponent(block, cwd, extensions);
+            const component = toolComponent(block, cwd, extensions, showImages, imageWidthCells);
             component.setExpanded(expanded);
             return component;
         }
@@ -211,13 +171,13 @@ function transcriptComponent(block, cwd, expanded, extensions) {
             return component;
         }
         case "retry":
-            return new Text(piTheme().fg("warning", `Retry: ${block.text}`), PINNED_PI_LAYOUT.outputPad, 0);
+            return new Text(piTheme().fg("warning", `Retry: ${block.text}`), outputPad, 0);
         case "error":
-            return new Text(piTheme().fg("error", `Error: ${block.text}`), PINNED_PI_LAYOUT.outputPad, 0);
+            return new Text(piTheme().fg("error", `Error: ${block.text}`), outputPad, 0);
         case "system":
-            return new Text(piTheme().fg("dim", block.text), PINNED_PI_LAYOUT.outputPad, 0);
+            return new Text(piTheme().fg("dim", block.text), outputPad, 0);
         case "custom":
-            return customMessageComponent(block, expanded, extensions);
+            return customMessageComponent(block, expanded, extensions, outputPad);
         case "bash":
             return bashExecutionComponent(block, cwd, expanded);
     }
@@ -266,8 +226,9 @@ function updateTranscriptComponent(component, previous, next, expanded) {
     }
     return false;
 }
-function assistantComponent(block) {
-    const component = new AssistantMessageComponent(undefined, false, getMarkdownTheme(), undefined, PINNED_PI_LAYOUT.outputPad);
+function assistantComponent(block, outputPad, hideThinkingBlock, mermaidRenderingMode) {
+    const transformer = createMermaidMarkdownTransformer({ getMode: () => mermaidRenderingMode, theme: piTheme() });
+    const component = new AssistantMessageComponent(undefined, hideThinkingBlock, getMarkdownTheme(), undefined, outputPad, [transformer]);
     component.updateContent(validatedAssistantMessage(block), block.status === "live");
     return component;
 }
@@ -335,12 +296,12 @@ function validatedMessageRenderer(value) {
 function isPiMessageRenderer(value) {
     return typeof value === "function";
 }
-function toolComponent(block, cwd, extensions) {
+function toolComponent(block, cwd, extensions, showImages, imageWidthCells) {
     const payload = blockPayload(block);
     const toolCallId = stringPayload(payload, "toolCallId") ?? block.id;
     const toolName = stringPayload(payload, "toolName") ?? block.title ?? "tool";
     const argumentsPayload = toolArguments(payload);
-    const component = new ToolExecutionComponent(toolName, toolCallId, argumentsPayload, undefined, validatedToolDefinition(extensions?.getToolDefinition(toolName)), createTuiFacade({ getColumns: () => 80, getRows: () => 24, requestRender() { }, onSubmit() { } }), cwd);
+    const component = new ToolExecutionComponent(toolName, toolCallId, argumentsPayload, { showImages, imageWidthCells }, validatedToolDefinition(extensions?.getToolDefinition(toolName)), createTuiFacade({ getColumns: () => 80, getRows: () => 24, requestRender() { }, onSubmit() { } }), cwd);
     if (block.status === "live")
         component.markExecutionStarted();
     if (block.status === "finalized" || payload.argsComplete === true)
@@ -356,7 +317,7 @@ function toolComponent(block, cwd, extensions) {
     }
     return component;
 }
-function customMessageComponent(block, expanded, extensions) {
+function customMessageComponent(block, expanded, extensions, outputPad) {
     const payload = blockPayload(block);
     const message = {
         role: "custom",
@@ -367,7 +328,7 @@ function customMessageComponent(block, expanded, extensions) {
         timestamp: numericPayload(block, "timestamp") || 0,
     };
     const renderer = validatedMessageRenderer(extensions?.getMessageRenderer(message.customType));
-    const component = new CustomMessageComponent(message, renderer, getMarkdownTheme(), PINNED_PI_LAYOUT.outputPad);
+    const component = new CustomMessageComponent(message, renderer, getMarkdownTheme(), outputPad);
     component.setExpanded(expanded);
     return component;
 }

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

@@ -1,5 +1,5 @@
 import { ModelSelectorComponent, type SessionInfo, type SettingsCallbacks, type SettingsConfig } from "@earendil-works/pi-coding-agent";
-import type { OwnedUiDialog } from "../owned-ui-contracts/index.js";
+import type { OwnedUiDialog } from "../../../contracts/owned-ui/index.js";
 import { type TrustDecision, type TrustOption, type TrustUpdate } from "./upstream/components/trust-selector.js";
 import { type PiShellComponentPort, type PiShellEditorOptions, type PiShellSelectorOption, type PiShellSelectorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellSelector(options: PiShellSelectorOptions): PiShellComponentPort;
@@ -91,7 +91,10 @@ export declare function createPiShellLoginDialog(runtime: Pick<PiShellEditorOpti
 export declare function createPiShellArmin(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellComponentPort;
 export declare function createPiShellDaxnuts(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellComponentPort;
 export declare function createPiShellEarendilAnnouncement(): PiShellComponentPort;
-export declare function createPiShellOperationLoader(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellComponentPort;
+export interface PiShellOperationLoaderPort extends PiShellComponentPort {
+    readonly signal: AbortSignal;
+}
+export declare function createPiShellOperationLoader(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, message: string): PiShellOperationLoaderPort;
 export declare function createPiShellReloadBox(): PiShellComponentPort;
 export interface PiShellAuthProviderOption extends PiShellSelectorOption {
     readonly providerId: string;

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

@@ -148,7 +148,8 @@ export function createPiShellEarendilAnnouncement() {
 }
 export function createPiShellOperationLoader(runtime, message) {
     ensureTheme();
-    return componentPort(new BorderedLoader(createTuiFacade(runtime), piTheme(), message));
+    const loader = new BorderedLoader(createTuiFacade(runtime), piTheme(), message, { cancellable: true });
+    return { ...componentPort(loader), signal: loader.signal };
 }
 export function createPiShellReloadBox() {
     ensureTheme();

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

@@ -1,13 +1,34 @@
-import { type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
-import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../owned-ui-contracts/index.js";
-export interface PiShellComponentPort {
-    render(width: number): readonly string[];
-    handleInput?(data: string): void;
-    invalidate(): void;
-    setFocused?(focused: boolean): void;
-    dispose?(): void;
+import { visibleWidth, type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
+import type { OwnedUiImageAttachment, OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
+import type { PresentationComponentPort } from "../../../contracts/presentation/index.js";
+/** Terminal-cell width authority used by Pi-rendered component rows. */
+export declare const piShellVisibleWidth: typeof visibleWidth;
+export interface PiShellComponentPort extends PresentationComponentPort {
+}
+export type PiShellClipboardContent = {
+    readonly kind: "text";
+    readonly text: string;
+} | {
+    readonly kind: "image";
+    readonly data: string;
+    readonly mimeType: string;
+};
+export interface PiShellEditorTextRange {
+    readonly start: number;
+    readonly end: number;
+}
+export interface PiShellEditorPointerEvent {
+    readonly kind: "press" | "motion" | "release";
+    readonly button: number;
+    readonly column: number;
+    /** One-based row relative to the top of the editor component. */
+    readonly row: number;
 }
 export interface PiShellEditorPort extends PiShellComponentPort {
+    /** Restores this editor's profile after another Pi component changed the global manager. */
+    activateKeybindings(): void;
+    /** Uses Pi's terminal decoder rather than assuming one terminal escape spelling. */
+    matchesTerminalKey(data: string, key: "home" | "end" | "ctrl+v"): boolean;
     getText(): string;
     setText(text: string): void;
     insertText(text: string): void;
@@ -16,8 +37,14 @@ export interface PiShellEditorPort extends PiShellComponentPort {
     setSubmitHandler(handler: (text: string) => void): void;
     setInterruptHandler(handler: () => void): void;
     setAutocompleteCommands(commands: readonly PiShellAutocompleteCommand[]): void;
+    setPaddingX(padding: number): void;
+    setAutocompleteMaxVisible(maxVisible: number): void;
     addAutocompleteProvider(factory: unknown): void;
     setThinkingLevel(level: OwnedUiThinkingLevel): void;
+    hasSelection(): boolean;
+    ownsPointer(): boolean;
+    handlePointer(event: PiShellEditorPointerEvent): boolean;
+    pasteClipboard(): boolean;
 }
 export interface PiShellAutocompleteCommand {
     readonly name: string;
@@ -28,8 +55,14 @@ export interface PiShellAutocompleteCommand {
 export interface PiShellViewComponentPort extends PiShellComponentPort {
     update(view: OwnedUiSessionViewModel): void;
 }
+export type PiShellStatusPlacement = "live" | "dock" | "hidden";
 export interface PiShellStatusPort extends PiShellViewComponentPort {
     setWorkingOverride(message: string | undefined): void;
+    setOutputPad(padding: 0 | 1): void;
+    /** Semantic row placement; callers must not inspect rendered text. */
+    placement(): PiShellStatusPlacement;
+    renderDock(width: number): readonly string[];
+    renderLive(width: number): readonly string[];
 }
 export interface PiShellQueuedInputPort extends PiShellComponentPort {
     update(submissions: readonly string[]): void;
@@ -48,6 +81,9 @@ export interface PiShellResourceEntry {
 export interface PiShellLoadedResourcesPort extends PiShellComponentPort {
     setExpanded(expanded: boolean): void;
 }
+export interface PiShellImageAssetResolver {
+    resolve(assetId: string): OwnedUiImageAttachment | null;
+}
 export interface PiShellExtensionRendererResolver {
     getMessageRenderer(customType: string): unknown;
     getToolDefinition(toolName: string): unknown;
@@ -57,6 +93,10 @@ export interface PiShellTranscriptComponentPort extends PiShellComponentPort {
     readonly revision: number;
     update(block: OwnedUiTranscriptBlock): void;
     setExpanded(expanded: boolean): void;
+    setOutputPad(padding: 0 | 1): void;
+    setHideThinkingBlock(hidden: boolean): void;
+    setMermaidRenderingMode(mode: "off" | "final" | "streaming"): void;
+    setImagePresentation(showImages: boolean, imageWidthCells: number): void;
 }
 export interface PiShellStartupNotice {
     readonly kind: "info" | "warning" | "error";
@@ -69,6 +109,8 @@ export interface PiShellHeaderOptions {
     readonly resources?: readonly PiShellResourceEntry[];
 }
 export interface PiShellEditorOptions {
+    /** Bare A1 adds ergonomic aliases while comparison profiles retain Pi defaults. */
+    readonly keybindingProfile?: "pi" | "a1";
     readonly getColumns: () => number;
     readonly getRows: () => number;
     readonly requestRender: () => void;
@@ -89,6 +131,13 @@ export interface PiShellEditorOptions {
     readonly onMessageCopy?: (() => void) | undefined;
     readonly onFollowUp?: (() => void) | undefined;
     readonly onDequeue?: (() => void) | undefined;
+    readonly onCopyText?: (text: string) => void;
+    readonly readClipboardContent?: () => Promise<PiShellClipboardContent | null>;
+    readonly transformPastedContent?: (content: PiShellClipboardContent) => string;
+    readonly editorAtomicRanges?: (line: string) => readonly PiShellEditorTextRange[];
+    readonly expandCopiedEditorText?: (text: string) => string;
+    readonly paintEditorSelection?: (line: string, from: number, to: number, atomic: boolean) => string;
+    readonly decorateEditorRow?: (row: string, width: number) => string;
     readonly cwd?: string;
     readonly agentDir?: string;
     readonly autocompleteCommands?: readonly PiShellAutocompleteCommand[];

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

@@ -1,7 +1,9 @@
-import { setKeybindings, } from "#pi-tui";
+import { setKeybindings, visibleWidth, } from "#pi-tui";
 import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
 import { ensurePiTheme, } from "./theme.js";
-// Pinned from packages/coding-agent/src/core/slash-commands.ts at 914cf14.
+/** Terminal-cell width authority used by Pi-rendered component rows. */
+export const piShellVisibleWidth = visibleWidth;
+// Provenance: pinned from packages/coding-agent/src/core/slash-commands.ts at 914cf14.
 export function createTuiFacade(options) {
     const children = [];
     const terminal = {

package/dist/integrations/pi/components/submitted-prompt-adapter.d.ts

@@ -0,0 +1,13 @@
+import { type Component } from "#pi-tui";
+import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
+export interface PiShellSubmittedPromptComposer {
+    readonly layout: (width: number, source?: Date | number | null) => {
+        readonly contentWidth: number;
+    };
+    readonly compose: (contentRows: readonly string[], width: number, source?: Date | number | null, style?: {
+        readonly prefix?: (text: string) => string;
+        readonly timestamp?: (text: string) => string;
+    }) => readonly string[];
+}
+/** Pi owns Markdown and theme adaptation; the injected composer owns neutral row geometry. */
+export declare function createPiSubmittedPromptComponent(block: OwnedUiTranscriptBlock, composer: PiShellSubmittedPromptComposer): Component;

package/dist/integrations/pi/components/submitted-prompt-adapter.js

@@ -0,0 +1,27 @@
+import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import { Box, Markdown } from "#pi-tui";
+import { piTheme } from "./theme.js";
+/** Pi owns Markdown and theme adaptation; the injected composer owns neutral row geometry. */
+export function createPiSubmittedPromptComponent(block, composer) {
+    const timestamp = numericTimestamp(block);
+    const markdown = new Markdown(block.text, 0, 0, getMarkdownTheme(), { color: content => piTheme().fg("userMessageText", content) }, { preserveOrderedListMarkers: true, preserveBackslashEscapes: true });
+    const content = {
+        render(width) {
+            const layout = composer.layout(width, timestamp);
+            return [...composer.compose(markdown.render(layout.contentWidth), width, timestamp, {
+                    prefix: text => piTheme().fg("muted", text),
+                    timestamp: text => piTheme().fg("dim", text),
+                })];
+        },
+        invalidate: () => markdown.invalidate(),
+    };
+    const box = new Box(0, 0, line => piTheme().bg("userMessageBg", line));
+    box.addChild(content);
+    return box;
+}
+function numericTimestamp(block) {
+    if (typeof block.payload !== "object" || block.payload === null)
+        return null;
+    const value = block.payload.timestamp;
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/upstream/adjacent/core/keybindings.d.ts

@@ -1,5 +1,5 @@
 /** Source-synchronized from Pi 0.84.2 packages/coding-agent/src/core/keybindings.ts. */
-import { type Keybinding, type KeybindingsConfig, type KeyId, KeybindingsManager as TuiKeybindingsManager } from "#pi-tui";
+import { type Keybinding, type KeybindingDefinitions, type KeybindingsConfig, type KeyId, KeybindingsManager as TuiKeybindingsManager } from "#pi-tui";
 export interface AppKeybindings {
     "app.interrupt": true;
     "app.clear": true;
@@ -43,6 +43,12 @@ export interface AppKeybindings {
     "app.tree.filter.all": true;
     "app.tree.filter.cycleForward": true;
     "app.tree.filter.cycleBackward": true;
+    "owned.editor.selectAll": true;
+    "owned.editor.cut": true;
+    "owned.editor.paste": true;
+    "owned.editor.redo": true;
+    "owned.editor.extendLeft": true;
+    "owned.editor.extendRight": true;
 }
 export type AppKeybinding = keyof AppKeybindings;
 declare module "#pi-tui" {
@@ -413,8 +419,10 @@ export declare function migrateKeybindingsConfig(rawConfig: Record<string, unkno
 };
 export declare class KeybindingsManager extends TuiKeybindingsManager {
     private configPath;
-    constructor(userBindings?: KeybindingsConfig, configPath?: string);
+    constructor(userBindings?: KeybindingsConfig, configPath?: string, definitions?: KeybindingDefinitions);
     static create(agentDir?: string): KeybindingsManager;
+    static createForOwnedInput(agentDir?: string): KeybindingsManager;
+    private static createWithDefinitions;
     reload(): void;
     getEffectiveConfig(): KeybindingsConfig;
     private static loadFromFile;

package/dist/{src/foundation/pi-component-adapter → integrations/pi/components}/upstream/adjacent/core/keybindings.js

@@ -147,6 +147,33 @@ export const KEYBINDINGS = {
         description: "Tree filter: cycle backward",
     },
 };
+/** Pi actions with bare-A1 aliases; the comparison profile keeps KEYBINDINGS unchanged. */
+const OWNED_INPUT_KEYBINDINGS = {
+    ...KEYBINDINGS,
+    "tui.editor.deleteWordBackward": {
+        ...KEYBINDINGS["tui.editor.deleteWordBackward"],
+        defaultKeys: [...KEYBINDINGS["tui.editor.deleteWordBackward"].defaultKeys, "ctrl+backspace"],
+    },
+    "tui.editor.deleteWordForward": {
+        ...KEYBINDINGS["tui.editor.deleteWordForward"],
+        defaultKeys: [...KEYBINDINGS["tui.editor.deleteWordForward"].defaultKeys, "ctrl+delete"],
+    },
+    "tui.editor.undo": {
+        ...KEYBINDINGS["tui.editor.undo"],
+        defaultKeys: [KEYBINDINGS["tui.editor.undo"].defaultKeys, "ctrl+z"],
+    },
+    // Ctrl+Z edits the prompt in bare A1 instead of suspending the process.
+    "app.suspend": { ...KEYBINDINGS["app.suspend"], defaultKeys: [] },
+    // Owned prompt-selection actions are intercepted before vanilla Pi editor
+    // actions. Keeping them in the keybinding manager makes the UX declarative,
+    // configurable, and independent of terminal escape-sequence spellings.
+    "owned.editor.selectAll": { defaultKeys: "ctrl+a", description: "Select all prompt text" },
+    "owned.editor.cut": { defaultKeys: "ctrl+x", description: "Cut selected prompt text" },
+    "owned.editor.paste": { defaultKeys: "ctrl+v", description: "Paste clipboard text" },
+    "owned.editor.redo": { defaultKeys: "ctrl+y", description: "Redo prompt edit" },
+    "owned.editor.extendLeft": { defaultKeys: "shift+left", description: "Extend prompt selection left" },
+    "owned.editor.extendRight": { defaultKeys: "shift+right", description: "Extend prompt selection right" },
+};
 const KEYBINDING_NAME_MIGRATIONS = {
     cursorUp: "tui.editor.cursorUp",
     cursorDown: "tui.editor.cursorDown",
@@ -270,14 +297,20 @@ function loadRawConfig(path) {
 }
 export class KeybindingsManager extends TuiKeybindingsManager {
     configPath;
-    constructor(userBindings = {}, configPath) {
-        super(KEYBINDINGS, userBindings);
+    constructor(userBindings = {}, configPath, definitions = KEYBINDINGS) {
+        super(definitions, userBindings);
         this.configPath = configPath;
     }
     static create(agentDir = getAgentDir()) {
+        return KeybindingsManager.createWithDefinitions(agentDir, KEYBINDINGS);
+    }
+    static createForOwnedInput(agentDir = getAgentDir()) {
+        return KeybindingsManager.createWithDefinitions(agentDir, OWNED_INPUT_KEYBINDINGS);
+    }
+    static createWithDefinitions(agentDir, definitions) {
         const configPath = join(agentDir, "keybindings.json");
         const userBindings = KeybindingsManager.loadFromFile(configPath);
-        return new KeybindingsManager(userBindings, configPath);
+        return new KeybindingsManager(userBindings, configPath, definitions);
     }
     reload() {
         if (!this.configPath)

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

@@ -1,5 +1,5 @@
 import { type Component } from "#pi-tui";
-import type { OwnedUiSessionViewModel } from "../../../owned-ui-contracts/index.js";
+import type { OwnedUiSessionViewModel } from "../../../../../contracts/owned-ui/index.js";
 export declare class SessionFooter implements Component {
     private readonly getView;
     private readonly cwd;