@timurproko/a1 0.2.7-dev.810 → 0.2.7-dev.828

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -81,7 +81,7 @@ class PromptSelectionInterceptor {
         installAtomicSegmentation(editor, options.atomicRanges, () => this.#wordDirection);
     }
     handleInput(data, next) {
-        if (this.#handleTerminalPaste(data, next))
+        if (this.options.pasteEnabled === false ? discardTerminalPaste(this, data, value => this.handleInput(value, next)) : this.#handleTerminalPaste(data, next))
             return;
         if (this.keybindings.matches(data, "owned.editor.selectAll")) {
             this.#selectAll();
@@ -107,7 +107,8 @@ class PromptSelectionInterceptor {
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.paste")) {
-            this.pasteClipboard();
+            if (this.options.pasteEnabled !== false)
+                this.pasteClipboard();
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.redo")) {
@@ -132,7 +133,7 @@ class PromptSelectionInterceptor {
                 this.#deleteSelection();
                 return;
             }
-            const inserted = insertedText(data);
+            const inserted = editorInsertedText(data);
             if (inserted !== undefined) {
                 this.#replaceSelection(inserted);
                 return;
@@ -280,11 +281,13 @@ class PromptSelectionInterceptor {
         this.#pointerSelecting = false;
         this.#lastClick = undefined;
         this.#redoStack = [];
+        DISABLED_TERMINAL_PASTES.delete(this);
         this.#selectionRevision += 1;
     }
     cancelPendingPastes() {
         this.#pasteGeneration += 1;
         this.#terminalPaste = undefined;
+        DISABLED_TERMINAL_PASTES.delete(this);
     }
     hasSelection() {
         return this.#activeRange() !== undefined;
@@ -295,6 +298,8 @@ class PromptSelectionInterceptor {
             : this.options.expandCopiedText(this.#selectedText());
     }
     pasteClipboard() {
+        if (this.options.pasteEnabled === false)
+            return false;
         this.#pasteFromClipboard();
         return true;
     }
@@ -933,7 +938,73 @@ function isEditorSegment(value) {
     const input = Reflect.get(value, "input");
     return typeof segment === "string" && typeof index === "number" && typeof input === "string";
 }
-function insertedText(data) {
+const DISABLED_TERMINAL_PASTES = new WeakMap();
+function discardTerminalPaste(owner, data, forward) {
+    const startMarker = "\x1b[200~";
+    const endMarker = "\x1b[201~";
+    const state = DISABLED_TERMINAL_PASTES.get(owner) ?? { startTail: "", bodyTail: null };
+    if (state.bodyTail !== null) {
+        const framed = state.bodyTail + data;
+        const end = framed.indexOf(endMarker);
+        if (end < 0) {
+            state.bodyTail = delimiterTail(framed, endMarker);
+            DISABLED_TERMINAL_PASTES.set(owner, state);
+            return true;
+        }
+        DISABLED_TERMINAL_PASTES.delete(owner);
+        const remaining = framed.slice(end + endMarker.length);
+        if (remaining.length > 0)
+            forward(remaining);
+        return true;
+    }
+    const hadStartTail = state.startTail.length > 0;
+    const candidate = state.startTail + data;
+    state.startTail = "";
+    const start = candidate.indexOf(startMarker);
+    if (start >= 0) {
+        if (start > 0)
+            forward(candidate.slice(0, start));
+        const framed = candidate.slice(start + startMarker.length);
+        const end = framed.indexOf(endMarker);
+        if (end < 0) {
+            state.bodyTail = delimiterTail(framed, endMarker);
+            DISABLED_TERMINAL_PASTES.set(owner, state);
+        }
+        else {
+            DISABLED_TERMINAL_PASTES.delete(owner);
+            const remaining = framed.slice(end + endMarker.length);
+            if (remaining.length > 0)
+                forward(remaining);
+        }
+        return true;
+    }
+    const partial = delimiterTail(candidate, startMarker);
+    // Compatibility: standalone Escape still cancels; marker fragments stay pending.
+    if (partial.length > 1) {
+        const before = candidate.slice(0, candidate.length - partial.length);
+        if (before.length > 0)
+            forward(before);
+        state.startTail = partial;
+        DISABLED_TERMINAL_PASTES.set(owner, state);
+        return true;
+    }
+    DISABLED_TERMINAL_PASTES.delete(owner);
+    if (hadStartTail) {
+        forward(candidate);
+        return true;
+    }
+    return false;
+}
+function delimiterTail(text, delimiter) {
+    const limit = Math.min(text.length, delimiter.length - 1);
+    for (let length = limit; length > 0; length -= 1) {
+        const suffix = text.slice(text.length - length);
+        if (delimiter.startsWith(suffix))
+            return suffix;
+    }
+    return "";
+}
+export function editorInsertedText(data) {
     if (!data || data.includes("\u001b[200~"))
         return undefined;
     const kitty = decodeKittyPrintable(data);

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -5,6 +5,8 @@ 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;
@@ -62,6 +64,8 @@ export function createPiShellEditor(options) {
     ensureTheme();
     const tui = createTuiFacade(options);
     const inputPresentation = options.keybindingProfile === "a1" ? options.promptPresentation?.input : undefined;
+    const inputCapabilities = options.inputCapabilities ?? {};
+    const autocompleteEnabled = inputCapabilities.autocomplete !== false;
     // Invariant: the process shares one manager; a standalone editor gets its own host for its profile.
     const host = options.keybindings ?? createPiKeybindingsHost({
         profile: options.keybindingProfile ?? "pi",
@@ -74,7 +78,7 @@ export function createPiShellEditor(options) {
     }
     const scrollInfo = { emitted: false, counter: undefined };
     const selectListTheme = getPiSelectListTheme();
-    let tunnelSkills = [];
+    const autocomplete = { provider: emptyAutocompleteProvider(), skills: [] };
     const EditorClass = options.keybindingProfile === "a1" && options.persistentHistory === true ? options.historyEditor : OwnedEditor;
     const editor = new EditorClass(tui, {
         borderColor: (value) => inputPresentation === undefined ? piTheme().fg("borderMuted", value) : inputPresentation.styleRule(value),
@@ -100,13 +104,14 @@ export function createPiShellEditor(options) {
         ...(options.keybindingProfile === "a1" ? {
             terminalRows: options.getRows,
             getVisualLineCount: (width) => editorVisualLineCount(editor, width),
-            clearCommandSearchOnEscape: true,
-            commandTunnels: () => tunnelSkills.length === 0 ? [] : [SKILLS_COMMAND_NAME],
+            clearCommandSearchOnEscape: autocompleteEnabled,
+            commandTunnels: () => !autocompleteEnabled || autocomplete.skills.length === 0 ? [] : [SKILLS_COMMAND_NAME],
         } : {}),
         ...(options.keybindingProfile === "a1" && options.promptPresentation !== undefined ? {
             ...(inputPresentation === undefined ? {} : { inputPresentation }),
             styleSuggestion: options.promptPresentation.styleSuggestion,
             styleSuggestionCaret: options.promptPresentation.styleSuggestionCaret,
+            ...(inputCapabilities.placeholder === undefined ? {} : { placeholder: inputCapabilities.placeholder }),
         } : {}),
     });
     const editorUx = options.keybindingProfile === "a1"
@@ -117,6 +122,7 @@ export function createPiShellEditor(options) {
                 ...(options.beginClipboardPaste === undefined ? {} : { beginClipboardPaste: options.beginClipboardPaste }),
                 ...(options.beginTextPaste === undefined ? {} : { beginTextPaste: options.beginTextPaste }),
                 ...(options.deferTextPaste === undefined ? {} : { deferTextPaste: options.deferTextPaste }),
+                pasteEnabled: inputCapabilities.paste !== false,
                 ...(options.onPasteRejected === undefined ? {} : { onPasteRejected: options.onPasteRejected }),
                 ...(options.onPasteInput === undefined ? {} : { onPasteInput: options.onPasteInput }),
                 transformPastedContent: options.transformPastedContent ?? (content => content.kind === "text" ? content.text : ""),
@@ -142,37 +148,7 @@ export function createPiShellEditor(options) {
             : isBashMode ? piTheme().getBashModeBorderColor() : piTheme().getThinkingBorderColor(thinkingLevel);
         tui.requestRender();
     };
-    let autocompleteProvider;
-    const builtInCatalog = (options.keybindingProfile === "a1" ? OWNED_BUILTIN_SLASH_COMMANDS : PINNED_PI_BUILTIN_SLASH_COMMANDS)
-        .filter(command => !options.hideSettingsCommand || command.name !== "settings");
-    const setAutocompleteCommands = (installed) => {
-        // Invariant: collapse is a bare-A1 presentation; the comparison profile installs the pinned list.
-        const collapsed = options.keybindingProfile === "a1" && options.skillsPresentation?.() === "collapse"
-            ? collapseSkillCommands(installed)
-            : { commands: installed, skills: [] };
-        tunnelSkills = collapsed.skills;
-        const commands = collapsed.commands;
-        const additions = new Map(commands.map(command => [command.name, command]));
-        const builtInNames = new Set(builtInCatalog.map(command => command.name));
-        const builtIns = builtInCatalog.flatMap(command => [
-            autocompleteCommand(command, additions.get(command.name)),
-            // Rationale: the collapsed browser is a primary bare-A1 command, not a resource after quit.
-            ...(command.name === "settings" && collapsed.collapsedCommand !== undefined
-                ? [autocompleteCommand(collapsed.collapsedCommand)]
-                : []),
-        ]);
-        // Invariant: built-in additions and the promoted collapsed browser never reappear as resources.
-        const resources = commands
-            .filter(command => command.name !== collapsed.collapsedCommand?.name && command.source !== "builtin" && !builtInNames.has(command.name))
-            .map(command => autocompleteCommand(command));
-        const catalog = [...builtIns, ...resources];
-        const combined = new CombinedAutocompleteProvider(catalog, options.cwd ?? process.cwd());
-        const tunnelAware = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
-        autocompleteProvider = options.keybindingProfile === "a1"
-            ? createDelimiterReadyCommandProvider(tunnelAware, catalog)
-            : tunnelAware;
-        editor.setAutocompleteProvider(autocompleteProvider);
-    };
+    const setAutocompleteCommands = autocompleteCommandSetter(options, editor, autocomplete, autocompleteEnabled);
     setAutocompleteCommands(options.autocompleteCommands ?? []);
     let submitHandler = options.onSubmit;
     let interruptHandler = options.onInterrupt ?? (() => { });
@@ -259,6 +235,9 @@ export function createPiShellEditor(options) {
         reloadKeybindings: () => host.reload(),
         matchesTerminalKey: (data, key) => matchesKey(data, key),
         handleInput: data => {
+            if (inputCapabilities.singleLine === true
+                && (keybindings.matches(data, "tui.input.newLine") || keybindings.matches(data, "tui.input.submit")))
+                return;
             // Compatibility: an unassigned reverse Tab must not clear selection or reach autocomplete fallback.
             if (editorUx !== undefined && matchesKey(data, "shift+tab")
                 && !Object.values(keybindings.getEffectiveConfig()).some(keys => (Array.isArray(keys) ? keys : [keys]).some(key => key !== undefined && matchesKey(data, key))))
@@ -316,13 +295,15 @@ export function createPiShellEditor(options) {
             tui.requestRender();
         },
         addAutocompleteProvider(factory) {
+            if (!autocompleteEnabled)
+                return;
             if (typeof factory !== "function")
                 throw new TypeError("extension autocomplete factory must be a function");
-            const candidate = Reflect.apply(factory, undefined, [autocompleteProvider]);
+            const candidate = Reflect.apply(factory, undefined, [autocomplete.provider]);
             if (!isAutocompleteProvider(candidate))
                 throw new TypeError("extension autocomplete factory returned a malformed provider");
-            autocompleteProvider = candidate;
-            editor.setAutocompleteProvider(autocompleteProvider);
+            autocomplete.provider = candidate;
+            editor.setAutocompleteProvider(autocomplete.provider);
         },
         setThinkingLevel(level) {
             if (thinkingLevel === level)
@@ -354,6 +335,45 @@ export function createPiShellEditor(options) {
         cancelPendingPastes: () => editorUx?.cancelPendingPastes(),
     };
 }
+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));
+    return installed => {
+        if (!enabled) {
+            state.provider = emptyAutocompleteProvider();
+            editor.setAutocompleteProvider(state.provider);
+            return;
+        }
+        // Invariant: collapse is a bare-A1 presentation; the comparison profile installs the pinned list.
+        const collapsed = options.keybindingProfile === "a1" && options.skillsPresentation?.() === "collapse"
+            ? collapseSkillCommands(installed)
+            : { commands: installed, skills: [] };
+        state.skills = collapsed.skills;
+        const additions = new Map(collapsed.commands.map(command => [command.name, command]));
+        const builtInNames = new Set(builtInCatalog.map(command => command.name));
+        const builtIns = builtInCatalog.flatMap(command => [
+            autocompleteCommand(command, additions.get(command.name)),
+            // Rationale: the collapsed browser is a primary bare-A1 command, not a resource after quit.
+            ...(command.name === "settings" && collapsed.collapsedCommand !== undefined
+                ? [autocompleteCommand(collapsed.collapsedCommand)] : []),
+        ]);
+        const resources = collapsed.commands
+            .filter(command => command.name !== collapsed.collapsedCommand?.name && command.source !== "builtin" && !builtInNames.has(command.name))
+            .map(command => autocompleteCommand(command));
+        const catalog = [...builtIns, ...resources];
+        const combined = new CombinedAutocompleteProvider(catalog, options.cwd ?? process.cwd());
+        const tunnelAware = state.skills.length === 0 ? combined : createSkillsTunnelProvider(combined, state.skills);
+        state.provider = options.keybindingProfile === "a1" ? createDelimiterReadyCommandProvider(tunnelAware, catalog) : tunnelAware;
+        editor.setAutocompleteProvider(state.provider);
+    };
+}
+function emptyAutocompleteProvider() {
+    return {
+        getSuggestions: async () => null,
+        applyCompletion: (lines, cursorLine, cursorCol) => ({ lines, cursorLine, cursorCol }),
+        shouldTriggerFileCompletion: () => false,
+    };
+}
 /** Bare A1 leaves an applied catalog command ready for `:`, a user-entered space, or submission. */
 function createDelimiterReadyCommandProvider(base, commands) {
     const commandNames = new Set(commands.map(command => command.name));

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

@@ -7,7 +7,7 @@ import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { StatusIndicator, WorkingStatusIndicator } from "./upstream/components/status-indicator.js";
 import { protectPiPromptChipPresentation } from "./prompt-chip-presentation.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
-import { createTuiFacade, ensureTheme, } from "./shell-shared-facade.js";
+import { createTuiFacade, ensureTheme, piShellTruncateToWidth, piShellVisibleWidth, } from "./shell-shared-facade.js";
 export function createPiShellHeader(options = {}) {
     ensureTheme();
     let expanded = options.expanded ?? false;
@@ -107,9 +107,9 @@ export function createPiShellStatus(view, progressStatus, runtime) {
         component = statusComponent(view, statusUi, outputPad, liveStatusText, placement, progressPresentation, progressStatus);
     };
     return {
-        render: width => component?.render(width) ?? [],
+        render: width => appendInstalledUpdateStatus(component?.render(width) ?? [], width, view),
         renderDock: width => placement === "dock" ? component?.render(width) ?? [] : [],
-        renderLive: width => placement === "live" ? component?.render(width) ?? [] : [],
+        renderLive: width => appendInstalledUpdateStatus(placement === "live" ? component?.render(width) ?? [] : [], width, view),
         placement: () => placement,
         invalidate: () => component?.invalidate(),
         update(next) {
@@ -228,6 +228,22 @@ function statusSignature(view, workingOverride, outputPad, placement, progressPr
     const message = withMessage ? `${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.workingProgress ?? ""}` : "";
     return `${placement}\u0000${outputPad}\u0000${view.lifecycle}\u0000${progressPresentation}\u0000${message}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
 }
+function appendInstalledUpdateStatus(rows, width, view) {
+    if (width <= 0 || !view.diagnostics.some(diagnostic => diagnostic.code === "release-update-installed"))
+        return rows;
+    const theme = piTheme();
+    const full = `${theme.fg("success", "Update installed")} ${theme.fg("muted", "·")} ${theme.fg("accent", "Restart to update")}`;
+    const status = piShellTruncateToWidth(full, width);
+    const statusWidth = piShellVisibleWidth(status);
+    const target = rows.findLastIndex(row => piShellVisibleWidth(row.trimEnd()) > 0);
+    if (target < 0)
+        return [`${" ".repeat(Math.max(0, width - statusWidth))}${status}`];
+    const base = (rows[target] ?? "").trimEnd();
+    const gap = width - piShellVisibleWidth(base) - statusWidth;
+    if (gap >= 2)
+        return rows.map((row, index) => index === target ? `${base}${" ".repeat(gap)}${status}` : row);
+    return [...rows.slice(0, target + 1), `${" ".repeat(Math.max(0, width - statusWidth))}${status}`, ...rows.slice(target + 1)];
+}
 function queuedInputChipWrapping(text, presentation, width) {
     return presentation === "custom-viewport"
         ? protectPiPromptChipPresentation(text, width)

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

@@ -4,7 +4,7 @@ import { SkillInvocationMessageComponent } from "./upstream/components/skill-inv
 import { piToolArguments as toolArguments, updatePiToolResult as updateToolResult } from "./tool-result-adapter.js";
 import { createTranscriptImageResolver } from "./transcript-image-resolver.js";
 import { createMermaidMarkdownTransformer } from "./upstream/components/mermaid.js";
-import { Container, Image, Spacer, Text, } from "@earendil-works/pi-tui";
+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";
 import { getPiMarkdownTheme, PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
@@ -127,7 +127,10 @@ function withTranscriptImages(component, block, assets, showImages, imageWidthCe
         return component;
     const container = new Container();
     container.addChild(component);
+    const imageProtocolUnavailable = getCapabilities().images === null;
     for (const reference of references) {
+        if (showImages && imageProtocolUnavailable)
+            continue;
         container.addChild(new Spacer(1));
         const asset = assets?.resolve(reference.assetId) ?? null;
         if (!showImages) {

package/dist/integrations/pi/components/shell-selectors-dialogs.js

@@ -3,7 +3,7 @@ import { EarendilAnnouncementComponent } from "./upstream/components/earendil-an
 import { ExtensionSelectorComponent } from "./upstream/components/extension-selector.js";
 import { Box, Container, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
 import { ScopedModelsSelectorComponent } from "./upstream/components/scoped-models-selector.js";
-import { addPiModalSelectFooter, adoptPiModalFrame, adoptPiModalHeader } from "./modal-frame.js";
+import { addPiModalSelectFooter, adoptPiModalFrame, adoptPiModalHeader, adoptPiModalSearchInput } from "./modal-frame.js";
 import { ModelsDialogComponent } from "./models-dialog.js";
 import { TrustSelectorComponent } from "./upstream/components/trust-selector.js";
 import { canonicalizePiSettingsHint, DIALOG_CLOSE_SHORTCUT_HINT, PINNED_PI_LAYOUT, getPiSelectListTheme, paintPiBorder, piTheme, renderPiModalShortcutHints, } from "./theme.js";
@@ -96,6 +96,7 @@ export function createPiShellSettingsSelector(options) {
 export function createPiShellModelSelector(options) {
     ensureTheme();
     const selector = new ModelSelectorComponent(createTuiFacade(options.runtime), options.currentModel, options.modelRuntime, options.scopedModels, options.onSelect, options.onCancel, options.initialSearchInput, options.onSelectAsDefault, options.defaultModel);
+    adoptPiModalSearchInput(selector, selector.getSearchInput());
     adoptPiModalFrame(selector, { topIndex: 0, bottomIndex: selector.children.length - 1 });
     return componentPort(selector);
 }
@@ -235,6 +236,8 @@ export function createPiShellAuthProviderSelector(mode, providers, onSelect, onC
         if (selected)
             onSelect(selected.id);
     }, onCancel, initialSearchInput);
+    // Provenance: OAuth selector slot is top rule, spacer, title, spacer, then its search Input.
+    adoptPiModalSearchInput(selector, selector.children[4]);
     addPiModalSelectFooter(selector);
     const preInsetContent = [selector.children[2], selector.children[6]];
     const header = adoptPiModalHeader(selector, 0, 2);

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

@@ -161,11 +161,18 @@ export interface PiShellPasteReservation {
 }
 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;
+    };
     readonly historyEditor?: HistoryEditorConstructor;
     /** Bare A1 adds ergonomic aliases while comparison profiles retain Pi defaults. */
     readonly keybindingProfile?: "pi" | "a1";
-    /** Resident Agents expose Settings through the global tab instead of a slash command. */
-    readonly hideSettingsCommand?: boolean;
+    /** 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;

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

@@ -1,6 +1,6 @@
 import { DynamicBorder } from "../startup-public.js";
 import { Container, getKeybindings, Input, Spacer, Text } from "@earendil-works/pi-tui";
-import { addPiModalHeader, adoptPiModalFrame } from "./modal-frame.js";
+import { addPiModalHeader, addPiModalSearchInput, adoptPiModalFrame } from "./modal-frame.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT, paintPiBorder, PINNED_PI_LAYOUT, piTheme, renderPiModalListRow, renderPiModalShortcutHints, } from "./theme.js";
 import { componentPort, ensureTheme, piShellTruncateToWidth, piShellVisibleWidth } from "./shell-shared-facade.js";
 import { skillMatchesQuery } from "./skills-command.js";
@@ -50,7 +50,7 @@ class SkillsSelectorComponent extends Container {
         this.#searchInput.onSubmit = () => this.#selectCurrent();
         const header = addPiModalHeader(this, new DynamicBorder(paintPiBorder), new Text(piTheme().fg("accent", piTheme().bold("Skills")), 0, 0));
         this.addChild(new Spacer(1));
-        this.addChild(this.#searchInput);
+        addPiModalSearchInput(this, this.#searchInput);
         this.addChild(new Spacer(1));
         this.addChild(this.#listContainer);
         this.addChild(new Spacer(1));

package/dist/integrations/pi/components/upstream/components/owned-editor.d.ts

@@ -3,11 +3,11 @@
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input
- * frame, transient contextual-suggestion branch, and explicit body geometry for selection and
- * above-prompt autocomplete with a one-cell outer gutter. Bare A1 also clears a sole top-level
- * slash-command search on Escape and completes a selected or exact completed tunnel command with `:`
- * and reopens the menu on its tunnel rows, and synchronously retains then refreshes an exact top-level
- * command menu after Tab applies its row.
+ * frame, configurable empty-input placeholder branch, transient contextual-suggestion branch, and
+ * explicit body geometry for selection and above-prompt autocomplete with a one-cell outer gutter.
+ * Bare A1 also clears a sole top-level slash-command search on Escape and completes a selected or
+ * exact completed tunnel command with `:` and reopens the menu on its tunnel rows, and synchronously
+ * retains then refreshes an exact top-level command menu after Tab applies its row.
  * Deviations: owned-shared-input-frame, above-prompt-autocomplete-placement,
  * clear-command-search-on-escape, command-tunnel-colon-completion, keep-command-menu-open-after-tab.
  */
@@ -21,6 +21,8 @@ export interface OwnedEditorOptions extends EditorOptions {
     readonly inputPresentation?: PiShellPromptInputPresentation;
     readonly styleSuggestion?: (text: string) => string;
     readonly styleSuggestionCaret?: (text: string) => string;
+    /** Non-accepting empty-input guidance rendered through the shared suggestion presentation. */
+    readonly placeholder?: string;
     readonly terminalRows?: () => number;
     /** Reuses the editor's established atomic-aware visual layout when available. */
     readonly getVisualLineCount?: (width: number) => number | undefined;

package/dist/integrations/pi/components/upstream/components/owned-editor.js

@@ -3,11 +3,11 @@
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input
- * frame, transient contextual-suggestion branch, and explicit body geometry for selection and
- * above-prompt autocomplete with a one-cell outer gutter. Bare A1 also clears a sole top-level
- * slash-command search on Escape and completes a selected or exact completed tunnel command with `:`
- * and reopens the menu on its tunnel rows, and synchronously retains then refreshes an exact top-level
- * command menu after Tab applies its row.
+ * frame, configurable empty-input placeholder branch, transient contextual-suggestion branch, and
+ * explicit body geometry for selection and above-prompt autocomplete with a one-cell outer gutter.
+ * Bare A1 also clears a sole top-level slash-command search on Escape and completes a selected or
+ * exact completed tunnel command with `:` and reopens the menu on its tunnel rows, and synchronously
+ * retains then refreshes an exact top-level command menu after Tab applies its row.
  * Deviations: owned-shared-input-frame, above-prompt-autocomplete-placement,
  * clear-command-search-on-escape, command-tunnel-colon-completion, keep-command-menu-open-after-tab.
  */
@@ -25,6 +25,7 @@ export function createOwnedEditorClass(Base) {
         #inputPresentation;
         #styleSuggestion;
         #styleSuggestionCaret;
+        #placeholder;
         #terminalRows;
         #getVisualLineCount;
         #clearCommandSearchOnEscape;
@@ -37,6 +38,7 @@ export function createOwnedEditorClass(Base) {
             this.#inputPresentation = options.inputPresentation;
             this.#styleSuggestion = options.styleSuggestion ?? (text => text);
             this.#styleSuggestionCaret = options.styleSuggestionCaret ?? (text => `\u001b[7m${text}\u001b[27m`);
+            this.#placeholder = options.placeholder ?? null;
             this.#terminalRows = options.terminalRows ?? (() => 24);
             this.#getVisualLineCount = options.getVisualLineCount;
             this.#clearCommandSearchOnEscape = options.clearCommandSearchOnEscape === true;
@@ -70,7 +72,12 @@ export function createOwnedEditorClass(Base) {
                 return rows;
             }
             if (this.#promptSuggestion !== null && this.canPresentPromptSuggestion()) {
-                const rows = this.#renderSuggestion(width);
+                const rows = this.#renderSuggestion(width, this.#promptSuggestion);
+                this.#renderedBodyRowCount = rows.length;
+                return rows;
+            }
+            if (this.#placeholder !== null && this.focused && this.getText().length === 0 && !this.isShowingAutocomplete()) {
+                const rows = this.#renderSuggestion(width, this.#placeholder);
                 this.#renderedBodyRowCount = rows.length;
                 return rows;
             }
@@ -176,10 +183,10 @@ export function createOwnedEditorClass(Base) {
             triggerAutocomplete(this);
             return true;
         }
-        #renderSuggestion(width) {
+        #renderSuggestion(width, suggestion) {
             const presentation = this.#inputPresentation;
             const { paddingX, contentWidth, layoutWidth } = presentation.geometry(width, this.getPaddingX());
-            const chunks = wrapTextWithAnsi(this.#promptSuggestion ?? "", layoutWidth).map(text => ({ text }));
+            const chunks = wrapTextWithAnsi(suggestion, layoutWidth).map(text => ({ text }));
             const maxVisible = Math.max(5, Math.floor(this.#terminalRows() * 0.3));
             const visible = chunks.slice(0, maxVisible);
             const leftPadding = " ".repeat(paddingX);

package/dist/integrations/pi/components/upstream/components/scoped-models-selector.d.ts

@@ -5,9 +5,9 @@
  * search, bulk/provider/reorder actions, dirty state, Ctrl+S persistence, refresh status,
  * cancellation, and focus while remapping theme and public helper imports; local key labels preserve
  * pinned platform formatting before layout without changing binding identities, and bare A1 uses the
- * shared semantic modal shortcut row and compact padded modal frame while immediately closing on the
- * implicit Ctrl+C selection-cancel alias without advertising it.
- * Deviations: owned-modal-shortcut-hints, owned-dialog-ctrl-c-cancel.
+ * shared semantic modal shortcut row, accent search marker, and compact padded modal frame while
+ * immediately closing on the implicit Ctrl+C selection-cancel alias without advertising it.
+ * Deviations: owned-modal-shortcut-hints, owned-dialog-ctrl-c-cancel, owned-dialog-search-marker.
  */
 interface ScopedModel {
     readonly provider: string;

package/dist/integrations/pi/components/upstream/components/scoped-models-selector.js

@@ -1,7 +1,7 @@
 import { Container, fuzzyFilter, getKeybindings, Input, Spacer, Text, } from "@earendil-works/pi-tui";
 import { DynamicBorder } from "../../../startup-public.js";
 import { getModelSearchText } from "../model-search.js";
-import { addPiModalHeader, adoptPiModalFrame } from "../../modal-frame.js";
+import { addPiModalHeader, addPiModalSearchInput, adoptPiModalFrame } from "../../modal-frame.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT, paintPiBorder, piTheme, renderPiModalShortcutHints } from "../../theme.js";
 // Rationale: upstream's capitalized hint formatter is private to the package; the same mapping lives here.
 function keyDisplayText(keybinding) {
@@ -118,7 +118,7 @@ export class ScopedModelsSelectorComponent extends Container {
         this.addChild(new Spacer(1));
         // Search input
         this.searchInput = new Input();
-        this.addChild(this.searchInput);
+        addPiModalSearchInput(this, this.searchInput);
         this.addChild(new Spacer(1));
         // List container
         this.listContainer = new Container();