@portel/photon 1.1.0 → 1.3.0

package/dist/daemon/protocol.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Daemon Protocol Types
+ *
+ * Defines message types for IPC communication between CLI client and daemon server
+ */
+/**
+ * Message from CLI client to daemon server
+ */
+export interface DaemonRequest {
+    type: 'command' | 'ping' | 'shutdown';
+    id: string;
+    sessionId?: string;
+    clientType?: 'cli' | 'mcp' | 'code-mode';
+    method?: string;
+    args?: Record<string, any>;
+}
+/**
+ * Response from daemon server to CLI client
+ */
+export interface DaemonResponse {
+    type: 'result' | 'error' | 'pong';
+    id: string;
+    success?: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Daemon status information
+ */
+export interface DaemonStatus {
+    running: boolean;
+    pid?: number;
+    startTime?: number;
+    lastActivity?: number;
+    photonName: string;
+    activeSessions?: number;
+}
+/**
+ * Session information
+ */
+export interface PhotonSession {
+    id: string;
+    instance: any;
+    createdAt: number;
+    lastActivity: number;
+    clientType?: string;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/daemon/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/daemon/protocol.js

@@ -0,0 +1,7 @@
+/**
+ * Daemon Protocol Types
+ *
+ * Defines message types for IPC communication between CLI client and daemon server
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/daemon/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/daemon/server.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Daemon Server
+ *
+ * Runs as a background process for stateful photons
+ * - Loads and initializes the photon
+ * - Listens on Unix socket / named pipe
+ * - Handles command requests
+ * - Manages idle timeout and shutdown
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/daemon/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/daemon/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/daemon/server.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+/**
+ * Daemon Server
+ *
+ * Runs as a background process for stateful photons
+ * - Loads and initializes the photon
+ * - Listens on Unix socket / named pipe
+ * - Handles command requests
+ * - Manages idle timeout and shutdown
+ */
+import * as net from 'net';
+import * as fs from 'fs';
+import { SessionManager } from './session-manager.js';
+// Command line args: photonName photonPath socketPath
+const photonName = process.argv[2];
+const photonPath = process.argv[3];
+const socketPath = process.argv[4];
+if (!photonName || !photonPath || !socketPath) {
+    console.error('[daemon-server] Missing required arguments');
+    process.exit(1);
+}
+let sessionManager = null;
+let idleTimeout = 600000; // 10 minutes default
+let idleTimer = null;
+/**
+ * Initialize session manager
+ */
+async function initializeSessionManager() {
+    try {
+        console.error(`[daemon-server] Initializing session manager for: ${photonName}`);
+        sessionManager = new SessionManager(photonPath, photonName, idleTimeout);
+        console.error(`[daemon-server] Session manager initialized`);
+        console.error(`[daemon-server] Session timeout: ${idleTimeout}ms`);
+        // Start idle timer if timeout is set
+        if (idleTimeout > 0) {
+            startIdleTimer();
+        }
+    }
+    catch (error) {
+        console.error(`[daemon-server] Failed to initialize session manager: ${error.message}`);
+        process.exit(1);
+    }
+}
+/**
+ * Start idle timer
+ */
+function startIdleTimer() {
+    if (idleTimer) {
+        clearTimeout(idleTimer);
+    }
+    if (idleTimeout <= 0) {
+        return; // Idle timeout disabled
+    }
+    idleTimer = setTimeout(() => {
+        if (!sessionManager)
+            return;
+        const lastActivity = sessionManager.getLastActivity();
+        const idleTime = Date.now() - lastActivity;
+        if (idleTime >= idleTimeout) {
+            console.error(`[daemon-server] Idle timeout reached (${idleTime}ms). Shutting down.`);
+            shutdown();
+        }
+        else {
+            // Restart timer with remaining time
+            startIdleTimer();
+        }
+    }, idleTimeout);
+}
+/**
+ * Reset idle timer (called on each activity)
+ */
+function resetIdleTimer() {
+    startIdleTimer();
+}
+/**
+ * Handle incoming command request
+ */
+async function handleRequest(request) {
+    resetIdleTimer();
+    if (request.type === 'ping') {
+        return {
+            type: 'pong',
+            id: request.id,
+        };
+    }
+    if (request.type === 'shutdown') {
+        shutdown();
+        return {
+            type: 'result',
+            id: request.id,
+            success: true,
+            data: { message: 'Shutting down' },
+        };
+    }
+    if (request.type === 'command') {
+        if (!request.method) {
+            return {
+                type: 'error',
+                id: request.id,
+                error: 'Method name required',
+            };
+        }
+        if (!sessionManager) {
+            return {
+                type: 'error',
+                id: request.id,
+                error: 'Session manager not initialized',
+            };
+        }
+        try {
+            // Get or create session for this client
+            const session = await sessionManager.getOrCreateSession(request.sessionId, request.clientType);
+            console.error(`[daemon-server] Executing: ${request.method} (session: ${session.id})`);
+            // Execute method on session's photon instance using loader
+            const result = await sessionManager.loader.executeTool(session.instance, request.method, request.args || {});
+            return {
+                type: 'result',
+                id: request.id,
+                success: true,
+                data: result,
+            };
+        }
+        catch (error) {
+            console.error(`[daemon-server] Error executing ${request.method}: ${error.message}`);
+            return {
+                type: 'error',
+                id: request.id,
+                error: error.message,
+            };
+        }
+    }
+    return {
+        type: 'error',
+        id: request.id,
+        error: `Unknown request type: ${request.type}`,
+    };
+}
+/**
+ * Start IPC server
+ */
+function startServer() {
+    const server = net.createServer((socket) => {
+        console.error('[daemon-server] Client connected');
+        let buffer = '';
+        socket.on('data', async (chunk) => {
+            buffer += chunk.toString();
+            // Process complete JSON messages (newline-delimited)
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || ''; // Keep incomplete line in buffer
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const request = JSON.parse(line);
+                    const response = await handleRequest(request);
+                    socket.write(JSON.stringify(response) + '\n');
+                }
+                catch (error) {
+                    console.error(`[daemon-server] Error processing request: ${error.message}`);
+                    socket.write(JSON.stringify({
+                        type: 'error',
+                        id: 'unknown',
+                        error: error.message,
+                    }) + '\n');
+                }
+            }
+        });
+        socket.on('end', () => {
+            console.error('[daemon-server] Client disconnected');
+        });
+        socket.on('error', (error) => {
+            console.error(`[daemon-server] Socket error: ${error.message}`);
+        });
+    });
+    server.listen(socketPath, () => {
+        console.error(`[daemon-server] Listening on ${socketPath}`);
+        console.error(`[daemon-server] PID: ${process.pid}`);
+    });
+    server.on('error', (error) => {
+        console.error(`[daemon-server] Server error: ${error.message}`);
+        process.exit(1);
+    });
+    // Graceful shutdown handlers
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+}
+/**
+ * Shutdown daemon
+ */
+function shutdown() {
+    console.error('[daemon-server] Shutting down...');
+    if (idleTimer) {
+        clearTimeout(idleTimer);
+    }
+    // Destroy session manager
+    if (sessionManager) {
+        sessionManager.destroy();
+    }
+    // Clean up socket file (Unix only)
+    if (fs.existsSync(socketPath) && process.platform !== 'win32') {
+        try {
+            fs.unlinkSync(socketPath);
+        }
+        catch (error) {
+            // Ignore cleanup errors
+        }
+    }
+    process.exit(0);
+}
+// Main execution
+(async () => {
+    await initializeSessionManager();
+    startServer();
+})();
+//# sourceMappingURL=server.js.map

