@timurproko/a1 0.1.8-dev.139 → 0.1.8-dev.157

package/README.md

@@ -23,20 +23,28 @@ npm install -g @timurproko/a1@0.1.8-dev.107
 ## Use
 
 ```sh
-a1                      # launch A1 (profile: ~/.a1/agent)
-a1 version              # show Current, Develop, and Release versions
-a1 update               # install the newest stable release
-a1 update:develop       # install the current development preview
-a1 update:107           # install numbered preview 107
-a1 update --models      # refresh A1's model catalogs
+a1                                      # launch A1 (profile: ~/.a1/agent)
+a1 --help                               # show all commands (short form: a1 -h)
+a1 --version                            # show the version (short form: a1 -v)
+a1 update                               # install the newest stable release
+a1 update --develop                     # install the current development preview
+a1 update --develop 107                 # install numbered preview 107
+a1 update --develop 0.1.8-dev.107       # install that exact preview
+a1 update --models                      # refresh A1's model catalogs
 ```
 
+Stable builds print only their installed version. Development builds also show the
+current development and stable channel versions.
+
 Development previews add the Pi comparison profile; release builds do not carry it.
 
 ```sh
-a1 pi           # vanilla Pi oracle: ~/.pi/agent
+a1 pi                                   # vanilla Pi oracle: ~/.pi/agent
 ```
 
+Unsupported commands exit quietly without launching anything. The removed
+`update:<preview>` forms are not aliases; use `update --develop`.
+
 ## Extensions
 
 Pi extension packages install into A1's own profile (`~/.a1/agent`), so bare `a1`
@@ -49,8 +57,12 @@ a1 pi remove npm:pi-mcp-adapter    # remove it (alias: a1 pi uninstall)
 a1 pi list                         # list installed packages
 a1 pi update --extensions          # update every installed package
 a1 pi update npm:pi-mcp-adapter    # update one
+a1 pi update --models              # refresh A1's model catalogs
 ```
 
+A1 pins the Pi runtime carried by each release, so Pi self-update forms are refused.
+Update A1 itself with `a1 update` or `a1 update --develop`.
+
 A running session picks up a newly installed package after a restart.
 Configuration is isolated the same way: bare `a1` reads `~/.a1/agent` (or the
 project), never `~/.pi/agent`. Configure MCP with `/mcp setup` inside bare `a1`.
@@ -88,8 +100,8 @@ npm run develop             # request the preview publish run and wait for it
 Install:
 
 ```sh
