Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

2.2 KB
Raw Blame
/**
 * The fallback for browsers that have not shipped WebMCP.
 *
 * `@mcp-b/global` does two things: it defines `document.modelContext`, and it
 * stands up an in-page MCP server for a bridge extension to attach to. The
 * second is the reason this is the chosen package over the bare
 * `@mcp-b/webmcp-polyfill`: without the server there is nothing for an
 * out-of-browser agent to connect to, which is the only case the fallback
 * exists to serve.
 *
 * It is a DYNAMIC import so a browser with native support never downloads it,
 * and so it lands in its own chunk rather than the entry bundle.
 */

import { makeStudioDebugLogger } from "../utils/studioDebug";
import { trackEvent } from "../telemetry/client";
import { getModelContext, type ModelContext } from "./types";

const log = makeStudioDebugLogger("webmcp");

/**
 * Module-level, so two mounts racing (React StrictMode, or a remount during
 * the import) share one load instead of pulling the package twice.
 */
let pending: Promise<ModelContext | null> | null = null;

async function importPolyfill(): Promise<ModelContext | null> {
  try {
    await import("@mcp-b/global");
    const modelContext = getModelContext();
    if (!modelContext) {
      // The package loaded but did not define what it promises to define.
      log("polyfill", { loaded: true, modelContext: false });
      trackEvent("webmcp.polyfill_failed", { error_name: "ModelContextMissingError" });
    } else {
      trackEvent("webmcp.polyfill_loaded");
    }
    return modelContext;
  } catch (error) {
    // A missing agent surface must never break Studio's boot.
    log("polyfill", { failed: error instanceof Error ? error.message : String(error) });
    trackEvent("webmcp.polyfill_failed", {
      error_name: error instanceof Error ? error.name : "NonError",
    });
    return null;
  }
}

export function loadModelContextPolyfill(): Promise<ModelContext | null> {
  if (pending) return pending;

  const attempt = importPolyfill();
  pending = attempt;
  // A transient chunk/CSP failure must not disable WebMCP for the rest of the
  // tab. Concurrent callers still share this attempt; a later mount may retry.
  void attempt.then((modelContext) => {
    if (modelContext === null && pending === attempt) pending = null;
  });
  return pending;
}