@framers/agentos 0.1.26 → 0.1.28

package/dist/channels/adapters/GoogleChatChannelAdapter.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Google Chat Channel Adapter for AgentOS.
+ *
+ * Integrates with Google Chat (formerly Hangouts Chat) via the
+ * Google Chat API. Supports sending messages, cards, and handling
+ * incoming events from Google Chat spaces.
+ *
+ * **Dependencies**: Requires `googleapis` (or `@googleapis/chat`)
+ * to be installed. Authentication is done via a Google Cloud
+ * service account.
+ *
+ * The adapter supports two authentication methods:
+ * 1. **Service account key file**: Path to a JSON key file.
+ * 2. **Credentials object**: Inline JSON credentials (for environments
+ *    where file access is restricted).
+ *
+ * @example
+ * ```typescript
+ * const gchat = new GoogleChatChannelAdapter();
+ * await gchat.initialize({
+ *   platform: 'google-chat',
+ *   credential: '/path/to/service-account-key.json',
+ *   params: {
+ *     // OR pass inline credentials:
+ *     // credentials: '{"type":"service_account",...}',
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/GoogleChatChannelAdapter
+ */
+import type { ChannelAuthConfig, ChannelCapability, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+/** Platform-specific authentication parameters for Google Chat. */
+export interface GoogleChatAuthParams extends Record<string, string | undefined> {
+    /**
+     * Inline JSON credentials for the service account.
+     * Provide this OR use `credential` as a path to the key file.
+     */
+    credentials?: string;
+    /**
+     * Space name to listen in (e.g., 'spaces/AAAA...').
+     * Optional — the adapter can send to any space when given a conversation ID.
+     */
+    defaultSpace?: string;
+}
+/**
+ * Channel adapter for Google Chat.
+ *
+ * Uses the `googleapis` package via dynamic import.
+ *
+ * Capabilities: `text`, `rich_text`, `images`, `buttons`, `threads`,
+ * `reactions`, `group_chat`.
+ *
+ * Conversation ID format:
+ * - Space: `spaces/<spaceId>` (Google Chat space name)
+ * - Thread: pass `replyToMessageId` as the thread key
+ */
+export declare class GoogleChatChannelAdapter extends BaseChannelAdapter<GoogleChatAuthParams> {
+    readonly platform: ChannelPlatform;
+    readonly displayName = "Google Chat";
+    readonly capabilities: readonly ChannelCapability[];
+    /** Google Chat API client. */
+    private chatClient;
+    /** Google Auth client. */
+    private authClient;
+    /** Default space to operate in. */
+    private defaultSpace;
+    /** Bot identity info. */
+    private botInfo;
+    /** Polling for space messages (Google Chat push is webhook-based,
+     *  so polling is the fallback for non-webhook setups). */
+    private pollTimer;
+    private lastPollTimestamp;
+    protected doConnect(auth: ChannelAuthConfig & {
+        params?: GoogleChatAuthParams;
+    }): Promise<void>;
+    protected doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    protected doShutdown(): Promise<void>;
+    editMessage(conversationId: string, messageId: string, content: MessageContent): Promise<void>;
+    deleteMessage(_conversationId: string, messageId: string): Promise<void>;
+    addReaction(_conversationId: string, messageId: string, emoji: string): Promise<void>;
+    getConversationInfo(conversationId: string): Promise<{
+        name?: string;
+        memberCount?: number;
+        isGroup: boolean;
+        metadata?: Record<string, unknown>;
+    }>;
+    /**
+     * Process an incoming Google Chat webhook event.
+     * Call this from your HTTP endpoint that receives Google Chat events.
+     *
+     * Google Chat sends events via HTTP push to configured webhook URLs
+     * or Cloud Pub/Sub subscriptions.
+     */
+    processWebhookEvent(event: any): Promise<void>;
+    /**
+     * List spaces the bot is a member of.
+     */
+    listSpaces(): Promise<Array<{
+        name: string;
+        displayName: string;
+        type: string;
+    }>>;
+    private buildMessagePayload;
+    private buildEmbedCard;
+    private buildPollCard;
+    private resolveSpaceName;
+    private handleIncomingMessage;
+    private handleAddedToSpace;
+    private handleRemovedFromSpace;
+    private handleCardClicked;
+    private startPolling;
+    private stopPolling;
+    private pollSpace;
+}
+//# sourceMappingURL=GoogleChatChannelAdapter.d.ts.map

package/dist/channels/adapters/GoogleChatChannelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleChatChannelAdapter.d.ts","sourceRoot":"","sources":["../../../src/channels/adapters/GoogleChatChannelAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,mEAAmE;AACnE,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9E;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuBD;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,SAAQ,kBAAkB,CAAC,oBAAoB,CAAC;IACpF,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAiB;IACnD,QAAQ,CAAC,WAAW,iBAAiB;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAQxC;IAEX,8BAA8B;IAE9B,OAAO,CAAC,UAAU,CAAkB;IAEpC,0BAA0B;IAE1B,OAAO,CAAC,UAAU,CAAkB;IAEpC,mCAAmC;IACnC,OAAO,CAAC,YAAY,CAAqB;IAEzC,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAAoD;IAEnE;8DAC0D;IAC1D,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,iBAAiB,CAAqB;cAI9B,SAAS,CACvB,IAAI,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,oBAAoB,CAAA;KAAE,GAC1D,OAAO,CAAC,IAAI,CAAC;cAqFA,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;cAuCb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;IAcV,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE,WAAW,CACf,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAkBV,mBAAmB,CACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IA+CzG;;;;;;OAMG;IAEG,mBAAmB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAmBvF,OAAO,CAAC,mBAAmB;IAwF3B,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,aAAa;IAmCrB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,qBAAqB;IA6D7B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;YAOL,SAAS;CA4CxB"}