@xopcai/xopcbot 0.1.1 → 0.1.3

package/dist/gateway/process-manager.js

@@ -0,0 +1,370 @@
+/**
+ * Gateway Process Manager
+ *
+ * Manages the lifecycle of the gateway server process.
+ * Supports starting, stopping, and restarting the gateway in background mode.
+ */
+import { spawn } from 'child_process';
+import { existsSync, appendFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { createLogger } from '../utils/logger.js';
+import { writePidFile, readPidFile, removePidFile, processExists, cleanupStalePidFile, } from './pid-file.js';
+import { checkPortAvailable, getProcessUsingPort, formatPortConflictError } from './port-checker.js';
+const log = createLogger('GatewayProcessManager');
+// Get __dirname equivalent in ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Project root (go up from src/gateway to project root)
+const PROJECT_ROOT = join(__dirname, '..', '..');
+// Default log file location
+const DEFAULT_LOG_DIR = join(process.env.HOME || process.env.USERPROFILE || '.', '.xopcbot', 'logs');
+const DEFAULT_LOG_FILE = join(DEFAULT_LOG_DIR, 'gateway.log');
+/**
+ * Gateway Process Manager class
+ */
+export class GatewayProcessManager {
+    childProcess = null;
+    config = null;
+    startTime = null;
+    /**
+     * Check if gateway is currently running
+     */
+    isRunning() {
+        // First check PID file
+        const pid = readPidFile();
+        if (pid === null) {
+            // No PID file, check if we have an active child process
+            return this.childProcess !== null && !this.childProcess.killed;
+        }
+        // Check if process exists
+        if (!processExists(pid)) {
+            // Process doesn't exist, clean up stale PID file
+            cleanupStalePidFile();
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get current gateway status
+     */
+    getStatus() {
+        const pid = readPidFile();
+        if (!this.isRunning()) {
+            return {
+                running: false,
+            };
+        }
+        const uptime = this.startTime ? Date.now() - this.startTime : 0;
+        return {
+            running: true,
+            pid: pid || undefined,
+            port: this.config?.port,
+            host: this.config?.host,
+            uptime,
+            health: 'unknown', // Would need health check endpoint to determine
+        };
+    }
+    /**
+     * Start gateway process
+     */
+    async start(config) {
+        log.info({ host: config.host, port: config.port, background: config.background }, 'Starting gateway process');
+        // Check if already running
+        if (this.isRunning()) {
+            log.warn('Gateway is already running');
+            return {
+                success: false,
+                alreadyRunning: true,
+                error: 'Gateway is already running. Use "xopcbot gateway restart" to restart.',
+            };
+        }
+        // Clean up any stale PID file
+        cleanupStalePidFile();
+        // Check if port is available
+        const portAvailable = await checkPortAvailable(config.port, config.host);
+        if (!portAvailable) {
+            const pid = await getProcessUsingPort(config.port);
+            const errorMessage = formatPortConflictError(config.port, config.host, pid);
+            log.error({ port: config.port, host: config.host, pid }, 'Port is in use');
+            return {
+                success: false,
+                portInUse: true,
+                error: errorMessage,
+            };
+        }
+        // Build command arguments
+        const args = ['gateway'];
+        if (config.host && config.host !== '0.0.0.0') {
+            args.push('--host', config.host);
+        }
+        if (config.port) {
+            args.push('--port', String(config.port));
+        }
+        if (config.token) {
+            args.push('--token', config.token);
+        }
+        if (config.configPath) {
+            args.push('--config', config.configPath);
+        }
+        if (config.verbose) {
+            args.push('--verbose');
+        }
+        if (config.enableHotReload === false) {
+            args.push('--no-hot-reload');
+        }
+        try {
+            if (config.background) {
+                // Background mode: spawn detached process
+                await this.startBackground(config, args);
+            }
+            else {
+                // Foreground mode: spawn attached process
+                await this.startForeground(config, args);
+            }
+            this.config = config;
+            this.startTime = Date.now();
+            log.info({ pid: this.childProcess?.pid }, 'Gateway process started');
+            return {
+                success: true,
+                pid: this.childProcess?.pid,
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            log.error({ err }, 'Failed to start gateway process');
+            return {
+                success: false,
+                error,
+            };
+        }
+    }
+    /**
+     * Start gateway in background mode (detached process)
+     */
+    async startBackground(config, args) {
+        const logFile = config.logFile || DEFAULT_LOG_FILE;
+        // Ensure log directory exists
+        const logDir = dirname(logFile);
+        if (!existsSync(logDir)) {
+            mkdirSync(logDir, { recursive: true });
+        }
+        // Always use compiled JS for background mode to avoid tsx complexity
+        // This ensures clean process detachment
+        // __dirname is dist/gateway, so we need to go up one level to dist
+        const cliPath = join(__dirname, '..', 'cli', 'index.js');
+        // Check if compiled code exists
+        if (!existsSync(cliPath)) {
+            throw new Error('Compiled code not found. Please run "pnpm run build" before using background mode, ' +
+                'or use foreground mode (without --background) for development.');
+        }
+        // Use node with compiled JS
+        this.childProcess = spawn('node', [cliPath, ...args], {
+            detached: true,
+            stdio: 'ignore',
+            env: { ...process.env },
+            shell: false,
+        });
+        // Write PID file after process is spawned
+        if (this.childProcess.pid) {
+            writePidFile(this.childProcess.pid);
+            log.info({ pid: this.childProcess.pid, logFile }, 'Gateway running in background');
+        }
+        // Don't attach any event listeners - they would prevent unref from working
+        // The child process is now fully detached and will run independently
+        // Allow parent process to exit immediately
+        this.childProcess.unref();
+    }
+    /**
+     * Start gateway in foreground mode (attached process)
+     */
+    async startForeground(config, args) {
+        const cliPath = join(__dirname, 'cli', 'index.js');
+        const isDevelopment = !existsSync(cliPath);
+        const command = isDevelopment ? 'tsx' : 'node';
+        const commandArgs = isDevelopment
+            ? [join(PROJECT_ROOT, 'src', 'cli', 'index.ts'), ...args]
+            : [cliPath, ...args];
+        this.childProcess = spawn(command, commandArgs, {
+            stdio: 'inherit', // Inherit stdin/stdout/stderr from parent
+            env: { ...process.env },
+            shell: false,
+            cwd: isDevelopment ? PROJECT_ROOT : undefined,
+        });
+        // Handle process exit
+        this.childProcess.on('exit', (code, signal) => {
+            log.info({ code, signal }, 'Gateway process exited');
+            this.childProcess = null;
+            this.startTime = null;
+            removePidFile();
+        });
+        // Write PID file
+        if (this.childProcess.pid) {
+            writePidFile(this.childProcess.pid);
+        }
+        // Don't detach - keep attached to parent process
+    }
+    /**
+     * Append data to log file
+     */
+    appendToLogFile(logFile, data) {
+        try {
+            const timestamp = new Date().toISOString();
+            const content = `[${timestamp}] ${data.toString()}`;
+            appendFileSync(logFile, content, 'utf-8');
+        }
+        catch (err) {
+            log.error({ err }, 'Failed to write to log file');
+        }
+    }
+    /**
+     * Stop gateway process gracefully
+     */
+    async stop(options = {}) {
+        const { timeout = 5000, force = false } = options;
+        log.info({ timeout, force }, 'Stopping gateway process');
+        // Check if running
+        const wasRunning = this.isRunning();
+        if (!wasRunning) {
+            log.info('Gateway is not running');
+            return {
+                success: true,
+                wasRunning: false,
+            };
+        }
+        const pid = readPidFile() || this.childProcess?.pid;
+        if (!pid) {
+            return {
+                success: false,
+                error: 'Could not determine gateway PID',
+            };
+        }
+        try {
+            if (force) {
+                // Force kill immediately
+                process.kill(pid, 'SIGKILL');
+                log.info({ pid }, 'Gateway process force killed');
+            }
+            else {
+                // Graceful shutdown with timeout
+                await this.gracefulShutdown(pid, timeout);
+            }
+            // Clean up PID file
+            removePidFile();
+            this.childProcess = null;
+            this.startTime = null;
+            this.config = null;
+            return {
+                success: true,
+                wasRunning: true,
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            log.error({ err, pid }, 'Failed to stop gateway process');
+            return {
+                success: false,
+                error,
+                wasRunning: true,
+            };
+        }
+    }
+    /**
+     * Perform graceful shutdown with timeout
+     */
+    async gracefulShutdown(pid, timeout) {
+        return new Promise((resolve, reject) => {
+            let completed = false;
+            // Send SIGTERM for graceful shutdown
+            try {
+                process.kill(pid, 'SIGTERM');
+            }
+            catch (err) {
+                reject(err);
+                return;
+            }
+            // Set timeout for force kill
+            const timeoutId = setTimeout(() => {
+                if (completed)
+                    return;
+                log.warn({ pid }, 'Graceful shutdown timed out, force killing');
+                try {
+                    process.kill(pid, 'SIGKILL');
+                    completed = true;
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }, timeout);
+            // Poll for process exit
+            const checkInterval = setInterval(() => {
+                if (!processExists(pid)) {
+                    clearInterval(checkInterval);
+                    clearTimeout(timeoutId);
+                    completed = true;
+                    log.info({ pid }, 'Gateway process stopped gracefully');
+                    resolve();
+                }
+            }, 100);
+        });
+    }
+    /**
+     * Restart gateway process
+     */
+    async restart(config) {
+        log.info('Restarting gateway process');
+        // Stop current process
+        await this.stop({ timeout: 5000 });
+        // Wait a bit for port to be released
+        await new Promise(resolve => setTimeout(resolve, 500));
+        // Start with new or existing config
+        const startConfig = config || this.config;
+        if (!startConfig) {
+            throw new Error('No configuration available for restart');
+        }
+        const result = await this.start(startConfig);
+        if (!result.success) {
+            throw new Error(result.error || 'Failed to restart gateway');
+        }
+    }
+    /**
+     * Get gateway log file path
+     */
+    getLogFile() {
+        return this.config?.logFile || DEFAULT_LOG_FILE;
+    }
+    /**
+     * Get recent logs (tail)
+     */
+    async getLogs(options = {}) {
+        const { lines = 100 } = options;
+        const logFile = this.getLogFile();
+        if (!existsSync(logFile)) {
+            return '';
+        }
+        try {
+            const { exec } = await import('child_process');
+            return new Promise((resolve) => {
+                const cmd = process.platform === 'win32'
+                    ? `powershell -Command "Get-Content '${logFile}' -Tail ${lines}"`
+                    : `tail -n ${lines} "${logFile}"`;
+                exec(cmd, (error, stdout) => {
+                    if (error) {
+                        resolve('');
+                    }
+                    else {
+                        resolve(stdout);
+                    }
+                });
+            });
+        }
+        catch (err) {
+            log.error({ err }, 'Failed to read logs');
+            return '';
+        }
+    }
+}
+// Export singleton instance for convenience
+export const gatewayProcessManager = new GatewayProcessManager();
+//# sourceMappingURL=process-manager.js.map

package/dist/gateway/process-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.js","sourceRoot":"","sources":["../../src/gateway/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAErG,MAAM,GAAG,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAElD,kCAAkC;AAClC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,wDAAwD;AACxD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEjD,4BAA4B;AAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AACrG,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACxB,YAAY,GAAwB,IAAI,CAAC;IACzC,MAAM,GAAgC,IAAI,CAAC;IAC3C,SAAS,GAAkB,IAAI,CAAC;IAExC;;OAEG;IACH,SAAS;QACP,uBAAuB;QACvB,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,wDAAwD;YACxD,OAAO,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QACjE,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,iDAAiD;YACjD,mBAAmB,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS;QACP,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,GAAG,IAAI,SAAS;YACrB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;YACvB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;YACvB,MAAM;YACN,MAAM,EAAE,SAAS,EAAE,gDAAgD;SACpE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAA4B;QACtC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAE9G,2BAA2B;QAC3B,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,cAAc,EAAE,IAAI;gBACpB,KAAK,EAAE,uEAAuE;aAC/E,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,mBAAmB,EAAE,CAAC;QAEtB,6BAA6B;QAC7B,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,YAAY,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC5E,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAE3E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,YAAY;aACpB,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzB,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,0CAA0C;gBAC1C,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,0CAA0C;gBAC1C,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE5B,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAC;YAErE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,GAAG;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/D,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;YAEtD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK;aACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,MAA4B,EAAE,IAAc;QACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;QAEnD,8BAA8B;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,qEAAqE;QACrE,wCAAwC;QACxC,mEAAmE;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAEzD,gCAAgC;QAChC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,qFAAqF;gBACrF,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE;YACpD,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,0CAA0C;QAC1C,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,+BAA+B,CAAC,CAAC;QACrF,CAAC;QAED,2EAA2E;QAC3E,qEAAqE;QAErE,2CAA2C;QAC3C,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,MAA4B,EAAE,IAAc;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/C,MAAM,WAAW,GAAG,aAAa;YAC/B,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC;YACzD,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAEvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE;YAC9C,KAAK,EAAE,SAAS,EAAE,0CAA0C;YAC5D,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,KAAK;YACZ,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,sBAAsB;QACtB,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC;YACrD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,aAAa,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,iDAAiD;IACnD,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe,EAAE,IAAqB;QAC5D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,SAAS,KAAK,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpD,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,6BAA6B,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAuB,EAAE;QAClC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QAElD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAEzD,mBAAmB;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,WAAW,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC;QACpD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,iCAAiC;aACzC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,CAAC;gBACV,yBAAyB;gBACzB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,8BAA8B,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,iCAAiC;gBACjC,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAED,oBAAoB;YACpB,aAAa,EAAE,CAAC;YAEhB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YAEnB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/D,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,gCAAgC,CAAC,CAAC;YAE1D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK;gBACL,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,GAAW,EAAE,OAAe;QACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,SAAS,GAAG,KAAK,CAAC;YAEtB,qCAAqC;YACrC,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YAED,6BAA6B;YAC7B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,SAAS;oBAAE,OAAO;gBAEtB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,4CAA4C,CAAC,CAAC;gBAChE,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;oBAC7B,SAAS,GAAG,IAAI,CAAC;oBACjB,OAAO,EAAE,CAAC;gBACZ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,wBAAwB;YACxB,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;gBACrC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,SAAS,GAAG,IAAI,CAAC;oBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,oCAAoC,CAAC,CAAC;oBACxD,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAA6B;QACzC,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAEvC,uBAAuB;QACvB,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnC,qCAAqC;QACrC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEvD,oCAAoC;QACpC,MAAM,WAAW,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,gBAAgB,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAA8B,EAAE;QAC5C,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAElC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;oBACtC,CAAC,CAAC,qCAAqC,OAAO,WAAW,KAAK,GAAG;oBACjE,CAAC,CAAC,WAAW,KAAK,KAAK,OAAO,GAAG,CAAC;gBAEpC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;oBAC1B,IAAI,KAAK,EAAE,CAAC;wBACV,OAAO,CAAC,EAAE,CAAC,CAAC;oBACd,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,MAAM,CAAC,CAAC;oBAClB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/gateway/process-manager.types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Gateway Process Manager Types
+ */
+/**
+ * Gateway process status
+ */
+export interface GatewayStatus {
+    running: boolean;
+    pid?: number;
+    port?: number;
+    host?: string;
+    uptime?: number;
+    health?: 'healthy' | 'unhealthy' | 'unknown';
+    lastError?: string;
+}
+/**
+ * Configuration for starting gateway process
+ */
+export interface GatewayProcessConfig {
+    /** Host to bind to */
+    host: string;
+    /** Port to listen on */
+    port: number;
+    /** Authentication token (optional, will use config if not provided) */
+    token?: string;
+    /** Config file path */
+    configPath?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Run in background (daemon mode) */
+    background?: boolean;
+    /** Log file path for background mode */
+    logFile?: string;
+    /** Enable config hot reload */
+    enableHotReload?: boolean;
+}
+/**
+ * Result of starting gateway process
+ */
+export interface StartResult {
+    success: boolean;
+    pid?: number;
+    error?: string;
+    portInUse?: boolean;
+    alreadyRunning?: boolean;
+}
+/**
+ * Result of stopping gateway process
+ */
+export interface StopResult {
+    success: boolean;
+    error?: string;
+    timedOut?: boolean;
+    wasRunning?: boolean;
+}
+/**
+ * Options for stopping gateway process
+ */
+export interface StopOptions {
+    /** Timeout in milliseconds before force kill */
+    timeout?: number;
+    /** Force kill immediately */
+    force?: boolean;
+}

package/dist/gateway/process-manager.types.js

@@ -0,0 +1,5 @@
+/**
+ * Gateway Process Manager Types
+ */
+export {};
+//# sourceMappingURL=process-manager.types.js.map

package/dist/gateway/process-manager.types.js.map

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

package/dist/gateway/server.js

@@ -19,9 +19,11 @@ export class GatewayServer {
         // Start the underlying service first
         await this.service.start();
         // Create Hono app
+        // Priority: CLI token > service auto-generated token
+        const effectiveToken = this.config.token || this.serviceInstance.getAuthToken();
         const app = createHonoApp({
             service: this.service,
-            token: this.config.token,
+            token: effectiveToken,
         });
         // Create Node.js HTTP server (no WebSocket upgrade needed)
         this.server = serve({

package/dist/gateway/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/gateway/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAW1C,MAAM,OAAO,aAAa;IAChB,MAAM,CAAc;IACpB,MAAM,CAAsB;IAC5B,OAAO,CAAiB;IAEhC,YAAY,MAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC;YAChC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,4BAA4B,CAAC,CAAC;QAE3F,qCAAqC;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAE3B,kBAAkB;QAClB,MAAM,GAAG,GAAG,aAAa,CAAC;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC,CAAC;QAEH,2DAA2D;QAC3D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;SAC3B,EAAE,GAAG,EAAE;YACN,GAAG,CAAC,IAAI,CACN,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAClD,oCAAoC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAC3E,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAEvC,uBAAuB;QACvB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,uEAAuE;YACvE,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACf,IAAI,CAAC,MAAc,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBAC/C,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,CAAC;YAET,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,MAAO,CAAC,KAAK,CAAC,GAAG,EAAE;oBACtB,YAAY,CAAC,UAAU,CAAC,CAAC;oBACzB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;QAED,8BAA8B;QAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAE1B,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACnC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/gateway/server.ts"],"names":[],"mappings":"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"}

package/dist/gateway/service.d.ts

@@ -27,6 +27,7 @@ export declare class GatewayService {
     private configReloader;
     private startTime;
     private workspacePath;
+    private auth;
     private eventCounter;
     private subscribers;
     private eventBuffers;
@@ -261,5 +262,24 @@ export declare class GatewayService {
         chatId: string;
         lastActive: string;
     }>>;
+    /**
+     * Validate authentication token from request headers.
+     * Returns true if auth is disabled (mode: 'none') or token is valid.
+     */
+    validateAuth(headers?: Record<string, string | string[] | undefined>): boolean;
+    /**
+     * Get current auth mode.
+     */
+    getAuthMode(): 'none' | 'token';
+    /**
+     * Get current auth token (for CLI server integration).
+     * Returns undefined if mode is 'none'.
+     */
+    getAuthToken(): string | undefined;
+    /**
+     * Refresh (regenerate) the gateway auth token.
+     * Returns the new token.
+     */
+    refreshAuthToken(): Promise<string>;
 }
 export {};

package/dist/gateway/service.js

@@ -11,6 +11,7 @@ import { PluginLoader, normalizePluginConfig } from '../plugins/index.js';
 import { HeartbeatService } from '../heartbeat/index.js';
 import { ConfigHotReloader } from '../config/reload.js';
 import { SessionManager } from '../session/index.js';
+import { resolveGatewayAuth, assertGatewayAuthConfigured, validateToken, extractToken } from './auth.js';
 const log = createLogger('GatewayService');
 const EVENT_BUFFER_SIZE = 200; // ring buffer per subscriber for Last-Event-ID replay
 export class GatewayService {
@@ -28,6 +29,8 @@ export class GatewayService {
     configReloader = null;
     startTime = Date.now();
     workspacePath;
+    // Authentication
+    auth;
     // SSE event system
     eventCounter = 0;
     subscribers = new Map();
@@ -37,6 +40,20 @@ export class GatewayService {
         this.bus = new MessageBus();
         this.configPath = serviceConfig.configPath || DEFAULT_PATHS.config;
         this.config = loadConfig(this.configPath);
+        // Initialize authentication
+        this.auth = resolveGatewayAuth({
+            authConfig: this.config.gateway?.auth,
+        });
+        // Validate auth configuration
+        assertGatewayAuthConfigured(this.auth);
+        // Log token info (not the token itself)
+        if (this.auth.mode === 'token') {
+            const tokenPreview = this.auth.token ? `${this.auth.token.slice(0, 8)}...` : 'none';
+            log.info({ mode: this.auth.mode, tokenPreview }, 'Gateway authentication configured');
+        }
+        else {
+            log.warn({ mode: this.auth.mode }, 'Gateway authentication disabled (no auth required)');
+        }
         // Initialize channel manager
         this.channelManager = new ChannelManager(this.config, this.bus);
         // Initialize plugin loader
@@ -617,5 +634,55 @@ export class GatewayService {
         }
         return chatIds;
     }
+    /**
+     * Validate authentication token from request headers.
+     * Returns true if auth is disabled (mode: 'none') or token is valid.
+     */
+    validateAuth(headers) {
+        const token = extractToken(headers);
+        return validateToken(this.auth, token);
+    }
+    /**
+     * Get current auth mode.
+     */
+    getAuthMode() {
+        return this.auth.mode;
+    }
+    /**
+     * Get current auth token (for CLI server integration).
+     * Returns undefined if mode is 'none'.
+     */
+    getAuthToken() {
+        return this.auth.mode === 'token' ? this.auth.token : undefined;
+    }
+    /**
+     * Refresh (regenerate) the gateway auth token.
+     * Returns the new token.
+     */
+    async refreshAuthToken() {
+        if (this.auth.mode !== 'token') {
+            throw new Error('Cannot refresh token: auth mode is not token');
+        }
+        // Generate new token
+        const newToken = crypto.randomBytes(24).toString('hex');
+        // Update in-memory auth
+        this.auth.token = newToken;
+        // Update config
+        this.config = {
+            ...this.config,
+            gateway: {
+                ...this.config.gateway,
+                auth: {
+                    ...this.config.gateway?.auth,
+                    mode: 'token',
+                    token: newToken,
+                },
+            },
+        };
+        // Save to disk
+        await saveConfig(this.config, this.configPath);
+        log.info({ tokenPreview: `${newToken.slice(0, 8)}...` }, 'Gateway token refreshed');
+        return newToken;
+    }
 }
 //# sourceMappingURL=service.js.map