-a1 update:107               # install preview 107
-a1 update:0.1.8-dev.107     # install that exact full preview version
+a1 update --develop 107                 # install preview 107
+a1 update --develop 0.1.8-dev.107       # install that exact full preview version
 ```
 
 ### Stable

package/bin/cli.js

@@ -45,5 +45,6 @@ process.exitCode = await dispatchCli(process.argv.slice(2), {
     return await runPackageCommand(request, { createPort: createPiPackagesPort });
   },
 }, {
+  stdout: message => process.stdout.write(message),
   stderr: message => process.stderr.write(message),
 }, capabilities);

package/dist/cli/dispatch.d.ts

@@ -9,11 +9,17 @@ export interface CliHandlers {
     readonly packages: (request: PackageCommandRequest) => Promise<number>;
 }
 export interface CliOutput {
+    readonly stdout: (message: string) => void;
     readonly stderr: (message: string) => void;
 }
 export declare function cliUsage(capabilities: CliCapabilities): string;
+export declare function cliHelp(capabilities: CliCapabilities): string;
 export declare function dispatchCli(arguments_: readonly string[], handlers: CliHandlers, output: CliOutput, capabilities: CliCapabilities): Promise<number>;
 export type CliCommand = {
+    readonly kind: "noop";
+} | {
+    readonly kind: "help";
+} | {
     readonly kind: "launch";
     readonly profileId: LaunchProfileId;
 } | {

package/dist/cli/dispatch.js

@@ -4,21 +4,60 @@ export function cliUsage(capabilities) {
     return PRODUCT_TEXT.usage([
         "",
         ...(capabilities.developmentComparison ? ["pi"] : []),
-        "version",
-        "update [self|--models]",
-        "update:develop",
-        "update:<number>",
+        "--help",
+        "-h",
+        "--version",
+        "-v",
+        "update",
+        "update --develop [preview-or-version]",
+        "update --models",
         "pi install <source>",
         "pi remove <source>",
+        "pi uninstall <source>",
         "pi list",
-        "pi update [--extensions|<source>]",
+        "pi update --extensions",
+        "pi update --models",
+        "pi update <source>",
     ]);
 }
+export function cliHelp(capabilities) {
+    const command = PRODUCT_TEXT.commandName;
+    return [
+        "Common:",
+        `  ${command}`,
+        ...(capabilities.developmentComparison ? [`  ${command} pi`] : []),
+        `  ${command} --help`,
+        `  ${command} -h`,
+        `  ${command} --version`,
+        `  ${command} -v`,
+        "",
+        "Update:",
+        `  ${command} update`,
+        `  ${command} update --develop [preview-or-version]`,
+        `  ${command} update --models`,
+        "",
+        "Pi-compatible packages:",
+        `  ${command} pi install <source>`,
+        `  ${command} pi remove <source>`,
+        `  ${command} pi uninstall <source>`,
+        `  ${command} pi list`,
+        `  ${command} pi update --extensions`,
+        `  ${command} pi update --models`,
+        `  ${command} pi update <source>`,
+        "",
+    ].join("\n");
+}
 const PROFILE_WORDS = new Set(["pi"]);
 export async function dispatchCli(arguments_, handlers, output, capabilities) {
     const command = parseCliCommand(arguments_, capabilities);
+    if (command.kind === "noop")
+        return 0;
+    if (command.kind === "help") {
+        output.stdout(cliHelp(capabilities));
+        return 0;
+    }
     if (command.kind === "error") {
-        output.stderr(`${command.message}\n${cliUsage(capabilities)}\n`);
+        output.stderr(`${command.message}\n`);
         return 2;
     }
     if (command.kind === "launch")
@@ -33,76 +72,63 @@ export function parseCliCommand(arguments_, capabilities) {
     if (arguments_.length === 0)
         return { kind: "launch", profileId: "a1" };
     const [command, ...rest] = arguments_;
+    if (command === "--help" || command === "-h")
+        return withoutArguments(rest, { kind: "help" });
+    if (command === "--version" || command === "-v")
+        return withoutArguments(rest, { kind: "version" });
     if (command === "pi") {
         if (rest.length > 0)
             return parsePiPackageCommand(rest);
-        if (capabilities.developmentComparison)
-            return { kind: "launch", profileId: "pi" };
+        return capabilities.developmentComparison ? { kind: "launch", profileId: "pi" } : { kind: "noop" };
     }
-    if (command === "version")
-        return withoutArguments(rest, { kind: "version" });
-    if (command !== undefined && command.startsWith("update:"))
-        return parseColonUpdate(command.slice("update:".length), rest);
     if (command === "update")
         return parseUpdate(rest);
-    if (command === "install" || command === "remove" || command === "uninstall" || command === "list") {
-        return packageNamespaceRejection(command, rest.join(" ") || undefined);
-    }
-    if (command === "ui")
-        return { kind: "error", message: `The ui subcommand was removed; run bare ${PRODUCT_TEXT.commandName} for the owned UI.` };
-    if (command === "agent")
-        return { kind: "error", message: `Bare ${PRODUCT_TEXT.commandName} is the ${PRODUCT_TEXT.displayName} agent experience; there is no agent subcommand.` };
-    return { kind: "error", message: PRODUCT_TEXT.diagnostic(`received an unknown command: ${command ?? ""}`) };
+    if (command?.startsWith("update:"))
+        return { kind: "noop" };
+    // Unsupported and reserved command spaces are deliberately quiet. Help is
+    // explicit, and a typo must never start an interactive or maintenance path.
+    return { kind: "noop" };
 }
 /**
- * What follows the colon says which development build to move to. `develop`
- * selects the channel head; a positive decimal or a full numbered preview names
- * one immutable publication.
- */
-function parseColonUpdate(suffix, rest) {
-    if (rest.length > 0)
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic("update takes what to move to after the colon, and nothing else.") };
-    if (suffix === "next") {
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`renamed its development channel; run ${PRODUCT_TEXT.commandName} update:develop.`) };
-    }
-    if (suffix === "develop")
-        return { kind: "update", channel: "next" };
-    if (suffix.length === 0)
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`update: needs a preview after the colon, as in ${PRODUCT_TEXT.commandName} update:develop.`) };
-    if (!/^[1-9]\d*$/.test(suffix) && !/^\d+\.\d+\.\d+-dev\.[1-9]\d*$/.test(suffix)) {
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`received an unusable numbered preview: ${suffix}`) };
-    }
-    return { kind: "update", channel: "next", target: suffix };
-}
-/**
- * Top-level `update` owns A1 itself and A1's model catalogs. Extension package
- * maintenance lives under the `pi` compatibility namespace, while updating the
- * pinned Pi runtime remains impossible.
+ * Stable update is the empty form. `--develop` selects the moving development
+ * head or one immutable numbered preview, while model refresh remains a separate
+ * operation that cannot be combined with either update channel.
  */
 function parseUpdate(rest) {
     if (rest.length === 0)
         return { kind: "update", channel: "stable" };
-    if (rest.length > 1)
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic("update accepts one target.") };
-    const [target] = rest;
-    if (target === "self")
-        return { kind: "update", channel: "stable" };
-    if (target === "pi") {
-        return {
-            kind: "error",
-            message: PRODUCT_TEXT.diagnostic(`pins the Pi version it was certified against; run ${PRODUCT_TEXT.commandName} update to move ${PRODUCT_TEXT.displayName} itself.`),
-        };
-    }
-    if (target === "next" || target === "develop" || target === "stable") {
-        const form = target === "stable" ? `${PRODUCT_TEXT.commandName} update` : `${PRODUCT_TEXT.commandName} update:develop`;
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`selects a release channel with a colon; run ${form}.`) };
+    const [selector, ...values] = rest;
+    // Removed compatibility notation is unsupported rather than deprecated.
+    if (selector === "self")
+        return { kind: "noop" };
+    if (selector === "--develop") {
+        if (values.length === 0)
+            return { kind: "update", channel: "next" };
+        if (values.length > 1)
+            return updateGrammarError("--develop accepts at most one preview number or version.");
+        const [target] = values;
+        if (target === undefined || !isDevelopmentTarget(target)) {
+            return updateGrammarError(`--develop received an unusable preview: ${target ?? ""}`);
+        }
+        return { kind: "update", channel: "next", target };
     }
-    if (target === "--models")
+    if (selector === "--models") {
+        if (values.length > 0)
+            return updateGrammarError("--models cannot be combined with another update selector.");
         return { kind: "packages", request: { verb: "refresh-models", source: null } };
-    if (target === "--extensions" || (target !== undefined && !target.startsWith("-"))) {
-        return packageNamespaceRejection("update", target === "--extensions" ? "--extensions" : target);
     }
-    return unknownOption(target ?? "", "update");
+    if (selector === "pi")
+        return pinnedPiUpdateError();
+    if (selector !== undefined && selector.startsWith("-"))
+        return unknownOption(selector, "update");
+    // Positional update targets are reserved for a future A1-native plugin model.
+    return { kind: "noop" };
+}
+function isDevelopmentTarget(target) {
+    return /^[1-9]\d*$/.test(target) || /^\d+\.\d+\.\d+-dev\.[1-9]\d*$/.test(target);
+}
+function updateGrammarError(detail) {
+    return { kind: "error", message: PRODUCT_TEXT.diagnostic(`could not parse update: ${detail}`) };
 }
 function parsePiPackageCommand(arguments_) {
     const [verb, ...rest] = arguments_;
@@ -113,30 +139,40 @@ function parsePiPackageCommand(arguments_) {
         return withoutArguments(rest, { kind: "packages", request: { verb: "list", source: null } });
     if (verb === "update")
         return parsePiPackageUpdate(rest);
-    return { kind: "error", message: PRODUCT_TEXT.diagnostic(`received an unknown pi package command: ${verb ?? ""}`) };
+    return { kind: "noop" };
 }
 function parsePiPackageUpdate(rest) {
-    if (rest.length === 0) {
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`pi update needs --extensions or a package source.`) };
-    }
+    if (rest.length === 0)
+        return pinnedPiUpdateError();
     if (rest.length > 1)
         return { kind: "error", message: PRODUCT_TEXT.diagnostic("pi update accepts one target.") };
     const [target] = rest;
     if (target === "--extensions")
         return { kind: "packages", request: { verb: "update", source: null } };
-    if (target === "--models") {
-        return { kind: "error", message: PRODUCT_TEXT.diagnostic(`refreshes its model catalogs at the top level; run ${PRODUCT_TEXT.commandName} update --models.`) };
-    }
+    if (target === "--models")
+        return { kind: "packages", request: { verb: "refresh-models", source: null } };
+    if (target === "--self" || target === "--all" || target === "self" || target === "pi")
+        return pinnedPiUpdateError();
     if (target === undefined || target.startsWith("-"))
         return unknownOption(target ?? "", "pi update");
-    if (PROFILE_WORDS.has(target))
-        return profileRejection("update");
     return { kind: "packages", request: { verb: "update", source: target } };
 }
+function pinnedPiUpdateError() {
+    return {
+        kind: "error",
+        message: [
+            PRODUCT_TEXT.diagnostic("pins its certified Pi runtime and cannot update it independently."),
+            "Use:",
+            `  ${PRODUCT_TEXT.commandName} update                    Update A1`,
+            `  ${PRODUCT_TEXT.commandName} pi update --extensions    Update Pi-compatible packages`,
+            `  ${PRODUCT_TEXT.commandName} pi update --models        Refresh model catalogs`,
+        ].join("\n"),
+    };
+}
 function parseSourceCommand(verb, rest) {
     const flag = rest.find(argument => argument.startsWith("-"));
     if (flag !== undefined)
-        return unknownOption(flag, verb);
+        return unknownOption(flag, `pi ${verb}`);
     if (rest.length === 0)
         return { kind: "error", message: PRODUCT_TEXT.diagnostic(`${verb} requires a package source.`) };
     if (rest.length > 1)
@@ -151,18 +187,8 @@ function parseSourceCommand(verb, rest) {
 function withoutArguments(rest, command) {
     if (rest.length === 0)
         return command;
-    const [argument] = rest;
-    if (argument !== undefined && (PROFILE_WORDS.has(argument) || argument.startsWith("--profile")))
-        return profileRejection("list");
     return { kind: "error", message: PRODUCT_TEXT.diagnostic("commands do not accept additional arguments.") };
 }
-function packageNamespaceRejection(verb, target) {
-    const suffix = target === undefined ? "" : ` ${target}`;
-    return {
-        kind: "error",
-        message: PRODUCT_TEXT.diagnostic(`manages extension packages under its pi namespace; run ${PRODUCT_TEXT.commandName} pi ${verb}${suffix}.`),
-    };
-}
 function profileRejection(verb) {
     return {
         kind: "error",

package/dist/cli/version-stats.js

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import crossSpawn from "cross-spawn";
-import { valid as validSemver } from "semver";
+import { prerelease, valid as validSemver } from "semver";
 import { PRODUCT_TEXT } from "../product-identity.js";
 const defaultOutput = {
     stdout(message) { process.stdout.write(message); },
@@ -20,6 +20,12 @@ export async function runVersionStats(options) {
         output.stderr(`${PRODUCT_TEXT.diagnostic(`could not read its installed version: ${message(error)}`)}\n`);
         return 1;
     }
+    // Match Pi's release behavior: stable builds print only their installed version.
+    // Development builds retain channel visibility for preview comparison and updates.
+    if (prerelease(installed) === null) {
+        output.stdout(`${installed}\n`);
+        return 0;
+    }
     const remote = await queryDistTags(runner, options.fetcher ?? defaultRegistryFetcher);
     output.stdout(`Current: ${installed}\nDevelop: ${remote.develop ?? "unavailable"}\nRelease: ${remote.release ?? "unavailable"}\n`);
     if (remote.error)

package/dist/composition/owned-ui.js

@@ -1,7 +1,7 @@
 import { resolveProductPaths } from "../foundation/lifecycle/index.js";
 import { applyConfiguredPiTheme, getAvailablePiThemes } from "../integrations/pi/components/index.js";
 import { createPiEngineAdapter } from "../integrations/pi/engine/index.js";
-import { OwnedUiSessionShell } from "../integrations/pi/owned-ui/index.js";
+import { OwnedUiSessionShell } from "../integrations/pi/session-ui/index.js";
 import { OwnedUiSettingsSession, OwnedUiSettingsStore } from "../ui/settings/index.js";
 import { createPiTerminalBridge } from "../integrations/pi/tui-runtime/index.js";
 import { createOwnedRouteHost } from "./settings-route-host.js";
@@ -13,17 +13,20 @@ export async function composeOwnedUi(options = {}) {
     const adapter = options.createPiAdapter
         ? await options.createPiAdapter()
         : await createPiEngineAdapter({ cwd, availableThemes: () => getAvailablePiThemes().map(theme => theme.name) });
+    const ownedSurfaces = options.ownedSurfaces !== "off";
     const settings = options.profileId === undefined
         ? null
         : new OwnedUiSettingsSession({
             store: new OwnedUiSettingsStore({ configDir: resolveProductPaths().configDir, profileId: options.profileId }),
             agentProvider: () => adapter.settingsPort(),
-            ...(options.ownedSurfaces === "off" ? {} : { hiddenAgentSettingIds: ["tuiMode"] }),
+            ...(ownedSurfaces ? {
+                hiddenAgentSettingIds: ["tuiMode", "theme", "fullscreenScrollbar", "quietStartup"],
+            } : {}),
         });
-    // Before anything is drawn, so every surface uses the configured theme rather
-    // than the one guessed from the terminal's background.
-    applyConfiguredPiTheme(adapter.configuredTheme());
-    const ownedSurfaces = options.ownedSurfaces !== "off";
+    // Bare A1 intentionally ships one visual target while its UI is being completed:
+    // dark, regardless of terminal detection or a previously stored Pi theme. The
+    // comparison profile keeps Pi's configured theme behavior and settings surface.
+    applyConfiguredPiTheme(ownedSurfaces ? "dark" : adapter.configuredTheme());
     const routeHost = settings === null || !ownedSurfaces ? null : createOwnedRouteHost(settings);
     const viewportSettings = settings === null || !ownedSurfaces ? null : {
         snapshot: () => viewportSettingsSnapshot(settings),
@@ -51,7 +54,7 @@ function viewportSettingsSnapshot(settings) {
     const style = settings.value("scrollbarStyle");
     const speed = settings.value("scrollbarSpeed");
     return {
-        scrollbarAppearance: appearance === "always" || appearance === "hidden" ? appearance : "hover",
+        scrollbarAppearance: appearance === "always" || appearance === "hidden" ? appearance : "auto",
         scrollbarStyle: style === "thick" ? "thick" : "thin",
         scrollbarSpeed: speed === "high" ? "high" : speed === "fast" ? "fast" : "normal",
     };

package/dist/composition/settings-route-host.d.ts

@@ -1,5 +1,5 @@
-import type { UiRouteHost } from "../integrations/pi/owned-ui/index.js";
 import type { OwnedUiSettingsSession } from "../ui/settings/index.js";
+import { type UiRouteHost } from "../ui/apps/index.js";
 /**
  * Registers the A1-owned screens and adapts the app host to the shell's route
  * seam. The shell mounts whatever surface it is handed and forwards keys; it

package/dist/composition/settings-route-host.js

@@ -1,6 +1,6 @@
 import { SETTINGS_APP_ID, SETTINGS_ROUTE, SettingsApp } from "../features/owned-ui/index.js";
 import { piTheme } from "../integrations/pi/components/index.js";
-import { UiAppHost, UiAppRegistry } from "../ui/apps/index.js";
+import { UiAppHost, UiAppRegistry, } from "../ui/apps/index.js";
 import { faint } from "../ui/components/index.js";
 /**
  * Registers the A1-owned screens and adapts the app host to the shell's route

package/dist/contracts/owned-ui/model.d.ts

@@ -13,7 +13,7 @@ export interface OwnedUiModelInfo {
 }
 export type OwnedUiThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
 export interface OwnedUiViewportSettings {
-    readonly scrollbarAppearance: "always" | "hover" | "hidden";
+    readonly scrollbarAppearance: "auto" | "always" | "hidden";
     readonly scrollbarStyle: "thin" | "thick";
     /** normal is baseline; fast is 2x normal; high is normal plus fast. */
     readonly scrollbarSpeed: "normal" | "fast" | "high";
@@ -29,6 +29,11 @@ export interface OwnedUiTerminalSurface {
     readonly focusedRegion: "transcript" | "editor" | "dialog" | "overlay" | "status";
     readonly hardwareCursor: boolean;
 }
+export interface OwnedUiImageAttachment {
+    readonly type: "image";
+    readonly data: string;
+    readonly mimeType: string;
+}
 export interface OwnedUiEditorState {
     readonly text: string;
     readonly queuedSubmissions: readonly string[];
@@ -133,11 +138,13 @@ export type OwnedUiCommand = {
     readonly correlationId: OwnedUiCorrelationId;
     readonly sessionId: OwnedUiSessionId;
     readonly text: string;
+    readonly images?: readonly OwnedUiImageAttachment[];
 } | {
     readonly type: "steer" | "follow-up";
     readonly correlationId: OwnedUiCorrelationId;
     readonly sessionId: OwnedUiSessionId;
     readonly text: string;
+    readonly images?: readonly OwnedUiImageAttachment[];
 } | {
     readonly type: "abort" | "retry" | "compact" | "shutdown";
     readonly correlationId: OwnedUiCorrelationId;

package/dist/contracts/owned-ui/validation.js

@@ -5,6 +5,8 @@ const MAX_MESSAGE_LENGTH = 4_096;
 const MAX_TEXT_BYTES = 256 * 1024;
 const MAX_PAYLOAD_BYTES = 64 * 1024;
 const MAX_SESSION_VIEW_BYTES = 1024 * 1024;
+const MAX_IMAGE_DATA_BYTES = 8 * 1024 * 1024;
+const MAX_PROMPT_IMAGES = 8;
 const MAX_BLOCKS = 10_000;
 const MAX_CUSTOMIZATIONS = 1_000;
 const MAX_DIAGNOSTICS = 1_000;
@@ -53,6 +55,15 @@ export function assertOwnedUiCommand(command) {
         case "steer":
         case "follow-up":
             assertBoundedText(command.text, "owned-UI prompt text", MAX_TEXT_BYTES);
+            if (command.images !== undefined) {
+                assertCollection(command.images, "owned-UI prompt images", MAX_PROMPT_IMAGES);
+                for (const image of command.images) {
+                    if (image.type !== "image")
+                        throw new TypeError("owned-UI prompt image type is invalid");
+                    assertBoundedText(image.data, "owned-UI prompt image data", MAX_IMAGE_DATA_BYTES);
+                    assertBoundedText(image.mimeType, "owned-UI prompt image MIME type", MAX_LABEL_LENGTH);
+                }
+            }
             return;
         case "abort":
         case "retry":

package/dist/features/owned-ui/settings-app.js

@@ -1,4 +1,4 @@
-import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, PROMPT_GLYPH, blockJumpTarget, dialogValueColumn, numericValues, RAIL_COLUMNS, renderDialogPanel, renderEmptyState, renderGroupHeader, renderInputRow, renderStatusLine, renderListRow, renderNote, dialogRowAt, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, valueColumnFor, valueMenuFrame, promptRule, caretCell, blockRowSpan, displayWidth, faint, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, isThumbRow, layoutList, moveSelection, rowKey, scrollForSelection, scrollbarGeometry, selectableIndexes, } from "../../ui/components/index.js";
+import { GLOBAL_SCOPE, LineInput, PLAIN_THEME, ShortcutRegistry, assertNoShortcutConflicts, PROMPT_GLYPH, blockJumpTarget, dialogValueColumn, numericValues, RAIL_COLUMNS, renderDialogPanel, renderEmptyState, renderGroupHeader, renderInputRow, renderStatusLine, renderListRow, renderNote, dialogRowAt, menuRowAt, regionAt, renderValueMenu, withScrollbarRail, stepperEnds, steppedValue, valueColumnFor, valueMenuFrame, promptRule, caretCell, blockRowSpan, displayWidth, faint, handleLineInputKey, humanizeLabel, humanizeTitle, indexOfKey, isThumbRow, layoutList, moveSelection, rowKey, scrollForSelection, scrollbarGeometry, selectableIndexes, } from "../../ui/components/index.js";
 export const SETTINGS_APP_ID = "settings";
 export const SETTINGS_ROUTE = "settings";
 const SCOPE = SETTINGS_APP_ID;
@@ -29,6 +29,7 @@ SETTINGS_SHORTCUTS.declare({ key: "left", scope: DIALOG_SCOPE, description: "Cha
 SETTINGS_SHORTCUTS.declare({ key: "right", scope: DIALOG_SCOPE, description: "Change this part", section: "Parts" }, "part-change");
 SETTINGS_SHORTCUTS.declare({ key: "up", scope: DIALOG_SCOPE, description: "Previous part", section: "Parts" }, "part-previous");
 SETTINGS_SHORTCUTS.declare({ key: "down", scope: DIALOG_SCOPE, description: "Next part", section: "Parts" }, "part-next");
+assertNoShortcutConflicts(SETTINGS_SHORTCUTS.assemble());
 const KEYS = {
     "\u001b[A": "up",
     "\u001b[B": "down",

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

@@ -0,0 +1,55 @@
+import { type Editor } from "#pi-tui";
+import type { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
+import type { PiShellClipboardContent, PiShellEditorTextRange } from "./shell-shared-facade.js";
+/**
+ * Middleware boundary around Pi's editor. Interceptors may claim an input or
+ * delegate to the next interceptor/vanilla editor, and may decorate the rows
+ * vanilla Pi renders. This keeps owned UX additions out of the synchronized
+ * Pi editor port and gives future interactions one registration point.
+ */
+export interface OwnedEditorUxInterceptor {
+    handleInput(data: string, next: () => void): void;
+    render(width: number, next: () => string[]): string[];
+    reset(): void;
+    handlePointer?(event: OwnedEditorPointerEvent): boolean;
+    hasSelection?(): boolean;
+    ownsPointer?(): boolean;
+    pasteClipboard?(): boolean;
+}
+export interface OwnedEditorPointerEvent {
+    readonly kind: "press" | "motion" | "release";
+    readonly button: number;
+    readonly column: number;
+    /** One-based row relative to the top of the editor component. */
+    readonly row: number;
+}
+export declare class OwnedEditorUxInterception {
+    readonly interceptors: readonly OwnedEditorUxInterceptor[];
+    readonly fallback: {
+        handleInput(data: string): void;
+        render(width: number): string[];
+    };
+    constructor(interceptors: readonly OwnedEditorUxInterceptor[], fallback: {
+        handleInput(data: string): void;
+        render(width: number): string[];
+    });
+    handleInput(data: string): void;
+    render(width: number): string[];
+    reset(): void;
+    handlePointer(event: OwnedEditorPointerEvent): boolean;
+    hasSelection(): boolean;
+    ownsPointer(): boolean;
+    pasteClipboard(): boolean;
+}
+export interface PromptSelectionUxOptions {
+    readonly copyText: (text: string) => void;
+    readonly readClipboardContent: () => Promise<PiShellClipboardContent | null>;
+    readonly transformPastedContent: (content: PiShellClipboardContent) => string;
+    readonly atomicRanges: (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;
+    readonly requestRender: () => void;
+    readonly getRows: () => number;
+}
+export declare function createPromptSelectionInterceptor(editor: Editor, keybindings: KeybindingsManager, options: PromptSelectionUxOptions): OwnedEditorUxInterceptor;