crewly 1.4.47 → 1.4.49

package/dist/backend/backend/src/services/cloud/cloud-sync.service.js

@@ -0,0 +1,484 @@
+/**
+ * Cloud Sync Service
+ *
+ * Singleton service that replaces the WebSocket Relay pairing model with a
+ * simpler heartbeat + polling architecture. All devices under the same Cloud
+ * account are automatically visible and can exchange messages.
+ *
+ * Responsibilities:
+ * - Heartbeat: periodically uploads device status to Cloud
+ * - Device poll: periodically fetches the device list for the account
+ * - Message poll: periodically fetches pending messages for this device
+ * - Send: posts messages to specific devices via Cloud
+ *
+ * @see docs/cloud-sync-design.md
+ * @module services/cloud/cloud-sync.service
+ */
+import { EventEmitter } from 'events';
+import { LoggerService } from '../core/logger.service.js';
+import { StorageService } from '../core/storage.service.js';
+import { CLOUD_SYNC_CONSTANTS } from '../../constants.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read the Crewly version from package.json (best-effort).
+ *
+ * @returns Version string or 'unknown'
+ */
+async function readVersion() {
+    try {
+        const { readFile } = await import('fs/promises');
+        const { join } = await import('path');
+        const pkg = JSON.parse(await readFile(join(process.cwd(), 'package.json'), 'utf-8'));
+        return pkg.version || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Gather active team summaries from StorageService.
+ *
+ * @returns Array of team summaries for heartbeat payload
+ */
+async function gatherTeamSummaries() {
+    try {
+        const storage = StorageService.getInstance();
+        const teams = await storage.getTeams();
+        return teams.map((team) => ({
+            id: team.id,
+            name: team.name,
+            memberCount: team.members?.length ?? 0,
+            activeAgents: team.members?.filter((m) => m.agentStatus === 'active').length ?? 0,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * CloudSyncService singleton.
+ *
+ * Manages heartbeat, device discovery, and message polling for the
+ * Cloud Sync system. Extends EventEmitter to notify consumers of
+ * device and message changes.
+ *
+ * Events:
+ * - `devices_updated` — Fired when the device list changes. Payload: SyncDevice[]
+ * - `message` — Fired for each incoming message. Payload: IncomingMessage
+ * - `device_online` — Fired when a device comes online. Payload: SyncDevice
+ * - `device_offline` — Fired when a device goes offline. Payload: SyncDevice
+ *
+ * @example
+ * ```typescript
+ * const sync = CloudSyncService.getInstance();
+ * sync.start({ cloudUrl, token, deviceId, deviceName });
+ * sync.on('message', (msg) => console.log('Received:', msg));
+ * sync.on('devices_updated', (devices) => console.log('Devices:', devices));
+ * ```
+ */
+export class CloudSyncService extends EventEmitter {
+    static instance = null;
+    logger;
+    /** Current service state */
+    state = 'stopped';
+    /** Configuration (set on start) */
+    config = null;
+    /** Cached device list from last poll */
+    devices = [];
+    /** Cached Crewly version */
+    version = 'unknown';
+    /** Heartbeat timer handle */
+    heartbeatTimer = null;
+    /** Device poll timer handle */
+    devicePollTimer = null;
+    /** Message poll timer handle */
+    messagePollTimer = null;
+    /** Consecutive heartbeat failure count */
+    heartbeatFailures = 0;
+    /** Consecutive device poll failure count */
+    devicePollFailures = 0;
+    /** Consecutive message poll failure count */
+    messagePollFailures = 0;
+    constructor() {
+        super();
+        this.logger = LoggerService.getInstance().createComponentLogger('CloudSyncService');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns CloudSyncService instance
+     */
+    static getInstance() {
+        if (!CloudSyncService.instance) {
+            CloudSyncService.instance = new CloudSyncService();
+        }
+        return CloudSyncService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        if (CloudSyncService.instance) {
+            CloudSyncService.instance.stop();
+        }
+        CloudSyncService.instance = null;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Start the Cloud Sync service.
+     *
+     * Begins heartbeat, device polling, and message polling timers.
+     * Performs an immediate heartbeat and device poll on start.
+     *
+     * @param config - Cloud connection configuration
+     */
+    start(config) {
+        if (this.state === 'syncing') {
+            this.logger.warn('CloudSyncService already running, ignoring start()');
+            return;
+        }
+        this.config = config;
+        this.state = 'syncing';
+        this.heartbeatFailures = 0;
+        this.devicePollFailures = 0;
+        this.messagePollFailures = 0;
+        this.logger.info('Starting Cloud Sync', {
+            cloudUrl: config.cloudUrl,
+            deviceId: config.deviceId,
+            deviceName: config.deviceName,
+        });
+        // Read version once at startup
+        readVersion().then((v) => { this.version = v; }).catch(() => { });
+        // Perform initial sync immediately
+        this.sendHeartbeat().catch(() => { });
+        this.pollDevices().catch(() => { });
+        // Start periodic timers
+        this.heartbeatTimer = setInterval(() => { this.sendHeartbeat().catch(() => { }); }, CLOUD_SYNC_CONSTANTS.HEARTBEAT_INTERVAL_MS);
+        this.devicePollTimer = setInterval(() => { this.pollDevices().catch(() => { }); }, CLOUD_SYNC_CONSTANTS.DEVICE_POLL_INTERVAL_MS);
+        this.messagePollTimer = setInterval(() => { this.pollMessages().catch(() => { }); }, CLOUD_SYNC_CONSTANTS.MESSAGE_POLL_INTERVAL_MS);
+        // Unref timers so they don't keep the process alive
+        if (this.heartbeatTimer.unref)
+            this.heartbeatTimer.unref();
+        if (this.devicePollTimer.unref)
+            this.devicePollTimer.unref();
+        if (this.messagePollTimer.unref)
+            this.messagePollTimer.unref();
+    }
+    /**
+     * Stop the Cloud Sync service.
+     *
+     * Clears all timers and resets state. Safe to call multiple times.
+     */
+    stop() {
+        if (this.state === 'stopped')
+            return;
+        this.logger.info('Stopping Cloud Sync');
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.devicePollTimer) {
+            clearInterval(this.devicePollTimer);
+            this.devicePollTimer = null;
+        }
+        if (this.messagePollTimer) {
+            clearInterval(this.messagePollTimer);
+            this.messagePollTimer = null;
+        }
+        this.state = 'stopped';
+        this.config = null;
+        this.devices = [];
+        this.heartbeatFailures = 0;
+        this.devicePollFailures = 0;
+        this.messagePollFailures = 0;
+    }
+    /**
+     * Check if the sync service has been started.
+     *
+     * @returns True if the service is currently syncing
+     */
+    isStarted() {
+        return this.state === 'syncing';
+    }
+    /**
+     * Get the current service state.
+     *
+     * @returns Current CloudSyncState
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get all cached devices for this Cloud account.
+     *
+     * @returns Array of SyncDevice objects (may include offline devices)
+     */
+    getDevices() {
+        return [...this.devices];
+    }
+    /**
+     * Get only online devices (excluding this device).
+     *
+     * @returns Array of online SyncDevice objects
+     */
+    getOnlineDevices() {
+        return this.devices.filter((d) => d.status === 'online' && !d.isLocal);
+    }
+    /**
+     * Send a message to another device via the Cloud message queue.
+     *
+     * @param toDeviceId - Target device identifier
+     * @param type - Message type
+     * @param payload - Message payload (must be JSON-serializable)
+     * @throws Error when not started or API call fails
+     *
+     * @example
+     * ```typescript
+     * await sync.sendMessage('dev-456', 'command', {
+     *   action: 'delegate-task',
+     *   content: 'Implement feature X'
+     * });
+     * ```
+     */
+    async sendMessage(toDeviceId, type, payload) {
+        if (!this.config) {
+            throw new Error('CloudSyncService not started. Call start() first.');
+        }
+        const url = `${this.config.cloudUrl}${CLOUD_SYNC_CONSTANTS.ENDPOINTS.MESSAGES}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: this.authHeaders(),
+            body: JSON.stringify({
+                to: toDeviceId,
+                type,
+                payload,
+                encrypted: false,
+            }),
+            signal: AbortSignal.timeout(CLOUD_SYNC_CONSTANTS.REQUEST_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => '');
+            throw new Error(`Failed to send message: ${response.status} ${errorText}`);
+        }
+        this.logger.info('Message sent via Cloud Sync', { to: toDeviceId, type });
+    }
+    // -------------------------------------------------------------------------
+    // Internal: Heartbeat
+    // -------------------------------------------------------------------------
+    /**
+     * Send a heartbeat to the Cloud server with current device state.
+     * Called periodically by the heartbeat timer.
+     */
+    async sendHeartbeat() {
+        if (!this.config)
+            return;
+        try {
+            const teams = await gatherTeamSummaries();
+            const payload = {
+                deviceId: this.config.deviceId,
+                deviceName: this.config.deviceName,
+                status: 'online',
+                version: this.version,
+                capabilities: ['orchestrator', 'agent-runner'],
+                teams,
+                timestamp: new Date().toISOString(),
+            };
+            const url = `${this.config.cloudUrl}${CLOUD_SYNC_CONSTANTS.ENDPOINTS.HEARTBEAT}`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: this.authHeaders(),
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(CLOUD_SYNC_CONSTANTS.REQUEST_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                throw new Error(`Heartbeat failed: ${response.status}`);
+            }
+            this.heartbeatFailures = 0;
+        }
+        catch (error) {
+            this.heartbeatFailures++;
+            this.logger.warn('Heartbeat failed', {
+                error: error instanceof Error ? error.message : String(error),
+                failures: this.heartbeatFailures,
+            });
+            this.checkErrorThreshold();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal: Device Polling
+    // -------------------------------------------------------------------------
+    /**
+     * Poll the Cloud server for the current device list.
+     * Updates the cached device list and emits events on changes.
+     */
+    async pollDevices() {
+        if (!this.config)
+            return;
+        try {
+            const url = `${this.config.cloudUrl}${CLOUD_SYNC_CONSTANTS.ENDPOINTS.DEVICES}`;
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: this.authHeaders(),
+                signal: AbortSignal.timeout(CLOUD_SYNC_CONSTANTS.REQUEST_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                throw new Error(`Device poll failed: ${response.status}`);
+            }
+            const data = await response.json();
+            if (!data.success || !data.devices) {
+                throw new Error('Device poll returned unsuccessful response');
+            }
+            const previousOnlineIds = new Set(this.devices.filter((d) => d.status === 'online').map((d) => d.deviceId));
+            // Normalize devices: mark local, determine online status
+            const offlineThreshold = CLOUD_SYNC_CONSTANTS.OFFLINE_THRESHOLD_MS;
+            const now = Date.now();
+            const updatedDevices = data.devices.map((d) => ({
+                ...d,
+                status: (now - new Date(d.lastHeartbeatAt).getTime() > offlineThreshold)
+                    ? 'offline'
+                    : 'online',
+                isLocal: d.deviceId === this.config.deviceId,
+            }));
+            // Detect online/offline transitions
+            const newOnlineIds = new Set(updatedDevices.filter((d) => d.status === 'online').map((d) => d.deviceId));
+            for (const device of updatedDevices) {
+                if (device.status === 'online' && !previousOnlineIds.has(device.deviceId) && !device.isLocal) {
+                    this.emit('device_online', device);
+                }
+            }
+            for (const prevId of previousOnlineIds) {
+                if (!newOnlineIds.has(prevId) && prevId !== this.config.deviceId) {
+                    const offlineDevice = this.devices.find((d) => d.deviceId === prevId);
+                    if (offlineDevice) {
+                        this.emit('device_offline', { ...offlineDevice, status: 'offline' });
+                    }
+                }
+            }
+            this.devices = updatedDevices;
+            this.devicePollFailures = 0;
+            this.emit('devices_updated', this.getDevices());
+        }
+        catch (error) {
+            this.devicePollFailures++;
+            this.logger.warn('Device poll failed', {
+                error: error instanceof Error ? error.message : String(error),
+                failures: this.devicePollFailures,
+            });
+            this.checkErrorThreshold();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal: Message Polling
+    // -------------------------------------------------------------------------
+    /**
+     * Poll the Cloud server for pending messages addressed to this device.
+     * Emits 'message' event for each received message, then acknowledges.
+     */
+    async pollMessages() {
+        if (!this.config)
+            return;
+        try {
+            const url = `${this.config.cloudUrl}${CLOUD_SYNC_CONSTANTS.ENDPOINTS.MESSAGES}?deviceId=${encodeURIComponent(this.config.deviceId)}&limit=50`;
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: this.authHeaders(),
+                signal: AbortSignal.timeout(CLOUD_SYNC_CONSTANTS.REQUEST_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                throw new Error(`Message poll failed: ${response.status}`);
+            }
+            const data = await response.json();
+            if (!data.success || !data.messages || data.messages.length === 0) {
+                this.messagePollFailures = 0;
+                return;
+            }
+            // Emit each message
+            const messageIds = [];
+            for (const msg of data.messages) {
+                this.emit('message', msg);
+                messageIds.push(msg.id);
+            }
+            // Acknowledge processed messages
+            await this.ackMessages(messageIds);
+            this.messagePollFailures = 0;
+            this.logger.debug('Polled and processed messages', { count: data.messages.length });
+        }
+        catch (error) {
+            this.messagePollFailures++;
+            this.logger.warn('Message poll failed', {
+                error: error instanceof Error ? error.message : String(error),
+                failures: this.messagePollFailures,
+            });
+            this.checkErrorThreshold();
+        }
+    }
+    /**
+     * Acknowledge processed messages so Cloud can remove them from the queue.
+     *
+     * @param messageIds - Array of message IDs to acknowledge
+     */
+    async ackMessages(messageIds) {
+        if (!this.config || messageIds.length === 0)
+            return;
+        try {
+            const url = `${this.config.cloudUrl}${CLOUD_SYNC_CONSTANTS.ENDPOINTS.MESSAGES_ACK}`;
+            await fetch(url, {
+                method: 'POST',
+                headers: this.authHeaders(),
+                body: JSON.stringify({
+                    deviceId: this.config.deviceId,
+                    messageIds,
+                }),
+                signal: AbortSignal.timeout(CLOUD_SYNC_CONSTANTS.REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            this.logger.warn('Message ACK failed (non-fatal)', {
+                error: error instanceof Error ? error.message : String(error),
+                messageIds,
+            });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal: Error Handling
+    // -------------------------------------------------------------------------
+    /**
+     * Check if any failure counter has exceeded the threshold.
+     * If so, transition to error state.
+     */
+    checkErrorThreshold() {
+        const max = CLOUD_SYNC_CONSTANTS.MAX_CONSECUTIVE_FAILURES;
+        if (this.heartbeatFailures >= max ||
+            this.devicePollFailures >= max ||
+            this.messagePollFailures >= max) {
+            this.logger.error('Cloud Sync entering error state after repeated failures', {
+                heartbeatFailures: this.heartbeatFailures,
+                devicePollFailures: this.devicePollFailures,
+                messagePollFailures: this.messagePollFailures,
+            });
+            this.state = 'error';
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal: Helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Build authorization headers for Cloud API requests.
+     *
+     * @returns Headers with Bearer token and Content-Type
+     */
+    authHeaders() {
+        return {
+            Authorization: `Bearer ${this.config?.token ?? ''}`,
+            'Content-Type': 'application/json',
+        };
+    }
+}
+//# sourceMappingURL=cloud-sync.service.js.map

package/dist/backend/backend/src/services/cloud/cloud-sync.service.js.map

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

package/dist/backend/backend/src/services/cloud/cloud-sync.types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Cloud Sync Type Definitions
+ *
+ * Defines the data structures for the Cloud Sync system that replaces
+ * the WebSocket Relay pairing model. All devices under the same Cloud
+ * account are automatically visible and can exchange messages.
+ *
+ * @see docs/cloud-sync-design.md
+ * @module services/cloud/cloud-sync.types
+ */
+/** Possible states of the CloudSyncService lifecycle. */
+export type CloudSyncState = 'stopped' | 'syncing' | 'error';
+/** Valid cloud sync state values for runtime validation. */
+export declare const CLOUD_SYNC_STATES: readonly ["stopped", "syncing", "error"];
+/**
+ * Configuration required to start the CloudSyncService.
+ * Obtained from CloudClientService credentials and DeviceIdentityService.
+ */
+export interface CloudSyncConfig {
+    /** Cloud API base URL (e.g. "https://api.crewlyai.com") */
+    cloudUrl: string;
+    /** Bearer token for Cloud API authentication */
+    token: string;
+    /** Unique device identifier from ~/.crewly/device.json */
+    deviceId: string;
+    /** Human-readable device name (OS hostname) */
+    deviceName: string;
+}
+/** Summary of a team on a device, included in heartbeat payloads. */
+export interface SyncTeamSummary {
+    /** Team identifier */
+    id: string;
+    /** Team display name */
+    name: string;
+    /** Number of configured team members */
+    memberCount: number;
+    /** Number of currently active agents */
+    activeAgents: number;
+}
+/**
+ * A device visible in the same Cloud account.
+ * Populated by polling GET /v1/devices.
+ */
+export interface SyncDevice {
+    /** Unique device identifier (UUID) */
+    deviceId: string;
+    /** Human-readable device name (hostname) */
+    deviceName: string;
+    /** Whether the device is online or offline (based on heartbeat freshness) */
+    status: 'online' | 'offline';
+    /** Crewly version running on the device */
+    version?: string;
+    /** Device capabilities (e.g. orchestrator, agent-runner, mcp-server) */
+    capabilities?: string[];
+    /** Active teams on the device */
+    teams?: SyncTeamSummary[];
+    /** ISO timestamp of last heartbeat */
+    lastHeartbeatAt: string;
+    /** Whether this device is the local OSS instance */
+    isLocal?: boolean;
+}
+/**
+ * Payload sent to Cloud in the heartbeat POST.
+ * Uploaded every HEARTBEAT_INTERVAL_MS (30s).
+ */
+export interface HeartbeatPayload {
+    /** Unique device identifier */
+    deviceId: string;
+    /** Human-readable device name (hostname) */
+    deviceName: string;
+    /** Device status */
+    status: 'online';
+    /** Crewly version */
+    version: string;
+    /** Device capabilities */
+    capabilities: string[];
+    /** Active teams on this device */
+    teams: SyncTeamSummary[];
+    /** ISO timestamp */
+    timestamp: string;
+}
+/** All supported message types for inter-device communication. */
+export type MessageType = 'command' | 'sync_teams' | 'sync_settings' | 'notification' | 'relay' | 'ping' | 'task_update';
+/** Valid message type values for runtime validation. */
+export declare const MESSAGE_TYPES: readonly MessageType[];
+/**
+ * An incoming message received from another device via Cloud polling.
+ */
+export interface IncomingMessage {
+    /** Unique message identifier */
+    id: string;
+    /** Device ID of the sender */
+    from: string;
+    /** Human-readable name of the sending device */
+    fromDeviceName: string;
+    /** Message type */
+    type: MessageType;
+    /** Message payload (structure varies by type) */
+    payload: unknown;
+    /** Whether the payload is E2EE encrypted */
+    encrypted: boolean;
+    /** ISO timestamp when the message was sent */
+    sentAt: string;
+}
+/**
+ * Payload for a command message sent between devices.
+ */
+export interface CommandPayload {
+    /** The action to perform */
+    action: string;
+    /** Optional task identifier */
+    taskId?: string;
+    /** Optional team identifier */
+    teamId?: string;
+    /** Optional agent session name */
+    agentSession?: string;
+    /** Free-text content */
+    content?: string;
+}
+/**
+ * Payload for a notification message.
+ */
+export interface NotificationPayload {
+    /** Notification title */
+    title: string;
+    /** Notification body */
+    message: string;
+    /** Urgency level */
+    urgency: 'low' | 'normal' | 'high';
+    /** Optional team identifier */
+    teamId?: string;
+}
+/**
+ * Payload for a task_update message.
+ */
+export interface TaskUpdatePayload {
+    /** Task identifier */
+    taskId: string;
+    /** Current task status */
+    status: string;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Summary of what was done */
+    summary?: string;
+}
+/**
+ * Check if a value is a valid CloudSyncState.
+ *
+ * @param value - Value to check
+ * @returns True if the value is a valid CloudSyncState
+ */
+export declare function isCloudSyncState(value: unknown): value is CloudSyncState;
+/**
+ * Check if a value is a valid MessageType.
+ *
+ * @param value - Value to check
+ * @returns True if the value is a valid MessageType
+ */
+export declare function isMessageType(value: unknown): value is MessageType;
+/**
+ * Check if an object satisfies the SyncDevice interface shape.
+ *
+ * @param value - Value to check
+ * @returns True if the value has the required SyncDevice fields
+ */
+export declare function isSyncDevice(value: unknown): value is SyncDevice;
+/**
+ * Check if an object satisfies the IncomingMessage interface shape.
+ *
+ * @param value - Value to check
+ * @returns True if the value has the required IncomingMessage fields
+ */
+export declare function isIncomingMessage(value: unknown): value is IncomingMessage;
+/**
+ * Check if an object satisfies the CloudSyncConfig interface shape.
+ *
+ * @param value - Value to check
+ * @returns True if the value has the required CloudSyncConfig fields
+ */
+export declare function isCloudSyncConfig(value: unknown): value is CloudSyncConfig;
+//# sourceMappingURL=cloud-sync.types.d.ts.map