@timurproko/a1 0.2.7-dev.1252 → 0.2.7-dev.1255

package/dist/integrations/pi/components/prompt-input-port.d.ts

@@ -1,19 +1,2 @@
-export interface PiShellPromptInputGeometry {
-    readonly prefixWidth: number;
-    readonly innerWidth: number;
-    readonly paddingX: number;
-    readonly contentWidth: number;
-    readonly layoutWidth: number;
-}
-export interface PiShellPromptInputBody {
-    readonly rows: readonly string[];
-    readonly topRule?: string | undefined;
-    readonly bottomRule?: string | undefined;
-    readonly after?: readonly string[];
-    readonly afterIndent?: number;
-}
-export interface PiShellPromptInputPresentation {
-    geometry(width: number, padding?: number): PiShellPromptInputGeometry;
-    styleRule(text: string): string;
-    render(width: number, body: (innerWidth: number) => PiShellPromptInputBody, ruled?: boolean, padding?: number): string[];
-}
+import type { OwnedUiShellPromptInputPresentation } from "../../../contracts/owned-ui/index.js";
+export type PiShellPromptInputPresentation = OwnedUiShellPromptInputPresentation;

package/dist/integrations/pi/components/resources/builtin-themes.d.ts

@@ -151,5 +151,6 @@ export declare const BUILTIN_THEME_RESOURCES: Readonly<{
         };
     };
 }>;
-export type BuiltinThemeName = keyof typeof BUILTIN_THEME_RESOURCES;
+type BuiltinThemeName = keyof typeof BUILTIN_THEME_RESOURCES;
 export declare function isBuiltinThemeName(name: string): name is BuiltinThemeName;
+export {};

package/dist/integrations/pi/components/shell-editor-autocomplete.d.ts

