@timurproko/a1 0.1.8-dev.299 → 0.1.8-dev.322

package/dist/foundation/release/update-recovery.js

@@ -5,6 +5,7 @@ import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
 import { processIsAlive } from "./process-cleanup.js";
+import { PRIVATE_LAUNCH_CONTRACT, assertCurrentLaunchContract } from "../launch-context/index.js";
 export const UPDATE_RECOVERY_SCHEMA = "a1-update-recovery-v1";
 const WORKER_TIMEOUT_MS = 15 * 60 * 1_000;
 const POLL_MS = 50;
@@ -18,6 +19,7 @@ export function updateLauncherPaths(globalRoot, platform = process.platform) {
 /** Validate transaction-scoped recovery authority without trusting npm temporary names. */
 export async function readUpdateRecoveryCapsule(manifestPath, platform = process.platform) {
     const capsule = JSON.parse(await readFile(manifestPath, "utf8"));
+    assertCurrentLaunchContract(capsule);
     if (capsule.schema !== UPDATE_RECOVERY_SCHEMA || !/^[0-9a-f-]{36}$/i.test(capsule.transactionId) || typeof capsule.targetVersion !== "string"
         || capsule.packageName !== PRODUCT_TEXT.packageName || typeof capsule.packageRoot !== "string" || typeof capsule.globalRoot !== "string"
         || typeof capsule.launcherRoot !== "string" || !Array.isArray(capsule.launchers) || typeof capsule.priorReleaseId !== "string"
@@ -59,6 +61,7 @@ export async function readUpdateRecoveryCapsule(manifestPath, platform = process
     if (priorReleaseRoot.split(sep).at(-1) !== capsule.priorReleaseId)
         throw new Error("recovery prior release identity is invalid");
     const priorManifest = JSON.parse(await readFile(resolve(priorReleaseRoot, capsule.releaseManifestName), "utf8"));
+    assertCurrentLaunchContract(priorManifest);
     if (priorManifest.releaseId !== capsule.priorReleaseId || priorManifest.contentDigest !== capsule.priorContentDigest) {
         throw new Error("recovery prior release manifest differs from the capsule");
     }
@@ -95,6 +98,7 @@ export async function prepareUpdateRecoveryCapsule(options) {
         const npmCli = await resolveNpmCli(canonicalGlobal, options.environment ?? process.env);
         const capsule = {
             schema: UPDATE_RECOVERY_SCHEMA,
+            launchContract: PRIVATE_LAUNCH_CONTRACT,
             transactionId: options.transaction.transactionId,
             packageName: PRODUCT_TEXT.packageName,
             targetVersion: options.transaction.targetVersion,

package/dist/foundation/release/update.js

@@ -13,6 +13,7 @@ import { cleanupVerifiedOwner, processIsAlive } from "./process-cleanup.js";
 import { materializeRelease, readMaterializedRelease } from "./release-store.js";
 import { scheduleReleaseCleanup } from "./release-gc.js";
 import { warmMaterializedRelease } from "./warmup.js";
+import { assertCurrentLaunchContract } from "../launch-context/index.js";
 import { UpdateTransactionStore } from "./update-transaction.js";
 import { removeUpdateRecoveryCapsule, runProtectedPackageReplacement } from "./update-recovery.js";
 export const PRODUCT_PACKAGE = PRODUCT_TEXT.packageName;
@@ -77,6 +78,8 @@ export function createUpdateLifecycleCoordinator(environment = process.env, file
         async targetIsActive(targetVersion) {
             const state = await stateStore.read();
             const activeId = state.references.active;
+            if (activeId)
+                assertCurrentLaunchContract(state.releases[activeId] ?? {});
             if (!activeId || state.releases[activeId]?.packageVersion !== targetVersion)
                 return false;
             const endpoint = await readActiveEndpoint(paths, activeId, environment);
@@ -85,6 +88,8 @@ export function createUpdateLifecycleCoordinator(environment = process.env, file
         async shutdownVerifiedOwners(targetVersion) {
             const state = await stateStore.read();
             const activeId = state.references.active;
+            if (activeId)
+                assertCurrentLaunchContract(state.releases[activeId] ?? {});
             const priorActiveVersion = activeId ? state.releases[activeId]?.packageVersion ?? null : null;
             const owner = await readActiveEndpoint(paths, activeId, environment);
             if (!owner)

package/dist/foundation/release/warmup.d.ts

@@ -1,3 +1,3 @@
-import type { MaterializedRelease } from "./release-store.js";
+import { type MaterializedRelease } from "./release-store.js";
 /** Import the exact immutable startup graph in a terminal-free bounded child process. */
 export declare function warmMaterializedRelease(release: MaterializedRelease, environment: NodeJS.ProcessEnv, timeoutMs?: number): Promise<void>;

package/dist/foundation/release/warmup.js

@@ -1,13 +1,14 @@
 import { spawn } from "node:child_process";
-import { resolve } from "node:path";
+import { resolveReleaseEntryPoint } from "./release-store.js";
 import { releaseEnvironment } from "./bootstrap.js";
-import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { PRIVATE_ENVIRONMENT, assertCurrentLaunchContract } from "../launch-context/index.js";
 /** Import the exact immutable startup graph in a terminal-free bounded child process. */
 export async function warmMaterializedRelease(release, environment, timeoutMs = 30_000) {
-    const entry = resolve(release.releaseRoot, "bin", "warmup.js");
+    assertCurrentLaunchContract(release);
+    const entry = await resolveReleaseEntryPoint(release, "bin/warmup.js");
     await new Promise((resolvePromise, rejectPromise) => {
         const child = spawn(process.execPath, [entry], {
-            env: { ...releaseEnvironment(environment, release), [PRODUCT_IDENTITY.environment.immutableWarmup]: "1" },
+            env: { ...releaseEnvironment(environment, release), [PRIVATE_ENVIRONMENT.immutableWarmup]: "1" },
             stdio: "ignore",
             windowsHide: true,
         });

package/dist/foundation/startup/startup-runtime.js

@@ -5,18 +5,20 @@ import { dirname, resolve } from "node:path";
 import { homedir, platform } from "node:os";
 import { performance } from "node:perf_hooks";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { readLaunchContext } from "../launch-context/index.js";
 /** Initialize opt-in startup tracing from a caller-provided evidence path. */
 export function initializeStartupTrace(environment, profileId, startedAtMs = performance.timeOrigin + performance.now()) {
     const configured = environment[PRODUCT_IDENTITY.environment.startupTrace];
     if (!configured || parseContext(configured) !== null)
         return;
+    const launch = readLaunchContext(environment);
     const context = {
         path: resolve(configured),
         traceId: randomUUID(),
         startedAtMs,
         profileId,
-        releaseId: environment[PRODUCT_IDENTITY.environment.releaseId] ?? null,
-        dependencyLayerIds: parseLayerIds(environment[PRODUCT_IDENTITY.environment.releaseLayers]),
+        releaseId: launch.releaseId ?? null,
+        dependencyLayerIds: parseLayerIds(launch.releaseLayers),
     };
     environment[PRODUCT_IDENTITY.environment.startupTrace] = JSON.stringify(context);
 }
@@ -25,17 +27,18 @@ export async function markStartupPhase(environment, phase) {
     const context = parseContext(environment[PRODUCT_IDENTITY.environment.startupTrace]);
     if (context === null)
         return;
+    const elapsedMs = Math.max(0, performance.timeOrigin + performance.now() - context.startedAtMs);
+    const launch = readLaunchContext(environment);
+    const dependencyLayerIds = parseLayerIds(launch.releaseLayers);
     const event = {
         schema: PRODUCT_IDENTITY.evidence.startupTraceSchema,
         traceId: context.traceId,
         phase,
-        elapsedMs: Math.max(0, performance.timeOrigin + performance.now() - context.startedAtMs),
+        elapsedMs,
         processId: process.pid,
         profileId: context.profileId,
-        releaseId: environment[PRODUCT_IDENTITY.environment.releaseId] ?? context.releaseId,
-        dependencyLayerIds: parseLayerIds(environment[PRODUCT_IDENTITY.environment.releaseLayers]).length > 0
-            ? parseLayerIds(environment[PRODUCT_IDENTITY.environment.releaseLayers])
-            : context.dependencyLayerIds,
+        releaseId: launch.releaseId ?? context.releaseId,
+        dependencyLayerIds: dependencyLayerIds.length > 0 ? dependencyLayerIds : context.dependencyLayerIds,
         nodeVersion: process.version,
         fileReadOperations: process.resourceUsage().fsRead,
     };
@@ -43,9 +46,7 @@ export async function markStartupPhase(environment, phase) {
     await appendFile(context.path, `${JSON.stringify(event)}\n`, { encoding: "utf8", mode: 0o600 });
 }
 export function assertImmutableWarmupEnvironment(environment) {
-    if (environment[PRODUCT_IDENTITY.environment.immutableWarmup] !== "1") {
-        throw new Error("warmup entry is private to verified update activation");
-    }
+    readLaunchContext(environment, "warmup");
 }
 /** Enable the compile cache directly from launch environment without loading profile services. */
 export function enableEnvironmentCompileCache(environment) {
@@ -54,7 +55,8 @@ export function enableEnvironmentCompileCache(environment) {
         ?? (platform() === "win32"
             ? resolve(environment.LOCALAPPDATA ?? home, PRODUCT_IDENTITY.state.windowsControlDirectory)
             : resolve(environment.XDG_DATA_HOME ?? resolve(home, ".local", "share"), PRODUCT_IDENTITY.state.unixControlDirectory)));
-    return enableStartupCompileCache(dataDir, environment[PRODUCT_IDENTITY.environment.releaseId] ?? null, parseLayerIds(environment[PRODUCT_IDENTITY.environment.releaseLayers]));
+    const launch = readLaunchContext(environment);
+    return enableStartupCompileCache(dataDir, launch.releaseId ?? null, parseLayerIds(launch.releaseLayers));
 }
 /** Enable Node's supported persistent compile cache in an immutable-identity namespace. */
 export function enableStartupCompileCache(dataDir, releaseId, dependencyLayerIds) {

package/dist/foundation/supervision/main.js

@@ -6,16 +6,18 @@ import { publishSupervisorStartupResult, supervisorStartupFailure, supervisorSta
 import { ControlStore } from "../storage/index.js";
 import { resolveCohortEndpoint, resolveProductPaths } from "./paths.js";
 import { SupervisorServer } from "./server.js";
-import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
+import { PRODUCT_TEXT } from "../../product-identity.js";
+import { readLaunchContext } from "../launch-context/index.js";
 export async function runSupervisor(arguments_ = []) {
     const productPaths = resolveProductPaths();
     mkdirSync(productPaths.runtimeDir, { recursive: true, mode: 0o700 });
     mkdirSync(productPaths.endpointsDir, { recursive: true, mode: 0o700 });
     let paths = productPaths;
     const log = (message) => appendFileSync(paths.supervisorLogPath, `${new Date().toISOString()} ${message}\n`);
-    const releaseRoot = process.env[PRODUCT_IDENTITY.environment.releaseRoot];
-    const releaseId = process.env[PRODUCT_IDENTITY.environment.releaseId];
-    const contentDigest = process.env[PRODUCT_IDENTITY.environment.releaseDigest];
+    const context = readLaunchContext(process.env, "release");
+    const releaseRoot = context.releaseRoot;
+    const releaseId = context.releaseId;
+    const contentDigest = context.releaseDigest;
     const attemptId = startupAttempt(arguments_);
     const resultPath = attemptId ? supervisorStartupResultPath(productPaths.runtimeDir, attemptId) : null;
     let stage = "release-environment";
@@ -24,9 +26,8 @@ export async function runSupervisor(arguments_ = []) {
         if (!releaseRoot || !releaseId || !contentDigest)
             throw new Error(PRODUCT_TEXT.diagnostic("supervisor must be launched from a verified immutable release"));
         stage = "release-certification";
-        const release = await readCertifiedReleaseManifest({ releaseRoot, releaseId, contentDigest }, resolve(paths.dataDir, "releases"), { allowLegacyParentCertification: true });
-        // Compatibility: an older updater may have written release evidence before restart seals
-        // existed, even when its layer certification has already been upgraded by a retry.
+        const release = await readCertifiedReleaseManifest({ releaseRoot, releaseId, contentDigest }, resolve(paths.dataDir, "releases"));
+        // Invariant: readiness follows current-contract certification, never an old-updater upgrade path.
         await recordParentCertifiedRelease(release, paths.dataDir);
         stage = "immutable-root";
         await assertImmutableExecutionRoot(release, paths.dataDir);

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

@@ -52,6 +52,7 @@ export interface PromptSelectionUxOptions {
     };
     readonly transformPastedContent: (content: PiShellClipboardContent) => string;
     readonly atomicRanges: (line: string) => readonly PiShellEditorTextRange[];
+    readonly hiddenRanges?: (line: string) => readonly PiShellEditorTextRange[];
     readonly expandCopiedText: (text: string) => string;
     readonly paintSelection: (line: string, from: number, to: number, atomic: boolean) => string;
     readonly decorateRow: (row: string, width: number) => string;

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

@@ -202,6 +202,47 @@ class PromptSelectionInterceptor {
             this.#redoStack = [];
     }
     render(width, next) {
+        const state = editorState(this.editor);
+        const hidden = state.lines.map(line => this.options.hiddenRanges?.(line) ?? []);
+        if (!hidden.some(ranges => ranges.length > 0))
+            return this.#renderVisible(width, next);
+        const original = { ...state, lines: [...state.lines] };
+        const selection = this.#selection;
+        const project = (position) => ({
+            line: position.line,
+            col: hideColumn(position.col, hidden[position.line] ?? []),
+        });
+        const lines = state.lines.map((line, index) => {
+            for (const range of [...(hidden[index] ?? [])].reverse())
+                line = line.slice(0, range.start) + line.slice(range.end);
+            return line;
+        });
+        // Rationale: project pending clipboard identities out before layout, not after painting.
+        // Keep the semantic draft/undo/submission markers intact and restore them even if rendering throws.
+        try {
+            this.#setRenderState(lines, project({ line: original.cursorLine, col: original.cursorCol }));
+            if (selection !== undefined)
+                this.#selection = { anchor: project(selection.anchor), head: project(selection.head) };
+            const rows = this.#renderVisible(width, next);
+            if (this.#geometry !== undefined) {
+                this.#geometry.hiddenRanges = hidden;
+                this.#geometry.lines = lines;
+            }
+            return rows;
+        }
+        finally {
+            this.#setRenderState(original.lines, { line: original.cursorLine, col: original.cursorCol });
+            this.#selection = selection;
+        }
+    }
+    #setRenderState(lines, cursor) {
+        if (this.editor.interaction !== undefined)
+            this.editor.interaction.replaceLines(lines);
+        else
+            editorState(this.editor).lines = lines;
+        this.#setCursor(cursor);
+    }
+    #renderVisible(width, next) {
         const rows = next().map(row => row.replaceAll(ATOMIC_SPACE_SENTINEL, " "));
         const maxPadding = Math.max(0, Math.floor((width - 1) / 2));
         const padding = Math.min(this.editor.getPaddingX(), maxPadding);
@@ -214,7 +255,7 @@ class PromptSelectionInterceptor {
         const scrollOffset = this.editor.interaction?.scrollOffset() ?? numericProperty(this.editor, "scrollOffset");
         const maxVisibleLines = Math.max(5, Math.floor(this.options.getRows() * 0.3));
         const textRows = Math.max(0, Math.min(visualLines.length - scrollOffset, maxVisibleLines, rows.length - 2));
-        this.#geometry = { width, padding, layoutWidth, visualLines, scrollOffset, textRows };
+        this.#geometry = { width, padding, layoutWidth, visualLines, scrollOffset, textRows, hiddenRanges: [] };
         if (this.#atomicFocus() !== undefined) {
             for (let row = 0; row < rows.length; row += 1) {
                 rows[row] = (rows[row] ?? "").replaceAll(CURSOR_MARKER, "");
@@ -344,12 +385,12 @@ class PromptSelectionInterceptor {
         const visual = geometry.visualLines[geometry.scrollOffset + textRow];
         if (visual === undefined)
             return undefined;
-        const line = editorState(this.editor).lines[visual.logicalLine] ?? "";
+        const line = (geometry.lines ?? editorState(this.editor).lines)[visual.logicalLine] ?? "";
         const segment = line.slice(visual.startCol, visual.startCol + visual.length);
         const displayColumn = Math.max(0, column - 1 - geometry.padding - (this.options.promptPrefixWidth ?? 0));
         return {
             line: visual.logicalLine,
-            col: visual.startCol + indexAtDisplayWidth(segment, displayColumn),
+            col: restoreColumn(visual.startCol + indexAtDisplayWidth(segment, displayColumn), geometry.hiddenRanges[visual.logicalLine] ?? []),
         };
     }
     #selectWord(position) {
@@ -804,6 +845,16 @@ function samePosition(left, right) {
 function sameSnapshot(left, right) {
     return left.text === right.text && samePosition(left.cursor, right.cursor);
 }
+function hideColumn(column, ranges) {
+    return column - ranges.reduce((removed, range) => removed + Math.max(0, Math.min(column, range.end) - range.start), 0);
+}
+function restoreColumn(column, ranges) {
+    let restored = column;
+    for (const range of ranges)
+        if (restored >= range.start)
+            restored += range.end - range.start;
+    return restored;
+}
 function editorState(editor) {
     if (editor.interaction !== undefined)
         return editor.interaction.snapshot();

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

@@ -64,6 +64,7 @@ export function createPiShellEditor(options) {
                 ...(options.beginClipboardPaste === undefined ? {} : { beginClipboardPaste: options.beginClipboardPaste }),
                 transformPastedContent: options.transformPastedContent ?? (content => content.kind === "text" ? content.text : ""),
                 atomicRanges: options.editorAtomicRanges ?? (() => []),
+                hiddenRanges: options.editorHiddenRanges ?? (() => []),
                 expandCopiedText: options.expandCopiedEditorText ?? (text => text),
                 paintSelection: options.paintEditorSelection ?? (line => line),
                 decorateRow: options.decorateEditorRow ?? (row => row),
@@ -149,6 +150,8 @@ export function createPiShellEditor(options) {
     return {
         render: width => editorUx?.render(width) ?? editor.render(width),
         activateKeybindings: () => setKeybindings(keybindings),
+        keybindingConfig: () => keybindings.getEffectiveConfig(),
+        reloadKeybindings: () => { keybindings.reload(); setKeybindings(keybindings); },
         matchesTerminalKey: (data, key) => matchesKey(data, key),
         handleInput: data => {
             if (editorUx === undefined)

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

@@ -1,4 +1,5 @@
-import { type PiShellComponentPort } from "./shell-shared-facade.js";
+import { type KeybindingsConfig } from "#pi-tui";
+import { type PiShellComponentPort, type PiShellExtensionRendererResolver } from "./shell-shared-facade.js";
 export interface PiShellSessionInfoPresentation {
     readonly sessionName?: string;
     readonly stats: {
@@ -30,7 +31,13 @@ export interface PiShellSessionInfoPresentation {
     }[];
 }
 export declare function renderPiShellStatusText(message: string, width: number, outputPad?: 0 | 1): readonly string[];
+export interface PiShellCommandMessagePresentation {
+    readonly kind: "error" | "warning" | "accent" | "new" | "name" | "debug";
+    readonly message: string;
+    readonly detail?: string;
+}
+export declare function renderPiShellCommandMessage(presentation: PiShellCommandMessagePresentation, width: number, outputPad?: 0 | 1): readonly string[];
 export declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
 export declare function createPiShellCollapsedChangelog(): PiShellComponentPort;
 export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;
-export declare function createPiShellHotkeys(): PiShellComponentPort;
+export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;

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

@@ -7,6 +7,22 @@ export function renderPiShellStatusText(message, width, outputPad = PINNED_PI_LA
     ensureTheme();
     return new Text(piTheme().fg("dim", message), outputPad, 0).render(width);
 }
+export function renderPiShellCommandMessage(presentation, width, outputPad = PINNED_PI_LAYOUT.outputPad) {
+    ensureTheme();
+    const { kind, message, detail } = presentation;
+    const prefix = kind === "error" ? "Error: " : kind === "warning" ? "Warning: " : "";
+    const color = kind === "name" ? "dim" : kind === "error" || kind === "warning" ? kind : "accent";
+    const content = piTheme().fg(color, `${prefix}${message}`)
+        + (kind === "debug" && detail ? `\n${piTheme().fg("muted", detail)}` : "");
+    // Compatibility: pinned errors honor outputPad; warnings and command notices retain
+    // one-cell padding. New-session/debug notices also own one vertical padding row.
+    const text = new Text(content, kind === "error" ? outputPad : 1, kind === "new" || kind === "debug" ? 1 : 0);
+    return [
+        ...(kind === "name" && detail ? renderPiShellCommandMessage({ kind: "warning", message: detail }, width) : []),
+        ...new Spacer(1).render(width),
+        ...text.render(width),
+    ];
+}
 export function createPiShellSessionInfo(presentation) {
     ensureTheme();
     const { stats, sessionName, cacheWaste, usageBreakdown } = presentation;
@@ -61,12 +77,27 @@ export function createPiShellChangelog(markdown) {
     container.addChild(new DynamicBorder());
     return componentPort(container);
 }
-export function createPiShellHotkeys() {
+function shortcutDisplay(key) {
+    // Platform: pinned Pi labels Alt as Option on macOS, including extension shortcuts.
+    return key.split("/").map(binding => binding.split("+").map(part => {
+        const label = process.platform === "darwin" && part.toLowerCase() === "alt" ? "option" : part;
+        return label.charAt(0).toUpperCase() + label.slice(1);
+    }).join("+")).join("/");
+}
+export function createPiShellHotkeys(bindings, getShortcuts = () => [], profile = "pi") {
     ensureTheme();
-    const keys = new KeybindingsManager();
-    const display = (action) => keys.getKeys(action).map(key => key.split("+").map(part => part.charAt(0).toUpperCase() + part.slice(1)).join("+")).join("/");
+    const keys = new KeybindingsManager(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"))
+        .map(shortcutDisplay).join("/");
     const row = (actions, description) => `| ${actions.map(action => `\`${display(action)}\``).join(" / ")} | ${description} |`;
-    const 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"], "Start of line"), row(["tui.editor.cursorLineEnd"], "End of line"), 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"], "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 last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], "Paste image or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |"].join("\n");
+    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"], "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 last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], "Paste image or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |"].join("\n");
+    const shortcuts = getShortcuts(bindings ?? keys.getEffectiveConfig());
+    if (shortcuts.length > 0) {
+        markdown += "\n\n**Extensions**\n| Key | Action |\n|-----|--------|\n";
+        markdown += shortcuts.map(shortcut => `| \`${shortcutDisplay(shortcut.key)}\` | ${shortcut.description} |`).join("\n");
+    }
     const container = new Container();
     container.addChild(new Spacer(1));
     container.addChild(new DynamicBorder());

package/dist/integrations/pi/components/shell-selectors-dialogs.d.ts

@@ -67,6 +67,7 @@ export declare function createPiShellTreeSelector(options: {
     readonly onSelect: (id: string) => void;
     readonly onCancel: () => void;
     readonly onLabelChange: (entryId: string, label: string | undefined) => void;
+    readonly onCopy?: (text: string | undefined) => void;
     readonly initialSelectedId?: string;
     readonly initialFilterMode?: "default" | "no-tools" | "user-only" | "labeled-only" | "all";
 }): PiShellComponentPort;
@@ -87,7 +88,7 @@ export interface PiShellLoginDialogPort extends PiShellComponentPort {
     showWaiting(message: string): void;
     showProgress(message: string): void;
 }
-export declare function createPiShellLoginDialog(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, providerId: string, onComplete: (success: boolean, message?: string) => void, providerName?: string): PiShellLoginDialogPort;
+export declare function createPiShellLoginDialog(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">, providerId: string, onComplete: (success: boolean, message?: string) => void, providerName?: string, title?: string): PiShellLoginDialogPort;
 export declare function createPiShellArmin(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellComponentPort;
 export declare function createPiShellDaxnuts(runtime: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellComponentPort;
 export declare function createPiShellEarendilAnnouncement(): PiShellComponentPort;
@@ -104,7 +105,7 @@ export interface PiShellAuthProviderOption extends PiShellSelectorOption {
         readonly source?: string;
     };
 }
-export declare function createPiShellAuthProviderSelector(mode: "login" | "logout", providers: readonly PiShellAuthProviderOption[], onSelect: (id: string) => void, onCancel: () => void): PiShellComponentPort;
+export declare function createPiShellAuthProviderSelector(mode: "login" | "logout", providers: readonly PiShellAuthProviderOption[], onSelect: (id: string) => void, onCancel: () => void, initialSearchInput?: string): PiShellComponentPort;
 export declare function createPiShellExtensionSelector(title: string, options: readonly string[], onSelect: (value: string) => void, onCancel: () => void): PiShellComponentPort;
 export declare function createPiShellThinkingSelector(currentLevel: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", availableLevels: readonly ("off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max")[], onSelect: (level: string) => void, onCancel: () => void): PiShellComponentPort;
 export declare function createPiShellThemeSelector(currentTheme: string, onSelect: (theme: string) => void, onCancel: () => void, onPreview: (theme: string) => void): PiShellComponentPort;

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

@@ -111,7 +111,10 @@ export function createPiShellSessionSelector(options) {
 }
 export function createPiShellTreeSelector(options) {
     ensureTheme();
-    return componentPort(new TreeSelectorComponent([...options.tree], options.currentLeafId, options.terminalHeight, options.onSelect, options.onCancel, options.onLabelChange, options.initialSelectedId, options.initialFilterMode));
+    const selector = new TreeSelectorComponent([...options.tree], options.currentLeafId, options.terminalHeight, options.onSelect, options.onCancel, options.onLabelChange, options.initialSelectedId, options.initialFilterMode);
+    if (options.onCopy)
+        selector.onCopy = options.onCopy;
+    return componentPort(selector);
 }
 export function createPiShellUserMessageSelector(messages, onSelect, onCancel, initialSelectedId) {
     ensureTheme();
@@ -119,9 +122,9 @@ export function createPiShellUserMessageSelector(messages, onSelect, onCancel, i
     const list = selector.getMessageList();
     return componentPort(selector, data => list.handleInput(data));
 }
-export function createPiShellLoginDialog(runtime, providerId, onComplete, providerName) {
+export function createPiShellLoginDialog(runtime, providerId, onComplete, providerName, title) {
     ensureTheme();
-    const dialog = new LoginDialogComponent(createTuiFacade(runtime), providerId, onComplete, providerName);
+    const dialog = new LoginDialogComponent(createTuiFacade(runtime), providerId, onComplete, providerName, title);
     return {
         ...componentPort(dialog),
         showAuth: (url, instructions) => dialog.showAuth(url, instructions),
@@ -162,7 +165,7 @@ export function createPiShellReloadBox() {
     container.addChild(new DynamicBorder(borderColor));
     return componentPort(container);
 }
-export function createPiShellAuthProviderSelector(mode, providers, onSelect, onCancel) {
+export function createPiShellAuthProviderSelector(mode, providers, onSelect, onCancel, initialSearchInput) {
     ensureTheme();
     const selector = new OAuthSelectorComponent(mode, providers.map(provider => ({
         id: provider.providerId,
@@ -173,7 +176,7 @@ export function createPiShellAuthProviderSelector(mode, providers, onSelect, onC
         const selected = providers.find(provider => provider.providerId === providerId && provider.authType === authType);
         if (selected)
             onSelect(selected.id);
-    }, onCancel);
+    }, onCancel, initialSearchInput);
     return componentPort(selector);
 }
 export function createPiShellExtensionSelector(title, options, onSelect, onCancel) {

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

@@ -1,4 +1,4 @@
-import { visibleWidth, type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
+import { visibleWidth, type AutocompleteProvider, type Component, type KeybindingsConfig, type TUI } from "#pi-tui";
 import type { OwnedUiImageAttachment, OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 import type { HistoryEditorConstructor } from "./history-editor-loader.js";
 import type { EditorRecallPort } from "./editor-interaction.js";
@@ -31,8 +31,10 @@ export interface PiShellEditorPort extends PiShellComponentPort {
     readonly historyReplacement?: typeof import("../../../contracts/owned-ui/index.js").PROMPT_HISTORY_EDITOR_REPLACEMENT;
     /** Restores this editor's profile after another Pi component changed the global manager. */
     activateKeybindings(): void;
+    keybindingConfig(): KeybindingsConfig;
+    reloadKeybindings(): void;
     /** Uses Pi's terminal decoder rather than assuming one terminal escape spelling. */
-    matchesTerminalKey(data: string, key: "home" | "end" | "ctrl+v"): boolean;
+    matchesTerminalKey(data: string, key: "home" | "end" | "ctrl+home" | "ctrl+end" | "ctrl+v"): boolean;
     getText(): string;
     setText(text: string): void;
     insertText(text: string): void;
@@ -94,6 +96,10 @@ export interface PiShellImageAssetResolver {
 export interface PiShellExtensionRendererResolver {
     getMessageRenderer(customType: string): unknown;
     getToolDefinition(toolName: string): unknown;
+    getShortcuts?(bindings: KeybindingsConfig): readonly {
+        readonly key: string;
+        readonly description: string;
+    }[];
 }
 export interface PiShellTranscriptComponentPort extends PiShellComponentPort {
     readonly id: string;
@@ -147,6 +153,7 @@ export interface PiShellEditorOptions {
         readonly marker: string;
         readonly result: Promise<string>;
     };
+    readonly editorHiddenRanges?: (line: string) => readonly PiShellEditorTextRange[];
     readonly transformPastedContent?: (content: PiShellClipboardContent) => string;
     readonly editorAtomicRanges?: (line: string) => readonly PiShellEditorTextRange[];
     readonly expandCopiedEditorText?: (text: string) => string;