@appkit/llamacpp-cli 1.0.0

package/dist/lib/model-scanner.js

@@ -0,0 +1,145 @@
+"use strict";
+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.modelScanner = exports.ModelScanner = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const file_utils_1 = require("../utils/file-utils");
+const format_utils_1 = require("../utils/format-utils");
+class ModelScanner {
+    constructor(modelsDir) {
+        this.modelsDir = modelsDir || (0, file_utils_1.getModelsDir)();
+    }
+    /**
+     * Scan models directory for GGUF files
+     */
+    async scanModels() {
+        try {
+            const files = await fs.readdir(this.modelsDir);
+            const ggufFiles = files.filter((f) => f.toLowerCase().endsWith('.gguf'));
+            const models = [];
+            for (const file of ggufFiles) {
+                const modelInfo = await this.getModelInfo(file);
+                if (modelInfo) {
+                    models.push(modelInfo);
+                }
+            }
+            // Sort by modified date (newest first)
+            models.sort((a, b) => b.modified.getTime() - a.modified.getTime());
+            return models;
+        }
+        catch (error) {
+            // Models directory doesn't exist or is not accessible
+            return [];
+        }
+    }
+    /**
+     * Get information about a specific model file
+     */
+    async getModelInfo(filename) {
+        const modelPath = path.join(this.modelsDir, filename);
+        try {
+            const stats = await fs.stat(modelPath);
+            return {
+                filename,
+                path: modelPath,
+                size: stats.size,
+                sizeFormatted: (0, format_utils_1.formatBytes)(stats.size),
+                modified: stats.mtime,
+                exists: true,
+            };
+        }
+        catch (error) {
+            // File doesn't exist or is not accessible
+            return {
+                filename,
+                path: modelPath,
+                size: 0,
+                sizeFormatted: '0 B',
+                modified: new Date(),
+                exists: false,
+            };
+        }
+    }
+    /**
+     * Validate that a model file exists and is readable
+     */
+    async validateModel(filename) {
+        const modelInfo = await this.getModelInfo(filename);
+        return modelInfo !== null && modelInfo.exists && modelInfo.size > 0;
+    }
+    /**
+     * Resolve a model filename to full path
+     */
+    async resolveModelPath(filename) {
+        // If already absolute path, return it
+        if (path.isAbsolute(filename)) {
+            return filename;
+        }
+        // Try in models directory
+        const modelPath = path.join(this.modelsDir, filename);
+        const modelInfo = await this.getModelInfo(filename);
+        if (modelInfo && modelInfo.exists) {
+            return modelPath;
+        }
+        // Try adding .gguf extension
+        if (!filename.toLowerCase().endsWith('.gguf')) {
+            const withExtension = `${filename}.gguf`;
+            const modelInfoWithExt = await this.getModelInfo(withExtension);
+            if (modelInfoWithExt && modelInfoWithExt.exists) {
+                return path.join(this.modelsDir, withExtension);
+            }
+        }
+        return null;
+    }
+    /**
+     * Get the size of a model file
+     */
+    async getModelSize(filename) {
+        const modelInfo = await this.getModelInfo(filename);
+        return modelInfo?.size || null;
+    }
+    /**
+     * Get total size of all models
+     */
+    async getTotalSize() {
+        const models = await this.scanModels();
+        return models.reduce((total, model) => total + model.size, 0);
+    }
+}
+exports.ModelScanner = ModelScanner;
+// Export singleton instance
+exports.modelScanner = new ModelScanner();
+//# sourceMappingURL=model-scanner.js.map

package/dist/lib/model-scanner.js.map

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

package/dist/lib/model-search.d.ts

