@kodelyth/google-meet 2026.5.39 → 2026.5.42

package/src/config-compat.test.ts

@@ -0,0 +1,98 @@
+import type { KlawConfig } from "klaw/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 KlawConfig;
+
+    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 KlawConfig;
+
+    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,84 @@
+import type { KlawConfig } from "klaw/plugin-sdk/config-contracts";
+
+type LegacyConfigRule = {
+  path: Array<string | number>;
+  message: string;
+  match: (value: unknown) => boolean;
+};
+
+function asRecord(value: unknown): Record<string, unknown> | null {
+  return value && typeof value === "object" && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+function normalizeProviderId(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim() ? value.trim().toLowerCase() : undefined;
+}
+
+function hasOwn(record: Record<string, unknown>, key: string): boolean {
+  return Object.prototype.hasOwnProperty.call(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 "klaw doctor --fix".',
+    match: hasLegacyGoogleRealtimeProvider,
+  },
+];
+
+export function migrateGoogleMeetLegacyRealtimeProvider(config: KlawConfig): {
+  config: KlawConfig;
+  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: KlawConfig }): {
+  config: KlawConfig;
+  changes: string[];
+} {
+  return migrateGoogleMeetLegacyRealtimeProvider(cfg) ?? { config: cfg, changes: [] };
+}