crewly 1.0.0

package/dist/backend/backend/src/services/messaging/sub-agent-message-queue.service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Sub-Agent Message Queue Service
+ *
+ * Buffers messages destined for sub-agents that have not yet completed
+ * initialization (agentStatus !== 'active'). Messages are flushed once
+ * the agent registers via the MCP `register_agent_status` tool.
+ *
+ * The orchestrator is excluded from this queue because it already has
+ * its own deferral mechanism via QueueProcessorService.
+ *
+ * @module sub-agent-message-queue
+ */
+/**
+ * A single queued message destined for a sub-agent.
+ */
+export interface QueuedAgentMessage {
+    /** The raw data string to write to the agent's terminal */
+    data: string;
+    /** Timestamp (ms since epoch) when the message was enqueued */
+    queuedAt: number;
+    /** The target session name */
+    sessionName: string;
+}
+/**
+ * Singleton service that holds pending messages per agent session.
+ *
+ * Messages are enqueued when a `mode: 'message'` write arrives at
+ * the terminal controller for an agent that is not yet active.
+ * They are dequeued and delivered sequentially when the agent
+ * registers (status becomes 'active').
+ */
+export declare class SubAgentMessageQueue {
+    private static instance;
+    private pendingMessages;
+    private logger;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The SubAgentMessageQueue singleton
+     */
+    static getInstance(): SubAgentMessageQueue;
+    /**
+     * Reset the singleton instance (for testing only).
+     */
+    static resetInstance(): void;
+    /**
+     * Enqueue a message for a session that is not yet active.
+     * If the queue exceeds MAX_QUEUE_SIZE, the oldest message is dropped.
+     *
+     * @param sessionName - The target agent session name
+     * @param data - The raw data string to deliver later
+     */
+    enqueue(sessionName: string, data: string): void;
+    /**
+     * Dequeue all pending messages for a session (FIFO order).
+     * The queue is cleared after dequeuing.
+     *
+     * @param sessionName - The agent session name
+     * @returns Array of queued messages in insertion order, or empty array
+     */
+    dequeueAll(sessionName: string): QueuedAgentMessage[];
+    /**
+     * Check if there are pending messages for a session.
+     *
+     * @param sessionName - The agent session name
+     * @returns True if there are pending messages
+     */
+    hasPending(sessionName: string): boolean;
+    /**
+     * Clear all pending messages for a session (e.g. on agent stop/exit).
+     *
+     * @param sessionName - The agent session name
+     */
+    clear(sessionName: string): void;
+    /**
+     * Get the number of pending messages for a session.
+     *
+     * @param sessionName - The agent session name
+     * @returns Number of pending messages
+     */
+    getQueueSize(sessionName: string): number;
+}
+//# sourceMappingURL=sub-agent-message-queue.service.d.ts.map

package/dist/backend/backend/src/services/messaging/sub-agent-message-queue.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-message-queue.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/sub-agent-message-queue.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IA8BhD;;;;;;OAMG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAiBrD;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKxC;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAWhC;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAIzC"}

package/dist/backend/backend/src/services/messaging/sub-agent-message-queue.service.js

