@tecet/ollm 0.1.3

package/dist/ui/hooks/useMouse.js

@@ -0,0 +1,115 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, createContext, useContext, useCallback } from 'react';
+import { useStdin } from 'ink';
+import { createLogger } from '../../../../core/src/utils/logger.js';
+import { enableMouseEvents, disableMouseEvents } from '../../utils/terminal.js';
+const logger = createLogger('useMouse');
+const MouseContext = createContext(null);
+export function MouseProvider({ children }) {
+    const { stdin, isRawModeSupported, setRawMode } = useStdin();
+    const isEnabled = useRef(false);
+    const listenersRef = useRef(new Set());
+    // Subscribe mechanism
+    const subscribe = useCallback((handler) => {
+        listenersRef.current.add(handler);
+        return () => {
+            listenersRef.current.delete(handler);
+        };
+    }, []);
+    useEffect(() => {
+        if (isRawModeSupported) {
+            setRawMode(true);
+            enableMouseEvents();
+            isEnabled.current = true;
+        }
+        return () => {
+            if (isEnabled.current) {
+                disableMouseEvents();
+                isEnabled.current = false;
+            }
+        };
+    }, [isRawModeSupported, setRawMode]);
+    useEffect(() => {
+        if (!stdin)
+            return;
+        const handleData = (data) => {
+            const input = data.toString();
+            // Check for SGR mouse sequence: \\x1b[<button;x;yM (or m)
+            const mouseRegex = /\\x1b\[<(\d+);(\d+);(\d+)([Mm])/;
+            const match = input.match(mouseRegex);
+            if (match) {
+                const rawButton = parseInt(match[1], 10);
+                const x = parseInt(match[2], 10);
+                const y = parseInt(match[3], 10);
+                const type = match[4]; // M = down/scroll, m = up
+                let action = 'move';
+                let button = 'none';
+                // Decode button/action
+                let mod = rawButton;
+                const scroll = (mod & 64) === 64;
+                mod &= ~64;
+                const _drag = (mod & 32) === 32;
+                mod &= ~32;
+                const ctrl = (mod & 16) === 16;
+                mod &= ~16;
+                const alt = (mod & 8) === 8;
+                mod &= ~8;
+                const shift = (mod & 4) === 4;
+                mod &= ~4;
+                const btnCode = mod;
+                if (scroll) {
+                    action = btnCode === 0 ? 'scroll-up' : 'scroll-down';
+                    button = 'none';
+                }
+                else {
+                    if (type === 'M') {
+                        action = 'down';
+                    }
+                    else {
+                        action = 'up';
+                    }
+                    if (btnCode === 0)
+                        button = 'left';
+                    else if (btnCode === 1)
+                        button = 'middle';
+                    else if (btnCode === 2)
+                        button = 'right';
+                }
+                const event = {
+                    x,
+                    y,
+                    action,
+                    button,
+                    shift,
+                    alt,
+                    ctrl,
+                };
+                // Notify listeners
+                listenersRef.current.forEach((listener) => listener(event));
+            }
+        };
+        stdin.on('data', handleData);
+        return () => {
+            // Use removeListener instead of off for better compatibility
+            stdin.removeListener('data', handleData);
+        };
+    }, [stdin]);
+    return _jsx(MouseContext.Provider, { value: { subscribe }, children: children });
+}
+export function useMouse(onMouse) {
+    const context = useContext(MouseContext);
+    useEffect(() => {
+        if (!context)
+            return;
+        return context.subscribe(onMouse);
+    }, [context, onMouse]);
+    // Fallback if used outside provider (mostly for testing or isolated components)
+    // We can't easily hook into stdin here without duplicating the provider logic.
+    // So we just warn or do nothing.
+    useEffect(() => {
+        if (!context) {
+            logger.warn('useMouse used outside MouseProvider - mouse events will not work');
+        }
+    }, [context]);
+}
+//# sourceMappingURL=useMouse.js.map

package/dist/ui/hooks/useMouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMouse.js","sourceRoot":"","sources":["../../../src/ui/hooks/useMouse.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAa,MAAM,OAAO,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;AAqBxC,MAAM,YAAY,GAAG,aAAa,CAA0B,IAAI,CAAC,CAAC;AAMlE,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAsB;IAC5D,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,YAAY,GAAG,MAAM,CAAoB,IAAI,GAAG,EAAE,CAAC,CAAC;IAE1D,sBAAsB;IACtB,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,OAAqB,EAAE,EAAE;QACtD,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,kBAAkB,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,iBAAiB,EAAE,CAAC;YACpB,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,kBAAkB,EAAE,CAAC;gBACrB,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAE9B,0DAA0D;YAC1D,MAAM,UAAU,GAAG,iCAAiC,CAAC;YACrD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAEtC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B;gBAEjD,IAAI,MAAM,GAAgB,MAAM,CAAC;gBACjC,IAAI,MAAM,GAAgB,MAAM,CAAC;gBAEjC,uBAAuB;gBACvB,IAAI,GAAG,GAAG,SAAS,CAAC;gBACpB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;gBACjC,GAAG,IAAI,CAAC,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;gBAChC,GAAG,IAAI,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;gBAC/B,GAAG,IAAI,CAAC,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC5B,GAAG,IAAI,CAAC,CAAC,CAAC;gBACV,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC9B,GAAG,IAAI,CAAC,CAAC,CAAC;gBAEV,MAAM,OAAO,GAAG,GAAG,CAAC;gBAEpB,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;oBACrD,MAAM,GAAG,MAAM,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;wBACjB,MAAM,GAAG,MAAM,CAAC;oBAClB,CAAC;yBAAM,CAAC;wBACN,MAAM,GAAG,IAAI,CAAC;oBAChB,CAAC;oBAED,IAAI,OAAO,KAAK,CAAC;wBAAE,MAAM,GAAG,MAAM,CAAC;yBAC9B,IAAI,OAAO,KAAK,CAAC;wBAAE,MAAM,GAAG,QAAQ,CAAC;yBACrC,IAAI,OAAO,KAAK,CAAC;wBAAE,MAAM,GAAG,OAAO,CAAC;gBAC3C,CAAC;gBAED,MAAM,KAAK,GAAe;oBACxB,CAAC;oBACD,CAAC;oBACD,MAAM;oBACN,MAAM;oBACN,KAAK;oBACL,GAAG;oBACH,IAAI;iBACL,CAAC;gBAEF,mBAAmB;gBACnB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,6DAA6D;YAC7D,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,SAAS,EAAE,YAAG,QAAQ,GAAyB,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAoC;IAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEvB,gFAAgF;IAChF,+EAA+E;IAC/E,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAChB,CAAC"}

package/dist/ui/hooks/useNotifications.d.ts

@@ -0,0 +1,43 @@
+/**
+ * useNotifications Hook
+ *
+ * Hook for managing notifications in the MCP panel.
+ * Provides methods to show success, error, warning, and info notifications.
+ *
+ * Features:
+ * - Add notifications with auto-generated IDs
+ * - Remove notifications manually or automatically
+ * - Queue multiple notifications
+ * - Prevent duplicate notifications
+ *
+ * Validates: NFR-7
+ */
+import type { NotificationType } from '../components/mcp/Notification.js';
+export interface Notification {
+    id: string;
+    type: NotificationType;
+    message: string;
+    description?: string;
+    timeout?: number;
+    showDismiss?: boolean;
+}
+/**
+ * useNotifications Hook
+ *
+ * Manages a queue of notifications with add/remove functionality.
+ */
+export declare function useNotifications(): {
+    notifications: Notification[];
+    addNotification: (type: NotificationType, message: string, options?: {
+        description?: string;
+        timeout?: number;
+        showDismiss?: boolean;
+    }) => string;
+    removeNotification: (id: string) => void;
+    clearNotifications: () => void;
+    showSuccess: (message: string, description?: string) => string;
+    showError: (message: string, description?: string) => string;
+    showWarning: (message: string, description?: string) => string;
+    showInfo: (message: string, description?: string) => string;
+};
+//# sourceMappingURL=useNotifications.d.ts.map

package/dist/ui/hooks/useNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotifications.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useNotifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AASD;;;;GAIG;AACH,wBAAgB,gBAAgB;;4BAQpB,gBAAgB,WACb,MAAM,YACL;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB;6BAsBuC,MAAM;;2BAetC,MAAM,gBAAgB,MAAM;yBAU5B,MAAM,gBAAgB,MAAM;2BAU5B,MAAM,gBAAgB,MAAM;wBAU5B,MAAM,gBAAgB,MAAM;EAgBzC"}

package/dist/ui/hooks/useNotifications.js

@@ -0,0 +1,92 @@
+/**
+ * useNotifications Hook
+ *
+ * Hook for managing notifications in the MCP panel.
+ * Provides methods to show success, error, warning, and info notifications.
+ *
+ * Features:
+ * - Add notifications with auto-generated IDs
+ * - Remove notifications manually or automatically
+ * - Queue multiple notifications
+ * - Prevent duplicate notifications
+ *
+ * Validates: NFR-7
+ */
+import { useState, useCallback } from 'react';
+/**
+ * Generate unique notification ID
+ */
+function generateNotificationId() {
+    return `notification-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * useNotifications Hook
+ *
+ * Manages a queue of notifications with add/remove functionality.
+ */
+export function useNotifications() {
+    const [notifications, setNotifications] = useState([]);
+    /**
+     * Add a notification to the queue
+     */
+    const addNotification = useCallback((type, message, options) => {
+        const id = generateNotificationId();
+        const notification = {
+            id,
+            type,
+            message,
+            description: options?.description,
+            timeout: options?.timeout ?? 3000,
+            showDismiss: options?.showDismiss ?? true,
+        };
+        setNotifications((prev) => [...prev, notification]);
+        return id;
+    }, []);
+    /**
+     * Remove a notification by ID
+     */
+    const removeNotification = useCallback((id) => {
+        setNotifications((prev) => prev.filter((n) => n.id !== id));
+    }, []);
+    /**
+     * Clear all notifications
+     */
+    const clearNotifications = useCallback(() => {
+        setNotifications([]);
+    }, []);
+    /**
+     * Show success notification
+     */
+    const showSuccess = useCallback((message, description) => {
+        return addNotification('success', message, { description, timeout: 3000 });
+    }, [addNotification]);
+    /**
+     * Show error notification
+     */
+    const showError = useCallback((message, description) => {
+        return addNotification('error', message, { description, timeout: 5000 });
+    }, [addNotification]);
+    /**
+     * Show warning notification
+     */
+    const showWarning = useCallback((message, description) => {
+        return addNotification('warning', message, { description, timeout: 4000 });
+    }, [addNotification]);
+    /**
+     * Show info notification
+     */
+    const showInfo = useCallback((message, description) => {
+        return addNotification('info', message, { description, timeout: 3000 });
+    }, [addNotification]);
+    return {
+        notifications,
+        addNotification,
+        removeNotification,
+        clearNotifications,
+        showSuccess,
+        showError,
+        showWarning,
+        showInfo,
+    };
+}
+//# sourceMappingURL=useNotifications.js.map

package/dist/ui/hooks/useNotifications.js.map

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

package/dist/ui/hooks/useTabEscapeHandler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tab Escape Handler Hook
+ *
+ * Provides consistent ESC key handling for tab components.
+ * This hook allows ESC to bubble to the global handler (FocusContext.exitOneLevel)
+ * for hierarchical navigation.
+ *
+ * Architecture:
+ * - Integrates with FocusContext for hierarchical navigation
+ * - Only active when the component has focus
+ * - Allows ESC to bubble naturally for consistent behavior
+ *
+ * Usage Pattern:
+ * - Use this hook in tab components (ToolsPanel, DocsPanel, SettingsPanel, etc.)
+ * - The hook will automatically handle ESC navigation
+ * - No need to implement custom exit logic
+ *
+ * @example
+ * ```typescript
+ * function MyTabComponent({ hasFocus }: { hasFocus: boolean }) {
+ *   useTabEscapeHandler(hasFocus);
+ *
+ *   // Rest of component logic
+ *   return <Box>...</Box>;
+ * }
+ * ```
+ */
+/**
+ * Hook that handles ESC key for tab components
+ *
+ * This hook provides consistent ESC behavior across all tab components.
+ * When ESC is pressed, it calls exitOneLevel() which implements the
+ * hierarchical navigation pattern:
+ *
+ * - Level 3 (Modals) → Level 2 (Tab Content)
+ * - Level 2 (Tab Content) → Level 1 (Nav Bar)
+ * - Level 1 (Nav Bar) → Chat Tab or User Input
+ *
+ * @param hasFocus - Whether the component currently has focus
+ */
+export declare function useTabEscapeHandler(hasFocus: boolean): void;
+//# sourceMappingURL=useTabEscapeHandler.d.ts.map

package/dist/ui/hooks/useTabEscapeHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabEscapeHandler.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTabEscapeHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,QAiBpD"}

package/dist/ui/hooks/useTabEscapeHandler.js

@@ -0,0 +1,56 @@
+/**
+ * Tab Escape Handler Hook
+ *
+ * Provides consistent ESC key handling for tab components.
+ * This hook allows ESC to bubble to the global handler (FocusContext.exitOneLevel)
+ * for hierarchical navigation.
+ *
+ * Architecture:
+ * - Integrates with FocusContext for hierarchical navigation
+ * - Only active when the component has focus
+ * - Allows ESC to bubble naturally for consistent behavior
+ *
+ * Usage Pattern:
+ * - Use this hook in tab components (ToolsPanel, DocsPanel, SettingsPanel, etc.)
+ * - The hook will automatically handle ESC navigation
+ * - No need to implement custom exit logic
+ *
+ * @example
+ * ```typescript
+ * function MyTabComponent({ hasFocus }: { hasFocus: boolean }) {
+ *   useTabEscapeHandler(hasFocus);
+ *
+ *   // Rest of component logic
+ *   return <Box>...</Box>;
+ * }
+ * ```
+ */
+import { useInput } from 'ink';
+import { useFocusManager } from '../../features/context/FocusContext.js';
+/**
+ * Hook that handles ESC key for tab components
+ *
+ * This hook provides consistent ESC behavior across all tab components.
+ * When ESC is pressed, it calls exitOneLevel() which implements the
+ * hierarchical navigation pattern:
+ *
+ * - Level 3 (Modals) → Level 2 (Tab Content)
+ * - Level 2 (Tab Content) → Level 1 (Nav Bar)
+ * - Level 1 (Nav Bar) → Chat Tab or User Input
+ *
+ * @param hasFocus - Whether the component currently has focus
+ */
+export function useTabEscapeHandler(hasFocus) {
+    const focusManager = useFocusManager();
+    useInput((input, key) => {
+        // Handle ESC key for hierarchical navigation
+        if (key.escape) {
+            focusManager.exitOneLevel();
+        }
+        // Handle '0' as alternative exit key (legacy pattern)
+        if (input === '0') {
+            focusManager.exitOneLevel();
+        }
+    }, { isActive: hasFocus });
+}
+//# sourceMappingURL=useTabEscapeHandler.js.map

package/dist/ui/hooks/useTabEscapeHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabEscapeHandler.js","sourceRoot":"","sources":["../../../src/ui/hooks/useTabEscapeHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAiB;IACnD,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IAEvC,QAAQ,CACN,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACb,6CAA6C;QAC7C,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,YAAY,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;QAED,sDAAsD;QACtD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,YAAY,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC,EACD,EAAE,QAAQ,EAAE,QAAQ,EAAE,CACvB,CAAC;AACJ,CAAC"}

package/dist/ui/hooks/useTerminal.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Terminal Hook Proxy
+ *
+ * Re-exports terminal hook from TerminalContext
+ */
+export { useTerminal } from '../contexts/TerminalContext.js';
+//# sourceMappingURL=useTerminal.d.ts.map

package/dist/ui/hooks/useTerminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminal.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/ui/hooks/useTerminal.js

@@ -0,0 +1,7 @@
+/**
+ * Terminal Hook Proxy
+ *
+ * Re-exports terminal hook from TerminalContext
+ */
+export { useTerminal } from '../contexts/TerminalContext.js';
+//# sourceMappingURL=useTerminal.js.map

package/dist/ui/hooks/useTerminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminal.js","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/ui/hooks/useTerminal2.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Terminal2 Hook Proxy
+ *
+ * Re-exports terminal 2 hook from Terminal2Context.
+ */
+export { useTerminal2 } from '../contexts/Terminal2Context.js';
+//# sourceMappingURL=useTerminal2.d.ts.map

package/dist/ui/hooks/useTerminal2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminal2.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminal2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/ui/hooks/useTerminal2.js

@@ -0,0 +1,7 @@
+/**
+ * Terminal2 Hook Proxy
+ *
+ * Re-exports terminal 2 hook from Terminal2Context.
+ */
+export { useTerminal2 } from '../contexts/Terminal2Context.js';
+//# sourceMappingURL=useTerminal2.js.map

package/dist/ui/hooks/useTerminal2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminal2.js","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminal2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/ui/services/docsService.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Documentation entry
+ */
+export interface DocEntry {
+    title: string;
+    path: string;
+    description?: string;
+    children?: DocEntry[];
+}
+/**
+ * DocsService
+ *
+ * Service for loading and managing documentation files.
+ * Provides markdown rendering and navigation support.
+ */
+export declare class DocsService {
+    private docsRoot;
+    private cache;
+    constructor(docsRoot?: string);
+    /**
+     * Get the documentation index
+     */
+    getIndex(): DocEntry[];
+    /**
+     * Load a documentation file
+     */
+    loadDoc(path: string): Promise<string>;
+    /**
+     * Render markdown to plain text (simplified)
+     *
+     * In a real implementation, this would use a proper markdown parser.
+     * For now, we just strip some basic markdown syntax.
+     */
+    renderMarkdown(content: string): string;
+    /**
+     * Resolve a link from one document to another
+     */
+    resolveLink(from: string, to: string): string;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=docsService.d.ts.map

package/dist/ui/services/docsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsService.d.ts","sourceRoot":"","sources":["../../../src/ui/services/docsService.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAkC;gBAEnC,QAAQ,GAAE,MAAe;IAIrC;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAgCtB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe5C;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAiBvC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAW7C;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/ui/services/docsService.js

@@ -0,0 +1,103 @@
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+/**
+ * DocsService
+ *
+ * Service for loading and managing documentation files.
+ * Provides markdown rendering and navigation support.
+ */
+export class DocsService {
+    docsRoot;
+    cache = new Map();
+    constructor(docsRoot = 'docs') {
+        this.docsRoot = docsRoot;
+    }
+    /**
+     * Get the documentation index
+     */
+    getIndex() {
+        return [
+            { title: 'Getting Started', path: 'docs/README.md', description: 'Introduction to OLLM CLI' },
+            {
+                title: 'Architecture',
+                path: 'docs/architecture.md',
+                description: 'System architecture overview',
+            },
+            { title: 'Commands', path: 'docs/commands.md', description: 'Available CLI commands' },
+            {
+                title: 'Provider Systems',
+                path: 'docs/provider-systems.md',
+                description: 'Provider integration guide',
+            },
+            {
+                title: 'Context Management',
+                path: 'docs/context-management-plan.md',
+                description: 'Context and memory management',
+            },
+            {
+                title: 'UI Design',
+                path: 'docs/ui-design-spec.md',
+                description: 'UI design specification',
+            },
+            {
+                title: 'Feature Analysis',
+                path: 'docs/feature-analysis.md',
+                description: 'Feature comparison and analysis',
+            },
+        ];
+    }
+    /**
+     * Load a documentation file
+     */
+    async loadDoc(path) {
+        // Check cache first
+        if (this.cache.has(path)) {
+            return this.cache.get(path);
+        }
+        try {
+            const content = await readFile(path, 'utf-8');
+            this.cache.set(path, content);
+            return content;
+        }
+        catch (_error) {
+            throw new Error(`Failed to load documentation: ${path}`);
+        }
+    }
+    /**
+     * Render markdown to plain text (simplified)
+     *
+     * In a real implementation, this would use a proper markdown parser.
+     * For now, we just strip some basic markdown syntax.
+     */
+    renderMarkdown(content) {
+        // Remove code blocks
+        let rendered = content.replace(/```[\s\S]*?```/g, '[code block]');
+        // Remove inline code
+        rendered = rendered.replace(/`([^`]+)`/g, '$1');
+        // Remove bold/italic
+        rendered = rendered.replace(/\*\*([^*]+)\*\*/g, '$1');
+        rendered = rendered.replace(/\*([^*]+)\*/g, '$1');
+        // Remove links but keep text
+        rendered = rendered.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1');
+        return rendered;
+    }
+    /**
+     * Resolve a link from one document to another
+     */
+    resolveLink(from, to) {
+        // If absolute path, return as-is
+        if (to.startsWith('/')) {
+            return to;
+        }
+        // If relative path, resolve from current document
+        const fromDir = from.substring(0, from.lastIndexOf('/'));
+        return join(fromDir, to);
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=docsService.js.map

package/dist/ui/services/docsService.js.map

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

package/dist/ui/services/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * UI services exports
+ */
+export { KeyboardHandler, keyboardHandler, type KeyboardShortcut, type KeyInput, } from './keyboardHandler.js';
+export { ThemeManager, getThemeManager, resetThemeManager } from './themeManager.js';
+export { DocsService, type DocEntry } from './docsService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,QAAQ,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ui/services/index.js

@@ -0,0 +1,7 @@
+/**
+ * UI services exports
+ */
+export { KeyboardHandler, keyboardHandler, } from './keyboardHandler.js';
+export { ThemeManager, getThemeManager, resetThemeManager } from './themeManager.js';
+export { DocsService } from './docsService.js';
+//# sourceMappingURL=index.js.map

package/dist/ui/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAiB,MAAM,kBAAkB,CAAC"}