@timurproko/a1 0.2.7-dev.1249 → 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-editor-autocomplete.js

@@ -5,8 +5,6 @@ import { OwnedEditorUxInterception, createPromptSelectionInterceptor, editorVisu
 import { PINNED_PI_LAYOUT, getPiSelectListTheme, piTheme, renderPiListSelection, } from "./theme.js";
 import { createPiKeybindingsHost, createTuiFacade, ensureTheme, isAutocompleteProvider, } from "./shell-shared-facade.js";
 import { SKILLS_COMMAND_NAME, collapseSkillCommands, createSkillsTunnelProvider, } from "./skills-command.js";
-/** The built-in commands resident A1 serves from its tab bar instead: utility tabs, and the tab rename for `/name`. */
-const RESIDENT_UTILITY_TAB_COMMANDS = new Set(["settings", "changelog", "name"]);
 /** A selected autocomplete row: its arrow/primary column, then the aligned description. */
 const SELECTED_DESCRIBED_ROW = /^(→ .*?\S)(\s{2,}.*)$/u;
 const INPUT_COUNTER_INSET = 3;
@@ -336,8 +334,7 @@ export function createPiShellEditor(options) {
     };
 }
 function autocompleteCommandSetter(options, editor, state, enabled) {
-    const builtInCatalog = (options.keybindingProfile === "a1" ? OWNED_BUILTIN_SLASH_COMMANDS : PINNED_PI_BUILTIN_SLASH_COMMANDS)
-        .filter(command => !options.hideUtilityTabCommands || !RESIDENT_UTILITY_TAB_COMMANDS.has(command.name));
+    const builtInCatalog = options.keybindingProfile === "a1" ? OWNED_BUILTIN_SLASH_COMMANDS : PINNED_PI_BUILTIN_SLASH_COMMANDS;
     return installed => {
         if (!enabled) {
             state.provider = emptyAutocompleteProvider();

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, showSessionName?: boolean): PiShellViewComponentPort;
-export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport", getKeybindings?: () => KeybindingsConfig): PiShellQueuedInputPort;
+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?: () => 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";
@@ -136,9 +137,9 @@ export function createPiShellStatus(view, progressStatus, runtime) {
         },
     };
 }
-export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () => true, showSessionName = true) {
+export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () => true) {
     ensureTheme();
-    const footer = new SessionFooter(() => view, cwd, profile, showLevel, showSessionName);
+    const footer = new SessionFooter(() => view, cwd, profile, showLevel);
     return {
         render: width => footer.render(width),
         invalidate: () => footer.invalidate(),
@@ -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-hotkey-sections.js

@@ -6,7 +6,7 @@ import { hotkeysMarkdown } from "./shell-presenters-info.js";
 export function renderPiShellHotkeySections(presentation, width) {
     ensureTheme();
     const shortcuts = presentation.getShortcuts ?? (() => []);
-    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi", presentation.residentTabs);
+    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi");
     const sections = [];
     for (const line of markdown.split("\n")) {
         const heading = /^\*\*(.+)\*\*$/.exec(line)?.[1];

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,17 +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";
-    readonly residentTabs?: boolean;
 }
-export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1", residentTabs?: boolean): 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[];
-/** The global tab declarations the hotkeys document lists, straight from the feature's declarations. */
-export declare const TAB_HOTKEYS: readonly (readonly [string, string | null, string])[];
-export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1", residentTabs?: boolean): 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
@@ -112,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,7 +1,7 @@
+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";
-import { projectResidentTabShortcuts, RESIDENT_TAB_GLOBAL_SHORTCUTS } from "../../../features/resident-tab/index.js";
 import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { getPiHotkeysMarkdownTheme, getPiMarkdownTheme, paintPiBorder, PINNED_PI_LAYOUT, piTheme } from "./theme.js";
 import { componentPort, ensureTheme, formatSessionTokens } from "./shell-shared-facade.js";
@@ -148,9 +148,9 @@ function shortcutDisplay(key) {
         return label.charAt(0).toUpperCase() + label.slice(1);
     }).join("+")).join("/");
 }
-export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi", residentTabs = false) {
+export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi") {
     ensureTheme();
-    const markdown = hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs);
+    const markdown = hotkeysMarkdown(bindings, getShortcuts, profile);
     const container = new Container();
     container.addChild(new Spacer(1));
     container.addChild(new DynamicBorder(paintPiBorder));
@@ -163,15 +163,13 @@ export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export function renderPiShellHotkeysLines(presentation, width) {
     ensureTheme();
-    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi", presentation.residentTabs)).render(width);
+    return hotkeysMarkdownComponent(hotkeysMarkdown(presentation.bindings, presentation.getShortcuts ?? (() => []), presentation.profile ?? "pi")).render(width);
 }
 function hotkeysMarkdownComponent(markdown) {
     return new Markdown(markdown, 1, 1, getPiHotkeysMarkdownTheme());
 }
