@timurproko/a1 0.1.8-dev.544 → 0.1.8-dev.546

package/dist/foundation/lifecycle/session-repository-context.js

@@ -0,0 +1,173 @@
+import { createHash, randomUUID } from "node:crypto";
+import { open, lstat, mkdir, readFile, realpath, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { resolveProductPaths } from "./paths.js";
+const SCHEMA = "a1-session-repository-context-v1";
+const MAX_RECORD_BYTES = 16 * 1024;
+const MAX_HEADER_BYTES = 64 * 1024;
+const GIT_TIMEOUT_MS = 5_000;
+/** Persist one explicit same-repository worktree association for a stable Pi session. */
+export async function setSessionRepositoryContext(identity, worktreePath, options = {}) {
+    const header = await readSessionHeader(identity);
+    const startup = await readGitWorktreeIdentity(header.cwd, false, options.signal);
+    const selected = await readGitWorktreeIdentity(worktreePath, true, options.signal);
+    if (!samePath(startup.commonDir, selected.commonDir)) {
+        throw new Error("associated worktree belongs to a different Git repository");
+    }
+    const record = {
+        schema: SCHEMA,
+        sessionId: header.id,
+        sessionFile: header.file,
+        startupRoot: startup.root,
+        startupCommonDir: startup.commonDir,
+        worktreeRoot: selected.root,
+        worktreeCommonDir: selected.commonDir,
+        worktreeGitDir: selected.gitDir,
+        updatedAt: new Date().toISOString(),
+    };
+    const destination = recordPath(header, options);
+    const directory = dirname(destination);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const temporary = `${destination}.${process.pid}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(record)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+        await rename(temporary, destination);
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => undefined);
+    }
+    return { cwd: selected.root, branch: requireBranch(selected) };
+}
+/** Remove only the association belonging to the supplied stable session. */
+export async function clearSessionRepositoryContext(identity, options = {}) {
+    const header = await readSessionHeader(identity);
+    await rm(recordPath(header, options), { force: true });
+}
+/** Read and revalidate a persisted association; malformed or stale state fails closed to absence. */
+export async function readSessionRepositoryContext(identity, options = {}) {
+    let header;
+    try {
+        header = await readSessionHeader(identity);
+    }
+    catch {
+        return null;
+    }
+    try {
+        const path = recordPath(header, options);
+        const metadata = await lstat(path);
+        if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size === 0 || metadata.size > MAX_RECORD_BYTES)
+            return null;
+        const bytes = await readFile(path, { signal: options.signal });
+        const value = JSON.parse(bytes.toString("utf8"));
+        if (!isRecord(value)
+            || value.schema !== SCHEMA
+            || value.sessionId !== header.id
+            || value.sessionFile !== header.file
+            || !validPath(value.startupRoot)
+            || !validPath(value.startupCommonDir)
+            || !validPath(value.worktreeRoot)
+            || !validPath(value.worktreeCommonDir)
+            || !validPath(value.worktreeGitDir)
+            || typeof value.updatedAt !== "string")
+            return null;
+        const startup = await readGitWorktreeIdentity(header.cwd, false, options.signal);
+        const selected = await readGitWorktreeIdentity(value.worktreeRoot, true, options.signal);
+        if (!samePath(startup.root, value.startupRoot)
+            || !samePath(startup.commonDir, value.startupCommonDir)
+            || !samePath(selected.root, value.worktreeRoot)
+            || !samePath(selected.commonDir, value.worktreeCommonDir)
+            || !samePath(selected.gitDir, value.worktreeGitDir)
+            || !samePath(startup.commonDir, selected.commonDir))
+            return null;
+        return { cwd: selected.root, branch: requireBranch(selected) };
+    }
+    catch {
+        return null;
+    }
+}
+async function readSessionHeader(identity) {
+    if (!validSessionId(identity.sessionId) || !validPath(identity.sessionFile))
+        throw new Error("active session identity is unavailable");
+    const file = await realpath(resolve(identity.sessionFile));
+    const handle = await open(file, "r");
+    try {
+        const buffer = Buffer.alloc(MAX_HEADER_BYTES);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.byteLength, 0);
+        const newline = buffer.subarray(0, bytesRead).indexOf(0x0a);
+        if (newline < 0)
+            throw new Error("session header is unavailable");
+        const value = JSON.parse(buffer.subarray(0, newline).toString("utf8"));
+        if (!isRecord(value) || value.type !== "session" || value.id !== identity.sessionId || !validPath(value.cwd)) {
+            throw new Error("active session identity does not match its session file");
+        }
+        return { id: identity.sessionId, cwd: await realpath(resolve(value.cwd)), file };
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function readGitWorktreeIdentity(path, requireWorktreeRoot, signal) {
+    if (!validPath(path))
+        throw new Error("associated worktree path is invalid");
+    const cwd = await realpath(resolve(path));
+    const { stdout } = await executeGit(["rev-parse", "--path-format=absolute", "--show-toplevel", "--git-common-dir", "--git-dir"], cwd, MAX_RECORD_BYTES, signal);
+    const lines = stdout.split(/\r?\n/u).filter(Boolean);
+    if (lines.length !== 3)
+        throw new Error("associated worktree identity is invalid");
+    const [rootValue, commonValue, gitValue] = lines;
+    if (!rootValue || !commonValue || !gitValue)
+        throw new Error("associated worktree identity is incomplete");
+    const root = await realpath(rootValue);
+    if (requireWorktreeRoot && !samePath(root, cwd))
+        throw new Error("associated path must be a Git worktree root");
+    const commonDir = await realpath(commonValue);
+    const gitDir = await realpath(gitValue);
+    let branch = null;
+    if (requireWorktreeRoot) {
+        const branchResult = await executeGit(["symbolic-ref", "--quiet", "--short", "HEAD"], cwd, 4_096, signal);
+        branch = branchResult.stdout.trim();
+        if (branch.length === 0 || branch.length > 256)
+            throw new Error("associated worktree has a detached or invalid branch");
+    }
+    return { root, commonDir, gitDir, branch };
+}
+async function executeGit(arguments_, cwd, maxBuffer, signal) {
+    const { execFile } = await import("node:child_process");
+    const execute = promisify(execFile);
+    return await execute("git", [...arguments_], {
+        cwd,
+        windowsHide: true,
+        timeout: GIT_TIMEOUT_MS,
+        maxBuffer,
+        encoding: "utf8",
+        signal,
+    });
+}
+function requireBranch(identity) {
+    if (identity.branch === null)
+        throw new Error("associated worktree branch is unavailable");
+    return identity.branch;
+}
+function recordPath(header, options) {
+    const dataDir = options.dataDir ?? resolveProductPaths().dataDir;
+    const digest = createHash("sha256").update(header.id).update("\0").update(pathKey(header.file)).digest("hex");
+    return join(dataDir, PRODUCT_IDENTITY.state.sessionRepositoryDirectory, `${digest}.json`);
+}
+function samePath(left, right) {
+    return pathKey(left) === pathKey(right);
+}
+function pathKey(value) {
+    const normalized = resolve(value);
+    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+function validSessionId(value) {
+    return typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/u.test(value);
+}
+function validPath(value) {
+    return typeof value === "string" && value.length > 0 && value.length <= 32_768 && !value.includes("\0") && isAbsolute(value);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

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

@@ -1,5 +1,5 @@
 import { Input, Key, getKeybindings, matchesKey, truncateToWidth, } from "@earendil-works/pi-tui";
-import { piTheme } from "./theme.js";
+import { piTheme, renderPiModalShortcutHints } from "./theme.js";
 const MAX_VISIBLE_ROWS = 10;
 const MODELS_TITLE = "Models";
 function fullModelId(model) {
@@ -228,7 +228,7 @@ export class ModelsDialogComponent {
         push();
         if (this.#refreshStatus !== undefined)
             push(theme.fg(this.#refreshStatus.kind, `  ${this.#refreshStatus.message}`));
-        push(theme.fg("dim", `  ${this.#hints().join(" · ")}`));
+        push(renderPiModalShortcutHints(this.#hints(), 2));
         push(border);
         return lines;
     }
@@ -237,13 +237,13 @@ export class ModelsDialogComponent {
         const confirm = keyLabel("tui.select.confirm");
         const save = keyLabel("app.models.save");
         return [
-            "type to search",
-            "↑↓ navigate",
-            ...(tab.length === 0 ? [] : [`${tab} filter`]),
-            ...(confirm.length === 0 ? [] : [`${confirm} switch`]),
-            "space scope",
-            ...(save.length === 0 ? [] : [`${save} save`]),
-            "esc close",
+            { action: "type to search" },
+            { key: "↑↓", action: "navigate" },
+            ...(tab.length === 0 ? [] : [{ key: tab, action: "filter" }]),
+            ...(confirm.length === 0 ? [] : [{ key: confirm, action: "switch" }]),
+            { key: "space", action: "scope" },
+            ...(save.length === 0 ? [] : [{ key: save, action: "save" }]),
+            { key: "esc", action: "close" },
         ];
     }
     #emptyText() {

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

@@ -132,9 +132,17 @@ export function createPiShellEditor(options) {
         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.map(command => autocompleteCommand(command, additions.get(command.name)));
-        // Invariant: the engine's built-in additions only decorate this profile's catalog; they never surface as resources.
-        const resources = commands.filter(command => command.source !== "builtin" && !builtInNames.has(command.name)).map(command => autocompleteCommand(command));
+        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 combined = new CombinedAutocompleteProvider([...builtIns, ...resources], options.cwd ?? process.cwd());
         autocompleteProvider = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
         editor.setAutocompleteProvider(autocompleteProvider);
@@ -229,10 +237,26 @@ export function createPiShellEditor(options) {
             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))))
                 return;
+            const hadDraft = editor.getText().length > 0;
             if (editorUx === undefined)
                 editor.handleInput(data);
             else
                 editorUx.handleInput(data);
+            if (editorUx === undefined || !hadDraft || editor.getText().length > 0)
+                return;
+            // Invariant: Pi's deletion paths can leave a visible or debounced autocomplete request owned by
+            // the removed draft. Reapplying empty text cancels both forms without a duplicate change notice.
+            const onChange = editor.onChange;
+            delete editor.onChange;
+            try {
+                editor.setText("");
+            }
+            finally {
+                if (onChange === undefined)
+                    delete editor.onChange;
+                else
+                    editor.onChange = onChange;
+            }
         },
         invalidate: () => editor.invalidate(),
         setFocused: focused => {

package/dist/integrations/pi/components/shell-extension-ui.js

@@ -1,5 +1,7 @@
-import { ExtensionInputComponent, ExtensionSelectorComponent, getSelectListTheme, } from "../startup-public.js";
-import { ExtensionEditorComponent, } from "./upstream/components/extension-editor.js";
+import { getSelectListTheme, } from "../startup-public.js";
+import { ExtensionEditorComponent } from "./upstream/components/extension-editor.js";
+import { ExtensionInputComponent } from "./upstream/components/extension-input.js";
+import { ExtensionSelectorComponent } from "./upstream/components/extension-selector.js";
 import { setKeybindings, Text, } from "@earendil-works/pi-tui";
 import { KeybindingsManager, } from "./upstream/adjacent/core/keybindings.js";
 import { PINNED_PI_LAYOUT, applyPiTheme, applyPiThemeInstance, getAvailablePiThemes, loadPiTheme, piTheme, } from "./theme.js";

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

@@ -165,7 +165,7 @@ function liveWorkingText(view, workingOverride, progressPresentation) {
     const message = workingOverride ?? view.status.workingMessage ?? "Working";
     const progress = view.status.workingProgress;
     return workingOverride === undefined && progressPresentation === "custom-viewport" && typeof progress === "number"
-        ? `${message} (${progress}%)`
+        ? `${message}(${progress}%)`
         : message;
 }
 function statusComponent(view, ui, outputPad, liveStatusText, placement) {

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

@@ -191,9 +191,11 @@ export function renderPiShellPackageUpdateNotice(packages, width) {
 function transcriptComponent(block, cwd, expanded, extensions, submittedPrompt, outputPad, hideThinkingBlock, mermaidRenderingMode, showImages, imageWidthCells, imageAssets, tui) {
     switch (block.kind) {
         case "user": {
-            const skill = parseSkillBlock(block.text);
+            const visibleBlock = submittedPrompt === undefined || block.userPresentation === undefined ? block
+                : { ...block, text: block.userPresentation.visibleText };
+            const skill = parseSkillBlock(visibleBlock.text);
             if (!skill)
-                return submittedPrompt ? createPiSubmittedPromptComponent(block, submittedPrompt) : new UserMessageComponent(block.text);
+                return submittedPrompt ? createPiSubmittedPromptComponent(visibleBlock, submittedPrompt) : new UserMessageComponent(visibleBlock.text);
             const invocation = new SkillInvocationMessageComponent(skill, getMarkdownTheme());
             invocation.setExpanded(expanded);
             if (!skill.userMessage)

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

@@ -11,6 +11,8 @@ export interface PiShellSkillSummary {
 }
 export interface PiShellCollapsedSkillCommands {
     readonly commands: readonly PiShellAutocompleteCommand[];
+    /** The synthetic command replacing the withheld entries, when skill commands were present. */
+    readonly collapsedCommand?: PiShellAutocompleteCommand;
     /** The skills withheld from the top-level menu, in the engine's discovery order. */
     readonly skills: readonly PiShellSkillSummary[];
 }

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

@@ -27,6 +27,15 @@ export function collapseSkillCommands(commands) {
     if (skills.length === 0)
         return { commands, skills };
     const collapsed = [];
+    const collapsedCommand = {
+        name: SKILLS_COMMAND_NAME,
+        description: SKILLS_COMMAND_DESCRIPTION,
+        argumentOptions: skills.map(skill => ({
+            id: skill.name,
+            label: skill.name,
+            ...(skill.description.length === 0 ? {} : { description: skill.description }),
+        })),
+    };
     let inserted = false;
     for (const command of commands) {
         if (!command.name.startsWith(SKILL_COMMAND_PREFIX)) {
@@ -36,17 +45,9 @@ export function collapseSkillCommands(commands) {
         if (inserted)
             continue;
         inserted = true;
-        collapsed.push({
-            name: SKILLS_COMMAND_NAME,
-            description: SKILLS_COMMAND_DESCRIPTION,
-            argumentOptions: skills.map(skill => ({
-                id: skill.name,
-                label: skill.name,
-                ...(skill.description.length === 0 ? {} : { description: skill.description }),
-            })),
-        });
+        collapsed.push(collapsedCommand);
     }
-    return { commands: collapsed, skills };
+    return { commands: collapsed, collapsedCommand, skills };
 }
 /** Case-insensitive substring match on the name or description; a leading `skill:`/`skills:` in the query is ignored for the name. */
 export function skillMatchesQuery(skill, query) {

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

@@ -1,6 +1,6 @@
-import { DynamicBorder, keyHint, rawKeyHint } from "../startup-public.js";
+import { DynamicBorder } from "../startup-public.js";
 import { Container, getKeybindings, Input, Spacer, Text } from "@earendil-works/pi-tui";
-import { PINNED_PI_LAYOUT, piTheme } from "./theme.js";
+import { PINNED_PI_LAYOUT, piTheme, renderPiModalShortcutHints } from "./theme.js";
 import { componentPort, ensureTheme, piShellTruncateToWidth, piShellVisibleWidth } from "./shell-shared-facade.js";
 import { SKILL_COMMAND_PREFIX, skillMatchesQuery } from "./skills-command.js";
 /** A single line clipped at the viewport width: no wrap, no ellipsis, padded to the full width. */
@@ -44,7 +44,12 @@ class SkillsSelectorComponent extends Container {
         this.addChild(new Spacer(1));
         this.addChild(this.#listContainer);
         this.addChild(new Spacer(1));
-        this.addChild(new Text(`  ${rawKeyHint("↑↓", "navigate")}  ${keyHint("tui.select.confirm", "select")}  ${keyHint("tui.select.cancel", "cancel")}`, 0, 0));
+        const bindings = getKeybindings();
+        this.addChild(new Text(renderPiModalShortcutHints([
+            { key: "↑↓", action: "navigate" },
+            { key: bindings.getKeys("tui.select.confirm").join("/"), action: "select" },
+            { key: bindings.getKeys("tui.select.cancel").join("/"), action: "cancel" },
+        ], 2), 0, 0));
         this.addChild(new DynamicBorder());
         this.#updateList();
     }

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

@@ -1 +1,5 @@
+import { type SemanticShortcutHint } from "../../../contracts/presentation/index.js";
 export * from "./upstream/theme/theme.js";
+export type PiModalShortcutHint = SemanticShortcutHint;
+/** The common bare-A1 modal footer: quiet display-cased keys, muted names, and whitespace-only gaps. */
+export declare function renderPiModalShortcutHints(entries: readonly PiModalShortcutHint[], indent?: number): string;

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

@@ -1 +1,11 @@
+import { renderSemanticShortcutHints, } from "../../../contracts/presentation/index.js";
+import { piTheme } from "./upstream/theme/theme.js";
 export * from "./upstream/theme/theme.js";
+/** The common bare-A1 modal footer: quiet display-cased keys, muted names, and whitespace-only gaps. */
+export function renderPiModalShortcutHints(entries, indent = 0) {
+    const theme = piTheme();
+    return renderSemanticShortcutHints(entries, {
+        key: text => theme.fg("dim", text),
+        action: text => theme.fg("muted", text),
+    }, indent);
+}

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

@@ -139,7 +139,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Copy selection or last assistant message";
     };
     readonly "app.message.followUp": {
-        readonly defaultKeys: "ctrl+q" | "alt+enter";
+        readonly defaultKeys: "alt+enter" | "ctrl+q";
         readonly description: "Queue follow-up message";
     };
     readonly "app.message.dequeue": {
@@ -147,7 +147,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Restore queued messages";
     };
     readonly "app.clipboard.pasteImage": {
-        readonly defaultKeys: "ctrl+v" | "alt+v";
+        readonly defaultKeys: "alt+v" | "ctrl+v";
         readonly description: "Paste image from clipboard (text fallback)";
     };
     readonly "app.session.new": {
@@ -167,11 +167,11 @@ export declare const KEYBINDINGS: {
         readonly description: "Resume a session";
     };
     readonly "app.tree.foldOrUp": {
-        readonly defaultKeys: ("ctrl+left" | "alt+left")[];
+        readonly defaultKeys: ("alt+left" | "ctrl+left")[];
         readonly description: "Fold tree branch or move up";
     };
     readonly "app.tree.unfoldOrDown": {
-        readonly defaultKeys: ("ctrl+right" | "alt+right")[];
+        readonly defaultKeys: ("alt+right" | "ctrl+right")[];
         readonly description: "Unfold tree branch or move down";
     };
     readonly "app.tree.editLabel": {

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

@@ -3,8 +3,8 @@
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,
- * cancellation, and external-editor lifecycle.
- * Deviations: none.
+ * cancellation, and external-editor lifecycle; bare A1 uses the shared semantic modal shortcut row.
+ * Deviations: owned-modal-shortcut-hints.
  */
 import { Container, type TUI } from "@earendil-works/pi-tui";
 import type { KeybindingsManager } from "../adjacent/core/keybindings.js";

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

@@ -3,16 +3,13 @@
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,
- * cancellation, and external-editor lifecycle.
- * Deviations: none.
+ * cancellation, and external-editor lifecycle; bare A1 uses the shared semantic modal shortcut row.
+ * Deviations: owned-modal-shortcut-hints.
  */
 import { Container, Editor, Spacer, Text, } from "@earendil-works/pi-tui";
 import { DynamicBorder, getSelectListTheme } from "../../../startup-public.js";
 import { editInExternalEditor } from "../external-editor.js";
-import { piTheme } from "../../theme.js";
-function keyHint(keybindings, keybinding, description) {
-    return piTheme().fg("dim", keybindings.getKeys(keybinding).join("/")) + piTheme().fg("muted", ` ${description}`);
-}
+import { piTheme, renderPiModalShortcutHints } from "../../theme.js";
 export class ExtensionEditorComponent extends Container {
     #editor;
     #tui;
@@ -54,10 +51,12 @@ export class ExtensionEditorComponent extends Container {
         this.#editor.onSubmit = onSubmit;
         this.addChild(this.#editor);
         this.addChild(new Spacer(1));
-        const hint = keyHint(this.#keybindings, "tui.select.confirm", "submit")
-            + "  " + keyHint(this.#keybindings, "tui.input.newLine", "newline")
-            + "  " + keyHint(this.#keybindings, "tui.select.cancel", "cancel")
-            + "  " + keyHint(this.#keybindings, "app.editor.external", "external editor");
+        const hint = renderPiModalShortcutHints([
+            { key: this.#keybindings.getKeys("tui.select.confirm").join("/"), action: "submit" },
+            { key: this.#keybindings.getKeys("tui.input.newLine").join("/"), action: "newline" },
+            { key: this.#keybindings.getKeys("tui.select.cancel").join("/"), action: "cancel" },
+            { key: this.#keybindings.getKeys("app.editor.external").join("/"), action: "external editor" },
+        ]);
         this.addChild(new Text(hint, 1, 0));
         this.addChild(new Spacer(1));
         this.addChild(new DynamicBorder());

package/dist/integrations/pi/components/upstream/components/extension-input.d.ts

@@ -0,0 +1,17 @@
+import { Container, type TUI } from "@earendil-works/pi-tui";
+interface ExtensionInputOptions {
+    readonly tui?: TUI;
+    readonly timeout?: number;
+    readonly description?: string;
+    readonly initialValue?: string;
+}
+/** Bare-A1 extension text input using the common modal shortcut row. */
+export declare class ExtensionInputComponent extends Container {
+    #private;
+    get focused(): boolean;
+    set focused(value: boolean);
+    constructor(title: string, _placeholder: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, opts?: ExtensionInputOptions);
+    handleInput(keyData: string): void;
+    dispose(): void;
+}
+export {};

package/dist/integrations/pi/components/upstream/components/extension-input.js

@@ -0,0 +1,72 @@
+/**
+ * Provenance: @earendil-works/pi-coding-agent 0.87.0 (MIT), commit 16787ad5b2dc748047f314ca1bfe7708f30f54f3,
+ * packages/coding-agent/src/modes/interactive/components/extension-input.ts.
+ * Modifications: Mechanical port: remap public imports, use ECMAScript private fields, and route the
+ * bare-A1 instruction row through the shared semantic shortcut renderer while preserving input,
+ * timeout, focus, submission, cancellation, and disposal behavior.
+ * Deviations: owned-modal-shortcut-hints.
+ */
+import { DynamicBorder } from "../../../startup-public.js";
+import { Container, getKeybindings, Input, Spacer, Text } from "@earendil-works/pi-tui";
+import { piTheme, renderPiModalShortcutHints } from "../../theme.js";
+import { CountdownTimer } from "./countdown-timer.js";
+/** Bare-A1 extension text input using the common modal shortcut row. */
+export class ExtensionInputComponent extends Container {
+    #input = new Input();
+    #onSubmit;
+    #onCancel;
+    #titleText;
+    #baseTitle;
+    #countdown;
+    #focused = false;
+    get focused() { return this.#focused; }
+    set focused(value) {
+        this.#focused = value;
+        this.#input.focused = value;
+    }
+    constructor(title, _placeholder, onSubmit, onCancel, opts) {
+        super();
+        this.#onSubmit = onSubmit;
+        this.#onCancel = onCancel;
+        this.#baseTitle = title;
+        const theme = piTheme();
+        this.addChild(new DynamicBorder());
+        this.addChild(new Spacer(1));
+        this.#titleText = new Text(theme.fg("accent", title), 1, 0);
+        this.addChild(this.#titleText);
+        if (opts?.description) {
+            this.addChild(new Spacer(1));
+            this.addChild(new Text(theme.fg("text", opts.description), 1, 0));
+        }
+        this.addChild(new Spacer(1));
+        this.#countdown = opts?.timeout !== undefined && opts.timeout > 0 && opts.tui !== undefined
+            ? new CountdownTimer(opts.timeout, opts.tui, seconds => {
+                const current = piTheme();
+                this.#titleText.setText(current.fg("accent", `${this.#baseTitle} (${seconds}s)`));
+            }, () => this.#onCancel())
+            : undefined;
+        if (opts?.initialValue !== undefined)
+            this.#input.setValue(opts.initialValue);
+        this.addChild(this.#input);
+        this.addChild(new Spacer(1));
+        const keys = getKeybindings();
+        this.addChild(new Text(renderPiModalShortcutHints([
+            { key: keys.getKeys("tui.select.confirm").join("/"), action: "submit" },
+            { key: keys.getKeys("tui.select.cancel").join("/"), action: "cancel" },
+        ]), 1, 0));
+        this.addChild(new Spacer(1));
+        this.addChild(new DynamicBorder());
+    }
+    handleInput(keyData) {
+        const keys = getKeybindings();
+        if (keys.matches(keyData, "tui.select.confirm") || keyData === "\n")
+            this.#onSubmit(this.#input.getValue());
+        else if (keys.matches(keyData, "tui.select.cancel"))
+            this.#onCancel();
+        else
+            this.#input.handleInput(keyData);
+    }
+    dispose() {
+        this.#countdown?.dispose();
+    }
+}

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

@@ -0,0 +1,15 @@
+import { Container, type TUI } from "@earendil-works/pi-tui";
+interface ExtensionSelectorOptions {
+    readonly tui?: TUI;
+    readonly timeout?: number;
+    readonly description?: string;
+    readonly onToggleToolsExpanded?: () => void;
+}
+/** Bare-A1 extension selector using the common modal shortcut row. */
+export declare class ExtensionSelectorComponent extends Container {
+    #private;
+    constructor(title: string, options: readonly string[], onSelect: (value: string) => void, onCancel: () => void, opts?: ExtensionSelectorOptions);
+    handleInput(keyData: string): void;
+    dispose(): void;
+}
+export {};