@@ -1,4 +1,5 @@
-import { type PiShellEditorPort, type PiShellEditorOptions } from "./shell-shared-facade.js";
+import { type OwnedUiShellEditorOptions } from "../../../contracts/owned-ui/index.js";
+import { type PiShellEditorPort } from "./shell-shared-facade.js";
 export declare const PINNED_PI_BUILTIN_SLASH_COMMANDS: ({
     readonly name: "thinking";
     readonly description: "Set thinking level";
@@ -20,4 +21,4 @@ export declare const OWNED_BUILTIN_SLASH_COMMANDS: ({
     name: string;
     description: string;
 })[];
-export declare function createPiShellEditor(options: PiShellEditorOptions): PiShellEditorPort;
+export declare function createPiShellEditor(options: OwnedUiShellEditorOptions): PiShellEditorPort;

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

@@ -1,8 +1,8 @@
+import type { OwnedUiShellKeybindings } from "../../../contracts/owned-ui/index.js";
 import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.js";
-import { type KeybindingsConfig } from "./upstream/adjacent/core/keybindings.js";
 import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellProgressStatusPresentation, type PiShellQueuedInputPort, type PiShellHeaderPort, type PiShellResourceEntry, type PiShellLoadedResourcesPort, type PiShellHeaderOptions, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
 export declare function createPiShellStatus(view: OwnedUiSessionViewModel, progressStatus: PiShellProgressStatusPresentation, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
 export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", showLevel?: () => boolean): PiShellViewComponentPort;
-export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport", getKeybindings?: () => KeybindingsConfig): PiShellQueuedInputPort;
+export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport", getKeybindings?: () => OwnedUiShellKeybindings): PiShellQueuedInputPort;

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

@@ -1,3 +1,4 @@
+import { piKeybindings } from "./shell-shared-facade.js";
 import { rawKeyHint, VERSION } from "../startup-public.js";
 import { Spacer, Text, } from "@earendil-works/pi-tui";
 import { SessionFooter } from "./upstream/components/session-footer.js";
@@ -263,7 +264,7 @@ function queuedInputText(submissions, presentation, bindings) {
         return submissions.map(submission => theme.fg("muted", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`)).join("\n");
     }
     const messages = submissions.map(submission => theme.fg("dim", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`));
-    const keys = KeybindingsManager.fromOwnedBindings(bindings).getKeys("app.message.dequeue");
+    const keys = KeybindingsManager.fromOwnedBindings(piKeybindings(bindings)).getKeys("app.message.dequeue");
     const label = keys.length === 0 ? "Unbound" : keys.map(displayKeybinding).join("/");
     const dequeueHint = theme.fg("dim", `↳ ${label} to edit all queued messages`);
     // Compatibility: the custom viewport matches Pi's interactive queue presentation while the
@@ -290,7 +291,7 @@ function compactHeaderText() {
     return `${headerWithLogo(instructions)}\n${compactOnboarding}\n\n${onboarding}`;
 }
 function expandedHeaderText(bindings) {
-    const keys = bindings === undefined ? undefined : KeybindingsManager.fromOwnedBindings(bindings);
+    const keys = bindings === undefined ? undefined : KeybindingsManager.fromOwnedBindings(piKeybindings(bindings));
     const instructions = [
         rawKeyHint("escape", "to interrupt"),
         rawKeyHint("ctrl+c", "to clear"),

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

@@ -1,4 +1,4 @@
-import { type KeybindingsConfig } from "@earendil-works/pi-tui";
+import type { OwnedUiShellKeybindings } from "../../../contracts/owned-ui/index.js";
 import { type PiShellComponentPort, type PiShellExtensionRendererResolver } from "./shell-shared-facade.js";
 export interface PiShellSessionInfoPresentation {
     readonly sessionName?: string;
@@ -31,7 +31,7 @@ export interface PiShellSessionInfoPresentation {
     }[];
     readonly cacheWarming: PiShellCacheWarmingPresentation;
 }
-export interface PiShellCacheWarmingPresentation {
+interface PiShellCacheWarmingPresentation {
     readonly mode: string;
     readonly status?: {
         readonly state: "inactive" | "scheduled" | "refreshing";
@@ -65,14 +65,14 @@ export declare function createPiShellChangelog(markdown: string): PiShellCompone
 export declare function renderPiShellChangelogLines(markdown: string, width: number): readonly string[];
 /** What the hotkeys presenters render: the editor bindings and the extension shortcuts declared over them. */
 export interface PiShellHotkeysPresentation {
-    readonly bindings?: KeybindingsConfig;
+    readonly bindings?: OwnedUiShellKeybindings;
     readonly getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>;
     readonly profile?: "pi" | "a1";
 }
-export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;
+export declare function createPiShellHotkeys(bindings?: OwnedUiShellKeybindings, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export declare function renderPiShellHotkeysLines(presentation: PiShellHotkeysPresentation, width: number): readonly string[];
-export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1"): string;
+export declare function hotkeysMarkdown(bindings: OwnedUiShellKeybindings | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1"): string;
 /**
  * Pinned Pi's `showPackageUpdateNotification` banner: warning-coloured dynamic
  * borders around a bold warning title, the muted update instruction with the
@@ -109,3 +109,4 @@ export declare function renderPiShellReleaseUpdateBanner(release: {
     readonly command: string;
     readonly changelogUrl: string | null;
 }, width: number, closeHovered: boolean): PiShellReleaseUpdateBanner;
+export {};

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

@@ -1,3 +1,4 @@
+import { piKeybindings } from "./shell-shared-facade.js";
 import { DynamicBorder } from "../startup-public.js";
 import { Container, getCapabilities, hyperlink, Markdown, Spacer, Text, visibleWidth } from "@earendil-works/pi-tui";
 import { PRODUCT_TEXT } from "../../../product-identity.js";
@@ -168,7 +169,7 @@ function hotkeysMarkdownComponent(markdown) {
     return new Markdown(markdown, 1, 1, getPiHotkeysMarkdownTheme());
 }
 export function hotkeysMarkdown(bindings, getShortcuts, profile) {
-    const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(bindings) : new KeybindingsManager(bindings);
+    const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(piKeybindings(bindings)) : new KeybindingsManager(piKeybindings(bindings));
     // Compatibility: the owned viewport consumes these physical chords before editor actions.
     const display = (action) => keys.getKeys(action)
         .filter(key => profile !== "a1" || (key !== "ctrl+home" && key !== "ctrl+end"))

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

@@ -1,5 +1,5 @@
 import { type PiShellSessionInfoPresentation } from "./shell-presenters-info.js";
-export interface PiShellSessionInfoReferenceDocument {
+interface PiShellSessionInfoReferenceDocument {
     readonly preamble: readonly string[];
     readonly sections: readonly {
         readonly title: string;
@@ -8,3 +8,4 @@ export interface PiShellSessionInfoReferenceDocument {
 }
 /** Renders the pinned report values while leaving group names semantic for the owned screen. */
 export declare function renderPiShellSessionInfoReferenceDocument(presentation: PiShellSessionInfoPresentation, width: number): PiShellSessionInfoReferenceDocument;
+export {};

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

@@ -1,242 +1,48 @@
 import { visibleWidth, type AutocompleteProvider, type Component, type KeybindingsConfig, type TUI } from "@earendil-works/pi-tui";
-import type { OwnedUiImageAttachment, OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock, SuggestionDecision } from "../../../contracts/owned-ui/index.js";
 import type { HistoryEditorConstructor } from "./history-editor-loader.js";
-import type { PiShellPromptInputPresentation } from "./prompt-input-port.js";
-import type { EditorRecallPort } from "./editor-interaction.js";
-import type { PresentationComponentPort } from "../../../contracts/presentation/index.js";
+import type { OwnedUiShellAutocompleteCommand, OwnedUiShellClipboardContent, OwnedUiShellComponentPort, OwnedUiShellEditorBodyGeometry, OwnedUiShellEditorOptions, OwnedUiShellKeybindings, OwnedUiShellEditorPointerEvent, OwnedUiShellEditorPort, OwnedUiShellEditorTextRange, OwnedUiShellExtensionRendererResolver, OwnedUiShellHeaderOptions, OwnedUiShellHeaderPort, OwnedUiShellImageAssetResolver, OwnedUiShellLoadedResourcesPort, OwnedUiShellPasteReservation, OwnedUiShellProgressPresentationMode, OwnedUiShellProgressStatusPresentation, OwnedUiShellQueuedInputPort, OwnedUiShellResourceEntry, OwnedUiShellResourceSection, OwnedUiShellSelectorOption, OwnedUiShellSelectorOptions, OwnedUiShellStartupNotice, OwnedUiShellStatusPlacement, OwnedUiShellStatusPort, OwnedUiShellTranscriptComponentPort, OwnedUiShellViewComponentPort } from "../../../contracts/owned-ui/index.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 /** Terminal-cell width authority used by Pi-rendered component rows. */
 export declare const piShellVisibleWidth: typeof visibleWidth;
 export declare const piShellTruncateToWidth: (text: string, width: number) => string;
-export declare const INSTALLED_UPDATE_STATUS_TEXT = "Update installed, restart to update";
 /** Shared green restart notice for the pinned status and bare-A1 prompt overlay. */
 export declare function renderPiShellInstalledUpdateStatus(width: number): string;
 /** A clickable URL in pinned Pi's grammar: an OSC 8 link where the terminal supports one, the plain URL otherwise. */
 export declare const piShellHyperlink: (url: string, text?: string) => string;
-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 border of the editor body, excluding its menu. */
-    readonly row: number;
-}
-export interface PiShellEditorBodyGeometry {
-    /** Zero-based body offset in the most recently rendered component rows. */
-    readonly rowOffset: number;
-    /** Border-inclusive body height, excluding autocomplete. */
-    readonly rowCount: number;
-}
-export interface PiShellEditorPort extends PiShellComponentPort {
-    /** Present only for the owned above-prompt autocomplete presentation. */
-    bodyGeometry?(): PiShellEditorBodyGeometry;
-    readonly recall?: EditorRecallPort;
-    readonly historyReplacement?: typeof import("../../../contracts/owned-ui/index.js").PROMPT_HISTORY_EDITOR_REPLACEMENT;
-    /** Restores the shared manager if anything replaced pi-tui's registry; a no-op when it is already active. */
-    activateKeybindings(): void;
-    keybindingConfig(): KeybindingsConfig;
-    reloadKeybindings(): void;
-    /** Uses Pi's terminal decoder rather than assuming one terminal escape spelling. */
-    matchesTerminalKey(data: string, key: "home" | "end" | "pageUp" | "pageDown" | "ctrl+home" | "ctrl+end" | "alt+home" | "ctrl+v"): boolean;
-    getText(): string;
-    setText(text: string): void;
-    insertText(text: string): void;
-    addToHistory(text: string): void;
-    setSubmitEnabled(enabled: boolean): void;
-    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;
-    setPromptSuggestion(text: string | null): void;
-    canPresentPromptSuggestion(): boolean;
-    promptSuggestionBlockReason?(): SuggestionDecision;
-    hasSelection(): boolean;
-    /** Exact expanded semantic editor selection without mutating or collapsing it. */
-    selectedText?(): string | undefined;
-    ownsPointer(): boolean;
-    handlePointer(event: PiShellEditorPointerEvent): boolean;
-    pasteClipboard(): boolean;
-    cancelPendingPastes?(): void;
-}
-export interface PiShellAutocompleteCommand {
-    readonly name: string;
-    readonly description?: string;
-    readonly argumentHint?: string;
-    readonly argumentOptions?: readonly PiShellSelectorOption[];
-    /** Built-in entries decorate the active profile's catalog; everything else is a discovered resource. */
-    readonly source?: "builtin" | "prompt" | "skill" | "extension";
-}
-export interface PiShellViewComponentPort extends PiShellComponentPort {
-    update(view: OwnedUiSessionViewModel): void;
-}
-export type PiShellStatusPlacement = "live" | "dock" | "hidden";
-export type PiShellProgressPresentationMode = "pinned" | "custom-viewport";
-export interface PiShellProgressStatusPresentation {
-    readonly text: (message: string, mode: PiShellProgressPresentationMode) => string;
-    readonly frame: (message: string, phase: number, styles: {
-        readonly muted: (text: string) => string;
-        readonly highlight: (text: string) => string;
-    }) => string;
-}
-export interface PiShellStatusPort extends PiShellViewComponentPort {
-    /** `active` owns a live operation before the engine lifecycle itself becomes busy. */
-    setWorkingOverride(message: string | undefined, active?: boolean): void;
-    setOutputPad(padding: 0 | 1): void;
-    /** Bare A1 shows engine-measured progress beside the working word; the pinned route keeps the bare word. */
-    setProgressPresentation(presentation: PiShellProgressPresentationMode): 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;
-}
-export interface PiShellHeaderPort extends PiShellComponentPort {
-    readonly expanded: boolean;
-    setExpanded(expanded: boolean): void;
-}
-export type PiShellResourceSection = "Context" | "Skills" | "Prompts" | "Extensions" | "Themes";
-export interface PiShellResourceEntry {
-    readonly section: PiShellResourceSection;
-    readonly label: string;
-    readonly sourcePath: string | null;
-    readonly diagnostic?: string | null;
-}
-export interface PiShellLoadedResourcesPort extends PiShellComponentPort {
-    setExpanded(expanded: boolean): void;
-}
-export interface PiShellImageAssetResolver {
-    resolve(assetId: string): OwnedUiImageAttachment | null;
-}
-export interface PiShellExtensionRendererResolver {
-    getMessageRenderer(customType: string): unknown;
-    getToolRenderers(toolName: string): unknown;
-    getShortcuts?(bindings: KeybindingsConfig): readonly {
-        readonly key: string;
-        readonly description: string;
-    }[];
-}
-export interface PiShellTranscriptComponentPort extends PiShellComponentPort {
-    readonly id: string;
-    readonly revision: number;
-    readonly presentationRevision?: 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";
-    readonly message: string;
-}
-export interface PiShellHeaderOptions {
-    readonly getKeybindings?: () => KeybindingsConfig;
-    readonly quiet?: boolean;
-    readonly expanded?: boolean;
-    readonly notices?: readonly PiShellStartupNotice[];
-    readonly resources?: readonly PiShellResourceEntry[];
-}
-/** An owned paste reserves its edit immediately and acknowledges completion only after insertion. */
-export interface PiShellPasteReservation {
-    readonly marker: string;
-    readonly result: Promise<string>;
-    complete?(): void;
-    isCurrent?(): boolean;
-}
-export interface PiShellEditorOptions {
-    readonly persistentHistory?: boolean;
-    /** Configures the shared interactive input for a caller narrower than the agent prompt. */
-    readonly inputCapabilities?: {
-        readonly singleLine?: boolean;
-        readonly paste?: boolean;
-        readonly autocomplete?: boolean;
-        readonly placeholder?: string;
-    };
+export type PiShellComponentPort = OwnedUiShellComponentPort;
+export type PiShellClipboardContent = OwnedUiShellClipboardContent;
+export type PiShellEditorTextRange = OwnedUiShellEditorTextRange;
+export type PiShellEditorPointerEvent = OwnedUiShellEditorPointerEvent;
+export type PiShellEditorBodyGeometry = OwnedUiShellEditorBodyGeometry;
+export type PiShellEditorPort = OwnedUiShellEditorPort;
+export type PiShellAutocompleteCommand = OwnedUiShellAutocompleteCommand;
+export type PiShellViewComponentPort = OwnedUiShellViewComponentPort;
+export type PiShellStatusPlacement = OwnedUiShellStatusPlacement;
+export type PiShellProgressPresentationMode = OwnedUiShellProgressPresentationMode;
+export type PiShellProgressStatusPresentation = OwnedUiShellProgressStatusPresentation;
+export type PiShellStatusPort = OwnedUiShellStatusPort;
+export type PiShellQueuedInputPort = OwnedUiShellQueuedInputPort;
+export type PiShellHeaderPort = OwnedUiShellHeaderPort;
+export type PiShellResourceSection = OwnedUiShellResourceSection;
+export type PiShellResourceEntry = OwnedUiShellResourceEntry;
+export type PiShellLoadedResourcesPort = OwnedUiShellLoadedResourcesPort;
+export type PiShellImageAssetResolver = OwnedUiShellImageAssetResolver;
+export type PiShellExtensionRendererResolver = OwnedUiShellExtensionRendererResolver;
+export type PiShellTranscriptComponentPort = OwnedUiShellTranscriptComponentPort;
+export type PiShellStartupNotice = OwnedUiShellStartupNotice;
+export type PiShellHeaderOptions = OwnedUiShellHeaderOptions;
+export type PiShellPasteReservation = OwnedUiShellPasteReservation;
+export type PiShellSelectorOption = OwnedUiShellSelectorOption;
+export type PiShellSelectorOptions = OwnedUiShellSelectorOptions;
+/**
+ * Restores Pi's keybinding type to bindings the shell carried through the neutral contract. They were read from
+ * Pi's keybinding manager in the first place, so the narrowing loses nothing.
+ */
+export declare function piKeybindings(bindings: OwnedUiShellKeybindings | undefined): KeybindingsConfig | undefined;
+/** The editor factory's options with the opaque history editor and keybindings narrowed to their Pi types. */
+export interface PiShellEditorOptions extends Omit<OwnedUiShellEditorOptions, "historyEditor" | "keybindings"> {
     readonly historyEditor?: HistoryEditorConstructor;
-    /** Bare A1 adds ergonomic aliases while comparison profiles retain Pi defaults. */
-    readonly keybindingProfile?: "pi" | "a1";
-    /** The process's shared keybindings; its profile must match `keybindingProfile`. */
     readonly keybindings?: PiKeybindingsHost;
-    readonly getColumns: () => number;
-    readonly getRows: () => number;
-    readonly requestRender: () => void;
-    readonly onSubmit: (text: string) => void;
-    readonly onChange?: (text: string) => void;
-    readonly onInterrupt?: () => void;
-    readonly onClear?: () => void;
-    readonly onExit?: () => void;
-    readonly onSuspend?: () => void;
-    readonly onExternalEditor?: () => void;
-    readonly onPasteImage?: () => void;
-    readonly onExtensionShortcut?: (data: string) => boolean;
-    readonly onModelSelect?: () => void;
-    readonly onModelCycle?: ((direction: "forward" | "backward") => void) | undefined;
-    readonly onThinkingCycle?: (() => void) | undefined;
-    readonly onThinkingToggle?: (() => void) | undefined;
-    readonly onToolsExpand?: (() => void) | undefined;
-    readonly onMessageCopy?: (() => void) | undefined;
-    readonly onFollowUp?: (() => void) | undefined;
-    readonly onDequeue?: (() => void) | undefined;
-    readonly onPromptSuggestionAccepted?: (text: string) => void;
-    readonly onCopyText?: (text: string, cut: boolean) => void;
-    readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
-    readonly beginClipboardPaste?: () => PiShellPasteReservation;
-    readonly beginTextPaste?: (text: string) => PiShellPasteReservation;
-    readonly deferTextPaste?: (text: string) => boolean;
-    readonly onPasteRejected?: (error: unknown) => void;
-    readonly onPasteInput?: (bytes: number, phase: "framing" | "inserting" | "settled") => void;
-    readonly editorHiddenRanges?: (line: string) => readonly PiShellEditorTextRange[];
-    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;
-    /** Row indices restart at zero for each complete owned editor decoration pass. */
-    readonly decorateEditorRow?: (row: string, width: number, rowIndex: number) => string;
-    readonly cwd?: string;
-    readonly agentDir?: string;
-    readonly autocompleteCommands?: readonly PiShellAutocompleteCommand[];
-    /**
-     * Bare A1's skills presentation, read at every command-list installation. `collapse` replaces the
-     * `skill:<name>` entries with one `skills` command and its tunnel; absent or `expand` keeps the
-     * pinned per-skill entries. Comparison profiles ignore it.
-     */
-    readonly skillsPresentation?: () => "collapse" | "expand";
-    readonly promptPresentation?: {
-        readonly input: PiShellPromptInputPresentation;
-        readonly styleSuggestion: (text: string) => string;
-        readonly styleSuggestionCaret: (text: string) => string;
-    };
-}
-export interface PiShellSelectorOption {
-    readonly id: string;
-    readonly label: string;
-    readonly description?: string;
-}
-export interface PiShellSelectorOptions {
-    readonly title?: string;
-    readonly options: readonly PiShellSelectorOption[];
-    readonly maxVisible?: number;
-    readonly onSelect?: (id: string) => void;
-    readonly onCancel?: () => void;
 }
 export declare function createTuiFacade(options: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender"> & {
     readonly onSubmit?: (text: string) => void;

package/dist/integrations/pi/components/shell-shared-facade.js

@@ -4,7 +4,7 @@ import { ensurePiTheme, piTheme, } from "./theme.js";
 /** Terminal-cell width authority used by Pi-rendered component rows. */
 export const piShellVisibleWidth = visibleWidth;
 export const piShellTruncateToWidth = (text, width) => truncateToWidth(text, width, "");
-export const INSTALLED_UPDATE_STATUS_TEXT = "Update installed, restart to update";
+const INSTALLED_UPDATE_STATUS_TEXT = "Update installed, restart to update";
 /** Shared green restart notice for the pinned status and bare-A1 prompt overlay. */
 export function renderPiShellInstalledUpdateStatus(width) {
     if (width <= 0)
@@ -14,6 +14,13 @@ export function renderPiShellInstalledUpdateStatus(width) {
 }
 /** A clickable URL in pinned Pi's grammar: an OSC 8 link where the terminal supports one, the plain URL otherwise. */
 export const piShellHyperlink = (url, text = url) => hyperlink(url, text);
+/**
+ * Restores Pi's keybinding type to bindings the shell carried through the neutral contract. They were read from
+ * Pi's keybinding manager in the first place, so the narrowing loses nothing.
+ */
+export function piKeybindings(bindings) {
+    return bindings;
+}
 // Provenance: pinned from packages/coding-agent/src/core/slash-commands.ts at 914cf14.
 export function createTuiFacade(options) {
     const children = [];

package/dist/integrations/pi/components/skills-command.d.ts

@@ -1,10 +1,7 @@
-import type { AutocompleteItem, AutocompleteProvider } from "@earendil-works/pi-tui";
+import type { AutocompleteProvider } from "@earendil-works/pi-tui";
 import type { PiShellAutocompleteCommand } from "./shell-shared-facade.js";
 /** The collapsed bare-A1 replacement for the per-skill command listing. */
 export declare const SKILLS_COMMAND_NAME = "skills";
-export declare const SKILLS_COMMAND_DESCRIPTION = "Browse, search, and apply a skill";
-/** Pi's own command prefix; the engine expands `/skill:<name>` regardless of how the menu presents it. */
-export declare const SKILL_COMMAND_PREFIX = "skill:";
 export interface PiShellSkillSummary {
     readonly name: string;
     readonly description: string;
@@ -16,8 +13,6 @@ export interface PiShellCollapsedSkillCommands {
     /** The skills withheld from the top-level menu, in the engine's discovery order. */
     readonly skills: readonly PiShellSkillSummary[];
 }
-/** One line of description, as the v2 extension shows it beside a row. */
-export declare function oneLineSkillDescription(description: string): string;
 /** The skills the engine registered as `skill:<name>` commands, in its order. */
 export declare function skillsFromCommands(commands: readonly PiShellAutocompleteCommand[]): readonly PiShellSkillSummary[];
 /**
@@ -37,9 +32,6 @@ export declare function skillPrompt(name: string, args?: string): string;
  * returned unchanged so ordinary prompts, `/skills <name>`, and `/skill:` input keep their text.
  */
 export declare function rewriteSkillsTunnelSubmission(text: string): string;
-/** The tunnel query when single-line content before the cursor is exactly `/skills:<query>`. */
-export declare function skillsTunnelQuery(lines: readonly string[], cursorLine: number, cursorCol: number): string | null;
-export declare function skillsTunnelItems(skills: readonly PiShellSkillSummary[], query: string): AutocompleteItem[];
 /**
  * Wrap the pinned combined provider with the `skills` tunnel: `/skills:<query>` lists matching
  * skills as `skills:<name>` rows and shows nothing when none match; every other request, the

package/dist/integrations/pi/components/skills-command.js

@@ -1,14 +1,14 @@
 /** The collapsed bare-A1 replacement for the per-skill command listing. */
 export const SKILLS_COMMAND_NAME = "skills";
-export const SKILLS_COMMAND_DESCRIPTION = "Browse, search, and apply a skill";
+const SKILLS_COMMAND_DESCRIPTION = "Browse, search, and apply a skill";
 /** Pi's own command prefix; the engine expands `/skill:<name>` regardless of how the menu presents it. */
-export const SKILL_COMMAND_PREFIX = "skill:";
+const SKILL_COMMAND_PREFIX = "skill:";
 const SKILLS_TUNNEL_PREFIX = `${SKILLS_COMMAND_NAME}:`;
 /** The tunnel form follows v2: a name without whitespace right after the colon. */
 const SKILLS_TUNNEL_INPUT = /^\/skills:(\S*)$/u;
 const SKILLS_TUNNEL_SUBMISSION = /^\/skills:([A-Za-z0-9][A-Za-z0-9_-]*)(\s[\s\S]*)?$/u;
 /** One line of description, as the v2 extension shows it beside a row. */
-export function oneLineSkillDescription(description) {
+function oneLineSkillDescription(description) {
     return description.replace(/\s+/gu, " ").trim();
 }
 /** The skills the engine registered as `skill:<name>` commands, in its order. */
@@ -82,13 +82,13 @@ export function rewriteSkillsTunnelSubmission(text) {
     return `/${SKILL_COMMAND_PREFIX}${match[1]}${match[2] ?? ""}`;
 }
 /** The tunnel query when single-line content before the cursor is exactly `/skills:<query>`. */
-export function skillsTunnelQuery(lines, cursorLine, cursorCol) {
+function skillsTunnelQuery(lines, cursorLine, cursorCol) {
     if (cursorLine !== 0 || lines.length !== 1)
         return null;
     const match = SKILLS_TUNNEL_INPUT.exec((lines[0] ?? "").slice(0, cursorCol));
     return match === null ? null : match[1] ?? "";
 }
-export function skillsTunnelItems(skills, query) {
+function skillsTunnelItems(skills, query) {
     return skills.filter(skill => skillMatchesQuery(skill, query)).map(skill => ({
         value: `${SKILLS_TUNNEL_PREFIX}${skill.name}`,
         label: `${SKILLS_TUNNEL_PREFIX}${skill.name}`,

package/dist/integrations/pi/components/theme.d.ts

@@ -1,6 +1,13 @@
-import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel, type SemanticShortcutHint } from "../../../contracts/presentation/index.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel, type SemanticShortcutHint, type ThemeSource, type UiTheme } from "../../../contracts/presentation/index.js";
 import { type MarkdownTheme, type SelectListTheme } from "@earendil-works/pi-tui";
-export * from "./upstream/theme/theme.js";
+export { PINNED_PI_LAYOUT, applyPiTheme, applyPiThemeInstance, currentPiThemeName, ensurePiTheme, getAvailablePiThemes, loadPiTheme, piCanvasBackgroundAnsi, piTheme, setPiAccentColor, setPiPackageBorderProjectionEnabled, } from "./upstream/theme/theme.js";
+type Paint = (text: string) => string;
+/** The live Pi theme in neutral roles; `panel` and `disabled` default to plain and dim. */
+export declare function piUiTheme(options?: {
+    readonly panel?: Paint;
+    readonly disabled?: Paint;
+}): UiTheme;
+export declare const PI_THEME_SOURCE: ThemeSource;
 export type PiModalShortcutHint = SemanticShortcutHint;
 export { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel };
 /** Resolves dialog rules through the live A1 projection instead of Pi's package-global theme. */

package/dist/integrations/pi/components/theme.js

@@ -1,8 +1,23 @@
 import { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel, renderSemanticShortcutHints, } from "../../../contracts/presentation/index.js";
 import { stripTerminalSequences, truncateToWidth } from "@earendil-works/pi-tui";
 import { getMarkdownTheme } from "../startup-public.js";
-import { piTheme } from "./upstream/theme/theme.js";
-export * from "./upstream/theme/theme.js";
+import { onPiThemeChange, piTheme, renderPiAccentPreview } from "./upstream/theme/theme.js";
+export { PINNED_PI_LAYOUT, applyPiTheme, applyPiThemeInstance, currentPiThemeName, ensurePiTheme, getAvailablePiThemes, loadPiTheme, piCanvasBackgroundAnsi, piTheme, setPiAccentColor, setPiPackageBorderProjectionEnabled, } from "./upstream/theme/theme.js";
+/** The live Pi theme in neutral roles; `panel` and `disabled` default to plain and dim. */
+export function piUiTheme(options = {}) {
+    return {
+        fg: (token, text) => piTheme().fg(token, text),
+        bold: text => piTheme().bold(text),
+        plain: text => text,
+        accentPreview: (color, text) => renderPiAccentPreview(color, text),
+        disabled: options.disabled ?? (text => piTheme().fg("dim", text)),
+        highlight: text => piTheme().bg("selectedBg", text),
+        panel: options.panel ?? (text => text),
+        background: (token, text) => piTheme().bg(token, text),
+    };
+}
+const PI_UI_THEME = Object.freeze(piUiTheme());
+export const PI_THEME_SOURCE = Object.freeze({ current: () => PI_UI_THEME, onChange: (listener) => onPiThemeChange(listener) });
 export { DIALOG_CLOSE_SHORTCUT_HINT, displayShortcutKeyLabel };
 /** Resolves dialog rules through the live A1 projection instead of Pi's package-global theme. */
 export function paintPiBorder(text) {

package/dist/integrations/pi/components/thinking-selector-dialog.d.ts

@@ -1,8 +1,9 @@
 import { type ThinkingSelectorLevel } from "./upstream/components/thinking-selector.js";
 import { type PiShellComponentPort } from "./shell-shared-facade.js";
-export interface PiShellThinkingSelectorPresentation {
+interface PiShellThinkingSelectorPresentation {
     readonly profile: "bare";
     readonly cycleBinding: string | readonly string[];
 }
 /** Lazily loaded because thinking-selector code does not belong to the startup graph before `/thinking` opens. */
 export declare function createPiShellThinkingSelector(currentLevel: ThinkingSelectorLevel, availableLevels: readonly ThinkingSelectorLevel[], onSelect: (level: ThinkingSelectorLevel) => void, onCancel: () => void, onSelectAsDefault?: (level: ThinkingSelectorLevel) => void, defaultLevel?: ThinkingSelectorLevel, presentation?: PiShellThinkingSelectorPresentation): PiShellComponentPort;
+export {};

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.d.ts

@@ -73,7 +73,7 @@ declare module "@earendil-works/pi-tui" {
 }
 export declare const KEYBINDINGS: {
     readonly "tui.editor.undo": {
-        readonly defaultKeys: "ctrl+z" | "alt+z" | "ctrl+-";
+        readonly defaultKeys: "alt+z" | "ctrl+z" | "ctrl+-";
         readonly description: "Undo";
     };
     readonly "tui.altScreen.previousPrompt": {
@@ -153,7 +153,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Restore queued messages";
     };
     readonly "app.clipboard.pasteImage": {
-        readonly defaultKeys: "alt+v" | "ctrl+v";
+        readonly defaultKeys: "ctrl+v" | "alt+v";
         readonly description: "Paste files on macOS, images, or text from clipboard";
     };
     readonly "app.session.new": {

package/dist/integrations/pi/engine/adapter.d.ts

@@ -6,7 +6,7 @@ import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selectio
 import { type AdapterCommandResult } from "./command-dispatch.js";
 import { type PiEnginePackageUpdateProbe, type PiEngineRuntimeFactory, type PiRepositoryContextReader } from "./session-runtime.js";
 import { type PiEngineHostSessionPorts } from "./host-ports.js";
-import { type PiSessionPresentationSource } from "./ports.js";
+import { type PiEngineAnnouncements, type PiSessionPresentationSource } from "./ports.js";
 export type { OwnedPiExtensionResourceSummary, OwnedPiExtensionSourceSummary, OwnedPiResourceSummary } from "./resource-catalog.js";
 export type { PiEngineRuntimeFactory, PiEngineRuntimeFactoryInput } from "./session-runtime.js";
 export type { AdapterCommandResult } from "./command-dispatch.js";
@@ -56,16 +56,14 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
     get settings(): OwnedUiSessionSettingsPort;
     get catalog(): OwnedUiSessionCatalogPort;
     get extensions(): OwnedUiExtensionPort;
+    /** Pinned Pi's changelog since the profile's last seen version and extension package updates; the host announces each once per process. */
+    get announcements(): PiEngineAnnouncements;
     /** The Pi objects behind pinned selectors and renderers, for the session presenters owner only. */
     presentationSource(): PiSessionPresentationSource;
     setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
     suggestionReasoningPolicy(): OwnedUiPromptSuggestionReasoning;
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
     start(): Promise<OwnedUiSessionViewModel>;
-    /** Announce pinned Pi's changelog since the profile's last seen version; the host calls this once per process. */
-    announceStartupChangelog(): Promise<void>;
-    /** Probe extension packages for updates and announce them; the host calls this once per process. */
-    announcePackageUpdates(): Promise<void>;
     onEvent(listener: (event: OwnedUiEvent) => void): () => void;
     /** Developer-only pressure evidence; never mirrored into visible diagnostic/status arrays. */
     deliveryDiagnostics(): {