@tambo-ai/react 0.65.3 → 0.66.0

package/esm/providers/tambo-registry-provider.js

@@ -1,82 +1,15 @@
 "use client";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
-import { ZodSchema } from "zod/v3";
-import zodToJsonSchema from "zod-to-json-schema";
-import { getMcpServerUniqueKey, MCPTransport, } from "../model/mcp-server-info";
-import { assertValidName } from "../util/validate-component-name";
-import { assertNoZodRecord } from "../util/validate-zod-schema";
-/**
- * Derives a short, meaningful key from a server URL.
- * Strips TLDs and common prefixes to get a human-readable identifier.
- * For example, "https://mcp.linear.app/mcp" becomes "linear".
- * @returns A lowercased, human-readable key derived from the URL
- */
-function deriveServerKey(url) {
-    try {
-        const parsed = new URL(url);
-        const hostname = parsed.hostname;
-        // Split hostname into parts
-        const parts = hostname.split(".");
-        // Remove common TLD patterns
-        // Handle cases like: .com, .org, .co.uk, .com.au, etc.
-        let relevantParts = [...parts];
-        // If we have 3+ parts and the last two are short (likely TLD like .co.uk)
-        if (relevantParts.length >= 3 &&
-            relevantParts[relevantParts.length - 1].length <= 3 &&
-            relevantParts[relevantParts.length - 2].length <= 3) {
-            relevantParts = relevantParts.slice(0, -2);
-        }
-        // Otherwise just remove the last part (TLD like .com)
-        else if (relevantParts.length >= 2) {
-            relevantParts = relevantParts.slice(0, -1);
-        }
-        // From what's left, prefer the rightmost part that's not a common prefix
-        // Common prefixes: www, api, mcp, app, etc.
-        const commonPrefixes = new Set([
-            "www",
-            "api",
-            "mcp",
-            "app",
-            "staging",
-            "dev",
-            "prod",
-        ]);
-        // Work backwards through the parts to find a meaningful name
-        for (let i = relevantParts.length - 1; i >= 0; i--) {
-            const part = relevantParts[i];
-            if (part && !commonPrefixes.has(part.toLowerCase())) {
-                return part.toLowerCase();
-            }
-        }
-        // Fallback: use the last relevant part even if it's a common prefix
-        return relevantParts[relevantParts.length - 1]?.toLowerCase() || hostname;
-    }
-    catch {
-        // If URL parsing fails, just return a sanitized version of the input
-        return url.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
-    }
-}
-/**
- * Normalizes an MCP server info object, ensuring it has a serverKey.
- * If serverKey is not provided, derives it from the URL.
- * @returns The normalized MCP server info object
- */
-function normalizeServerInfo(server) {
-    const base = typeof server === "string"
-        ? {
-            url: server,
-            transport: MCPTransport.HTTP,
-        }
-        : server;
-    const serverKey = base.serverKey ?? deriveServerKey(base.url);
-    const transport = base.transport ?? MCPTransport.HTTP;
-    return { ...base, transport, serverKey };
-}
+import { deduplicateMcpServers, normalizeServerInfo, } from "../util/mcp-server-utils";
+import { validateAndPrepareComponent, validateTool, validateToolAssociation, } from "../util/registry-validators";
+import { validateResource, validateResourceSource, } from "../util/resource-validators";
 export const TamboRegistryContext = createContext({
     componentList: {},
     toolRegistry: {},
     componentToolAssociations: {},
     mcpServerInfos: [],
+    resources: [],
+    resourceSource: null,
     /**
      *
      */
@@ -101,6 +34,18 @@ export const TamboRegistryContext = createContext({
      *
      */
     registerMcpServers: () => { },
+    /**
+     *
+     */
+    registerResource: () => { },
+    /**
+     *
+     */
+    registerResources: () => { },
+    /**
+     *
+     */
+    registerResourceSource: () => { },
 });
 /**
  * The TamboRegistryProvider is a React provider that provides a component
@@ -110,22 +55,22 @@ export const TamboRegistryContext = createContext({
  * @param props.components - The components to register
  * @param props.tools - The tools to register
  * @param props.mcpServers - The MCP servers to register
+ * @param props.resources - The static resources to register
+ * @param props.listResources - The dynamic resource search function (must be paired with getResource)
+ * @param props.getResource - The dynamic resource fetch function (must be paired with listResources)
  * @param props.onCallUnregisteredTool - The function to call when an unknown tool is called (optional)
  * @returns The TamboRegistryProvider component
  */
-export const TamboRegistryProvider = ({ children, components: userComponents, tools: userTools, mcpServers: userMcpServers, onCallUnregisteredTool, }) => {
+export const TamboRegistryProvider = ({ children, components: userComponents, tools: userTools, mcpServers: userMcpServers, resources: userResources, listResources: userListResources, getResource: userGetResource, onCallUnregisteredTool, }) => {
     const [componentList, setComponentList] = useState({});
     const [toolRegistry, setToolRegistry] = useState({});
     const [componentToolAssociations, setComponentToolAssociations] = useState({});
     const [staticMcpServerInfos, setStaticMcpServerInfos] = useState([]);
     const [dynamicMcpServerInfos, setDynamicMcpServerInfos] = useState([]);
+    const [staticResources, setStaticResources] = useState([]);
+    const [resourceSource, setResourceSource] = useState(null);
     const registerTool = useCallback((tool, warnOnOverwrite = true) => {
-        // Validate tool name
-        assertValidName(tool.name, "tool");
-        // Validate tool schemas
-        if (tool.toolSchema && isZodSchema(tool.toolSchema)) {
-            assertNoZodRecord(tool.toolSchema, `toolSchema of tool "${tool.name}"`);
-        }
+        validateTool(tool);
         setToolRegistry((prev) => {
             if (prev[tool.name] && warnOnOverwrite) {
                 console.warn(`Overwriting tool ${tool.name}`);
@@ -148,38 +93,15 @@ export const TamboRegistryProvider = ({ children, components: userComponents, to
         setDynamicMcpServerInfos((prev) => [...prev, ...normalized]);
     }, []);
     const addToolAssociation = useCallback((componentName, tool) => {
-        // Validate component and tool names
-        assertValidName(componentName, "component");
-        assertValidName(tool.name, "tool");
-        if (!componentList[componentName]) {
-            throw new Error(`Component ${componentName} not found in registry`);
-        }
-        if (!toolRegistry[tool.name]) {
-            throw new Error(`Tool ${tool.name} not found in registry`);
-        }
+        validateToolAssociation(componentName, tool.name, !!componentList[componentName], !!toolRegistry[tool.name]);
         setComponentToolAssociations((prev) => ({
             ...prev,
             [componentName]: [...(prev[componentName] || []), tool.name],
         }));
     }, [componentList, toolRegistry]);
     const registerComponent = useCallback((options, warnOnOverwrite = true) => {
-        const { name, description, component, propsSchema, propsDefinition, loadingComponent, associatedTools, } = options;
-        // Validate component name
-        assertValidName(name, "component");
-        // Validate that at least one props definition is provided
-        if (!propsSchema && !propsDefinition) {
-            throw new Error(`Component ${name} must have either propsSchema (recommended) or propsDefinition defined`);
-        }
-        // Validate that only one props definition is provided
-        if (propsSchema && propsDefinition) {
-            throw new Error(`Component ${name} cannot have both propsSchema and propsDefinition defined. Use only one. We recommend using propsSchema.`);
-        }
-        // Validate that the propsSchema does not include z.record()
-        if (propsSchema && isZodSchema(propsSchema)) {
-            assertNoZodRecord(propsSchema, `propsSchema of component "${name}"`);
-        }
-        // Convert propsSchema to JSON Schema if it exists
-        const props = getSerializedProps(propsDefinition, propsSchema, name);
+        const { name, description, component, loadingComponent, associatedTools, } = options;
+        const { props } = validateAndPrepareComponent(options);
         setComponentList((prev) => {
             if (prev[name] && warnOnOverwrite) {
                 console.warn(`overwriting component ${name}`);
@@ -225,44 +147,60 @@ export const TamboRegistryProvider = ({ children, components: userComponents, to
         const normalized = userMcpServers.map(normalizeServerInfo);
         setStaticMcpServerInfos(normalized);
     }, [userMcpServers]);
-    const mcpServerInfos = useMemo(() => {
-        const allServers = [...staticMcpServerInfos, ...dynamicMcpServerInfos];
-        if (allServers.length === 0) {
-            return allServers;
+    useEffect(() => {
+        // Validate that listResources and getResource are both provided or both omitted
+        validateResourceSource(userListResources, userGetResource);
+        // Set static resources from props
+        if (userResources) {
+            userResources.forEach((resource) => validateResource(resource));
+            setStaticResources(userResources);
+        }
+        else {
+            setStaticResources([]);
+        }
+        // Set resource source from props
+        if (userListResources && userGetResource) {
+            setResourceSource({
+                listResources: userListResources,
+                getResource: userGetResource,
+            });
         }
-        // 1. Deduplicate by connection identity using a stable key
-        const byKey = new Map();
-        for (const server of allServers) {
-            const key = getMcpServerUniqueKey(server);
-            byKey.set(key, server);
+        else {
+            setResourceSource(null);
         }
-        const deduped = Array.from(byKey.values());
-        // 2. Ensure serverKey uniqueness for readable, unambiguous prefixes
-        const seen = new Map();
-        return deduped.map((server) => {
-            const baseKey = server.serverKey;
-            const count = (seen.get(baseKey) ?? 0) + 1;
-            seen.set(baseKey, count);
-            if (count === 1) {
-                return server;
-            }
-            return {
-                ...server,
-                serverKey: `${baseKey}-${count}`,
-            };
-        });
+    }, [userResources, userListResources, userGetResource]);
+    const registerResource = useCallback((resource) => {
+        validateResource(resource);
+        setStaticResources((prev) => [...prev, resource]);
+    }, []);
+    const registerResources = useCallback((resources) => {
+        resources.forEach((resource) => validateResource(resource));
+        setStaticResources((prev) => [...prev, ...resources]);
+    }, []);
+    const registerResourceSource = useCallback((source) => {
+        validateResourceSource(source.listResources, source.getResource);
+        setResourceSource(source);
+    }, []);
+    const mcpServerInfos = useMemo(() => {
+        const allServers = [...staticMcpServerInfos, ...dynamicMcpServerInfos];
+        return deduplicateMcpServers(allServers);
     }, [staticMcpServerInfos, dynamicMcpServerInfos]);
     const value = {
         componentList,
         toolRegistry,
         componentToolAssociations,
         mcpServerInfos,
+        resources: staticResources,
+        resourceSource,
         registerComponent,
         registerTool,
         registerTools,
         addToolAssociation,
         registerMcpServer,
         registerMcpServers,
+        registerResource,
+        registerResources,
+        registerResourceSource,
         onCallUnregisteredTool,
     };
     return (React.createElement(TamboRegistryContext.Provider, { value: value }, children));
@@ -307,50 +245,4 @@ export const useTamboRegistry = () => {
 export const useTamboMcpServerInfos = () => {
     return useContext(TamboRegistryContext).mcpServerInfos;
 };
-function getSerializedProps(propsDefinition, propsSchema, name) {
-    if (propsDefinition) {
-        console.warn(`propsDefinition is deprecated. Use propsSchema instead.`);
-        return propsDefinition;
-    }
-    if (isZodSchema(propsSchema)) {
-        try {
-            return zodToJsonSchema(propsSchema);
-        }
-        catch (error) {
-            console.error(`Error converting ${name} props schema to JSON Schema:`, error);
-        }
-    }
-    // try to roughly detect JSONSchema, should always be an object with a properties key
-    if (isJSONSchema(propsSchema)) {
-        return propsSchema;
-    }
-    throw new Error(`Invalid props schema for ${name}`);
-}
-/**
- * Checks if the propsSchema is a JSON Schema. This is a rough check, and the
- * server will provide the definitive check.
- * @param propsSchema - The props schema to check
- * @returns True if the props schema is a JSON Schema, false otherwise
- */
-function isJSONSchema(propsSchema) {
-    return (propsSchema &&
-        typeof propsSchema === "object" &&
-        propsSchema.type === "object" &&
-        propsSchema.properties);
-}
-/**
- * Since we require a certain zod version, we need to check if the object is a ZodSchema
- * @param obj - The object to check
- * @returns True if the object is a ZodSchema, false otherwise
- */
-function isZodSchema(obj) {
-    if (obj instanceof ZodSchema) {
-        return true;
-    }
-    // try to detect if the object is a ZodSchema
-    return (typeof obj === "object" &&
-        obj !== null &&
-        typeof obj.safeParse === "function" &&
-        typeof obj._def === "object");
-}
 //# sourceMappingURL=tambo-registry-provider.js.map

package/esm/providers/tambo-registry-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-registry-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-registry-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport type TamboAI from \"@tambo-ai/typescript-sdk\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport { ZodSchema } from \"zod/v3\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport {\n  ComponentRegistry,\n  TamboComponent,\n  TamboTool,\n} from \"../model/component-metadata\";\nimport {\n  getMcpServerUniqueKey,\n  McpServerInfo,\n  MCPTransport,\n  type NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\nimport { assertValidName } from \"../util/validate-component-name\";\nimport { assertNoZodRecord } from \"../util/validate-zod-schema\";\n\n/**\n * Derives a short, meaningful key from a server URL.\n * Strips TLDs and common prefixes to get a human-readable identifier.\n * For example, \"https://mcp.linear.app/mcp\" becomes \"linear\".\n * @returns A lowercased, human-readable key derived from the URL\n */\nfunction deriveServerKey(url: string): string {\n  try {\n    const parsed = new URL(url);\n    const hostname = parsed.hostname;\n\n    // Split hostname into parts\n    const parts = hostname.split(\".\");\n\n    // Remove common TLD patterns\n    // Handle cases like: .com, .org, .co.uk, .com.au, etc.\n    let relevantParts = [...parts];\n\n    // If we have 3+ parts and the last two are short (likely TLD like .co.uk)\n    if (\n      relevantParts.length >= 3 &&\n      relevantParts[relevantParts.length - 1].length <= 3 &&\n      relevantParts[relevantParts.length - 2].length <= 3\n    ) {\n      relevantParts = relevantParts.slice(0, -2);\n    }\n    // Otherwise just remove the last part (TLD like .com)\n    else if (relevantParts.length >= 2) {\n      relevantParts = relevantParts.slice(0, -1);\n    }\n\n    // From what's left, prefer the rightmost part that's not a common prefix\n    // Common prefixes: www, api, mcp, app, etc.\n    const commonPrefixes = new Set([\n      \"www\",\n      \"api\",\n      \"mcp\",\n      \"app\",\n      \"staging\",\n      \"dev\",\n      \"prod\",\n    ]);\n\n    // Work backwards through the parts to find a meaningful name\n    for (let i = relevantParts.length - 1; i >= 0; i--) {\n      const part = relevantParts[i];\n      if (part && !commonPrefixes.has(part.toLowerCase())) {\n        return part.toLowerCase();\n      }\n    }\n\n    // Fallback: use the last relevant part even if it's a common prefix\n    return relevantParts[relevantParts.length - 1]?.toLowerCase() || hostname;\n  } catch {\n    // If URL parsing fails, just return a sanitized version of the input\n    return url.replace(/[^a-zA-Z0-9]/g, \"_\").toLowerCase();\n  }\n}\n\n/**\n * Normalizes an MCP server info object, ensuring it has a serverKey.\n * If serverKey is not provided, derives it from the URL.\n * @returns The normalized MCP server info object\n */\nfunction normalizeServerInfo(\n  server: McpServerInfo | string,\n): NormalizedMcpServerInfo {\n  const base: McpServerInfo =\n    typeof server === \"string\"\n      ? {\n          url: server,\n          transport: MCPTransport.HTTP,\n        }\n      : server;\n\n  const serverKey = base.serverKey ?? deriveServerKey(base.url);\n  const transport = base.transport ?? MCPTransport.HTTP;\n\n  return { ...base, transport, serverKey };\n}\n\nexport interface TamboRegistryContext {\n  componentList: ComponentRegistry;\n  toolRegistry: Record<string, TamboTool>;\n  componentToolAssociations: Record<string, string[]>;\n  mcpServerInfos: NormalizedMcpServerInfo[];\n  registerComponent: (options: TamboComponent) => void;\n  registerTool: (tool: TamboTool) => void;\n  registerTools: (tools: TamboTool[]) => void;\n  addToolAssociation: (componentName: string, tool: TamboTool) => void;\n  registerMcpServer: (info: McpServerInfo) => void;\n  registerMcpServers: (infos: McpServerInfo[]) => void;\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>;\n}\n\nexport const TamboRegistryContext = createContext<TamboRegistryContext>({\n  componentList: {},\n  toolRegistry: {},\n  componentToolAssociations: {},\n  mcpServerInfos: [],\n  /**\n   *\n   */\n  registerComponent: () => {},\n  /**\n   *\n   */\n  registerTool: () => {},\n  /**\n   *\n   */\n  registerTools: () => {},\n  /**\n   *\n   */\n  addToolAssociation: () => {},\n  /**\n   *\n   */\n  registerMcpServer: () => {},\n  /**\n   *\n   */\n  registerMcpServers: () => {},\n});\n\nexport interface TamboRegistryProviderProps {\n  /** The components to register */\n  components?: TamboComponent[];\n  /** The tools to register */\n  tools?: TamboTool[];\n  /** The MCP servers to register */\n  mcpServers?: (McpServerInfo | string)[];\n\n  /**\n   * A function to call when an unknown tool is called. If this function is not\n   * provided, an error will be thrown when a tool call is requested by the\n   * server.\n   *\n   * Note that this is generally only for agents, where the agent code may\n   * request tool calls that are not registered in the tool registry.\n   */\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>;\n}\n\n/**\n * The TamboRegistryProvider is a React provider that provides a component\n * registry to the descendants of the provider.\n * @param props - The props for the TamboRegistryProvider\n * @param props.children - The children to wrap\n * @param props.components - The components to register\n * @param props.tools - The tools to register\n * @param props.mcpServers - The MCP servers to register\n * @param props.onCallUnregisteredTool - The function to call when an unknown tool is called (optional)\n * @returns The TamboRegistryProvider component\n */\nexport const TamboRegistryProvider: React.FC<\n  PropsWithChildren<TamboRegistryProviderProps>\n> = ({\n  children,\n  components: userComponents,\n  tools: userTools,\n  mcpServers: userMcpServers,\n  onCallUnregisteredTool,\n}) => {\n  const [componentList, setComponentList] = useState<ComponentRegistry>({});\n  const [toolRegistry, setToolRegistry] = useState<Record<string, TamboTool>>(\n    {},\n  );\n  const [componentToolAssociations, setComponentToolAssociations] = useState<\n    Record<string, string[]>\n  >({});\n  const [staticMcpServerInfos, setStaticMcpServerInfos] = useState<\n    NormalizedMcpServerInfo[]\n  >([]);\n  const [dynamicMcpServerInfos, setDynamicMcpServerInfos] = useState<\n    NormalizedMcpServerInfo[]\n  >([]);\n\n  const registerTool = useCallback(\n    (tool: TamboTool, warnOnOverwrite = true) => {\n      // Validate tool name\n      assertValidName(tool.name, \"tool\");\n\n      // Validate tool schemas\n      if (tool.toolSchema && isZodSchema(tool.toolSchema)) {\n        assertNoZodRecord(tool.toolSchema, `toolSchema of tool \"${tool.name}\"`);\n      }\n      setToolRegistry((prev) => {\n        if (prev[tool.name] && warnOnOverwrite) {\n          console.warn(`Overwriting tool ${tool.name}`);\n        }\n        return {\n          ...prev,\n          [tool.name]: tool,\n        };\n      });\n    },\n    [],\n  );\n\n  const registerTools = useCallback(\n    (tools: TamboTool[], warnOnOverwrite = true) => {\n      tools.forEach((tool) => registerTool(tool, warnOnOverwrite));\n    },\n    [registerTool],\n  );\n\n  const registerMcpServer = useCallback((info: McpServerInfo | string) => {\n    const normalized = normalizeServerInfo(info);\n    setDynamicMcpServerInfos((prev) => [...prev, normalized]);\n  }, []);\n\n  const registerMcpServers = useCallback(\n    (infos: (McpServerInfo | string)[]) => {\n      const normalized = infos.map(normalizeServerInfo);\n      setDynamicMcpServerInfos((prev) => [...prev, ...normalized]);\n    },\n    [],\n  );\n\n  const addToolAssociation = useCallback(\n    (componentName: string, tool: TamboTool) => {\n      // Validate component and tool names\n      assertValidName(componentName, \"component\");\n      assertValidName(tool.name, \"tool\");\n\n      if (!componentList[componentName]) {\n        throw new Error(`Component ${componentName} not found in registry`);\n      }\n      if (!toolRegistry[tool.name]) {\n        throw new Error(`Tool ${tool.name} not found in registry`);\n      }\n\n      setComponentToolAssociations((prev) => ({\n        ...prev,\n        [componentName]: [...(prev[componentName] || []), tool.name],\n      }));\n    },\n    [componentList, toolRegistry],\n  );\n\n  const registerComponent = useCallback(\n    (options: TamboComponent, warnOnOverwrite = true) => {\n      const {\n        name,\n        description,\n        component,\n        propsSchema,\n        propsDefinition,\n        loadingComponent,\n        associatedTools,\n      } = options;\n\n      // Validate component name\n      assertValidName(name, \"component\");\n\n      // Validate that at least one props definition is provided\n      if (!propsSchema && !propsDefinition) {\n        throw new Error(\n          `Component ${name} must have either propsSchema (recommended) or propsDefinition defined`,\n        );\n      }\n\n      // Validate that only one props definition is provided\n      if (propsSchema && propsDefinition) {\n        throw new Error(\n          `Component ${name} cannot have both propsSchema and propsDefinition defined. Use only one. We recommend using propsSchema.`,\n        );\n      }\n\n      // Validate that the propsSchema does not include z.record()\n      if (propsSchema && isZodSchema(propsSchema)) {\n        assertNoZodRecord(propsSchema, `propsSchema of component \"${name}\"`);\n      }\n\n      // Convert propsSchema to JSON Schema if it exists\n      const props = getSerializedProps(propsDefinition, propsSchema, name);\n\n      setComponentList((prev) => {\n        if (prev[name] && warnOnOverwrite) {\n          console.warn(`overwriting component ${name}`);\n        }\n        return {\n          ...prev,\n          [name]: {\n            component,\n            loadingComponent,\n            name,\n            description,\n            props,\n            contextTools: [],\n          },\n        };\n      });\n      if (associatedTools) {\n        registerTools(associatedTools);\n        setComponentToolAssociations((prev) => ({\n          ...prev,\n          [name]: associatedTools.map((tool) => tool.name),\n        }));\n      }\n    },\n    [registerTools],\n  );\n  useEffect(() => {\n    if (userComponents) {\n      userComponents.forEach((component) => {\n        registerComponent(component, false);\n      });\n    }\n  }, [registerComponent, userComponents]);\n\n  useEffect(() => {\n    if (userTools) {\n      registerTools(userTools, false);\n    }\n  }, [registerTools, userTools]);\n\n  useEffect(() => {\n    if (!userMcpServers || userMcpServers.length === 0) {\n      setStaticMcpServerInfos([]);\n      return;\n    }\n\n    // Normalize servers from props and ensure all have serverKey and transport\n    const normalized = userMcpServers.map(normalizeServerInfo);\n    setStaticMcpServerInfos(normalized);\n  }, [userMcpServers]);\n\n  const mcpServerInfos: NormalizedMcpServerInfo[] = useMemo(() => {\n    const allServers = [...staticMcpServerInfos, ...dynamicMcpServerInfos];\n    if (allServers.length === 0) {\n      return allServers;\n    }\n\n    // 1. Deduplicate by connection identity using a stable key\n    const byKey = new Map<string, NormalizedMcpServerInfo>();\n    for (const server of allServers) {\n      const key = getMcpServerUniqueKey(server);\n      byKey.set(key, server);\n    }\n\n    const deduped = Array.from(byKey.values());\n\n    // 2. Ensure serverKey uniqueness for readable, unambiguous prefixes\n    const seen = new Map<string, number>();\n    return deduped.map((server) => {\n      const baseKey = server.serverKey;\n      const count = (seen.get(baseKey) ?? 0) + 1;\n      seen.set(baseKey, count);\n\n      if (count === 1) {\n        return server;\n      }\n\n      return {\n        ...server,\n        serverKey: `${baseKey}-${count}`,\n      };\n    });\n  }, [staticMcpServerInfos, dynamicMcpServerInfos]);\n\n  const value = {\n    componentList,\n    toolRegistry,\n    componentToolAssociations,\n    mcpServerInfos,\n    registerComponent,\n    registerTool,\n    registerTools,\n    addToolAssociation,\n    registerMcpServer,\n    registerMcpServers,\n    onCallUnregisteredTool,\n  };\n\n  return (\n    <TamboRegistryContext.Provider value={value}>\n      {children}\n    </TamboRegistryContext.Provider>\n  );\n};\n\n/**\n * The useTamboRegistry hook provides access to the component registry\n * to the descendants of the TamboRegistryProvider.\n * @returns The component registry\n */\nexport const useTamboRegistry = () => {\n  return useContext(TamboRegistryContext);\n};\n\n/**\n * Hook to access the MCP server metadata from TamboRegistryProvider.\n * This provides access to the registered MCP server configurations (metadata only, not connections).\n *\n * This hook can be used anywhere within the TamboProvider hierarchy to access\n * the list of configured MCP servers without needing to be inside TamboMcpProvider.\n * @returns Array of MCP server metadata\n * @example\n * ```tsx\n * function MyComponent() {\n *   const mcpServers = useTamboMcpServerInfos();\n *\n *   return (\n *     <div>\n *       <h3>Configured MCP Servers:</h3>\n *       {mcpServers.map((server) => (\n *         <div key={server.url}>\n *           {server.name || server.url}\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n *\n * The returned objects are `NormalizedMcpServerInfo` instances, meaning both\n * `serverKey` and `transport` are always populated (with `transport`\n * defaulting to HTTP when not explicitly specified).\n */\nexport const useTamboMcpServerInfos = (): NormalizedMcpServerInfo[] => {\n  return useContext(TamboRegistryContext).mcpServerInfos;\n};\nfunction getSerializedProps(\n  propsDefinition: any,\n  propsSchema: any,\n  name: string,\n) {\n  if (propsDefinition) {\n    console.warn(`propsDefinition is deprecated. Use propsSchema instead.`);\n    return propsDefinition;\n  }\n\n  if (isZodSchema(propsSchema)) {\n    try {\n      return zodToJsonSchema(propsSchema);\n    } catch (error) {\n      console.error(\n        `Error converting ${name} props schema to JSON Schema:`,\n        error,\n      );\n    }\n  }\n  // try to roughly detect JSONSchema, should always be an object with a properties key\n  if (isJSONSchema(propsSchema)) {\n    return propsSchema;\n  }\n\n  throw new Error(`Invalid props schema for ${name}`);\n}\n\n/**\n * Checks if the propsSchema is a JSON Schema. This is a rough check, and the\n * server will provide the definitive check.\n * @param propsSchema - The props schema to check\n * @returns True if the props schema is a JSON Schema, false otherwise\n */\nfunction isJSONSchema(propsSchema: any) {\n  return (\n    propsSchema &&\n    typeof propsSchema === \"object\" &&\n    propsSchema.type === \"object\" &&\n    propsSchema.properties\n  );\n}\n\n/**\n * Since we require a certain zod version, we need to check if the object is a ZodSchema\n * @param obj - The object to check\n * @returns True if the object is a ZodSchema, false otherwise\n */\nfunction isZodSchema(obj: unknown): obj is ZodSchema {\n  if (obj instanceof ZodSchema) {\n    return true;\n  }\n  // try to detect if the object is a ZodSchema\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    typeof (obj as any).safeParse === \"function\" &&\n    typeof (obj as any)._def === \"object\"\n  );\n}\n"]}
+{"version":3,"file":"tambo-registry-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-registry-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport type TamboAI from \"@tambo-ai/typescript-sdk\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport type {\n  ComponentRegistry,\n  RegisterToolFn,\n  RegisterToolsFn,\n  TamboComponent,\n  TamboTool,\n  TamboToolRegistry,\n  TamboToolWithToolSchema,\n} from \"../model/component-metadata\";\nimport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\nimport type { ListResourceItem, ResourceSource } from \"../model/resource-info\";\nimport {\n  deduplicateMcpServers,\n  normalizeServerInfo,\n} from \"../util/mcp-server-utils\";\nimport {\n  validateAndPrepareComponent,\n  validateTool,\n  validateToolAssociation,\n} from \"../util/registry-validators\";\nimport {\n  validateResource,\n  validateResourceSource,\n} from \"../util/resource-validators\";\n\nexport interface TamboRegistryContext {\n  componentList: ComponentRegistry;\n  toolRegistry: TamboToolRegistry;\n  componentToolAssociations: Record<string, string[]>;\n  mcpServerInfos: NormalizedMcpServerInfo[];\n  resources: ListResourceItem[];\n  resourceSource: ResourceSource | null;\n  registerComponent: (options: TamboComponent) => void;\n  registerTool: RegisterToolFn;\n  registerTools: RegisterToolsFn;\n  addToolAssociation: (\n    componentName: string,\n    tool: TamboTool | TamboToolWithToolSchema,\n  ) => void;\n  registerMcpServer: (info: McpServerInfo) => void;\n  registerMcpServers: (infos: McpServerInfo[]) => void;\n  registerResource: (resource: ListResourceItem) => void;\n  registerResources: (resources: ListResourceItem[]) => void;\n  registerResourceSource: (source: ResourceSource) => void;\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>;\n}\n\nexport const TamboRegistryContext = createContext<TamboRegistryContext>({\n  componentList: {},\n  toolRegistry: {},\n  componentToolAssociations: {},\n  mcpServerInfos: [],\n  resources: [],\n  resourceSource: null,\n  /**\n   *\n   */\n  registerComponent: () => {},\n  /**\n   *\n   */\n  registerTool: () => {},\n  /**\n   *\n   */\n  registerTools: () => {},\n  /**\n   *\n   */\n  addToolAssociation: () => {},\n  /**\n   *\n   */\n  registerMcpServer: () => {},\n  /**\n   *\n   */\n  registerMcpServers: () => {},\n  /**\n   *\n   */\n  registerResource: () => {},\n  /**\n   *\n   */\n  registerResources: () => {},\n  /**\n   *\n   */\n  registerResourceSource: () => {},\n});\n\nexport interface TamboRegistryProviderProps {\n  /** The components to register */\n  components?: TamboComponent[];\n  /** The tools to register */\n  tools?: (TamboTool | TamboToolWithToolSchema)[];\n  /** The MCP servers to register */\n  mcpServers?: (McpServerInfo | string)[];\n  /** The static resources to register */\n  resources?: ListResourceItem[];\n\n  /**\n   * Dynamic resource search function. Must be paired with getResource.\n   * Called when useTamboMcpResourceList() is used to fetch resources.\n   */\n  listResources?: ResourceSource[\"listResources\"];\n\n  /**\n   * Dynamic resource fetch function. Must be paired with listResources.\n   * Called when useTamboMcpResource() is used to fetch a specific resource.\n   */\n  getResource?: ResourceSource[\"getResource\"];\n\n  /**\n   * A function to call when an unknown tool is called. If this function is not\n   * provided, an error will be thrown when a tool call is requested by the\n   * server.\n   *\n   * Note that this is generally only for agents, where the agent code may\n   * request tool calls that are not registered in the tool registry.\n   */\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>;\n}\n\n/**\n * The TamboRegistryProvider is a React provider that provides a component\n * registry to the descendants of the provider.\n * @param props - The props for the TamboRegistryProvider\n * @param props.children - The children to wrap\n * @param props.components - The components to register\n * @param props.tools - The tools to register\n * @param props.mcpServers - The MCP servers to register\n * @param props.resources - The static resources to register\n * @param props.listResources - The dynamic resource search function (must be paired with getResource)\n * @param props.getResource - The dynamic resource fetch function (must be paired with listResources)\n * @param props.onCallUnregisteredTool - The function to call when an unknown tool is called (optional)\n * @returns The TamboRegistryProvider component\n */\nexport const TamboRegistryProvider: React.FC<\n  PropsWithChildren<TamboRegistryProviderProps>\n> = ({\n  children,\n  components: userComponents,\n  tools: userTools,\n  mcpServers: userMcpServers,\n  resources: userResources,\n  listResources: userListResources,\n  getResource: userGetResource,\n  onCallUnregisteredTool,\n}) => {\n  const [componentList, setComponentList] = useState<ComponentRegistry>({});\n  const [toolRegistry, setToolRegistry] = useState<TamboToolRegistry>({});\n  const [componentToolAssociations, setComponentToolAssociations] = useState<\n    Record<string, string[]>\n  >({});\n  const [staticMcpServerInfos, setStaticMcpServerInfos] = useState<\n    NormalizedMcpServerInfo[]\n  >([]);\n  const [dynamicMcpServerInfos, setDynamicMcpServerInfos] = useState<\n    NormalizedMcpServerInfo[]\n  >([]);\n  const [staticResources, setStaticResources] = useState<ListResourceItem[]>(\n    [],\n  );\n  const [resourceSource, setResourceSource] = useState<ResourceSource | null>(\n    null,\n  );\n\n  const registerTool = useCallback(\n    (tool: TamboTool | TamboToolWithToolSchema, warnOnOverwrite = true) => {\n      validateTool(tool);\n\n      setToolRegistry((prev) => {\n        if (prev[tool.name] && warnOnOverwrite) {\n          console.warn(`Overwriting tool ${tool.name}`);\n        }\n        return {\n          ...prev,\n          [tool.name]: tool,\n        };\n      });\n    },\n    [],\n  );\n\n  const registerTools = useCallback(\n    (\n      tools: (TamboTool | TamboToolWithToolSchema)[],\n      warnOnOverwrite = true,\n    ) => {\n      tools.forEach((tool) => registerTool(tool, warnOnOverwrite));\n    },\n    [registerTool],\n  );\n\n  const registerMcpServer = useCallback((info: McpServerInfo | string) => {\n    const normalized = normalizeServerInfo(info);\n    setDynamicMcpServerInfos((prev) => [...prev, normalized]);\n  }, []);\n\n  const registerMcpServers = useCallback(\n    (infos: (McpServerInfo | string)[]) => {\n      const normalized = infos.map(normalizeServerInfo);\n      setDynamicMcpServerInfos((prev) => [...prev, ...normalized]);\n    },\n    [],\n  );\n\n  const addToolAssociation = useCallback(\n    (componentName: string, tool: TamboTool | TamboToolWithToolSchema) => {\n      validateToolAssociation(\n        componentName,\n        tool.name,\n        !!componentList[componentName],\n        !!toolRegistry[tool.name],\n      );\n\n      setComponentToolAssociations((prev) => ({\n        ...prev,\n        [componentName]: [...(prev[componentName] || []), tool.name],\n      }));\n    },\n    [componentList, toolRegistry],\n  );\n\n  const registerComponent = useCallback(\n    (options: TamboComponent, warnOnOverwrite = true) => {\n      const {\n        name,\n        description,\n        component,\n        loadingComponent,\n        associatedTools,\n      } = options;\n\n      const { props } = validateAndPrepareComponent(options);\n\n      setComponentList((prev) => {\n        if (prev[name] && warnOnOverwrite) {\n          console.warn(`overwriting component ${name}`);\n        }\n        return {\n          ...prev,\n          [name]: {\n            component,\n            loadingComponent,\n            name,\n            description,\n            props,\n            contextTools: [],\n          },\n        };\n      });\n      if (associatedTools) {\n        registerTools(associatedTools);\n        setComponentToolAssociations((prev) => ({\n          ...prev,\n          [name]: associatedTools.map((tool) => tool.name),\n        }));\n      }\n    },\n    [registerTools],\n  );\n  useEffect(() => {\n    if (userComponents) {\n      userComponents.forEach((component) => {\n        registerComponent(component, false);\n      });\n    }\n  }, [registerComponent, userComponents]);\n\n  useEffect(() => {\n    if (userTools) {\n      registerTools(userTools, false);\n    }\n  }, [registerTools, userTools]);\n\n  useEffect(() => {\n    if (!userMcpServers || userMcpServers.length === 0) {\n      setStaticMcpServerInfos([]);\n      return;\n    }\n\n    // Normalize servers from props and ensure all have serverKey and transport\n    const normalized = userMcpServers.map(normalizeServerInfo);\n    setStaticMcpServerInfos(normalized);\n  }, [userMcpServers]);\n\n  useEffect(() => {\n    // Validate that listResources and getResource are both provided or both omitted\n    validateResourceSource(userListResources, userGetResource);\n\n    // Set static resources from props\n    if (userResources) {\n      userResources.forEach((resource) => validateResource(resource));\n      setStaticResources(userResources);\n    } else {\n      setStaticResources([]);\n    }\n\n    // Set resource source from props\n    if (userListResources && userGetResource) {\n      setResourceSource({\n        listResources: userListResources,\n        getResource: userGetResource,\n      });\n    } else {\n      setResourceSource(null);\n    }\n  }, [userResources, userListResources, userGetResource]);\n\n  const registerResource = useCallback((resource: ListResourceItem) => {\n    validateResource(resource);\n    setStaticResources((prev) => [...prev, resource]);\n  }, []);\n\n  const registerResources = useCallback((resources: ListResourceItem[]) => {\n    resources.forEach((resource) => validateResource(resource));\n    setStaticResources((prev) => [...prev, ...resources]);\n  }, []);\n\n  const registerResourceSource = useCallback((source: ResourceSource) => {\n    validateResourceSource(source.listResources, source.getResource);\n    setResourceSource(source);\n  }, []);\n\n  const mcpServerInfos: NormalizedMcpServerInfo[] = useMemo(() => {\n    const allServers = [...staticMcpServerInfos, ...dynamicMcpServerInfos];\n    return deduplicateMcpServers(allServers);\n  }, [staticMcpServerInfos, dynamicMcpServerInfos]);\n\n  const value = {\n    componentList,\n    toolRegistry,\n    componentToolAssociations,\n    mcpServerInfos,\n    resources: staticResources,\n    resourceSource,\n    registerComponent,\n    registerTool,\n    registerTools,\n    addToolAssociation,\n    registerMcpServer,\n    registerMcpServers,\n    registerResource,\n    registerResources,\n    registerResourceSource,\n    onCallUnregisteredTool,\n  };\n\n  return (\n    <TamboRegistryContext.Provider value={value}>\n      {children}\n    </TamboRegistryContext.Provider>\n  );\n};\n\n/**\n * The useTamboRegistry hook provides access to the component registry\n * to the descendants of the TamboRegistryProvider.\n * @returns The component registry\n */\nexport const useTamboRegistry = () => {\n  return useContext(TamboRegistryContext);\n};\n\n/**\n * Hook to access the MCP server metadata from TamboRegistryProvider.\n * This provides access to the registered MCP server configurations (metadata only, not connections).\n *\n * This hook can be used anywhere within the TamboProvider hierarchy to access\n * the list of configured MCP servers without needing to be inside TamboMcpProvider.\n * @returns Array of MCP server metadata\n * @example\n * ```tsx\n * function MyComponent() {\n *   const mcpServers = useTamboMcpServerInfos();\n *\n *   return (\n *     <div>\n *       <h3>Configured MCP Servers:</h3>\n *       {mcpServers.map((server) => (\n *         <div key={server.url}>\n *           {server.name || server.url}\n *         </div>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n *\n * The returned objects are `NormalizedMcpServerInfo` instances, meaning both\n * `serverKey` and `transport` are always populated (with `transport`\n * defaulting to HTTP when not explicitly specified).\n */\nexport const useTamboMcpServerInfos = (): NormalizedMcpServerInfo[] => {\n  return useContext(TamboRegistryContext).mcpServerInfos;\n};\n"]}