crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/agent/pty-activity-tracker.service.js

@@ -0,0 +1,161 @@
+/**
+ * PTY Activity Tracker Service
+ *
+ * Lightweight singleton that tracks the last PTY output timestamp per session.
+ * Used by IdleDetectionService to determine when agents have been idle
+ * long enough to be suspended.
+ *
+ * @module pty-activity-tracker-service
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { stripAnsiCodes } from '../../utils/terminal-output.utils.js';
+import { PTY_CONSTANTS } from '../../constants.js';
+/**
+ * Tracks last PTY output timestamp per session for idle detection.
+ *
+ * This service is intentionally kept simple — it only records timestamps
+ * and answers idle-time queries. It does NOT subscribe to PTY events
+ * itself; the terminal gateway hooks into it via `recordActivity()`.
+ */
+export class PtyActivityTrackerService {
+    static instance = null;
+    logger;
+    /** Map of session name to last activity timestamp (epoch ms) — includes both PTY and API */
+    lastActivityMap = new Map();
+    /** Map of session name to last API-only activity timestamp (epoch ms) */
+    lastApiActivityMap = new Map();
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('PtyActivityTracker');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The PtyActivityTrackerService singleton
+     */
+    static getInstance() {
+        if (!PtyActivityTrackerService.instance) {
+            PtyActivityTrackerService.instance = new PtyActivityTrackerService();
+        }
+        return PtyActivityTrackerService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        PtyActivityTrackerService.instance = null;
+    }
+    /**
+     * Record PTY activity for a session.
+     * Called by the terminal gateway whenever PTY data is received.
+     *
+     * @param sessionName - The session that produced output
+     */
+    recordActivity(sessionName) {
+        this.lastActivityMap.set(sessionName, Date.now());
+    }
+    /**
+     * Record API-specific activity for a session.
+     * Called by the agent heartbeat middleware when an actual API call is made.
+     * Also records general activity.
+     *
+     * @param sessionName - The session that made an API call
+     */
+    recordApiActivity(sessionName) {
+        const now = Date.now();
+        this.lastActivityMap.set(sessionName, now);
+        this.lastApiActivityMap.set(sessionName, now);
+    }
+    /**
+     * Get the API-only idle time in milliseconds for a session.
+     * Unlike getIdleTimeMs(), this only considers API calls — not PTY output.
+     * Used by the heartbeat monitor to distinguish real orchestrator responses
+     * from PTY echo noise (e.g., heartbeat messages echoing back).
+     *
+     * @param sessionName - The session to check
+     * @returns Milliseconds since last API call, or 0 if never recorded
+     */
+    getApiIdleTimeMs(sessionName) {
+        const lastApi = this.lastApiActivityMap.get(sessionName);
+        if (lastApi === undefined) {
+            return 0;
+        }
+        return Date.now() - lastApi;
+    }
+    /**
+     * Get the idle time in milliseconds for a session.
+     * Returns 0 if no activity has ever been recorded, treating unknown
+     * sessions as "just started" to prevent premature heartbeat/suspend
+     * actions against agents that haven't produced PTY output yet.
+     *
+     * @param sessionName - The session to check
+     * @returns Milliseconds since last PTY output, or 0 if never recorded
+     */
+    getIdleTimeMs(sessionName) {
+        const lastActivity = this.lastActivityMap.get(sessionName);
+        if (lastActivity === undefined) {
+            return 0;
+        }
+        return Date.now() - lastActivity;
+    }
+    /**
+     * Check whether a session has been idle for at least the given duration.
+     * Returns false if no activity has ever been recorded for the session,
+     * since "never seen" should not be treated as "idle" — this prevents
+     * newly started agents from being immediately suspended.
+     *
+     * @param sessionName - The session to check
+     * @param durationMs - Required idle duration in milliseconds
+     * @returns True if the session has been idle for at least durationMs
+     */
+    isIdleFor(sessionName, durationMs) {
+        if (!this.lastActivityMap.has(sessionName)) {
+            return false;
+        }
+        return this.getIdleTimeMs(sessionName) >= durationMs;
+    }
+    /**
+     * Check if activity has ever been recorded for a session.
+     *
+     * @param sessionName - The session to check
+     * @returns True if activity has been recorded
+     */
+    hasActivity(sessionName) {
+        return this.lastActivityMap.has(sessionName);
+    }
+    /**
+     * Record PTY activity only if the output contains meaningful content.
+     * Strips ANSI escape codes (cursor movements, color codes, spinner characters)
+     * and only records activity if the remaining text has sufficient non-whitespace
+     * characters. This prevents TUI noise (spinners, cursor repositioning) from
+     * resetting the idle timer.
+     *
+     * @param sessionName - The session that produced output
+     * @param rawData - Raw PTY output data to evaluate
+     */
+    recordFilteredActivity(sessionName, rawData) {
+        const stripped = stripAnsiCodes(rawData).replace(/\s/g, '');
+        if (stripped.length >= PTY_CONSTANTS.MIN_MEANINGFUL_OUTPUT_BYTES) {
+            this.recordActivity(sessionName);
+        }
+    }
+    /**
+     * Remove tracking data for a session.
+     * Called when a session is terminated or suspended.
+     *
+     * @param sessionName - The session to clear
+     */
+    clearSession(sessionName) {
+        this.lastActivityMap.delete(sessionName);
+        this.lastApiActivityMap.delete(sessionName);
+        this.logger.debug('Cleared activity tracking for session', { sessionName });
+    }
+    /**
+     * Get the number of tracked sessions.
+     *
+     * @returns Number of sessions with recorded activity
+     */
+    getTrackedSessionCount() {
+        return this.lastActivityMap.size;
+    }
+}
+//# sourceMappingURL=pty-activity-tracker.service.js.map

