@ironbee-ai/cli 0.12.0 → 0.13.0

package/dist/tui/shell/area.d.ts

@@ -0,0 +1,47 @@
+/**
+ * IronBee — TUI shell: area contract
+ *
+ * An "area" is one top-level section of the TUI (Configuration, Platforms,
+ * Projects, …) — the rough analog of a first-level CLI command group. The
+ * shell hosts exactly one area at a time inside a shared content region and
+ * provides each area a context to drive navigation and shared modals.
+ *
+ * Adding an area = implement {@link TuiArea} + append it to `shell/registry.ts`.
+ */
+import * as blessed from "blessed";
+import { TuiSession } from "./session";
+/** Services + region the shell hands an area when mounting it. */
+export interface AreaContext {
+    /** The single shared blessed screen. */
+    screen: blessed.Widgets.Screen;
+    /** The content region the area renders its widgets into (between the frame bars). */
+    container: blessed.Widgets.BoxElement;
+    /** Shared session — projectDir, exit-rerender flag, modal helpers. */
+    session: TuiSession;
+    /** Unmount this area and return to the home menu. */
+    back(): void;
+    /** Tear down the whole app and exit. */
+    quit(): void;
+    /** Set the bottom status/help bar text (blessed tags allowed). */
+    setStatus(help: string): void;
+    /** Switch the active project (updates `session.projectDir` + breadcrumb). Other
+     *  project-scoped areas read it at their next mount. */
+    setActiveProject(dir: string): void;
+}
+/** Returned by {@link TuiArea.mount}; lets the shell tear the area down. */
+export interface AreaHandle {
+    /** Destroy the area's widgets and unbind its keys. */
+    unmount(): void;
+}
+/** One top-level TUI section. */
+export interface TuiArea {
+    /** Stable id, used for deep-linking (`ironbee tui <id>`). */
+    id: string;
+    /** Title shown in the breadcrumb and home menu. */
+    title: string;
+    /** One-line description shown in the home menu. */
+    summary: string;
+    /** Build the area's UI into `ctx.container`, wire keys, focus. */
+    mount(ctx: AreaContext): AreaHandle;
+}
+//# sourceMappingURL=area.d.ts.map

package/dist/tui/shell/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,kEAAkE;AAClE,MAAM,WAAW,WAAW;IACxB,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/B,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IACtC,sEAAsE;IACtE,OAAO,EAAE,UAAU,CAAC;IACpB,qDAAqD;IACrD,IAAI,IAAI,IAAI,CAAC;IACb,wCAAwC;IACxC,IAAI,IAAI,IAAI,CAAC;IACb,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;4DACwD;IACxD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACvB,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,OAAO;IACpB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CAAC;CACvC"}

