@knowzai/cli 0.1.0

package/dist/menu/frontends.js

@@ -0,0 +1,31 @@
+import { runMenu } from './run.js';
+export const DEFAULT_FRONTEND = 'menu';
+export const FRONTENDS = {
+    menu: {
+        id: 'menu',
+        label: 'Classic menu (inquirer)',
+        available: true,
+        run: runMenu,
+    },
+    tui: {
+        id: 'tui',
+        label: 'Full-screen TUI (Ink) — coming soon',
+        available: false,
+        // Not invoked while unavailable (resolveFrontend falls back); kept so the
+        // Ink implementation is a drop-in here later.
+        run: runMenu,
+    },
+};
+/**
+ * Resolve the frontend to run. Precedence: explicit `pref` (flag) →
+ * `KNOWZ_UI_FRONTEND` env → `configFrontend` (persisted `ui.frontend`) →
+ * default. Unknown or not-yet-available ids fall back to the menu.
+ */
+export function resolveFrontend(pref, env = process.env, configFrontend) {
+    const requested = (pref ?? env.KNOWZ_UI_FRONTEND ?? configFrontend ?? DEFAULT_FRONTEND).toLowerCase();
+    const chosen = FRONTENDS[requested];
+    if (chosen?.available)
+        return { frontend: chosen, fellBack: false, requested };
+    return { frontend: FRONTENDS[DEFAULT_FRONTEND], fellBack: requested !== DEFAULT_FRONTEND, requested };
+}
+//# sourceMappingURL=frontends.js.map

package/dist/menu/frontends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontends.js","sourceRoot":"","sources":["../../src/menu/frontends.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAUnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,MAAM,CAAC,MAAM,SAAS,GAA6B;IACjD,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,yBAAyB;QAChC,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,OAAO;KACb;IACD,GAAG,EAAE;QACH,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,qCAAqC;QAC5C,SAAS,EAAE,KAAK;QAChB,0EAA0E;QAC1E,8CAA8C;QAC9C,GAAG,EAAE,OAAO;KACb;CACF,CAAC;AAUF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAa,EACb,MAAyB,OAAO,CAAC,GAAG,EACpC,cAAuB;IAEvB,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,iBAAiB,IAAI,cAAc,IAAI,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC;IACtG,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,MAAM,EAAE,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC/E,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,gBAAgB,CAAE,EAAE,QAAQ,EAAE,SAAS,KAAK,gBAAgB,EAAE,SAAS,EAAE,CAAC;AACzG,CAAC"}

