@tambo-ai/react 1.1.0 → 1.2.1

package/esm/mcp/mcp-client.js

@@ -1,216 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { CreateMessageRequestSchema, ElicitRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { MCPTransport } from "../model/mcp-server-info.js";
-// Re-export for backwards compatibility
-export { MCPTransport };
-/**
- * A client for interacting with MCP (Model Context Protocol) servers.
- * Provides a simple interface for listing and calling tools exposed by the server.
- * @example
- * ```typescript
- * const mcp = await MCPClient.create('https://api.example.com/mcp');
- * const tools = await mcp.listTools();
- * const result = await mcp.callTool('toolName', { arg1: 'value1' });
- * ```
- */
-export class MCPClient {
-    /**
-     * The underlying MCP client
-     *
-     * Be careful not to mutate the client directly, use the methods provided instead.
-     */
-    client;
-    transport;
-    transportType;
-    sessionId;
-    endpoint;
-    headers;
-    authProvider;
-    handlers;
-    /**
-     * Private constructor to enforce using the static create method.
-     * @param endpoint - The URL of the MCP server to connect to
-     * @param transportType - The transport to use for the MCP client
-     * @param headers - Optional custom headers to include in requests
-     */
-    constructor(endpoint, transportType, headers, authProvider, sessionId, handlers = {}) {
-        this.endpoint = endpoint;
-        this.headers = headers ?? {};
-        this.authProvider = authProvider;
-        this.transportType = transportType;
-        this.handlers = handlers;
-        this.transport = this.initializeTransport(sessionId);
-        this.client = this.initializeClient();
-    }
-    /**
-     * Creates and initializes a new MCPClient instance. This is the recommended
-     * way to create an MCPClient as it handles both instantiation and connection
-     * setup.
-     * @param endpoint - The URL of the MCP server to connect to
-     * @param transportType - The transport type to use for the MCP client. Defaults to HTTP.
-     * @param headers - Optional custom headers to include in requests
-     * @param authProvider - Optional auth provider to use for authentication
-     * @param sessionId - Optional session id to use for the MCP client - if not
-     *   provided, a new session will be created
-     * @returns A connected MCPClient instance ready for use
-     * @throws {Error} Will throw an error if connection fails
-     */
-    static async create(endpoint, transportType = MCPTransport.HTTP, headers, authProvider, sessionId, handlers = {}) {
-        const mcpClient = new MCPClient(endpoint, transportType, headers, authProvider, sessionId, handlers);
-        await mcpClient.client.connect(mcpClient.transport);
-        if ("sessionId" in mcpClient.transport) {
-            mcpClient.sessionId = mcpClient.transport.sessionId;
-        }
-        return mcpClient;
-    }
-    initializeTransport(sessionId) {
-        if (this.transportType === MCPTransport.SSE) {
-            return new SSEClientTransport(new URL(this.endpoint), {
-                authProvider: this.authProvider,
-                requestInit: { headers: this.headers },
-            });
-        }
-        else {
-            return new StreamableHTTPClientTransport(new URL(this.endpoint), {
-                authProvider: this.authProvider,
-                requestInit: { headers: this.headers },
-                sessionId,
-            });
-        }
-    }
-    /**
-     * Initializes the MCP client with the appropriate capabilities and handlers
-     * @returns The initialized MCP client
-     */
-    initializeClient() {
-        const elicitationCapability = this.handlers.elicitation
-            ? { elicitation: {} }
-            : {};
-        const samplingCapability = this.handlers.sampling ? { sampling: {} } : {};
-        const client = new Client({
-            name: "tambo-mcp-client",
-            version: "1.0.0",
-        }, {
-            capabilities: {
-                ...elicitationCapability,
-                ...samplingCapability,
-            },
-        });
-        if (this.handlers.elicitation) {
-            client.setRequestHandler(ElicitRequestSchema, this.handlers.elicitation);
-        }
-        if (this.handlers.sampling) {
-            client.setRequestHandler(CreateMessageRequestSchema, this.handlers.sampling);
-        }
-        return client;
-    }
-    /**
-     * Retrieves a complete list of all available tools from the MCP server.
-     * Handles pagination automatically by following cursors until all tools are fetched.
-     * @returns A complete list of all available tools and their descriptions
-     * @throws {Error} Will throw an error if any server request fails during pagination
-     */
-    async listTools() {
-        const allTools = [];
-        let hasMore = true;
-        let cursor = undefined;
-        while (hasMore) {
-            const response = await this.client.listTools({ cursor }, {});
-            allTools.push(...response.tools.map((tool) => {
-                // make sure the right type is used
-                const inputSchemaType = tool.inputSchema.type;
-                if (inputSchemaType !== "object") {
-                    throw new Error(`Input schema for tool ${tool.name} is not an object`);
-                }
-                return {
-                    name: tool.name,
-                    description: tool.description,
-                    inputSchema: tool.inputSchema,
-                };
-            }));
-            if (response.nextCursor) {
-                cursor = response.nextCursor;
-            }
-            else {
-                hasMore = false;
-            }
-        }
-        return allTools;
-    }
-    getServerCapabilities() {
-        return this.client.getServerCapabilities();
-    }
-    getServerVersion() {
-        return this.client.getServerVersion();
-    }
-    getInstructions() {
-        return this.client.getInstructions();
-    }
-    /**
-     * Calls a specific tool on the MCP server with the provided arguments.
-     * @param name - The name of the tool to call
-     * @param args - Arguments to pass to the tool, must match the tool's expected schema
-     * @returns The result from the tool execution
-     * @throws {Error} Will throw an error if the tool call fails or if arguments are invalid
-     */
-    async callTool(name, args, _meta) {
-        const result = await this.client.callTool({
-            name,
-            arguments: args,
-            _meta,
-        });
-        return result;
-    }
-    updateElicitationHandler(handler) {
-        // Skip if handler hasn't changed
-        if (handler === this.handlers.elicitation) {
-            return;
-        }
-        // Because we advertise the elicitation capability on initial connection, we can only update
-        // an existing handler, not add it if we haven't set it yet.
-        if (handler && !this.handlers.elicitation) {
-            throw new Error("Elicitation handler must be set on create");
-        }
-        this.handlers = {
-            ...this.handlers,
-            elicitation: handler,
-        };
-        if (!handler) {
-            const method = ElicitRequestSchema.shape.method.value;
-            this.client.removeRequestHandler(method);
-            return;
-        }
-        this.client.setRequestHandler(ElicitRequestSchema, handler);
-    }
-    updateSamplingHandler(handler) {
-        // Skip if handler hasn't changed
-        if (handler === this.handlers.sampling) {
-            return;
-        }
-        // Because we advertise the sampling capability on initial connection, we can only update
-        // an existing handler, not add it if we haven't set it yet.
-        if (handler && !this.handlers.sampling) {
-            throw new Error("Sampling handler must be set on create");
-        }
-        this.handlers = {
-            ...this.handlers,
-            sampling: handler,
-        };
-        if (!handler) {
-            const method = CreateMessageRequestSchema.shape.method.value;
-            this.client.removeRequestHandler(method);
-            return;
-        }
-        this.client.setRequestHandler(CreateMessageRequestSchema, handler);
-    }
-    async close() {
-        // Not really sure which one of these to close first, but we'll close the
-        // transport first so that no requests can come in and hit closing/closed
-        // clients
-        await this.transport.close();
-        await this.client.close();
-    }
-}
-//# sourceMappingURL=mcp-client.js.map

package/esm/mcp/mcp-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { type OAuthClientProvider } from \"@modelcontextprotocol/sdk/client/auth.js\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport {\n  ClientNotification,\n  ClientRequest,\n  CreateMessageRequest,\n  CreateMessageRequestSchema,\n  CreateMessageResult,\n  ElicitRequest,\n  ElicitRequestSchema,\n  ElicitResult,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { JSONSchema7 } from \"json-schema\";\nimport { MCPTransport } from \"../model/mcp-server-info\";\n\n// Re-export for backwards compatibility\nexport { MCPTransport };\n\n/**\n * Handler for MCP elicitation requests.\n * Receives the elicit request and a RequestHandlerExtra containing an AbortSignal that fires when the request is cancelled.\n * @param request - The elicitation request from the server\n * @param extra - Additional context including AbortSignal for cancellation\n * @returns Promise resolving to the elicitation result\n * @example\n * ```typescript\n * const handler: MCPElicitationHandler = async (request, extra) => {\n *   // Listen for cancellation\n *   extra.signal.addEventListener('abort', () => {\n *     console.log('Request cancelled');\n *   });\n *\n *   // Return user's response\n *   return {\n *     action: 'accept',\n *     content: { name: 'John' }\n *   };\n * };\n * ```\n */\nexport type MCPElicitationHandler = (\n  e: ElicitRequest,\n  extra: RequestHandlerExtra<ClientRequest, ClientNotification>,\n) => Promise<ElicitResult>;\n\n/**\n * Handler for MCP sampling requests (create_message).\n * Receives the sampling request and a RequestHandlerExtra containing an AbortSignal that fires when the request is cancelled.\n * @param request - The sampling/create_message request from the server\n * @param extra - Additional context including AbortSignal for cancellation\n * @returns Promise resolving to the sampling result\n */\nexport type MCPSamplingHandler = (\n  e: CreateMessageRequest,\n  extra: RequestHandlerExtra<ClientRequest, ClientNotification>,\n) => Promise<CreateMessageResult>;\n\n/**\n * Handlers for MCP requests - these are only used if the server supports the corresponding capabilities\n * @param elicitation - Handler for elicitation requests (receives request and RequestHandlerExtra with AbortSignal)\n * @param sampling - Handler for sampling requests (receives request and RequestHandlerExtra with AbortSignal)\n * @example\n * ```typescript\n * const mcp = await MCPClient.create(\n *     'https://api.example.com/mcp',\n *     MCPTransport.HTTP,\n *     {},\n *     undefined,\n *     undefined,\n *     {\n *       elicitation: (e, extra) => Promise.resolve({...}),\n *     },\n * );\n * ```\n */\nexport interface MCPHandlers {\n  elicitation: MCPElicitationHandler;\n  sampling: MCPSamplingHandler;\n}\n\n/**\n * A client for interacting with MCP (Model Context Protocol) servers.\n * Provides a simple interface for listing and calling tools exposed by the server.\n * @example\n * ```typescript\n * const mcp = await MCPClient.create('https://api.example.com/mcp');\n * const tools = await mcp.listTools();\n * const result = await mcp.callTool('toolName', { arg1: 'value1' });\n * ```\n */\nexport class MCPClient {\n  /**\n   * The underlying MCP client\n   *\n   * Be careful not to mutate the client directly, use the methods provided instead.\n   */\n  client: Client;\n  private transport: SSEClientTransport | StreamableHTTPClientTransport;\n  private transportType: MCPTransport;\n  public sessionId?: string;\n  private endpoint: string;\n  private headers: Record<string, string>;\n  private authProvider?: OAuthClientProvider;\n  private handlers: Partial<MCPHandlers>;\n\n  /**\n   * Private constructor to enforce using the static create method.\n   * @param endpoint - The URL of the MCP server to connect to\n   * @param transportType - The transport to use for the MCP client\n   * @param headers - Optional custom headers to include in requests\n   */\n  private constructor(\n    endpoint: string,\n    transportType: MCPTransport,\n    headers?: Record<string, string>,\n    authProvider?: OAuthClientProvider,\n    sessionId?: string,\n    handlers: Partial<MCPHandlers> = {},\n  ) {\n    this.endpoint = endpoint;\n    this.headers = headers ?? {};\n    this.authProvider = authProvider;\n    this.transportType = transportType;\n    this.handlers = handlers;\n    this.transport = this.initializeTransport(sessionId);\n    this.client = this.initializeClient();\n  }\n\n  /**\n   * Creates and initializes a new MCPClient instance. This is the recommended\n   * way to create an MCPClient as it handles both instantiation and connection\n   * setup.\n   * @param endpoint - The URL of the MCP server to connect to\n   * @param transportType - The transport type to use for the MCP client. Defaults to HTTP.\n   * @param headers - Optional custom headers to include in requests\n   * @param authProvider - Optional auth provider to use for authentication\n   * @param sessionId - Optional session id to use for the MCP client - if not\n   *   provided, a new session will be created\n   * @returns A connected MCPClient instance ready for use\n   * @throws {Error} Will throw an error if connection fails\n   */\n  static async create(\n    endpoint: string,\n    transportType: MCPTransport = MCPTransport.HTTP,\n    headers: Record<string, string> | undefined,\n    authProvider: OAuthClientProvider | undefined,\n    sessionId: string | undefined,\n    handlers: Partial<MCPHandlers> = {},\n  ): Promise<MCPClient> {\n    const mcpClient = new MCPClient(\n      endpoint,\n      transportType,\n      headers,\n      authProvider,\n      sessionId,\n      handlers,\n    );\n    await mcpClient.client.connect(mcpClient.transport);\n    if (\"sessionId\" in mcpClient.transport) {\n      mcpClient.sessionId = mcpClient.transport.sessionId;\n    }\n    return mcpClient;\n  }\n\n  private initializeTransport(sessionId: string | undefined) {\n    if (this.transportType === MCPTransport.SSE) {\n      return new SSEClientTransport(new URL(this.endpoint), {\n        authProvider: this.authProvider,\n        requestInit: { headers: this.headers },\n      });\n    } else {\n      return new StreamableHTTPClientTransport(new URL(this.endpoint), {\n        authProvider: this.authProvider,\n        requestInit: { headers: this.headers },\n        sessionId,\n      });\n    }\n  }\n\n  /**\n   * Initializes the MCP client with the appropriate capabilities and handlers\n   * @returns The initialized MCP client\n   */\n  private initializeClient() {\n    const elicitationCapability = this.handlers.elicitation\n      ? { elicitation: {} }\n      : {};\n    const samplingCapability = this.handlers.sampling ? { sampling: {} } : {};\n    const client = new Client(\n      {\n        name: \"tambo-mcp-client\",\n        version: \"1.0.0\",\n      },\n      {\n        capabilities: {\n          ...elicitationCapability,\n          ...samplingCapability,\n        },\n      },\n    );\n\n    if (this.handlers.elicitation) {\n      client.setRequestHandler(ElicitRequestSchema, this.handlers.elicitation);\n    }\n    if (this.handlers.sampling) {\n      client.setRequestHandler(\n        CreateMessageRequestSchema,\n        this.handlers.sampling,\n      );\n    }\n    return client;\n  }\n\n  /**\n   * Retrieves a complete list of all available tools from the MCP server.\n   * Handles pagination automatically by following cursors until all tools are fetched.\n   * @returns A complete list of all available tools and their descriptions\n   * @throws {Error} Will throw an error if any server request fails during pagination\n   */\n  async listTools(): Promise<MCPToolSpec[]> {\n    const allTools: MCPToolSpec[] = [];\n    let hasMore = true;\n    let cursor: string | undefined = undefined;\n\n    while (hasMore) {\n      const response = await this.client.listTools({ cursor }, {});\n      allTools.push(\n        ...response.tools.map((tool): MCPToolSpec => {\n          // make sure the right type is used\n          const inputSchemaType: string = tool.inputSchema.type;\n          if (inputSchemaType !== \"object\") {\n            throw new Error(\n              `Input schema for tool ${tool.name} is not an object`,\n            );\n          }\n\n          return {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.inputSchema as JSONSchema7,\n          };\n        }),\n      );\n\n      if (response.nextCursor) {\n        cursor = response.nextCursor;\n      } else {\n        hasMore = false;\n      }\n    }\n\n    return allTools;\n  }\n\n  getServerCapabilities() {\n    return this.client.getServerCapabilities();\n  }\n\n  getServerVersion() {\n    return this.client.getServerVersion();\n  }\n\n  getInstructions() {\n    return this.client.getInstructions();\n  }\n\n  /**\n   * Calls a specific tool on the MCP server with the provided arguments.\n   * @param name - The name of the tool to call\n   * @param args - Arguments to pass to the tool, must match the tool's expected schema\n   * @returns The result from the tool execution\n   * @throws {Error} Will throw an error if the tool call fails or if arguments are invalid\n   */\n  async callTool(\n    name: string,\n    args: Record<string, unknown>,\n    _meta?: Record<string, unknown>,\n  ): Promise<MCPToolCallResult> {\n    const result = await this.client.callTool({\n      name,\n      arguments: args,\n      _meta,\n    });\n    return result;\n  }\n\n  updateElicitationHandler(handler: MCPElicitationHandler | undefined) {\n    // Skip if handler hasn't changed\n    if (handler === this.handlers.elicitation) {\n      return;\n    }\n\n    // Because we advertise the elicitation capability on initial connection, we can only update\n    // an existing handler, not add it if we haven't set it yet.\n    if (handler && !this.handlers.elicitation) {\n      throw new Error(\"Elicitation handler must be set on create\");\n    }\n    this.handlers = {\n      ...this.handlers,\n      elicitation: handler,\n    };\n    if (!handler) {\n      const method = ElicitRequestSchema.shape.method.value;\n      this.client.removeRequestHandler(method);\n      return;\n    }\n    this.client.setRequestHandler(ElicitRequestSchema, handler);\n  }\n\n  updateSamplingHandler(handler: MCPSamplingHandler | undefined) {\n    // Skip if handler hasn't changed\n    if (handler === this.handlers.sampling) {\n      return;\n    }\n\n    // Because we advertise the sampling capability on initial connection, we can only update\n    // an existing handler, not add it if we haven't set it yet.\n    if (handler && !this.handlers.sampling) {\n      throw new Error(\"Sampling handler must be set on create\");\n    }\n    this.handlers = {\n      ...this.handlers,\n      sampling: handler,\n    };\n    if (!handler) {\n      const method = CreateMessageRequestSchema.shape.method.value;\n      this.client.removeRequestHandler(method);\n      return;\n    }\n    this.client.setRequestHandler(CreateMessageRequestSchema, handler);\n  }\n\n  async close() {\n    // Not really sure which one of these to close first, but we'll close the\n    // transport first so that no requests can come in and hit closing/closed\n    // clients\n    await this.transport.close();\n    await this.client.close();\n  }\n}\n\n/**\n * The result of a tool call.\n * This is the same as the result of a tool call in the OpenAI SDK, but is reified here\n */\nexport type MCPToolCallResult = Awaited<\n  ReturnType<typeof Client.prototype.callTool>\n>;\n\n// Example usage:\n/*\nconst mcp = await MCPClient.create('https://api.example.com/mcp', MCPTransport.HTTP);\nconst tools = await mcp.listTools();\nconst result = await mcp.callTool('toolName', { arg1: 'value1' });\n*/\n\nexport interface MCPToolSpec {\n  name: string;\n  description?: string;\n  inputSchema?: JSONSchema7;\n  maxCalls?: number;\n}\n"]}

