@openclaw/googlechat 2026.5.2-beta.1 → 2026.5.3-beta.1

package/src/monitor.ts

@@ -1,428 +0,0 @@
-import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/text-runtime";
-import type { OpenClawConfig } from "../runtime-api.js";
-import {
-  createChannelReplyPipeline,
-  resolveInboundRouteEnvelopeBuilderWithRuntime,
-  resolveWebhookPath,
-} from "../runtime-api.js";
-import { type ResolvedGoogleChatAccount } from "./accounts.js";
-import { downloadGoogleChatMedia, sendGoogleChatMessage } from "./api.js";
-import { type GoogleChatAudienceType } from "./auth.js";
-import { applyGoogleChatInboundAccessPolicy } from "./monitor-access.js";
-import { deliverGoogleChatReply } from "./monitor-reply-delivery.js";
-import {
-  registerGoogleChatWebhookTarget,
-  setGoogleChatWebhookEventProcessor,
-} from "./monitor-routing.js";
-import type {
-  GoogleChatCoreRuntime,
-  GoogleChatMonitorOptions,
-  GoogleChatRuntimeEnv,
-  WebhookTarget,
-} from "./monitor-types.js";
-import { warnAppPrincipalMisconfiguration } from "./monitor-webhook.js";
-import { getGoogleChatRuntime } from "./runtime.js";
-import type { GoogleChatAttachment, GoogleChatEvent } from "./types.js";
-
-setGoogleChatWebhookEventProcessor(processGoogleChatEvent);
-
-function logVerbose(core: GoogleChatCoreRuntime, runtime: GoogleChatRuntimeEnv, message: string) {
-  if (core.logging.shouldLogVerbose()) {
-    runtime.log?.(`[googlechat] ${message}`);
-  }
-}
-
-function normalizeAudienceType(value?: string | null): GoogleChatAudienceType | undefined {
-  const normalized = normalizeOptionalLowercaseString(value);
-  if (normalized === "app-url" || normalized === "app_url" || normalized === "app") {
-    return "app-url";
-  }
-  if (
-    normalized === "project-number" ||
-    normalized === "project_number" ||
-    normalized === "project"
-  ) {
-    return "project-number";
-  }
-  return undefined;
-}
-
-async function processGoogleChatEvent(event: GoogleChatEvent, target: WebhookTarget) {
-  const eventType = event.type ?? (event as { eventType?: string }).eventType;
-  if (eventType !== "MESSAGE") {
-    return;
-  }
-  if (!event.message || !event.space) {
-    return;
-  }
-
-  await processMessageWithPipeline({
-    event,
-    account: target.account,
-    config: target.config,
-    runtime: target.runtime,
-    core: target.core,
-    statusSink: target.statusSink,
-    mediaMaxMb: target.mediaMaxMb,
-  });
-}
-
-/**
- * Resolve bot display name with fallback chain:
- * 1. Account config name
- * 2. Agent name from config
- * 3. "OpenClaw" as generic fallback
- */
-function resolveBotDisplayName(params: {
-  accountName?: string;
-  agentId: string;
-  config: OpenClawConfig;
-}): string {
-  const { accountName, agentId, config } = params;
-  if (accountName?.trim()) {
-    return accountName.trim();
-  }
-  const agent = config.agents?.list?.find((a) => a.id === agentId);
-  if (agent?.name?.trim()) {
-    return agent.name.trim();
-  }
-  return "OpenClaw";
-}
-
-async function processMessageWithPipeline(params: {
-  event: GoogleChatEvent;
-  account: ResolvedGoogleChatAccount;
-  config: OpenClawConfig;
-  runtime: GoogleChatRuntimeEnv;
-  core: GoogleChatCoreRuntime;
-  statusSink?: (patch: { lastInboundAt?: number; lastOutboundAt?: number }) => void;
-  mediaMaxMb: number;
-}): Promise<void> {
-  const { event, account, config, runtime, core, statusSink, mediaMaxMb } = params;
-  const space = event.space;
-  const message = event.message;
-  if (!space || !message) {
-    return;
-  }
-
-  const spaceId = space.name ?? "";
-  if (!spaceId) {
-    return;
-  }
-  const spaceType = (space.type ?? "").toUpperCase();
-  const isGroup = spaceType !== "DM";
-  const sender = message.sender ?? event.user;
-  const senderId = sender?.name ?? "";
-  const senderName = sender?.displayName ?? "";
-  const senderEmail = sender?.email ?? undefined;
-
-  const allowBots = account.config.allowBots === true;
-  if (!allowBots) {
-    if (sender?.type?.toUpperCase() === "BOT") {
-      logVerbose(core, runtime, `skip bot-authored message (${senderId || "unknown"})`);
-      return;
-    }
-    if (senderId === "users/app") {
-      logVerbose(core, runtime, "skip app-authored message");
-      return;
-    }
-  }
-
-  const messageText = (message.argumentText ?? message.text ?? "").trim();
-  const attachments = message.attachment ?? [];
-  const hasMedia = attachments.length > 0;
-  const rawBody = messageText || (hasMedia ? "<media:attachment>" : "");
-  if (!rawBody) {
-    return;
-  }
-
-  const access = await applyGoogleChatInboundAccessPolicy({
-    account,
-    config,
-    core,
-    space,
-    message,
-    isGroup,
-    senderId,
-    senderName,
-    senderEmail,
-    rawBody,
-    statusSink,
-    logVerbose: (message) => logVerbose(core, runtime, message),
-  });
-  if (!access.ok) {
-    return;
-  }
-  const { commandAuthorized, effectiveWasMentioned, groupSystemPrompt } = access;
-
-  const { route, buildEnvelope } = resolveInboundRouteEnvelopeBuilderWithRuntime({
-    cfg: config,
-    channel: "googlechat",
-    accountId: account.accountId,
-    peer: {
-      kind: isGroup ? ("group" as const) : ("direct" as const),
-      id: spaceId,
-    },
-    runtime: core.channel,
-    sessionStore: config.session?.store,
-  });
-
-  let mediaPath: string | undefined;
-  let mediaType: string | undefined;
-  if (attachments.length > 0) {
-    const first = attachments[0];
-    const attachmentData = await downloadAttachment(first, account, mediaMaxMb, core);
-    if (attachmentData) {
-      mediaPath = attachmentData.path;
-      mediaType = attachmentData.contentType;
-    }
-  }
-
-  const fromLabel = isGroup
-    ? space.displayName || `space:${spaceId}`
-    : senderName || `user:${senderId}`;
-  const { storePath, body } = buildEnvelope({
-    channel: "Google Chat",
-    from: fromLabel,
-    timestamp: event.eventTime ? Date.parse(event.eventTime) : undefined,
-    body: rawBody,
-  });
-
-  const ctxPayload = core.channel.turn.buildContext({
-    channel: "googlechat",
-    accountId: route.accountId,
-    messageId: message.name,
-    messageIdFull: message.name,
-    timestamp: event.eventTime ? Date.parse(event.eventTime) : undefined,
-    from: `googlechat:${senderId}`,
-    sender: {
-      id: senderId,
-      name: senderName || undefined,
-      username: senderEmail,
-    },
-    conversation: {
-      kind: isGroup ? "channel" : "direct",
-      id: spaceId,
-      label: fromLabel,
-      routePeer: {
-        kind: isGroup ? "group" : "direct",
-        id: spaceId,
-      },
-    },
-    route: {
-      agentId: route.agentId,
-      accountId: route.accountId,
-      routeSessionKey: route.sessionKey,
-    },
-    reply: {
-      to: `googlechat:${spaceId}`,
-      originatingTo: `googlechat:${spaceId}`,
-      replyToId: message.thread?.name,
-      replyToIdFull: message.thread?.name,
-    },
-    message: {
-      body,
-      bodyForAgent: rawBody,
-      rawBody,
-      commandBody: rawBody,
-      envelopeFrom: fromLabel,
-    },
-    media:
-      mediaPath || mediaType
-        ? [
-            {
-              path: mediaPath,
-              url: mediaPath,
-              contentType: mediaType,
-            },
-          ]
-        : undefined,
-    supplemental: {
-      groupSystemPrompt: isGroup ? groupSystemPrompt : undefined,
-    },
-    extra: {
-      ChatType: isGroup ? "channel" : "direct",
-      WasMentioned: isGroup ? effectiveWasMentioned : undefined,
-      CommandAuthorized: commandAuthorized,
-      GroupSubject: undefined,
-      GroupSpace: isGroup ? (space.displayName ?? undefined) : undefined,
-    },
-  });
-
-  // Typing indicator setup
-  // Note: Reaction mode requires user OAuth, not available with service account auth.
-  // If reaction is configured, we fall back to message mode with a warning.
-  let typingIndicator = account.config.typingIndicator ?? "message";
-  if (typingIndicator === "reaction") {
-    runtime.error?.(
-      `[${account.accountId}] typingIndicator="reaction" requires user OAuth (not supported with service account). Falling back to "message" mode.`,
-    );
-    typingIndicator = "message";
-  }
-  let typingMessageName: string | undefined;
-
-  // Start typing indicator (message mode only, reaction mode not supported with app auth)
-  if (typingIndicator === "message") {
-    try {
-      const botName = resolveBotDisplayName({
-        accountName: account.config.name,
-        agentId: route.agentId,
-        config,
-      });
-      const result = await sendGoogleChatMessage({
-        account,
-        space: spaceId,
-        text: `_${botName} is typing..._`,
-        thread: message.thread?.name,
-      });
-      typingMessageName = result?.messageName;
-    } catch (err) {
-      runtime.error?.(`Failed sending typing message: ${String(err)}`);
-    }
-  }
-
-  const { onModelSelected, ...replyPipeline } = createChannelReplyPipeline({
-    cfg: config,
-    agentId: route.agentId,
-    channel: "googlechat",
-    accountId: route.accountId,
-  });
-
-  await core.channel.turn.run({
-    channel: "googlechat",
-    accountId: route.accountId,
-    raw: message,
-    adapter: {
-      ingest: () => ({
-        id: message.name ?? spaceId,
-        timestamp: event.eventTime ? Date.parse(event.eventTime) : undefined,
-        rawText: rawBody,
-        textForAgent: rawBody,
-        textForCommands: rawBody,
-        raw: message,
-      }),
-      resolveTurn: () => ({
-        cfg: config,
-        channel: "googlechat",
-        accountId: route.accountId,
-        agentId: route.agentId,
-        routeSessionKey: route.sessionKey,
-        storePath,
-        ctxPayload,
-        recordInboundSession: core.channel.session.recordInboundSession,
-        dispatchReplyWithBufferedBlockDispatcher:
-          core.channel.reply.dispatchReplyWithBufferedBlockDispatcher,
-        delivery: {
-          deliver: async (payload) => {
-            await deliverGoogleChatReply({
-              payload,
-              account,
-              spaceId,
-              runtime,
-              core,
-              config,
-              statusSink,
-              typingMessageName,
-            });
-            // Only use typing message for first delivery
-            typingMessageName = undefined;
-          },
-          onError: (err, info) => {
-            runtime.error?.(
-              `[${account.accountId}] Google Chat ${info.kind} reply failed: ${String(err)}`,
-            );
-          },
-        },
-        dispatcherOptions: replyPipeline,
-        replyOptions: {
-          onModelSelected,
-        },
-        record: {
-          onRecordError: (err) => {
-            runtime.error?.(`googlechat: failed updating session meta: ${String(err)}`);
-          },
-        },
-      }),
-    },
-  });
-}
-
-async function downloadAttachment(
-  attachment: GoogleChatAttachment,
-  account: ResolvedGoogleChatAccount,
-  mediaMaxMb: number,
-  core: GoogleChatCoreRuntime,
-): Promise<{ path: string; contentType?: string } | null> {
-  const resourceName = attachment.attachmentDataRef?.resourceName;
-  if (!resourceName) {
-    return null;
-  }
-  const maxBytes = Math.max(1, mediaMaxMb) * 1024 * 1024;
-  const downloaded = await downloadGoogleChatMedia({ account, resourceName, maxBytes });
-  const saved = await core.channel.media.saveMediaBuffer(
-    downloaded.buffer,
-    downloaded.contentType ?? attachment.contentType,
-    "inbound",
-    maxBytes,
-    attachment.contentName,
-  );
-  return { path: saved.path, contentType: saved.contentType };
-}
-
-function monitorGoogleChatProvider(options: GoogleChatMonitorOptions): () => void {
-  const core = getGoogleChatRuntime();
-  const webhookPath = resolveWebhookPath({
-    webhookPath: options.webhookPath,
-    webhookUrl: options.webhookUrl,
-    defaultPath: "/googlechat",
-  });
-  if (!webhookPath) {
-    options.runtime.error?.(`[${options.account.accountId}] invalid webhook path`);
-    return () => {};
-  }
-
-  const audienceType = normalizeAudienceType(options.account.config.audienceType);
-  const audience = options.account.config.audience?.trim();
-  const mediaMaxMb = options.account.config.mediaMaxMb ?? 20;
-
-  warnAppPrincipalMisconfiguration({
-    accountId: options.account.accountId,
-    audienceType,
-    appPrincipal: options.account.config.appPrincipal,
-    log: options.runtime.log,
-  });
-
-  const unregisterTarget = registerGoogleChatWebhookTarget({
-    account: options.account,
-    config: options.config,
-    runtime: options.runtime,
-    core,
-    path: webhookPath,
-    audienceType,
-    audience,
-    statusSink: options.statusSink,
-    mediaMaxMb,
-  });
-
-  return () => {
-    unregisterTarget();
-  };
-}
-
-export async function startGoogleChatMonitor(
-  params: GoogleChatMonitorOptions,
-): Promise<() => void> {
-  return monitorGoogleChatProvider(params);
-}
-
-export function resolveGoogleChatWebhookPath(params: {
-  account: ResolvedGoogleChatAccount;
-}): string {
-  return (
-    resolveWebhookPath({
-      webhookPath: params.account.config.webhookPath,
-      webhookUrl: params.account.config.webhookUrl,
-      defaultPath: "/googlechat",
-    }) ?? "/googlechat"
-  );
-}

