@actagent/google-meet 2026.6.2

package/src/config-compat.test.ts

@@ -0,0 +1,99 @@
+// Google Meet tests cover config compat plugin behavior.
+import type { ACTAgentConfig } from "actagent/plugin-sdk/config-contracts";
+import { describe, expect, it } from "vitest";
+import {
+  legacyConfigRules,
+  migrateGoogleMeetLegacyRealtimeProvider,
+  normalizeCompatibilityConfig,
+} from "./config-compat.js";
+
+describe("google-meet config compatibility", () => {
+  it("detects legacy Google realtime provider config", () => {
+    expect(
+      legacyConfigRules[0]?.match({
+        provider: "google",
+        model: "gemini-2.5-flash-native-audio-preview-12-2025",
+      }),
+    ).toBe(true);
+  });
+
+  it("migrates legacy Google bidi provider intent to scoped realtime providers", () => {
+    const config = {
+      plugins: {
+        entries: {
+          "google-meet": {
+            enabled: true,
+            config: {
+              defaultMode: "agent",
+              realtime: {
+                provider: "google",
+                model: "gemini-2.5-flash-native-audio-preview-12-2025",
+                providers: {
+                  google: {
+                    voice: "Kore",
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    } as ACTAgentConfig;
+
+    const migration = migrateGoogleMeetLegacyRealtimeProvider(config);
+
+    expect(migration?.changes).toEqual([
+      'Moved Google Meet legacy realtime.provider="google" intent to realtime.voiceProvider="google" and realtime.transcriptionProvider="openai".',
+    ]);
+    expect(
+      (
+        migration!.config.plugins!.entries!["google-meet"] as {
+          config?: { realtime?: Record<string, unknown> };
+        }
+      ).config?.realtime,
+    ).toEqual({
+      provider: "openai",
+      transcriptionProvider: "openai",
+      voiceProvider: "google",
+      model: "gemini-2.5-flash-native-audio-preview-12-2025",
+      providers: {
+        google: {
+          voice: "Kore",
+        },
+      },
+    });
+  });
+
+  it("leaves fully scoped provider configs alone", () => {
+    const config = {
+      plugins: {
+        entries: {
+          "google-meet": {
+            config: {
+              realtime: {
+                provider: "google",
+                transcriptionProvider: "custom-stt",
+                voiceProvider: "custom-voice",
+              },
+            },
+          },
+        },
+      },
+    } as ACTAgentConfig;
+
+    const migration = normalizeCompatibilityConfig({ cfg: config });
+
+    expect(migration.changes).toStrictEqual([]);
+    expect(
+      (
+        migration.config.plugins!.entries!["google-meet"] as {
+          config?: { realtime?: Record<string, unknown> };
+        }
+      ).config?.realtime,
+    ).toEqual({
+      provider: "google",
+      transcriptionProvider: "custom-stt",
+      voiceProvider: "custom-voice",
+    });
+  });
+});

package/src/config-compat.ts

@@ -0,0 +1,79 @@
+// Google Meet helper module supports config compat behavior.
+import type { ACTAgentConfig } from "actagent/plugin-sdk/config-contracts";
+import {
+  asNullableRecord as asRecord,
+  normalizeOptionalLowercaseString as normalizeProviderId,
+} from "actagent/plugin-sdk/string-coerce-runtime";
+
+type LegacyConfigRule = {
+  path: Array<string | number>;
+  message: string;
+  match: (value: unknown) => boolean;
+};
+
+function hasOwn(record: Record<string, unknown>, key: string): boolean {
+  return Object.hasOwn(record, key);
+}
+
+function hasLegacyGoogleRealtimeProvider(value: unknown): boolean {
+  const realtime = asRecord(value);
+  if (!realtime || normalizeProviderId(realtime.provider) !== "google") {
+    return false;
+  }
+  return !hasOwn(realtime, "voiceProvider") || !hasOwn(realtime, "transcriptionProvider");
+}
+
+export const legacyConfigRules: LegacyConfigRule[] = [
+  {
+    path: ["plugins", "entries", "google-meet", "config", "realtime"],
+    message:
+      'plugins.entries.google-meet.config.realtime.provider="google" is legacy for Gemini Live bidi mode; use realtime.voiceProvider="google" and realtime.transcriptionProvider="openai". Run "actagent doctor --fix".',
+    match: hasLegacyGoogleRealtimeProvider,
+  },
+];
+
+export function migrateGoogleMeetLegacyRealtimeProvider(config: ACTAgentConfig): {
+  config: ACTAgentConfig;
+  changes: string[];
+} | null {
+  const rawEntry = asRecord(config.plugins?.entries?.["google-meet"]);
+  const rawPluginConfig = asRecord(rawEntry?.config);
+  const rawRealtime = asRecord(rawPluginConfig?.realtime);
+  if (!rawRealtime || !hasLegacyGoogleRealtimeProvider(rawRealtime)) {
+    return null;
+  }
+
+  const nextConfig = structuredClone(config);
+  const nextPlugins = asRecord(nextConfig.plugins) ?? {};
+  nextConfig.plugins = nextPlugins;
+  const nextEntries = asRecord(nextPlugins.entries) ?? {};
+  nextPlugins.entries = nextEntries;
+  const nextEntry = asRecord(nextEntries["google-meet"]) ?? {};
+  nextEntries["google-meet"] = nextEntry;
+  const nextPluginConfig = asRecord(nextEntry.config) ?? {};
+  nextEntry.config = nextPluginConfig;
+  const nextRealtime = asRecord(nextPluginConfig.realtime) ?? {};
+  nextPluginConfig.realtime = nextRealtime;
+
+  nextRealtime.provider = "openai";
+  if (!hasOwn(nextRealtime, "transcriptionProvider")) {
+    nextRealtime.transcriptionProvider = "openai";
+  }
+  if (!hasOwn(nextRealtime, "voiceProvider")) {
+    nextRealtime.voiceProvider = "google";
+  }
+
+  return {
+    config: nextConfig,
+    changes: [
+      'Moved Google Meet legacy realtime.provider="google" intent to realtime.voiceProvider="google" and realtime.transcriptionProvider="openai".',
+    ],
+  };
+}
+
+export function normalizeCompatibilityConfig({ cfg }: { cfg: ACTAgentConfig }): {
+  config: ACTAgentConfig;
+  changes: string[];
+} {
+  return migrateGoogleMeetLegacyRealtimeProvider(cfg) ?? { config: cfg, changes: [] };
+}

package/src/config.test.ts

@@ -0,0 +1,57 @@
+// Google Meet tests cover config plugin behavior.
+import { MAX_TIMER_TIMEOUT_MS } from "actagent/plugin-sdk/number-runtime";
+import { describe, expect, it } from "vitest";
+import { resolveGoogleMeetConfig, resolveGoogleMeetGatewayOperationTimeoutMs } from "./config.js";
+
+describe("google meet gateway operation timeout", () => {
+  it("caps timer config fields before runtime polling uses them", () => {
+    const config = resolveGoogleMeetConfig({
+      chrome: {
+        joinTimeoutMs: Number.MAX_VALUE,
+        waitForInCallMs: Number.MAX_VALUE,
+        bargeInCooldownMs: Number.MAX_VALUE,
+      },
+      voiceCall: {
+        requestTimeoutMs: Number.MAX_VALUE,
+        dtmfDelayMs: Number.MAX_VALUE,
+        postDtmfSpeechDelayMs: Number.MAX_VALUE,
+      },
+    });
+
+    expect(config.chrome.joinTimeoutMs).toBe(MAX_TIMER_TIMEOUT_MS);
+    expect(config.chrome.waitForInCallMs).toBe(MAX_TIMER_TIMEOUT_MS);
+    expect(config.chrome.bargeInCooldownMs).toBe(MAX_TIMER_TIMEOUT_MS);
+    expect(config.voiceCall.requestTimeoutMs).toBe(MAX_TIMER_TIMEOUT_MS);
+    expect(config.voiceCall.dtmfDelayMs).toBe(MAX_TIMER_TIMEOUT_MS);
+    expect(config.voiceCall.postDtmfSpeechDelayMs).toBe(MAX_TIMER_TIMEOUT_MS);
+  });
+
+  it("adds operation grace to normal transport timeouts", () => {
+    expect(resolveGoogleMeetGatewayOperationTimeoutMs(resolveGoogleMeetConfig({}))).toBe(60_000);
+    expect(
+      resolveGoogleMeetGatewayOperationTimeoutMs(
+        resolveGoogleMeetConfig({
+          chrome: { joinTimeoutMs: 120_000 },
+          voiceCall: { requestTimeoutMs: 30_000 },
+        }),
+      ),
+    ).toBe(150_000);
+  });
+
+  it("caps overflowed transport timeout grace", () => {
+    expect(
+      resolveGoogleMeetGatewayOperationTimeoutMs(
+        resolveGoogleMeetConfig({
+          chrome: { joinTimeoutMs: Number.MAX_VALUE },
+        }),
+      ),
+    ).toBe(MAX_TIMER_TIMEOUT_MS);
+    expect(
+      resolveGoogleMeetGatewayOperationTimeoutMs(
+        resolveGoogleMeetConfig({
+          voiceCall: { requestTimeoutMs: Number.MAX_VALUE },
+        }),
+      ),
+    ).toBe(MAX_TIMER_TIMEOUT_MS);
+  });
+});