package/esm/mcp/mcp-constants.d.ts

@@ -1,19 +0,0 @@
-/**
- * Server type enum for distinguishing different kinds of MCP servers.
- * Used to determine how resources should be resolved.
- */
-export declare const ServerType: {
-    /** Client-side MCP server passed via mcpServers prop */
-    readonly BROWSER_SIDE: "browser-side";
-    /** Internal Tambo MCP server at /mcp endpoint (server-side MCP) */
-    readonly TAMBO_INTERNAL: "tambo-internal";
-    /** Virtual server representing browser-only registry resources */
-    readonly TAMBO_REGISTRY: "tambo-registry";
-};
-export type ServerType = (typeof ServerType)[keyof typeof ServerType];
-/**
- * Synthetic server key for local registry resources.
- * Used to give registry resources the same `@serverKey:uri` format as MCP resources.
- */
-export declare const REGISTRY_SERVER_KEY = "registry";
-//# sourceMappingURL=mcp-constants.d.ts.map

package/esm/mcp/mcp-constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-constants.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB,wDAAwD;;IAExD,mEAAmE;;IAEnE,kEAAkE;;CAE1D,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAC"}

package/esm/mcp/mcp-constants.js

@@ -1,18 +0,0 @@
-/**
- * Server type enum for distinguishing different kinds of MCP servers.
- * Used to determine how resources should be resolved.
- */
-export const ServerType = {
-    /** Client-side MCP server passed via mcpServers prop */
-    BROWSER_SIDE: "browser-side",
-    /** Internal Tambo MCP server at /mcp endpoint (server-side MCP) */
-    TAMBO_INTERNAL: "tambo-internal",
-    /** Virtual server representing browser-only registry resources */
-    TAMBO_REGISTRY: "tambo-registry",
-};
-/**
- * Synthetic server key for local registry resources.
- * Used to give registry resources the same `@serverKey:uri` format as MCP resources.
- */
-export const REGISTRY_SERVER_KEY = "registry";
-//# sourceMappingURL=mcp-constants.js.map