package/src/monitor.webhook-routing.test.ts

@@ -1,252 +0,0 @@
-import { EventEmitter } from "node:events";
-import type { IncomingMessage } from "node:http";
-import {
-  createEmptyPluginRegistry,
-  setActivePluginRegistry,
-} from "openclaw/plugin-sdk/plugin-test-runtime";
-import { createMockServerResponse } from "openclaw/plugin-sdk/test-env";
-import { afterEach, describe, expect, it, vi } from "vitest";
-import type { OpenClawConfig, PluginRuntime } from "../runtime-api.js";
-import type { ResolvedGoogleChatAccount } from "./accounts.js";
-import { verifyGoogleChatRequest } from "./auth.js";
-import {
-  handleGoogleChatWebhookRequest,
-  registerGoogleChatWebhookTarget,
-} from "./monitor-routing.js";
-
-vi.mock("./auth.js", () => ({
-  verifyGoogleChatRequest: vi.fn(),
-}));
-
-function createWebhookRequest(params: {
-  authorization?: string;
-  payload: unknown;
-  path?: string;
-}): IncomingMessage {
-  const req = new EventEmitter() as IncomingMessage & {
-    destroyed?: boolean;
-    destroy: (error?: Error) => IncomingMessage;
-    on: (event: string, listener: (...args: unknown[]) => void) => IncomingMessage;
-  };
-  req.method = "POST";
-  req.url = params.path ?? "/googlechat";
-  req.headers = {
-    authorization: params.authorization ?? "",
-    "content-type": "application/json",
-  };
-  req.destroyed = false;
-  (req as unknown as { socket: { remoteAddress: string } }).socket = {
-    remoteAddress: "127.0.0.1",
-  };
-  req.destroy = () => {
-    req.destroyed = true;
-    return req;
-  };
-
-  const originalOn = req.on.bind(req);
-  let bodyScheduled = false;
-  req.on = ((event: string, listener: (...args: unknown[]) => void) => {
-    const result = originalOn(event, listener);
-    if (!bodyScheduled && event === "data") {
-      bodyScheduled = true;
-      void Promise.resolve().then(() => {
-        req.emit("data", Buffer.from(JSON.stringify(params.payload), "utf-8"));
-        if (!req.destroyed) {
-          req.emit("end");
-        }
-      });
-    }
-    return result;
-  }) as IncomingMessage["on"];
-
-  return req;
-}
-
-function createHeaderOnlyWebhookRequest(params: {
-  authorization?: string;
-  path?: string;
-}): IncomingMessage {
-  const req = new EventEmitter() as IncomingMessage;
-  req.method = "POST";
-  req.url = params.path ?? "/googlechat";
-  req.headers = {
-    authorization: params.authorization ?? "",
-    "content-type": "application/json",
-  };
-  (req as unknown as { socket: { remoteAddress: string } }).socket = {
-    remoteAddress: "127.0.0.1",
-  };
-  return req;
-}
-
-const baseAccount = (accountId: string) =>
-  ({
-    accountId,
-    enabled: true,
-    credentialSource: "none",
-    config: {},
-  }) as ResolvedGoogleChatAccount;
-
-function registerTwoTargets() {
-  const sinkA = vi.fn();
-  const sinkB = vi.fn();
-  const logA = vi.fn();
-  const logB = vi.fn();
-  const core = {} as PluginRuntime;
-  const config = {} as OpenClawConfig;
-
-  const unregisterA = registerGoogleChatWebhookTarget({
-    account: baseAccount("A"),
-    config,
-    runtime: { log: logA },
-    core,
-    path: "/googlechat",
-    statusSink: sinkA,
-    mediaMaxMb: 5,
-  });
-  const unregisterB = registerGoogleChatWebhookTarget({
-    account: baseAccount("B"),
-    config,
-    runtime: { log: logB },
-    core,
-    path: "/googlechat",
-    statusSink: sinkB,
-    mediaMaxMb: 5,
-  });
-
-  return {
-    logA,
-    logB,
-    sinkA,
-    sinkB,
-    unregister: () => {
-      unregisterA();
-      unregisterB();
-    },
-  };
-}
-
-async function dispatchWebhookRequest(req: IncomingMessage) {
-  const res = createMockServerResponse();
-  const handled = await handleGoogleChatWebhookRequest(req, res);
-  expect(handled).toBe(true);
-  return res;
-}
-
-async function expectVerifiedRoute(params: {
-  request: IncomingMessage;
-  expectedStatus: number;
-  sinkA: ReturnType<typeof vi.fn>;
-  sinkB: ReturnType<typeof vi.fn>;
-  expectedSink: "none" | "A" | "B";
-}) {
-  const res = await dispatchWebhookRequest(params.request);
-  expect(res.statusCode).toBe(params.expectedStatus);
-  const expectedCounts =
-    params.expectedSink === "A" ? [1, 0] : params.expectedSink === "B" ? [0, 1] : [0, 0];
-  expect(params.sinkA).toHaveBeenCalledTimes(expectedCounts[0]);
-  expect(params.sinkB).toHaveBeenCalledTimes(expectedCounts[1]);
-}
-
-function mockSecondVerifierSuccess() {
-  vi.mocked(verifyGoogleChatRequest)
-    .mockResolvedValueOnce({ ok: false, reason: "invalid" })
-    .mockResolvedValueOnce({ ok: true });
-}
-
-describe("Google Chat webhook routing", () => {
-  afterEach(() => {
-    setActivePluginRegistry(createEmptyPluginRegistry());
-  });
-
-  it("rejects ambiguous routing when multiple targets on the same path verify successfully", async () => {
-    vi.mocked(verifyGoogleChatRequest).mockResolvedValue({ ok: true });
-
-    const { sinkA, sinkB, unregister } = registerTwoTargets();
-
-    try {
-      await expectVerifiedRoute({
-        request: createWebhookRequest({
-          authorization: "Bearer test-token",
-          payload: { type: "ADDED_TO_SPACE", space: { name: "spaces/AAA" } },
-        }),
-        expectedStatus: 401,
-        sinkA,
-        sinkB,
-        expectedSink: "none",
-      });
-    } finally {
-      unregister();
-    }
-  });
-
-  it("routes to the single verified target when earlier targets fail verification", async () => {
-    mockSecondVerifierSuccess();
-
-    const { logA, logB, sinkA, sinkB, unregister } = registerTwoTargets();
-
-    try {
-      await expectVerifiedRoute({
-        request: createWebhookRequest({
-          authorization: "Bearer test-token",
-          payload: { type: "ADDED_TO_SPACE", space: { name: "spaces/BBB" } },
-        }),
-        expectedStatus: 200,
-        sinkA,
-        sinkB,
-        expectedSink: "B",
-      });
-      expect(logA).not.toHaveBeenCalled();
-      expect(logB).not.toHaveBeenCalled();
-    } finally {
-      unregister();
-    }
-  });
-
-  it("rejects invalid bearer before attempting to read the body", async () => {
-    vi.mocked(verifyGoogleChatRequest).mockResolvedValue({ ok: false, reason: "invalid" });
-    const { unregister } = registerTwoTargets();
-
-    try {
-      const req = createHeaderOnlyWebhookRequest({
-        authorization: "Bearer invalid-token",
-      });
-      const onSpy = vi.spyOn(req, "on");
-      const res = await dispatchWebhookRequest(req);
-      expect(res.statusCode).toBe(401);
-      expect(onSpy).not.toHaveBeenCalledWith("data", expect.any(Function));
-    } finally {
-      unregister();
-    }
-  });
-
-  it("supports add-on requests that provide systemIdToken in the body", async () => {
-    mockSecondVerifierSuccess();
-    const { sinkA, sinkB, unregister } = registerTwoTargets();
-
-    try {
-      await expectVerifiedRoute({
-        request: createWebhookRequest({
-          payload: {
-            commonEventObject: { hostApp: "CHAT" },
-            authorizationEventObject: { systemIdToken: "addon-token" },
-            chat: {
-              eventTime: "2026-03-02T00:00:00.000Z",
-              user: { name: "users/12345", displayName: "Test User" },
-              messagePayload: {
-                space: { name: "spaces/AAA" },
-                message: { text: "Hello from add-on" },
-              },
-            },
-          },
-        }),
-        expectedStatus: 200,
-        sinkA,
-        sinkB,
-        expectedSink: "B",
-      });
-    } finally {
-      unregister();
-    }
-  });
-});

package/src/runtime.ts

@@ -1,9 +0,0 @@
-import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
-import type { PluginRuntime } from "openclaw/plugin-sdk/runtime-store";
-
-const { setRuntime: setGoogleChatRuntime, getRuntime: getGoogleChatRuntime } =
-  createPluginRuntimeStore<PluginRuntime>({
-    pluginId: "googlechat",
-    errorMessage: "Google Chat runtime not initialized",
-  });
-export { getGoogleChatRuntime, setGoogleChatRuntime };