crewly 1.0.0

package/dist/backend/backend/src/services/orchestrator/index.js

@@ -0,0 +1,15 @@
+/**
+ * Orchestrator Service Module
+ *
+ * Exports orchestrator-related services.
+ *
+ * @module services/orchestrator
+ */
+export { StatePersistenceService, getStatePersistenceService, resetStatePersistenceService, } from './state-persistence.service.js';
+export { SafeRestartService, getSafeRestartService, resetSafeRestartService, } from './safe-restart.service.js';
+export { SelfImprovementService, getSelfImprovementService, resetSelfImprovementService, } from './self-improvement.service.js';
+export { ImprovementMarkerService, getImprovementMarkerService, resetImprovementMarkerService, } from './improvement-marker.service.js';
+export { ImprovementStartupService, getImprovementStartupService, resetImprovementStartupService, } from './improvement-startup.service.js';
+export { isOrchestratorActive, getOrchestratorStatus, getOrchestratorOfflineMessage, } from './orchestrator-status.service.js';
+export { OrchestratorRestartService, } from './orchestrator-restart.service.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,GAGxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAI5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAK9B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,GAE/B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,GAE9B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,0BAA0B,GAE3B,MAAM,mCAAmC,CAAC"}

package/dist/backend/backend/src/services/orchestrator/orchestrator-restart.service.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Orchestrator Restart Service
+ *
+ * Automatically restarts the orchestrator when it becomes unresponsive
+ * (child process dies inside the PTY shell). Enforces a cooldown window
+ * to prevent restart loops.
+ *
+ * @module orchestrator-restart.service
+ */
+import type { AgentRegistrationService } from '../agent/agent-registration.service.js';
+import type { ISessionBackend } from '../session/session-backend.interface.js';
+/**
+ * Restart statistics for monitoring
+ */
+export interface RestartStats {
+    /** Total number of restarts since service creation */
+    totalRestarts: number;
+    /** Restarts within the current cooldown window */
+    restartsInWindow: number;
+    /** Whether a restart is currently in progress */
+    isRestarting: boolean;
+    /** Timestamp of the last successful restart */
+    lastRestartAt: string | null;
+    /** Whether further restarts are allowed under cooldown */
+    restartAllowed: boolean;
+}
+/**
+ * OrchestratorRestartService manages automatic restart of the orchestrator
+ * when the child process (Claude Code) dies inside the PTY shell.
+ *
+ * Features:
+ * - Kills the old PTY session before creating a new one
+ * - Initializes memory and starts chat monitoring
+ * - Notifies via Slack (if configured)
+ * - Broadcasts WebSocket event for UI updates
+ * - Enforces max 3 restarts per hour cooldown
+ *
+ * @example
+ * ```typescript
+ * const service = OrchestratorRestartService.getInstance();
+ * service.setDependencies(agentRegistrationService, sessionBackend, io);
+ * await service.attemptRestart();
+ * ```
+ */
+export declare class OrchestratorRestartService {
+    private static instance;
+    private logger;
+    /** Timestamps of recent restarts for cooldown tracking */
+    private restartTimestamps;
+    /** Total restart count since service creation */
+    private totalRestarts;
+    /** Flag to prevent concurrent restart attempts */
+    private isRestarting;
+    /** External dependencies (injected via setDependencies) */
+    private agentRegistrationService;
+    private sessionBackend;
+    private socketIO;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The OrchestratorRestartService instance
+     */
+    static getInstance(): OrchestratorRestartService;
+    /**
+     * Reset the singleton instance (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Inject external dependencies.
+     *
+     * @param agentRegistrationService - Service for creating agent sessions
+     * @param sessionBackend - Session backend for killing old sessions
+     * @param socketIO - Socket.IO server for broadcasting events
+     */
+    setDependencies(agentRegistrationService: AgentRegistrationService, sessionBackend: ISessionBackend, socketIO?: {
+        emit: (event: string, data: unknown) => void;
+    }): void;
+    /**
+     * Check if a restart is currently allowed under the cooldown window.
+     *
+     * @returns true if restart is allowed
+     */
+    isRestartAllowed(): boolean;
+    /**
+     * Attempt to restart the orchestrator.
+     *
+     * This method:
+     * 1. Checks cooldown limits
+     * 2. Kills the old PTY session
+     * 3. Creates a new agent session
+     * 4. Initializes memory
+     * 5. Starts chat monitoring
+     * 6. Notifies Slack (if configured)
+     * 7. Broadcasts WebSocket event
+     *
+     * @returns true if restart succeeded, false otherwise
+     */
+    attemptRestart(): Promise<boolean>;
+    /**
+     * Get current restart statistics.
+     *
+     * @returns Restart statistics object
+     */
+    getRestartStats(): RestartStats;
+    /**
+     * Send a Slack notification about the orchestrator restart.
+     * Best-effort: silently ignores failures (Slack may not be configured).
+     */
+    private notifySlack;
+}
+//# sourceMappingURL=orchestrator-restart.service.d.ts.map