@@ -0,0 +1,29 @@
+export interface HFModelResult {
+    modelId: string;
+    author: string;
+    modelName: string;
+    downloads: number;
+    likes: number;
+    tags: string[];
+    lastModified: string;
+}
+export declare class ModelSearch {
+    /**
+     * Search Hugging Face for GGUF models
+     */
+    searchModels(query: string, limit?: number): Promise<HFModelResult[]>;
+    /**
+     * Build Hugging Face search URL
+     */
+    private buildSearchUrl;
+    /**
+     * Parse API results into our model format
+     */
+    private parseResults;
+    /**
+     * Get GGUF files for a specific model
+     */
+    getModelFiles(modelId: string): Promise<string[]>;
+}
+export declare const modelSearch: ModelSearch;
+//# sourceMappingURL=model-search.d.ts.map

package/dist/lib/model-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-search.d.ts","sourceRoot":"","sources":["../../src/lib/model-search.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA0BvE;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA4BxD;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/lib/model-search.js

@@ -0,0 +1,131 @@
+"use strict";
+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.modelSearch = exports.ModelSearch = void 0;
+const https = __importStar(require("https"));
+class ModelSearch {
+    /**
+     * Search Hugging Face for GGUF models
+     */
+    async searchModels(query, limit = 20) {
+        const searchUrl = this.buildSearchUrl(query, limit);
+        return new Promise((resolve, reject) => {
+            https.get(searchUrl, (response) => {
+                let data = '';
+                response.on('data', (chunk) => {
+                    data += chunk;
+                });
+                response.on('end', () => {
+                    try {
+                        const results = JSON.parse(data);
+                        const models = this.parseResults(results);
+                        resolve(models);
+                    }
+                    catch (error) {
+                        reject(new Error(`Failed to parse search results: ${error.message}`));
+                    }
+                });
+            }).on('error', (error) => {
+                reject(new Error(`Search request failed: ${error.message}`));
+            });
+        });
+    }
+    /**
+     * Build Hugging Face search URL
+     */
+    buildSearchUrl(query, limit) {
+        const params = new URLSearchParams({
+            search: query,
+            filter: 'gguf',
+            sort: 'downloads',
+            direction: '-1',
+            limit: limit.toString(),
+        });
+        return `https://huggingface.co/api/models?${params.toString()}`;
+    }
+    /**
+     * Parse API results into our model format
+     */
+    parseResults(results) {
+        return results.map((result) => {
+            const modelId = result.id || result.modelId || '';
+            const parts = modelId.split('/');
+            const author = parts[0] || '';
+            const modelName = parts.slice(1).join('/') || '';
+            return {
+                modelId,
+                author,
+                modelName,
+                downloads: result.downloads || 0,
+                likes: result.likes || 0,
+                tags: result.tags || [],
+                lastModified: result.lastModified || '',
+            };
+        });
+    }
+    /**
+     * Get GGUF files for a specific model
+     */
+    async getModelFiles(modelId) {
+        const apiUrl = `https://huggingface.co/api/models/${modelId}`;
+        return new Promise((resolve, reject) => {
+            https.get(apiUrl, (response) => {
+                let data = '';
+                response.on('data', (chunk) => {
+                    data += chunk;
+                });
+                response.on('end', () => {
+                    try {
+                        const modelInfo = JSON.parse(data);
+                        const files = modelInfo.siblings || [];
+                        const ggufFiles = files
+                            .filter((file) => file.rfilename?.toLowerCase().endsWith('.gguf'))
+                            .map((file) => file.rfilename);
+                        resolve(ggufFiles);
+                    }
+                    catch (error) {
+                        reject(new Error(`Failed to fetch model files: ${error.message}`));
+                    }
+                });
+            }).on('error', (error) => {
+                reject(new Error(`API request failed: ${error.message}`));
+            });
+        });
+    }
+}
+exports.ModelSearch = ModelSearch;
+// Export singleton instance
+exports.modelSearch = new ModelSearch();
+//# sourceMappingURL=model-search.js.map

package/dist/lib/model-search.js.map

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

package/dist/lib/port-manager.d.ts

