@elizaos/plugin-google-chat 2.0.0-alpha.6 → 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @elizaos/plugin-google-chat
+
+Google Chat connector for elizaOS agents. Sends and receives messages in Google Workspace spaces, DMs, and threads via the Google Chat REST API.
+
+This package is a runtime plugin consumed by an elizaOS agent. It registers two services and a `MessageConnector` (`source: "google-chat"`); there are no actions or providers. For agent/contributor-facing detail, see [CLAUDE.md](./CLAUDE.md).
+
+## What it provides
+
+- Send/receive messages in spaces, threaded replies, and 1:1 DMs.
+- Emoji reactions (`sendReaction` / `deleteReaction`), message edit (`updateMessage`) and delete (`deleteMessage`).
+- Attachment upload (multipart to `https://chat.googleapis.com/upload/v1`) and download (`?alt=media`).
+- Multiple concurrent bot accounts via one service instance.
+- Inbound webhook events through `GoogleChatService.processWebhookEvent()`. This plugin does not mount its own HTTP route — the host runtime forwards events to it at the configured `webhookPath`.
+
+Auth uses a Google service account with scope `https://www.googleapis.com/auth/chat.bot`. There is no OAuth user flow.
+
+## Usage
+
+```typescript
+import googleChatPlugin from "@elizaos/plugin-google-chat";
+```
+
+Add the plugin to the runtime's plugin list, or let auto-enable activate it when a `connectors.googlechat` block is present in the character config (see `auto-enable.ts`).
+
+## Configuration
+
+Resolution order: per-account character config > top-level `character.settings.googleChat` > `GOOGLE_CHAT_ACCOUNTS` JSON env var > single-account env vars (only for the `default` account).
+
+| Env var | Required | Default | Description |
+|---|---|---|---|
+| `GOOGLE_CHAT_SERVICE_ACCOUNT` | One of three | — | Inline service account JSON string |
+| `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE` | One of three | — | Path to service account JSON key file |
+| `GOOGLE_APPLICATION_CREDENTIALS` | One of three | — | ADC credentials file path (standard Google env var) |
+| `GOOGLE_CHAT_AUDIENCE` | Yes | — | Audience value for webhook token verification by the host |
+| `GOOGLE_CHAT_AUDIENCE_TYPE` | No | `app-url` | `app-url` or `project-number` |
+| `GOOGLE_CHAT_WEBHOOK_PATH` | No | `/googlechat` | Webhook path for incoming events |
+| `GOOGLE_CHAT_SPACES` | No | — | Comma-separated initial space resource names (`spaces/xxx`) |
+| `GOOGLE_CHAT_REQUIRE_MENTION` | No | `true` | Only respond in spaces when @mentioned |
+| `GOOGLE_CHAT_BOT_USER` | No | — | Bot user resource name (`users/xxx`) |
+| `GOOGLE_CHAT_ENABLED` | No | `true` | Master switch for this plugin |
+| `GOOGLE_CHAT_ACCOUNTS` | No | — | JSON array/object for multi-account config |
+| `GOOGLE_CHAT_DEFAULT_ACCOUNT_ID` | No | `default` | Active account when multiple are configured |
+
+Character-level config (`character.settings.googleChat`) accepts all `GoogleChatAccountConfig` fields (`src/config.ts`): per-space overrides, DM policies, reaction-notification modes, `textChunkLimit` (default 4096), `mediaMaxMb` (default 50), and heartbeat visibility.
+
+## Events
+
+Emitted via `runtime.emitEvent` (constants in `GoogleChatEventTypes`, `src/types.ts`):
+
+| Event | Fired when |
+|---|---|
+| `GOOGLE_CHAT_MESSAGE_RECEIVED` | Webhook receives a `MESSAGE` event |
+| `GOOGLE_CHAT_MESSAGE_SENT` | `sendMessage` succeeds |
+| `GOOGLE_CHAT_SPACE_JOINED` | Bot added to a space |
+| `GOOGLE_CHAT_SPACE_LEFT` | Bot removed from a space |
+| `GOOGLE_CHAT_REACTION_SENT` | `sendReaction` succeeds |
+| `GOOGLE_CHAT_CONNECTION_READY` | Account connected at startup |
+
+`GOOGLE_CHAT_REACTION_RECEIVED` and `GOOGLE_CHAT_WEBHOOK_READY` are declared in the enum but not currently emitted.
+
+## Commands
+
+From `package.json`:
+
+```bash
+bun run --cwd plugins/plugin-google-chat build         # bunx tsc -p tsconfig.json
+bun run --cwd plugins/plugin-google-chat test          # vitest run
+bun run --cwd plugins/plugin-google-chat lint          # biome check --write --unsafe
+bun run --cwd plugins/plugin-google-chat typecheck     # tsgo --noEmit
+```
+
+Messages longer than 4,000 chars (`MAX_GOOGLE_CHAT_MESSAGE_LENGTH`) can be split with `splitMessageForGoogleChat` (`src/types.ts`), which breaks on newline or word boundaries.
+
+This plugin is separate from `@elizaos/plugin-google` (OAuth for Drive/Calendar). Auth scopes and audience models differ — do not merge.

package/auto-enable.ts

@@ -0,0 +1,21 @@
+// Auto-enable check for @elizaos/plugin-google-chat.
+//
+// Plugin manifest entry-point — referenced by package.json's
+// `elizaos.plugin.autoEnableModule`. Keep this module light: env reads only,
+// no service init, no transitive imports of the full plugin runtime. The
+// auto-enable engine loads dozens of these per boot.
+import type { PluginAutoEnableContext } from "@elizaos/core";
+
+/** Enable when a `googlechat` connector block is present and not explicitly disabled. */
+export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
+  const c = (ctx.config.connectors as Record<string, unknown> | undefined)
+    ?.googlechat;
+  if (!c || typeof c !== "object") return false;
+  const config = c as Record<string, unknown>;
+  if (config.enabled === false) return false;
+  // The full per-connector field check (service account credentials / project)
+  // lives in the central engine's isConnectorConfigured. We delegate to a
+  // simple "block present + not explicitly disabled" check here; the central
+  // engine's stricter check remains as a fallback during migration.
+  return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-google-chat",
-  "version": "2.0.0-alpha.6",
+  "version": "2.0.11-beta.7",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -9,38 +9,63 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "auto-enable.ts"
   ],
+  "elizaos": {
+    "plugin": {
+      "autoEnableModule": "./auto-enable.ts",
+      "capabilities": [
+        "messaging"
+      ]
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "build": "bun run build.ts",
-    "test": "vitest run --passWithNoTests",
+    "test": "vitest run",
     "test:watch": "vitest --config vitest.config.ts",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
     "lint:check": "bunx @biomejs/biome check .",
     "format": "bunx @biomejs/biome format --write .",
     "format:check": "bunx @biomejs/biome format .",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
-    "google-auth-library": "^9.0.0",
-    "zod": "^4.3.6"
+    "@elizaos/core": "2.0.11-beta.7",
+    "google-auth-library": "^10.0.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.0.0",
-    "@biomejs/biome": "^2.3.11"
+    "@biomejs/biome": "^2.4.14",
+    "@types/node": "^22.19.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
   },
-  "milady": {
+  "eliza": {
     "platforms": [
       "node"
     ],
@@ -109,5 +134,6 @@
         "sensitive": false
       }
     }
-  }
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }

package/dist/index.d.ts

@@ -1 +0,0 @@
-// stub