crewly 1.2.6 → 1.2.7

package/dist/backend/backend/src/services/messaging/adapters/google-chat-messenger.adapter.d.ts

@@ -1,47 +1,74 @@
 /**
  * Google Chat Messenger Adapter
  *
- * Messenger adapter for Google Chat using the Google Chat API (webhook or service account).
- * Supports sending messages to Google Chat spaces via incoming webhooks or
- * the Chat API with a service account.
+ * Messenger adapter for Google Chat supporting three connection modes:
+ * 1. **Webhook mode** — post messages via an incoming webhook URL (send-only)
+ * 2. **Service account mode** — send messages via the Chat API (send-only)
+ * 3. **Pub/Sub mode** — pull incoming messages from a Cloud Pub/Sub subscription
+ *    and reply via the Chat API (bidirectional, thread-aware)
+ *
+ * In Pub/Sub mode, a Google Chat App is configured to publish events to a
+ * Pub/Sub topic. Crewly pulls from the subscription, processes MESSAGE events,
+ * and replies in the same thread via the Chat API.
  *
  * @module services/messaging/adapters/google-chat-messenger.adapter
  */
-import { MessengerAdapter, MessengerPlatform } from '../messenger-adapter.interface.js';
+import { MessengerAdapter, MessengerPlatform, IncomingMessage } from '../messenger-adapter.interface.js';
 /**
- * Messenger adapter for Google Chat.
- *
- * Supports two modes:
- * 1. **Webhook mode** (simpler): uses an incoming webhook URL to post messages
- * 2. **Service account mode**: uses a service account key to call the Chat API
+ * Callback type for incoming messages from Pub/Sub pull.
+ */
+export type GoogleChatIncomingCallback = (msg: IncomingMessage) => void;
+/**
+ * Messenger adapter for Google Chat with Pub/Sub support.
  *
- * Webhook mode is used when `webhookUrl` is provided in config.
- * Service account mode is used when `serviceAccountKey` is provided.
+ * Supports webhook, service-account, and pubsub modes.
+ * Pub/Sub mode enables bidirectional communication with thread tracking.
  */
 export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
     readonly platform: MessengerPlatform;
+    /** Current connection mode */
+    private mode;
     /** Webhook URL for posting messages (webhook mode) */
     private webhookUrl;
-    /** Service account key JSON (service account mode) */
+    /** Service account key JSON string */
     private serviceAccountKey;
     /** Access token obtained from service account (cached) */
     private accessToken;
     /** Access token expiry timestamp */
     private tokenExpiresAt;
+    /** OAuth2 scopes for the current mode */
+    private tokenScopes;
+    /** Full Pub/Sub subscription resource name (e.g. projects/PROJECT/subscriptions/SUB) */
+    private subscriptionName;
+    /** GCP project ID (for Pub/Sub mode) */
+    private projectId;
+    /** Pub/Sub pull interval timer */
+    private pullIntervalTimer;
+    /** Callback for incoming messages */
+    private onIncomingMessage;
+    /** Consecutive pull failure count */
+    private consecutiveFailures;
+    /** Whether the pull loop is paused due to failures */
+    private pullPaused;
     /**
-     * Initialize the adapter by validating credentials.
+     * Initialize the adapter with the provided credentials.
      *
-     * @param config - Must contain either `webhookUrl` string or `serviceAccountKey` string
-     * @throws Error if neither credential is provided or validation fails
+     * Detects mode based on provided config fields:
+     * - `webhookUrl` → webhook mode
+     * - `serviceAccountKey` + `projectId` + `subscriptionName` → pubsub mode
+     * - `serviceAccountKey` alone → service-account mode
+     *
+     * @param config - Configuration object with credentials
+     * @throws Error if credentials are invalid or missing
      */
     initialize(config: Record<string, unknown>): Promise<void>;
     /**
      * Send a text message to a Google Chat space.
      *
      * In webhook mode, the `channel` parameter is ignored (webhook URL determines the space).
-     * In service account mode, `channel` is the space name (e.g., "spaces/AAAA...").
+     * In service-account/pubsub mode, `channel` is the space name (e.g., "spaces/AAAA...").
      *
-     * @param channel - Google Chat space name (used in service account mode)
+     * @param channel - Google Chat space name (used in service-account/pubsub mode)
      * @param text - Message content
      * @param options - Optional send options (threadId for threaded replies)
      * @throws Error if adapter is not initialized or send fails
@@ -52,7 +79,7 @@ export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
     /**
      * Get the current connection status.
      *
-     * @returns Status object with connected flag and platform identifier
+     * @returns Status object with connected flag, platform, and mode details
      */
     getStatus(): {
         connected: boolean;
@@ -60,9 +87,40 @@ export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
         details?: Record<string, unknown>;
     };
     /**
-     * Disconnect by clearing stored credentials.
+     * Disconnect by clearing stored credentials and stopping the pull loop.
      */
     disconnect(): Promise<void>;