@@ -0,0 +1,26 @@
+export declare class PortManager {
+    private readonly portRangeStart;
+    private readonly portRangeEnd;
+    /**
+     * Find an available port in the range
+     */
+    findAvailablePort(startPort?: number): Promise<number>;
+    /**
+     * Check if a port is available
+     */
+    isPortAvailable(port: number): Promise<boolean>;
+    /**
+     * Validate a port number
+     */
+    validatePort(port: number): void;
+    /**
+     * Find a server using a given port
+     */
+    findServerByPort(port: number): Promise<import("../types/server-config").ServerConfig | null>;
+    /**
+     * Check for port conflicts
+     */
+    checkPortConflict(port: number, exceptId?: string): Promise<boolean>;
+}
+export declare const portManager: PortManager;
+//# sourceMappingURL=port-manager.d.ts.map

package/dist/lib/port-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-manager.d.ts","sourceRoot":"","sources":["../../src/lib/port-manager.ts"],"names":[],"mappings":"AAGA,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IAErC;;OAEG;IACG,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB5D;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBrD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAShC;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAInC;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAK3E;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/lib/port-manager.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.portManager = exports.PortManager = void 0;
+const process_utils_1 = require("../utils/process-utils");
+const state_manager_1 = require("./state-manager");
+class PortManager {
+    constructor() {
+        this.portRangeStart = 9000;
+        this.portRangeEnd = 9999;
+    }
+    /**
+     * Find an available port in the range
+     */
+    async findAvailablePort(startPort) {
+        const start = startPort || this.portRangeStart;
+        // Get ports used by existing servers
+        const usedPorts = await state_manager_1.stateManager.getUsedPorts();
+        // Find first available port
+        for (let port = start; port <= this.portRangeEnd; port++) {
+            if (!usedPorts.has(port)) {
+                // Check if port is actually available (not used by other processes)
+                const inUse = await (0, process_utils_1.isPortInUse)(port);
+                if (!inUse) {
+                    return port;
+                }
+            }
+        }
+        throw new Error(`No available ports in range ${start}-${this.portRangeEnd}`);
+    }
+    /**
+     * Check if a port is available
+     */
+    async isPortAvailable(port) {
+        // Check if port is in valid range
+        if (port < 1024 || port > 65535) {
+            return false;
+        }
+        // Check if port is used by any server
+        const usedPorts = await state_manager_1.stateManager.getUsedPorts();
+        if (usedPorts.has(port)) {
+            return false;
+        }
+        // Check if port is actually in use
+        return !(await (0, process_utils_1.isPortInUse)(port));
+    }
+    /**
+     * Validate a port number
+     */
+    validatePort(port) {
+        if (port < 1024) {
+            throw new Error('Port must be >= 1024 (ports below 1024 require root)');
+        }
+        if (port > 65535) {
+            throw new Error('Port must be <= 65535');
+        }
+    }
+    /**
+     * Find a server using a given port
+     */
+    async findServerByPort(port) {
+        return await state_manager_1.stateManager.findServerByPort(port);
+    }
+    /**
+     * Check for port conflicts
+     */
+    async checkPortConflict(port, exceptId) {
+        const servers = await state_manager_1.stateManager.getAllServers();
+        const conflict = servers.find((s) => s.port === port && s.id !== exceptId);
+        return conflict !== undefined;
+    }
+}
+exports.PortManager = PortManager;
+// Export singleton instance
+exports.portManager = new PortManager();
+//# sourceMappingURL=port-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"port-manager.js","sourceRoot":"","sources":["../../src/lib/port-manager.ts"],"names":[],"mappings":";;;AAAA,0DAAqD;AACrD,mDAA+C;AAE/C,MAAa,WAAW;IAAxB;QACmB,mBAAc,GAAG,IAAI,CAAC;QACtB,iBAAY,GAAG,IAAI,CAAC;IAuEvC,CAAC;IArEC;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAkB;QACxC,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC;QAE/C,qCAAqC;QACrC,MAAM,SAAS,GAAG,MAAM,4BAAY,CAAC,YAAY,EAAE,CAAC;QAEpD,4BAA4B;QAC5B,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC;YACzD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,oEAAoE;gBACpE,MAAM,KAAK,GAAG,MAAM,IAAA,2BAAW,EAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,kCAAkC;QAClC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,sCAAsC;QACtC,MAAM,SAAS,GAAG,MAAM,4BAAY,CAAC,YAAY,EAAE,CAAC;QACpD,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mCAAmC;QACnC,OAAO,CAAC,CAAC,MAAM,IAAA,2BAAW,EAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY;QACvB,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,OAAO,MAAM,4BAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAY,EAAE,QAAiB;QACrD,MAAM,OAAO,GAAG,MAAM,4BAAY,CAAC,aAAa,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QAC3E,OAAO,QAAQ,KAAK,SAAS,CAAC;IAChC,CAAC;CACF;AAzED,kCAyEC;AAED,4BAA4B;AACf,QAAA,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/lib/state-manager.d.ts