package/esm/mcp/mcp-constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-constants.js","sourceRoot":"","sources":["../../src/mcp/mcp-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,wDAAwD;IACxD,YAAY,EAAE,cAAc;IAC5B,mEAAmE;IACnE,cAAc,EAAE,gBAAgB;IAChC,kEAAkE;IAClE,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAIX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC","sourcesContent":["/**\n * Server type enum for distinguishing different kinds of MCP servers.\n * Used to determine how resources should be resolved.\n */\nexport const ServerType = {\n  /** Client-side MCP server passed via mcpServers prop */\n  BROWSER_SIDE: \"browser-side\",\n  /** Internal Tambo MCP server at /mcp endpoint (server-side MCP) */\n  TAMBO_INTERNAL: \"tambo-internal\",\n  /** Virtual server representing browser-only registry resources */\n  TAMBO_REGISTRY: \"tambo-registry\",\n} as const;\n\nexport type ServerType = (typeof ServerType)[keyof typeof ServerType];\n\n/**\n * Synthetic server key for local registry resources.\n * Used to give registry resources the same `@serverKey:uri` format as MCP resources.\n */\nexport const REGISTRY_SERVER_KEY = \"registry\";\n"]}

package/esm/model/mcp-server-info.d.ts

@@ -1,76 +0,0 @@
-/**
- * The transport protocol to use for MCP connections.
- */
-export declare enum MCPTransport {
-    SSE = "sse",
-    HTTP = "http"
-}
-/**
- * User-provided configuration for an MCP server.
- *
- * This is the type accepted by `TamboProvider` / `TamboRegistryProvider` in
- * the `mcpServers` prop.
- *
- * The `handlers` field is intentionally typed as `unknown` here so the core
- * SDK does not depend on the MCP subpackage. In the `@tambo-ai/react/mcp`
- * subpackage this is treated as `Partial<MCPHandlers>` (with
- * `elicitation` / `sampling` callbacks). The `@modelcontextprotocol/sdk` is
- * included automatically with `@tambo-ai/react`. See the React SDK README for
- * any additional optional peer dependencies needed for MCP features.
- */
-export interface McpServerInfo {
-    /** Optional name for the MCP server */
-    name?: string;
-    /** The URL of the MCP server to connect to */
-    url: string;
-    /** Optional description of the MCP server */
-    description?: string;
-    /** The transport type to use (SSE or HTTP). Defaults to HTTP for string URLs */
-    transport?: MCPTransport;
-    /** Optional custom headers to include in requests */
-    customHeaders?: Record<string, string>;
-    /**
-     * Optional short name for namespacing MCP resources, prompts, and tools.
-     * When multiple MCP servers are configured, this key is used to prefix:
-     * - prompts: `<serverKey>:<promptName>`
-     * - resources: `<serverKey>:<resourceUrl>`
-     * - tools: `<serverKey>__<toolName>`
-     *
-     * If not provided, a key will be derived from the URL hostname.
-     * For example, "https://mcp.linear.app/mcp" becomes "linear".
-     */
-    serverKey?: string;
-    /**
-     * Optional handlers for elicitation and sampling requests from the server.
-     *
-     * In the MCP subpackage this is interpreted as `Partial<MCPHandlers>`,
-     * i.e. `{ elicitation?: MCPElicitationHandler; sampling?: MCPSamplingHandler }`.
-     *
-     * Note: These callbacks should be stable (e.g., wrapped in useCallback or
-     * defined outside the component) to avoid constant re-registration of the
-     * MCP server on every render.
-     */
-    handlers?: unknown;
-}
-/**
- * Normalized MCP server metadata used internally by the registry and MCP
- * provider.
- *
- * This is equivalent to `McpServerInfo` except that:
- * - `serverKey` is guaranteed to be present
- * - `transport` is resolved to a concrete value (defaults to HTTP)
- */
-export interface NormalizedMcpServerInfo extends McpServerInfo {
-    transport: MCPTransport;
-    serverKey: string;
-}
-/**
- * Creates a stable identifier for an MCP server based on its connection properties.
- * Two servers with the same URL, transport, and headers will have the same key.
- *
- * This is used by both the registry and MCP provider to deduplicate servers,
- * so it lives alongside the shared server metadata type.
- * @returns A stable string key identifying the server
- */
-export declare function getMcpServerUniqueKey(serverInfo: Pick<McpServerInfo, "url" | "transport" | "customHeaders">): string;
-//# sourceMappingURL=mcp-server-info.d.ts.map