package/dist/backend/backend/src/services/orchestrator/orchestrator-restart.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-restart.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/orchestrator-restart.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0DAA0D;IAC1D,cAAc,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,0BAA0B;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAkB;IAEhC,0DAA0D;IAC1D,OAAO,CAAC,iBAAiB,CAAgB;IACzC,iDAAiD;IACjD,OAAO,CAAC,aAAa,CAAK;IAC1B,kDAAkD;IAClD,OAAO,CAAC,YAAY,CAAS;IAE7B,2DAA2D;IAC3D,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAiE;IAEjF,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,0BAA0B;IAOhD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,eAAe,CACd,wBAAwB,EAAE,wBAAwB,EAClD,cAAc,EAAE,eAAe,EAC/B,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,GACzD,IAAI;IAMP;;;;OAIG;IACH,gBAAgB,IAAI,OAAO;IAU3B;;;;;;;;;;;;;OAaG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAuHxC;;;;OAIG;IACH,eAAe,IAAI,YAAY;IAiB/B;;;OAGG;YACW,WAAW;CAezB"}

package/dist/backend/backend/src/services/orchestrator/orchestrator-restart.service.js

@@ -0,0 +1,244 @@
+/**
+ * Orchestrator Restart Service
+ *
+ * Automatically restarts the orchestrator when it becomes unresponsive
+ * (child process dies inside the PTY shell). Enforces a cooldown window
+ * to prevent restart loops.
+ *
+ * @module orchestrator-restart.service
+ */
+import { ORCHESTRATOR_SESSION_NAME, ORCHESTRATOR_ROLE, ORCHESTRATOR_WINDOW_NAME, ORCHESTRATOR_RESTART_CONSTANTS, RUNTIME_TYPES, } from '../../constants.js';
+import { LoggerService } from '../core/logger.service.js';
+import { MemoryService } from '../memory/memory.service.js';
+import { getTerminalGateway } from '../../websocket/terminal.gateway.js';
+/**
+ * OrchestratorRestartService manages automatic restart of the orchestrator
+ * when the child process (Claude Code) dies inside the PTY shell.
+ *
+ * Features:
+ * - Kills the old PTY session before creating a new one
+ * - Initializes memory and starts chat monitoring
+ * - Notifies via Slack (if configured)
+ * - Broadcasts WebSocket event for UI updates
+ * - Enforces max 3 restarts per hour cooldown
+ *
+ * @example
+ * ```typescript
+ * const service = OrchestratorRestartService.getInstance();
+ * service.setDependencies(agentRegistrationService, sessionBackend, io);
+ * await service.attemptRestart();
+ * ```
+ */
+export class OrchestratorRestartService {
+    static instance;
+    logger;
+    /** Timestamps of recent restarts for cooldown tracking */
+    restartTimestamps = [];
+    /** Total restart count since service creation */
+    totalRestarts = 0;
+    /** Flag to prevent concurrent restart attempts */
+    isRestarting = false;
+    /** External dependencies (injected via setDependencies) */
+    agentRegistrationService = null;
+    sessionBackend = null;
+    socketIO = null;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('OrchestratorRestart');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The OrchestratorRestartService instance
+     */
+    static getInstance() {
+        if (!OrchestratorRestartService.instance) {
+            OrchestratorRestartService.instance = new OrchestratorRestartService();
+        }
+        return OrchestratorRestartService.instance;
+    }
+    /**
+     * Reset the singleton instance (for testing).
+     */
+    static resetInstance() {
+        OrchestratorRestartService.instance = undefined;
+    }
+    /**
+     * Inject external dependencies.
+     *
+     * @param agentRegistrationService - Service for creating agent sessions
+     * @param sessionBackend - Session backend for killing old sessions
+     * @param socketIO - Socket.IO server for broadcasting events
+     */
+    setDependencies(agentRegistrationService, sessionBackend, socketIO) {
+        this.agentRegistrationService = agentRegistrationService;
+        this.sessionBackend = sessionBackend;
+        this.socketIO = socketIO ?? null;
+    }
+    /**
+     * Check if a restart is currently allowed under the cooldown window.
+     *
+     * @returns true if restart is allowed
+     */
+    isRestartAllowed() {
+        const now = Date.now();
+        const windowStart = now - ORCHESTRATOR_RESTART_CONSTANTS.COOLDOWN_WINDOW_MS;
+        // Prune timestamps outside the window
+        this.restartTimestamps = this.restartTimestamps.filter((ts) => ts > windowStart);
+        return this.restartTimestamps.length < ORCHESTRATOR_RESTART_CONSTANTS.MAX_RESTARTS_PER_WINDOW;
+    }
+    /**
+     * Attempt to restart the orchestrator.
+     *
+     * This method:
+     * 1. Checks cooldown limits
+     * 2. Kills the old PTY session
+     * 3. Creates a new agent session
+     * 4. Initializes memory
+     * 5. Starts chat monitoring
+     * 6. Notifies Slack (if configured)
+     * 7. Broadcasts WebSocket event
+     *
+     * @returns true if restart succeeded, false otherwise
+     */
+    async attemptRestart() {
+        if (this.isRestarting) {
+            this.logger.warn('Restart already in progress, skipping');
+            return false;
+        }
+        if (!this.isRestartAllowed()) {
+            this.logger.warn('Restart cooldown active, skipping', {
+                restartsInWindow: this.restartTimestamps.length,
+                maxAllowed: ORCHESTRATOR_RESTART_CONSTANTS.MAX_RESTARTS_PER_WINDOW,
+            });
+            return false;
+        }
+        if (!this.agentRegistrationService || !this.sessionBackend) {
+            this.logger.error('Dependencies not set, cannot restart');
+            return false;
+        }
+        this.isRestarting = true;
+        try {
+            this.logger.info('Attempting orchestrator restart...');
+            // Step 1: Wait a brief delay for cleanup
+            await new Promise((resolve) => setTimeout(resolve, ORCHESTRATOR_RESTART_CONSTANTS.RESTART_DELAY_MS));
+            // Step 2: Kill the old PTY session
+            try {
+                if (this.sessionBackend.sessionExists(ORCHESTRATOR_SESSION_NAME)) {
+                    await this.sessionBackend.killSession(ORCHESTRATOR_SESSION_NAME);
+                    this.logger.info('Killed old orchestrator session');
+                }
+            }
+            catch (killErr) {
+                this.logger.warn('Error killing old session (continuing with restart)', {
+                    error: killErr instanceof Error ? killErr.message : String(killErr),
+                });
+            }
+            // Step 3: Determine runtime type
+            let runtimeType = RUNTIME_TYPES.CLAUDE_CODE;
+            // Step 4: Create new agent session
+            const result = await this.agentRegistrationService.createAgentSession({
+                sessionName: ORCHESTRATOR_SESSION_NAME,
+                role: ORCHESTRATOR_ROLE,
+                projectPath: process.cwd(),
+                windowName: ORCHESTRATOR_WINDOW_NAME,
+                runtimeType,
+            });
+            if (!result.success) {
+                this.logger.error('Failed to create new orchestrator session', {
+                    error: result.error,
+                });
+                return false;
+            }
+            // Step 5: Initialize memory
+            try {
+                const memoryService = MemoryService.getInstance();
+                await memoryService.initializeForSession(ORCHESTRATOR_SESSION_NAME, ORCHESTRATOR_ROLE, process.cwd());
+            }
+            catch (memoryErr) {
+                this.logger.warn('Failed to initialize memory during restart', {
+                    error: memoryErr instanceof Error ? memoryErr.message : String(memoryErr),
+                });
+            }
+            // Step 6: Start chat monitoring
+            try {
+                const terminalGateway = getTerminalGateway();
+                if (terminalGateway) {
+                    terminalGateway.startOrchestratorChatMonitoring(ORCHESTRATOR_SESSION_NAME);
+                }
+            }
+            catch (chatErr) {
+                this.logger.warn('Failed to start chat monitoring during restart', {
+                    error: chatErr instanceof Error ? chatErr.message : String(chatErr),
+                });
+            }
+            // Step 7: Notify via Slack (fire-and-forget)
+            this.notifySlack().catch(() => {
+                // Slack notification is best-effort
+            });
+            // Step 8: Broadcast WebSocket event
+            if (this.socketIO) {
+                this.socketIO.emit('orchestrator:restarted', {
+                    timestamp: new Date().toISOString(),
+                    restartCount: this.totalRestarts + 1,
+                });
+            }
+            // Track restart
+            this.restartTimestamps.push(Date.now());
+            this.totalRestarts++;
+            this.logger.info('Orchestrator restart successful', {
+                totalRestarts: this.totalRestarts,
+            });
+            return true;
+        }
+        catch (error) {
+            this.logger.error('Orchestrator restart failed', {
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            return false;
+        }
+        finally {
+            this.isRestarting = false;
+        }
+    }
+    /**
+     * Get current restart statistics.
+     *
+     * @returns Restart statistics object
+     */
+    getRestartStats() {
+        const now = Date.now();
+        const windowStart = now - ORCHESTRATOR_RESTART_CONSTANTS.COOLDOWN_WINDOW_MS;
+        const restartsInWindow = this.restartTimestamps.filter((ts) => ts > windowStart).length;
+        return {
+            totalRestarts: this.totalRestarts,
+            restartsInWindow,
+            isRestarting: this.isRestarting,
+            lastRestartAt: this.restartTimestamps.length > 0
+                ? new Date(this.restartTimestamps[this.restartTimestamps.length - 1]).toISOString()
+                : null,
+            restartAllowed: this.isRestartAllowed(),
+        };
+    }
+    /**
+     * Send a Slack notification about the orchestrator restart.
+     * Best-effort: silently ignores failures (Slack may not be configured).
+     */
+    async notifySlack() {
+        try {
+            const { getSlackService } = await import('../slack/slack.service.js');
+            const slackService = getSlackService();
+            await slackService.sendNotification({
+                title: 'Orchestrator Restarted',
+                message: `The orchestrator was automatically restarted (attempt #${this.totalRestarts}). Previous process was detected as unresponsive.`,
+                type: 'alert',
+                urgency: 'high',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            // Slack may not be configured or client not initialized; ignore
+        }
+    }
+}
+//# sourceMappingURL=orchestrator-restart.service.js.map

package/dist/backend/backend/src/services/orchestrator/orchestrator-restart.service.js.map

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

package/dist/backend/backend/src/services/orchestrator/orchestrator-status.service.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Orchestrator Status Service
+ *
+ * Provides utilities to check the status of the orchestrator.
+ * Used by Chat and Slack services to provide appropriate feedback
+ * when the orchestrator is not running.
+ *
+ * @module services/orchestrator/orchestrator-status.service
+ */
+/**
+ * Result of an orchestrator status check
+ */
+export interface OrchestratorStatusResult {
+    /** Whether the orchestrator is active and ready to receive messages */
+    isActive: boolean;
+    /** The current agent status of the orchestrator */
+    agentStatus: string | null;
+    /** Human-readable status message */
+    message: string;
+}
+/**
+ * Check if the orchestrator is currently active and ready to receive messages.
+ *
+ * @returns Promise resolving to true if orchestrator is active
+ *
+ * @example
+ * ```typescript
+ * if (await isOrchestratorActive()) {
+ *   // Safe to send message to orchestrator
+ * } else {
+ *   // Show user-friendly offline message
+ * }
+ * ```
+ */
+export declare function isOrchestratorActive(): Promise<boolean>;
+/**
+ * Get detailed orchestrator status information.
+ *
+ * Uses the storageService.getOrchestratorStatus() method which reads the
+ * orchestrator data directly from storage (not from the teams array).
+ *
+ * @returns Promise resolving to status details including active state and message
+ *
+ * @example
+ * ```typescript
+ * const status = await getOrchestratorStatus();
+ * if (!status.isActive) {
+ *   showError(status.message);
+ * }
+ * ```
+ */
+export declare function getOrchestratorStatus(): Promise<OrchestratorStatusResult>;
+/**
+ * Get a user-friendly message for when the orchestrator is offline.
+ * Useful for Slack and Chat responses.
+ *
+ * @param includeUrl - Whether to include the dashboard URL in the message
+ * @returns A user-friendly offline message
+ */
+export declare function getOrchestratorOfflineMessage(includeUrl?: boolean): string;
+//# sourceMappingURL=orchestrator-status.service.d.ts.map

package/dist/backend/backend/src/services/orchestrator/orchestrator-status.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-status.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/orchestrator-status.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAuG/E;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,UAAO,GAAG,MAAM,CAMvE"}

package/dist/backend/backend/src/services/orchestrator/orchestrator-status.service.js

@@ -0,0 +1,156 @@
+/**
+ * Orchestrator Status Service
+ *
+ * Provides utilities to check the status of the orchestrator.
+ * Used by Chat and Slack services to provide appropriate feedback
+ * when the orchestrator is not running.
+ *
+ * @module services/orchestrator/orchestrator-status.service
+ */
+import { StorageService } from '../core/storage.service.js';
+import { CREWLY_CONSTANTS, WEB_CONSTANTS } from '../../../../config/index.js';
+import { getSessionBackendSync } from '../session/index.js';
+/** Dashboard URL for user-facing messages */
+const DASHBOARD_URL = `http://localhost:${WEB_CONSTANTS.PORTS.FRONTEND}`;
+/**
+ * Check if the orchestrator is currently active and ready to receive messages.
+ *
+ * @returns Promise resolving to true if orchestrator is active
+ *
+ * @example
+ * ```typescript
+ * if (await isOrchestratorActive()) {
+ *   // Safe to send message to orchestrator
+ * } else {
+ *   // Show user-friendly offline message
+ * }
+ * ```
+ */
+export async function isOrchestratorActive() {
+    const status = await getOrchestratorStatus();
+    return status.isActive;
+}
+/**
+ * Get detailed orchestrator status information.
+ *
+ * Uses the storageService.getOrchestratorStatus() method which reads the
+ * orchestrator data directly from storage (not from the teams array).
+ *
+ * @returns Promise resolving to status details including active state and message
+ *
+ * @example
+ * ```typescript
+ * const status = await getOrchestratorStatus();
+ * if (!status.isActive) {
+ *   showError(status.message);
+ * }
+ * ```
+ */
+export async function getOrchestratorStatus() {
+    try {
+        const storageService = StorageService.getInstance();
+        // Use getOrchestratorStatus which reads the orchestrator data directly
+        // The orchestrator is stored separately from the teams array
+        const orchestratorStatus = await storageService.getOrchestratorStatus();
+        // Also check if the PTY session exists - this provides a real-time view
+        // of whether the orchestrator is actually running.
+        // Use the well-known constant as fallback when sessionName isn't stored,
+        // aligning with how the teams controller checks session existence.
+        let sessionExists = false;
+        let sessionCheckPerformed = false;
+        try {
+            const sessionBackend = getSessionBackendSync();
+            const sessionName = orchestratorStatus?.sessionName || CREWLY_CONSTANTS.SESSIONS.ORCHESTRATOR_NAME;
+            if (sessionBackend && sessionName) {
+                sessionExists = sessionBackend.sessionExists(sessionName);
+                sessionCheckPerformed = true;
+            }
+        }
+        catch {
+            // Ignore session check errors - fall back to storage-based status
+        }
+        if (!orchestratorStatus) {
+            return {
+                isActive: false,
+                agentStatus: null,
+                message: 'Orchestrator not configured. Please set up the orchestrator from the Dashboard.',
+            };
+        }
+        const agentStatus = orchestratorStatus.agentStatus || CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE;
+        // Orchestrator is active when fully registered via MCP AND the session is
+        // confirmed alive (or the session backend was unavailable to check).
+        // If the session backend confirmed the session is dead, treat as not active.
+        const isRegisteredActive = agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE
+            && (!sessionCheckPerformed || sessionExists);
+        // Also treat as active when the PTY session exists and the runtime is running
+        // ("started" means Claude Code is running). This aligns with the teams controller
+        // which uses session existence as ground truth for status.
+        const isSessionActive = sessionExists && agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.STARTED;
+        if (isRegisteredActive || isSessionActive) {
+            return {
+                isActive: true,
+                agentStatus: CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE,
+                message: 'Orchestrator is active and ready.',
+            };
+        }
+        // Proactive cleanup: if the session backend confirmed the session is dead
+        // but stored status says active, update storage to prevent repeated stale checks
+        // from other callers (QueueProcessor, dashboard).
+        if (sessionCheckPerformed && !sessionExists && agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE) {
+            try {
+                const storageServiceForCleanup = StorageService.getInstance();
+                const cleanupSessionName = orchestratorStatus?.sessionName || CREWLY_CONSTANTS.SESSIONS.ORCHESTRATOR_NAME;
+                await storageServiceForCleanup.updateAgentStatus(cleanupSessionName, CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE);
+            }
+            catch {
+                // Best-effort cleanup — don't let it break the status check
+            }
+        }
+        // Provide context-appropriate message based on status
+        // Note: STARTED without a live session falls here (session died or config is stale)
+        if (agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVATING ||
+            agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.STARTING ||
+            agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.STARTED) {
+            return {
+                isActive: false,
+                agentStatus,
+                message: 'Orchestrator is starting up. Please wait a moment and try again.',
+            };
+        }
+        // If session exists but status is not active/started, it may be initializing
+        if (sessionExists) {
+            return {
+                isActive: false,
+                agentStatus,
+                message: 'Orchestrator is starting up. Please wait a moment and try again.',
+            };
+        }
+        return {
+            isActive: false,
+            agentStatus,
+            message: 'Orchestrator is not running. Please start the orchestrator from the Dashboard.',
+        };
+    }
+    catch (error) {
+        return {
+            isActive: false,
+            agentStatus: null,
+            message: `Unable to check orchestrator status: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+}
+/**
+ * Get a user-friendly message for when the orchestrator is offline.
+ * Useful for Slack and Chat responses.
+ *
+ * @param includeUrl - Whether to include the dashboard URL in the message
+ * @returns A user-friendly offline message
+ */
+export function getOrchestratorOfflineMessage(includeUrl = true) {
+    const baseMessage = 'The orchestrator is currently offline.';
+    if (includeUrl) {
+        return `${baseMessage} Please start it from the Crewly dashboard at ${DASHBOARD_URL}`;
+    }
+    return `${baseMessage} Please start it from the Crewly dashboard.`;
+}
+//# sourceMappingURL=orchestrator-status.service.js.map

package/dist/backend/backend/src/services/orchestrator/orchestrator-status.service.js.map

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