host-compat

import {
  deriveServerRequirements,
  evaluateHostCompat,
  evaluateAllHosts,
  scanWidgetSource,
  scanWidgetMeta,
  detectHostCompatBridgeFromMeta,
  HostCompatBridge,
} from "@mcpjam/sdk/host-compat";

deriveServerRequirements(
  toolsData?: HostCompatToolsInput | null,
  widgetUsage?: WidgetUsage,
  connectionFacts?: ConnectionFacts,
): ServerRequirements

import { deriveServerRequirements } from "@mcpjam/sdk/host-compat";

const tools = await manager.listTools("my-server");
const requirements = deriveServerRequirements(
  { tools: tools.tools },
  undefined, // widgetUsage — not yet scanned
  { protocolVersion: "2025-11-25" },
);

console.log(requirements.hasWidgets);          // true / false
console.log(requirements.widgets.mcpAppsOnly); // ["draw_chart", ...]
console.log(requirements.unknownDimensions);   // ["widget capabilities (widget HTML not analyzed)"]

evaluateHostCompat(
  requirements: ServerRequirements,
  profile: HostCompatProfile,
): HostCompatReport

evaluateAllHosts(
  toolsData: HostCompatToolsInput | null | undefined,
  profiles: HostCompatProfile[],
  options?: EvaluateAllHostsOptions,
): HostCompatEvaluation

import {
  evaluateAllHosts,
  type HostCompatProfile,
} from "@mcpjam/sdk/host-compat";

const claudeProfile: HostCompatProfile = {
  id: "claude",
  label: "Claude",
  provenance: "probe",
  rendersMcpApps: true,
  rendersOpenAiApps: false,
  supportedProtocolVersions: ["2025-11-25"],
  capabilities: {
    serverTools: true,
    openLinks: true,
    message: true,
    // ...
  },
};

const { requirements, reports } = evaluateAllHosts(
  { tools: toolsList },
  [claudeProfile],
  { connectionFacts: { protocolVersion: "2025-11-25" } },
);

for (const report of reports) {
  console.log(`${report.hostLabel}: ${report.verdict}`);
  for (const finding of report.findings) {
    console.log(`  [${finding.severity}] ${finding.title} — ${finding.detail}`);
  }
}

scanWidgetSource(html: string): WidgetUsage

type WidgetUsage = Partial<Record<WidgetCapabilityNeed, string[]>>;

type WidgetCapabilityNeed =
  | "serverTools"
  | "serverResources"
  | "message"
  | "updateModelContext"
  | "openLinks"
  | "downloadFile"
  | "sandboxPermissions"
  | "cspFrameDomains"
  | "logging";

scanWidgetMeta(meta: Record<string, unknown> | undefined): {
  bridge: HostCompatBridge;
  isAppOnly: boolean;
}

detectHostCompatBridgeFromMeta(
  meta: Record<string, unknown> | undefined,
): HostCompatBridge

enum HostCompatBridge {
  NONE = "none",
  MCP_APPS = "mcp-apps",
  OPENAI_SDK = "openai-sdk",
  OPENAI_SDK_AND_MCP_APPS = "openai-sdk-and-mcp-apps",
}