package/esm/model/mcp-server-info.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server-info.d.ts","sourceRoot":"","sources":["../../src/model/mcp-server-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,SAAS,EAAE,YAAY,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,WAAW,GAAG,eAAe,CAAC,GACrE,MAAM,CAUR"}

package/esm/model/mcp-server-info.js

@@ -1,25 +0,0 @@
-/**
- * The transport protocol to use for MCP connections.
- */
-export var MCPTransport;
-(function (MCPTransport) {
-    MCPTransport["SSE"] = "sse";
-    MCPTransport["HTTP"] = "http";
-})(MCPTransport || (MCPTransport = {}));
-/**
- * Creates a stable identifier for an MCP server based on its connection properties.
- * Two servers with the same URL, transport, and headers will have the same key.
- *
- * This is used by both the registry and MCP provider to deduplicate servers,
- * so it lives alongside the shared server metadata type.
- * @returns A stable string key identifying the server
- */
-export function getMcpServerUniqueKey(serverInfo) {
-    const headerStr = serverInfo.customHeaders
-        ? JSON.stringify(Object.entries(serverInfo.customHeaders)
-            .map(([k, v]) => [k.toLowerCase(), v])
-            .sort(([a], [b]) => a.localeCompare(b)))
-        : "";
-    return `${serverInfo.url}|${serverInfo.transport ?? MCPTransport.HTTP}|${headerStr}`;
-}
-//# sourceMappingURL=mcp-server-info.js.map