package/dist/tui/shell/area.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * IronBee — TUI shell: area contract
+ *
+ * An "area" is one top-level section of the TUI (Configuration, Platforms,
+ * Projects, …) — the rough analog of a first-level CLI command group. The
+ * shell hosts exactly one area at a time inside a shared content region and
+ * provides each area a context to drive navigation and shared modals.
+ *
+ * Adding an area = implement {@link TuiArea} + append it to `shell/registry.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=area.js.map

package/dist/tui/shell/area.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.js","sourceRoot":"","sources":["../../../src/tui/shell/area.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/tui/shell/frame.d.ts

@@ -0,0 +1,23 @@
+/**
+ * IronBee — TUI shell: frame (persistent chrome around the content region)
+ *
+ * Top breadcrumb bar (`IronBee ▸ Configuration`), a content region areas mount
+ * into, and a bottom status/help bar. Named "frame" (not "chrome") to avoid
+ * confusion with the browser DevTools / Chrome concept elsewhere in IronBee.
+ */
+import * as blessed from "blessed";
+/** The frame widgets + setters the shell drives. */
+export interface Frame {
+    /** Region areas render into (between the two bars). */
+    content: blessed.Widgets.BoxElement;
+    /** Set the breadcrumb trail, e.g. `["IronBee", "Configuration"]`. */
+    setBreadcrumb(parts: string[]): void;
+    /** Set the bottom status/help text (blessed tags allowed). */
+    setStatus(help: string): void;
+}
+/** Build the frame on `screen` and return its handles. `getProjectDir` is read
+ *  on every `setBreadcrumb` so the breadcrumb always shows the CURRENT active
+ *  project (which is switchable) — i.e. the project the project/local layers
+ *  resolve against (`<projectDir>/.ironbee/config*.json`). */
+export declare function buildFrame(screen: blessed.Widgets.Screen, getProjectDir: () => string): Frame;
+//# sourceMappingURL=frame.d.ts.map

package/dist/tui/shell/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/frame.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,oDAAoD;AACpD,MAAM,WAAW,KAAK;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;IACpC,qEAAqE;IACrE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;8DAG8D;AAC9D,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,MAAM,GAAG,KAAK,CA2C7F"}

package/dist/tui/shell/frame.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * IronBee — TUI shell: frame (persistent chrome around the content region)
+ *
+ * Top breadcrumb bar (`IronBee ▸ Configuration`), a content region areas mount
+ * into, and a bottom status/help bar. Named "frame" (not "chrome") to avoid
+ * confusion with the browser DevTools / Chrome concept elsewhere in IronBee.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFrame = buildFrame;
+const blessed = __importStar(require("blessed"));
+const util_1 = require("./util");
+/** Build the frame on `screen` and return its handles. `getProjectDir` is read
+ *  on every `setBreadcrumb` so the breadcrumb always shows the CURRENT active
+ *  project (which is switchable) — i.e. the project the project/local layers
+ *  resolve against (`<projectDir>/.ironbee/config*.json`). */
+function buildFrame(screen, getProjectDir) {
+    const breadcrumb = blessed.box({
+        parent: screen,
+        top: 0,
+        left: 0,
+        width: "100%",
+        height: 1,
+        tags: true,
+        style: { fg: "white", bg: "blue" },
+        content: "",
+    });
+    const content = blessed.box({
+        parent: screen,
+        top: 1,
+        left: 0,
+        width: "100%",
+        height: "100%-2",
+        tags: true,
+    });
+    const status = blessed.box({
+        parent: screen,
+        bottom: 0,
+        left: 0,
+        width: "100%",
+        height: 1,
+        tags: true,
+        style: { fg: "white", bg: "black" },
+        content: "",
+    });
+    return {
+        content,
+        setBreadcrumb(parts) {
+            const trail = parts.map((p) => (0, util_1.escapeTags)(p)).join(" {white-fg}▸{/white-fg} ");
+            const dirSuffix = `  {white-fg}·{/white-fg} ${(0, util_1.escapeTags)(getProjectDir())}`;
+            breadcrumb.setContent(` {bold}${trail}{/bold}${dirSuffix}`);
+        },
+        setStatus(help) {
+            status.setContent(` ${help}`);
+        },
+    };
+}
+//# sourceMappingURL=frame.js.map

package/dist/tui/shell/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../../src/tui/shell/frame.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBH,gCA2CC;AA5DD,iDAAmC;AACnC,iCAAoC;AAYpC;;;8DAG8D;AAC9D,SAAgB,UAAU,CAAC,MAA8B,EAAE,aAA2B;IAClF,MAAM,UAAU,GAA+B,OAAO,CAAC,GAAG,CAAC;QACvD,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE;QAClC,OAAO,EAAE,EAAE;KACd,CAAC,CAAC;IAEH,MAAM,OAAO,GAA+B,OAAO,CAAC,GAAG,CAAC;QACpD,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,MAAM,MAAM,GAA+B,OAAO,CAAC,GAAG,CAAC;QACnD,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE;QACnC,OAAO,EAAE,EAAE;KACd,CAAC,CAAC;IAEH,OAAO;QACH,OAAO;QACP,aAAa,CAAC,KAAe;YACzB,MAAM,KAAK,GAAW,KAAK,CAAC,GAAG,CAAC,CAAC,CAAS,EAAU,EAAE,CAAC,IAAA,iBAAU,EAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvG,MAAM,SAAS,GAAW,4BAA4B,IAAA,iBAAU,EAAC,aAAa,EAAE,CAAC,EAAE,CAAC;YACpF,UAAU,CAAC,UAAU,CAAC,UAAU,KAAK,UAAU,SAAS,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,SAAS,CAAC,IAAY;YAClB,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/tui/shell/registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * IronBee — TUI area registry
+ *
+ * The list of top-level TUI areas, in home-menu display order. Adding an area
+ * is a one-line append here (+ its module) — the analog of `REGISTERED_CLIENTS`.
+ */
+import { TuiArea } from "./area";
+export declare const AREAS: TuiArea[];
+/** Look up an area by id (for `ironbee tui <id>` deep-linking). */
+export declare function findArea(id: string): TuiArea | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tui/shell/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,eAAO,MAAM,KAAK,EAAE,OAAO,EAO1B,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAExD"}

package/dist/tui/shell/registry.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * IronBee — TUI area registry
+ *
+ * The list of top-level TUI areas, in home-menu display order. Adding an area
+ * is a one-line append here (+ its module) — the analog of `REGISTERED_CLIENTS`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AREAS = void 0;
+exports.findArea = findArea;
+const area_1 = require("../config/area");
+const area_2 = require("../import/area");
+const area_3 = require("../platforms/area");
+const area_4 = require("../projects/area");
+const area_5 = require("../queue/area");
+const area_6 = require("../sessions/area");
+exports.AREAS = [
+    area_1.configArea,
+    area_3.platformsArea,
+    area_4.projectsArea,
+    area_6.sessionsArea,
+    area_5.queueArea,
+    area_2.importArea,
+];
+/** Look up an area by id (for `ironbee tui <id>` deep-linking). */
+function findArea(id) {
+    return exports.AREAS.find((a) => a.id === id);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tui/shell/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tui/shell/registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAoBH,4BAEC;AApBD,yCAA4C;AAC5C,yCAA4C;AAC5C,4CAAkD;AAClD,2CAAgD;AAChD,wCAA0C;AAC1C,2CAAgD;AAGnC,QAAA,KAAK,GAAc;IAC5B,iBAAU;IACV,oBAAa;IACb,mBAAY;IACZ,mBAAY;IACZ,gBAAS;IACT,iBAAU;CACb,CAAC;AAEF,mEAAmE;AACnE,SAAgB,QAAQ,CAAC,EAAU;IAC/B,OAAO,aAAK,CAAC,IAAI,CAAC,CAAC,CAAU,EAAW,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/tui/shell/rerender.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IronBee — TUI shell: artifact rerender (app-global, runs once on exit)
+ *
+ * Any area that mutates artifact-affecting config flags the session; on app
+ * exit (after the screen is torn down) the shell re-renders installed client
+ * artifacts ONCE with normal console output. This is cross-area (config edits,
+ * future platform toggles, …), so it lives at the shell level rather than in
+ * any single area. Reads only the public clients/lib surface.
+ */
+/**
+ * Re-render installed client artifacts so they reflect the current (merged)
+ * on-disk config. Returns the client names that were re-rendered, or `[]` when
+ * no client is detected and no explicit `clientName` was given.
+ */
+export declare function rerenderArtifacts(projectDir: string, clientName?: string): string[];
+//# sourceMappingURL=rerender.d.ts.map

package/dist/tui/shell/rerender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerender.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/rerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAYnF"}

package/dist/tui/shell/rerender.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * IronBee — TUI shell: artifact rerender (app-global, runs once on exit)
+ *
+ * Any area that mutates artifact-affecting config flags the session; on app
+ * exit (after the screen is torn down) the shell re-renders installed client
+ * artifacts ONCE with normal console output. This is cross-area (config edits,
+ * future platform toggles, …), so it lives at the shell level rather than in
+ * any single area. Reads only the public clients/lib surface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rerenderArtifacts = rerenderArtifacts;
+const registry_1 = require("../../clients/registry");
+const config_1 = require("../../lib/config");
+const gitignore_1 = require("../../lib/gitignore");
+/**
+ * Re-render installed client artifacts so they reflect the current (merged)
+ * on-disk config. Returns the client names that were re-rendered, or `[]` when
+ * no client is detected and no explicit `clientName` was given.
+ */
+function rerenderArtifacts(projectDir, clientName) {
+    const detected = (0, registry_1.detectClients)(projectDir);
+    if (clientName === undefined && detected.length === 0) {
+        return [];
+    }
+    const cfg = (0, config_1.loadConfig)(projectDir);
+    const clients = (0, registry_1.resolveTargetClients)(projectDir, clientName);
+    for (const client of clients) {
+        client.install(projectDir, cfg);
+    }
+    (0, gitignore_1.ensureIronBeeGitignored)(projectDir);
+    return clients.map((c) => c.name);
+}
+//# sourceMappingURL=rerender.js.map

package/dist/tui/shell/rerender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerender.js","sourceRoot":"","sources":["../../../src/tui/shell/rerender.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAYH,8CAYC;AArBD,qDAA6E;AAC7E,6CAA6D;AAC7D,mDAA8D;AAE9D;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,UAAkB,EAAE,UAAmB;IACrE,MAAM,QAAQ,GAAc,IAAA,wBAAa,EAAC,UAAU,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAkB,IAAA,mBAAU,EAAC,UAAU,CAAC,CAAC;IAClD,MAAM,OAAO,GAAc,IAAA,+BAAoB,EAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAA,mCAAuB,EAAC,UAAU,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/tui/shell/session.d.ts

@@ -0,0 +1,75 @@
+/**
+ * IronBee — TUI shell: session
+ *
+ * Cross-area state + shared modal helpers. One session per `ironbee tui` run.
+ *
+ *  - `projectDir`            — the resolved project directory all areas read/write against.
+ *  - rerender flag           — any area that changes artifact-affecting config calls
+ *                              `markRerenderNeeded()`; the app re-renders client artifacts
+ *                              ONCE on exit (never mid-session — install stdout would
+ *                              corrupt the screen).
+ *  - `isModalOpen()`         — true while a shared modal (prompt/confirm/message/pick) is
+ *                              up, so the shell's global Esc=back doesn't fire underneath it.
+ *  - modal helpers           — prompt / confirm / message / pick, reused by every area so
+ *                              they don't each reimplement (and so modal tracking + focus
+ *                              restore are uniform).
+ */
+import * as blessed from "blessed";
+export declare class TuiSession {
+    readonly screen: blessed.Widgets.Screen;
+    /** The directory the TUI was launched in (cwd / -p) — immutable. Used by
+     *  "register cwd". The *active* project (what areas read) can differ. */
+    readonly launchDir: string;
+    private activeProjectDir;
+    /** Project dirs whose artifacts need re-rendering on exit. A Set (not a
+     *  bool) because the active project is switchable — the user can edit
+     *  artifact-affecting config across several projects in one session. */
+    private rerenderDirs;
+    private modalOpen;
+    constructor(screen: blessed.Widgets.Screen, projectDir: string);
+    /** The active project — what every project-scoped area reads at mount. */
+    get projectDir(): string;
+    /** Switch the active project (in-memory, TUI-session only). */
+    setProjectDir(dir: string): void;
+    /** Flag `dir`'s artifacts for re-render on exit. */
+    markRerenderNeeded(dir: string): void;
+    isRerenderNeeded(): boolean;
+    /** Drain the set of project dirs needing a rerender (clears it). */
+    rerenderProjects(): string[];
+    isModalOpen(): boolean;
+    /** Capture focus + flag a modal as open; returns the restore function. */
+    private openModal;
+    /** Transient auto-dismissing notice (3s or any key). */
+    message(text: string): void;
+    /** Single-line text input. `cb` gets the entered string, or `null` on cancel (Esc). */
+    prompt(label: string, value: string, cb: (raw: string | null) => void): void;
+    /**
+     * Yes/no question. `cb` gets `true` for yes. Rendered as an arrow-navigable
+     * Yes/No list (NOT blessed's `question` widget, whose OK/Cancel buttons only
+     * respond to y/n/enter/esc keypresses, not ↑/↓ selection). Defaults to "No"
+     * (safer for the destructive confirms — uninstall / clear / purge); `Esc`/`q`
+     * cancels = no.
+     */
+    confirm(question: string, cb: (yes: boolean) => void): void;
+    /** Pick one of `items`. `cb` gets the chosen index, or `-1` on cancel. */
+    pick(title: string, items: string[], cb: (index: number) => void): void;
+    /**
+     * Run a synchronous `fn` with stdout/stderr suppressed (discarded), then
+     * restored. For calling noisy library functions (loggers!) during a render
+     * without their output leaking onto — and corrupting — the blessed screen.
+     */
+    silently<T>(fn: () => T): T;
+    /** Bind scroll (↑/↓/PgUp/PgDn) + close (Esc/Enter/q) keys to a pane box. */
+    private bindPaneKeys;
+    /** Show `content` (must be blessed-tag-safe) in a scrollable modal pane. */
+    showPane(title: string, content: string): void;
+    /**
+     * Run `fn` in the FOREGROUND, blocking TUI interaction until it finishes:
+     * shows a "running" modal, captures everything `fn` writes to stdout/stderr,
+     * then shows the captured output (plus any string `fn` returns) in a
+     * scrollable pane. For install / uninstall / drain / import — operations the
+     * user wants to watch to completion. Resolves when the pane is closed.
+     */
+    runWithOutput(label: string, fn: () => Promise<string | void> | string | void): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/tui/shell/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,qBAAa,UAAU;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IACxC;6EACyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC;;4EAEwE;IACxE,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM;IAM9D,0EAA0E;IAC1E,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,+DAA+D;IAC/D,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC,oDAAoD;IACpD,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIrC,gBAAgB,IAAI,OAAO;IAI3B,oEAAoE;IACpE,gBAAgB,IAAI,MAAM,EAAE;IAM5B,WAAW,IAAI,OAAO;IAItB,0EAA0E;IAC1E,OAAO,CAAC,SAAS;IAsBjB,wDAAwD;IACxD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkB3B,uFAAuF;IACvF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAqB5E;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAoC3D,0EAA0E;IAC1E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IA6BvE;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAc3B,4EAA4E;IAC5E,OAAO,CAAC,YAAY;IASpB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqB9C;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CA2DhG"}