# Google Chat Channel Adapter Checklist

Date: 2026-02-16
Status: completed

## Scope

- Add a first-class Google Chat channel adapter.
- Support inbound event handling and outbound message replies through Google Chat REST API.

## Completed

- Added `GoogleChatAdapter` in `src/channels/googleChat/adapter.ts`:
  - inbound webhook handling for `POST /google-chat/events`
  - optional webhook token validation (`google_chat.webhook_token`)
  - mention-aware room message gating with DM bypass
  - optional space allowlist (`allowed_space_names`)
  - outbound send to `chat.googleapis.com` using service-account OAuth token flow
  - reply routing via encoded `metadata.replyPeerId`
- Registered channel exports:
  - `src/channels/googleChat/index.ts`
  - `src/channels/index.ts`
- Added config schema support in `src/config/schema.ts`:
  - `google_chat.service_account_key_file`
  - `google_chat.service_account_json`
  - `google_chat.webhook_token`
  - `google_chat.allowed_space_names`
  - `google_chat.require_mention`
- Wired daemon + gateway integration:
  - registration in `src/daemon/channels.ts`
  - gateway Google Chat route handling in `src/gateway/server.ts` (`POST /google-chat/events`)
- Updated service discovery + docs:
  - `src/gateway/handlers/services.ts`
  - `README.md`
  - `config/default.yaml`
  - `docs/api/PROTOCOL.md`
  - redaction coverage for `service_account_json` in `src/cli/shared.ts`
- Added tests:
  - `src/channels/googleChat/adapter.test.ts`
  - `src/config/schema.test.ts` (google_chat schema coverage)
  - `src/gateway/handlers/services.test.ts` (google_chat service status)
  - `src/cli/shared.test.ts` (service_account_json redaction)

## Verification

- `pnpm test:run src/channels/googleChat/adapter.test.ts src/config/schema.test.ts src/gateway/handlers/services.test.ts src/cli/shared.test.ts`
- `pnpm typecheck`