package/esm/model/mcp-server-info.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server-info.js","sourceRoot":"","sources":["../../src/model/mcp-server-info.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AA+DD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAsE;IAEtE,MAAM,SAAS,GAAG,UAAU,CAAC,aAAa;QACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAU,CAAC;aAC9C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC1C;QACH,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,GAAG,UAAU,CAAC,GAAG,IAAI,UAAU,CAAC,SAAS,IAAI,YAAY,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;AACvF,CAAC","sourcesContent":["/**\n * The transport protocol to use for MCP connections.\n */\nexport enum MCPTransport {\n  SSE = \"sse\",\n  HTTP = \"http\",\n}\n\n/**\n * User-provided configuration for an MCP server.\n *\n * This is the type accepted by `TamboProvider` / `TamboRegistryProvider` in\n * the `mcpServers` prop.\n *\n * The `handlers` field is intentionally typed as `unknown` here so the core\n * SDK does not depend on the MCP subpackage. In the `@tambo-ai/react/mcp`\n * subpackage this is treated as `Partial<MCPHandlers>` (with\n * `elicitation` / `sampling` callbacks). The `@modelcontextprotocol/sdk` is\n * included automatically with `@tambo-ai/react`. See the React SDK README for\n * any additional optional peer dependencies needed for MCP features.\n */\nexport interface McpServerInfo {\n  /** Optional name for the MCP server */\n  name?: string;\n  /** The URL of the MCP server to connect to */\n  url: string;\n  /** Optional description of the MCP server */\n  description?: string;\n  /** The transport type to use (SSE or HTTP). Defaults to HTTP for string URLs */\n  transport?: MCPTransport;\n  /** Optional custom headers to include in requests */\n  customHeaders?: Record<string, string>;\n  /**\n   * Optional short name for namespacing MCP resources, prompts, and tools.\n   * When multiple MCP servers are configured, this key is used to prefix:\n   * - prompts: `<serverKey>:<promptName>`\n   * - resources: `<serverKey>:<resourceUrl>`\n   * - tools: `<serverKey>__<toolName>`\n   *\n   * If not provided, a key will be derived from the URL hostname.\n   * For example, \"https://mcp.linear.app/mcp\" becomes \"linear\".\n   */\n  serverKey?: string;\n  /**\n   * Optional handlers for elicitation and sampling requests from the server.\n   *\n   * In the MCP subpackage this is interpreted as `Partial<MCPHandlers>`,\n   * i.e. `{ elicitation?: MCPElicitationHandler; sampling?: MCPSamplingHandler }`.\n   *\n   * Note: These callbacks should be stable (e.g., wrapped in useCallback or\n   * defined outside the component) to avoid constant re-registration of the\n   * MCP server on every render.\n   */\n  handlers?: unknown;\n}\n\n/**\n * Normalized MCP server metadata used internally by the registry and MCP\n * provider.\n *\n * This is equivalent to `McpServerInfo` except that:\n * - `serverKey` is guaranteed to be present\n * - `transport` is resolved to a concrete value (defaults to HTTP)\n */\nexport interface NormalizedMcpServerInfo extends McpServerInfo {\n  transport: MCPTransport;\n  serverKey: string;\n}\n\n/**\n * Creates a stable identifier for an MCP server based on its connection properties.\n * Two servers with the same URL, transport, and headers will have the same key.\n *\n * This is used by both the registry and MCP provider to deduplicate servers,\n * so it lives alongside the shared server metadata type.\n * @returns A stable string key identifying the server\n */\nexport function getMcpServerUniqueKey(\n  serverInfo: Pick<McpServerInfo, \"url\" | \"transport\" | \"customHeaders\">,\n): string {\n  const headerStr = serverInfo.customHeaders\n    ? JSON.stringify(\n        Object.entries(serverInfo.customHeaders)\n          .map(([k, v]) => [k.toLowerCase(), v] as const)\n          .sort(([a], [b]) => a.localeCompare(b)),\n      )\n    : \"\";\n\n  return `${serverInfo.url}|${serverInfo.transport ?? MCPTransport.HTTP}|${headerStr}`;\n}\n"]}