-/** The global tab declarations the hotkeys document lists, straight from the feature's declarations. */
-export const TAB_HOTKEYS = RESIDENT_TAB_GLOBAL_SHORTCUTS.map(shortcut => [shortcut.id, shortcut.defaultKey, shortcut.description]);
-export function hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs = false) {
-    const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(bindings) : new KeybindingsManager(bindings);
+export function hotkeysMarkdown(bindings, getShortcuts, profile) {
+    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"))
@@ -183,17 +181,6 @@ export function hotkeysMarkdown(bindings, getShortcuts, profile, residentTabs =
             : `\`${label}\``;
     }).join(" / ")} | ${description} |`;
     let markdown = ["**Navigation**", "| Key | Action |", "|-----|--------|", row(["tui.editor.cursorUp", "tui.editor.cursorDown", "tui.editor.cursorLeft", "tui.editor.cursorRight"], "Move cursor / browse history"), row(["tui.editor.cursorWordLeft", "tui.editor.cursorWordRight"], "Move by word"), row(["tui.editor.cursorLineStart"], profile === "a1" ? "Start of prompt line" : "Start of line"), row(["tui.editor.cursorLineEnd"], profile === "a1" ? "End of prompt line" : "End of line"), ...(profile === "a1" ? ["| `Ctrl+Home` | Start of content |", "| `Ctrl+End` | End of content / follow output |"] : []), row(["tui.editor.jumpForward"], "Jump forward to character"), row(["tui.editor.jumpBackward"], "Jump backward to character"), row(["tui.editor.pageUp", "tui.editor.pageDown"], "Scroll by page"), "", "**Editing**", "| Key | Action |", "|-----|--------|", row(["tui.input.submit"], "Send message"), row(["tui.input.newLine"], `New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""}`), row(["tui.editor.deleteWordBackward"], "Delete word backwards"), row(["tui.editor.deleteWordForward"], "Delete word forwards"), row(["tui.editor.deleteToLineStart"], "Delete to start of line"), row(["tui.editor.deleteToLineEnd"], "Delete to end of line"), row(["tui.editor.yank"], "Paste the most-recently-deleted text"), row(["tui.editor.yankPop"], "Cycle through the deleted text after pasting"), row(["tui.editor.undo"], "Undo"), "", "**Other**", "| Key | Action |", "|-----|--------|", row(["tui.input.tab"], "Path completion / accept autocomplete"), row(["app.interrupt"], "Cancel autocomplete / abort streaming"), row(["app.clear"], "Clear editor (first) / exit (second)"), row(["app.exit"], "Exit (when editor is empty)"), row(["app.suspend"], "Suspend to background"), row(["app.thinking.cycle"], "Cycle thinking level"), row(["app.model.cycleForward", "app.model.cycleBackward"], "Cycle models"), row(["app.model.select"], profile === "a1" ? "Open the Models dialog" : "Open model selector"), row(["app.tools.expand"], "Toggle tool output expansion"), row(["app.thinking.toggle"], "Toggle thinking block visibility"), row(["app.editor.external"], "Edit message in external editor"), row(["app.message.copy"], "Copy selection or last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], profile === "a1" ? "Paste image or text from clipboard" : "Paste files on macOS, images, or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |", ...(profile === "a1" ? ["", "**Models dialog**", "| Key | Action |", "|-----|--------|", "| `Space` | Toggle the selected model in the cycling scope |", "| `Tab` | Switch the all/scoped filter |", row(["app.models.save"], "Save the scope to settings"), row(["app.models.enableAll"], "Scope every listed model"), row(["app.models.clearAll"], "Clear the listed models from the scope"), row(["app.models.toggleProvider"], "Toggle the selected model's provider"), row(["app.models.reorderUp", "app.models.reorderDown"], "Reorder the cycling scope")] : [])].join("\n");
-    if (profile === "a1" && residentTabs) {
-        // Invariant: the Tabs section shows the same projection the resident shell dispatches: the
-        // effective A1 declarations keep their keys and earlier tab declarations keep duplicates.
-        const projection = projectResidentTabShortcuts({ configured: bindings, reserved: keys.getEffectiveConfig() });
-        markdown += "\n\n**Tabs**\n| Key | Action |\n|-----|--------|\n";
-        markdown += RESIDENT_TAB_GLOBAL_SHORTCUTS.map(shortcut => {
-            const assigned = projection.assignments[shortcut.id];
-            const label = assigned === null ? "Unbound" : `\`${shortcutDisplay(assigned)}\``;
-            return `| ${label} | ${shortcut.description} |`;
-        }).join("\n");
-    }
     const shortcuts = getShortcuts(bindings ?? keys.getEffectiveConfig());
     if (shortcuts.length > 0) {
         markdown += "\n\n**Extensions**\n| Key | Action |\n|-----|--------|\n";

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

@@ -2,7 +2,7 @@ import { AssistantMessageComponent } from "../startup-public.js";
 import { type MermaidRenderingMode } from "./upstream/components/mermaid.js";
 import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 import { type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
-export { isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
+export { isPiPromptStyleCompaction, type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
 import { type PiShellExtensionRendererResolver, type PiShellImageAssetResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
 export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer, initialOutputPad?: 0 | 1, initialHideThinkingBlock?: boolean, initialMermaidRenderingMode?: MermaidRenderingMode, initialShowImages?: boolean, initialImageWidthCells?: number, imageAssets?: PiShellImageAssetResolver, presentation?: {
     readonly getColumns: () => number;

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

@@ -6,7 +6,7 @@ import { createTranscriptImageResolver } from "./transcript-image-resolver.js";
 import { createMermaidMarkdownTransformer } from "./upstream/components/mermaid.js";
 import { Container, getCapabilities, Image, Spacer, Text, } from "@earendil-works/pi-tui";
 import { createPiSubmittedPromptComponent, isPiPromptStyleCompaction, } from "./submitted-prompt-adapter.js";
-export { isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp } from "./submitted-prompt-adapter.js";
+export { isPiPromptStyleCompaction } from "./submitted-prompt-adapter.js";
 import { getPiMarkdownTheme, PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { 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, presentation) {

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,244 +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";
-    /** Resident Agents expose Settings and the changelog as utility tabs instead of slash commands. */
-    readonly hideUtilityTabCommands?: boolean;
-    /** 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