genbox-agent 1.0.39 → 1.0.41

package/dist/server/port-finder.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Port Finder Utility
+ *
+ * Finds an available port for the genbox-agent server.
+ * Uses base port 47191 with automatic fallback to 47192, 47193, etc.
+ *
+ * Why 47191?
+ * - Not in common port lists (IANA, Docker, dev tools)
+ * - High enough to avoid privileged range
+ * - Memorable pattern: 47-1-91
+ * - Unlikely to conflict with other services
+ */
+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.BASE_PORT = void 0;
+exports.isPortAvailable = isPortAvailable;
+exports.findAvailablePort = findAvailablePort;
+exports.createPortLock = createPortLock;
+exports.removePortLock = removePortLock;
+exports.getLockedPort = getLockedPort;
+exports.findAndLockPort = findAndLockPort;
+exports.cleanupStaleLocks = cleanupStaleLocks;
+const net = __importStar(require("net"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// Base port for genbox-agent server
+exports.BASE_PORT = 47191;
+// Maximum number of ports to try before giving up
+const MAX_ATTEMPTS = 10;
+// Port lock file directory
+const LOCK_DIR = path.join(os.homedir(), '.genbox', 'locks');
+/**
+ * Check if a port is available for binding
+ */
+async function isPortAvailable(port, host = '0.0.0.0') {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE' || err.code === 'EACCES') {
+                resolve(false);
+            }
+            else {
+                // Other errors - assume port is not usable
+                resolve(false);
+            }
+        });
+        server.once('listening', () => {
+            server.close(() => {
+                resolve(true);
+            });
+        });
+        server.listen(port, host);
+    });
+}
+/**
+ * Find an available port starting from basePort
+ * Returns the first available port, or 0 if none found (let OS assign)
+ */
+async function findAvailablePort(basePort = exports.BASE_PORT) {
+    for (let offset = 0; offset < MAX_ATTEMPTS; offset++) {
+        const port = basePort + offset;
+        // Check if port is available
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+        console.log(`[port-finder] Port ${port} is in use, trying next...`);
+    }
+    console.log(`[port-finder] No ports available in range ${basePort}-${basePort + MAX_ATTEMPTS - 1}, using OS-assigned port`);
+    return 0; // Let OS assign a random port
+}
+/**
+ * Ensure lock directory exists
+ */
+function ensureLockDir() {
+    if (!fs.existsSync(LOCK_DIR)) {
+        fs.mkdirSync(LOCK_DIR, { recursive: true });
+    }
+}
+/**
+ * Create a lock file for a port (prevents race conditions with other daemon instances)
+ */
+function createPortLock(port) {
+    ensureLockDir();
+    const lockFile = path.join(LOCK_DIR, `port-${port}.lock`);
+    try {
+        // Check if lock exists and is valid (process still running)
+        if (fs.existsSync(lockFile)) {
+            const content = fs.readFileSync(lockFile, 'utf8');
+            const [pidStr, timestampStr] = content.split(':');
+            const pid = parseInt(pidStr, 10);
+            // Check if process is still running
+            try {
+                process.kill(pid, 0); // Signal 0 = check if process exists
+                // Process still running, lock is valid
+                return false;
+            }
+            catch {
+                // Process not running, lock is stale - remove it
+                fs.unlinkSync(lockFile);
+            }
+        }
+        // Create new lock file
+        fs.writeFileSync(lockFile, `${process.pid}:${Date.now()}`, { flag: 'wx' });
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'EEXIST') {
+            // Another process created the lock between our check and write
+            return false;
+        }
+        // Other errors - log and proceed
+        console.error(`[port-finder] Failed to create lock file: ${err.message}`);
+        return true; // Proceed anyway
+    }
+}
+/**
+ * Remove port lock file
+ */
+function removePortLock(port) {
+    const lockFile = path.join(LOCK_DIR, `port-${port}.lock`);
+    try {
+        if (fs.existsSync(lockFile)) {
+            fs.unlinkSync(lockFile);
+        }
+    }
+    catch (err) {
+        console.error(`[port-finder] Failed to remove lock file: ${err.message}`);
+    }
+}
+/**
+ * Get currently locked port by this process (if any)
+ * Useful for finding which port the daemon is using
+ */
+function getLockedPort() {
+    ensureLockDir();
+    try {
+        const files = fs.readdirSync(LOCK_DIR);
+        for (const file of files) {
+            if (file.startsWith('port-') && file.endsWith('.lock')) {
+                const content = fs.readFileSync(path.join(LOCK_DIR, file), 'utf8');
+                const [pidStr] = content.split(':');
+                const pid = parseInt(pidStr, 10);
+                if (pid === process.pid) {
+                    const portStr = file.replace('port-', '').replace('.lock', '');
+                    return parseInt(portStr, 10);
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return null;
+}
+/**
+ * Find and lock an available port
+ * Combines findAvailablePort with createPortLock for atomic operation
+ */
+async function findAndLockPort(basePort = exports.BASE_PORT) {
+    for (let offset = 0; offset < MAX_ATTEMPTS; offset++) {
+        const port = basePort + offset;
+        // Try to create lock first (fast path)
+        if (!createPortLock(port)) {
+            console.log(`[port-finder] Port ${port} is locked by another process, trying next...`);
+            continue;
+        }
+        // Check if port is actually available
+        if (await isPortAvailable(port)) {
+            console.log(`[port-finder] Successfully locked port ${port}`);
+            return port;
+        }
+        // Port not available, remove our lock and try next
+        removePortLock(port);
+        console.log(`[port-finder] Port ${port} is in use (no lock), trying next...`);
+    }
+    // Fallback: let OS assign a port
+    console.log(`[port-finder] No ports available in range, requesting OS-assigned port`);
+    const osPort = await getOSAssignedPort();
+    if (osPort > 0) {
+        createPortLock(osPort);
+    }
+    return osPort;
+}
+/**
+ * Get an OS-assigned random available port
+ */
+async function getOSAssignedPort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once('error', reject);
+        server.once('listening', () => {
+            const address = server.address();
+            const port = typeof address === 'object' && address ? address.port : 0;
+            server.close(() => {
+                resolve(port);
+            });
+        });
+        server.listen(0, '0.0.0.0');
+    });
+}
+/**
+ * Cleanup stale lock files (for maintenance)
+ */
+function cleanupStaleLocks() {
+    ensureLockDir();
+    let cleaned = 0;
+    try {
+        const files = fs.readdirSync(LOCK_DIR);
+        for (const file of files) {
+            if (file.startsWith('port-') && file.endsWith('.lock')) {
+                const filePath = path.join(LOCK_DIR, file);
+                const content = fs.readFileSync(filePath, 'utf8');
+                const [pidStr] = content.split(':');
+                const pid = parseInt(pidStr, 10);
+                // Check if process is still running
+                try {
+                    process.kill(pid, 0);
+                    // Process still running, leave lock
+                }
+                catch {
+                    // Process not running, remove stale lock
+                    fs.unlinkSync(filePath);
+                    cleaned++;
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.error(`[port-finder] Error cleaning up stale locks: ${err.message}`);
+    }
+    return cleaned;
+}
+//# sourceMappingURL=port-finder.js.map

package/dist/server/port-finder.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Local SQLite Storage
+ *
+ * Provides persistent storage for sessions, messages, events, and output.
+ * Compatible with Session V2 API for seamless cloud sync.
+ *
+ * Database location: ~/.genbox/data/agent.db
+ */
+import Database from 'better-sqlite3';
+export * from './schema';
+/**
+ * Storage configuration
+ */
+export interface StorageConfig {
+    dbPath?: string;
+    inMemory?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Local Storage Manager
+ */
+export declare class LocalStorage {
+    private db;
+    private config;
+    constructor(config?: StorageConfig);
+    /**
+     * Initialize database schema
+     */
+    private initSchema;
+    /**
+     * Run migrations
+     */
+    private migrate;
+    /**
+     * Get the underlying database instance
+     */
+    getDb(): Database.Database;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+    /**
+     * Run a transaction
+     */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Get database file path
+     */
+    getPath(): string;
+    /**
+     * Get database stats
+     */
+    getStats(): {
+        sessions: number;
+        messages: number;
+        toolUses: number;
+        events: number;
+        sizeBytes: number;
+    };
+    /**
+     * Get pending sync counts
+     */
+    getPendingSyncCounts(): {
+        sessions: number;
+        messages: number;
+        toolUses: number;
+        events: number;
+    };
+    /**
+     * Vacuum database to reclaim space
+     */
+    vacuum(): void;
+}
+/**
+ * Get or create the storage instance
+ */
+export declare function getStorage(config?: StorageConfig): LocalStorage;
+/**
+ * Close the storage instance
+ */
+export declare function closeStorage(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC,cAAc,UAAU,CAAC;AAMzB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,GAAE,aAAkB;IA8BtC;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,KAAK,IAAI,QAAQ,CAAC,QAAQ;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI9B;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB;IAmBD;;OAEG;IACH,oBAAoB,IAAI;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB;IASD;;OAEG;IACH,MAAM,IAAI,IAAI;CAIf;AAKD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,YAAY,CAK/D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC"}

package/dist/storage/index.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Local SQLite Storage
+ *
+ * Provides persistent storage for sessions, messages, events, and output.
+ * Compatible with Session V2 API for seamless cloud sync.
+ *
+ * Database location: ~/.genbox/data/agent.db
+ */
+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;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorage = void 0;
+exports.getStorage = getStorage;
+exports.closeStorage = closeStorage;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const schema_1 = require("./schema");
+// Re-export types
+__exportStar(require("./schema"), exports);
+// Default database path
+const DEFAULT_DB_DIR = path.join(os.homedir(), '.genbox', 'data');
+const DEFAULT_DB_PATH = path.join(DEFAULT_DB_DIR, 'agent.db');
+/**
+ * Local Storage Manager
+ */
+class LocalStorage {
+    db;
+    config;
+    constructor(config = {}) {
+        this.config = config;
+        // Ensure directory exists
+        if (!config.inMemory) {
+            const dbPath = config.dbPath || DEFAULT_DB_PATH;
+            const dbDir = path.dirname(dbPath);
+            if (!fs.existsSync(dbDir)) {
+                fs.mkdirSync(dbDir, { recursive: true });
+            }
+        }
+        // Open database
+        const dbPath = config.inMemory ? ':memory:' : (config.dbPath || DEFAULT_DB_PATH);
+        this.db = new better_sqlite3_1.default(dbPath, {
+            verbose: config.verbose ? console.log : undefined,
+        });
+        // Enable WAL mode for better concurrency
+        this.db.pragma('journal_mode = WAL');
+        // Enable foreign keys
+        this.db.pragma('foreign_keys = ON');
+        // Initialize schema
+        this.initSchema();
+        console.log(`[storage] Database initialized at ${dbPath}`);
+    }
+    /**
+     * Initialize database schema
+     */
+    initSchema() {
+        // Check current schema version
+        const hasVersionTable = this.db.prepare(`
+      SELECT name FROM sqlite_master
+      WHERE type='table' AND name='schema_version'
+    `).get();
+        if (!hasVersionTable) {
+            // Fresh database - create all tables
+            this.db.exec(schema_1.SCHEMA_SQL);
+            this.db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(schema_1.SCHEMA_VERSION);
+            console.log(`[storage] Schema created (version ${schema_1.SCHEMA_VERSION})`);
+        }
+        else {
+            // Check if migration needed
+            const row = this.db.prepare('SELECT MAX(version) as version FROM schema_version').get();
+            const currentVersion = row?.version || 0;
+            if (currentVersion < schema_1.SCHEMA_VERSION) {
+                this.migrate(currentVersion, schema_1.SCHEMA_VERSION);
+            }
+        }
+    }
+    /**
+     * Run migrations
+     */
+    migrate(fromVersion, toVersion) {
+        console.log(`[storage] Migrating from version ${fromVersion} to ${toVersion}`);
+        // Add migration logic here as schema evolves
+        // For now, just update version
+        this.db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(toVersion);
+    }
+    /**
+     * Get the underlying database instance
+     */
+    getDb() {
+        return this.db;
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        this.db.close();
+        console.log('[storage] Database closed');
+    }
+    /**
+     * Run a transaction
+     */
+    transaction(fn) {
+        return this.db.transaction(fn)();
+    }
+    /**
+     * Get database file path
+     */
+    getPath() {
+        return this.config.dbPath || DEFAULT_DB_PATH;
+    }
+    /**
+     * Get database stats
+     */
+    getStats() {
+        const sessions = this.db.prepare('SELECT COUNT(*) as count FROM sessions').get().count;
+        const messages = this.db.prepare('SELECT COUNT(*) as count FROM messages').get().count;
+        const toolUses = this.db.prepare('SELECT COUNT(*) as count FROM tool_uses').get().count;
+        const events = this.db.prepare('SELECT COUNT(*) as count FROM events').get().count;
+        let sizeBytes = 0;
+        if (!this.config.inMemory) {
+            try {
+                const stat = fs.statSync(this.getPath());
+                sizeBytes = stat.size;
+            }
+            catch {
+                // Ignore
+            }
+        }
+        return { sessions, messages, toolUses, events, sizeBytes };
+    }
+    /**
+     * Get pending sync counts
+     */
+    getPendingSyncCounts() {
+        const sessions = this.db.prepare('SELECT COUNT(*) as count FROM sessions WHERE sync_pending = 1').get().count;
+        const messages = this.db.prepare('SELECT COUNT(*) as count FROM messages WHERE sync_pending = 1').get().count;
+        const toolUses = this.db.prepare('SELECT COUNT(*) as count FROM tool_uses WHERE sync_pending = 1').get().count;
+        const events = this.db.prepare('SELECT COUNT(*) as count FROM events WHERE sync_pending = 1').get().count;
+        return { sessions, messages, toolUses, events };
+    }
+    /**
+     * Vacuum database to reclaim space
+     */
+    vacuum() {
+        this.db.exec('VACUUM');
+        console.log('[storage] Database vacuumed');
+    }
+}
+exports.LocalStorage = LocalStorage;
+// Singleton instance
+let storageInstance = null;
+/**
+ * Get or create the storage instance
+ */
+function getStorage(config) {
+    if (!storageInstance) {
+        storageInstance = new LocalStorage(config);
+    }
+    return storageInstance;
+}
+/**
+ * Close the storage instance
+ */
+function closeStorage() {
+    if (storageInstance) {
+        storageInstance.close();
+        storageInstance = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

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