@tambo-ai/react 1.1.0 → 1.2.1

package/esm/mcp/use-mcp-servers.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-mcp-servers.test.js","sourceRoot":"","sources":["../../src/mcp/use-mcp-servers.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React, { useEffect } from \"react\";\nimport { TamboMcpTokenProvider } from \"../providers/tambo-mcp-token-provider\";\nimport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\nimport { TamboClientContext } from \"../providers/tambo-client-provider\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport {\n  TamboMcpProvider,\n  useTamboMcpServers,\n  type McpServer,\n} from \"./tambo-mcp-provider\";\n\n// Mock the registry to provide a no-op registerTool\n// Do not mock the registry; use the real provider in render\n\n// Provide a minimal client context instead of mocking the hook\n\n// Mock the MCP client; use a mutable implementation to avoid TDZ issues\nlet createImpl: jest.Mock = jest.fn();\njest.mock(\"./mcp-client\", () => ({\n  MCPClient: { create: (...args: any[]) => createImpl(...args) },\n  MCPTransport: { SSE: \"sse\", HTTP: \"http\" },\n}));\n\n// Import after mocks note: jest.mock calls are hoisted, so standard imports are fine\n\ndescribe(\"useTamboMcpServers + TamboMcpProvider\", () => {\n  beforeEach(() => {\n    createImpl = jest.fn();\n  });\n\n  it(\"provides normalized MCP server entries to inner components\", async () => {\n    const fakeClient = { listTools: jest.fn().mockResolvedValue([]) } as any;\n    createImpl.mockResolvedValue(fakeClient);\n\n    const Inner: React.FC = () => {\n      const servers = useTamboMcpServers();\n      return (\n        <div>\n          <div data-testid=\"count\">{servers.length}</div>\n          <div data-testid=\"urls\">{servers.map((s) => s.url).join(\",\")}</div>\n        </div>\n      );\n    };\n\n    const { getByTestId } = render(\n      <TamboClientContext.Provider\n        value={{\n          client: { baseURL: \"https://api.tambo.co\" } as any,\n          queryClient: new QueryClient(),\n          isUpdatingToken: false,\n          tokenExchangeError: null,\n          userToken: undefined,\n          hasValidToken: false,\n        }}\n      >\n        <TamboRegistryProvider\n          mcpServers={[{ url: \"https://one.example\" }, \"https://two.example\"]}\n        >\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <Inner />\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboRegistryProvider>\n      </TamboClientContext.Provider>,\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"count\").textContent).toBe(\"2\");\n      const urls = getByTestId(\"urls\").textContent || \"\";\n      expect(urls).toContain(\"https://one.example\");\n      expect(urls).toContain(\"https://two.example\");\n    });\n  });\n\n  it(\"marks a successfully connected server with a client instance\", async () => {\n    const fakeClient = { listTools: jest.fn().mockResolvedValue([]) } as any;\n    createImpl.mockResolvedValue(fakeClient);\n\n    let latest: McpServer[] = [];\n    const Capture: React.FC = () => {\n      const servers = useTamboMcpServers();\n      useEffect(() => {\n        latest = servers;\n      }, [servers]);\n      return null;\n    };\n\n    render(\n      <TamboClientContext.Provider\n        value={{\n          client: { baseURL: \"https://api.tambo.co\" } as any,\n          queryClient: new QueryClient(),\n          isUpdatingToken: false,\n          tokenExchangeError: null,\n          userToken: undefined,\n          hasValidToken: false,\n        }}\n      >\n        <TamboRegistryProvider mcpServers={[{ url: \"https://ok.example\" }]}>\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <Capture />\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboRegistryProvider>\n      </TamboClientContext.Provider>,\n    );\n\n    await waitFor(() => {\n      expect(latest.length).toBe(1);\n      expect(\"client\" in latest[0]).toBe(true);\n      expect((latest[0] as any).client).toBe(fakeClient);\n      // no connectionError on connected server\n      expect((latest[0] as any).connectionError).toBeUndefined();\n    });\n  });\n\n  it(\"marks a failed server with a connectionError and no client\", async () => {\n    const boom = new Error(\"boom\");\n    createImpl.mockRejectedValue(boom);\n\n    let latest: McpServer[] = [];\n    const Capture: React.FC = () => {\n      const servers = useTamboMcpServers();\n      useEffect(() => {\n        latest = servers;\n      }, [servers]);\n      return null;\n    };\n\n    render(\n      <TamboClientContext.Provider\n        value={{\n          client: { baseURL: \"https://api.tambo.co\" } as any,\n          queryClient: new QueryClient(),\n          isUpdatingToken: false,\n          tokenExchangeError: null,\n          userToken: undefined,\n          hasValidToken: false,\n        }}\n      >\n        <TamboRegistryProvider mcpServers={[{ url: \"https://fail.example\" }]}>\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <Capture />\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboRegistryProvider>\n      </TamboClientContext.Provider>,\n    );\n\n    await waitFor(() => {\n      expect(latest.length).toBe(1);\n      expect(\"client\" in latest[0]).toBe(false);\n      // @ts-expect-error narrowing at runtime\n      expect(latest[0].connectionError).toBeInstanceOf(Error);\n      // @ts-expect-error narrowing at runtime\n      expect(latest[0].connectionError?.message).toBe(\"boom\");\n    });\n  });\n});\n"]}
+{"version":3,"file":"use-mcp-servers.test.js","sourceRoot":"","sources":["../../src/mcp/use-mcp-servers.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React, { useEffect } from \"react\";\nimport { TamboMcpTokenProvider } from \"../providers/tambo-mcp-token-provider\";\nimport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\nimport { TamboClientContext } from \"../providers/tambo-client-provider\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport {\n  TamboMcpProvider,\n  useTamboMcpServers,\n  type McpServer,\n} from \"./tambo-mcp-provider\";\n\n// Mock the registry to provide a no-op registerTool\n// Do not mock the registry; use the real provider in render\n\n// Provide a minimal client context instead of mocking the hook\n\n// Mock the MCP client; use a mutable implementation to avoid TDZ issues\nlet createImpl: jest.Mock = jest.fn();\njest.mock(\"@tambo-ai/client\", () => ({\n  ...jest.requireActual(\"@tambo-ai/client\"),\n  MCPClient: { create: (...args: any[]) => createImpl(...args) },\n  MCPTransport: { SSE: \"sse\", HTTP: \"http\" },\n}));\n\n// Import after mocks note: jest.mock calls are hoisted, so standard imports are fine\n\ndescribe(\"useTamboMcpServers + TamboMcpProvider\", () => {\n  beforeEach(() => {\n    createImpl = jest.fn();\n  });\n\n  it(\"provides normalized MCP server entries to inner components\", async () => {\n    const fakeClient = { listTools: jest.fn().mockResolvedValue([]) } as any;\n    createImpl.mockResolvedValue(fakeClient);\n\n    const Inner: React.FC = () => {\n      const servers = useTamboMcpServers();\n      return (\n        <div>\n          <div data-testid=\"count\">{servers.length}</div>\n          <div data-testid=\"urls\">{servers.map((s) => s.url).join(\",\")}</div>\n        </div>\n      );\n    };\n\n    const { getByTestId } = render(\n      <TamboClientContext.Provider\n        value={{\n          client: { baseURL: \"https://api.tambo.co\" } as any,\n          queryClient: new QueryClient(),\n          isUpdatingToken: false,\n          tokenExchangeError: null,\n          userToken: undefined,\n          hasValidToken: false,\n        }}\n      >\n        <TamboRegistryProvider\n          mcpServers={[{ url: \"https://one.example\" }, \"https://two.example\"]}\n        >\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <Inner />\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboRegistryProvider>\n      </TamboClientContext.Provider>,\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"count\").textContent).toBe(\"2\");\n      const urls = getByTestId(\"urls\").textContent || \"\";\n      expect(urls).toContain(\"https://one.example\");\n      expect(urls).toContain(\"https://two.example\");\n    });\n  });\n\n  it(\"marks a successfully connected server with a client instance\", async () => {\n    const fakeClient = { listTools: jest.fn().mockResolvedValue([]) } as any;\n    createImpl.mockResolvedValue(fakeClient);\n\n    let latest: McpServer[] = [];\n    const Capture: React.FC = () => {\n      const servers = useTamboMcpServers();\n      useEffect(() => {\n        latest = servers;\n      }, [servers]);\n      return null;\n    };\n\n    render(\n      <TamboClientContext.Provider\n        value={{\n          client: { baseURL: \"https://api.tambo.co\" } as any,\n          queryClient: new QueryClient(),\n          isUpdatingToken: false,\n          tokenExchangeError: null,\n          userToken: undefined,\n          hasValidToken: false,\n        }}\n      >\n        <TamboRegistryProvider mcpServers={[{ url: \"https://ok.example\" }]}>\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <Capture />\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboRegistryProvider>\n      </TamboClientContext.Provider>,\n    );\n\n    await waitFor(() => {\n      expect(latest.length).toBe(1);\n      expect(\"client\" in latest[0]).toBe(true);\n      expect((latest[0] as any).client).toBe(fakeClient);\n      // no connectionError on connected server\n      expect((latest[0] as any).connectionError).toBeUndefined();\n    });\n  });\n\n  it(\"marks a failed server with a connectionError and no client\", async () => {\n    const boom = new Error(\"boom\");\n    createImpl.mockRejectedValue(boom);\n\n    let latest: McpServer[] = [];\n    const Capture: React.FC = () => {\n      const servers = useTamboMcpServers();\n      useEffect(() => {\n        latest = servers;\n      }, [servers]);\n      return null;\n    };\n\n    render(\n      <TamboClientContext.Provider\n        value={{\n          client: { baseURL: \"https://api.tambo.co\" } as any,\n          queryClient: new QueryClient(),\n          isUpdatingToken: false,\n          tokenExchangeError: null,\n          userToken: undefined,\n          hasValidToken: false,\n        }}\n      >\n        <TamboRegistryProvider mcpServers={[{ url: \"https://fail.example\" }]}>\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <Capture />\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboRegistryProvider>\n      </TamboClientContext.Provider>,\n    );\n\n    await waitFor(() => {\n      expect(latest.length).toBe(1);\n      expect(\"client\" in latest[0]).toBe(false);\n      // @ts-expect-error narrowing at runtime\n      expect(latest[0].connectionError).toBeInstanceOf(Error);\n      // @ts-expect-error narrowing at runtime\n      expect(latest[0].connectionError?.message).toBe(\"boom\");\n    });\n  });\n});\n"]}