package/esm/schema/schema.d.ts

@@ -1,49 +0,0 @@
-/**
- * Schema utilities for working with Standard Schema and JSON Schema.
- *
- * This module provides a unified interface for handling different schema types
- * used in Tambo components and tools. It uses Standard Schema (https://standardschema.dev/)
- * as the primary interface, which is implemented by Zod 3.24+ and other validation libraries.
- *
- * JSON Schema conversion is handled by `@standard-community/standard-json`.
- * @module schema
- */
-import type { JSONSchema7 } from "json-schema";
-import { ParameterSpec, SupportedSchema, TamboTool } from "../model/component-metadata.js";
-/**
- * Converts a schema (Standard Schema or JSON Schema) to a JSON Schema object.
- *
- * If the schema is already a JSON Schema, it is returned as-is.
- * For Standard Schema validators (Zod 3.24+, etc.), uses
- * `@standard-community/standard-json` for conversion.
- * @param schema - The schema to convert
- * @returns The JSON Schema representation
- * @example
- * ```typescript
- * import { z } from "zod/v4";
- *
- * // Convert a Zod schema
- * const zodSchema = z.object({ name: z.string() });
- * const jsonSchema = schemaToJsonSchema(zodSchema);
- *
- * // Pass through a JSON Schema
- * const existingJsonSchema = { type: "object", properties: { name: { type: "string" } } };
- * schemaToJsonSchema(existingJsonSchema); // returns the same object
- * ```
- */
-export declare function schemaToJsonSchema(schema: SupportedSchema): JSONSchema7;
-/**
- * Safely converts a schema to JSON Schema, returning undefined for invalid inputs.
- * @param schema - The schema to convert (may be undefined)
- * @param onError - Optional callback invoked on conversion error
- * @returns The JSON Schema representation, or undefined if conversion fails
- */
-export declare function safeSchemaToJsonSchema(schema: SupportedSchema | undefined | null, onError?: (error: unknown) => void): JSONSchema7 | undefined;
-/**
- * Extracts parameter specifications from a tool's inputSchema.
- * @param tool - The tool containing the schema
- * @returns An array of parameter specifications
- */
-export declare function getParametersFromToolSchema(tool: TamboTool): ParameterSpec[];
-export type { SupportedSchema };
-//# sourceMappingURL=schema.d.ts.map

package/esm/schema/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,aAAa,EACb,eAAe,EACf,SAAS,EACV,MAAM,6BAA6B,CAAC;AAuBrC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAOvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,EAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,WAAW,GAAG,SAAS,CAYzB;AAoCD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,EAAE,CAe5E;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/esm/schema/schema.js

