crewly 1.2.1 → 1.2.4

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

@@ -0,0 +1,131 @@
+import { RuntimeAgentService } from './runtime-agent.service.abstract.js';
+import { RUNTIME_TYPES } from '../../constants.js';
+/**
+ * OpenHands specific runtime service implementation.
+ * Handles OpenHands CLI initialization, detection, and interaction patterns.
+ *
+ * OpenHands (formerly OpenDevin) is an open-source AI coding agent with
+ * browser automation (BrowserGym) and multi-LLM support via LiteLLM.
+ * It supports both interactive TUI and headless JSONL modes.
+ */
+export class OpenHandsRuntimeService extends RuntimeAgentService {
+    constructor(sessionHelper, projectRoot) {
+        super(sessionHelper, projectRoot);
+    }
+    getRuntimeType() {
+        return RUNTIME_TYPES.OPENHANDS;
+    }
+    /**
+     * OpenHands runtime detection using passive output inspection.
+     *
+     * Uses passive detection (like Codex) rather than active key probing
+     * (like Claude/Gemini). OpenHands TUI may not respond predictably
+     * to slash-key probes, so we check for ready patterns in terminal output.
+     *
+     * @param sessionName - PTY session name to check
+     * @returns True if OpenHands is detected as running
+     */
+    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('OpenHands detection completed', {
+            sessionName,
+            hasReadySignal,
+        });
+        return hasReadySignal;
+    }
+    /**
+     * OpenHands specific ready patterns.
+     *
+     * These patterns appear in the terminal when OpenHands CLI
+     * has finished initializing and is ready to accept input.
+     */
+    getRuntimeReadyPatterns() {
+        return [
+            '>>',
+            'Setting agent(CodeActAgent) state from AgentState.LOADING to AgentState.RUNNING',
+            'CLIRuntime initialized',
+            'Tools updated for agent',
+            'OpenHands',
+        ];
+    }
+    /**
+     * OpenHands specific exit patterns for runtime exit detection.
+     *
+     * Includes both clean exit patterns and error patterns that indicate
+     * the CLI has terminated or become unrecoverable.
+     *
+     * @returns Array of RegExp patterns that match runtime exit output
+     */
+    getRuntimeExitPatterns() {
+        return [
+            /OpenHands.*exited/i,
+            /Session\s+ended/i,
+            /AgentState\.FINISHED/i,
+            /AgentState\.ERROR/i,
+            /Conversation\s+ended/i,
+        ];
+    }
+    /**
+     * OpenHands specific error patterns.
+     *
+     * These patterns indicate startup failures or unrecoverable errors
+     * during OpenHands CLI initialization.
+     */
+    getRuntimeErrorPatterns() {
+        const commonErrors = ['Permission denied', 'No such file or directory'];
+        return [
+            ...commonErrors,
+            'command not found: openhands',
+            'LLM API error',
+            'Authentication failed',
+            'Invalid API key',
+            'Rate limit exceeded',
+            'Model not found',
+        ];
+    }
+    /**
+     * Check if OpenHands CLI is installed and configured.
+     *
+     * @returns Installation check result with status and message
+     */
+    async checkOpenHandsInstallation() {
+        try {
+            return {
+                isInstalled: true,
+                message: 'OpenHands CLI is available',
+            };
+        }
+        catch (error) {
+            return {
+                isInstalled: false,
+                message: 'OpenHands CLI not found or not configured',
+            };
+        }
+    }
+    /**
+     * Initialize OpenHands in an existing session.
+     *
+     * @param sessionName - PTY session name to initialize in
+     * @returns Result with success status and message
+     */
+    async initializeOpenHandsInSession(sessionName) {
+        try {
+            await this.executeRuntimeInitScript(sessionName);
+            return {
+                success: true,
+                message: 'OpenHands CLI initialized successfully',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: error instanceof Error
+                    ? error.message
+                    : 'Failed to initialize OpenHands CLI',
+            };
+        }
+    }
+}
+//# sourceMappingURL=openhands-runtime.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openhands-runtime.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/openhands-runtime.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAC/D,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;;;;;;;;;OASG;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,+BAA+B,EAAE;YAClD,WAAW;YACX,cAAc;SACd,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACO,uBAAuB;QAChC,OAAO;YACN,IAAI;YACJ,iFAAiF;YACjF,wBAAwB;YACxB,yBAAyB;YACzB,WAAW;SACX,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACO,sBAAsB;QAC/B,OAAO;YACN,oBAAoB;YACpB,kBAAkB;YAClB,uBAAuB;YACvB,oBAAoB;YACpB,uBAAuB;SACvB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACO,uBAAuB;QAChC,MAAM,YAAY,GAAG,CAAC,mBAAmB,EAAE,2BAA2B,CAAC,CAAC;QACxE,OAAO;YACN,GAAG,YAAY;YACf,8BAA8B;YAC9B,eAAe;YACf,uBAAuB;YACvB,iBAAiB;YACjB,qBAAqB;YACrB,iBAAiB;SACjB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,0BAA0B;QAK/B,IAAI,CAAC;YACJ,OAAO;gBACN,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,4BAA4B;aACrC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,WAAW,EAAE,KAAK;gBAClB,OAAO,EAAE,2CAA2C;aACpD,CAAC;QACH,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,4BAA4B,CAAC,WAAmB;QAIrD,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;YACjD,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,wCAAwC;aACjD,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,oCAAoC;aACxC,CAAC;QACH,CAAC;IACF,CAAC;CACD"}

