crewly 1.0.0

package/dist/backend/backend/src/services/agent/runtime-exit-monitor.service.js

@@ -0,0 +1,284 @@
+import { LoggerService } from '../core/logger.service.js';
+import { StorageService } from '../core/storage.service.js';
+import { getSessionBackendSync, createSessionCommandHelper, } from '../session/index.js';
+import { RuntimeServiceFactory } from './runtime-service.factory.js';
+import { SessionMemoryService } from '../memory/session-memory.service.js';
+import { getTerminalGateway } from '../../websocket/terminal.gateway.js';
+import { SHELL_PROMPT_PATTERNS } from '../continuation/patterns/idle-patterns.js';
+import { CREWLY_CONSTANTS, ORCHESTRATOR_SESSION_NAME, RUNTIME_EXIT_CONSTANTS, } from '../../constants.js';
+/**
+ * Service that monitors PTY sessions for runtime exit patterns.
+ *
+ * When an agent CLI (Claude Code, Gemini CLI, Codex CLI) exits inside a PTY
+ * session, the PTY shell itself stays alive. This service watches terminal
+ * output for runtime-specific exit patterns and reacts by:
+ *
+ * 1. Updating the agent status to `inactive`
+ * 2. Capturing session memory
+ * 3. Broadcasting WebSocket events to the frontend
+ * 4. Cancelling pending registration operations
+ *
+ * @example
+ * ```typescript
+ * const monitor = RuntimeExitMonitorService.getInstance();
+ * monitor.startMonitoring('agent-dev-001', 'claude-code', 'developer');
+ * // ... later ...
+ * monitor.stopMonitoring('agent-dev-001');
+ * ```
+ */
+export class RuntimeExitMonitorService {
+    static instance = null;
+    logger;
+    sessions = new Map();
+    onExitDetectedCallback;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('RuntimeExitMonitorService');
+    }
+    /**
+     * Get the singleton instance.
+     */
+    static getInstance() {
+        if (!RuntimeExitMonitorService.instance) {
+            RuntimeExitMonitorService.instance = new RuntimeExitMonitorService();
+        }
+        return RuntimeExitMonitorService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        if (RuntimeExitMonitorService.instance) {
+            RuntimeExitMonitorService.instance.destroy();
+        }
+        RuntimeExitMonitorService.instance = null;
+    }
+    /**
+     * Register a callback invoked when a runtime exit is detected.
+     * Used by AgentRegistrationService to cancel pending registrations.
+     *
+     * @param callback - Called with the sessionName on exit detection
+     */
+    setOnExitDetectedCallback(callback) {
+        this.onExitDetectedCallback = callback;
+    }
+    /**
+     * Start monitoring a PTY session for runtime exit patterns.
+     *
+     * @param sessionName - PTY session name
+     * @param runtimeType - Agent runtime type (claude-code, gemini-cli, codex-cli)
+     * @param role - Agent role name
+     * @param teamId - Optional team identifier
+     * @param memberId - Optional member identifier
+     */
+    startMonitoring(sessionName, runtimeType, role, teamId, memberId) {
+        // Stop any existing monitoring for this session
+        if (this.sessions.has(sessionName)) {
+            this.stopMonitoring(sessionName);
+        }
+        const backend = getSessionBackendSync();
+        if (!backend) {
+            this.logger.warn('Cannot start monitoring: session backend not initialized', { sessionName });
+            return;
+        }
+        const helper = createSessionCommandHelper(backend);
+        const session = helper.getSession(sessionName);
+        if (!session) {
+            this.logger.warn('Cannot start monitoring: session not found', { sessionName });
+            return;
+        }
+        const monitored = {
+            sessionName,
+            runtimeType,
+            role,
+            memberId,
+            teamId,
+            buffer: '',
+            startedAt: Date.now(),
+            exitDetected: false,
+            unsubscribe: () => { },
+        };
+        // Get exit patterns for this runtime type
+        let exitPatterns;
+        try {
+            const runtimeService = RuntimeServiceFactory.create(runtimeType, null, process.cwd());
+            exitPatterns = runtimeService.getExitPatterns();
+        }
+        catch {
+            this.logger.warn('Failed to get exit patterns, using empty set', { sessionName, runtimeType });
+            exitPatterns = [];
+        }
+        if (exitPatterns.length === 0) {
+            this.logger.debug('No exit patterns for runtime, skipping monitoring', { sessionName, runtimeType });
+            return;
+        }
+        // Subscribe to PTY output
+        const unsubscribe = session.onData((data) => {
+            this.handleData(sessionName, data, exitPatterns, helper);
+        });
+        monitored.unsubscribe = unsubscribe;
+        this.sessions.set(sessionName, monitored);
+        this.logger.info('Started runtime exit monitoring', {
+            sessionName,
+            runtimeType,
+            role,
+            patternCount: exitPatterns.length,
+        });
+    }
+    /**
+     * Stop monitoring a PTY session.
+     *
+     * @param sessionName - PTY session name
+     */
+    stopMonitoring(sessionName) {
+        const monitored = this.sessions.get(sessionName);
+        if (!monitored) {
+            return;
+        }
+        if (monitored.debounceTimer) {
+            clearTimeout(monitored.debounceTimer);
+        }
+        monitored.unsubscribe();
+        this.sessions.delete(sessionName);
+        this.logger.debug('Stopped runtime exit monitoring', { sessionName });
+    }
+    /**
+     * Check if a session is being monitored.
+     */
+    isMonitoring(sessionName) {
+        return this.sessions.has(sessionName);
+    }
+    /**
+     * Destroy all monitoring subscriptions.
+     */
+    destroy() {
+        for (const [sessionName] of this.sessions) {
+            this.stopMonitoring(sessionName);
+        }
+        this.logger.debug('All runtime exit monitors destroyed');
+    }
+    /**
+     * Handle incoming PTY data for a monitored session.
+     */
+    handleData(sessionName, data, exitPatterns, helper) {
+        const monitored = this.sessions.get(sessionName);
+        if (!monitored || monitored.exitDetected) {
+            return;
+        }
+        // Append to rolling buffer, cap at MAX_BUFFER_SIZE
+        monitored.buffer += data;
+        if (monitored.buffer.length > RUNTIME_EXIT_CONSTANTS.MAX_BUFFER_SIZE) {
+            monitored.buffer = monitored.buffer.slice(-RUNTIME_EXIT_CONSTANTS.MAX_BUFFER_SIZE);
+        }
+        // Skip pattern matching during startup grace period
+        if (Date.now() - monitored.startedAt < RUNTIME_EXIT_CONSTANTS.STARTUP_GRACE_PERIOD_MS) {
+            return;
+        }
+        // Test buffer against exit patterns
+        const matched = exitPatterns.some((pattern) => pattern.test(monitored.buffer));
+        if (!matched) {
+            return;
+        }
+        // Pattern matched — start debounce timer to confirm
+        if (monitored.debounceTimer) {
+            clearTimeout(monitored.debounceTimer);
+        }
+        monitored.debounceTimer = setTimeout(() => {
+            this.confirmAndReact(sessionName, helper);
+        }, RUNTIME_EXIT_CONSTANTS.CONFIRMATION_DELAY_MS);
+    }
+    /**
+     * Confirm exit by checking for a shell prompt, then react.
+     */
+    async confirmAndReact(sessionName, helper) {
+        const monitored = this.sessions.get(sessionName);
+        if (!monitored || monitored.exitDetected) {
+            return;
+        }
+        // Verify shell prompt is visible (avoids false positives)
+        if (!this.verifyExitWithShellPrompt(sessionName, helper)) {
+            this.logger.debug('Exit pattern matched but shell prompt not confirmed, ignoring', { sessionName });
+            return;
+        }
+        // Mark as detected to prevent double-processing
+        monitored.exitDetected = true;
+        this.logger.info('Runtime exit detected and confirmed', {
+            sessionName,
+            runtimeType: monitored.runtimeType,
+            role: monitored.role,
+        });
+        // Fire the exit-detected callback (used to cancel pending registrations)
+        if (this.onExitDetectedCallback) {
+            try {
+                this.onExitDetectedCallback(sessionName);
+            }
+            catch (error) {
+                this.logger.warn('onExitDetected callback error', {
+                    sessionName,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        // Update agent status to inactive
+        try {
+            const storageService = StorageService.getInstance();
+            await storageService.updateAgentStatus(sessionName, CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE);
+            this.logger.info('Agent status updated to inactive after runtime exit', { sessionName });
+        }
+        catch (error) {
+            this.logger.warn('Failed to update agent status after runtime exit', {
+                sessionName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        // Capture session memory
+        try {
+            const sessionMemoryService = SessionMemoryService.getInstance();
+            await sessionMemoryService.onSessionEnd(sessionName, monitored.role, process.cwd());
+        }
+        catch (error) {
+            this.logger.warn('Failed to capture session memory after runtime exit', {
+                sessionName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        // Broadcast WebSocket event
+        try {
+            const terminalGateway = getTerminalGateway();
+            if (terminalGateway) {
+                const statusPayload = {
+                    sessionName,
+                    status: CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE,
+                    reason: 'runtime_exited',
+                };
+                if (sessionName === ORCHESTRATOR_SESSION_NAME) {
+                    terminalGateway.broadcastOrchestratorStatus(statusPayload);
+                }
+                else {
+                    terminalGateway.broadcastTeamMemberStatus(statusPayload);
+                }
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to broadcast runtime exit event', {
+                sessionName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        // Cleanup this subscription
+        this.stopMonitoring(sessionName);
+    }
+    /**
+     * Verify that a shell prompt is visible in the terminal, confirming
+     * that the agent CLI has actually exited and returned to the shell.
+     */
+    verifyExitWithShellPrompt(sessionName, helper) {
+        try {
+            const output = helper.capturePane(sessionName);
+            return SHELL_PROMPT_PATTERNS.some((pattern) => pattern.test(output));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=runtime-exit-monitor.service.js.map

package/dist/backend/backend/src/services/agent/runtime-exit-monitor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-exit-monitor.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/runtime-exit-monitor.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/agent/runtime-service.factory.d.ts

@@ -0,0 +1,71 @@
+import { RuntimeAgentService } from './runtime-agent.service.abstract.js';
+import { SessionCommandHelper } from '../session/index.js';
+import { type RuntimeType } from '../../constants.js';
+/**
+ * Factory for creating runtime-specific service instances.
+ * Implements factory pattern to encapsulate runtime service creation logic.
+ */
+export declare class RuntimeServiceFactory {
+    private static instanceCache;
+    private static sessionHelperCache;
+    private static logger;
+    /**
+     * Get or create a SessionCommandHelper, using lazy initialization.
+     * This is the recommended way to get the helper for runtime service creation.
+     */
+    private static getOrCreateSessionHelper;
+    /**
+     * Create a runtime service instance for the specified runtime type.
+     * Automatically gets or creates the SessionCommandHelper.
+     *
+     * @param runtimeType - The type of runtime to create
+     * @param _legacyParam - Ignored legacy parameter for backwards compatibility
+     * @param projectRoot - The project root directory
+     */
+    static create(runtimeType: RuntimeType, _legacyParam: unknown, projectRoot: string): RuntimeAgentService;
+    /**
+     * Create a runtime service without caching (for testing or special cases).
+     * Automatically gets or creates the SessionCommandHelper.
+     *
+     * @param runtimeType - The type of runtime to create
+     * @param _legacyParam - Ignored legacy parameter for backwards compatibility
+     * @param projectRoot - The project root directory
+     */
+    static createFresh(runtimeType: RuntimeType, _legacyParam: unknown, projectRoot: string): RuntimeAgentService;
+    /**
+     * Get available runtime types
+     */
+    static getAvailableRuntimeTypes(): RuntimeType[];
+    /**
+     * Clear cached instances (useful for testing or when configuration changes)
+     */
+    static clearCache(): void;
+    /**
+     * Clear cached instance for a specific runtime type and project
+     */
+    static clearCacheFor(runtimeType: RuntimeType, projectRoot: string): void;
+    /**
+     * Get cached instance count (useful for debugging/monitoring)
+     */
+    static getCachedInstanceCount(): number;
+    /**
+     * Check if a runtime type is supported
+     */
+    static isRuntimeTypeSupported(runtimeType: string): runtimeType is RuntimeType;
+    /**
+     * Set a custom session helper for testing purposes.
+     * This allows injecting a mock SessionCommandHelper.
+     *
+     * @param sessionHelper - The session helper to use
+     */
+    static setSessionHelperForTesting(sessionHelper: SessionCommandHelper | null): void;
+    /**
+     * Create a runtime service with an explicit session helper (for testing).
+     *
+     * @param runtimeType - The type of runtime to create
+     * @param sessionHelper - The session helper to use
+     * @param projectRoot - The project root directory
+     */
+    static createWithHelper(runtimeType: RuntimeType, sessionHelper: SessionCommandHelper, projectRoot: string): RuntimeAgentService;
+}
+//# sourceMappingURL=runtime-service.factory.d.ts.map

package/dist/backend/backend/src/services/agent/runtime-service.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-service.factory.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/runtime-service.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAI1E,OAAO,EACN,oBAAoB,EAKpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGrE;;;GAGG;AACH,qBAAa,qBAAqB;IAEjC,OAAO,CAAC,MAAM,CAAC,aAAa,CAA+C;IAE3E,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAqC;IAEtE,OAAO,CAAC,MAAM,CAAC,MAAM,CAA+F;IAEpH;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAmBvC;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACZ,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,MAAM,GACjB,mBAAmB;IA0CtB;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CACjB,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,MAAM,GACjB,mBAAmB;IAoBtB;;OAEG;IACH,MAAM,CAAC,wBAAwB,IAAI,WAAW,EAAE;IAQhD;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAKzB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzE;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,MAAM;IAIvC;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,IAAI,WAAW;IAI9E;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,aAAa,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI;IAInF;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CACtB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,oBAAoB,EACnC,WAAW,EAAE,MAAM,GACjB,mBAAmB;CAgBtB"}

package/dist/backend/backend/src/services/agent/runtime-service.factory.js

@@ -0,0 +1,165 @@
+import { ClaudeRuntimeService } from './claude-runtime.service.js';
+import { GeminiRuntimeService } from './gemini-runtime.service.js';
+import { CodexRuntimeService } from './codex-runtime.service.js';
+import { createSessionCommandHelper, getSessionBackendSync, } from '../session/index.js';
+import { RUNTIME_TYPES } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+/**
+ * Factory for creating runtime-specific service instances.
+ * Implements factory pattern to encapsulate runtime service creation logic.
+ */
+export class RuntimeServiceFactory {
+    // Cache instances to avoid creating multiple services for the same runtime type
+    static instanceCache = new Map();
+    // Cache the session helper to reuse across runtime service creations
+    static sessionHelperCache = null;
+    // Logger for the factory
+    static logger = LoggerService.getInstance().createComponentLogger('RuntimeServiceFactory');
+    /**
+     * Get or create a SessionCommandHelper, using lazy initialization.
+     * This is the recommended way to get the helper for runtime service creation.
+     */
+    static getOrCreateSessionHelper() {
+        if (this.sessionHelperCache) {
+            return this.sessionHelperCache;
+        }
+        // Try to get existing backend first
+        let backend = getSessionBackendSync();
+        if (!backend) {
+            // This shouldn't happen in normal operation as backend should be initialized
+            // Throw an error to indicate initialization problem
+            throw new Error('Session backend not initialized. Call createSessionBackend() first.');
+        }
+        this.sessionHelperCache = createSessionCommandHelper(backend);
+        return this.sessionHelperCache;
+    }
+    /**
+     * Create a runtime service instance for the specified runtime type.
+     * Automatically gets or creates the SessionCommandHelper.
+     *
+     * @param runtimeType - The type of runtime to create
+     * @param _legacyParam - Ignored legacy parameter for backwards compatibility
+     * @param projectRoot - The project root directory
+     */
+    static create(runtimeType, _legacyParam, projectRoot) {
+        // Get the session helper (ignoring legacy parameter)
+        const sessionHelper = this.getOrCreateSessionHelper();
+        // Create a cache key that includes all constructor parameters
+        const cacheKey = `${runtimeType}-${projectRoot}`;
+        // Return cached instance if available
+        if (this.instanceCache.has(cacheKey)) {
+            const cachedInstance = this.instanceCache.get(cacheKey);
+            return cachedInstance;
+        }
+        // Create new instance based on runtime type
+        let runtimeService;
+        switch (runtimeType) {
+            case RUNTIME_TYPES.CLAUDE_CODE:
+                runtimeService = new ClaudeRuntimeService(sessionHelper, projectRoot);
+                break;
+            case RUNTIME_TYPES.GEMINI_CLI:
+                runtimeService = new GeminiRuntimeService(sessionHelper, projectRoot);
+                break;
+            case RUNTIME_TYPES.CODEX_CLI:
+                runtimeService = new CodexRuntimeService(sessionHelper, projectRoot);
+                break;
+            default:
+                // Fallback to Claude Code for unknown runtime types
+                this.logger.warn('Unknown runtime type, falling back to Claude Code', { runtimeType });
+                runtimeService = new ClaudeRuntimeService(sessionHelper, projectRoot);
+                break;
+        }
+        // Cache the instance
+        this.instanceCache.set(cacheKey, runtimeService);
+        return runtimeService;
+    }
+    /**
+     * Create a runtime service without caching (for testing or special cases).
+     * Automatically gets or creates the SessionCommandHelper.
+     *
+     * @param runtimeType - The type of runtime to create
+     * @param _legacyParam - Ignored legacy parameter for backwards compatibility
+     * @param projectRoot - The project root directory
+     */
+    static createFresh(runtimeType, _legacyParam, projectRoot) {
+        const sessionHelper = this.getOrCreateSessionHelper();
+        switch (runtimeType) {
+            case RUNTIME_TYPES.CLAUDE_CODE:
+                return new ClaudeRuntimeService(sessionHelper, projectRoot);
+            case RUNTIME_TYPES.GEMINI_CLI:
+                return new GeminiRuntimeService(sessionHelper, projectRoot);
+            case RUNTIME_TYPES.CODEX_CLI:
+                return new CodexRuntimeService(sessionHelper, projectRoot);
+            default:
+                // Fallback to Claude Code for unknown runtime types
+                this.logger.warn('Unknown runtime type, falling back to Claude Code', { runtimeType });
+                return new ClaudeRuntimeService(sessionHelper, projectRoot);
+        }
+    }
+    /**
+     * Get available runtime types
+     */
+    static getAvailableRuntimeTypes() {
+        return [
+            RUNTIME_TYPES.CLAUDE_CODE,
+            RUNTIME_TYPES.GEMINI_CLI,
+            RUNTIME_TYPES.CODEX_CLI,
+        ];
+    }
+    /**
+     * Clear cached instances (useful for testing or when configuration changes)
+     */
+    static clearCache() {
+        this.instanceCache.clear();
+        this.sessionHelperCache = null;
+    }
+    /**
+     * Clear cached instance for a specific runtime type and project
+     */
+    static clearCacheFor(runtimeType, projectRoot) {
+        const cacheKey = `${runtimeType}-${projectRoot}`;
+        this.instanceCache.delete(cacheKey);
+    }
+    /**
+     * Get cached instance count (useful for debugging/monitoring)
+     */
+    static getCachedInstanceCount() {
+        return this.instanceCache.size;
+    }
+    /**
+     * Check if a runtime type is supported
+     */
+    static isRuntimeTypeSupported(runtimeType) {
+        return this.getAvailableRuntimeTypes().includes(runtimeType);
+    }
+    /**
+     * Set a custom session helper for testing purposes.
+     * This allows injecting a mock SessionCommandHelper.
+     *
+     * @param sessionHelper - The session helper to use
+     */
+    static setSessionHelperForTesting(sessionHelper) {
+        this.sessionHelperCache = sessionHelper;
+    }
+    /**
+     * Create a runtime service with an explicit session helper (for testing).
+     *
+     * @param runtimeType - The type of runtime to create
+     * @param sessionHelper - The session helper to use
+     * @param projectRoot - The project root directory
+     */
+    static createWithHelper(runtimeType, sessionHelper, projectRoot) {
+        switch (runtimeType) {
+            case RUNTIME_TYPES.CLAUDE_CODE:
+                return new ClaudeRuntimeService(sessionHelper, projectRoot);
+            case RUNTIME_TYPES.GEMINI_CLI:
+                return new GeminiRuntimeService(sessionHelper, projectRoot);
+            case RUNTIME_TYPES.CODEX_CLI:
+                return new CodexRuntimeService(sessionHelper, projectRoot);
+            default:
+                this.logger.warn('Unknown runtime type, falling back to Claude Code', { runtimeType });
+                return new ClaudeRuntimeService(sessionHelper, projectRoot);
+        }
+    }
+}
+//# sourceMappingURL=runtime-service.factory.js.map

package/dist/backend/backend/src/services/agent/runtime-service.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-service.factory.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/runtime-service.factory.ts"],"names":[],"mappings":"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"}