@timurproko/a1 0.1.8-dev.137 → 0.1.8-dev.151

package/dist/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;
@@ -139,6 +173,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/integrations/pi/components/shell-footer-status.d.ts

@@ -4,4 +4,4 @@ export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiS
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
 export declare function createPiShellStatus(view: OwnedUiSessionViewModel, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
 export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string): PiShellViewComponentPort;
-export declare function createPiQueuedInputStatus(submissions: readonly string[]): PiShellQueuedInputPort;
+export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport"): PiShellQueuedInputPort;

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

@@ -110,14 +110,14 @@ 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));
         },
     };
 }
@@ -135,9 +135,18 @@ function statusComponent(view, ui, workingOverride) {
 function statusSignature(view, workingOverride) {
     return `${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");
+    // 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-transcript.d.ts

@@ -1,5 +1,7 @@
 import { AssistantMessageComponent } from "@earendil-works/pi-coding-agent";
 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 PiShellComponentPort, type PiShellExtensionRendererResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
 export interface PiShellSessionInfoPresentation {
     readonly sessionName?: string;
@@ -35,7 +37,7 @@ export declare function renderPiShellStatusText(message: string, width: number):
 export declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
 export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;
 export declare function createPiShellHotkeys(): PiShellComponentPort;
-export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver): PiShellTranscriptComponentPort;
+export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer): PiShellTranscriptComponentPort;
 export declare function renderPiShellTranscriptBlock(block: OwnedUiTranscriptBlock, width: number, cwd: string): readonly string[];
 /**
  * Pinned Pi's CLI prints startup diagnostics with `reportDiagnostics` before
@@ -54,4 +56,3 @@ export declare function renderPiShellStartupDiagnostic(diagnostic: {
 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;
-export {};

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

@@ -1,8 +1,9 @@
 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 { 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 { createPiSubmittedPromptComponent, } from "./submitted-prompt-adapter.js";
+import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.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) {
@@ -106,11 +107,11 @@ export function createPiShellHotkeys() {
     container.addChild(new DynamicBorder());
     return componentPort(container);
 }
-export function createPiShellTranscriptComponent(initial, cwd, extensions) {
+export function createPiShellTranscriptComponent(initial, cwd, extensions, submittedPrompt) {
     ensureTheme();
     let block = initial;
     let expanded = false;
-    let component = transcriptComponent(block, cwd, expanded, extensions);
+    let component = transcriptComponent(block, cwd, expanded, extensions, submittedPrompt);
     return {
         get id() { return block.id; },
         get revision() { return block.revision; },
@@ -122,7 +123,7 @@ export function createPiShellTranscriptComponent(initial, cwd, extensions) {
             const previous = block;
             block = next;
             if (!updateTranscriptComponent(component, previous, next, expanded)) {
-                component = transcriptComponent(block, cwd, expanded, extensions);
+                component = transcriptComponent(block, cwd, expanded, extensions, submittedPrompt);
             }
         },
         setExpanded(next) {
@@ -133,7 +134,7 @@ export function createPiShellTranscriptComponent(initial, cwd, extensions) {
                 component.setExpanded(expanded);
             }
             else {
-                component = transcriptComponent(block, cwd, expanded, extensions);
+                component = transcriptComponent(block, cwd, expanded, extensions, submittedPrompt);
             }
         },
     };
@@ -175,12 +176,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) {
     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)

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -1,13 +1,34 @@
-import { type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
+import { visibleWidth, type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
 import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
-export interface PiShellComponentPort {
-    render(width: number): readonly string[];
-    handleInput?(data: string): void;
-    invalidate(): void;
-    setFocused?(focused: boolean): void;
-    dispose?(): void;
+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;
@@ -18,6 +39,10 @@ export interface PiShellEditorPort extends PiShellComponentPort {
     setAutocompleteCommands(commands: readonly PiShellAutocompleteCommand[]): 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;
@@ -69,6 +94,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 +116,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/integrations/pi/components/shell-shared-facade.js

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

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/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/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/integrations/pi/engine/adapter.js

@@ -16,7 +16,10 @@ const execFileAsync = promisify(execFile);
  * that a streaming burst never holds input, large enough that an ordinary turn is one
  * batch.
  */
-const EVENT_DELIVERY_BATCH = 16;
+// Deliver at most one engine event per event-loop turn. Transcript updates can
+// be expensive in long sessions; a larger synchronous batch starves terminal
+// input and makes an in-progress mouse selection appear frozen.
+const EVENT_DELIVERY_BATCH = 1;
 const TOOL_UPDATE_COALESCE_MS = 50;
 const DEFAULT_SURFACE = {
     columns: 100,
@@ -1317,7 +1320,11 @@ export class PiEngineAdapter {
             case "retry":
             case "compact": {
                 const result = await this.#sessionCommands?.execute(command.type === "prompt" || command.type === "steer" || command.type === "follow-up"
-                    ? { type: command.type, text: command.text }
+                    ? {
+                        type: command.type,
+                        text: command.text,
+                        ...(command.images === undefined ? {} : { images: [...command.images] }),
+                    }
                     : { type: command.type });
                 if (!result || result.outcome === "rejected" || result.outcome === "failed") {
                     throw new Error(command.type === "retry" ? "no previous prompt is available to retry" : `Pi session command failed: ${command.type}`);
@@ -1484,6 +1491,7 @@ export class PiEngineAdapter {
         switch (event.type) {
             case "agent_start":
                 this.#agentRunActive = true;
+                this.#emitEvent({ type: "agent-run-started" });
                 this.#enterWorkState("working", "Working...");
                 return;
             case "message_start":
@@ -1505,6 +1513,12 @@ export class PiEngineAdapter {
             }
             case "message_end":
                 this.#upsertMessageBlock(event.message, "finalized");
+                // Preserve the same semantic boundary v2 counted. Transcript block
+                // finalization is intentionally not a substitute: rebuilds, retries,
+                // thinking parts, and tool rows can all finalize independently.
+                if (isRecord(event.message) && event.message.role === "assistant") {
+                    this.#emitEvent({ type: "assistant-message-completed" });
+                }
                 return;
             case "turn_end":
                 this.#upsertMessageBlock(event.message, "finalized");
@@ -1688,7 +1702,11 @@ export class PiEngineAdapter {
                     revision: this.#nextBlockRevision(baseId),
                     title: "User",
                     text: textFromContent(message.content),
-                    payload: { role: "user", imageCount: contentImageCount(message.content) },
+                    payload: {
+                        role: "user",
+                        imageCount: contentImageCount(message.content),
+                        timestamp: typeof message.timestamp === "number" && Number.isFinite(message.timestamp) ? message.timestamp : null,
+                    },
                 }];
         }
         if (message.role === "bashExecution") {

package/dist/integrations/pi/engine/session-integration.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSession, AgentSessionEvent } from "@earendil-works/pi-coding-agent";
+import type { AgentSession, AgentSessionEvent, PromptOptions } from "@earendil-works/pi-coding-agent";
 import { type AgentCommandOutcome, type AgentEvent } from "../../../contracts/agent-engine/index.js";
 export interface PiDocumentedSessionCommands {
     readonly isStreaming: AgentSession["isStreaming"];
@@ -18,6 +18,7 @@ export interface PiDocumentedSessionCommands {
 export type PiSessionCommand = {
     readonly type: "prompt" | "steer" | "follow-up";
     readonly text: string;
+    readonly images?: NonNullable<PromptOptions["images"]>;
 } | {
     readonly type: "abort" | "retry" | "compact";
 } | {

package/dist/integrations/pi/engine/session-integration.js

@@ -9,15 +9,29 @@ export class PiSessionCommandIntegration {
         switch (command.type) {
             case "prompt":
                 this.#lastPrompt = command.text;
-                await this.session.prompt(command.text, this.session.isStreaming ? { streamingBehavior: "followUp" } : undefined);
+                await this.session.prompt(command.text, command.images === undefined
+                    ? this.session.isStreaming ? { streamingBehavior: "followUp" } : undefined
+                    : {
+                        ...(this.session.isStreaming ? { streamingBehavior: "followUp" } : {}),
+                        images: [...command.images],
+                    });
                 return { outcome: "completed" };
             case "steer":
                 this.#lastPrompt = command.text;
-                await this.session.steer(command.text);
+                // Match interactive Pi: prompt() owns template/extension expansion and
+                // turns the accepted steering message into the visible user row while
+                // later messages remain in the pending queue.
+                await this.session.prompt(command.text, {
+                    streamingBehavior: "steer",
+                    ...(command.images === undefined ? {} : { images: [...command.images] }),
+                });
                 return { outcome: "completed" };
             case "follow-up":
                 this.#lastPrompt = command.text;
-                await this.session.followUp(command.text);
+                await this.session.prompt(command.text, {
+                    streamingBehavior: "followUp",
+                    ...(command.images === undefined ? {} : { images: [...command.images] }),
+                });
                 return { outcome: "completed" };
             case "abort":
                 if (this.session.isRetrying)

package/dist/integrations/pi/session-ui/prompt-chips.d.ts

@@ -0,0 +1,23 @@
+import type { PiShellClipboardContent, PiShellEditorTextRange } from "../components/index.js";
+export interface PromptImageAttachment {
+    readonly type: "image";
+    readonly data: string;
+    readonly mimeType: string;
+}
+export interface PreparedPrompt {
+    readonly text: string;
+    readonly images: readonly PromptImageAttachment[];
+}
+/** Owns semantic clipboard records while the prompt displays compact chips. */
+export declare class PromptChipStore {
+    #private;
+    transformPastedContent(content: PiShellClipboardContent): string;
+    atomicRanges(line: string): readonly PiShellEditorTextRange[];
+    hyperlinkRanges(text: string): readonly {
+        start: number;
+        end: number;
+        target: string;
+    }[];
+    expandCopiedText(text: string): string;
+    prepareSubmission(text: string): PreparedPrompt;
+}