@@ -1,124 +0,0 @@
-/**
- * Schema utilities for working with Standard Schema and JSON Schema.
- *
- * This module provides a unified interface for handling different schema types
- * used in Tambo components and tools. It uses Standard Schema (https://standardschema.dev/)
- * as the primary interface, which is implemented by Zod 3.24+ and other validation libraries.
- *
- * JSON Schema conversion is handled by `@standard-community/standard-json`.
- * @module schema
- */
-import { loadVendor, toJsonSchema } from "@standard-community/standard-json";
-import { zodToJsonSchema } from "zod-to-json-schema";
-import { toJSONSchema as zod4ToJSONSchema } from "zod/v4/core";
-import { looksLikeJSONSchema } from "./json-schema.js";
-import { isStandardSchema } from "./standard-schema.js";
-/**
- * Register the zod vendor handler for synchronous JSON Schema conversion.
- * This uses Zod 4's native toJSONSchema for Zod 4.x schemas and zod-to-json-schema for Zod 3.x.
- */
-loadVendor("zod", (schema) => {
-    // Check if this is a Zod 4 schema (has _zod property)
-    if (schema && typeof schema === "object" && "_zod" in schema) {
-        // Use Zod 4's native toJSONSchema from zod/v4/core
-        // Cast through unknown since the Zod 4 internal types don't match our detection pattern
-        return zod4ToJSONSchema(schema);
-    }
-    // Fall back to zod-to-json-schema for Zod 3.x
-    return zodToJsonSchema(schema);
-});
-/**
- * Converts a schema (Standard Schema or JSON Schema) to a JSON Schema object.
- *
- * If the schema is already a JSON Schema, it is returned as-is.
- * For Standard Schema validators (Zod 3.24+, etc.), uses
- * `@standard-community/standard-json` for conversion.
- * @param schema - The schema to convert
- * @returns The JSON Schema representation
- * @example
- * ```typescript
- * import { z } from "zod/v4";
- *
- * // Convert a Zod schema
- * const zodSchema = z.object({ name: z.string() });
- * const jsonSchema = schemaToJsonSchema(zodSchema);
- *
- * // Pass through a JSON Schema
- * const existingJsonSchema = { type: "object", properties: { name: { type: "string" } } };
- * schemaToJsonSchema(existingJsonSchema); // returns the same object
- * ```
- */
-export function schemaToJsonSchema(schema) {
-    // Already a JSON Schema - return as-is
-    if (!isStandardSchema(schema)) {
-        return schema;
-    }
-    return toJsonSchema.sync(schema);
-}
-/**
- * Safely converts a schema to JSON Schema, returning undefined for invalid inputs.
- * @param schema - The schema to convert (may be undefined)
- * @param onError - Optional callback invoked on conversion error
- * @returns The JSON Schema representation, or undefined if conversion fails
- */
-export function safeSchemaToJsonSchema(schema, onError) {
-    if (!schema) {
-        return undefined;
-    }
-    try {
-        return schemaToJsonSchema(schema);
-    }
-    catch (error) {
-        console.error("Error converting schema to JSON Schema:", error);
-        onError?.(error);
-        return undefined;
-    }
-}
-/**
- * Creates parameter specs from an input schema.
- * The schema represents the shape of the single object argument to the tool function.
- * @param schema - The input schema (JSON Schema)
- * @returns An array of parameter specifications
- */
-function createParametersFromSchema(schema) {
-    const properties = schema.properties ?? {};
-    return Object.entries(properties).map(([key, propSchema]) => ({
-        name: key,
-        type: propSchema && typeof propSchema === "object" && "type" in propSchema
-            ? propSchema.type
-            : "object",
-        description: propSchema &&
-            typeof propSchema === "object" &&
-            "description" in propSchema
-            ? (propSchema.description ?? "")
-            : "",
-        isRequired: Array.isArray(schema.required)
-            ? schema.required.includes(key)
-            : false,
-        schema: typeof propSchema === "object" && propSchema !== null
-            ? propSchema
-            : {},
-    }));
-}
-/**
- * Extracts parameter specifications from a tool's inputSchema.
- * @param tool - The tool containing the schema
- * @returns An array of parameter specifications
- */
-export function getParametersFromToolSchema(tool) {
-    const schema = tool.inputSchema;
-    // Convert to JSON Schema if needed
-    let jsonSchema;
-    if (looksLikeJSONSchema(schema)) {
-        jsonSchema = schema;
-    }
-    else if (isStandardSchema(schema)) {
-        jsonSchema = schemaToJsonSchema(schema);
-    }
-    else {
-        console.warn("Unknown inputSchema type, returning empty parameters");
-        return [];
-    }
-    return createParametersFromSchema(jsonSchema);
-}
-//# sourceMappingURL=schema.js.map