package/dist/menu/help.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pure help/hint text for the interactive menu. Kept free of chalk/IO so it's
+ * unit-testable; run.ts colorizes + prints it.
+ */
+/** Multi-line keybinding + power-move help shown by the "Help & keys" action. */
+export declare function helpLines(): string[];
+/** One-line footer hint under a normal screen header. */
+export declare function footerHint(): string;
+/** Footer hint for the main menu (adds the palette/help affordances). */
+export declare function mainFooterHint(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/menu/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/menu/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iFAAiF;AACjF,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAkBpC;AAED,yDAAyD;AACzD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/menu/help.js

@@ -0,0 +1,33 @@
+/**
+ * Pure help/hint text for the interactive menu. Kept free of chalk/IO so it's
+ * unit-testable; run.ts colorizes + prints it.
+ */
+/** Multi-line keybinding + power-move help shown by the "Help & keys" action. */
+export function helpLines() {
+    return [
+        'Navigation',
+        '  ↑ / ↓        move between items',
+        '  ⏎ Enter      select',
+        '  type…        filter the current list as you type (type-ahead)',
+        '  Ctrl-C       back one level (quits at the main menu)',
+        '',
+        'Power moves (from the main menu)',
+        '  ⌘ Jump to…   fuzzy-jump straight to ANY action, no drilling',
+        '  ❔ Help       show this screen',
+        '',
+        'Choosing the interface',
+        '  knowz                      open the interactive menu (default)',
+        '  knowz tui                  open the full-screen TUI (coming soon → menu)',
+        '  --frontend <menu|tui>      pick the UI for this run',
+        '  KNOWZ_UI_FRONTEND=tui      default to the TUI once it ships',
+    ];
+}
+/** One-line footer hint under a normal screen header. */
+export function footerHint() {
+    return '↑↓ move · ⏎ select · type to filter · Ctrl-C back';
+}
+/** Footer hint for the main menu (adds the palette/help affordances). */
+export function mainFooterHint() {
+    return '↑↓ move · ⏎ select · type to filter · ⌘ Jump & ❔ Help up top · Ctrl-C quit';
+}
+//# sourceMappingURL=help.js.map

package/dist/menu/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/menu/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iFAAiF;AACjF,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,YAAY;QACZ,mCAAmC;QACnC,uBAAuB;QACvB,iEAAiE;QACjE,wDAAwD;QACxD,EAAE;QACF,kCAAkC;QAClC,+DAA+D;QAC/D,iCAAiC;QACjC,EAAE;QACF,wBAAwB;QACxB,kEAAkE;QAClE,4EAA4E;QAC5E,uDAAuD;QACvD,+DAA+D;KAChE,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU;IACxB,OAAO,mDAAmD,CAAC;AAC7D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,cAAc;IAC5B,OAAO,4EAA4E,CAAC;AACtF,CAAC"}

package/dist/menu/palette.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Command palette: flattens the screen catalogue into a searchable list of
+ * actions so the user can fuzzy-jump to ANYTHING from the main menu instead of
+ * drilling through submenus. Pure + deterministic (no IO) so it's unit-testable;
+ * run.ts renders it via the injectable PromptApi `search` prompt.
+ */
+import type { Screen, Intent } from './types.js';
+export interface PaletteAction {
+    /** Breadcrumb path, e.g. "Knowledge › Add knowledge". */
+    path: string;
+    /** Leaf label without its leading icon. */
+    label: string;
+    /** Screen the action lives under. */
+    screenId: string;
+    intent: Intent;
+}
+/**
+ * Walk navigations from `rootId`, recording every command/custom leaf AND every
+ * navigate target (so "go to Vaults" is jumpable too) with a breadcrumb path.
+ * `exit`/`back` are not palette-able. Cycle-safe via a visited set.
+ */
+export declare function buildPaletteActions(screens: Record<string, Screen>, rootId?: string): PaletteAction[];
+/**
+ * Token-AND substring filter (case- and punctuation-insensitive) over the
+ * action path. An empty term returns everything (so the palette opens full).
+ */
+export declare function filterPaletteActions(actions: PaletteAction[], term: string): PaletteAction[];
+//# sourceMappingURL=palette.d.ts.map

package/dist/menu/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/menu/palette.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,SAAS,GACd,aAAa,EAAE,CAwBjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAQ5F"}

package/dist/menu/palette.js

@@ -0,0 +1,57 @@
+/** Drop a leading emoji/icon + spacing from a menu label. */
+function stripIcon(label) {
+    const cleaned = label.replace(/^[^\p{L}\p{N}]+/u, '').trim();
+    return cleaned.length > 0 ? cleaned : label.trim();
+}
+function normalize(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ' ')
+        .trim();
+}
+/**
+ * Walk navigations from `rootId`, recording every command/custom leaf AND every
+ * navigate target (so "go to Vaults" is jumpable too) with a breadcrumb path.
+ * `exit`/`back` are not palette-able. Cycle-safe via a visited set.
+ */
+export function buildPaletteActions(screens, rootId = 'main') {
+    const out = [];
+    const visited = new Set();
+    const walk = (id, trail) => {
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        const screen = screens[id];
+        if (!screen)
+            return;
+        for (const item of screen.items) {
+            const label = stripIcon(item.label);
+            const path = [...trail, label].join(' › ');
+            if (item.intent.kind === 'navigate') {
+                out.push({ path, label, screenId: id, intent: item.intent });
+                walk(item.intent.to, [...trail, label]);
+            }
+            else if (item.intent.kind === 'command' || item.intent.kind === 'custom') {
+                out.push({ path, label, screenId: id, intent: item.intent });
+            }
+            // 'exit' / 'back' intents are intentionally excluded.
+        }
+    };
+    walk(rootId, []);
+    return out;
+}
+/**
+ * Token-AND substring filter (case- and punctuation-insensitive) over the
+ * action path. An empty term returns everything (so the palette opens full).
+ */
+export function filterPaletteActions(actions, term) {
+    const q = normalize(term ?? '');
+    if (!q)
+        return actions;
+    const tokens = q.split(' ').filter(Boolean);
+    return actions.filter((a) => {
+        const hay = normalize(a.path);
+        return tokens.every((t) => hay.includes(t));
+    });
+}
+//# sourceMappingURL=palette.js.map

package/dist/menu/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/menu/palette.ts"],"names":[],"mappings":"AAkBA,6DAA6D;AAC7D,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA+B,EAC/B,MAAM,GAAG,MAAM;IAEf,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,KAAe,EAAQ,EAAE;QACjD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACpC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,sDAAsD;QACxD,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB,EAAE,IAAY;IACzE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IACvB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/menu/reducer.d.ts

