@portel/photon 1.9.0 → 1.10.0

package/dist/cli/commands/beam.js

@@ -0,0 +1,256 @@
+/**
+ * Beam & SSE CLI Commands
+ *
+ * beam: Launch Photon Beam interactive control panel
+ * sse:  Run Photon as HTTP server with SSE transport
+ */
+import * as path from 'path';
+import * as net from 'net';
+import { getErrorMessage, ExitCode, exitWithError, handleError, } from '../../shared/error-handler.js';
+import { normalizeLogLevel, logger } from '../../shared/logger.js';
+import { validateOrThrow, inRange, isPositive, isInteger } from '../../shared/validation.js';
+import { resolvePhotonPath } from '../../path-resolver.js';
+import { getDefaultContext } from '../../context.js';
+import { getBundledPhotonPath } from '../../shared-utils.js';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// ══════════════════════════════════════════════════════════════════════════════
+// PRIVATE HELPERS
+// ══════════════════════════════════════════════════════════════════════════════
+/**
+ * Check if a port is available
+ */
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => resolve(false));
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        // Listen on all interfaces (same as http.createServer default)
+        server.listen(port);
+    });
+}
+/**
+ * Find an available port starting from the given port
+ */
+async function findAvailablePort(startPort, maxAttempts = 10) {
+    // Validate port range
+    validateOrThrow(startPort, [
+        inRange('start port', 1, 65535),
+        isInteger('start port'),
+        isPositive('start port'),
+    ]);
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = startPort + i;
+        if (port > 65535) {
+            throw new Error(`Port ${port} exceeds maximum port number (65535)`);
+        }
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    throw new Error(`No available port found between ${startPort} and ${startPort + maxAttempts - 1}`);
+}
+function getLogOptionsFromCommand(command) {
+    const root = command?.parent?.opts?.() ?? {};
+    try {
+        const level = normalizeLogLevel(root.logLevel);
+        return {
+            level,
+            json: Boolean(root.jsonLogs),
+        };
+    }
+    catch (error) {
+        handleError(error, { exitOnError: true });
+        throw error; // TypeScript doesn't know handleError exits
+    }
+}
+/**
+ * Resolve photon path - checks bundled first, then user directory
+ */
+async function resolvePhotonPathWithBundled(name, workingDir) {
+    // Check bundled photons first
+    const bundledPath = getBundledPhotonPath(name, __dirname);
+    if (bundledPath) {
+        return bundledPath;
+    }
+    // Fall back to user photons
+    return resolvePhotonPath(name, workingDir);
+}
+// ══════════════════════════════════════════════════════════════════════════════
+// COMMANDS
+// ══════════════════════════════════════════════════════════════════════════════
+/**
+ * Register the sse command
+ *
+ * Run Photon as HTTP server with SSE transport (auto port detection)
+ */
+export function registerSSECommand(program) {
+    program
+        .command('sse', { hidden: true })
+        .argument('<name>', 'Photon name (without .photon.ts extension)')
+        .option('-p, --port <number>', 'Port to start from (auto-finds available)', '3000')
+        .option('--dev', 'Enable development mode with hot reload')
+        .description('Run Photon as HTTP server with SSE transport (auto port detection)')
+        .action(async (name, options, command) => {
+        try {
+            // Get working directory from global options
+            const workingDir = getDefaultContext().baseDir;
+            const logOptions = getLogOptionsFromCommand(command);
+            // Resolve file path from name
+            const filePath = await resolvePhotonPathWithBundled(name, workingDir);
+            if (!filePath) {
+                exitWithError(`Photon not found: ${name}`, {
+                    exitCode: ExitCode.NOT_FOUND,
+                    searchedIn: workingDir,
+                    suggestion: "Use 'photon info' to see available photons",
+                });
+            }
+            // Find available port
+            const startPort = parseInt(options.port, 10);
+            const port = await findAvailablePort(startPort);
+            if (port !== startPort) {
+                console.error(`⚠️  Port ${startPort} is in use, using ${port} instead\n`);
+            }
+            const { PhotonServer } = await import('../../server.js');
+            const { FileWatcher } = await import('../../watcher.js');
+            // Start SSE server
+            const server = new PhotonServer({
+                filePath: filePath,
+                devMode: options.dev,
+                transport: 'sse',
+                port,
+                logOptions: { ...logOptions, scope: 'sse' },
+                workingDir,
+            });
+            // Handle shutdown signals
+            const shutdown = async () => {
+                console.error('\nShutting down...');
+                await server.stop();
+                process.exit(0);
+            };
+            process.on('SIGINT', () => {
+                void shutdown();
+            });
+            process.on('SIGTERM', () => {
+                void shutdown();
+            });
+            // Start the server
+            await server.start();
+            // Start file watcher in dev mode
+            if (options.dev) {
+                const watcher = new FileWatcher(server, filePath, server.createScopedLogger('watcher'));
+                watcher.start();
+                process.on('SIGINT', () => {
+                    void watcher.stop();
+                });
+                process.on('SIGTERM', () => {
+                    void watcher.stop();
+                });
+            }
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Register the beam command
+ *
+ * Launch Photon Beam - interactive control panel for all your photons
+ */
+export function registerBeamCommand(program) {
+    program
+        .command('beam', { hidden: true })
+        .argument('[photon]', 'Photon to open in full-width focus view')
+        .option('-p, --port <number>', 'Port to start from (auto-finds available)', '3000')
+        .option('-o, --open', 'Auto-open browser after starting')
+        .option('--no-open', 'Do not auto-open browser')
+        .description('Launch Photon Beam - interactive control panel for all your photons')
+        .action(async (photon, options, command) => {
+        try {
+            const workingDir = getDefaultContext().baseDir;
+            const { existsSync } = await import('fs');
+            // If a photon name is given but not installed, try marketplace auto-install
+            if (photon) {
+                const photonFile = path.join(workingDir, `${photon}.photon.ts`);
+                if (!existsSync(photonFile)) {
+                    const { MarketplaceManager } = await import('../../marketplace-manager.js');
+                    const manager = new MarketplaceManager(undefined, workingDir);
+                    await manager.initialize();
+                    const conflict = await manager.checkConflict(photon);
+                    if (conflict.sources.length === 0) {
+                        const { printError } = await import('../../cli-formatter.js');
+                        printError(`Photon '${photon}' not found locally or in marketplace.`);
+                        console.error(`  Search for it with: photon search ${photon}`);
+                        process.exit(1);
+                    }
+                    console.error(`📦 Installing ${photon}...`);
+                    const result = await manager.fetchMCP(photon);
+                    if (result) {
+                        await manager.installPhoton(result, photon, workingDir);
+                        console.error(`✅ Installed ${photon}`);
+                    }
+                }
+            }
+            // Find available port
+            const startPort = parseInt(options.port, 10);
+            const port = await findAvailablePort(startPort);
+            if (port !== startPort) {
+                console.error(`⚠️  Port ${startPort} is in use, using ${port} instead\n`);
+            }
+            // Import and start Beam server
+            const { startBeam } = await import('../../auto-ui/beam.js');
+            await startBeam(workingDir, port);
+            // Auto-open browser — always when a photon is specified (focus mode), or when --open flag is set
+            if (photon || options.open) {
+                const actualPort = process.env.BEAM_PORT || port;
+                // Focus mode: hash routes to the photon, ?focus=1 hides sidebar for full-width view
+                const url = photon
+                    ? `http://localhost:${actualPort}/#${photon}?focus=1`
+                    : `http://localhost:${actualPort}`;
+                const { exec } = await import('child_process');
+                const openCmd = process.platform === 'darwin'
+                    ? 'open'
+                    : process.platform === 'win32'
+                        ? 'start'
+                        : 'xdg-open';
+                exec(`${openCmd} "${url}"`, (err) => {
+                    if (err)
+                        logger.debug(`Could not auto-open browser: ${err.message}`);
+                });
+            }
+            // Handle shutdown signals (guard against duplicate Ctrl+C)
+            let shuttingDown = false;
+            const shutdown = async () => {
+                if (shuttingDown)
+                    return;
+                shuttingDown = true;
+                console.error('\nShutting down Photon Beam...');
+                // Gracefully close external MCP clients to prevent ugly tracebacks
+                try {
+                    const { stopBeam } = await import('../../auto-ui/beam.js');
+                    await stopBeam();
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+                process.exit(0);
+            };
+            process.on('SIGINT', () => {
+                void shutdown();
+            });
+            process.on('SIGTERM', () => {
+                void shutdown();
+            });
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=beam.js.map

package/dist/cli/commands/beam.js.map

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

package/dist/cli/commands/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Config CLI Commands
+ *
+ * Commands for managing photon instances and environment configuration:
+ * - use: Switch to a named instance of a stateful photon
+ * - instances: List all instances of a stateful photon
+ * - set: Configure environment variables for a photon
+ */
+import type { Command } from 'commander';
+/**
+ * Register config-related commands: use, instances, set
+ */
+export declare function registerConfigCommands(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuK7D"}

package/dist/cli/commands/config.js

@@ -0,0 +1,165 @@
+/**
+ * Config CLI Commands
+ *
+ * Commands for managing photon instances and environment configuration:
+ * - use: Switch to a named instance of a stateful photon
+ * - instances: List all instances of a stateful photon
+ * - set: Configure environment variables for a photon
+ */
+import { getErrorMessage } from '../../shared/error-handler.js';
+import { getDefaultContext } from '../../context.js';
+/**
+ * Register config-related commands: use, instances, set
+ */
+export function registerConfigCommands(program) {
+    // Use command: switch to a named instance of a stateful photon
+    program
+        .command('use')
+        .argument('<photon>', 'Photon name')
+        .argument('[instance]', 'Instance name (omit for default)')
+        .description('Switch to a named instance of a stateful photon')
+        .action(async (photonName, instance) => {
+        try {
+            const { printSuccess, printError } = await import('../../cli-formatter.js');
+            const { CLISessionStore } = await import('../../context-store.js');
+            // Write to CLI session store only — each client manages its own instance
+            new CLISessionStore().setCurrentInstance(photonName, instance || '');
+            const label = instance || 'default';
+            printSuccess(`${photonName} → instance: ${label}`);
+            // Refresh completions cache (picks up new instance)
+            try {
+                const { generateCompletionCache } = await import('../../shell-completions.js');
+                await generateCompletionCache();
+            }
+            catch {
+                // Best-effort: don't break the use command if cache refresh fails
+            }
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(getErrorMessage(error));
+            process.exit(1);
+        }
+    });
+    // Instances command: list all instances of a stateful photon
+    program
+        .command('instances')
+        .argument('<photon>', 'Photon name')
+        .description('List all instances of a stateful photon')
+        .action(async (photonName, _options, command) => {
+        try {
+            const { printInfo, printError, printHeader } = await import('../../cli-formatter.js');
+            const workingDir = getDefaultContext().baseDir;
+            const { InstanceStore } = await import('../../context-store.js');
+            const store = new InstanceStore(workingDir);
+            const instances = store.listInstances(photonName);
+            const current = store.getCurrentInstance(photonName) || 'default';
+            if (instances.length === 0) {
+                printInfo(`No instances found for ${photonName}.`);
+                return;
+            }
+            console.log('');
+            printHeader(`${photonName} — Instances`);
+            console.log('');
+            for (const name of instances) {
+                const marker = name === current ? ' ← current' : '';
+                console.log(`  ${name}${marker}`);
+            }
+            console.log('');
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(getErrorMessage(error));
+            process.exit(1);
+        }
+    });
+    // Set command: configure environment for photons (primitive params without defaults)
+    program
+        .command('set')
+        .argument('<photon>', 'Photon name')
+        .argument('[args...]', 'Environment values (name=value pairs)')
+        .description('Configure environment for a photon (params without defaults)')
+        .action(async (photonName, args, _options, command) => {
+        try {
+            const { printInfo, printSuccess, printError, printHeader } = await import('../../cli-formatter.js');
+            const workingDir = getDefaultContext().baseDir;
+            // Resolve photon path (including bundled photons)
+            const { getBundledPhotonPath } = await import('../../shared-utils.js');
+            const { resolvePhotonPath } = await import('../../path-resolver.js');
+            const { fileURLToPath } = await import('url');
+            const path = await import('path');
+            const __dirname = path.dirname(fileURLToPath(import.meta.url));
+            // Go up two levels: commands/ -> cli/ -> src/
+            const distDir = path.resolve(__dirname, '..', '..');
+            const bundledPath = getBundledPhotonPath(photonName, distDir);
+            const filePath = bundledPath || (await resolvePhotonPath(photonName, workingDir));
+            if (!filePath) {
+                printError(`Photon not found: ${photonName}`);
+                process.exit(1);
+            }
+            // Extract constructor params and filter env params
+            const { SchemaExtractor } = await import('@portel/photon-core');
+            const fs = await import('fs/promises');
+            const source = await fs.readFile(filePath, 'utf-8');
+            const extractor = new SchemaExtractor();
+            const allParams = extractor.extractConstructorParams(source);
+            const { getEnvParams, EnvStore } = await import('../../context-store.js');
+            const envParams = getEnvParams(allParams);
+            if (envParams.length === 0) {
+                printInfo(`${photonName} has no environment parameters.`);
+                return;
+            }
+            const store = new EnvStore();
+            // Parse name=value pairs from args
+            const values = {};
+            const paramNames = new Set(envParams.map((p) => p.name));
+            for (const arg of args) {
+                const eqIdx = arg.indexOf('=');
+                if (eqIdx > 0) {
+                    const key = arg.slice(0, eqIdx);
+                    const val = arg.slice(eqIdx + 1);
+                    if (paramNames.has(key)) {
+                        values[key] = val;
+                    }
+                }
+                else if (envParams.length === 1) {
+                    // Single env param: positional value
+                    values[envParams[0].name] = arg;
+                }
+            }
+            // Find params that still need values
+            const remaining = envParams.filter((p) => !(p.name in values));
+            if (remaining.length > 0) {
+                // Interactive mode for remaining params
+                console.log('');
+                printHeader(`${photonName} — Environment`);
+                console.log('');
+                const masked = store.getMasked(photonName);
+                const { promptText } = await import('../../shared/cli-utils.js');
+                for (const param of remaining) {
+                    const currentDisplay = masked[param.name]
+                        ? `Current: ${masked[param.name]}`
+                        : 'Not set';
+                    const answer = await promptText(`  ${param.name} (required)\n  ${currentDisplay}\n  > `);
+                    if (answer.trim() !== '') {
+                        values[param.name] = answer.trim();
+                    }
+                }
+            }
+            if (Object.keys(values).length > 0) {
+                store.write(photonName, values);
+                const summary = Object.keys(values).join(', ');
+                printSuccess(`Environment saved: ${summary}`);
+            }
+            else {
+                printInfo('No changes.');
+            }
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(getErrorMessage(error));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/commands/config.js.map

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

package/dist/cli/commands/daemon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Daemon CLI Command Group
+ *
+ * Manage the Photon background daemon process (start, stop, restart, status).
+ */
+import type { Command } from 'commander';
+/**
+ * Register daemon command group
+ */
+export declare function registerDaemonCommands(program: Command): void;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/cli/commands/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkG7D"}

package/dist/cli/commands/daemon.js

@@ -0,0 +1,108 @@
+/**
+ * Daemon CLI Command Group
+ *
+ * Manage the Photon background daemon process (start, stop, restart, status).
+ */
+import { getErrorMessage } from '../../shared/error-handler.js';
+/**
+ * Register daemon command group
+ */
+export function registerDaemonCommands(program) {
+    const daemonCmd = program.command('daemon').description('Manage the Photon background daemon');
+    daemonCmd
+        .command('start')
+        .description('Start the daemon (no-op if already running)')
+        .action(async () => {
+        try {
+            const { printInfo, printSuccess, printError } = await import('../../cli-formatter.js');
+            const { ensureDaemon, isGlobalDaemonRunning } = await import('../../daemon/manager.js');
+            if (isGlobalDaemonRunning()) {
+                printInfo('Daemon is already running.');
+                return;
+            }
+            await ensureDaemon(false);
+            printSuccess('Daemon started.');
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(`Failed to start daemon: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    daemonCmd
+        .command('stop')
+        .description('Stop the running daemon')
+        .action(async () => {
+        try {
+            const { printInfo, printSuccess, printError } = await import('../../cli-formatter.js');
+            const { stopGlobalDaemon, isGlobalDaemonRunning } = await import('../../daemon/manager.js');
+            if (!isGlobalDaemonRunning()) {
+                printInfo('Daemon is not running.');
+                return;
+            }
+            stopGlobalDaemon();
+            printSuccess('Daemon stopped.');
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(`Failed to stop daemon: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    daemonCmd
+        .command('restart')
+        .description('Restart the daemon')
+        .action(async () => {
+        try {
+            const { printSuccess, printError } = await import('../../cli-formatter.js');
+            const { restartGlobalDaemon } = await import('../../daemon/manager.js');
+            await restartGlobalDaemon();
+            printSuccess('Daemon restarted.');
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(`Failed to restart daemon: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    daemonCmd
+        .command('status')
+        .description('Show daemon status and health info')
+        .action(async () => {
+        try {
+            const { printInfo, printSuccess, printError } = await import('../../cli-formatter.js');
+            const { isGlobalDaemonRunning, GLOBAL_PID_FILE, GLOBAL_LOG_FILE } = await import('../../daemon/manager.js');
+            const running = isGlobalDaemonRunning();
+            if (running) {
+                const { readFileSync, existsSync } = await import('fs');
+                const pid = existsSync(GLOBAL_PID_FILE)
+                    ? readFileSync(GLOBAL_PID_FILE, 'utf-8').trim()
+                    : 'unknown';
+                printSuccess(`Daemon is running (PID ${pid})`);
+                console.log(`  Log: ${GLOBAL_LOG_FILE}`);
+                // Query daemon for health info
+                const { queryDaemonStatus } = await import('../../daemon/client.js');
+                const health = await queryDaemonStatus();
+                if (health) {
+                    const uptimeSec = Math.round(health.uptime);
+                    const hours = Math.floor(uptimeSec / 3600);
+                    const mins = Math.floor((uptimeSec % 3600) / 60);
+                    const uptimeStr = hours > 0 ? `${hours}h ${mins}m` : `${mins}m`;
+                    console.log(`  Uptime: ${uptimeStr}`);
+                    console.log(`  Memory: ${health.memoryMB} MB`);
+                    console.log(`  Sessions: ${health.sessions}`);
+                    console.log(`  Photons loaded: ${health.photonsLoaded}`);
+                }
+            }
+            else {
+                printInfo('Daemon is not running.');
+            }
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(`Failed to check daemon status: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/cli/commands/daemon.js.map

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

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Doctor CLI Command
+ *
+ * Run diagnostics on the photon environment, ports, and per-photon configuration.
+ */
+import type { Command } from 'commander';
+/**
+ * Register the `doctor` command.
+ *
+ * Runs environment diagnostics: Node version, npm, working directory, cache,
+ * port availability, marketplace configuration, and optional per-photon checks.
+ */
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwM5D"}