@nexus-cortex/core 4.26.0

package/dist/ui/menu-types.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Shared Interactive Menu Types for Nexus Cortex
+ *
+ * These types define a UI-agnostic menu structure that can be rendered
+ * by different CLI implementations:
+ * - fuzzycortex (chalk-based terminal UI)
+ * - neoncortex (Ink-based React terminal UI)
+ * - cortexserver (HTTP API for web/mobile clients)
+ *
+ * The menu system supports:
+ * - Multiple item types (toggle, select, number, text, action, info)
+ * - Sectioned layouts with collapsible groups
+ * - Hybrid save behavior (live updates for toggles, explicit save for text/numbers)
+ * - Validation with error messages
+ * - Keyboard shortcuts for actions
+ *
+ * @module ui/menu-types
+ */
+/**
+ * Available menu item types
+ */
+export type MenuItemType = 'toggle' | 'select' | 'number' | 'text' | 'action' | 'info';
+/**
+ * Base properties shared by all menu items
+ */
+export interface BaseMenuItem {
+    /** Unique key for this item (maps to config key) */
+    key: string;
+    /** Display label shown to user */
+    label: string;
+    /** Optional description/help text */
+    description?: string;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /** Whether changes should apply immediately (default: true for toggles/selects, false for text/numbers) */
+    liveUpdate?: boolean;
+}
+/**
+ * Toggle item - boolean on/off switch
+ */
+export interface ToggleMenuItem extends BaseMenuItem {
+    type: 'toggle';
+    value: boolean;
+}
+/**
+ * Select item - dropdown/list selection from predefined choices
+ */
+export interface SelectMenuItem extends BaseMenuItem {
+    type: 'select';
+    value: string;
+    choices: SelectChoice[];
+}
+/**
+ * A choice option for select menus
+ */
+export interface SelectChoice {
+    /** Display label */
+    label: string;
+    /** Value to store */
+    value: string;
+    /** Optional description for this choice */
+    description?: string;
+}
+/**
+ * Number item - numeric input with optional range constraints
+ */
+export interface NumberMenuItem extends BaseMenuItem {
+    type: 'number';
+    value: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/**
+ * Text item - string input field
+ */
+export interface TextMenuItem extends BaseMenuItem {
+    type: 'text';
+    value: string;
+    placeholder?: string;
+    /** Whether to mask input (for passwords/secrets) */
+    secret?: boolean;
+    /** Multi-line text input */
+    multiline?: boolean;
+}
+/**
+ * Action item - clickable button that triggers a handler
+ */
+export interface ActionMenuItem extends BaseMenuItem {
+    type: 'action';
+    /** Label for the action button */
+    actionLabel: string;
+    /** Whether this is a destructive action (shows warning) */
+    destructive?: boolean;
+}
+/**
+ * Info item - read-only display of information
+ */
+export interface InfoMenuItem extends BaseMenuItem {
+    type: 'info';
+    value: string;
+    /** Optional icon/emoji */
+    icon?: string;
+}
+/**
+ * Union type of all menu item types
+ */
+export type MenuItem = ToggleMenuItem | SelectMenuItem | NumberMenuItem | TextMenuItem | ActionMenuItem | InfoMenuItem;
+/**
+ * A section groups related menu items together
+ */
+export interface MenuSection {
+    /** Unique identifier for this section */
+    id: string;
+    /** Section title */
+    title: string;
+    /** Optional section description */
+    description?: string;
+    /** Items in this section */
+    items: MenuItem[];
+    /** Whether section starts collapsed */
+    collapsed?: boolean;
+    /** Icon/emoji for section header */
+    icon?: string;
+}
+/**
+ * A menu action (Save, Cancel, Reset, etc.)
+ */
+export interface MenuAction {
+    /** Unique identifier */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Keyboard shortcut hint (e.g., 'Enter', 'Esc', 'r') */
+    shortcut?: string;
+    /** Whether this is the primary/default action */
+    primary?: boolean;
+    /** Whether this is a destructive action */
+    destructive?: boolean;
+}
+/**
+ * Complete interactive menu definition
+ */
+export interface InteractiveMenuDefinition {
+    /** Unique identifier for this menu */
+    id: string;
+    /** Menu title */
+    title: string;
+    /** Optional menu description */
+    description?: string;
+    /** Icon/emoji for menu header */
+    icon?: string;
+    /** Menu sections */
+    sections: MenuSection[];
+    /** Available actions (Save, Cancel, etc.) */
+    actions: MenuAction[];
+    /** Footer text (keyboard hints, etc.) */
+    footer?: string;
+}
+/**
+ * Result from menu interaction
+ */
+export interface MenuResult {
+    /** Action taken (save, cancel, reset, or custom action id) */
+    action: 'save' | 'cancel' | 'reset' | string;
+    /** Changed values (key -> new value) */
+    changes: Record<string, unknown>;
+    /** Whether any values were changed */
+    hasChanges: boolean;
+}
+/**
+ * Validation result for a single menu value
+ */
+export interface MenuValidationResult {
+    /** Whether value is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Generic configuration service interface
+ * Implementations provide config read/write and menu generation
+ *
+ * @template T - The configuration type this service manages
+ */
+export interface ConfigService<T extends Record<string, unknown>> {
+    /**
+     * Get current configuration
+     */
+    getConfig(): T;
+    /**
+     * Update configuration (partial update)
+     * @param config - Partial config to merge
+     */
+    setConfig(config: Partial<T>): Promise<void>;
+    /**
+     * Get a single config value
+     * @param key - Config key
+     */
+    getValue<K extends keyof T>(key: K): T[K];
+    /**
+     * Set a single config value
+     * @param key - Config key
+     * @param value - New value
+     */
+    setValue<K extends keyof T>(key: K, value: T[K]): Promise<void>;
+    /**
+     * Get menu definition for this config
+     */
+    getMenuDefinition(): InteractiveMenuDefinition;
+    /**
+     * Validate a value for a given key
+     * @param key - Config key
+     * @param value - Value to validate
+     */
+    validateValue(key: string, value: unknown): MenuValidationResult;
+    /**
+     * Get default configuration
+     */
+    getDefaultConfig(): T;
+    /**
+     * Reset configuration to defaults
+     */
+    resetToDefaults(): Promise<void>;
+    /**
+     * Reload configuration from source (e.g., .env file)
+     */
+    reload(): void;
+}
+/**
+ * Event emitted when a menu item value changes
+ */
+export interface MenuItemChangeEvent {
+    /** Item key */
+    key: string;
+    /** Previous value */
+    previousValue: unknown;
+    /** New value */
+    newValue: unknown;
+    /** Whether this was a live update (vs pending save) */
+    isLiveUpdate: boolean;
+}
+/**
+ * Event emitted when menu navigation changes
+ */
+export interface MenuNavigationEvent {
+    /** Currently focused section */
+    sectionId: string;
+    /** Currently focused item key */
+    itemKey: string;
+    /** Navigation direction */
+    direction: 'up' | 'down' | 'enter' | 'escape' | 'tab';
+}
+/**
+ * Interface for menu renderers (implemented by CLI UIs)
+ */
+export interface MenuRenderer {
+    /**
+     * Render the menu and return the result
+     * @param definition - Menu definition to render
+     * @param initialValues - Initial values for menu items
+     * @param onLiveUpdate - Callback for live updates (toggles/selects)
+     */
+    render(definition: InteractiveMenuDefinition, initialValues: Record<string, unknown>, onLiveUpdate?: (key: string, value: unknown) => Promise<void>): Promise<MenuResult>;
+}
+/**
+ * Type guard for ToggleMenuItem
+ */
+export declare function isToggleItem(item: MenuItem): item is ToggleMenuItem;
+/**
+ * Type guard for SelectMenuItem
+ */
+export declare function isSelectItem(item: MenuItem): item is SelectMenuItem;
+/**
+ * Type guard for NumberMenuItem
+ */
+export declare function isNumberItem(item: MenuItem): item is NumberMenuItem;
+/**
+ * Type guard for TextMenuItem
+ */
+export declare function isTextItem(item: MenuItem): item is TextMenuItem;
+/**
+ * Type guard for ActionMenuItem
+ */
+export declare function isActionItem(item: MenuItem): item is ActionMenuItem;
+/**
+ * Type guard for InfoMenuItem
+ */
+export declare function isInfoItem(item: MenuItem): item is InfoMenuItem;
+/**
+ * Get all items from a menu definition (flattened)
+ */
+export declare function getAllMenuItems(definition: InteractiveMenuDefinition): MenuItem[];
+/**
+ * Find a menu item by key
+ */
+export declare function findMenuItem(definition: InteractiveMenuDefinition, key: string): MenuItem | undefined;
+/**
+ * Get section containing an item
+ */
+export declare function findItemSection(definition: InteractiveMenuDefinition, key: string): MenuSection | undefined;
+/**
+ * Check if an item should live-update by default based on its type
+ */
+export declare function shouldLiveUpdate(item: MenuItem): boolean;
+/**
+ * Create a standard set of menu actions (Save, Cancel, Reset)
+ */
+export declare function createStandardActions(options?: {
+    includeSave?: boolean;
+    includeCancel?: boolean;
+    includeReset?: boolean;
+}): MenuAction[];
+//# sourceMappingURL=menu-types.d.ts.map

package/dist/ui/menu-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-types.d.ts","sourceRoot":"","sources":["../../src/ui/menu-types.ts"],"names":[],"mappings":"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"}

package/dist/ui/menu-types.js

@@ -0,0 +1,138 @@
+/**
+ * Shared Interactive Menu Types for Nexus Cortex
+ *
+ * These types define a UI-agnostic menu structure that can be rendered
+ * by different CLI implementations:
+ * - fuzzycortex (chalk-based terminal UI)
+ * - neoncortex (Ink-based React terminal UI)
+ * - cortexserver (HTTP API for web/mobile clients)
+ *
+ * The menu system supports:
+ * - Multiple item types (toggle, select, number, text, action, info)
+ * - Sectioned layouts with collapsible groups
+ * - Hybrid save behavior (live updates for toggles, explicit save for text/numbers)
+ * - Validation with error messages
+ * - Keyboard shortcuts for actions
+ *
+ * @module ui/menu-types
+ */
+// ============================================
+// Type Guards
+// ============================================
+/**
+ * Type guard for ToggleMenuItem
+ */
+export function isToggleItem(item) {
+    return item.type === 'toggle';
+}
+/**
+ * Type guard for SelectMenuItem
+ */
+export function isSelectItem(item) {
+    return item.type === 'select';
+}
+/**
+ * Type guard for NumberMenuItem
+ */
+export function isNumberItem(item) {
+    return item.type === 'number';
+}
+/**
+ * Type guard for TextMenuItem
+ */
+export function isTextItem(item) {
+    return item.type === 'text';
+}
+/**
+ * Type guard for ActionMenuItem
+ */
+export function isActionItem(item) {
+    return item.type === 'action';
+}
+/**
+ * Type guard for InfoMenuItem
+ */
+export function isInfoItem(item) {
+    return item.type === 'info';
+}
+// ============================================
+// Utility Functions
+// ============================================
+/**
+ * Get all items from a menu definition (flattened)
+ */
+export function getAllMenuItems(definition) {
+    return definition.sections.flatMap(section => section.items);
+}
+/**
+ * Find a menu item by key
+ */
+export function findMenuItem(definition, key) {
+    for (const section of definition.sections) {
+        const item = section.items.find(i => i.key === key);
+        if (item)
+            return item;
+    }
+    return undefined;
+}
+/**
+ * Get section containing an item
+ */
+export function findItemSection(definition, key) {
+    return definition.sections.find(section => section.items.some(item => item.key === key));
+}
+/**
+ * Check if an item should live-update by default based on its type
+ */
+export function shouldLiveUpdate(item) {
+    // Explicit setting takes precedence
+    if (item.liveUpdate !== undefined) {
+        return item.liveUpdate;
+    }
+    // Default: toggles and selects update live, others require save
+    switch (item.type) {
+        case 'toggle':
+        case 'select':
+            return true;
+        case 'number':
+        case 'text':
+            return false;
+        case 'action':
+        case 'info':
+            return false;
+        default:
+            return false;
+    }
+}
+/**
+ * Create a standard set of menu actions (Save, Cancel, Reset)
+ */
+export function createStandardActions(options) {
+    const { includeSave = true, includeCancel = true, includeReset = true } = options || {};
+    const actions = [];
+    if (includeSave) {
+        actions.push({
+            id: 'save',
+            label: 'Save',
+            shortcut: 's',
+            primary: true
+        });
+    }
+    if (includeCancel) {
+        actions.push({
+            id: 'cancel',
+            label: 'Cancel',
+            shortcut: 'Esc'
+        });
+    }
+    if (includeReset) {
+        actions.push({
+            id: 'reset',
+            label: 'Reset to Defaults',
+            shortcut: 'r',
+            destructive: true
+        });
+    }
+    return actions;
+}
+//# sourceMappingURL=menu-types.js.map

package/dist/ui/menu-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-types.js","sourceRoot":"","sources":["../../src/ui/menu-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiVH,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC;AAED,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAqC;IACnE,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAqC,EAAE,GAAW;IAC7E,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QACpD,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAqC,EAAE,GAAW;IAChF,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CACxC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,oCAAoC;IACpC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,gEAAgE;IAChE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,KAAK,CAAC;QACf;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAIrC;IACC,MAAM,EACJ,WAAW,GAAG,IAAI,EAClB,aAAa,GAAG,IAAI,EACpB,YAAY,GAAG,IAAI,EACpB,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,GAAG;YACb,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,mBAAmB;YAC1B,QAAQ,EAAE,GAAG;YACb,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/ui/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Shared UI Types for Nexus Cortex
+ *
+ * These types are shared between different CLI implementations:
+ * - fuzzycortex (chalk-based terminal UI)
+ * - neoncortex (Ink-based React terminal UI)
+ * - cortexserver (HTTP API for web/mobile clients)
+ *
+ * @module ui/types
+ */
+/**
+ * Model display information for UI components
+ * Used by model picker dialogs in both chalk and Ink implementations
+ */
+export interface ModelDisplayInfo {
+    /** Unique model identifier (e.g., "gpt-4", "claude-3-opus") */
+    id: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Provider name (e.g., "OpenAI", "Anthropic", "Google") */
+    provider: string;
+    /** Context window size in tokens */
+    contextWindow?: number;
+    /** Input cost per million tokens */
+    inputCost?: number;
+    /** Output cost per million tokens */
+    outputCost?: number;
+    /** Whether the model supports reasoning/thinking mode */
+    supportsReasoning?: boolean;
+    /** Whether the model supports vision/image input */
+    supportsVision?: boolean;
+    /** Whether the model supports streaming responses */
+    supportsStreaming?: boolean;
+    /** Maximum output tokens */
+    maxOutput?: number;
+    /** Model description */
+    description?: string;
+}
+/**
+ * Result from a model picker interaction
+ */
+export interface ModelPickerResult {
+    /** Whether a model was selected (false if cancelled) */
+    selected: boolean;
+    /** The selected model ID (undefined if cancelled) */
+    modelId?: string;
+}
+/**
+ * Session display information for UI components
+ * Used by session picker dialogs
+ */
+export interface SessionDisplayInfo {
+    /** Session ID */
+    id: string;
+    /** Session display name or title */
+    name: string;
+    /** Number of messages in the session */
+    messageCount: number;
+    /** Session creation timestamp */
+    createdAt: Date;
+    /** Session last updated timestamp */
+    updatedAt: Date;
+    /** Total token count */
+    tokenCount?: number;
+    /** Current model used in session */
+    currentModel?: string;
+}
+/**
+ * Result from a session picker interaction
+ */
+export interface SessionPickerResult {
+    /** Whether a session was selected (false if cancelled) */
+    selected: boolean;
+    /** The selected session ID (undefined if cancelled) */
+    sessionId?: string;
+}
+/**
+ * Theme picker result
+ */
+export interface ThemePickerResult {
+    /** Whether a theme was selected */
+    selected: boolean;
+    /** The selected theme name */
+    theme?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ui/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IAEX,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;IAElB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAEhB,qCAAqC;IACrC,SAAS,EAAE,IAAI,CAAC;IAEhB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAElB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAElB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/ui/types.js

@@ -0,0 +1,12 @@
+/**
+ * Shared UI Types for Nexus Cortex
+ *
+ * These types are shared between different CLI implementations:
+ * - fuzzycortex (chalk-based terminal UI)
+ * - neoncortex (Ink-based React terminal UI)
+ * - cortexserver (HTTP API for web/mobile clients)
+ *
+ * @module ui/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ui/types.js.map

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