+    /**
+     * Start the Pub/Sub pull loop that periodically fetches messages.
+     */
+    private startPubSubPull;
+    /**
+     * Stop the Pub/Sub pull loop.
+     */
+    private stopPubSubPull;
+    /**
+     * Pull messages from the Pub/Sub subscription, process them, and acknowledge.
+     *
+     * Each message is a base64-encoded Google Chat event JSON. Only MESSAGE-type
+     * events are forwarded to the incoming message callback. All messages are
+     * acknowledged regardless of type to prevent redelivery.
+     */
+    pullMessages(): Promise<void>;
+    /**
+     * Process a Google Chat event and forward MESSAGE events to the callback.
+     *
+     * Thread tracking: extracts the thread name from the event so that replies
+     * can be posted back to the same thread.
+     *
+     * @param event - Parsed Google Chat event payload
+     */
+    private processChatEvent;
+    /**
+     * Acknowledge processed messages to prevent redelivery.
+     *
+     * @param ackIds - Array of ack IDs from the pull response
+     */
+    private acknowledgeMessages;
     /**
      * Send a message via incoming webhook URL.
      *
@@ -73,18 +131,33 @@ export declare class GoogleChatMessengerAdapter implements MessengerAdapter {
     /**
      * Send a message via the Google Chat REST API using service account credentials.
      *
+     * When a threadId (thread name) is provided, the reply is posted to the same
+     * thread. This enables conversational thread tracking for Pub/Sub mode.
+     *
      * @param space - Space name (e.g., "spaces/AAAA...")
      * @param text - Message text
-     * @param threadKey - Optional thread key for threaded replies
+     * @param threadName - Optional full thread name (e.g., "spaces/SPACE/threads/THREAD")
      */
     private sendViaApi;
     /**
      * Get a valid access token, refreshing if needed.
      *
-     * Uses a simplified JWT-based OAuth2 flow for service accounts.
+     * Uses a JWT-based OAuth2 flow for service accounts.
+     * The scope includes Pub/Sub when in pubsub mode.
      *
      * @returns Valid access token string
      */
-    private getAccessToken;
+    getAccessToken(): Promise<string>;
+    /**
+     * Validate a service account key JSON string.
+     *
+     * @param key - JSON string of the service account key
+     * @throws Error if the key is invalid
+     */
+    private validateServiceAccountKey;
+    /**
+     * Reset all internal state to defaults.
+     */
+    private resetState;
 }
 //# sourceMappingURL=google-chat-messenger.adapter.d.ts.map