package/esm/schema/schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema/schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Schema utilities for working with Standard Schema and JSON Schema.\n *\n * This module provides a unified interface for handling different schema types\n * used in Tambo components and tools. It uses Standard Schema (https://standardschema.dev/)\n * as the primary interface, which is implemented by Zod 3.24+ and other validation libraries.\n *\n * JSON Schema conversion is handled by `@standard-community/standard-json`.\n * @module schema\n */\n\nimport { loadVendor, toJsonSchema } from \"@standard-community/standard-json\";\nimport type { JSONSchema7 } from \"json-schema\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { toJSONSchema as zod4ToJSONSchema } from \"zod/v4/core\";\nimport {\n  ParameterSpec,\n  SupportedSchema,\n  TamboTool,\n} from \"../model/component-metadata\";\nimport { looksLikeJSONSchema } from \"./json-schema\";\nimport { isStandardSchema } from \"./standard-schema\";\n\n/**\n * Register the zod vendor handler for synchronous JSON Schema conversion.\n * This uses Zod 4's native toJSONSchema for Zod 4.x schemas and zod-to-json-schema for Zod 3.x.\n */\nloadVendor(\"zod\", (schema: unknown): JSONSchema7 => {\n  // Check if this is a Zod 4 schema (has _zod property)\n  if (schema && typeof schema === \"object\" && \"_zod\" in schema) {\n    // Use Zod 4's native toJSONSchema from zod/v4/core\n    // Cast through unknown since the Zod 4 internal types don't match our detection pattern\n    return zod4ToJSONSchema(\n      schema as unknown as Parameters<typeof zod4ToJSONSchema>[0],\n    ) as JSONSchema7;\n  }\n  // Fall back to zod-to-json-schema for Zod 3.x\n  return zodToJsonSchema(\n    schema as Parameters<typeof zodToJsonSchema>[0],\n  ) as JSONSchema7;\n});\n\n/**\n * Converts a schema (Standard Schema or JSON Schema) to a JSON Schema object.\n *\n * If the schema is already a JSON Schema, it is returned as-is.\n * For Standard Schema validators (Zod 3.24+, etc.), uses\n * `@standard-community/standard-json` for conversion.\n * @param schema - The schema to convert\n * @returns The JSON Schema representation\n * @example\n * ```typescript\n * import { z } from \"zod/v4\";\n *\n * // Convert a Zod schema\n * const zodSchema = z.object({ name: z.string() });\n * const jsonSchema = schemaToJsonSchema(zodSchema);\n *\n * // Pass through a JSON Schema\n * const existingJsonSchema = { type: \"object\", properties: { name: { type: \"string\" } } };\n * schemaToJsonSchema(existingJsonSchema); // returns the same object\n * ```\n */\nexport function schemaToJsonSchema(schema: SupportedSchema): JSONSchema7 {\n  // Already a JSON Schema - return as-is\n  if (!isStandardSchema(schema)) {\n    return schema;\n  }\n\n  return toJsonSchema.sync(schema) as JSONSchema7;\n}\n\n/**\n * Safely converts a schema to JSON Schema, returning undefined for invalid inputs.\n * @param schema - The schema to convert (may be undefined)\n * @param onError - Optional callback invoked on conversion error\n * @returns The JSON Schema representation, or undefined if conversion fails\n */\nexport function safeSchemaToJsonSchema(\n  schema: SupportedSchema | undefined | null,\n  onError?: (error: unknown) => void,\n): JSONSchema7 | undefined {\n  if (!schema) {\n    return undefined;\n  }\n\n  try {\n    return schemaToJsonSchema(schema);\n  } catch (error) {\n    console.error(\"Error converting schema to JSON Schema:\", error);\n    onError?.(error);\n    return undefined;\n  }\n}\n\n/**\n * Creates parameter specs from an input schema.\n * The schema represents the shape of the single object argument to the tool function.\n * @param schema - The input schema (JSON Schema)\n * @returns An array of parameter specifications\n */\nfunction createParametersFromSchema(schema: JSONSchema7): ParameterSpec[] {\n  const properties = schema.properties ?? {};\n\n  return Object.entries(properties).map(\n    ([key, propSchema]) =>\n      ({\n        name: key,\n        type:\n          propSchema && typeof propSchema === \"object\" && \"type\" in propSchema\n            ? (propSchema.type as string)\n            : \"object\",\n        description:\n          propSchema &&\n          typeof propSchema === \"object\" &&\n          \"description\" in propSchema\n            ? (propSchema.description ?? \"\")\n            : \"\",\n        isRequired: Array.isArray(schema.required)\n          ? schema.required.includes(key)\n          : false,\n        schema:\n          typeof propSchema === \"object\" && propSchema !== null\n            ? propSchema\n            : {},\n      }) satisfies ParameterSpec,\n  );\n}\n\n/**\n * Extracts parameter specifications from a tool's inputSchema.\n * @param tool - The tool containing the schema\n * @returns An array of parameter specifications\n */\nexport function getParametersFromToolSchema(tool: TamboTool): ParameterSpec[] {\n  const schema = tool.inputSchema;\n\n  // Convert to JSON Schema if needed\n  let jsonSchema: JSONSchema7;\n  if (looksLikeJSONSchema(schema)) {\n    jsonSchema = schema;\n  } else if (isStandardSchema(schema)) {\n    jsonSchema = schemaToJsonSchema(schema);\n  } else {\n    console.warn(\"Unknown inputSchema type, returning empty parameters\");\n    return [];\n  }\n\n  return createParametersFromSchema(jsonSchema);\n}\n\nexport type { SupportedSchema };\n"]}

package/esm/schema/standard-schema.d.ts

@@ -1,22 +0,0 @@
-import { StandardSchemaV1 } from "@standard-schema/spec";
-/**
- * Type guard to check if an object implements the Standard Schema interface.
- *
- * Standard Schema compliant validators have a `~standard` property containing
- * metadata about the schema including version, vendor, and validate function.
- * Uses duck typing to avoid cross-version Zod compatibility issues.
- * @param obj - The object to check
- * @returns True if the object implements StandardSchemaV1
- * @example
- * ```typescript
- * import { z } from "zod/v4";
- *
- * const zodSchema = z.object({ name: z.string() });
- * isStandardSchema(zodSchema); // true
- *
- * const jsonSchema = { type: "object", properties: { name: { type: "string" } } };
- * isStandardSchema(jsonSchema); // false
- * ```
- */
-export declare function isStandardSchema(obj: unknown): obj is StandardSchemaV1;
-//# sourceMappingURL=standard-schema.d.ts.map

package/esm/schema/standard-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../src/schema/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAuBtE"}