@@ -0,0 +1,19 @@
+/** Pure navigation reducer: a screen-id stack with push/pop/exit semantics. */
+import type { Intent, Effect, NavState } from './types.js';
+export declare function initialState(): NavState;
+/** The current (top-of-stack) screen id. */
+export declare function current(state: NavState): string;
+/** Whether we're at the root menu (no screen to go "back" to). */
+export declare function atRoot(state: NavState): boolean;
+/**
+ * Apply an intent. `navigate` pushes; `back` pops (or quits at root); `exit`
+ * quits; `command`/`custom` leave the stack untouched and ask the shell to run
+ * the action, then re-render the same screen.
+ */
+export declare function reduce(state: NavState, intent: Intent): {
+    state: NavState;
+    effect: Effect;
+};
+/** Breadcrumb trail (screen titles) for the header. */
+export declare function breadcrumb(state: NavState, titles: Record<string, string>): string;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/menu/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../src/menu/reducer.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3D,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAE/C;AAED,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAc3F;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAElF"}

package/dist/menu/reducer.js

@@ -0,0 +1,37 @@
+export function initialState() {
+    return { stack: ['main'] };
+}
+/** The current (top-of-stack) screen id. */
+export function current(state) {
+    return state.stack[state.stack.length - 1] ?? 'main';
+}
+/** Whether we're at the root menu (no screen to go "back" to). */
+export function atRoot(state) {
+    return state.stack.length <= 1;
+}
+/**
+ * Apply an intent. `navigate` pushes; `back` pops (or quits at root); `exit`
+ * quits; `command`/`custom` leave the stack untouched and ask the shell to run
+ * the action, then re-render the same screen.
+ */
+export function reduce(state, intent) {
+    switch (intent.kind) {
+        case 'navigate':
+            return { state: { stack: [...state.stack, intent.to] }, effect: { kind: 'render' } };
+        case 'back':
+            if (atRoot(state))
+                return { state, effect: { kind: 'quit' } };
+            return { state: { stack: state.stack.slice(0, -1) }, effect: { kind: 'render' } };
+        case 'exit':
+            return { state, effect: { kind: 'quit' } };
+        case 'command':
+            return { state, effect: { kind: 'command', id: intent.id, prompts: intent.prompts } };
+        case 'custom':
+            return { state, effect: { kind: 'custom', handler: intent.handler } };
+    }
+}
+/** Breadcrumb trail (screen titles) for the header. */
+export function breadcrumb(state, titles) {
+    return state.stack.map((id) => titles[id] ?? id).join(' › ');
+}
+//# sourceMappingURL=reducer.js.map

package/dist/menu/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../src/menu/reducer.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7B,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,OAAO,CAAC,KAAe;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC;AACvD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,MAAM,CAAC,KAAe;IACpC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAe,EAAE,MAAc;IACpD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;QACvF,KAAK,MAAM;YACT,IAAI,MAAM,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;YAC9D,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;QACpF,KAAK,MAAM;YACT,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;QAC7C,KAAK,SAAS;YACZ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACxF,KAAK,QAAQ;YACX,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,UAAU,CAAC,KAAe,EAAE,MAA8B;IACxE,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/dist/menu/run.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Interactive menu IO shell. The ONLY module that imports @inquirer/prompts.
+ * Renders screens, collects inputs, and reuses every leaf command through
+ * `config.runCommand(id, argv)` — no API logic is duplicated here.
+ */
+import { select, input, editor, confirm, password, search } from '@inquirer/prompts';
+import type { Config } from '@oclif/core';
+import type { KnowzApiClient } from '@knowzai/api-client';
+import * as ui from '../lib/ui.js';
+/**
+ * The subset of @inquirer/prompts the menu uses. Injectable so the e2e suite can
+ * drive the menu with scripted answers while production uses the real prompts.
+ */
+export interface PromptApi {
+    select: typeof select;
+    input: typeof input;
+    editor: typeof editor;
+    confirm: typeof confirm;
+    password: typeof password;
+    search: typeof search;
+}
+export declare const realPrompts: PromptApi;
+export interface MenuRuntime {
+    config: Config;
+    version?: string;
+    identity: () => ui.Identity;
+    loadStats: () => Promise<Record<string, unknown> | undefined>;
+    /** Typed API client for the rich detail/comments flows (fetch without printing). */
+    client: KnowzApiClient;
+    /** Prompt implementation; defaults to the real inquirer prompts. */
+    prompts?: PromptApi;
+}
+export declare function runMenu(rt: MenuRuntime): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/menu/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/menu/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,cAAc,CAAC;AASnC;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,EAAE,OAAO,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,EAAE,SAAgE,CAAC;AAE3F,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC;IAC5B,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;IAC9D,oFAAoF;IACpF,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAWD,wBAAsB,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE5D"}