package/dist/backend/backend/src/services/messaging/adapters/google-chat-messenger.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-chat-messenger.adapter.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/messaging/adapters/google-chat-messenger.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAKxF;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAiB;IAErD,sDAAsD;IACtD,OAAO,CAAC,UAAU,CAAuB;IAEzC,sDAAsD;IACtD,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,0DAA0D;IAC1D,OAAO,CAAC,WAAW,CAAuB;IAE1C,oCAAoC;IACpC,OAAO,CAAC,cAAc,CAAK;IAE3B;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyChE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAchG;;;;OAIG;IACH,SAAS,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAWnG;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;OAKG;YACW,cAAc;IA8B5B;;;;;;OAMG;YACW,UAAU;IAmCxB;;;;;;OAMG;YACW,cAAc;CAkD7B"}
+{"version":3,"file":"google-chat-messenger.adapter.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/messaging/adapters/google-chat-messenger.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAoCzG;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;AAExE;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAiB;IAErD,8BAA8B;IAC9B,OAAO,CAAC,IAAI,CAA0B;IAEtC,sDAAsD;IACtD,OAAO,CAAC,UAAU,CAAuB;IAEzC,sCAAsC;IACtC,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,0DAA0D;IAC1D,OAAO,CAAC,WAAW,CAAuB;IAE1C,oCAAoC;IACpC,OAAO,CAAC,cAAc,CAAK;IAE3B,yCAAyC;IACzC,OAAO,CAAC,WAAW,CAAmD;IAEtE,wFAAwF;IACxF,OAAO,CAAC,gBAAgB,CAAuB;IAE/C,wCAAwC;IACxC,OAAO,CAAC,SAAS,CAAuB;IAExC,kCAAkC;IAClC,OAAO,CAAC,iBAAiB,CAA+C;IAExE,qCAAqC;IACrC,OAAO,CAAC,iBAAiB,CAA2C;IAEpE,qCAAqC;IACrC,OAAO,CAAC,mBAAmB,CAAK;IAEhC,sDAAsD;IACtD,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;OAUG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDhE;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAchG;;;;OAIG;IACH,SAAS,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAiBnG;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;;OAMG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDnC;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;;;OAIG;YACW,mBAAmB;IA0BjC;;;;;OAKG;YACW,cAAc;IA8B5B;;;;;;;;;OASG;YACW,UAAU;IA2CxB;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAqDvC;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;IACH,OAAO,CAAC,UAAU;CAcnB"}

package/dist/backend/backend/src/services/messaging/adapters/google-chat-messenger.adapter.js

@@ -1,72 +1,99 @@
 /**
  * Google Chat Messenger Adapter
  *
- * Messenger adapter for Google Chat using the Google Chat API (webhook or service account).
- * Supports sending messages to Google Chat spaces via incoming webhooks or
- * the Chat API with a service account.
+ * Messenger adapter for Google Chat supporting three connection modes:
+ * 1. **Webhook mode** — post messages via an incoming webhook URL (send-only)
+ * 2. **Service account mode** — send messages via the Chat API (send-only)
+ * 3. **Pub/Sub mode** — pull incoming messages from a Cloud Pub/Sub subscription
+ *    and reply via the Chat API (bidirectional, thread-aware)
+ *
+ * In Pub/Sub mode, a Google Chat App is configured to publish events to a
+ * Pub/Sub topic. Crewly pulls from the subscription, processes MESSAGE events,
+ * and replies in the same thread via the Chat API.
  *
  * @module services/messaging/adapters/google-chat-messenger.adapter
  */
