@appkit/llamacpp-cli 2.0.0 → 2.1.0

package/dist/lib/keyboard-manager.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyboardManager = void 0;
+/**
+ * KeyboardManager provides centralized keyboard event handling with a context stack.
+ *
+ * This solves several problems with blessed.js's event model:
+ * 1. No built-in event.stopPropagation() mechanism
+ * 2. Multiple handlers can fire for the same key
+ * 3. Modal focus doesn't prevent screen handlers from executing
+ * 4. Handler re-registration in render() causes races and state loss
+ *
+ * Usage pattern:
+ * ```typescript
+ * const keyboardManager = new KeyboardManager(screen);
+ *
+ * // Push main app context
+ * keyboardManager.pushContext('main', {
+ *   'escape': () => process.exit(0),
+ *   'up': () => scrollUp(),
+ *   'down': () => scrollDown(),
+ * });
+ *
+ * // When opening a modal, push a blocking context
+ * keyboardManager.pushContext('confirm-modal', {
+ *   'enter': () => confirmAction(),
+ *   'escape': () => closeModal(),
+ * }, true); // blocking=true prevents main context from receiving keys
+ *
+ * // When closing the modal, pop the context
+ * keyboardManager.popContext();
+ *
+ * // Now main context receives keys again
+ * ```
+ *
+ * Context Stack Example:
+ * ```
+ * [top] modal-context (blocking)    <- Keys go here first
+ *       main-context                <- Only receives keys if modal doesn't handle and is non-blocking
+ * ```
+ */
+class KeyboardManager {
+    /**
+     * Create a new KeyboardManager.
+     *
+     * @param screen - blessed screen instance to intercept keys from
+     * @param debugMode - If true, log key handling to stderr for debugging
+     */
+    constructor(screen, debugMode = false) {
+        this.contextStack = [];
+        this.debugMode = false;
+        this.screen = screen;
+        this.debugMode = debugMode;
+        this.interceptKeys();
+    }
+    /**
+     * Intercept all keypresses at the screen level.
+     * This is called BEFORE blessed's screen.key() handlers.
+     */
+    interceptKeys() {
+        this.screen.on('keypress', (ch, key) => {
+            this.handleKeypress(ch, key);
+        });
+    }
+    /**
+     * Route keypress to the top-most context.
+     * If context doesn't handle it and is non-blocking, pass to lower contexts.
+     */
+    handleKeypress(ch, key) {
+        if (this.debugMode) {
+            const contextNames = this.contextStack.map(c => c.name).join(' -> ');
+            console.error(`[KeyboardManager] Key: ${key.full || key.name} | Contexts: ${contextNames || '(none)'}`);
+        }
+        if (this.contextStack.length === 0) {
+            if (this.debugMode) {
+                console.error('[KeyboardManager] No contexts registered, key not handled');
+            }
+            return;
+        }
+        // Iterate from top of stack (most recent context) to bottom
+        for (let i = this.contextStack.length - 1; i >= 0; i--) {
+            const context = this.contextStack[i];
+            const handled = this.tryContext(context, ch, key);
+            if (handled) {
+                // Event consumed by this context
+                if (this.debugMode) {
+                    console.error(`[KeyboardManager] ✓ Handled by context: ${context.name}`);
+                }
+                return;
+            }
+            if (context.blocking) {
+                // Context is blocking, don't pass to lower contexts
+                if (this.debugMode) {
+                    console.error(`[KeyboardManager] ✗ Not handled, but blocked by: ${context.name}`);
+                }
+                return;
+            }
+            // Not handled and not blocking, continue to next context
+            if (this.debugMode) {
+                console.error(`[KeyboardManager] ↓ Not handled by ${context.name}, trying next context`);
+            }
+        }
+        if (this.debugMode) {
+            console.error('[KeyboardManager] Key not handled by any context');
+        }
+    }
+    /**
+     * Try to handle key in the given context.
+     * Returns true if handled, false otherwise.
+     */
+    tryContext(context, ch, key) {
+        // Try full key name first (e.g., "C-c", "escape", "M-x")
+        const fullKey = key.full || key.name;
+        let handler = context.handlers[fullKey];
+        if (!handler && key.name) {
+            // Try just the key name (e.g., "c" instead of "C-c")
+            handler = context.handlers[key.name];
+        }
+        if (!handler && ch) {
+            // Try the character itself (e.g., "a", "1")
+            handler = context.handlers[ch];
+        }
+        if (handler) {
+            const result = handler(ch, key);
+            // Handler can return false to indicate "not handled"
+            return result !== false;
+        }
+        return false;
+    }
+    /**
+     * Push a new keyboard context onto the stack.
+     * This context will receive keys before lower contexts.
+     *
+     * @param name - Human-readable name for debugging
+     * @param handlers - Map of key names to handler functions
+     * @param blocking - If true, prevent keys from reaching lower contexts (default: true)
+     *
+     * @example
+     * ```typescript
+     * // Push a blocking modal context
+     * keyboardManager.pushContext('error-modal', {
+     *   'enter': () => closeModal(),
+     *   'escape': () => closeModal(),
+     * }, true);
+     * ```
+     */
+    pushContext(name, handlers, blocking = true) {
+        if (this.debugMode) {
+            console.error(`[KeyboardManager] ⬆ Push context: ${name} (blocking: ${blocking})`);
+        }
+        this.contextStack.push({
+            name,
+            handlers,
+            blocking,
+        });
+    }
+    /**
+     * Pop the top keyboard context from the stack.
+     * Previous context (if any) will now receive keys.
+     *
+     * @example
+     * ```typescript
+     * // Close modal and restore previous context
+     * keyboardManager.popContext();
+     * ```
+     */
+    popContext() {
+        const context = this.contextStack.pop();
+        if (this.debugMode && context) {
+            console.error(`[KeyboardManager] ⬇ Pop context: ${context.name}`);
+        }
+    }
+    /**
+     * Update handlers for the current (top) context.
+     * Useful for view mode changes without push/pop.
+     *
+     * @param handlers - New handler map for the current context
+     *
+     * @example
+     * ```typescript
+     * // Switch from list mode to detail mode handlers
+     * keyboardManager.updateCurrentContext({
+     *   'escape': () => backToList(),
+     *   'h': () => showHistory(),
+     *   'l': () => showLogs(),
+     * });
+     * ```
+     */
+    updateCurrentContext(handlers) {
+        if (this.contextStack.length === 0) {
+            throw new Error('No context to update');
+        }
+        const current = this.contextStack[this.contextStack.length - 1];
+        current.handlers = handlers;
+        if (this.debugMode) {
+            console.error(`[KeyboardManager] ↻ Updated context: ${current.name}`);
+        }
+    }
+    /**
+     * Get the current context name (for debugging).
+     *
+     * @returns Current context name, or null if no contexts
+     */
+    getCurrentContextName() {
+        return this.contextStack.length > 0
+            ? this.contextStack[this.contextStack.length - 1].name
+            : null;
+    }
+    /**
+     * Get the full context stack (for debugging).
+     *
+     * @returns Array of context names from bottom to top
+     */
+    getContextStack() {
+        return this.contextStack.map(c => c.name);
+    }
+    /**
+     * Clear all contexts (useful for cleanup).
+     *
+     * @example
+     * ```typescript
+     * // Cleanup on exit
+     * keyboardManager.clearAll();
+     * screen.destroy();
+     * ```
+     */
+    clearAll() {
+        if (this.debugMode) {
+            console.error('[KeyboardManager] Clear all contexts');
+        }
+        this.contextStack = [];
+    }
+    /**
+     * Enable or disable debug mode.
+     * When enabled, logs key handling to stderr.
+     *
+     * @param enabled - True to enable debug logging
+     */
+    setDebugMode(enabled) {
+        this.debugMode = enabled;
+        if (enabled) {
+            console.error('[KeyboardManager] Debug mode enabled');
+        }
+    }
+}
+exports.KeyboardManager = KeyboardManager;
+//# sourceMappingURL=keyboard-manager.js.map