package/dist/daemon/server.js.map

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

package/dist/daemon/session-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Session Manager
+ *
+ * Manages isolated photon instances per client session
+ * Handles session lifecycle, cleanup, and resource management
+ */
+import { PhotonLoader } from '../loader.js';
+import { PhotonSession } from './protocol.js';
+export declare class SessionManager {
+    private sessions;
+    private photonPath;
+    private photonName;
+    loader: PhotonLoader;
+    private sessionTimeout;
+    private cleanupInterval;
+    constructor(photonPath: string, photonName: string, sessionTimeout?: number);
+    /**
+     * Get or create a session
+     */
+    getOrCreateSession(sessionId: string | undefined, clientType?: string): Promise<PhotonSession>;
+    /**
+     * Get session count
+     */
+    getSessionCount(): number;
+    /**
+     * Get all sessions (for debugging)
+     */
+    getSessions(): PhotonSession[];
+    /**
+     * Clean up idle sessions
+     */
+    private cleanup;
+    /**
+     * Start periodic cleanup
+     */
+    private startCleanup;
+    /**
+     * Stop cleanup and destroy all sessions
+     */
+    destroy(): void;
+    /**
+     * Get last activity time across all sessions
+     */
+    getLastActivity(): number;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/daemon/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/daemon/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IACpB,MAAM,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,GAAE,MAAe;IAUnF;;OAEG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiCpG;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;IAI9B;;OAEG;IACH,OAAO,CAAC,OAAO;IAuBf;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,IAAI,IAAI;IAUf;;OAEG;IACH,eAAe,IAAI,MAAM;CAS1B"}

package/dist/daemon/session-manager.js

@@ -0,0 +1,120 @@
+/**
+ * Session Manager
+ *
+ * Manages isolated photon instances per client session
+ * Handles session lifecycle, cleanup, and resource management
+ */
+import { PhotonLoader } from '../loader.js';
+const DEFAULT_SESSION_ID = 'default';
+export class SessionManager {
+    sessions = new Map();
+    photonPath;
+    photonName;
+    loader; // Public to allow executeTool access
+    sessionTimeout;
+    cleanupInterval = null;
+    constructor(photonPath, photonName, sessionTimeout = 600000) {
+        this.photonPath = photonPath;
+        this.photonName = photonName;
+        this.sessionTimeout = sessionTimeout;
+        this.loader = new PhotonLoader(false); // verbose = false
+        // Start periodic cleanup
+        this.startCleanup();
+    }
+    /**
+     * Get or create a session
+     */
+    async getOrCreateSession(sessionId, clientType) {
+        const id = sessionId || DEFAULT_SESSION_ID;
+        if (this.sessions.has(id)) {
+            const session = this.sessions.get(id);
+            session.lastActivity = Date.now();
+            return session;
+        }
+        // Create new session
+        console.error(`[session-manager] Creating new session: ${id} (${clientType || 'unknown'})`);
+        try {
+            const instance = await this.loader.loadFile(this.photonPath);
+            const session = {
+                id,
+                instance,
+                createdAt: Date.now(),
+                lastActivity: Date.now(),
+                clientType
+            };
+            this.sessions.set(id, session);
+            console.error(`[session-manager] Session created. Active sessions: ${this.sessions.size}`);
+            return session;
+        }
+        catch (error) {
+            console.error(`[session-manager] Failed to create session: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Get session count
+     */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Get all sessions (for debugging)
+     */
+    getSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Clean up idle sessions
+     */
+    cleanup() {
+        const now = Date.now();
+        const expiredSessions = [];
+        for (const [id, session] of this.sessions) {
+            const idleTime = now - session.lastActivity;
+            if (idleTime > this.sessionTimeout) {
+                console.error(`[session-manager] Session ${id} expired (idle ${idleTime}ms)`);
+                expiredSessions.push(id);
+            }
+        }
+        // Remove expired sessions
+        for (const id of expiredSessions) {
+            this.sessions.delete(id);
+        }
+        if (expiredSessions.length > 0) {
+            console.error(`[session-manager] Cleaned up ${expiredSessions.length} sessions. Active: ${this.sessions.size}`);
+        }
+    }
+    /**
+     * Start periodic cleanup
+     */
+    startCleanup() {
+        // Run cleanup every minute
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 60000);
+    }
+    /**
+     * Stop cleanup and destroy all sessions
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        console.error(`[session-manager] Destroying ${this.sessions.size} active sessions`);
+        this.sessions.clear();
+    }
+    /**
+     * Get last activity time across all sessions
+     */
+    getLastActivity() {
+        let latest = 0;
+        for (const session of this.sessions.values()) {
+            if (session.lastActivity > latest) {
+                latest = session.lastActivity;
+            }
+        }
+        return latest;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/daemon/session-manager.js.map

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

package/dist/photon-cli-runner.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Photon CLI Runner
+ *
+ * Allows direct invocation of Photon methods from the command line
+ * Example: photon cli lg-remote discover
+ */
+/**
+ * List all methods in a photon (standard CLI help format)
+ */
+export declare function listMethods(photonName: string): Promise<void>;
+/**
+ * Run a photon method from CLI
+ */
+export declare function runMethod(photonName: string, methodName: string, args: string[]): Promise<void>;
+//# sourceMappingURL=photon-cli-runner.d.ts.map

package/dist/photon-cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-cli-runner.d.ts","sourceRoot":"","sources":["../src/photon-cli-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmtBH;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAmIf"}