@@ -0,0 +1,59 @@
+import { ServerConfig } from '../types/server-config';
+import { GlobalConfig } from '../types/global-config';
+export declare class StateManager {
+    private configDir;
+    private serversDir;
+    private logsDir;
+    private globalConfigPath;
+    constructor();
+    /**
+     * Initialize config directories
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load global configuration
+     */
+    loadGlobalConfig(): Promise<GlobalConfig>;
+    /**
+     * Save global configuration
+     */
+    saveGlobalConfig(config: GlobalConfig): Promise<void>;
+    /**
+     * Load a server configuration by ID
+     */
+    loadServerConfig(id: string): Promise<ServerConfig | null>;
+    /**
+     * Save a server configuration
+     */
+    saveServerConfig(config: ServerConfig): Promise<void>;
+    /**
+     * Delete a server configuration
+     */
+    deleteServerConfig(id: string): Promise<void>;
+    /**
+     * Get all server configurations
+     */
+    getAllServers(): Promise<ServerConfig[]>;
+    /**
+     * Find a server by port
+     */
+    findServerByPort(port: number): Promise<ServerConfig | null>;
+    /**
+     * Find a server by model name (fuzzy match)
+     */
+    findServerByModelName(name: string): Promise<ServerConfig | null>;
+    /**
+     * Find a server by identifier (ID, model name, or port)
+     */
+    findServer(identifier: string): Promise<ServerConfig | null>;
+    /**
+     * Check if a server exists for a given model
+     */
+    serverExistsForModel(modelPath: string): Promise<boolean>;
+    /**
+     * Get all used ports
+     */
+    getUsedPorts(): Promise<Set<number>>;
+}
+export declare const stateManager: StateManager;
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/lib/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/lib/state-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAyB,MAAM,wBAAwB,CAAC;AAc7E,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;;IASjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC;IAK/C;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAQhE;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D;;OAEG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAmB9C;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAKlE;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiBvE;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAYlE;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;CAI3C;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/lib/state-manager.js