package/dist/lib/keyboard-manager.js.map

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

package/dist/lib/label-migration.d.ts

@@ -0,0 +1,65 @@
+import { ServerConfig } from '../types/server-config';
+import { RouterConfig } from '../types/router-config';
+import { AdminConfig } from '../types/admin-config';
+export interface MigrationBackup {
+    timestamp: string;
+    servers: ServerConfig[];
+    router: RouterConfig | null;
+    admin: AdminConfig | null;
+    runningServices: string[];
+}
+export interface MigrationResult {
+    success: boolean;
+    migratedCount: number;
+    failedServices: string[];
+    error?: string;
+}
+export declare class LabelMigration {
+    private configDir;
+    private launchAgentsDir;
+    private markerPath;
+    private backupPath;
+    constructor();
+    /**
+     * Check if migration is needed
+     */
+    needsMigration(): Promise<boolean>;
+    /**
+     * Detect services with old labels
+     */
+    detectOldLabels(): Promise<string[]>;
+    /**
+     * Create backup of current state
+     */
+    createBackup(): Promise<void>;
+    /**
+     * Migrate a single server
+     */
+    migrateServer(server: ServerConfig, wasRunning: boolean): Promise<void>;
+    /**
+     * Migrate router service
+     */
+    migrateRouter(wasRunning: boolean): Promise<void>;
+    /**
+     * Migrate admin service
+     */
+    migrateAdmin(wasRunning: boolean): Promise<void>;
+    /**
+     * Migrate all services
+     */
+    migrateAll(onProgress?: (message: string, current: number, total: number) => void): Promise<MigrationResult>;
+    /**
+     * Rollback migration
+     */
+    rollback(): Promise<void>;
+    /**
+     * Get backup info if exists
+     */
+    getBackupInfo(): Promise<MigrationBackup | null>;
+    /**
+     * Delete backup file
+     */
+    deleteBackup(): Promise<void>;
+}
+export declare const labelMigration: LabelMigration;
+//# sourceMappingURL=label-migration.d.ts.map

package/dist/lib/label-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-migration.d.ts","sourceRoot":"","sources":["../../src/lib/label-migration.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAepD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;;IAS3B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAWxC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA0B1C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BnC;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC;IAwDhB;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DvD;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DtD;;OAEG;IACG,UAAU,CACd,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACrE,OAAO,CAAC,eAAe,CAAC;IAgG3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoG/B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAOtD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAKpC;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}