@timurproko/a1 0.2.7-dev.1245 → 0.2.7-dev.1252

package/dist/composition/utility-tab.d.ts

@@ -1,28 +0,0 @@
-import type { OwnedUiApplicationPort, PresentationTerminalPort } from "../contracts/presentation/index.js";
-import type { TabBridgeClient } from "../foundation/resident-tabs/bridge-client.js";
-import type { ResidentTabRoute } from "../foundation/resident-tabs/routes.js";
-import type { ReleaseNoteCatalog } from "../features/owned-ui/release-notes.js";
-import type { UiRouteHost } from "../ui/apps/contracts.js";
-import type { OwnedSettingsManager } from "../ui/settings/manager.js";
-import { terminateOwnedUiProcess } from "../features/owned-ui/run.js";
-export { terminateOwnedUiProcess };
-export interface UtilityTabOptions {
-    readonly route: ResidentTabRoute;
-    readonly bridge: TabBridgeClient;
-    readonly cwd?: string;
-    readonly profileId?: string;
-    readonly terminal?: PresentationTerminalPort;
-    readonly agentDir?: string;
-    readonly settings?: OwnedSettingsManager;
-    readonly routeHost?: UiRouteHost;
-    readonly releaseNotes?: ReleaseNoteCatalog;
-    readonly onApplication?: (application: OwnedUiApplicationPort) => void;
-}
-export interface UtilityTabComposition {
-    readonly application: OwnedUiApplicationPort;
-    readonly settings: OwnedSettingsManager;
-}
-/** Runs one pinned Settings or Changelog screen without constructing an Agent engine or session. */
-export declare function runUtilityTab(options: UtilityTabOptions): Promise<number>;
-export declare function composeUtilityTab(options: UtilityTabOptions): Promise<UtilityTabComposition>;
-export declare function utilityAgentDir(environment?: NodeJS.ProcessEnv): string;

package/dist/composition/utility-tab.js