@@ -0,0 +1,136 @@
+/**
+ * Sub-Agent Message Queue Service
+ *
+ * Buffers messages destined for sub-agents that have not yet completed
+ * initialization (agentStatus !== 'active'). Messages are flushed once
+ * the agent registers via the MCP `register_agent_status` tool.
+ *
+ * The orchestrator is excluded from this queue because it already has
+ * its own deferral mechanism via QueueProcessorService.
+ *
+ * @module sub-agent-message-queue
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { SUB_AGENT_QUEUE_CONSTANTS } from '../../constants.js';
+/**
+ * Singleton service that holds pending messages per agent session.
+ *
+ * Messages are enqueued when a `mode: 'message'` write arrives at
+ * the terminal controller for an agent that is not yet active.
+ * They are dequeued and delivered sequentially when the agent
+ * registers (status becomes 'active').
+ */
+export class SubAgentMessageQueue {
+    static instance = null;
+    pendingMessages = new Map();
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('SubAgentMessageQueue');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The SubAgentMessageQueue singleton
+     */
+    static getInstance() {
+        if (!SubAgentMessageQueue.instance) {
+            SubAgentMessageQueue.instance = new SubAgentMessageQueue();
+        }
+        return SubAgentMessageQueue.instance;
+    }
+    /**
+     * Reset the singleton instance (for testing only).
+     */
+    static resetInstance() {
+        SubAgentMessageQueue.instance = null;
+    }
+    /**
+     * Enqueue a message for a session that is not yet active.
+     * If the queue exceeds MAX_QUEUE_SIZE, the oldest message is dropped.
+     *
+     * @param sessionName - The target agent session name
+     * @param data - The raw data string to deliver later
+     */
+    enqueue(sessionName, data) {
+        let queue = this.pendingMessages.get(sessionName);
+        if (!queue) {
+            queue = [];
+            this.pendingMessages.set(sessionName, queue);
+        }
+        // Drop oldest if at capacity
+        if (queue.length >= SUB_AGENT_QUEUE_CONSTANTS.MAX_QUEUE_SIZE) {
+            const dropped = queue.shift();
+            this.logger.warn('Queue at capacity, dropping oldest message', {
+                sessionName,
+                droppedAt: dropped?.queuedAt,
+                queueSize: queue.length,
+            });
+        }
+        queue.push({
+            data,
+            queuedAt: Date.now(),
+            sessionName,
+        });
+        this.logger.info('Message queued for sub-agent', {
+            sessionName,
+            queueSize: queue.length,
+            dataLength: data.length,
+        });
+    }
+    /**
+     * Dequeue all pending messages for a session (FIFO order).
+     * The queue is cleared after dequeuing.
+     *
+     * @param sessionName - The agent session name
+     * @returns Array of queued messages in insertion order, or empty array
+     */
+    dequeueAll(sessionName) {
+        const queue = this.pendingMessages.get(sessionName);
+        if (!queue || queue.length === 0) {
+            return [];
+        }
+        const messages = [...queue];
+        this.pendingMessages.delete(sessionName);
+        this.logger.info('Dequeued all messages for sub-agent', {
+            sessionName,
+            count: messages.length,
+        });
+        return messages;
+    }
+    /**
+     * Check if there are pending messages for a session.
+     *
+     * @param sessionName - The agent session name
+     * @returns True if there are pending messages
+     */
+    hasPending(sessionName) {
+        const queue = this.pendingMessages.get(sessionName);
+        return !!queue && queue.length > 0;
+    }
+    /**
+     * Clear all pending messages for a session (e.g. on agent stop/exit).
+     *
+     * @param sessionName - The agent session name
+     */
+    clear(sessionName) {
+        const queue = this.pendingMessages.get(sessionName);
+        if (queue && queue.length > 0) {
+            this.logger.info('Clearing queued messages for session', {
+                sessionName,
+                droppedCount: queue.length,
+            });
+        }
+        this.pendingMessages.delete(sessionName);
+    }
+    /**
+     * Get the number of pending messages for a session.
+     *
+     * @param sessionName - The agent session name
+     * @returns Number of pending messages
+     */
+    getQueueSize(sessionName) {
+        const queue = this.pendingMessages.get(sessionName);
+        return queue ? queue.length : 0;
+    }
+}
+//# sourceMappingURL=sub-agent-message-queue.service.js.map

package/dist/backend/backend/src/services/messaging/sub-agent-message-queue.service.js.map

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

package/dist/backend/backend/src/services/monitoring/activity-monitor.service.d.ts

