crewly 1.4.2 → 1.4.4

package/dist/backend/backend/src/services/cloud/relay-client.service.d.ts

@@ -1,21 +1,21 @@
 /**
  * Relay Client Service
  *
- * WebSocket client that connects to a Relay Server for inter-node
- * communication when direct connections are unavailable (NAT/firewall).
+ * HTTP polling-based client that connects to a Cloud Message Queue for
+ * inter-node communication when direct connections are unavailable (NAT/firewall).
  *
- * Flow: Node A (Agent) <-> Cloud (Relay) <-> Node B (Orchestrator)
+ * Flow: Node A (Agent) <-> Cloud (Queue) <-> Node B (Orchestrator)
  *
  * Features:
- * - Automatic fallback from direct connection to relay mode
+ * - HTTP-based registration and message polling (replaces WebSocket)
  * - End-to-end encryption (E2EE) — relay never sees plaintext
- * - Heartbeat keep-alive with auto-reconnection
- * - Exponential backoff on reconnection failures
+ * - Exponential backoff on registration failures
+ * - Automatic message acknowledgement after processing
  *
  * @module services/cloud/relay-client.service
  */
 import { EventEmitter } from 'events';
-import { type RelayClientConfig, type RelayClientState, type RelaySessionId } from './relay.types.js';
+import type { RelayClientConfig, RelayClientState, RelaySessionId } from './relay.types.js';
 export interface RelayClientEvents {
     /** Emitted when successfully paired with a peer */
     paired: (peerSessionId: RelaySessionId, peerRole: string) => void;
@@ -31,22 +31,22 @@ export interface RelayClientEvents {
 /**
  * RelayClientService singleton.
  *
- * Manages a WebSocket connection to a relay server, handles registration,
- * heartbeats, reconnection, and encrypts/decrypts messages for E2EE.
+ * Manages HTTP-based registration, polling, and message exchange with
+ * a Cloud Message Queue. Encrypts/decrypts messages for E2EE.
  */
 export declare class RelayClientService extends EventEmitter {
     private static instance;
     private readonly logger;
-    /** Current WebSocket connection */
-    private ws;
     /** Client configuration (set via connect()) */
     private config;
     /** Current connection state */
     private state;
-    /** Assigned session ID after registration */
+    /** Assigned queue ID after registration (used as sessionId) */
     private sessionId;
-    /** Heartbeat interval timer */
-    private heartbeatInterval;
+    /** Peer's queue ID for sending messages */
+    private peerQueueId;
+    /** Polling interval timer */
+    private pollInterval;
     /** Reconnection attempt counter */
     private reconnectAttempts;
     /** Reconnection timer */
@@ -57,6 +57,8 @@ export declare class RelayClientService extends EventEmitter {
     private salt;
     /** Whether disconnect was intentional (skip reconnect) */
     private intentionalDisconnect;
+    /** Timestamp of last seen message for pagination */
+    private lastSeenTimestamp;
     private constructor();
     /**
      * Get the singleton instance.
@@ -69,10 +71,10 @@ export declare class RelayClientService extends EventEmitter {
      */
     static resetInstance(): void;
     /**
-     * Connect to a relay server.
+     * Connect to the Cloud Message Queue.
      *
-     * Establishes the WebSocket connection, sends a register message,
-     * and derives the E2EE encryption key from the shared secret.
+     * Registers via HTTP POST, derives the E2EE encryption key,
+     * and starts polling for messages if not immediately paired.
      *
      * @param config - Relay client configuration
      *
@@ -80,7 +82,7 @@ export declare class RelayClientService extends EventEmitter {
      * ```ts
      * const client = RelayClientService.getInstance();
      * client.connect({
-     *   wsUrl: 'ws://cloud.crewly.dev:8787/relay',
+     *   apiUrl: 'https://api.crewlyai.com',
      *   pairingCode: 'abc-123',
      *   role: 'agent',
      *   token: 'sk-xxx',
@@ -91,13 +93,13 @@ export declare class RelayClientService extends EventEmitter {
      */
     connect(config: RelayClientConfig): void;
     /**
-     * Disconnect from the relay server.
+     * Disconnect from the Cloud Message Queue.
      *
-     * Closes the WebSocket cleanly and stops heartbeats and reconnection.
+     * Stops polling and cleans up all timers.
      */
     disconnect(): void;
     /**
-     * Send an encrypted message to the paired peer via the relay.
+     * Send an encrypted message to the paired peer via the Cloud Queue.
      *
      * The message is encrypted locally before being sent — the relay
      * server only forwards the opaque ciphertext.
@@ -118,49 +120,50 @@ export declare class RelayClientService extends EventEmitter {
      */
     getState(): RelayClientState;
     /**
-     * Get the assigned session ID (available after registration).
+     * Get the assigned session ID (queue ID, available after registration).
      *
      * @returns Session ID or null if not registered
      */
     getSessionId(): RelaySessionId | null;
     /**
-     * Establish the WebSocket connection and set up handlers.
+     * Register with the Cloud Message Queue via HTTP POST.
      */
-    private doConnect;
+    private doRegister;
     /**
-     * Send the registration message to the relay server.
+     * Start the polling interval to fetch new messages from the queue.
      */
-    private sendRegister;
+    private startPolling;
     /**
-     * Handle an incoming WebSocket message.
-     *
-     * @param data - Raw message data
+     * Stop the polling interval.
+     */
+    private stopPolling;
+    /**
+     * Poll the queue for new messages and process them.
      */
-    private handleMessage;
+    private poll;
     /**
-     * Handle an incoming relay data message by decrypting the payload.
+     * Handle a single queue message payload by decrypting it.
      *
-     * @param msg - Relay data message with encrypted payload
+     * @param payload - Encrypted payload string
      */
-    private handleRelayData;
+    private handleQueueMessage;
     /**
-     * Start the heartbeat interval to keep the connection alive.
+     * Acknowledge processed messages so they are not re-delivered.
+     *
+     * @param messageIds - Array of message IDs to acknowledge
      */
-    private startHeartbeat;
+    private ackMessages;
     /**
-     * Stop the heartbeat interval.
+     * Send an encrypted payload to the peer via HTTP POST.
+     *
+     * @param payload - Serialized encrypted envelope
      */
-    private stopHeartbeat;
+    private sendViaHttp;
     /**
      * Schedule a reconnection attempt with exponential backoff.
+     * Applied to HTTP register failures.
      */
     private scheduleReconnect;
-    /**
-     * Send a raw relay message over the WebSocket.
-     *
-     * @param message - Relay message to send
-     */
-    private sendRaw;
     /**
      * Update the client state and emit a stateChange event.
      *
@@ -168,7 +171,7 @@ export declare class RelayClientService extends EventEmitter {
      */
     private setState;
     /**
-     * Clean up timers and close the WebSocket connection.
+     * Clean up timers and reset connection state.
      */
     private cleanup;
 }

package/dist/backend/backend/src/services/cloud/relay-client.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-client.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/relay-client.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAKpB,MAAM,kBAAkB,CAAC;AAgB1B,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,iEAAiE;IACjE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wCAAwC;IACxC,gBAAgB,EAAE,CAAC,aAAa,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1D,4CAA4C;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,wBAAwB;IACxB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAMD;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAA0B;IACpC,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAkC;IAChD,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAoC;IACjD,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAA+B;IAChD,+BAA+B;IAC/B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,mCAAmC;IACnC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,yBAAyB;IACzB,OAAO,CAAC,cAAc,CAA8C;IACpE,6BAA6B;IAC7B,OAAO,CAAC,aAAa,CAAuB;IAC5C,kEAAkE;IAClE,OAAO,CAAC,IAAI,CAAuB;IACnC,0DAA0D;IAC1D,OAAO,CAAC,qBAAqB,CAAS;IAEtC,OAAO;IAKP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAY5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAiBxC;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAe7B;;;;OAIG;IACH,QAAQ,IAAI,gBAAgB;IAI5B;;;;OAIG;IACH,YAAY,IAAI,cAAc,GAAG,IAAI;IAQrC;;OAEG;IACH,OAAO,CAAC,SAAS;IA6CjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAyDrB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAMf;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,OAAO;CAkBhB"}
+{"version":3,"file":"relay-client.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/relay-client.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EAGf,MAAM,kBAAkB,CAAC;AAgB1B,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,iEAAiE;IACjE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wCAAwC;IACxC,gBAAgB,EAAE,CAAC,aAAa,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1D,4CAA4C;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,wBAAwB;IACxB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAMD;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAkC;IAChD,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAoC;IACjD,+DAA+D;IAC/D,OAAO,CAAC,SAAS,CAA+B;IAChD,2CAA2C;IAC3C,OAAO,CAAC,WAAW,CAAuB;IAC1C,6BAA6B;IAC7B,OAAO,CAAC,YAAY,CAA+C;IACnE,mCAAmC;IACnC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,yBAAyB;IACzB,OAAO,CAAC,cAAc,CAA8C;IACpE,6BAA6B;IAC7B,OAAO,CAAC,aAAa,CAAuB;IAC5C,kEAAkE;IAClE,OAAO,CAAC,IAAI,CAAuB;IACnC,0DAA0D;IAC1D,OAAO,CAAC,qBAAqB,CAAS;IACtC,oDAAoD;IACpD,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,OAAO;IAKP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAOxC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAY5B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAkBxC;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAMlB;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAiB7B;;;;OAIG;IACH,QAAQ,IAAI,gBAAgB;IAI5B;;;;OAIG;IACH,YAAY,IAAI,cAAc,GAAG,IAAI;IAQrC;;OAEG;YACW,UAAU;IAyDxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,IAAI;IAkDlB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;OAIG;YACW,WAAW;IA0BzB;;;;OAIG;YACW,WAAW;IA8BzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,OAAO,CAAC,OAAO;CAWhB"}