@@ -1,244 +0,0 @@
-import { homedir } from "node:os";
-import { resolve } from "node:path";
-import { MAX_CLIPBOARD_TEXT_BYTES } from "../contracts/owned-ui/index.js";
-import { writeSystemClipboardText } from "../app/session-shell/system-clipboard.js";
-import { OwnedUiTerminalHost, } from "../app/session-shell/shell-host.js";
-import { nativeHyperlinkStyle } from "../ui/components/spans.js";
-import { createPiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
-import { applyConfiguredPiTheme, setPiAccentColor, setPiPackageBorderProjectionEnabled } from "../integrations/pi/components/upstream/theme/theme.js";
-import { createPiTerminalBridge } from "../integrations/pi/tui-runtime/presentation-adapter.js";
-import { resolveLaunchProfilePaths } from "../features/launch/profile-paths.js";
-import { createOwnedSettingsManager, watchSharedSettings } from "./owned-settings.js";
-import { residentRouteHostOptions, residentTabKeybindings } from "./resident-tab-bridge.js";
-import { createOwnedRouteHost } from "./settings-route-host.js";
-import { runOwnedUi, terminateOwnedUiProcess } from "../features/owned-ui/run.js";
-export { terminateOwnedUiProcess };
-/** Runs one pinned Settings or Changelog screen without constructing an Agent engine or session. */
-export async function runUtilityTab(options) {
-    const composition = await composeUtilityTab(options);
-    options.onApplication?.(composition.application);
-    return await runOwnedUi(composition);
-}
-export async function composeUtilityTab(options) {
-    const cwd = options.cwd ?? process.cwd();
-    const agentDir = options.agentDir ?? utilityAgentDir();
-    const { settings, offline } = await prepareUtilitySettings(options, cwd, agentDir);
-    await options.bridge.start().catch(() => false);
-    options.bridge.status("starting");
-    applyUtilityTheme(settings, options.bridge);
-    const keybindings = residentTabKeybindings(options.bridge, agentDir, createPiKeybindingsHost({ profile: "a1", agentDir }));
-    const routeHost = options.routeHost ?? createUtilityRouteHost(options, settings, keybindings, cwd, agentDir);
-    return {
-        settings,
-        application: createUtilityApplication(options, settings, offline, routeHost),
-    };
-}
-async function prepareUtilitySettings(options, cwd, agentDir) {
-    const offline = options.settings === undefined && options.route === "settings"
-        ? await import("../integrations/pi/engine/offline-settings-port.js")
-            .then(module => module.createOfflinePiSettingsPort({ cwd, agentDir }))
-        : null;
-    return {
-        offline,
-        settings: options.settings ?? createOwnedSettingsManager({
-            profileId: options.profileId ?? "a1",
-            agent: offline?.port ?? null,
-        }),
-    };
-}
-function applyUtilityTheme(settings, bridge) {
-    setPiPackageBorderProjectionEnabled(true);
-    setPiAccentColor(settings.value("accentColor"));
-    applyConfiguredPiTheme("dark");
-    bridge.accent(settings.value("accentColor"));
-}
-function createUtilityRouteHost(options, settings, keybindings, cwd, agentDir) {
-    let catalog;
-    const releaseNoteCatalog = () => catalog ??= options.releaseNotes === undefined
-        ? import("../features/owned-ui/release-notes.js").then(module => module.readPackagedReleaseNotes())
-        : Promise.resolve(options.releaseNotes);
-    return pinnedRouteHost(options.route, createOwnedRouteHost(settings, {
-        changelog: async () => {
-            const [notes, { renderPiShellChangelogLines }] = await Promise.all([
-                releaseNoteCatalog(),
-                import("../integrations/pi/components/shell-presenters-info.js"),
-            ]);
-            return { rows: width => renderPiShellChangelogLines(notes.completeMarkdown, width).map(row => nativeHyperlinkStyle(row)) };
-        },
-        hotkeys: async () => { throw new Error("hotkeys are unavailable in a utility tab"); },
-        session: async () => { throw new Error("session information is unavailable in a utility tab"); },
-    }, {
-        ...residentRouteHostOptions(options.bridge),
-        keybindings,
-        agentDir,
-        cwd,
-        copyText: text => {
-            if (Buffer.byteLength(text) > MAX_CLIPBOARD_TEXT_BYTES)
-                return false;
-            void writeSystemClipboardText(text).catch(() => { });
-            return true;
-        },
-    }));
-}
-function createUtilityApplication(options, settings, offline, routeHost) {
-    const backgroundSettings = {
-        snapshot: () => settings.value("backgroundStyle"),
-        onChange: listener => settings.onChange(current => listener(current.value("backgroundStyle"))),
-    };
-    const terminalHost = new OwnedUiTerminalHost({
-        layout: "custom-viewport", mode: "fullscreen", hardwareCursor: false,
-        ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-        backgroundSettings,
-    });
-    const presenter = new UtilityTabPresenter(terminalHost, routeHost, options.route, options.bridge);
-    const removeBoundaryInput = terminalHost.runtime.addPreInputListener(data => ({ data: options.bridge.consumeControllerBoundaryInput(data) }));
-    const unwatchSettings = watchSharedSettings(settings);
-    const unsubscribeAccent = settings.onChange(current => {
-        const accent = current.value("accentColor");
-        setPiAccentColor(accent);
-        options.bridge.accent(accent);
-    });
-    let disposed = false;
-    let started = false;
-    let stopResolve;
-    let unsubscribeBridge = () => { };
-    const stopped = new Promise(resolvePromise => { stopResolve = resolvePromise; });
-    return {
-        get disposed() { return disposed; },
-        start: () => {
-            if (started || disposed)
-                return;
-            started = true;
-            presenter.start();
-            terminalHost.attach(presenter);
-            unsubscribeBridge = options.bridge.onCommand(command => handleBridgeCommand(command, presenter, options.route, () => {
-                stopResolve();
-                void terminalHost.dispose().catch(() => undefined);
-            }));
-            options.bridge.status("idle");
-            void offline?.modelsReady.then(() => settings.load()).catch(() => undefined);
-        },
-        flush: async () => { },
-        waitUntilStopped: () => stopped,
-        dispose: async () => {
-            if (disposed)
-                return;
-            disposed = true;
-            stopResolve();
-            unsubscribeBridge();
-            unsubscribeAccent();
-            unwatchSettings();
-            removeBoundaryInput();
-            try {
-                await terminalHost.dispose();
-            }
-            finally {
-                options.bridge.close();
-            }
-        },
-    };
-}
-function pinnedRouteHost(route, host) {
-    return {
-        claims: candidate => candidate === route && host.claims(candidate),
-        open: (candidate, input) => candidate === route ? host.open(candidate, input) : null,
-    };
-}
-function handleBridgeCommand(command, presenter, route, stop) {
-    if (command.type === "stop")
-        stop();
-    else if (command.type === "route" && command.route === route)
-        presenter.presentRoute();
-}
-export function utilityAgentDir(environment = process.env) {
-    const configured = environment.PI_CODING_AGENT_DIR;
-    if (configured !== undefined && configured.trim().length > 0) {
-        return resolve(configured.startsWith("~/") || configured.startsWith("~\\")
-            ? `${homedir()}${configured.slice(1)}`
-            : configured);
-    }
-    return resolveLaunchProfilePaths().agentProfile;
-}
-class UtilityTabPresenter {
-    #host;
-    #terminal;
-    #routeHost;
-    #route;
-    #bridge;
-    #surface = null;
-    #routeHandle = null;
-    #released = false;
-    constructor(host, routeHost, route, bridge) {
-        this.#host = host;
-        this.#routeHost = routeHost;
-        this.#route = route;
-        this.#bridge = bridge;
-        this.#terminal = host.connect(this);
-    }
-    render(_width) { return []; }
-    handleInput(_data) { }
-    invalidate() { this.#terminal.requestRender(); }
-    setFocused(_focused) { }
-    inputCoordinationSurface() { return "owned"; }
-    setOverlaySurfaces(_surfaces) { }
-    noteImmediatePresentation() { }
-    handleViewportInput(_data) { return undefined; }
-    layoutPart(_part) { return EMPTY_COMPONENT; }
-    activated() { this.presentRoute(); }
-    start() { this.#terminal.start(); }
-    waitUntilStopped() { return new Promise(() => { }); }
-    dispose() { return this.#host.close(this); }
-    presentRoute() {
-        if (this.#released || this.#routeHandle !== null)
-            return;
-        if (!this.#terminal.running || !this.#terminal.attached)
-            return;
-        const surface = this.#routeHost.open(this.#route);
-        if (surface === null)
-            throw new Error(`utility route is unavailable: ${this.#route}`);
-        this.#surface = surface;
-        let exitRequested = false;
-        const handle = this.#terminal.openRoute(surface, {
-            closed: rendered => {
-                if (this.#routeHandle === handle)
-                    this.#routeHandle = null;
-                this.#surface = null;
-                queueMicrotask(() => {
-                    if (rendered && !exitRequested)
-                        void this.#bridge.requestClose();
-                });
-            },
-            exit: () => {
-                exitRequested = true;
-                void this.#bridge.requestDetach().then(() => this.presentRoute(), () => this.presentRoute());
-            },
-        });
-        this.#routeHandle = handle;
-    }
-    release() {
-        if (this.#released)
-            return { exitText: "", failures: [], settle: async () => [] };
-        this.#released = true;
-        const failures = [];
-        try {
-            this.#routeHandle?.hide();
-        }
-        catch (error) {
-            failures.push(error);
-        }
-        try {
-            this.#surface?.close();
-        }
-        catch (error) {
-            failures.push(error);
-        }
-        this.#routeHandle = null;
-        this.#surface = null;
-        return { exitText: "", failures, settle: async () => [] };
-    }
-}
-const EMPTY_COMPONENT = {
-    render: () => [],
-    handleInput: () => { },
-    invalidate: () => { },
-};

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

@@ -1,28 +0,0 @@
-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;
-}
-/** Presentation copy for a searchable ordered flag multi-select dialog. */
-export interface FlagToggleDialogPresentation {
-    readonly title: string;
-    readonly description: string;
-    readonly empty: string;
-}
-/** Owns only filtering and selection; the Settings screen owns enabled state and persistence. */
-export declare class FlagToggleDialog {
-    #private;
-    constructor(kinds: readonly PlusMenuKind[], presentation: FlagToggleDialogPresentation);
-    /** 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[];
-}
-/** The tab bar's specialized flag dialog, retained as the public Plus Menu surface. */
-export declare class PlusMenuDialog extends FlagToggleDialog {
-    constructor(kinds: readonly PlusMenuKind[]);
-}

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

@@ -1,89 +0,0 @@
-import { LineInput, handleLineInputKey, padToWidth, renderInputRow, renderShortcutHintsWithClose, 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 PLUS_MENU_PRESENTATION = Object.freeze({
-    title: "Plus Menu",
-    description: "Choose what the + button in the tab bar can add.",
-    empty: "No tabs match",
-});
-const HINTS = [
-    { key: "Type", action: "search" },
-    { key: "↑↓", action: "navigate" },
-    { key: "Space", action: "toggle" },
-    { key: "esc", action: "close" },
-];
-const PADDING_X = 2;
-/** Owns only filtering and selection; the Settings screen owns enabled state and persistence. */
-export class FlagToggleDialog {
-    #kinds;
-    #presentation;
-    #filter = new LineInput("");
-    #index = 0;
-    constructor(kinds, presentation) {
-        this.#kinds = kinds;
-        this.#presentation = presentation;
-    }
-    /** 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 frameWidth = Math.max(0, width);
-        const left = Math.min(PADDING_X, frameWidth);
-        const right = Math.min(PADDING_X, frameWidth - left);
-        const contentWidth = Math.max(0, frameWidth - left - right);
-        const blank = " ".repeat(frameWidth);
-        const row = (painted, selected = false) => {
-            const content = padToWidth(truncateToWidth(painted, contentWidth), contentWidth);
-            const rightPadding = " ".repeat(right);
-            return `${" ".repeat(left)}${selected ? theme.highlight(content) : content}${selected ? theme.panel(rightPadding) : rightPadding}`;
-        };
-        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", this.#presentation.empty))]
-            : shown.map((kind, position) => {
-                const selected = position === index;
-                const cursor = selected ? "→ " : "  ";
-                const marker = enabled[kind.key] === true ? "●" : "○";
-                const content = `${selected ? theme.fg("accent", cursor) : cursor}${theme.fg("text", marker)} ${theme.fg("text", kind.label)}`;
-                return row(content, selected);
-            });
-        return [
-            blank,
-            row(theme.bold(theme.fg("accent", this.#presentation.title))),
-            row(theme.fg("dim", this.#presentation.description)),
-            blank,
-            ...renderInputRow(this.#filter, contentWidth, { ruled: false, promptGlyph: "> ", theme }).lines.map(line => row(line)),
-            blank,
-            ...rows,
-            blank,
-            row(renderShortcutHintsWithClose(HINTS, theme, contentWidth)),
-            blank,
-        ];
-    }
-}
-/** The tab bar's specialized flag dialog, retained as the public Plus Menu surface. */
-export class PlusMenuDialog extends FlagToggleDialog {
-    constructor(kinds) { super(kinds, PLUS_MENU_PRESENTATION); }
-}

package/dist/features/resident-tab/auto-name.d.ts

@@ -1,11 +0,0 @@
-export declare const AUTO_NAME_MAX_LENGTH = 16;
-export declare const AUTO_NAME_TIMEOUT_MS = 30000;
-export declare const AUTO_NAME_TOKEN_BUDGETS: readonly [4096, 32768];
-export declare function normalizeAutoName(value: string): string | null;
-export declare function fallbackAutoName(prompt: string): string;
-export interface AutoNameCompletion {
-    readonly prompt: string;
-    readonly maxTokens: number;
-    readonly signal: AbortSignal;
-}
-export declare function generateAutoName(firstPrompt: string, complete: (request: AutoNameCompletion) => Promise<string | null>, timeoutMs?: number): Promise<string>;

package/dist/features/resident-tab/auto-name.js

@@ -1,44 +0,0 @@
-export const AUTO_NAME_MAX_LENGTH = 16;
-export const AUTO_NAME_TIMEOUT_MS = 30_000;
-// Rationale: reasoning models can spend a small ceiling on hidden thinking and emit no title, so an
-// answerless attempt retries with a larger bound; budgets stay strictly increasing, as in v2.
-export const AUTO_NAME_TOKEN_BUDGETS = [4_096, 32_768];
-export function normalizeAutoName(value) {
-    const normalized = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
-    if (!normalized)
-        return null;
-    if (normalized.length <= AUTO_NAME_MAX_LENGTH)
-        return normalized;
-    const clipped = normalized.slice(0, AUTO_NAME_MAX_LENGTH + 1);
-    const boundary = clipped.lastIndexOf("-");
-    const result = (boundary >= 4 ? clipped.slice(0, boundary) : normalized.slice(0, AUTO_NAME_MAX_LENGTH)).replace(/-+$/g, "");
-    return result || null;
-}
-export function fallbackAutoName(prompt) {
-    const words = prompt.toLowerCase().match(/[a-z0-9]+/g) ?? [];
-    return normalizeAutoName(words.slice(0, 3).join("-")) ?? "new-task";
-}
-export async function generateAutoName(firstPrompt, complete, timeoutMs = AUTO_NAME_TIMEOUT_MS) {
-    for (const maxTokens of AUTO_NAME_TOKEN_BUDGETS) {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), timeoutMs);
-        timer.unref?.();
-        try {
-            const response = await complete({
-                prompt: `Name this coding task with a lowercase hyphenated title of at most ${AUTO_NAME_MAX_LENGTH} characters. Reply only with the title.\n\n${firstPrompt.slice(0, 500)}`,
-                maxTokens,
-                signal: controller.signal,
-            });
-            const name = response === null ? null : normalizeAutoName(response);
-            if (name !== null)
-                return name;
-        }
-        catch {
-            // Rationale: naming is best effort; the larger bounded attempt precedes the deterministic fallback.
-        }
-        finally {
-            clearTimeout(timer);
-        }
-    }
-    return fallbackAutoName(firstPrompt);
-}

package/dist/features/resident-tab/index.d.ts

@@ -1,5 +0,0 @@
-export { AUTO_NAME_MAX_LENGTH, AUTO_NAME_TIMEOUT_MS, AUTO_NAME_TOKEN_BUDGETS, fallbackAutoName, generateAutoName, normalizeAutoName, type AutoNameCompletion, } from "./auto-name.js";
-export { RESIDENT_TAB_SHORTCUTS, type ResidentTabAction, type ResidentTabShortcut, } from "./shortcut-declarations.js";
-export { projectResidentTabShortcuts, RESIDENT_TAB_GLOBAL_SHORTCUTS, type ResidentTabGlobalAction, type ResidentTabShortcutConflict, type ResidentTabShortcutProjection, type ShortcutBindings, } from "./shortcut-projection.js";
-export { readShortcutBindingsFile } from "./shortcut-bindings-file.js";
-export { deriveResidentTabStatus, type ResidentTabDerivedStatus, type ResidentTabFacts, } from "./status-deriver.js";

package/dist/features/resident-tab/index.js

@@ -1,7 +0,0 @@
-export { AUTO_NAME_MAX_LENGTH, AUTO_NAME_TIMEOUT_MS, AUTO_NAME_TOKEN_BUDGETS, fallbackAutoName, generateAutoName, normalizeAutoName, } from "./auto-name.js";
-// Performance: the registry builder lives in `shortcuts.ts`, outside this barrel, so startup
-// presentation can read the declarations without loading the component registry.
-export { RESIDENT_TAB_SHORTCUTS, } from "./shortcut-declarations.js";
-export { projectResidentTabShortcuts, RESIDENT_TAB_GLOBAL_SHORTCUTS, } from "./shortcut-projection.js";
-export { readShortcutBindingsFile } from "./shortcut-bindings-file.js";
-export { deriveResidentTabStatus, } from "./status-deriver.js";

package/dist/features/resident-tab/shortcut-bindings-file.d.ts

@@ -1,8 +0,0 @@
-import type { ShortcutBindings } from "./shortcut-projection.js";
-/** Largest `keybindings.json` the projection reads; a larger file counts as absent. */
-export declare const MAX_SHORTCUT_BINDINGS_BYTES: number;
-/**
- * Reads the user's `keybindings.json` as shortcut bindings, keeping `null` entries so an
- * explicit unbind survives, and treating any unreadable or malformed file as empty.
- */
-export declare function readShortcutBindingsFile(agentDir: string): ShortcutBindings;

package/dist/features/resident-tab/shortcut-bindings-file.js

@@ -1,40 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-/** Largest `keybindings.json` the projection reads; a larger file counts as absent. */
-export const MAX_SHORTCUT_BINDINGS_BYTES = 256 * 1024;
-/**
- * Reads the user's `keybindings.json` as shortcut bindings, keeping `null` entries so an
- * explicit unbind survives, and treating any unreadable or malformed file as empty.
- */
-export function readShortcutBindingsFile(agentDir) {
-    let text;
-    try {
-        text = readFileSync(join(agentDir, "keybindings.json"), "utf8");
-    }
-    catch {
-        return {};
-    }
-    if (text.length > MAX_SHORTCUT_BINDINGS_BYTES)
-        return {};
-    let parsed;
-    try {
-        parsed = JSON.parse(text.replace(/^/u, ""));
-    }
-    catch {
-        return {};
-    }
-    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
-        return {};
-    const bindings = {};
-    for (const [action, value] of Object.entries(parsed)) {
-        if (action === "$schema")
-            continue;
-        if (value === null || typeof value === "string") {
-            bindings[action] = value;
-            continue;
-        }
-        if (Array.isArray(value))
-            bindings[action] = value.filter((key) => typeof key === "string");
-    }
-    return bindings;
-}

package/dist/features/resident-tab/shortcut-declarations.d.ts

@@ -1,13 +0,0 @@
-export type ResidentTabAction = "tabs.new" | "tabs.close" | "tabs.rename" | "tabs.settings" | "tabs.changelog" | "tabs.commands" | "tabs.retry" | "tabs.fresh" | "tabs.next" | "tabs.previous" | "tabs.moveRight" | "tabs.moveLeft" | `tabs.jump${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10}`;
-export interface ResidentTabShortcut {
-    readonly id: ResidentTabAction;
-    readonly defaultKey: string | null;
-    readonly scope: "global" | "failed-banner";
-    readonly description: string;
-}
-/**
- * The tab shortcut declarations, in the order that decides which action keeps a duplicated key.
- * This module stays dependency-free so startup presentation and the resident projection can
- * read it without loading the component registry.
- */
-export declare const RESIDENT_TAB_SHORTCUTS: readonly ResidentTabShortcut[];

package/dist/features/resident-tab/shortcut-declarations.js

@@ -1,26 +0,0 @@
-const jumps = Array.from({ length: 10 }, (_, index) => ({
-    id: `tabs.jump${index + 1}`,
-    defaultKey: `alt+${(index + 1) % 10}`,
-    scope: "global",
-    description: `View A1 tab ${index + 1}`,
-}));
-/**
- * The tab shortcut declarations, in the order that decides which action keeps a duplicated key.
- * This module stays dependency-free so startup presentation and the resident projection can
- * read it without loading the component registry.
- */
-export const RESIDENT_TAB_SHORTCUTS = Object.freeze([
-    { id: "tabs.new", defaultKey: "alt+a", scope: "global", description: "New A1 tab" },
-    { id: "tabs.close", defaultKey: "alt+w", scope: "global", description: "Close A1 tab" },
-    { id: "tabs.rename", defaultKey: "f2", scope: "global", description: "Rename A1 tab" },
-    { id: "tabs.settings", defaultKey: "alt+,", scope: "global", description: "Open Settings tab" },
-    { id: "tabs.changelog", defaultKey: null, scope: "global", description: "Open Changelog tab" },
-    { id: "tabs.commands", defaultKey: "alt+/", scope: "global", description: "Open command palette" },
-    ...jumps,
-    { id: "tabs.next", defaultKey: null, scope: "global", description: "View next A1 tab" },
-    { id: "tabs.previous", defaultKey: null, scope: "global", description: "View previous A1 tab" },
-    { id: "tabs.moveRight", defaultKey: null, scope: "global", description: "Move A1 tab right" },
-    { id: "tabs.moveLeft", defaultKey: null, scope: "global", description: "Move A1 tab left" },
-    { id: "tabs.retry", defaultKey: "r", scope: "failed-banner", description: "Retry failed A1 tab" },
-    { id: "tabs.fresh", defaultKey: "f", scope: "failed-banner", description: "Start failed A1 tab fresh" },
-]);

package/dist/features/resident-tab/shortcut-projection.d.ts

@@ -1,29 +0,0 @@
-import { type ResidentTabAction } from "./shortcut-declarations.js";
-/** Key assignments as `keybindings.json` and the keybinding manager express them. */
-export type ShortcutBindings = Readonly<Record<string, string | readonly string[] | null | undefined>>;
-export type ResidentTabGlobalAction = Exclude<ResidentTabAction, "tabs.retry" | "tabs.fresh">;
-export interface ResidentTabShortcutConflict {
-    readonly id: ResidentTabGlobalAction;
-    readonly key: string;
-    /** `reserved` keys belong to an A1 action; `duplicate` keys were claimed by an earlier tab action. */
-    readonly reason: "reserved" | "duplicate";
-}
-/** The effective tab shortcuts the resident shell dispatches and every presentation shows. */
-export interface ResidentTabShortcutProjection {
-    readonly assignments: Readonly<Record<ResidentTabGlobalAction, string | null>>;
-    readonly conflicts: readonly ResidentTabShortcutConflict[];
-}
-export interface ResidentTabShortcutInput {
-    /** The user's `keybindings.json`, including any `tabs.*` entries; `null` unbinds an action. */
-    readonly configured?: ShortcutBindings | undefined;
-    /** The effective A1 declarations (defaults plus customization) whose keys tab actions may not take. */
-    readonly reserved?: ShortcutBindings | undefined;
-}
-/** The declarations the projection covers, in the order that decides duplicate claims. */
-export declare const RESIDENT_TAB_GLOBAL_SHORTCUTS: import("./shortcut-declarations.js").ResidentTabShortcut[];
-/**
- * Projects the effective A1 declarations and the user's customization into one tab shortcut
- * assignment per action. A key an A1 action holds after customization never becomes a tab
- * shortcut; between tab actions the earlier declaration keeps a duplicated key.
- */
-export declare function projectResidentTabShortcuts(input?: ResidentTabShortcutInput): ResidentTabShortcutProjection;

package/dist/features/resident-tab/shortcut-projection.js

@@ -1,64 +0,0 @@
-import { RESIDENT_TAB_SHORTCUTS } from "./shortcut-declarations.js";
-/** The declarations the projection covers, in the order that decides duplicate claims. */
-export const RESIDENT_TAB_GLOBAL_SHORTCUTS = RESIDENT_TAB_SHORTCUTS.filter(shortcut => shortcut.scope === "global");
-function normalizeKey(key) {
-    return key.trim().toLowerCase();
-}
-function keysOf(value) {
-    if (value === null || value === undefined)
-        return value;
-    if (typeof value === "string")
-        return [value];
-    return value.filter((key) => typeof key === "string");
-}
-/**
- * Projects the effective A1 declarations and the user's customization into one tab shortcut
- * assignment per action. A key an A1 action holds after customization never becomes a tab
- * shortcut; between tab actions the earlier declaration keeps a duplicated key.
- */
-export function projectResidentTabShortcuts(input = {}) {
-    const configured = input.configured ?? {};
-    const claimedByOwnedActions = new Map();
-    for (const [action, value] of Object.entries(input.reserved ?? {})) {
-        if (action.startsWith("tabs."))
-            continue;
-        claimedByOwnedActions.set(action, keysOf(value) ?? []);
-    }
-    for (const [action, value] of Object.entries(configured)) {
-        if (action.startsWith("tabs.") || action === "$schema")
-            continue;
-        claimedByOwnedActions.set(action, keysOf(value) ?? []);
-    }
-    const reserved = new Set();
-    for (const keys of claimedByOwnedActions.values())
-        for (const key of keys)
-            reserved.add(normalizeKey(key));
-    const claimed = new Set();
-    const conflicts = [];
-    const assignments = {};
-    for (const shortcut of RESIDENT_TAB_GLOBAL_SHORTCUTS) {
-        const id = shortcut.id;
-        const custom = configured[id];
-        const candidates = custom === undefined
-            ? (shortcut.defaultKey === null ? [] : [shortcut.defaultKey])
-            : (keysOf(custom) ?? []);
-        let assigned = null;
-        for (const candidate of candidates.map(normalizeKey)) {
-            if (candidate.length === 0)
-                continue;
-            if (reserved.has(candidate)) {
-                conflicts.push({ id, key: candidate, reason: "reserved" });
-                continue;
-            }
-            if (claimed.has(candidate)) {
-                conflicts.push({ id, key: candidate, reason: "duplicate" });
-                continue;
-            }
-            assigned = candidate;
-            claimed.add(candidate);
-            break;
-        }
-        assignments[id] = assigned;
-    }
-    return { assignments, conflicts };
-}

package/dist/features/resident-tab/status-deriver.d.ts

@@ -1,10 +0,0 @@
-/** How the tab's last agent turn settled; it persists until the next turn starts. */
-export type ResidentTabTurnSettlement = "done" | "aborted" | "error";
-export type ResidentTabDerivedStatus = "starting" | "working" | "needs-input" | "idle" | "failed" | ResidentTabTurnSettlement;
-export interface ResidentTabFacts {
-    readonly lifecycle: string;
-    readonly pendingRequests: number;
-    readonly queuedInput: number;
-    readonly lastTurn?: ResidentTabTurnSettlement;
-}
-export declare function deriveResidentTabStatus(facts: ResidentTabFacts): ResidentTabDerivedStatus;