@timurproko/a1 0.2.7-dev.820 → 0.2.7-dev.834

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

@@ -11,13 +11,14 @@ export function createOwnedRouteHost(settings, references, options = {}) {
             if (!routes.has(route))
                 return null;
             if (route === SETTINGS_ROUTE) {
-                return deferredSurface(SETTINGS_APP_ID, "settings", () => loadSettingsSurface(settings, options.settingsPinned === true));
+                return deferredSurface(SETTINGS_APP_ID, "settings", () => loadSettingsSurface(settings, options));
             }
             const changelog = route === CHANGELOG_ROUTE;
             const session = route === "session";
             const title = session ? "Session Info" : changelog ? input ? "What's New" : "Changelog" : HOTKEYS_TITLE;
             const document = session ? references.session() : changelog ? references.changelog(input) : references.hotkeys();
-            return deferredSurface(route, title, () => loadReferenceSurface(settings, route, route, title, document));
+            const pinned = options.tabRoute === route;
+            return deferredSurface(route, title, () => loadReferenceSurface(settings, route, title, document, pinned));
         },
     };
 }
@@ -61,12 +62,27 @@ function deferredSurface(id, label, load) {
         onExitRequested: listener => { onExit = listener; },
     };
 }
-async function loadSettingsSurface(settings, pinned) {
-    const { SettingsApp } = await import("../features/owned-ui/settings-app.js");
-    // Invariant: a pinned Settings tab closes as a tab; neither Esc nor one Ctrl+C dismisses its screen.
-    return hostApp(SETTINGS_APP_ID, SETTINGS_ROUTE, () => new SettingsApp(settings, { pinned }), !pinned);
+async function loadSettingsSurface(settings, options) {
+    const [{ SettingsApp }, { createSettingsSearchInputFactory }] = await Promise.all([
+        import("../features/owned-ui/settings-app.js"),
+        import("./settings-search-input.js"),
+    ]);
+    const pinned = options.tabRoute === SETTINGS_ROUTE;
+    const searchInputFactory = createSettingsSearchInputFactory({
+        ...(options.keybindings === undefined ? {} : { keybindings: options.keybindings }),
+        ...(options.agentDir === undefined ? {} : { agentDir: options.agentDir }),
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+    });
+    // Invariant: a pinned Settings tab closes as a tab; neither Esc nor one unclaimed Ctrl+C dismisses its screen.
+    return hostApp(SETTINGS_APP_ID, SETTINGS_ROUTE, () => new SettingsApp(settings, {
+        pinned,
+        searchInputFactory,
+        configurePlusMenu: options.configurePlusMenu ?? null,
+        ...(options.copyText === undefined ? {} : { copyText: options.copyText }),
+    }), !pinned, true);
 }
-async function loadReferenceSurface(settings, id, route, title, document) {
+async function loadReferenceSurface(settings, route, title, document, pinned) {
+    const id = route;
     // Rationale: the app module and the document load together, so a document that fails
     // to render is reported by the placeholder rather than by a screen that never fills.
     const [{ ReferenceScreenApp }, content] = await Promise.all([import("../features/owned-ui/reference-screen-app.js"), document]);
@@ -79,9 +95,10 @@ async function loadReferenceSurface(settings, id, route, title, document) {
             scrollbarStyle: settings.value("scrollbarStyle"),
             scrollbarSpeed: settings.value("scrollbarSpeed"),
         }),
-    }));
+        pinned,
+    }), !pinned);
 }