-/** Timeout for external Google Chat API calls (ms). */
-const FETCH_TIMEOUT_MS = 15_000;
+import { GOOGLE_CHAT_PUBSUB_CONSTANTS } from '../../../constants.js';
 /**
- * Messenger adapter for Google Chat.
- *
- * Supports two modes:
- * 1. **Webhook mode** (simpler): uses an incoming webhook URL to post messages
- * 2. **Service account mode**: uses a service account key to call the Chat API
+ * Messenger adapter for Google Chat with Pub/Sub support.
  *
- * Webhook mode is used when `webhookUrl` is provided in config.
- * Service account mode is used when `serviceAccountKey` is provided.
+ * Supports webhook, service-account, and pubsub modes.
+ * Pub/Sub mode enables bidirectional communication with thread tracking.
  */
 export class GoogleChatMessengerAdapter {
     platform = 'google-chat';
+    /** Current connection mode */
+    mode = 'none';
     /** Webhook URL for posting messages (webhook mode) */
     webhookUrl = null;
-    /** Service account key JSON (service account mode) */
+    /** Service account key JSON string */
     serviceAccountKey = null;
     /** Access token obtained from service account (cached) */
     accessToken = null;
     /** Access token expiry timestamp */
     tokenExpiresAt = 0;
+    /** OAuth2 scopes for the current mode */
+    tokenScopes = GOOGLE_CHAT_PUBSUB_CONSTANTS.CHAT_SCOPE;
+    /** Full Pub/Sub subscription resource name (e.g. projects/PROJECT/subscriptions/SUB) */
+    subscriptionName = null;
+    /** GCP project ID (for Pub/Sub mode) */
+    projectId = null;
+    /** Pub/Sub pull interval timer */
+    pullIntervalTimer = null;
+    /** Callback for incoming messages */
+    onIncomingMessage = null;
+    /** Consecutive pull failure count */
+    consecutiveFailures = 0;
+    /** Whether the pull loop is paused due to failures */
+    pullPaused = false;
     /**
-     * Initialize the adapter by validating credentials.
+     * Initialize the adapter with the provided credentials.
+     *
+     * Detects mode based on provided config fields:
+     * - `webhookUrl` → webhook mode
+     * - `serviceAccountKey` + `projectId` + `subscriptionName` → pubsub mode
+     * - `serviceAccountKey` alone → service-account mode
      *
-     * @param config - Must contain either `webhookUrl` string or `serviceAccountKey` string
-     * @throws Error if neither credential is provided or validation fails
+     * @param config - Configuration object with credentials
+     * @throws Error if credentials are invalid or missing
      */
     async initialize(config) {
         const webhookUrl = config.webhookUrl;
         const serviceAccountKey = config.serviceAccountKey;
+        const projectId = config.projectId;
+        const subscriptionName = config.subscriptionName;
+        const onIncomingMessage = config.onIncomingMessage;
+        // Webhook mode
         if (typeof webhookUrl === 'string' && webhookUrl) {
-            // Webhook mode: validate the URL format
             if (!webhookUrl.startsWith('https://chat.googleapis.com/')) {
                 throw new Error('Invalid Google Chat webhook URL. Must start with https://chat.googleapis.com/');
             }
-            // Validate by sending a test (dry-run) - Google Chat webhooks don't have a validate endpoint,
-            // so we just validate the URL format and store it
+            this.resetState();
             this.webhookUrl = webhookUrl;
-            this.serviceAccountKey = null;
-            this.accessToken = null;
+            this.mode = 'webhook';
             return;
         }
+        // Pub/Sub mode or Service Account mode — both require a service account key
         if (typeof serviceAccountKey === 'string' && serviceAccountKey) {
-            // Service account mode: validate the key is valid JSON
-            try {
-                const parsed = JSON.parse(serviceAccountKey);
-                if (!parsed.client_email || !parsed.private_key) {
-                    throw new Error('Service account key must contain client_email and private_key');
-                }
-            }
-            catch (err) {
-                if (err instanceof SyntaxError) {
-                    throw new Error('Service account key must be valid JSON');
+            this.validateServiceAccountKey(serviceAccountKey);
+            this.resetState();
+            this.serviceAccountKey = serviceAccountKey;
+            // Pub/Sub mode: requires projectId + subscriptionName
+            if (typeof projectId === 'string' && projectId &&
+                typeof subscriptionName === 'string' && subscriptionName) {
+                this.projectId = projectId;
+                this.subscriptionName = `projects/${projectId}/subscriptions/${subscriptionName}`;
+                this.tokenScopes = `${GOOGLE_CHAT_PUBSUB_CONSTANTS.CHAT_SCOPE} ${GOOGLE_CHAT_PUBSUB_CONSTANTS.PUBSUB_SCOPE}`;
+                this.mode = 'pubsub';
+                if (typeof onIncomingMessage === 'function') {
+                    this.onIncomingMessage = onIncomingMessage;
                 }
-                throw err;
+                this.startPubSubPull();
+                return;
             }
-            this.serviceAccountKey = serviceAccountKey;
-            this.webhookUrl = null;
-            this.accessToken = null;
+            // Service account mode (send-only)
+            this.mode = 'service-account';
+            this.tokenScopes = GOOGLE_CHAT_PUBSUB_CONSTANTS.CHAT_SCOPE;
             return;
         }
         throw new Error('Google Chat requires either a webhookUrl or serviceAccountKey');
@@ -75,19 +102,19 @@ export class GoogleChatMessengerAdapter {
      * Send a text message to a Google Chat space.
      *
      * In webhook mode, the `channel` parameter is ignored (webhook URL determines the space).
-     * In service account mode, `channel` is the space name (e.g., "spaces/AAAA...").
+     * In service-account/pubsub mode, `channel` is the space name (e.g., "spaces/AAAA...").
      *
-     * @param channel - Google Chat space name (used in service account mode)
+     * @param channel - Google Chat space name (used in service-account/pubsub mode)
      * @param text - Message content
      * @param options - Optional send options (threadId for threaded replies)
      * @throws Error if adapter is not initialized or send fails
      */
     async sendMessage(channel, text, options) {
-        if (this.webhookUrl) {
+        if (this.mode === 'webhook' && this.webhookUrl) {
             await this.sendViaWebhook(text, options?.threadId);
             return;
         }
-        if (this.serviceAccountKey) {
+        if ((this.mode === 'service-account' || this.mode === 'pubsub') && this.serviceAccountKey) {
             await this.sendViaApi(channel, text, options?.threadId);
             return;
         }
@@ -96,27 +123,173 @@ export class GoogleChatMessengerAdapter {
     /**
      * Get the current connection status.
      *
-     * @returns Status object with connected flag and platform identifier
+     * @returns Status object with connected flag, platform, and mode details
      */
     getStatus() {
-        const connected = Boolean(this.webhookUrl || this.serviceAccountKey);
         return {
-            connected,
+            connected: this.mode !== 'none',
             platform: this.platform,
             details: {
-                mode: this.webhookUrl ? 'webhook' : this.serviceAccountKey ? 'service-account' : 'none',
+                mode: this.mode,
+                ...(this.mode === 'pubsub' ? {
+                    subscriptionName: this.subscriptionName,
+                    projectId: this.projectId,
+                    pullActive: Boolean(this.pullIntervalTimer) && !this.pullPaused,
+                    pullPaused: this.pullPaused,
+                    consecutiveFailures: this.consecutiveFailures,
+                } : {}),
             },
         };
     }
     /**
-     * Disconnect by clearing stored credentials.
+     * Disconnect by clearing stored credentials and stopping the pull loop.
      */
     async disconnect() {
-        this.webhookUrl = null;
-        this.serviceAccountKey = null;
-        this.accessToken = null;
-        this.tokenExpiresAt = 0;
+        this.stopPubSubPull();
+        this.resetState();
+    }
+    // ===========================================================================
+    // Pub/Sub Pull Loop
+    // ===========================================================================
+    /**
+     * Start the Pub/Sub pull loop that periodically fetches messages.
+     */
+    startPubSubPull() {
+        this.stopPubSubPull();
+        this.consecutiveFailures = 0;
+        this.pullPaused = false;
+        this.pullIntervalTimer = setInterval(async () => {
+            if (this.pullPaused)
+                return;
+            try {
+                await this.pullMessages();
+                this.consecutiveFailures = 0;
+            }
+            catch {
+                this.consecutiveFailures++;
+                if (this.consecutiveFailures >= GOOGLE_CHAT_PUBSUB_CONSTANTS.MAX_CONSECUTIVE_FAILURES) {
+                    this.pullPaused = true;
+                }
+            }
+        }, GOOGLE_CHAT_PUBSUB_CONSTANTS.PULL_INTERVAL_MS);
+    }
+    /**
+     * Stop the Pub/Sub pull loop.
+     */
+    stopPubSubPull() {
+        if (this.pullIntervalTimer) {
+            clearInterval(this.pullIntervalTimer);
+            this.pullIntervalTimer = null;
+        }
+    }
+    /**
+     * Pull messages from the Pub/Sub subscription, process them, and acknowledge.
+     *
+     * Each message is a base64-encoded Google Chat event JSON. Only MESSAGE-type
+     * events are forwarded to the incoming message callback. All messages are
+     * acknowledged regardless of type to prevent redelivery.
+     */
+    async pullMessages() {
+        if (!this.subscriptionName) {
+            throw new Error('Pub/Sub subscription not configured');
+        }
+        const token = await this.getAccessToken();
+        const pullUrl = `${GOOGLE_CHAT_PUBSUB_CONSTANTS.PUBSUB_API_BASE}/${this.subscriptionName}:pull`;
+        const resp = await fetch(pullUrl, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ maxMessages: GOOGLE_CHAT_PUBSUB_CONSTANTS.MAX_MESSAGES_PER_PULL }),
+            signal: AbortSignal.timeout(GOOGLE_CHAT_PUBSUB_CONSTANTS.FETCH_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            const details = await resp.text();
+            throw new Error(`Pub/Sub pull failed (${resp.status}): ${details}`);
+        }
+        const data = await resp.json();
+        if (!data.receivedMessages || data.receivedMessages.length === 0) {
+            return;
+        }
+        const ackIds = [];
+        for (const received of data.receivedMessages) {
+            ackIds.push(received.ackId);
+            if (!received.message.data)
+                continue;
+            try {
+                const decoded = Buffer.from(received.message.data, 'base64').toString('utf-8');
+                const event = JSON.parse(decoded);
+                this.processChatEvent(event);
+            }
+            catch {
+                // Skip malformed messages — they will still be acked
+            }
+        }
+        // Acknowledge all messages (even non-MESSAGE types) to prevent redelivery
+        if (ackIds.length > 0) {
+            await this.acknowledgeMessages(ackIds);
+        }
     }
+    /**
+     * Process a Google Chat event and forward MESSAGE events to the callback.
+     *
+     * Thread tracking: extracts the thread name from the event so that replies
+     * can be posted back to the same thread.
+     *
+     * @param event - Parsed Google Chat event payload
+     */
+    processChatEvent(event) {
+        // Only process MESSAGE events (ignore ADDED_TO_SPACE, REMOVED_FROM_SPACE, etc.)
+        if (event.type !== 'MESSAGE' || !event.message?.text) {
+            return;
+        }
+        if (!this.onIncomingMessage) {
+            return;
+        }
+        const spaceName = event.space?.name || '';
+        const threadName = event.message.thread?.name || '';
+        const senderName = event.message.sender?.displayName || event.message.sender?.name || '';
+        const incomingMessage = {
+            platform: 'google-chat',
+            conversationId: spaceName,
+            channelId: spaceName,
+            userId: senderName,
+            text: event.message.text,
+            // Thread name is the full resource path (e.g. spaces/SPACE/threads/THREAD)
+            // This is used to reply in the same thread via the Chat API
+            threadId: threadName,
+            timestamp: event.message.createTime || event.eventTime || new Date().toISOString(),
+        };
+        this.onIncomingMessage(incomingMessage);
+    }
+    /**
+     * Acknowledge processed messages to prevent redelivery.
+     *
+     * @param ackIds - Array of ack IDs from the pull response
+     */
+    async acknowledgeMessages(ackIds) {
+        if (!this.subscriptionName)
+            return;
+        const token = await this.getAccessToken();
+        const ackUrl = `${GOOGLE_CHAT_PUBSUB_CONSTANTS.PUBSUB_API_BASE}/${this.subscriptionName}:acknowledge`;
+        const resp = await fetch(ackUrl, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ ackIds }),
+            signal: AbortSignal.timeout(GOOGLE_CHAT_PUBSUB_CONSTANTS.FETCH_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            const details = await resp.text();
+            throw new Error(`Pub/Sub acknowledge failed (${resp.status}): ${details}`);
+        }
+    }
+    // ===========================================================================
+    // Send Methods
+    // ===========================================================================
     /**
      * Send a message via incoming webhook URL.
      *
@@ -141,7 +314,7 @@ export class GoogleChatMessengerAdapter {
             method: 'POST',
             headers: { 'Content-Type': 'application/json; charset=UTF-8' },
             body: JSON.stringify(body),
-            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            signal: AbortSignal.timeout(GOOGLE_CHAT_PUBSUB_CONSTANTS.FETCH_TIMEOUT_MS),
         });
         if (!resp.ok) {
             const details = await resp.text();
@@ -151,11 +324,14 @@ export class GoogleChatMessengerAdapter {
     /**
      * Send a message via the Google Chat REST API using service account credentials.
      *
+     * When a threadId (thread name) is provided, the reply is posted to the same
+     * thread. This enables conversational thread tracking for Pub/Sub mode.
+     *
      * @param space - Space name (e.g., "spaces/AAAA...")
      * @param text - Message text
-     * @param threadKey - Optional thread key for threaded replies
+     * @param threadName - Optional full thread name (e.g., "spaces/SPACE/threads/THREAD")
      */
-    async sendViaApi(space, text, threadKey) {
+    async sendViaApi(space, text, threadName) {
         if (!this.serviceAccountKey) {
             throw new Error('Service account key not configured');
         }
@@ -164,27 +340,37 @@ export class GoogleChatMessengerAdapter {
         }
         const token = await this.getAccessToken();
         const body = { text };
-        if (threadKey) {
-            body.thread = { name: `${space}/threads/${threadKey}` };
+        if (threadName) {
+            // Use the full thread resource name for API-based threading
+            body.thread = { name: threadName };
+        }
+        // Build URL with messageReplyOption to enable thread replies
+        let url = `${GOOGLE_CHAT_PUBSUB_CONSTANTS.CHAT_API_BASE}/${space}/messages`;
+        if (threadName) {
+            url += '?messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD';
         }
-        const resp = await fetch(`https://chat.googleapis.com/v1/${space}/messages`, {
+        const resp = await fetch(url, {
             method: 'POST',
             headers: {
                 Authorization: `Bearer ${token}`,
                 'Content-Type': 'application/json',
             },
             body: JSON.stringify(body),
-            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            signal: AbortSignal.timeout(GOOGLE_CHAT_PUBSUB_CONSTANTS.FETCH_TIMEOUT_MS),
         });
         if (!resp.ok) {
             const details = await resp.text();
             throw new Error(`Google Chat API send failed (${resp.status}): ${details}`);
         }
     }
+    // ===========================================================================
+    // Auth
+    // ===========================================================================
     /**
      * Get a valid access token, refreshing if needed.
      *
-     * Uses a simplified JWT-based OAuth2 flow for service accounts.
+     * Uses a JWT-based OAuth2 flow for service accounts.
+     * The scope includes Pub/Sub when in pubsub mode.
      *
      * @returns Valid access token string
      */
@@ -196,14 +382,12 @@ export class GoogleChatMessengerAdapter {
         if (!this.serviceAccountKey) {
             throw new Error('Service account key not configured');
         }
-        // For service account auth, we need to create a JWT and exchange it for an access token.
-        // This is a simplified implementation — production use should use google-auth-library.
         const key = JSON.parse(this.serviceAccountKey);
         const now = Math.floor(Date.now() / 1000);
         const header = Buffer.from(JSON.stringify({ alg: 'RS256', typ: 'JWT' })).toString('base64url');
         const payload = Buffer.from(JSON.stringify({
             iss: key.client_email,
-            scope: 'https://www.googleapis.com/auth/chat.bot',
+            scope: this.tokenScopes,
             aud: 'https://oauth2.googleapis.com/token',
             iat: now,
             exp: now + 3600,
@@ -218,7 +402,7 @@ export class GoogleChatMessengerAdapter {
             method: 'POST',
             headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
             body: `grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${jwt}`,
-            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            signal: AbortSignal.timeout(GOOGLE_CHAT_PUBSUB_CONSTANTS.FETCH_TIMEOUT_MS),
         });
         if (!resp.ok) {
             const details = await resp.text();
@@ -229,5 +413,45 @@ export class GoogleChatMessengerAdapter {
         this.tokenExpiresAt = Date.now() + data.expires_in * 1000;
         return this.accessToken;
     }
+    // ===========================================================================
+    // Helpers
+    // ===========================================================================
+    /**
+     * Validate a service account key JSON string.
+     *
+     * @param key - JSON string of the service account key
+     * @throws Error if the key is invalid
+     */
+    validateServiceAccountKey(key) {
+        try {
+            const parsed = JSON.parse(key);
+            if (!parsed.client_email || !parsed.private_key) {
+                throw new Error('Service account key must contain client_email and private_key');
+            }
+        }
+        catch (err) {
+            if (err instanceof SyntaxError) {
+                throw new Error('Service account key must be valid JSON');
+            }
+            throw err;
+        }
+    }
+    /**
+     * Reset all internal state to defaults.
+     */
+    resetState() {
+        this.stopPubSubPull();
+        this.webhookUrl = null;
+        this.serviceAccountKey = null;
+        this.accessToken = null;
+        this.tokenExpiresAt = 0;
+        this.tokenScopes = GOOGLE_CHAT_PUBSUB_CONSTANTS.CHAT_SCOPE;
+        this.subscriptionName = null;
+        this.projectId = null;
+        this.onIncomingMessage = null;
+        this.consecutiveFailures = 0;
+        this.pullPaused = false;
+        this.mode = 'none';
+    }
 }
 //# sourceMappingURL=google-chat-messenger.adapter.js.map