From 2cadff901dcc0d93211b2bc862d29540e6f70f48 Mon Sep 17 00:00:00 2001 From: William Valentin Date: Mon, 16 Feb 2026 02:08:00 -0800 Subject: [PATCH] docs(plan): record google chat gap completion --- ...026-02-06-openclaw-feature-gap-analysis.md | 6 ++- docs/plans/2026-02-15-openclaw-gap-roadmap.md | 2 - ...6-google-chat-channel-adapter-checklist.md | 47 +++++++++++++++++++ docs/plans/state.json | 32 ++++++++++++- 4 files changed, 81 insertions(+), 6 deletions(-) create mode 100644 docs/plans/2026-02-16-google-chat-channel-adapter-checklist.md diff --git a/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md b/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md index 1b5e14e..8ef2c0b 100644 --- a/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md +++ b/docs/plans/2026-02-06-openclaw-feature-gap-analysis.md @@ -22,7 +22,7 @@ | Slack | Bolt SDK | Bolt SDK Socket Mode (channel allowlists, mention gating) | **MATCH** | | Signal | signal-cli | Signal adapter | **MATCH** | | iMessage / BlueBubbles | imsg + BlueBubbles | -- | **MISSING** | -| Google Chat | Chat API | -- | **MISSING** | +| Google Chat | Chat API | Google Chat adapter | **MATCH** | | Microsoft Teams | Bot Framework | Teams adapter | **MATCH** | | Matrix | Extension | -- | **MISSING** | | Zalo / Zalo Personal | Extension | -- | **MISSING** | @@ -291,7 +291,9 @@ All five Tier 3 items implemented: Lane Queue (per-session FIFO in gateway), cre - DM pairing codes (PairingManager with TTL codes, all 4 channel adapters, gateway handlers, TUI /pair command) **Remaining channels (if desired):** -6. Google Chat (Chat API) +6. iMessage / BlueBubbles +7. Zalo / Zalo Personal +8. LINE / Feishu / Mattermost ### Tier 5 — Deferred / Niche diff --git a/docs/plans/2026-02-15-openclaw-gap-roadmap.md b/docs/plans/2026-02-15-openclaw-gap-roadmap.md index 9cefa60..0f8c1c0 100644 --- a/docs/plans/2026-02-15-openclaw-gap-roadmap.md +++ b/docs/plans/2026-02-15-openclaw-gap-roadmap.md @@ -21,7 +21,6 @@ A gap item is considered implemented when: ### Channels / Frontends (MISSING) -- Google Chat - iMessage/BlueBubbles - Zalo - LINE/Feishu/Mattermost @@ -330,7 +329,6 @@ These are substantial UX/ecosystem projects or highly platform-specific; defer u - Bonjour/mDNS discovery - QMD backend - ClawHub registry -- Google Chat (enterprise/ops heavy) - iMessage/BlueBubbles (Apple ecosystem) ## Suggested Next Execution Order diff --git a/docs/plans/2026-02-16-google-chat-channel-adapter-checklist.md b/docs/plans/2026-02-16-google-chat-channel-adapter-checklist.md new file mode 100644 index 0000000..eaa8374 --- /dev/null +++ b/docs/plans/2026-02-16-google-chat-channel-adapter-checklist.md @@ -0,0 +1,47 @@ +# 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` diff --git a/docs/plans/state.json b/docs/plans/state.json index 896db4d..a4d7bac 100644 --- a/docs/plans/state.json +++ b/docs/plans/state.json @@ -527,6 +527,34 @@ ], "test_status": "pnpm test:run src/channels/teams/adapter.test.ts src/config/schema.test.ts src/gateway/handlers/services.test.ts src/cli/shared.test.ts + pnpm typecheck passing" }, + "google-chat-channel-adapter": { + "file": "2026-02-16-google-chat-channel-adapter-checklist.md", + "status": "completed", + "date": "2026-02-16", + "updated": "2026-02-16", + "summary": "Added a first-class Google Chat adapter with inbound event webhook handling (`POST /google-chat/events`), optional webhook token validation, mention-aware room gating, space allowlist filtering, and outbound Chat API replies via service-account OAuth token flow.", + "files_created": [ + "docs/plans/2026-02-16-google-chat-channel-adapter-checklist.md", + "src/channels/googleChat/adapter.ts", + "src/channels/googleChat/adapter.test.ts", + "src/channels/googleChat/index.ts" + ], + "files_modified": [ + "src/config/schema.ts", + "src/config/schema.test.ts", + "src/daemon/channels.ts", + "src/channels/index.ts", + "src/gateway/server.ts", + "src/gateway/handlers/services.ts", + "src/gateway/handlers/services.test.ts", + "src/cli/shared.ts", + "src/cli/shared.test.ts", + "README.md", + "config/default.yaml", + "docs/api/PROTOCOL.md" + ], + "test_status": "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 passing" + }, "openclaw-style-personal-agent-without-openclaw-risks": { "file": "2026-02-14-openclaw-style-personal-agent-without-openclaw-risks-plan.md", "status": "completed", @@ -2849,12 +2877,12 @@ "tier2_completion": "4/4 (100%) — inbound webhooks, vector memory search, Dockerfile, heartbeat monitor", "tier3_completion": "5/5 (100%) — lane queue, credential redaction, web UI token dashboard, xAI (Grok) provider, Voyage AI embeddings", "tier4_completion": "4/4 (100%) — gateway lock, shell completion, Tailscale Serve/Funnel, DM pairing codes", - "feature_gap_scorecard": "111/128 match (87%), 0 partial (0%), 17 missing (13%)", + "feature_gap_scorecard": "112/128 match (88%), 0 partial (0%), 16 missing (12%)", "operator_dx_milestone": "Phase 3 (Live Ops Dashboard): 2/2 plans complete — milestone done", "gmail_auth_cli": "flynn gmail-auth command implemented with OAuth2 flow, doctor check, config routed to Telegram", "native_audio_support": "completed — smart routing for native audio (Gemini/OpenAI/GitHub) vs Whisper transcription fallback", "remaining_phases_completion": "Phase 1: 3/3 (100%) — context levels, command registry, memory structure. Phase 2: 3/3 (100%) — component registry, confidence routing, history index. Phase 3: 2/2 (100%) — adaptive memory/compaction, truthfulness/autonomy hardening", - "next_up": "OpenClaw gap: Google Chat channel adapter (open next scoped implementation checklist)" + "next_up": "OpenClaw gap: iMessage/BlueBubbles channel adapter (open next scoped implementation checklist)" }, "soul_md_and_cron_create": { "date": "2026-02-11",