@@ -0,0 +1,178 @@
+"use strict";
+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.stateManager = exports.StateManager = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises"));
+const global_config_1 = require("../types/global-config");
+const file_utils_1 = require("../utils/file-utils");
+class StateManager {
+    constructor() {
+        this.configDir = (0, file_utils_1.getConfigDir)();
+        this.serversDir = (0, file_utils_1.getServersDir)();
+        this.logsDir = (0, file_utils_1.getLogsDir)();
+        this.globalConfigPath = (0, file_utils_1.getGlobalConfigPath)();
+    }
+    /**
+     * Initialize config directories
+     */
+    async initialize() {
+        await (0, file_utils_1.ensureDir)(this.configDir);
+        await (0, file_utils_1.ensureDir)(this.serversDir);
+        await (0, file_utils_1.ensureDir)(this.logsDir);
+        await (0, file_utils_1.ensureDir)((0, file_utils_1.getLaunchAgentsDir)());
+        // Create default global config if it doesn't exist
+        if (!(await (0, file_utils_1.fileExists)(this.globalConfigPath))) {
+            const defaultConfig = {
+                ...global_config_1.DEFAULT_GLOBAL_CONFIG,
+                modelsDirectory: (0, file_utils_1.getModelsDir)(),
+            };
+            await this.saveGlobalConfig(defaultConfig);
+        }
+    }
+    /**
+     * Load global configuration
+     */
+    async loadGlobalConfig() {
+        await this.initialize();
+        return await (0, file_utils_1.readJson)(this.globalConfigPath);
+    }
+    /**
+     * Save global configuration
+     */
+    async saveGlobalConfig(config) {
+        await (0, file_utils_1.writeJsonAtomic)(this.globalConfigPath, config);
+    }
+    /**
+     * Load a server configuration by ID
+     */
+    async loadServerConfig(id) {
+        const configPath = path.join(this.serversDir, `${id}.json`);
+        if (!(await (0, file_utils_1.fileExists)(configPath))) {
+            return null;
+        }
+        return await (0, file_utils_1.readJson)(configPath);
+    }
+    /**
+     * Save a server configuration
+     */
+    async saveServerConfig(config) {
+        const configPath = path.join(this.serversDir, `${config.id}.json`);
+        await (0, file_utils_1.writeJsonAtomic)(configPath, config);
+    }
+    /**
+     * Delete a server configuration
+     */
+    async deleteServerConfig(id) {
+        const configPath = path.join(this.serversDir, `${id}.json`);
+        if (await (0, file_utils_1.fileExists)(configPath)) {
+            await fs.unlink(configPath);
+        }
+    }
+    /**
+     * Get all server configurations
+     */
+    async getAllServers() {
+        await (0, file_utils_1.ensureDir)(this.serversDir);
+        const files = await fs.readdir(this.serversDir);
+        const configFiles = files.filter((f) => f.endsWith('.json'));
+        const servers = [];
+        for (const file of configFiles) {
+            const filePath = path.join(this.serversDir, file);
+            try {
+                const config = await (0, file_utils_1.readJson)(filePath);
+                servers.push(config);
+            }
+            catch (error) {
+                console.error(`Failed to load server config ${file}:`, error);
+            }
+        }
+        return servers;
+    }
+    /**
+     * Find a server by port
+     */
+    async findServerByPort(port) {
+        const servers = await this.getAllServers();
+        return servers.find((s) => s.port === port) || null;
+    }
+    /**
+     * Find a server by model name (fuzzy match)
+     */
+    async findServerByModelName(name) {
+        const servers = await this.getAllServers();
+        const nameLower = name.toLowerCase();
+        // Try exact ID match first
+        const exactMatch = servers.find((s) => s.id === nameLower);
+        if (exactMatch)
+            return exactMatch;
+        // Try partial match on model name or ID
+        const partialMatch = servers.find((s) => s.modelName.toLowerCase().includes(nameLower) ||
+            s.id.toLowerCase().includes(nameLower));
+        return partialMatch || null;
+    }
+    /**
+     * Find a server by identifier (ID, model name, or port)
+     */
+    async findServer(identifier) {
+        // Try as port number
+        const port = parseInt(identifier, 10);
+        if (!isNaN(port)) {
+            const server = await this.findServerByPort(port);
+            if (server)
+                return server;
+        }
+        // Try as ID or model name
+        return await this.findServerByModelName(identifier);
+    }
+    /**
+     * Check if a server exists for a given model
+     */
+    async serverExistsForModel(modelPath) {
+        const servers = await this.getAllServers();
+        return servers.some((s) => s.modelPath === modelPath);
+    }
+    /**
+     * Get all used ports
+     */
+    async getUsedPorts() {
+        const servers = await this.getAllServers();
+        return new Set(servers.map((s) => s.port));
+    }
+}
+exports.StateManager = StateManager;
+// Export singleton instance
+exports.stateManager = new StateManager();
+//# sourceMappingURL=state-manager.js.map