-async function hostApp(id, route, create, closeOnInterrupt = true) {
+async function hostApp(id, route, create, closeOnInterrupt = true, appInputBeforeInterrupt = false) {
     const [{ UiAppHost }, { UiAppRegistry }] = await Promise.all([
         import("../ui/apps/host.js"),
         import("../ui/apps/registry.js"),
@@ -96,6 +113,7 @@ async function hostApp(id, route, create, closeOnInterrupt = true) {
     const host = new UiAppHost({
         registry,
         closeOnInterrupt,
+        appInputBeforeInterrupt,
         theme: pinnedTheme(),
         surface: {
             size: () => size,

package/dist/composition/settings-search-input.d.ts

@@ -0,0 +1,9 @@
+import type { SettingsSearchInputFactory } from "../features/owned-ui/settings-search-input.js";
+import { type PiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
+export interface SettingsSearchInputFactoryOptions {
+    readonly keybindings?: PiKeybindingsHost;
+    readonly agentDir?: string;
+    readonly cwd?: string;
+}
+/** Builds Settings search from the same configurable owned editor used by the agent prompt. */
+export declare function createSettingsSearchInputFactory(options?: SettingsSearchInputFactoryOptions): SettingsSearchInputFactory;

package/dist/composition/settings-search-input.js

@@ -0,0 +1,58 @@
+import { editorInsertedText } from "../integrations/pi/components/owned-editor-ux.js";
+import { createPiShellEditor } from "../integrations/pi/components/shell-editor-autocomplete.js";
+import { piShellTruncateToWidth, piShellVisibleWidth, } from "../integrations/pi/components/shell-shared-facade.js";
+import { backgroundSgrSpan } from "../ui/components/spans.js";
+import { caretCell } from "../ui/components/line-input.js";
+import { PromptInput } from "../ui/components/prompt-input.js";
+/** Builds Settings search from the same configurable owned editor used by the agent prompt. */
+export function createSettingsSearchInputFactory(options = {}) {
+    return {
+        isTextInput: data => {
+            const text = editorInsertedText(data);
+            return text !== undefined && /[^\p{Cc}]/u.test(text);
+        },
+        create: surface => createSettingsSearchInput(surface, options),
+    };
+}
+function createSettingsSearchInput(surface, options) {
+    let columns = 80;
+    const editor = createPiShellEditor({
+        keybindingProfile: "a1",
+        inputCapabilities: {
+            singleLine: true,
+            paste: false,
+            autocomplete: false,
+            placeholder: "Search settings",
+        },
+        ...(options.keybindings === undefined ? {} : { keybindings: options.keybindings }),
+        ...(options.agentDir === undefined ? {} : { agentDir: options.agentDir }),
+        cwd: options.cwd ?? process.cwd(),
+        getColumns: () => columns,
+        getRows: surface.getRows,
+        requestRender: surface.requestRender,
+        onSubmit: () => { },
+        onCopyText: text => surface.copyText(text),
+        paintEditorSelection: (line, from, to, atomic) => backgroundSgrSpan(line, from, to, atomic ? "\u001b[7m" : "\u001b[27m\u001b[48;2;38;79;120m", atomic ? "\u001b[27m" : "\u001b[49m", piShellVisibleWidth),
+        promptPresentation: {
+            input: new PromptInput({ fg: (token, text) => surface.theme.fg(token, text) }, {
+                measure: piShellVisibleWidth,
+                truncate: piShellTruncateToWidth,
+            }),
+            styleSuggestion: text => surface.theme.fg("dim", text),
+            styleSuggestionCaret: caretCell,
+        },
+    });
+    editor.setFocused?.(true);
+    return {
+        render(width) {
+            columns = width;
+            return editor.render(width);
+        },
+        handleInput: (data) => editor.handleInput?.(data),
+        handlePointer: (event) => editor.handlePointer(event),
+        getText: () => editor.getText(),
+        hasSelection: () => editor.hasSelection(),
+        ownsPointer: () => editor.ownsPointer(),
+        setFocused: (focused) => editor.setFocused?.(focused),
+    };
+}

package/dist/contracts/owned-ui/session-backend.d.ts

@@ -37,6 +37,8 @@ export interface OwnedUiSessionIdentityPort {
     readonly sessionBindingGeneration: number;
     readonly disposed: boolean;
     currentSessionFile(): string | null;
+    /** The durable conversation identity; unlike sessionId it survives agent process restart. */
+    currentHistorySessionId(): string | null;
     currentSessionResumeMetadata(): OwnedUiSessionResumeMetadata | null;
 }
 /** The session lifecycle, its view, its event stream, and command admission. */

package/dist/contracts/owned-ui/session-workflows.d.ts

@@ -337,9 +337,13 @@ export interface OwnedUiVisualExtensionSupport {
     readonly renderCallbacks: typeof OWNED_UI_EXTENSION_RENDER_CALLBACKS;
     readonly diagnostic: string;
 }
-/** A newer release found by the startup check. */
-export interface OwnedUiReleaseUpdate {
+/** A newer release found by the startup check, or one installed for the next restart. */
+export type OwnedUiReleaseUpdate = {
+    readonly status?: "available";
     readonly version: string;
     readonly command: string;
     readonly changelogUrl: string | null;
-}
+} | {
+    readonly status: "installed";
+    readonly version: string;
+};

package/dist/contracts/presentation/index.d.ts

@@ -14,6 +14,17 @@ export declare const DIALOG_BACK_SHORTCUT_HINT: Readonly<{
     key: string;
     action: string;
 }>;
+/** Global inset inherited by every semantic row inside an A1-owned dialog frame. */
+export declare const DIALOG_CONTENT_PADDING_X = 1;
+export interface DialogFrameGeometry {
+    readonly frameWidth: number;
+    readonly contentPaddingX: number;
+    readonly contentWidth: number;
+}
+/** Shared full-width-rule/content-width geometry for string and component dialog renderers. */
+export declare function dialogFrameGeometry(width: number): DialogFrameGeometry;
+/** Injects a semantic row into the frame's global content inset. */
+export declare function insetDialogContent(row: string, geometry: DialogFrameGeometry): string;
 export interface ShortcutHintRoles {
     key(label: string): string;
     action(name: string): string;

package/dist/contracts/presentation/index.js

@@ -2,6 +2,18 @@
 export const DIALOG_CLOSE_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "close" });
 /** Canonical return guidance for a nested step within a dialog surface. */
 export const DIALOG_BACK_SHORTCUT_HINT = Object.freeze({ key: "esc", action: "back" });
+/** Global inset inherited by every semantic row inside an A1-owned dialog frame. */
+export const DIALOG_CONTENT_PADDING_X = 1;
+/** Shared full-width-rule/content-width geometry for string and component dialog renderers. */
+export function dialogFrameGeometry(width) {
+    const frameWidth = Math.max(0, width);
+    const contentPaddingX = Math.min(DIALOG_CONTENT_PADDING_X, frameWidth);
+    return { frameWidth, contentPaddingX, contentWidth: frameWidth - contentPaddingX };
+}
+/** Injects a semantic row into the frame's global content inset. */
+export function insetDialogContent(row, geometry) {
+    return `${" ".repeat(geometry.contentPaddingX)}${row}`;
+}
 const SHORTCUT_KEY_NAMES = Object.freeze({
     alt: "Alt", backspace: "Backspace", cmd: "Cmd", ctrl: "Ctrl", delete: "Delete", down: "Down", end: "End",
     enter: "Enter", esc: "Esc", escape: "Escape", home: "Home", insert: "Insert", left: "Left", meta: "Meta",

package/dist/features/launch/development-launch.js

@@ -19,6 +19,11 @@ export function resolveDevelopmentLaunchEnvironment(canonicalPackageRoot, releas
         ? join(developmentRoot, "config")
         : join(checkoutRoot, "config");
     const dataDir = resolve(source[PRODUCT_IDENTITY.environment.dataDir] ?? join(developmentRoot, "data"));
+    // Rationale: solo processes keep isolated control state but must see the same history
+    // after selecting Shared; use a checkout-wide root across rebuilds unless overridden.
+    const historyDataDir = resolve(source[PRODUCT_IDENTITY.environment.developmentHistoryDataDir]
+        ?? source[PRODUCT_IDENTITY.environment.dataDir]
+        ?? (selectedDevelopmentRoot ? dataDir : join(checkoutRoot, "data")));
     return {
         checkoutId,
         releaseId,
@@ -27,6 +32,7 @@ export function resolveDevelopmentLaunchEnvironment(canonicalPackageRoot, releas
         environment: {
             ...source,
             [PRODUCT_IDENTITY.environment.developmentInstanceId]: instanceId,
+            [PRODUCT_IDENTITY.environment.developmentHistoryDataDir]: historyDataDir,
             [PRODUCT_IDENTITY.environment.configDir]: resolve(source[PRODUCT_IDENTITY.environment.configDir] ?? persistentConfigDir),
             [PRODUCT_IDENTITY.environment.dataDir]: dataDir,
             [PRODUCT_IDENTITY.environment.runtimeDir]: resolve(source[PRODUCT_IDENTITY.environment.runtimeDir] ?? join(developmentRoot, "runtime")),

package/dist/features/launch/profile-paths.js

@@ -18,6 +18,10 @@ export function resolveLaunchProfilePaths(options = {}) {
 export function resolvePromptHistoryDataDir(options = {}) {
     const environment = options.environment ?? process.env;
     const platform = options.platform ?? process.platform;
+    const developmentHistoryDataDir = environment[PRODUCT_IDENTITY.environment.developmentHistoryDataDir];
+    if (developmentHistoryDataDir !== undefined) {
+        return resolveProductPaths({ ...environment, [PRODUCT_IDENTITY.environment.dataDir]: developmentHistoryDataDir }, platform).dataDir;
+    }
     if (environment[PRODUCT_IDENTITY.environment.dataDir] !== undefined) {
         return resolveProductPaths(environment, platform).dataDir;
     }

package/dist/features/owned-ui/plus-menu-dialog.d.ts

@@ -0,0 +1,22 @@
+import type { UiTheme } from "../../ui/components/index.js";
+/** The A1 setting holding the tab kinds the strip's `+` offers. */
+export declare const PLUS_MENU_SETTING_ID = "tabBarPlusMenu";
+/** One tab kind the plus menu can offer. */
+export interface PlusMenuKind {
+    readonly key: string;
+    readonly label: string;
+}
+/**
+ * The plus-menu dialog: every tab kind with `●` when `+` offers it and `○` when not, filtered by typed
+ * text. It owns only its filter and the row in hand; the enabled record and its saving stay with the
+ * Settings screen that opened it.
+ */
+export declare class PlusMenuDialog {
+    #private;
+    constructor(kinds: readonly PlusMenuKind[]);
+    /** The kinds the filter keeps, in kind order. */
+    shown(): readonly PlusMenuKind[];
+    /** Handles one key by its resolved name; `toggle` flips a kind. Returns whether the dialog closed. */
+    handle(name: string, data: string, toggle: (key: string) => void): "close" | "handled";
+    lines(enabled: Readonly<Record<string, boolean | string>>, width: number, theme: UiTheme): readonly string[];
+}

package/dist/features/owned-ui/plus-menu-dialog.js

@@ -0,0 +1,76 @@
+import { LineInput, displayWidth, handleLineInputKey, renderInputRow, truncateToWidth, } from "../../ui/components/index.js";
+/** The A1 setting holding the tab kinds the strip's `+` offers. */
+export const PLUS_MENU_SETTING_ID = "tabBarPlusMenu";
+const TITLE = "Plus Menu";
+const DESCRIPTION = "Choose what the + button in the tab bar can add.";
+const HINT = "Type search · ↑↓ navigate · Space toggle · Esc close";
+/**
+ * The plus-menu dialog: every tab kind with `●` when `+` offers it and `○` when not, filtered by typed
+ * text. It owns only its filter and the row in hand; the enabled record and its saving stay with the
+ * Settings screen that opened it.
+ */
+export class PlusMenuDialog {
+    #kinds;
+    #filter = new LineInput("");
+    #index = 0;
+    constructor(kinds) {
+        this.#kinds = kinds;
+    }
+    /** The kinds the filter keeps, in kind order. */
+    shown() {
+        const needle = this.#filter.value.trim().toLowerCase();
+        return this.#kinds.filter(kind => needle.length === 0 || kind.label.toLowerCase().includes(needle));
+    }
+    /** Handles one key by its resolved name; `toggle` flips a kind. Returns whether the dialog closed. */
+    handle(name, data, toggle) {
+        const shown = this.shown();
+        if (name === "escape")
+            return "close";
+        if (name === "up" || name === "down") {
+            this.#index = Math.min(Math.max(0, shown.length - 1), Math.max(0, this.#index + (name === "down" ? 1 : -1)));
+            return "handled";
+        }
+        if (name === "space") {
+            const kind = shown[this.#index];
+            if (kind !== undefined)
+                toggle(kind.key);
+            return "handled";
+        }
+        handleLineInputKey(this.#filter, data);
+        this.#index = 0;
+        return "handled";
+    }
+    lines(enabled, width, theme) {
+        const rule = theme.fg("border", "─".repeat(Math.max(0, width)));
+        const inset = width > 0 ? " " : "";
+        const contentWidth = Math.max(0, width - inset.length);
+        const row = (painted, raw) => {
+            const clipped = truncateToWidth(painted, contentWidth);
+            return `${inset}${clipped}${" ".repeat(Math.max(0, contentWidth - displayWidth(raw)))}`;
+        };
+        const shown = this.shown();
+        const index = Math.min(this.#index, Math.max(0, shown.length - 1));
+        const rows = shown.length === 0
+            ? [row(theme.fg("dim", "No tabs match"), "No tabs match")]
+            : shown.map((kind, position) => {
+                const selected = position === index;
+                const cursor = selected ? "→ " : "  ";
+                const marker = enabled[kind.key] === true ? "●" : "○";
+                const raw = `${cursor}${marker} ${kind.label}`;
+                const content = `${selected ? theme.fg("accent", cursor) : cursor}${theme.fg("text", marker)} ${theme.fg("text", kind.label)}`;
+                return row(selected ? theme.highlight(content) : content, raw);
+            });
+        return [
+            rule,
+            row(theme.bold(theme.fg("accent", TITLE)), TITLE),
+            row(theme.fg("dim", DESCRIPTION), DESCRIPTION),
+            "",
+            ...renderInputRow(this.#filter, width, { ruled: false, promptGlyph: "> ", theme }).lines,
+            "",
+            ...rows,
+            "",
+            row(theme.fg("dim", HINT), HINT),
+            rule,
+        ];
+    }
+}

package/dist/features/owned-ui/reference-screen-app.d.ts

@@ -24,6 +24,8 @@ export interface ReferenceScreenOptions {
     readonly document: ReferenceDocumentProvider;
     /** The reader's scroll settings, read on every frame so a live change is honored. */
     readonly scrollSettings: () => OwnedUiViewportSettings;
+    /** The screen is a resident tab, such as the Changelog tab: it offers no screen-level close. */
+    readonly pinned?: boolean;
 }
 /**
  * Presents one read-only document full screen between two accent rules: the bold

package/dist/features/owned-ui/reference-screen-app.js

@@ -48,6 +48,7 @@ export class ReferenceScreenApp {
     #title;
     #document;
     #scrollSettings;
+    #pinned;
     #scroll = 0;
     #interruptArmed = false;
     #failure = null;
@@ -67,6 +68,7 @@ export class ReferenceScreenApp {
         this.#title = options.title;
         this.#document = options.document;
         this.#scrollSettings = options.scrollSettings;
+        this.#pinned = options.pinned === true;
     }
     onActivate(host) {
         const ready = this.#document.ready;
@@ -139,7 +141,7 @@ export class ReferenceScreenApp {
         const withRail = withScrollbarRail(body.slice(0, bodyHeight), geometry, contentWidth, theme, { presentation });
         const hint = this.#interruptArmed
             ? theme.fg("dim", " press ctrl+c again to exit a1")
-            : renderShortcutHintsWithClose(REFERENCE_SCREEN_SHORTCUTS.hintEntries(SCOPE), theme, rect.width, 1);
+            : renderShortcutHintsWithClose(this.#hintEntries(), theme, rect.width, 1);
         // Compatibility: the v2 reference screen frames its document between two border-coloured rules.
         const rule = theme.fg("border", "─".repeat(rect.width));
         // Invariant: dialog chrome shares the title's one-cell inset; document content keeps its own layout.
@@ -153,7 +155,8 @@ export class ReferenceScreenApp {
             return { consumed: false };
         switch (action) {
             case "close":
-                host.close();
+                if (!this.#pinned)
+                    host.close();
                 return { consumed: true };
             case "up":
                 this.#scrollBy(-1);
@@ -216,6 +219,13 @@ export class ReferenceScreenApp {
         }
         return { owned: true, changed: true };
     }
+    // Invariant: a pinned screen is its tab and `Esc` does not close it, so it shows no close hint.
+    #hintEntries() {
+        const entries = REFERENCE_SCREEN_SHORTCUTS.hintEntries(SCOPE);
+        if (!this.#pinned)
+            return entries;
+        return entries.filter(entry => entry.key !== DIALOG_CLOSE_SHORTCUT_HINT.key || entry.action !== DIALOG_CLOSE_SHORTCUT_HINT.action);
+    }
     // Invariant: the title is the first document row, as in v2, so it scrolls with the document.
     #content(width, theme) {
         // Compatibility: one leading space, so the title lines up with the padded Markdown rows as in v2.

package/dist/features/owned-ui/settings-app.d.ts

@@ -1,8 +1,9 @@
 import type { AppHostServices, UiApp } from "../../ui/apps/index.js";
 import { ShortcutRegistry, type PaneInputResult, type PaneMouseEvent, type PaneRect } from "../../ui/components/index.js";
 import type { OwnedSettingsManager } from "../../ui/settings/index.js";
+import type { SettingsSearchInputFactory } from "./settings-search-input.js";
 export { SETTINGS_APP_ID, SETTINGS_ROUTE } from "./settings-route.js";
-type Action = "move-up" | "move-down" | "block-up" | "block-down" | "first" | "last" | "page-up" | "page-down" | "previous-value" | "next-value" | "activate" | "open-filter" | "close" | "undo" | "part-previous" | "part-next" | "part-change";
+type Action = "move-up" | "move-down" | "block-up" | "block-down" | "first" | "last" | "page-up" | "page-down" | "previous-value" | "next-value" | "activate" | "edit-filter" | "close" | "undo" | "part-previous" | "part-next" | "part-change";
 export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
 /**
  * The settings screen. Rows, sticky headers, scrolling, and the keymap come from
@@ -12,9 +13,15 @@ export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
 export declare class SettingsApp implements UiApp {
     #private;
     readonly id = "settings";
-    /** `pinned` presents the screen as a resident Settings tab, which offers no screen-level close. */
-    constructor(session: OwnedSettingsManager, options?: {
+    /**
+     * `pinned` presents the screen as a resident Settings tab, which offers no screen-level close;
+     * `configurePlusMenu` opens the tab bar's Plus Menu dialog in place of this screen's own.
+     */
+    constructor(session: OwnedSettingsManager, options: {
         readonly pinned?: boolean;
+        readonly searchInputFactory: SettingsSearchInputFactory;
+        readonly copyText?: (text: string) => void;
+        readonly configurePlusMenu?: (() => boolean) | null;
     });
     onActivate(host: AppHostServices): void;
     onClose(_host: AppHostServices): void;