package/dist/cli/backend/src/services/agent/pty-activity-tracker.service.js.map

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

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

@@ -0,0 +1,156 @@
+import { ComponentLogger } from '../core/logger.service.js';
+import { SessionCommandHelper } from '../session/index.js';
+import { RuntimeType } from '../../constants.js';
+/**
+ * Result of MCP configuration operation.
+ * Returned by ensureMcpConfig to indicate what was configured.
+ */
+export interface McpConfigResult {
+    /** Whether the config was written successfully */
+    success: boolean;
+    /** Number of new servers added */
+    addedServers: number;
+    /** Total servers in the final config */
+    totalServers: number;
+    /** Names of servers in the final config */
+    serverNames: string[];
+    /** Error message if success is false */
+    error?: string;
+}
+/**
+ * Runtime configuration interface
+ */
+export interface RuntimeConfig {
+    displayName: string;
+    initScript: string;
+    welcomeMessage: string;
+    timeout: number;
+    description: string;
+}
+/**
+ * Abstract base class for AI runtime services that handles tmux session initialization,
+ * detection, and interaction patterns for different AI CLI tools.
+ *
+ * Uses Template Method pattern for maximum code reuse while allowing runtime-specific customization.
+ */
+export declare abstract class RuntimeAgentService {
+    protected logger: ComponentLogger;
+    protected sessionHelper: SessionCommandHelper;
+    protected projectRoot: string;
+    protected runtimeConfig: RuntimeConfig | null;
+    private detectionInProgress;
+    private detectionResults;
+    constructor(sessionHelper: SessionCommandHelper, projectRoot: string);
+    protected abstract getRuntimeType(): RuntimeType;
+    protected abstract detectRuntimeSpecific(sessionName: string): Promise<boolean>;
+    protected abstract getRuntimeReadyPatterns(): string[];
+    protected abstract getRuntimeErrorPatterns(): string[];
+    protected abstract getRuntimeExitPatterns(): RegExp[];
+    /**
+     * Get patterns that indicate this runtime has exited.
+     * Used by RuntimeExitMonitorService to detect when the CLI process exits.
+     *
+     * @returns Array of RegExp patterns that match runtime exit output
+     */
+    getExitPatterns(): RegExp[];
+    /**
+     * Template method for executing runtime initialization script.
+     * Most logic is shared, only runtime-specific parts are delegated to abstract methods.
+     *
+     * @param sessionName - PTY session name
+     * @param targetPath - Working directory for the session
+     * @param runtimeFlags - Optional CLI flags to inject before --dangerously-skip-permissions
+     * @param promptFilePath - Optional path to a prompt file; for non-Claude-Code runtimes,
+     *                         appends --append-system-prompt-file flag
+     * @param agentName - Optional agent name for Claude Code --agent flag (#207)
+     */
+    executeRuntimeInitScript(sessionName: string, targetPath?: string, runtimeFlags?: string[], promptFilePath?: string, agentName?: string): Promise<void>;
+    /**
+     * Template method for detecting if runtime is running.
+     * Handles caching and concurrent access, delegates actual detection to concrete classes.
+     */
+    detectRuntimeWithCommand(sessionName: string, forceRefresh?: boolean): Promise<boolean>;
+    /**
+     * Simplified method for waiting for runtime to be ready.
+     * Checks at regular intervals until timeout, looking for ready patterns in the terminal output.
+     */
+    waitForRuntimeReady(sessionName: string, timeout: number, checkInterval?: number): Promise<boolean>;
+    /**
+     * Hook called after the runtime is ready but before prompts are sent.
+     * Override in concrete classes for runtime-specific post-initialization steps
+     * (e.g., Gemini CLI directory allowlist additions).
+     *
+     * Default implementation is a no-op.
+     *
+     * @param sessionName - PTY session name
+     * @param targetProjectPath - Optional target project path for the agent (where MCP configs should be written).
+     *                            Falls back to this.projectRoot if not provided.
+     */
+    postInitialize(sessionName: string, targetProjectPath?: string, additionalAllowlistPaths?: string[], browserAutomationOverride?: boolean): Promise<void>;
+    /**
+     * Clear cached detection results for a session
+     */
+    clearDetectionCache(sessionName: string): void;
+    /**
+     * Get runtime configuration
+     */
+    getRuntimeConfiguration(): RuntimeConfig | null;
+    /**
+     * Ensure MCP server configuration exists at the given config file path.
+     *
+     * Reads `enableBrowserAutomation` from settings, builds the required MCP servers
+     * list, reads any existing config at `configFilePath`, merge-only adds missing
+     * servers, and writes the result back via `atomicWriteJson`.
+     *
+     * Parent directories of `configFilePath` are created automatically with
+     * `fs.mkdir({ recursive: true })`.
+     *
+     * Preserves any existing user-configured MCP servers (never overwrites).
+     * Errors are non-fatal and logged as warnings.
+     *
+     * @param configFilePath - Absolute path to the MCP config JSON file
+     *                         (e.g., `/project/.mcp.json` or `/project/.gemini/settings.json`)
+     * @param projectPath - Project directory path, used only for log context
+     * @param browserAutomationOverride - Per-agent override for browser automation.
+     *                                    When provided, takes precedence over global settings.
+     *                                    `undefined` means use global setting.
+     */
+    protected ensureMcpConfig(configFilePath: string, projectPath: string, browserAutomationOverride?: boolean): Promise<McpConfigResult>;
+    /**
+     * Verify MCP config file exists and contains expected servers.
+     *
+     * Reads the config file back after write and checks that the expected
+     * server names are present. Non-fatal — logs warnings on failure.
+     *
+     * @param configFilePath - Absolute path to the MCP config JSON file
+     * @param expectedServers - Server names expected to be present (e.g. ['playwright'])
+     * @returns True if all expected servers are present, false otherwise
+     */
+    protected verifyMcpConfig(configFilePath: string, expectedServers: string[]): Promise<boolean>;
+    /**
+     * Check if the Crewly Pro addon is installed.
+     *
+     * Pro addon provides its own Crewly in Chrome bridge, so Playwright MCP
+     * should not be injected when it is present.
+     *
+     * @returns True if crewly-pro addon manifest exists
+     */
+    protected isProAddonInstalled(): boolean;
+    /**
+     * Initialize runtime configuration from config file
+     */
+    private initializeRuntimeConfig;
+    /**
+     * Get runtime configuration with fallback
+     */
+    protected getRuntimeConfig(): RuntimeConfig;
+    /**
+     * Load initialization script commands from file
+     */
+    protected loadInitScript(scriptName: string): Promise<string[]>;
+    /**
+     * Send shell commands to session
+     */
+    protected sendShellCommandsToSession(sessionName: string, commands: string[], targetPath?: string): Promise<void>;
+}
+//# sourceMappingURL=runtime-agent.service.abstract.d.ts.map

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

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