package/esm/model/component-metadata.d.ts

@@ -1,232 +1,18 @@
-import type { ToolAnnotations as MCPToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
-import type { StandardSchemaV1 } from "@standard-schema/spec";
-import TamboAI from "@tambo-ai/typescript-sdk";
-import { JSONSchema7 } from "json-schema";
-import { ComponentType } from "react";
+import type { ComponentType } from "react";
+import type { TamboComponent as BaseTamboComponent, RegisteredComponent as BaseRegisteredComponent } from "@tambo-ai/client";
+export type { SupportedSchema, ToolAnnotations, ParameterSpec, ComponentContextToolMetadata, ComponentContextTool, TamboToolRegistry, JSONSchemaLite, TamboTool, TamboToolJSONSchema, TamboToolUnknown, TamboToolStandardSchema, UnsupportedSchemaTamboTool, TamboToolAssociations, RegisterToolsFn, RegisterToolFn, DefineToolFn, } from "@tambo-ai/client";
 /**
- * A schema type that accepts either a Standard Schema compliant validator
- * (e.g., Zod, Valibot, ArkType) or a raw JSON Schema object.
- *
- * Standard Schema is a specification that provides a unified interface for
- * TypeScript validation libraries. Libraries like Zod implement this spec,
- * allowing us to accept any compliant validator without depending on a specific library.
- * @see https://standardschema.dev/
+ * React-specific RegisteredComponent with ComponentType fields.
  */
-export type SupportedSchema<Input = unknown, Output = Input> = StandardSchemaV1<Input, Output> | JSONSchema7;
-/**
- * Annotations describing a tool's behavior, aligned with the MCP (Model Context Protocol)
- * specification. These hints help clients understand how tools behave and can be used
- * to optimize tool execution strategies.
- * @see https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations
- */
-export type ToolAnnotations = MCPToolAnnotations & {
-    /**
-     * Indicates that the tool is safe to be called repeatedly while a response is
-     * being streamed. This is typically used for read-only tools that do not
-     * cause side effects.
-     */
-    tamboStreamableHint?: boolean;
-};
-/** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */
-export type ParameterSpec = TamboAI.ToolParameters & {
-    schema?: JSONSchema7;
-};
-/**
- * Extends the base ContextTool interface from Tambo AI to include schema information
- * for parameter validation.
- */
-export interface ComponentContextToolMetadata extends TamboAI.ComponentContextToolMetadata {
-    parameters: ParameterSpec[];
-    /**
-     * Optional per-tool call limit. When set, this overrides the project's
-     * global tool call limit for this specific tool.
-     *
-     * This is useful for tools that should only be called once or twice
-     * regardless of the project's global limit.
-     */
-    maxCalls?: number;
-    /**
-     * Annotations describing the tool's behavior. See {@link ToolAnnotations}.
-     */
-    annotations?: ToolAnnotations;
-}
-export interface ComponentContextTool {
-    getComponentContext: (...args: any[]) => Promise<any>;
-    definition: ComponentContextToolMetadata;
-}
-export interface RegisteredComponent extends TamboAI.AvailableComponent {
+export interface RegisteredComponent extends Omit<BaseRegisteredComponent, "component" | "loadingComponent"> {
     component: ComponentType<any>;
     loadingComponent?: ComponentType<any>;
 }
 export type ComponentRegistry = Record<string, RegisteredComponent>;
-export type TamboToolRegistry = Record<string, TamboTool>;
-/**
- * A JSON Schema that is compatible with the MCP.
- * This is a simplified JSON Schema that is compatible with the MCPClient and the tool's inputSchema.
- *
- * Do not export this type from the SDK.
- */
-export type JSONSchemaLite = JSONSchema7 & {
-    description?: string;
-};
-type MaybeAsync<T> = T | Promise<T>;
 /**
- * TamboTool is a type that represents a tool that can be registered with Tambo.
- *
- * It is preferable to use the `defineTool` helper function to create tools, as
- * it provides better type inference and safety.
- * @example
- * ```ts
- * import { TamboTool, defineTool } from "@tambo-ai/react";
- * import { z } from "zod";
- *
- * const locationToLatLon = defineTool({
- *   name: "location_to_latlon",
- *   description:
- *     "Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.",
- *   tool: async ({ location }) => getLatLonFromLocation(location),
- *   inputSchema: z.object({
- *     location: z.string(),
- *   }),
- *   outputSchema: z.object({
- *     lat: z.number(),
- *     lon: z.number(),
- *   }),
- * });
- * ```
+ * React-specific TamboComponent with ComponentType fields.
  */
-export interface TamboTool<Params = any, Returns = any, Rest extends any[] = []> {
-    /**
-     * Unique identifier for the tool
-     */
-    name: string;
-    /**
-     * Description of what the tool does - used by AI to determine when to use it
-     */
-    description: string;
-    /**
-     * Optional human-readable name of the tool for display purposes.
-     */
-    title?: string;
-    /**
-     * Optional limit for how many times this tool may be called while
-     * generating a single response. If present, this value overrides the
-     * project's global `maxToolCallLimit` for this tool.
-     * @example 1
-     */
-    maxCalls?: number;
-    /**
-     * Annotations describing the tool's behavior, aligned with the MCP specification.
-     * Use `tamboStreamableHint: true` to enable streaming execution of partial tool calls.
-     * @see {@link ToolAnnotations}
-     * @example
-     * ```ts
-     * const setTextTool: TamboTool<{ text: string }> = {
-     *   name: "set_text",
-     *   description: "Set the displayed text",
-     *   annotations: {
-     *     tamboStreamableHint: true, // tool is safe for streaming calls
-     *   },
-     *   tool: ({ text }) => setText(text),
-     *   inputSchema: z.object({ text: z.string() }),
-     *   outputSchema: z.void(),
-     * };
-     * ```
-     */
-    annotations?: ToolAnnotations;
-    /**
-     * The function that implements the tool's logic. This function will be called
-     * by Tambo when the model decides to invoke the tool.
-     * @param params - The input parameters for the tool. These are validated
-     * against the inputSchema before being passed so are guaranteed to be correct
-     * when called by the model.
-     * @returns The result of the tool execution, which can be a value or a
-     * Promise resolving to a value
-     */
-    tool: (params: Params, ...rest: Rest) => MaybeAsync<Returns>;
-    /**
-     * The schema for the tool's input parameters. This can be a validator from
-     * any Standard Schema compliant library (Zod 3.24+, Zod 4.x) or a
-     * raw JSON Schema object.
-     *
-     * This schema is used to validate and parse the parameters before passing
-     * them to the tool function.
-     */
-    inputSchema: SupportedSchema<Params>;
-    /**
-     * The schema for the tool's output/return value. This can be any Standard Schema
-     * compliant validator (Zod 3.24+, Zod 4.x) or a raw JSON Schema object.
-     *
-     * This is used to inform the model about the structure of the tool's return value
-     * and is not used for runtime validation at this stage.
-     */
-    outputSchema: SupportedSchema<Returns>;
-    /**
-     * Optional function to transform the tool's return value into an array of content parts.
-     * If not provided, the return value will be converted to a string and wrapped in a text content part.
-     * @param result - The result returned by the tool function
-     * @returns An array of content parts to be sent back to the AI
-     */
-    transformToContent?: (result: any) => Promise<TamboAI.Beta.Threads.ChatCompletionContentPart[]> | TamboAI.Beta.Threads.ChatCompletionContentPart[];
-}
-/**
- * A tool that uses JSON Schema compliant input and output schemas.
- * This does not provide type safety for the tool's parameters and return value.
- * @internal
- */
-export type TamboToolJSONSchema<Args extends unknown[] = unknown[], Returns = unknown> = Omit<TamboTool<Args, Returns>, "tool" | "inputSchema" | "outputSchema"> & {
-    tool: (...args: Args) => MaybeAsync<Returns>;
-    inputSchema: JSONSchemaLite;
-    outputSchema: JSONSchemaLite;
-};
-/**
- * A tool that could not be matched to any known schema types.
- * This means type safety cannot be guaranteed.
- * @internal
- */
-export type TamboToolUnknown = Omit<TamboTool, "tool" | "inputSchema" | "outputSchema"> & {
-    tool: (...args: unknown[]) => MaybeAsync<unknown>;
-    inputSchema: SupportedSchema;
-    outputSchema: SupportedSchema;
-};
-/**
- * A tool that uses Standard Schema compliant input and output schemas.
- * This provides full type safety for the tool's parameters and return value.
- * @internal
- */
-export type TamboToolStandardSchema<Input extends StandardSchemaV1 = StandardSchemaV1, Output extends StandardSchemaV1 = StandardSchemaV1> = Omit<TamboTool<StandardSchemaV1.InferOutput<Input>, StandardSchemaV1.InferOutput<Output>>, "tool" | "inputSchema" | "outputSchema"> & {
-    tool: (...args: [StandardSchemaV1.InferOutput<Input>]) => MaybeAsync<StandardSchemaV1.InferOutput<Output>>;
-    inputSchema: Input;
-    outputSchema: Output;
-};
-/**
- * If you're seeing this type, it means that you are using a deprecated and now
- * unsupported schema type for defining Tambo tools.
- *
- * Follow the migration guide to update your tool definitions to use
- * inputSchema and outputSchema with either Standard Schema compliant validators
- * (like Zod 3.25.76, Zod 4.x) or raw JSON Schema objects.
- * @deprecated replace `toolSchema` with `inputSchema` and `outputSchema` instead.
- * @see {@link https://docs.tambo.co/reference/react-sdk/migration}
- */
-export type UnsupportedSchemaTamboTool = Omit<TamboTool, "tool" | "inputSchema" | "outputSchema"> & {
-    /**
-     * @deprecated replace `toolSchema` with `inputSchema` and `outputSchema` instead.
-     */
-    toolSchema: any;
-    tool: (...args: any[]) => MaybeAsync<any>;
-    inputSchema?: never;
-    outputSchema?: never;
-};
-export type TamboToolAssociations = Record<string, string[]>;
-/**
- * A component that can be registered with the TamboRegistryProvider.
- */
-export interface TamboComponent {
-    /** The name of the component */
-    name: string;
-    /** The description of the component */
-    description: string;
+export interface TamboComponent extends Omit<BaseTamboComponent, "component" | "loadingComponent"> {
     /**
      * The React component to render.
      *
@@ -247,158 +33,7 @@ export interface TamboComponent {
      * ```
      */
     component: ComponentType<any>;
-    /**
-     * Schema describing the component's props. Accepts any Standard Schema
-     * compliant validator (Zod, Valibot, ArkType, etc.) or a raw JSON Schema
-     * object.
-     *
-     * Either this or propsDefinition must be provided, but not both.
-     * @example
-     * ```typescript
-     * import { z } from "zod/v4";
-     *
-     * const component: TamboComponent = {
-     *   name: "MyComponent",
-     *   description: "A sample component",
-     *   component: MyComponent,
-     *   propsSchema: z.object({
-     *     title: z.string(),
-     *     count: z.number().optional()
-     *   })
-     * };
-     * ```
-     */
-    propsSchema?: SupportedSchema;
-    /**
-     * The props definition of the component as a JSON object.
-     * Either this or propsSchema must be provided, but not both.
-     * @deprecated Use propsSchema instead.
-     */
-    propsDefinition?: any;
     /** The loading component to render while the component is loading */
     loadingComponent?: ComponentType<any>;
-    /** The tools that are associated with the component */
-    associatedTools?: TamboTool[];
-    /** Annotations describing the component's behavior. */
-    annotations?: ToolAnnotations;
-}
-type OptionalSchemaProps<T> = Omit<T, "inputSchema" | "outputSchema"> & {
-    inputSchema?: T extends {
-        inputSchema: infer I;
-    } ? I : never;
-    outputSchema?: T extends {
-        outputSchema: infer O;
-    } ? O : never;
-};
-/**
- * Registers one or more Tambo tools.
- * @param tools - An array of Tambo tools to register
- * @param warnOnOverwrite - Whether to warn if any tool is being overwritten
- */
-export interface RegisterToolsFn {
-    /**
-     * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration | Migration Guide} to update
-     * your tool definitions to use `inputSchema` and `outputSchema` instead.
-     */
-    (tools: UnsupportedSchemaTamboTool[], warnOnOverwrite?: boolean): void;
-    /**
-     * Register one or more Tambo tools. For better type inference, consider registering tools individually using the
-     * `registerTool` function or use the `defineTool` helper when defining your tools.
-     * @example
-     * ```typescript
-     * import { defineTool } from "@tambo-ai/react";
-     * const tools = [
-     *   defineTool({...});
-     *   defineTool({...});
-     * ];
-     * registerTools(tools);
-     * @param tools - An array of Tambo tools to register
-     * @param warnOnOverwrite - Whether to warn if any tool is being overwritten
-     */
-    (tools: TamboTool[], warnOnOverwrite?: boolean): void;
-}
-/**
- * Function interface for registering a Tambo tool with full type inference.
- * This function has multiple overloads to handle different schema types. This
- * is a utility function and does not perform any runtime logic.
- */
-export interface RegisterToolFn {
-    <Args extends StandardSchemaV1, Returns extends StandardSchemaV1>(tool: TamboToolStandardSchema<Args, Returns>, warnOnOverwrite?: boolean): void;
-    <Args extends any[], Returns = any>(tool: TamboToolJSONSchema<Args, Returns>, warnOnOverwrite?: boolean): void;
-    (tool: TamboToolUnknown, warnOnOverwrite?: boolean): void;
-    (tool: TamboTool, warnOnOverwrite?: boolean): void;
-    /**
-     * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration | Migration Guide} to update
-     * your tool definitions to use `inputSchema` and `outputSchema` instead.
-     * @param tool - The unsupported schema Tambo tool to register
-     * @param warnOnOverwrite - Whether to warn if the tool is being overwritten
-     */
-    (tool: UnsupportedSchemaTamboTool, warnOnOverwrite?: boolean): void;
-}
-/**
- * Function interface for defining a Tambo tool with full type inference. This function has multiple overloads to handle
- * different schema types. This is a utility function and does not perform any runtime logic.
- */
-export interface DefineToolFn {
-    /**
-     * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration | Migration Guide} to update
-     * your tool definitions to use `inputSchema` and `outputSchema` instead.
-     * @param tool The tool definition to register
-     * @returns The registered tool definition
-     */
-    (tool: UnsupportedSchemaTamboTool): typeof tool;
-    /**
-     * Provides type safety for defining a Tambo Tool.
-     *
-     * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema
-     * compliant validator (Zod 3.24+, Zod 4.x). This definition ensures the input and output types are correctly
-     * inferred from the provided schemas.
-     * @example
-     * ```typescript
-     * import { z } from "zod/v4";
-     *
-     * const myTool = defineTool({
-     *   name: "myTool",
-     *   description: "An example tool",
-     *   inputSchema: z.object({
-     *     input: z.string().describe("Input description")
-     *   }),
-     *   outputSchema: z.number().describe("Result description"),
-     *   tool: ({ input }) => input.length,
-     * });
-     * ```
-     * @see {@link https://standard-schema.dev/}
-     * @param tool The tool definition to register
-     * @returns The registered tool definition
-     */
-    <Input extends StandardSchemaV1, Output extends StandardSchemaV1>(tool: OptionalSchemaProps<TamboToolStandardSchema<Input, Output>>): TamboToolStandardSchema<Input, Output>;
-    /**
-     * Provides type safety for defining a Tambo Tool with JSON Schema input and output.
-     *
-     * This overload is used when providing raw JSON Schema objects instead of StandardSchema validators.
-     * Type inference is limited when using raw JSON Schema.
-     * @see {@link https://standard-schema.dev/}
-     * @param tool The tool definition to register
-     * @returns The registered tool definition
-     */
-    <I extends any[], O = any>(tool: OptionalSchemaProps<TamboToolJSONSchema<I, O>>): TamboToolJSONSchema<I, O>;
-    /**
-     * Provides type safety for defining a Tambo Tool.
-     *
-     * This overload is used when the schema types could not be matched to known types.
-     * Type safety cannot be guaranteed.
-     * @param tool The tool definition to register
-     * @returns The registered tool definition
-     */
-    (tool: OptionalSchemaProps<TamboToolUnknown>): TamboToolUnknown;
-    /**
-     * Provides type safety for defining a Tambo Tool.
-     *
-     * This overload is used when providing a fully defined TamboTool.
-     * @param tool The tool definition to register
-     * @returns The registered tool definition
-     */
-    (tool: OptionalSchemaProps<TamboTool>): TamboTool;
 }
-export {};
 //# sourceMappingURL=component-metadata.d.ts.map

package/esm/model/component-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-metadata.d.ts","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component-metadata.d.ts","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,cAAc,IAAI,kBAAkB,EACpC,mBAAmB,IAAI,uBAAuB,EAC/C,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,uBAAuB,EACvB,WAAW,GAAG,kBAAkB,CACjC;IACC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,gBAAgB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI,CAC1C,kBAAkB,EAClB,WAAW,GAAG,kBAAkB,CACjC;IACC;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACvC"}

package/esm/model/component-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-metadata.js","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"","sourcesContent":["import type { ToolAnnotations as MCPToolAnnotations } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { JSONSchema7 } from \"json-schema\";\nimport { ComponentType } from \"react\";\n\n/**\n * A schema type that accepts either a Standard Schema compliant validator\n * (e.g., Zod, Valibot, ArkType) or a raw JSON Schema object.\n *\n * Standard Schema is a specification that provides a unified interface for\n * TypeScript validation libraries. Libraries like Zod implement this spec,\n * allowing us to accept any compliant validator without depending on a specific library.\n * @see https://standardschema.dev/\n */\nexport type SupportedSchema<Input = unknown, Output = Input> =\n  | StandardSchemaV1<Input, Output>\n  | JSONSchema7;\n\n/**\n * Annotations describing a tool's behavior, aligned with the MCP (Model Context Protocol)\n * specification. These hints help clients understand how tools behave and can be used\n * to optimize tool execution strategies.\n * @see https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations\n */\nexport type ToolAnnotations = MCPToolAnnotations & {\n  /**\n   * Indicates that the tool is safe to be called repeatedly while a response is\n   * being streamed. This is typically used for read-only tools that do not\n   * cause side effects.\n   */\n  tamboStreamableHint?: boolean;\n};\n\n/** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */\nexport type ParameterSpec = TamboAI.ToolParameters & {\n  schema?: JSONSchema7;\n};\n\n/**\n * Extends the base ContextTool interface from Tambo AI to include schema information\n * for parameter validation.\n */\nexport interface ComponentContextToolMetadata\n  extends TamboAI.ComponentContextToolMetadata {\n  parameters: ParameterSpec[];\n  /**\n   * Optional per-tool call limit. When set, this overrides the project's\n   * global tool call limit for this specific tool.\n   *\n   * This is useful for tools that should only be called once or twice\n   * regardless of the project's global limit.\n   */\n  maxCalls?: number;\n  /**\n   * Annotations describing the tool's behavior. See {@link ToolAnnotations}.\n   */\n  annotations?: ToolAnnotations;\n}\n\nexport interface ComponentContextTool {\n  getComponentContext: (...args: any[]) => Promise<any>;\n  definition: ComponentContextToolMetadata;\n}\n\nexport interface RegisteredComponent extends TamboAI.AvailableComponent {\n  component: ComponentType<any>;\n  loadingComponent?: ComponentType<any>;\n}\n\nexport type ComponentRegistry = Record<string, RegisteredComponent>;\n\nexport type TamboToolRegistry = Record<string, TamboTool>;\n\n/**\n * A JSON Schema that is compatible with the MCP.\n * This is a simplified JSON Schema that is compatible with the MCPClient and the tool's inputSchema.\n *\n * Do not export this type from the SDK.\n */\nexport type JSONSchemaLite = JSONSchema7 & {\n  description?: string;\n};\n\ntype MaybeAsync<T> = T | Promise<T>;\n\n/**\n * TamboTool is a type that represents a tool that can be registered with Tambo.\n *\n * It is preferable to use the `defineTool` helper function to create tools, as\n * it provides better type inference and safety.\n * @example\n * ```ts\n * import { TamboTool, defineTool } from \"@tambo-ai/react\";\n * import { z } from \"zod\";\n *\n * const locationToLatLon = defineTool({\n *   name: \"location_to_latlon\",\n *   description:\n *     \"Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.\",\n *   tool: async ({ location }) => getLatLonFromLocation(location),\n *   inputSchema: z.object({\n *     location: z.string(),\n *   }),\n *   outputSchema: z.object({\n *     lat: z.number(),\n *     lon: z.number(),\n *   }),\n * });\n * ```\n */\nexport interface TamboTool<\n  Params = any,\n  Returns = any,\n  Rest extends any[] = [],\n> {\n  /**\n   * Unique identifier for the tool\n   */\n  name: string;\n  /**\n   * Description of what the tool does - used by AI to determine when to use it\n   */\n  description: string;\n  /**\n   * Optional human-readable name of the tool for display purposes.\n   */\n  title?: string;\n  /**\n   * Optional limit for how many times this tool may be called while\n   * generating a single response. If present, this value overrides the\n   * project's global `maxToolCallLimit` for this tool.\n   * @example 1\n   */\n  maxCalls?: number;\n  /**\n   * Annotations describing the tool's behavior, aligned with the MCP specification.\n   * Use `tamboStreamableHint: true` to enable streaming execution of partial tool calls.\n   * @see {@link ToolAnnotations}\n   * @example\n   * ```ts\n   * const setTextTool: TamboTool<{ text: string }> = {\n   *   name: \"set_text\",\n   *   description: \"Set the displayed text\",\n   *   annotations: {\n   *     tamboStreamableHint: true, // tool is safe for streaming calls\n   *   },\n   *   tool: ({ text }) => setText(text),\n   *   inputSchema: z.object({ text: z.string() }),\n   *   outputSchema: z.void(),\n   * };\n   * ```\n   */\n  annotations?: ToolAnnotations;\n\n  /**\n   * The function that implements the tool's logic. This function will be called\n   * by Tambo when the model decides to invoke the tool.\n   * @param params - The input parameters for the tool. These are validated\n   * against the inputSchema before being passed so are guaranteed to be correct\n   * when called by the model.\n   * @returns The result of the tool execution, which can be a value or a\n   * Promise resolving to a value\n   */\n  tool: (params: Params, ...rest: Rest) => MaybeAsync<Returns>;\n\n  /**\n   * The schema for the tool's input parameters. This can be a validator from\n   * any Standard Schema compliant library (Zod 3.24+, Zod 4.x) or a\n   * raw JSON Schema object.\n   *\n   * This schema is used to validate and parse the parameters before passing\n   * them to the tool function.\n   */\n  inputSchema: SupportedSchema<Params>;\n\n  /**\n   * The schema for the tool's output/return value. This can be any Standard Schema\n   * compliant validator (Zod 3.24+, Zod 4.x) or a raw JSON Schema object.\n   *\n   * This is used to inform the model about the structure of the tool's return value\n   * and is not used for runtime validation at this stage.\n   */\n  outputSchema: SupportedSchema<Returns>;\n\n  /**\n   * Optional function to transform the tool's return value into an array of content parts.\n   * If not provided, the return value will be converted to a string and wrapped in a text content part.\n   * @param result - The result returned by the tool function\n   * @returns An array of content parts to be sent back to the AI\n   */\n  transformToContent?: (\n    result: any,\n  ) =>\n    | Promise<TamboAI.Beta.Threads.ChatCompletionContentPart[]>\n    | TamboAI.Beta.Threads.ChatCompletionContentPart[];\n}\n\n/**\n * A tool that uses JSON Schema compliant input and output schemas.\n * This does not provide type safety for the tool's parameters and return value.\n * @internal\n */\nexport type TamboToolJSONSchema<\n  Args extends unknown[] = unknown[],\n  Returns = unknown,\n> = Omit<TamboTool<Args, Returns>, \"tool\" | \"inputSchema\" | \"outputSchema\"> & {\n  tool: (...args: Args) => MaybeAsync<Returns>;\n  inputSchema: JSONSchemaLite;\n  outputSchema: JSONSchemaLite;\n};\n\n/**\n * A tool that could not be matched to any known schema types.\n * This means type safety cannot be guaranteed.\n * @internal\n */\nexport type TamboToolUnknown = Omit<\n  TamboTool,\n  \"tool\" | \"inputSchema\" | \"outputSchema\"\n> & {\n  tool: (...args: unknown[]) => MaybeAsync<unknown>;\n  inputSchema: SupportedSchema;\n  outputSchema: SupportedSchema;\n};\n\n/**\n * A tool that uses Standard Schema compliant input and output schemas.\n * This provides full type safety for the tool's parameters and return value.\n * @internal\n */\nexport type TamboToolStandardSchema<\n  Input extends StandardSchemaV1 = StandardSchemaV1,\n  Output extends StandardSchemaV1 = StandardSchemaV1,\n> = Omit<\n  TamboTool<\n    StandardSchemaV1.InferOutput<Input>,\n    StandardSchemaV1.InferOutput<Output>\n  >,\n  \"tool\" | \"inputSchema\" | \"outputSchema\"\n> & {\n  tool: (\n    ...args: [StandardSchemaV1.InferOutput<Input>]\n  ) => MaybeAsync<StandardSchemaV1.InferOutput<Output>>;\n  inputSchema: Input;\n  outputSchema: Output;\n};\n\n/**\n * If you're seeing this type, it means that you are using a deprecated and now\n * unsupported schema type for defining Tambo tools.\n *\n * Follow the migration guide to update your tool definitions to use\n * inputSchema and outputSchema with either Standard Schema compliant validators\n * (like Zod 3.25.76, Zod 4.x) or raw JSON Schema objects.\n * @deprecated replace `toolSchema` with `inputSchema` and `outputSchema` instead.\n * @see {@link https://docs.tambo.co/reference/react-sdk/migration}\n */\nexport type UnsupportedSchemaTamboTool = Omit<\n  TamboTool,\n  \"tool\" | \"inputSchema\" | \"outputSchema\"\n> & {\n  /**\n   * @deprecated replace `toolSchema` with `inputSchema` and `outputSchema` instead.\n   */\n  toolSchema: any;\n  tool: (...args: any[]) => MaybeAsync<any>;\n  inputSchema?: never;\n  outputSchema?: never;\n};\n\nexport type TamboToolAssociations = Record<string, string[]>;\n/**\n * A component that can be registered with the TamboRegistryProvider.\n */\n\nexport interface TamboComponent {\n  /** The name of the component */\n  name: string;\n  /** The description of the component */\n  description: string;\n  /**\n   * The React component to render.\n   *\n   * Make sure to pass the Component itself, not an instance of the component. For example,\n   * if you have a component like this:\n   *\n   * ```tsx\n   * const MyComponent = () => {\n   *   return <div>My Component</div>;\n   * };\n   * ```\n   *\n   * You should pass the `Component`:\n   *\n   * ```tsx\n   * const components = [MyComponent];\n   * <TamboRegistryProvider components={components} />\n   * ```\n   */\n  component: ComponentType<any>;\n\n  /**\n   * Schema describing the component's props. Accepts any Standard Schema\n   * compliant validator (Zod, Valibot, ArkType, etc.) or a raw JSON Schema\n   * object.\n   *\n   * Either this or propsDefinition must be provided, but not both.\n   * @example\n   * ```typescript\n   * import { z } from \"zod/v4\";\n   *\n   * const component: TamboComponent = {\n   *   name: \"MyComponent\",\n   *   description: \"A sample component\",\n   *   component: MyComponent,\n   *   propsSchema: z.object({\n   *     title: z.string(),\n   *     count: z.number().optional()\n   *   })\n   * };\n   * ```\n   */\n  propsSchema?: SupportedSchema;\n  /**\n   * The props definition of the component as a JSON object.\n   * Either this or propsSchema must be provided, but not both.\n   * @deprecated Use propsSchema instead.\n   */\n  propsDefinition?: any;\n  /** The loading component to render while the component is loading */\n  loadingComponent?: ComponentType<any>;\n  /** The tools that are associated with the component */\n  associatedTools?: TamboTool[];\n  /** Annotations describing the component's behavior. */\n  annotations?: ToolAnnotations;\n}\n\ntype OptionalSchemaProps<T> = Omit<T, \"inputSchema\" | \"outputSchema\"> & {\n  inputSchema?: T extends { inputSchema: infer I } ? I : never;\n  outputSchema?: T extends { outputSchema: infer O } ? O : never;\n};\n\n/**\n * Registers one or more Tambo tools.\n * @param tools - An array of Tambo tools to register\n * @param warnOnOverwrite - Whether to warn if any tool is being overwritten\n */\nexport interface RegisterToolsFn {\n  /**\n   * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration | Migration Guide} to update\n   * your tool definitions to use `inputSchema` and `outputSchema` instead.\n   */\n  (tools: UnsupportedSchemaTamboTool[], warnOnOverwrite?: boolean): void;\n  /**\n   * Register one or more Tambo tools. For better type inference, consider registering tools individually using the\n   * `registerTool` function or use the `defineTool` helper when defining your tools.\n   * @example\n   * ```typescript\n   * import { defineTool } from \"@tambo-ai/react\";\n   * const tools = [\n   *   defineTool({...});\n   *   defineTool({...});\n   * ];\n   * registerTools(tools);\n   * @param tools - An array of Tambo tools to register\n   * @param warnOnOverwrite - Whether to warn if any tool is being overwritten\n   */\n  (tools: TamboTool[], warnOnOverwrite?: boolean): void;\n}\n\n/**\n * Function interface for registering a Tambo tool with full type inference.\n * This function has multiple overloads to handle different schema types. This\n * is a utility function and does not perform any runtime logic.\n */\nexport interface RegisterToolFn {\n  <Args extends StandardSchemaV1, Returns extends StandardSchemaV1>(\n    tool: TamboToolStandardSchema<Args, Returns>,\n    warnOnOverwrite?: boolean,\n  ): void;\n  <Args extends any[], Returns = any>(\n    tool: TamboToolJSONSchema<Args, Returns>,\n    warnOnOverwrite?: boolean,\n  ): void;\n  (tool: TamboToolUnknown, warnOnOverwrite?: boolean): void;\n  (tool: TamboTool, warnOnOverwrite?: boolean): void;\n  /**\n   * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration | Migration Guide} to update\n   * your tool definitions to use `inputSchema` and `outputSchema` instead.\n   * @param tool - The unsupported schema Tambo tool to register\n   * @param warnOnOverwrite - Whether to warn if the tool is being overwritten\n   */\n  (tool: UnsupportedSchemaTamboTool, warnOnOverwrite?: boolean): void;\n}\n\n/**\n * Function interface for defining a Tambo tool with full type inference. This function has multiple overloads to handle\n * different schema types. This is a utility function and does not perform any runtime logic.\n */\nexport interface DefineToolFn {\n  /**\n   * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration | Migration Guide} to update\n   * your tool definitions to use `inputSchema` and `outputSchema` instead.\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  (tool: UnsupportedSchemaTamboTool): typeof tool;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema\n   * compliant validator (Zod 3.24+, Zod 4.x). This definition ensures the input and output types are correctly\n   * inferred from the provided schemas.\n   * @example\n   * ```typescript\n   * import { z } from \"zod/v4\";\n   *\n   * const myTool = defineTool({\n   *   name: \"myTool\",\n   *   description: \"An example tool\",\n   *   inputSchema: z.object({\n   *     input: z.string().describe(\"Input description\")\n   *   }),\n   *   outputSchema: z.number().describe(\"Result description\"),\n   *   tool: ({ input }) => input.length,\n   * });\n   * ```\n   * @see {@link https://standard-schema.dev/}\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  <Input extends StandardSchemaV1, Output extends StandardSchemaV1>(\n    tool: OptionalSchemaProps<TamboToolStandardSchema<Input, Output>>,\n  ): TamboToolStandardSchema<Input, Output>;\n  /**\n   * Provides type safety for defining a Tambo Tool with JSON Schema input and output.\n   *\n   * This overload is used when providing raw JSON Schema objects instead of StandardSchema validators.\n   * Type inference is limited when using raw JSON Schema.\n   * @see {@link https://standard-schema.dev/}\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  <I extends any[], O = any>(\n    tool: OptionalSchemaProps<TamboToolJSONSchema<I, O>>,\n  ): TamboToolJSONSchema<I, O>;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This overload is used when the schema types could not be matched to known types.\n   * Type safety cannot be guaranteed.\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  (tool: OptionalSchemaProps<TamboToolUnknown>): TamboToolUnknown;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This overload is used when providing a fully defined TamboTool.\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  (tool: OptionalSchemaProps<TamboTool>): TamboTool;\n}\n"]}
+{"version":3,"file":"component-metadata.js","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"","sourcesContent":["// Re-exported from @tambo-ai/client, with React-specific overrides for\n// TamboComponent and RegisteredComponent which use ComponentType<any>\n// instead of the client's framework-agnostic `unknown`.\nimport type { ComponentType } from \"react\";\nimport type {\n  TamboComponent as BaseTamboComponent,\n  RegisteredComponent as BaseRegisteredComponent,\n} from \"@tambo-ai/client\";\n\n// Re-export everything from client that doesn't need React-specific overrides\nexport type {\n  SupportedSchema,\n  ToolAnnotations,\n  ParameterSpec,\n  ComponentContextToolMetadata,\n  ComponentContextTool,\n  TamboToolRegistry,\n  JSONSchemaLite,\n  TamboTool,\n  TamboToolJSONSchema,\n  TamboToolUnknown,\n  TamboToolStandardSchema,\n  UnsupportedSchemaTamboTool,\n  TamboToolAssociations,\n  RegisterToolsFn,\n  RegisterToolFn,\n  DefineToolFn,\n} from \"@tambo-ai/client\";\n\n/**\n * React-specific RegisteredComponent with ComponentType fields.\n */\nexport interface RegisteredComponent extends Omit<\n  BaseRegisteredComponent,\n  \"component\" | \"loadingComponent\"\n> {\n  component: ComponentType<any>;\n  loadingComponent?: ComponentType<any>;\n}\n\nexport type ComponentRegistry = Record<string, RegisteredComponent>;\n\n/**\n * React-specific TamboComponent with ComponentType fields.\n */\nexport interface TamboComponent extends Omit<\n  BaseTamboComponent,\n  \"component\" | \"loadingComponent\"\n> {\n  /**\n   * The React component to render.\n   *\n   * Make sure to pass the Component itself, not an instance of the component. For example,\n   * if you have a component like this:\n   *\n   * ```tsx\n   * const MyComponent = () => {\n   *   return <div>My Component</div>;\n   * };\n   * ```\n   *\n   * You should pass the `Component`:\n   *\n   * ```tsx\n   * const components = [MyComponent];\n   * <TamboRegistryProvider components={components} />\n   * ```\n   */\n  component: ComponentType<any>;\n  /** The loading component to render while the component is loading */\n  loadingComponent?: ComponentType<any>;\n}\n"]}

package/esm/model/validate-input.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-input.test.d.ts.map

package/esm/model/validate-input.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-input.test.d.ts","sourceRoot":"","sources":["../../src/model/validate-input.test.ts"],"names":[],"mappings":""}

package/esm/model/validate-input.test.js

@@ -0,0 +1,36 @@
+import { validateInput } from "./validate-input.js";
+describe("validateInput", () => {
+    it("returns valid for normal input", () => {
+        const result = validateInput("Hello world");
+        expect(result.isValid).toBe(true);
+        expect(result.sanitizedInput).toBe("Hello world");
+        expect(result.error).toBeUndefined();
+    });
+    it("trims whitespace", () => {
+        const result = validateInput("  hello  ");
+        expect(result.isValid).toBe(true);
+        expect(result.sanitizedInput).toBe("hello");
+    });
+    it("rejects empty string", () => {
+        const result = validateInput("");
+        expect(result.isValid).toBe(false);
+        expect(result.error?.message).toBe("Message cannot be empty");
+    });
+    it("rejects whitespace-only string", () => {
+        const result = validateInput("   ");
+        expect(result.isValid).toBe(false);
+        expect(result.error?.message).toBe("Message cannot be empty");
+    });
+    it("rejects messages over 10000 characters", () => {
+        const long = "a".repeat(10001);
+        const result = validateInput(long);
+        expect(result.isValid).toBe(false);
+        expect(result.error?.message).toBe("Message is too long (max 10000 characters)");
+    });
+    it("accepts messages at exactly 10000 characters", () => {
+        const exact = "a".repeat(10000);
+        const result = validateInput(exact);
+        expect(result.isValid).toBe(true);
+    });
+});
+//# sourceMappingURL=validate-input.test.js.map

package/esm/model/validate-input.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-input.test.js","sourceRoot":"","sources":["../../src/model/validate-input.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAChC,4CAA4C,CAC7C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { validateInput } from \"./validate-input\";\n\ndescribe(\"validateInput\", () => {\n  it(\"returns valid for normal input\", () => {\n    const result = validateInput(\"Hello world\");\n    expect(result.isValid).toBe(true);\n    expect(result.sanitizedInput).toBe(\"Hello world\");\n    expect(result.error).toBeUndefined();\n  });\n\n  it(\"trims whitespace\", () => {\n    const result = validateInput(\"  hello  \");\n    expect(result.isValid).toBe(true);\n    expect(result.sanitizedInput).toBe(\"hello\");\n  });\n\n  it(\"rejects empty string\", () => {\n    const result = validateInput(\"\");\n    expect(result.isValid).toBe(false);\n    expect(result.error?.message).toBe(\"Message cannot be empty\");\n  });\n\n  it(\"rejects whitespace-only string\", () => {\n    const result = validateInput(\"   \");\n    expect(result.isValid).toBe(false);\n    expect(result.error?.message).toBe(\"Message cannot be empty\");\n  });\n\n  it(\"rejects messages over 10000 characters\", () => {\n    const long = \"a\".repeat(10001);\n    const result = validateInput(long);\n    expect(result.isValid).toBe(false);\n    expect(result.error?.message).toBe(\n      \"Message is too long (max 10000 characters)\",\n    );\n  });\n\n  it(\"accepts messages at exactly 10000 characters\", () => {\n    const exact = \"a\".repeat(10000);\n    const result = validateInput(exact);\n    expect(result.isValid).toBe(true);\n  });\n});\n"]}

package/esm/providers/tambo-interactable-provider-partial-updates.test.js

@@ -14,9 +14,11 @@ jest.mock("./tambo-context-helpers-provider", () => ({
 }));
 // Mock the registry provider
 const mockRegisterTool = jest.fn();
+const mockUnregisterTools = jest.fn();
 jest.mock("./tambo-registry-provider", () => ({
     useTamboRegistry: () => ({
         registerTool: mockRegisterTool,
+        unregisterTools: mockUnregisterTools,
     }),
 }));
 // Mock the context helper creation