@@ -0,0 +1,113 @@
+import { type WorkingStatus } from '../../constants.js';
+/**
+ * Team Working Status File Structure
+ * Tracks ONLY workingStatus (idle vs in_progress) based on terminal activity
+ * agentStatus is now managed by AgentHeartbeatService via MCP calls
+ */
+export interface TeamWorkingStatusFile {
+    /** Orchestrator working status */
+    orchestrator: {
+        sessionName: string;
+        workingStatus: WorkingStatus;
+        lastActivityCheck: string;
+        updatedAt: string;
+    };
+    /** Team member working statuses indexed by sessionName */
+    teamMembers: Record<string, {
+        sessionName: string;
+        teamMemberId: string;
+        workingStatus: WorkingStatus;
+        lastActivityCheck: string;
+        updatedAt: string;
+    }>;
+    /** File metadata */
+    metadata: {
+        lastUpdated: string;
+        version: string;
+    };
+}
+/**
+ * Activity Monitor Service - NEW ARCHITECTURE
+ *
+ * Responsibilities:
+ * - Track ONLY workingStatus (idle vs in_progress) based on terminal activity
+ * - Create and manage teamWorkingStatus.json file
+ * - Integrate with AgentHeartbeatService for stale agent detection
+ * - Remove ALL agentStatus management (now owned by AgentHeartbeatService)
+ *
+ * Key Changes:
+ * - No more agentStatus updates to teams.json
+ * - Simple activity detection: output changed = in_progress, else = idle
+ * - Integration with stale detection (30-minute threshold)
+ * - Separate teamWorkingStatus.json file for working statuses
+ */
+export declare class ActivityMonitorService {
+    private static instance;
+    private logger;
+    private storageService;
+    private _sessionBackend;
+    private agentHeartbeatService;
+    private intervalId;
+    private readonly POLLING_INTERVAL;
+    private lastTerminalOutputs;
+    private readonly MAX_OUTPUT_SIZE;
+    private readonly ACTIVITY_CHECK_TIMEOUT;
+    private lastCleanup;
+    private crewlyHome;
+    private teamWorkingStatusFile;
+    private constructor();
+    /**
+     * Get the session backend, lazily initializing if needed.
+     */
+    private getBackend;
+    /**
+     * Get the session backend synchronously (may return null if not initialized).
+     */
+    private get sessionBackend();
+    static getInstance(): ActivityMonitorService;
+    startPolling(): void;
+    stopPolling(): void;
+    private performActivityCheck;
+    /**
+     * NEW ARCHITECTURE: Simplified activity checking
+     *
+     * This method now:
+     * 1. Detects stale agents via AgentHeartbeatService (30-minute threshold)
+     * 2. Checks terminal activity for working status (ONLY)
+     * 3. Updates teamWorkingStatus.json (separate from teams.json)
+     * 4. Removes ALL agentStatus logic (handled by AgentHeartbeatService)
+     */
+    private performActivityCheckInternal;
+    /**
+     * Load teamWorkingStatus.json file with proper initialization
+     */
+    private loadTeamWorkingStatusFile;
+    /**
+     * Save teamWorkingStatus.json file with atomic write
+     */
+    private saveTeamWorkingStatusFile;
+    /**
+     * Create default teamWorkingStatus.json structure
+     */
+    private createDefaultTeamWorkingStatusFile;
+    /**
+     * Cleanup old terminal outputs and perform garbage collection
+     */
+    private performPeriodicCleanup;
+    /**
+     * Get terminal output with size limits for activity detection
+     */
+    private getTerminalOutput;
+    isRunning(): boolean;
+    getPollingInterval(): number;
+    /**
+     * Get current team working status data
+     * Useful for external services that need to check working statuses
+     */
+    getTeamWorkingStatus(): Promise<TeamWorkingStatusFile>;
+    /**
+     * Get working status for a specific session
+     */
+    getWorkingStatusForSession(sessionName: string): Promise<WorkingStatus | null>;
+}
+//# sourceMappingURL=activity-monitor.service.d.ts.map

package/dist/backend/backend/src/services/monitoring/activity-monitor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-monitor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/monitoring/activity-monitor.service.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG5H;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,aAAa,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,aAAa,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,oBAAoB;IACpB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAChD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAO;IACvC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;IAC/C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,qBAAqB,CAAS;IAEtC,OAAO;IAQP;;OAEG;YACW,UAAU;IAUxB;;OAEG;IACH,OAAO,KAAK,cAAc,GAKzB;WAEa,WAAW,IAAI,sBAAsB;IAO5C,YAAY,IAAI,IAAI;IAiBpB,WAAW,IAAI,IAAI;YAQZ,oBAAoB;IAoBlC;;;;;;;;OAQG;YACW,4BAA4B;IA0N1C;;OAEG;YACW,yBAAyB;IA+BvC;;OAEG;YACW,yBAAyB;IAiBvC;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAiB1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiC9B;;OAEG;YACW,iBAAiB;IAmBxB,SAAS,IAAI,OAAO;IAIpB,kBAAkB,IAAI,MAAM;IAInC;;;OAGG;IACU,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAInE;;OAEG;IACU,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAiB5F"}