package/dist/backend/backend/src/services/agent/pty-activity-tracker.service.d.ts

@@ -17,8 +17,10 @@
 export declare class PtyActivityTrackerService {
     private static instance;
     private logger;
-    /** Map of session name to last activity timestamp (epoch ms) */
+    /** Map of session name to last activity timestamp (epoch ms) — includes both PTY and API */
     private lastActivityMap;
+    /** Map of session name to last API-only activity timestamp (epoch ms) */
+    private lastApiActivityMap;
     private constructor();
     /**
      * Get the singleton instance.
@@ -37,6 +39,24 @@ export declare class PtyActivityTrackerService {
      * @param sessionName - The session that produced output
      */
     recordActivity(sessionName: string): void;
+    /**
+     * 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: string): void;
+    /**
+     * 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: string): number;
     /**
      * Get the idle time in milliseconds for a session.
      * Returns 0 if no activity has ever been recorded, treating unknown

package/dist/backend/backend/src/services/agent/pty-activity-tracker.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pty-activity-tracker.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/pty-activity-tracker.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IACjE,OAAO,CAAC,MAAM,CAAkB;IAEhC,gEAAgE;IAChE,OAAO,CAAC,eAAe,CAAkC;IAEzD,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;;;;;OAQG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ1C;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAO3D;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;;;;OASG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlE;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKvC;;;;OAIG;IACH,sBAAsB,IAAI,MAAM;CAGhC"}
+{"version":3,"file":"pty-activity-tracker.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/pty-activity-tracker.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IACjE,OAAO,CAAC,MAAM,CAAkB;IAEhC,4FAA4F;IAC5F,OAAO,CAAC,eAAe,CAAkC;IAEzD,yEAAyE;IACzE,OAAO,CAAC,kBAAkB,CAAkC;IAE5D,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;;;OAMG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM5C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ7C;;;;;;;;OAQG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ1C;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAO3D;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;;;;OASG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlE;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMvC;;;;OAIG;IACH,sBAAsB,IAAI,MAAM;CAGhC"}

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

@@ -20,8 +20,10 @@ import { PTY_CONSTANTS } from '../../constants.js';
 export class PtyActivityTrackerService {
     static instance = null;
     logger;
-    /** Map of session name to last activity timestamp (epoch ms) */
+    /** 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');
     }
@@ -51,6 +53,34 @@ export class PtyActivityTrackerService {
     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
@@ -116,6 +146,7 @@ export class PtyActivityTrackerService {
      */
     clearSession(sessionName) {
         this.lastActivityMap.delete(sessionName);
+        this.lastApiActivityMap.delete(sessionName);
         this.logger.debug('Cleared activity tracking for session', { sessionName });
     }
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"pty-activity-tracker.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/pty-activity-tracker.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAmB,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,OAAO,yBAAyB;IAC7B,MAAM,CAAC,QAAQ,GAAqC,IAAI,CAAC;IACzD,MAAM,CAAkB;IAEhC,gEAAgE;IACxD,eAAe,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEzD;QACC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC;YACzC,yBAAyB,CAAC,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,yBAAyB,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QACnB,yBAAyB,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAmB;QACjC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,WAAmB;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,CAAC;QACV,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAmB,EAAE,UAAkB;QAChD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,WAAmB;QAC9B,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;OASG;IACH,sBAAsB,CAAC,WAAmB,EAAE,OAAe;QAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,MAAM,IAAI,aAAa,CAAC,2BAA2B,EAAE,CAAC;YAClE,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,WAAmB;QAC/B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;IAClC,CAAC"}
+{"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/backend/backend/src/services/agent/runtime-exit-monitor.service.d.ts

@@ -1,5 +1,6 @@
 import { TaskTrackingService } from '../project/task-tracking.service.js';
 import type { AgentRegistrationService } from './agent-registration.service.js';
+import type { EventBusService } from '../event-bus/event-bus.service.js';
 import { type RuntimeType } from '../../constants.js';
 /**
  * Service that monitors PTY sessions for runtime exit patterns.
@@ -18,6 +19,10 @@ import { type RuntimeType } from '../../constants.js';
  * needs recovery. These failure patterns bypass the shell prompt verification
  * since the CLI may still be running but non-functional.
  *
+ * For Claude Code, the service detects fatal API errors (e.g. thinking
+ * block corruption) that make the CLI permanently non-functional within
+ * the current session. These trigger immediate recovery without retry.
+ *
  * @example
  * ```typescript
  * const monitor = RuntimeExitMonitorService.getInstance();
@@ -33,6 +38,14 @@ export declare class RuntimeExitMonitorService {
     private onExitDetectedCallback?;
     private agentRegistrationService;
     private taskTrackingService;
+    private eventBusService;
+    /**
+     * Restart timestamps per session, persisted across monitoring cycles.
+     * Unlike MonitoredSession (which is recreated on each startMonitoring call),
+     * this map survives agent restarts to prevent infinite restart loops
+     * when agents keep crashing (e.g. during network outages).
+     */
+    private restartHistory;
     private constructor();
     /**
      * Get the singleton instance.
@@ -61,6 +74,12 @@ export declare class RuntimeExitMonitorService {
      * @param service - The TaskTrackingService instance
      */
     setTaskTrackingService(service: TaskTrackingService): void;
+    /**
+     * Set the EventBusService dependency for publishing agent lifecycle events.
+     *
+     * @param service - The EventBusService instance
+     */
+    setEventBusService(service: EventBusService): void;
     /**
      * Start monitoring a PTY session for runtime exit patterns.
      *
@@ -97,19 +116,24 @@ export declare class RuntimeExitMonitorService {
      * dead. Gemini CLI often recovers automatically from transient API errors
      * (RESOURCE_EXHAUSTED, UNAVAILABLE, Connection error). Only after
      * MAX_RETRIES does the system proceed with the exit/restart flow.
+     *
+     * For Claude Code fatal patterns (thinking block corruption, etc.),
+     * the system skips retry and forces immediate recovery since these
+     * errors are permanently unrecoverable within the same session.
      */
     private confirmAndReact;
     /**
      * Handle a Gemini CLI failure with exponential backoff retry.
      *
      * Waits with increasing delays and checks if the CLI recovers (returns
-     * to a ready prompt). Returns 'recovered' if the CLI is back, or
-     * 'exhausted' if max retries have been reached.
+     * to a ready prompt). Returns 'recovered' if the CLI is back,
+     * 'deferred' if retries remain (skip exit flow, re-check on next
+     * failure detection), or 'exhausted' if max retries have been reached.
      *
      * @param sessionName - PTY session name
      * @param monitored - Monitored session state (retry counter is mutated)
      * @param helper - Session command helper for terminal output capture
-     * @returns 'recovered' if CLI is back, 'exhausted' if retries exhausted
+     * @returns 'recovered' | 'deferred' | 'exhausted'
      */
     private handleGeminiFailureWithRetry;
     /**
@@ -155,5 +179,55 @@ export declare class RuntimeExitMonitorService {
      * that the agent CLI has actually exited and returned to the shell.
      */
     private verifyExitWithShellPrompt;
+    /**
+     * Check if an agent restart is allowed based on cooldown window.
+     * Prevents infinite restart loops when agents keep crashing (e.g. during
+     * network outages). Uses the same limits as AgentHeartbeatMonitorService.
+     *
+     * @param sessionName - PTY session name
+     * @returns True if restart is allowed, false if cooldown is active
+     */
+    private isAgentRestartAllowed;
+    /**
+     * Record a restart attempt for cooldown tracking.
+     *
+     * @param sessionName - PTY session name
+     */
+    private recordAgentRestart;
+    /**
+     * Classify an error reason as transient or persistent.
+     *
+     * Transient errors (connectivity, timeout, quota) may resolve on retry.
+     * Persistent errors (auth, config, crash loop) require manual intervention.
+     *
+     * @param reason - The failure reason string
+     * @returns 'TRANSIENT' | 'PERSISTENT' | 'UNKNOWN'
+     */
+    private classifyError;
+    /**
+     * Notify the orchestrator about an agent failure via the chat API (#129).
+     *
+     * Sends a structured failure notification with error classification so the
+     * orchestrator can decide whether to restart the agent, reassign tasks,
+     * or inform the user. This is fire-and-forget — failures are logged but
+     * do not block the exit flow.
+     *
+     * @param sessionName - Failed agent's PTY session name
+     * @param reason - Failure reason (runtime_exited, api_failure, etc.)
+     * @param activeTasks - In-progress tasks the agent had, if any
+     * @param restartSucceeded - Whether automatic restart succeeded
+     */
+    private notifyOrchestratorOfFailure;
+    /**
+     * Publish agent:status_changed and agent:inactive events to the EventBus.
+     *
+     * Looks up team/member names from StorageService to build the full
+     * AgentEvent. This mirrors the pattern used in TeamsJsonWatcherService.
+     *
+     * @param sessionName - PTY session name
+     * @param monitored - Monitored session state with teamId/memberId
+     * @param storageService - StorageService instance for team/member lookup
+     */
+    private publishInactiveEvent;
 }
 //# sourceMappingURL=runtime-exit-monitor.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"runtime-exit-monitor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/runtime-exit-monitor.service.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAWN,KAAK,WAAW,EAChB,MAAM,oBAAoB,CAAC;AAyB5B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IACjE,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,sBAAsB,CAAC,CAAgC;IAC/D,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,mBAAmB,CAAoC;IAE/D,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAO5B;;;;;OAKG;IACH,yBAAyB,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIxE;;;;OAIG;IACH,2BAA2B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAIpE;;;;OAIG;IACH,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D;;;;;;;;OAQG;IACH,eAAe,CACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GACf,IAAI;IAwEP;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAmBzC;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,OAAO,CAAC,UAAU;IAsClB;;;;;;;;OAQG;YACW,eAAe;IAoP7B;;;;;;;;;;;OAWG;YACW,4BAA4B;IAqF1C;;;;;;;;;;;;;;OAcG;YACW,qBAAqB;IA8EnC;;;;;;;;OAQG;YACW,cAAc;IAkE5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IA6CzB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;CAQjC"}
+{"version":3,"file":"runtime-exit-monitor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/runtime-exit-monitor.service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAeN,KAAK,WAAW,EAChB,MAAM,oBAAoB,CAAC;AAyB5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IACjE,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,sBAAsB,CAAC,CAAgC;IAC/D,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,eAAe,CAAgC;IAEvD;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAA+B;IAErD,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAO5B;;;;;OAKG;IACH,yBAAyB,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIxE;;;;OAIG;IACH,2BAA2B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAIpE;;;;OAIG;IACH,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIlD;;;;;;;;OAQG;IACH,eAAe,CACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GACf,IAAI;IAwEP;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAmBzC;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,OAAO,CAAC,UAAU;IAsClB;;;;;;;;;;;;OAYG;YACW,eAAe;IAiS7B;;;;;;;;;;;;OAYG;YACW,4BAA4B;IAkF1C;;;;;;;;;;;;;;OAcG;YACW,qBAAqB;IA8EnC;;;;;;;;OAQG;YACW,cAAc;IAkE5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IA6CzB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IASjC;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,2BAA2B;IAsEnC;;;;;;;;;OASG;YACW,oBAAoB;CAoDlC"}