crewly 1.13.0 → 1.14.0

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

@@ -0,0 +1,334 @@
+import * as path from 'path';
+import { spawn } from 'child_process';
+import { RuntimeAgentService } from './runtime-agent.service.abstract.js';
+import { RUNTIME_TYPES, CLAUDE_FATAL_PATTERNS } from '../../constants.js';
+import { delay } from '../../utils/async.utils.js';
+/**
+ * Claude Code specific runtime service implementation.
+ * Handles Claude Code CLI initialization, detection, and interaction patterns.
+ */
+export class ClaudeRuntimeService extends RuntimeAgentService {
+    constructor(sessionHelper, projectRoot) {
+        super(sessionHelper, projectRoot);
+    }
+    getRuntimeType() {
+        return RUNTIME_TYPES.CLAUDE_CODE;
+    }
+    /**
+     * Claude Code specific detection using slash command
+     */
+    async detectRuntimeSpecific(sessionName) {
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // First to clear the current command
+        await this.sessionHelper.clearCurrentCommandLine(sessionName);
+        // Capture the output before checking
+        const beforeOutput = this.sessionHelper.capturePane(sessionName, 20);
+        // Send the '/' key to detect changes
+        await this.sessionHelper.sendKey(sessionName, '/');
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+        // Capture the output after sending '/'
+        const afterOutput = this.sessionHelper.capturePane(sessionName, 20);
+        // Exit the slash command palette without issuing another Ctrl+C so we
+        // don't send consecutive interrupts that can terminate the CLI.
+        await this.sessionHelper.sendEscape(sessionName);
+        await delay(200);
+        await this.sessionHelper.sendKey(sessionName, 'C-u');
+        const hasOutputChange = afterOutput.length - beforeOutput.length > 5;
+        this.logger.debug('Claude detection completed', {
+            sessionName,
+            hasOutputChange,
+            beforeLength: beforeOutput.length,
+            afterLength: afterOutput.length,
+        });
+        return hasOutputChange;
+    }
+    /**
+     * Detect the Claude Code workspace trust prompt in terminal output.
+     *
+     * Claude Code shows "Is this a project you trust?" on first launch
+     * for untrusted workspaces. This blocks agent initialization.
+     *
+     * @param output - Terminal output text
+     * @returns True if trust prompt is detected
+     * @see https://github.com/stevehuang0115/crewly/issues/144
+     */
+    isClaudeTrustPrompt(output) {
+        const trustPatterns = [
+            'Do you trust the files',
+            'Is this a project you trust',
+            'Yes, proceed',
+            'Trust this folder',
+            'trust this project',
+        ];
+        return trustPatterns.some(p => output.includes(p));
+    }
+    /**
+     * Override waitForRuntimeReady to auto-accept workspace trust prompt (#144).
+     *
+     * Claude Code shows an interactive trust gate on first launch for
+     * untrusted workspaces. Without auto-acceptance, the agent hangs
+     * and enters a crash-restart loop.
+     */
+    async waitForRuntimeReady(sessionName, timeout, checkInterval = 2000) {
+        const startTime = Date.now();
+        let trustPromptAttempts = 0;
+        this.logger.info('Waiting for Claude Code to be ready (with trust prompt detection)', {
+            sessionName,
+            timeout,
+            checkInterval,
+        });
+        while (Date.now() - startTime < timeout) {
+            try {
+                const output = this.sessionHelper.capturePane(sessionName);
+                // #144: Auto-accept workspace trust prompt
+                if (this.isClaudeTrustPrompt(output)) {
+                    trustPromptAttempts++;
+                    this.logger.info('Claude Code trust prompt detected, auto-accepting', {
+                        sessionName,
+                        attempt: trustPromptAttempts,
+                    });
+                    await this.sessionHelper.sendEnter(sessionName);
+                    await delay(1000);
+                    continue;
+                }
+                const readyPatterns = this.getRuntimeReadyPatterns();
+                const hasReadySignal = readyPatterns.some(p => output.includes(p));
+                if (hasReadySignal) {
+                    this.logger.info('Claude Code ready', {
+                        sessionName,
+                        totalElapsed: Date.now() - startTime,
+                        trustPromptAttempts,
+                    });
+                    return true;
+                }
+                const errorPatterns = this.getRuntimeErrorPatterns();
+                const hasError = errorPatterns.some(p => output.includes(p));
+                if (hasError) {
+                    this.logger.error('Claude Code error during startup', {
+                        sessionName,
+                        totalElapsed: Date.now() - startTime,
+                    });
+                    return false;
+                }
+            }
+            catch (error) {
+                this.logger.warn('Error checking Claude Code ready state', {
+                    sessionName,
+                    error: String(error),
+                });
+            }
+            await delay(checkInterval);
+        }
+        this.logger.warn('Timeout waiting for Claude Code', { sessionName, timeout });
+        return false;
+    }
+    /**
+     * Claude Code specific ready patterns
+     */
+    getRuntimeReadyPatterns() {
+        return [
+            'Welcome to Claude Code!',
+            'claude-code>',
+            'Ready to assist',
+            'How can I help',
+            '/help for help',
+            'cwd:',
+            'bypass permissions on',
+            '✻ Welcome to Claude',
+        ];
+    }
+    /**
+     * Claude Code specific exit patterns for runtime exit detection.
+     *
+     * Includes both clean exit patterns (e.g. "Claude Code exited") and
+     * fatal error patterns that indicate the CLI is stuck in an unrecoverable
+     * state (e.g. thinking block corruption).
+     *
+     * @returns Array of RegExp patterns that match runtime exit or fatal output
+     */
+    getRuntimeExitPatterns() {
+        return [
+            // Clean exit patterns
+            /Claude\s+(Code\s+)?exited/i,
+            /Session\s+ended/i,
+            // Fatal error patterns — CLI is running but permanently broken
+            ...CLAUDE_FATAL_PATTERNS,
+        ];
+    }
+    /**
+     * Claude Code specific error patterns
+     */
+    getRuntimeErrorPatterns() {
+        const commonErrors = ['Permission denied', 'No such file or directory'];
+        return [...commonErrors, 'command not found: claude'];
+    }
+    /**
+     * Check if Claude Code CLI is installed on the system
+     */
+    async checkClaudeInstallation() {
+        try {
+            return new Promise((resolve) => {
+                const whichProcess = spawn('which', ['claude']);
+                let stdout = '';
+                let stderr = '';
+                whichProcess.stdout.on('data', (data) => {
+                    stdout += data.toString();
+                });
+                whichProcess.stderr.on('data', (data) => {
+                    stderr += data.toString();
+                });
+                whichProcess.on('close', (code) => {
+                    if (code === 0 && stdout.trim()) {
+                        // Claude CLI found, try to get version
+                        const versionProcess = spawn('claude', ['--version']);
+                        let versionOutput = '';
+                        versionProcess.stdout.on('data', (data) => {
+                            versionOutput += data.toString();
+                        });
+                        versionProcess.on('close', (versionCode) => {
+                            resolve({
+                                installed: true,
+                                version: versionCode === 0 ? versionOutput.trim() : 'unknown',
+                                message: 'Claude Code CLI is available',
+                            });
+                        });
+                        // Timeout for version check
+                        setTimeout(() => {
+                            versionProcess.kill();
+                            resolve({
+                                installed: true,
+                                message: 'Claude Code CLI found but version check timed out',
+                            });
+                        }, 5000);
+                    }
+                    else {
+                        resolve({
+                            installed: false,
+                            message: 'Claude Code CLI not found. Please install Claude Code to enable agent functionality.',
+                        });
+                    }
+                });
+                // Timeout for which command
+                setTimeout(() => {
+                    whichProcess.kill();
+                    resolve({
+                        installed: false,
+                        message: 'Claude Code installation check timed out',
+                    });
+                }, 5000);
+            });
+        }
+        catch (error) {
+            return {
+                installed: false,
+                message: `Failed to check Claude installation: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    /**
+     * Initialize Claude in an existing session (legacy compatibility)
+     */
+    async initializeClaudeInSession(sessionName) {
+        try {
+            this.logger.info('Initializing Claude Code in session', { sessionName });
+            // Start Claude Code by sending Enter
+            await this.sessionHelper.sendEnter(sessionName);
+            // Wait for Claude to be ready
+            const isReady = await this.waitForRuntimeReady(sessionName, 45000);
+            if (isReady) {
+                this.logger.info('Claude Code initialized successfully', { sessionName });
+                return {
+                    success: true,
+                    message: 'Claude Code initialized and ready',
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    error: 'Claude Code failed to initialize within timeout',
+                };
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error('Failed to initialize Claude Code in session', {
+                sessionName,
+                error: errorMessage,
+            });
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Enhanced Claude detection using slash command with detailed analysis
+     * This is the legacy method that provides more detailed detection than the base detectRuntimeSpecific
+     */
+    async detectClaudeWithSlashCommand(sessionName, forceRefresh = false) {
+        // For now, delegate to the base detectRuntimeWithCommand method
+        // which calls our detectRuntimeSpecific implementation
+        return await this.detectRuntimeWithCommand(sessionName, forceRefresh);
+    }
+    /**
+     * Execute Claude initialization script (legacy compatibility)
+     */
+    async executeClaudeInitScript(sessionName, targetPath) {
+        return await this.executeRuntimeInitScript(sessionName, targetPath);
+    }
+    /**
+     * Post-initialization hook for Claude Code.
+     * Ensures MCP server configuration (e.g., playwright) is present in the project directory.
+     *
+     * @param sessionName - PTY session name
+     * @param targetProjectPath - Optional target project path for MCP config.
+     *                            Falls back to this.projectRoot if not provided.
+     */
+    async postInitialize(sessionName, targetProjectPath, _additionalAllowlistPaths, browserAutomationOverride) {
+        const effectiveProjectPath = targetProjectPath || this.projectRoot;
+        this.logger.info('Claude Code post-init: ensuring MCP config', {
+            sessionName,
+            projectRoot: this.projectRoot,
+            targetProjectPath: effectiveProjectPath,
+            browserAutomationOverride,
+        });
+        const result = await this.ensureClaudeMcpConfig(effectiveProjectPath, browserAutomationOverride);
+        // Health check: verify the config was written correctly
+        if (result.success && result.totalServers > 0) {
+            const mcpConfigPath = path.join(effectiveProjectPath, '.mcp.json');
+            const verified = await this.verifyMcpConfig(mcpConfigPath, result.serverNames);
+            if (verified) {
+                this.logger.info('MCP health check passed', {
+                    sessionName,
+                    servers: result.serverNames,
+                });
+            }
+            else {
+                this.logger.warn('MCP health check failed: config file does not match expected servers', {
+                    sessionName,
+                    expectedServers: result.serverNames,
+                });
+            }
+        }
+        else if (!result.success) {
+            this.logger.warn('MCP config setup failed during post-init', {
+                sessionName,
+                error: result.error,
+            });
+        }
+    }
+    /**
+     * Ensure Claude Code MCP server configuration exists in the project directory.
+     *
+     * Creates or merges `.mcp.json` with required MCP servers.
+     * Delegates to the shared `ensureMcpConfig` in the base class.
+     *
+     * @param projectPath - Project directory where `.mcp.json` will be created
+     * @returns Result of the MCP config operation
+     */
+    async ensureClaudeMcpConfig(projectPath, browserAutomationOverride) {
+        const mcpConfigPath = path.join(projectPath, '.mcp.json');
+        return await this.ensureMcpConfig(mcpConfigPath, projectPath, browserAutomationOverride);
+    }
+}
+//# sourceMappingURL=claude-runtime.service.js.map

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

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

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

@@ -0,0 +1,47 @@
+import { RuntimeAgentService } from './runtime-agent.service.abstract.js';
+import { SessionCommandHelper } from '../session/index.js';
+import { type RuntimeType } from '../../constants.js';
+/**
+ * OpenAI Codex CLI specific runtime service implementation.
+ * Handles Codex CLI initialization, detection, and interaction patterns.
+ */
+export declare class CodexRuntimeService extends RuntimeAgentService {
+    constructor(sessionHelper: SessionCommandHelper, projectRoot: string);
+    protected getRuntimeType(): RuntimeType;
+    /**
+     * Codex CLI runtime detection.
+     *
+     * NOTE: Do not use active key probes (Ctrl+C, '/', etc.) here. Codex can
+     * interpret those as shell input/cancel and drop back to zsh, which causes
+     * false negatives and unintended exits during health checks.
+     */
+    protected detectRuntimeSpecific(sessionName: string): Promise<boolean>;
+    /**
+     * Codex CLI specific ready patterns
+     */
+    protected getRuntimeReadyPatterns(): string[];
+    /**
+     * Codex CLI specific exit patterns for runtime exit detection
+     */
+    protected getRuntimeExitPatterns(): RegExp[];
+    /**
+     * Codex CLI specific error patterns
+     */
+    protected getRuntimeErrorPatterns(): string[];
+    /**
+     * Check if Codex CLI is installed and configured
+     */
+    checkCodexInstallation(): Promise<{
+        isInstalled: boolean;
+        version?: string;
+        message: string;
+    }>;
+    /**
+     * Initialize Codex in an existing session
+     */
+    initializeCodexInSession(sessionName: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=codex-runtime.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-runtime.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/codex-runtime.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB;gBAC/C,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM;IAIpE,SAAS,CAAC,cAAc,IAAI,WAAW;IAIvC;;;;;;OAMG;cACa,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa5E;;OAEG;IACH,SAAS,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAc7C;;OAEG;IACH,SAAS,CAAC,sBAAsB,IAAI,MAAM,EAAE;IAQ5C;;OAEG;IACH,SAAS,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAa7C;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC;QACvC,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;IAgBF;;OAEG;IACG,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5D,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CAiBF"}

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

@@ -0,0 +1,112 @@
+import { RuntimeAgentService } from './runtime-agent.service.abstract.js';
+import { RUNTIME_TYPES } from '../../constants.js';
+/**
+ * OpenAI Codex CLI specific runtime service implementation.
+ * Handles Codex CLI initialization, detection, and interaction patterns.
+ */
+export class CodexRuntimeService extends RuntimeAgentService {
+    constructor(sessionHelper, projectRoot) {
+        super(sessionHelper, projectRoot);
+    }
+    getRuntimeType() {
+        return RUNTIME_TYPES.CODEX_CLI;
+    }
+    /**
+     * Codex CLI runtime detection.
+     *
+     * NOTE: Do not use active key probes (Ctrl+C, '/', etc.) here. Codex can
+     * interpret those as shell input/cancel and drop back to zsh, which causes
+     * false negatives and unintended exits during health checks.
+     */
+    async detectRuntimeSpecific(sessionName) {
+        const output = this.sessionHelper.capturePane(sessionName, 120);
+        const readyPatterns = this.getRuntimeReadyPatterns();
+        const hasReadySignal = readyPatterns.some((pattern) => output.includes(pattern));
+        this.logger.debug('Codex detection completed', {
+            sessionName,
+            hasReadySignal,
+        });
+        return hasReadySignal;
+    }
+    /**
+     * Codex CLI specific ready patterns
+     */
+    getRuntimeReadyPatterns() {
+        return [
+            'Codex CLI',
+            'codex>',
+            'Ready for commands',
+            'OpenAI Codex',
+            'model:',
+            'token:',
+            'Connected to OpenAI',
+            'Welcome to Codex',
+            'Initialized successfully',
+        ];
+    }
+    /**
+     * Codex CLI specific exit patterns for runtime exit detection
+     */
+    getRuntimeExitPatterns() {
+        return [
+            /codex.*exited/i,
+            /Session\s+ended/i,
+            /Conversation interrupted/i,
+        ];
+    }
+    /**
+     * Codex CLI specific error patterns
+     */
+    getRuntimeErrorPatterns() {
+        const commonErrors = ['Permission denied', 'No such file or directory'];
+        return [
+            ...commonErrors,
+            'command not found: codex',
+            'OpenAI API error',
+            'Authentication failed',
+            'Invalid API key',
+            'Rate limit exceeded',
+            'Token limit exceeded',
+        ];
+    }
+    /**
+     * Check if Codex CLI is installed and configured
+     */
+    async checkCodexInstallation() {
+        try {
+            // This would check if Codex CLI is available
+            // Could run: codex --version or similar
+            return {
+                isInstalled: true,
+                message: 'OpenAI Codex CLI is available',
+            };
+        }
+        catch (error) {
+            return {
+                isInstalled: false,
+                message: 'OpenAI Codex CLI not found or not configured',
+            };
+        }
+    }
+    /**
+     * Initialize Codex in an existing session
+     */
+    async initializeCodexInSession(sessionName) {
+        try {
+            await this.executeRuntimeInitScript(sessionName);
+            return {
+                success: true,
+                message: 'OpenAI Codex CLI initialized successfully',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error
+                    ? error.message
+                    : 'Failed to initialize OpenAI Codex CLI',
+            };
+        }
+    }
+}
+//# sourceMappingURL=codex-runtime.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-runtime.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/codex-runtime.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AAErE;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,mBAAmB;IAC3D,YAAY,aAAmC,EAAE,WAAmB;QACnE,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC;IAES,cAAc;QACvB,OAAO,aAAa,CAAC,SAAS,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAChE,MAAM,aAAa,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACrD,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAEjF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;YAC9C,WAAW;YACX,cAAc;SACd,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC;IACvB,CAAC;IAED;;OAEG;IACO,uBAAuB;QAChC,OAAO;YACN,WAAW;YACX,QAAQ;YACR,oBAAoB;YACpB,cAAc;YACd,QAAQ;YACR,QAAQ;YACR,qBAAqB;YACrB,kBAAkB;YAClB,0BAA0B;SAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACO,sBAAsB;QAC/B,OAAO;YACN,gBAAgB;YAChB,kBAAkB;YAClB,2BAA2B;SAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACO,uBAAuB;QAChC,MAAM,YAAY,GAAG,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAAC;QACxE,OAAO;YACN,GAAG,YAAY;YACf,0BAA0B;YAC1B,kBAAkB;YAClB,uBAAuB;YACvB,iBAAiB;YACjB,qBAAqB;YACrB,sBAAsB;SACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB;QAK3B,IAAI,CAAC;YACJ,6CAA6C;YAC7C,wCAAwC;YACxC,OAAO;gBACN,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,+BAA+B;aACxC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,WAAW,EAAE,KAAK;gBAClB,OAAO,EAAE,8CAA8C;aACvD,CAAC;QACH,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB,CAAC,WAAmB;QAIjD,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;YACjD,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,2CAA2C;aACpD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,OAAO,EACN,KAAK,YAAY,KAAK;oBACrB,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC,uCAAuC;aAC3C,CAAC;QACH,CAAC;IACF,CAAC;CACD"}