@tambo-ai/react 0.75.0 → 1.0.0-rc.4

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

@@ -207,7 +207,7 @@ export type TamboToolStandardSchema<Input extends StandardSchemaV1 = StandardSch
  * 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/toolschema}
+ * @see {@link https://docs.tambo.co/reference/react-sdk/migration}
  */
 export type UnsupportedSchemaTamboTool = Omit<TamboTool, "tool" | "inputSchema" | "outputSchema"> & {
     /**
@@ -297,7 +297,7 @@ type OptionalSchemaProps<T> = Omit<T, "inputSchema" | "outputSchema"> & {
  */
 export interface RegisterToolsFn {
     /**
-     * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration/toolschema | Migration Guide} to update
+     * @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;
@@ -328,7 +328,7 @@ export interface RegisterToolFn {
     (tool: TamboToolUnknown, warnOnOverwrite?: boolean): void;
     (tool: TamboTool, warnOnOverwrite?: boolean): void;
     /**
-     * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration/toolschema | Migration Guide} to update
+     * @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
@@ -341,7 +341,7 @@ export interface RegisterToolFn {
  */
 export interface DefineToolFn {
     /**
-     * @deprecated Follow the {@link https://docs.tambo.co/reference/react-sdk/migration/toolschema | Migration Guide} to update
+     * @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

package/dist/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/toolschema}\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/toolschema | 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/toolschema | 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/toolschema | 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":["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"]}

package/dist/providers/tambo-client-provider.d.ts

@@ -27,6 +27,11 @@ export interface TamboClientProviderProps {
      * These will be merged with the default headers.
      */
     additionalHeaders?: Record<string, string>;
+    /**
+     * User key sent as a default query parameter on all API requests.
+     * Required if no bearer token (userToken) is provided.
+     */
+    userKey?: string;
 }
 export interface TamboClientContextProps {
     /** The TamboAI client */
@@ -55,6 +60,7 @@ export declare const TamboClientContext: React.Context<TamboClientContextProps |
  * @param props.environment - The environment to use for the Tambo API
  * @param props.userToken - The oauth access token to use to identify the user in the Tambo API
  * @param props.additionalHeaders - Additional headers to include in all requests
+ * @param props.userKey - User key sent as a default query parameter on all API requests
  * @returns The TamboClientProvider component
  */
 export declare const TamboClientProvider: React.FC<PropsWithChildren<TamboClientProviderProps>>;

package/dist/providers/tambo-client-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-client-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-client-provider.tsx"],"names":[],"mappings":"AACA,OAAO,OAA0B,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,EAAiB,iBAAiB,EAAW,MAAM,OAAO,CAAC;AAIzE,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAEvC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,wCAAwC;IACxC,kBAAkB,EAAE,KAAK,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,oDAEnB,CAAC;AAEb;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CACxC,iBAAiB,CAAC,wBAAwB,CAAC,CAgD5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAM1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,mBAQ/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAQnC,CAAC"}
+{"version":3,"file":"tambo-client-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-client-provider.tsx"],"names":[],"mappings":"AACA,OAAO,OAA0B,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,EAAiB,iBAAiB,EAAW,MAAM,OAAO,CAAC;AAIzE,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAEvC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,2DAA2D;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,wCAAwC;IACxC,kBAAkB,EAAE,KAAK,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,2CAA2C;IAC3C,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,oDAEnB,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CACxC,iBAAiB,CAAC,wBAAwB,CAAC,CAkD5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAM1B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,mBAQ/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAQnC,CAAC"}

package/dist/providers/tambo-client-provider.js

@@ -54,18 +54,20 @@ exports.TamboClientContext = (0, react_1.createContext)(undefined);
  * @param props.environment - The environment to use for the Tambo API
  * @param props.userToken - The oauth access token to use to identify the user in the Tambo API
  * @param props.additionalHeaders - Additional headers to include in all requests
+ * @param props.userKey - User key sent as a default query parameter on all API requests
  * @returns The TamboClientProvider component
  */
-const TamboClientProvider = ({ children, tamboUrl, apiKey, environment, userToken, additionalHeaders, }) => {
+const TamboClientProvider = ({ children, tamboUrl, apiKey, environment, userToken, additionalHeaders, userKey, }) => {
     const tamboConfig = (0, react_1.useMemo)(() => ({
         apiKey,
         defaultHeaders: {
             "X-Tambo-React-Version": package_json_1.default.version,
             ...additionalHeaders,
         },
+        defaultQuery: userKey ? { userKey } : undefined,
         baseURL: tamboUrl ?? undefined,
         environment: environment ?? undefined,
-    }), [additionalHeaders, apiKey, tamboUrl, environment]);
+    }), [additionalHeaders, apiKey, tamboUrl, environment, userKey]);
     const client = (0, react_1.useMemo)(() => new typescript_sdk_1.default(tamboConfig), [tamboConfig]);
     const queryClient = (0, react_1.useMemo)(() => new react_query_1.QueryClient(), []);
     // Keep the session token updated and get the updating state

package/dist/providers/tambo-client-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-client-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-client-provider.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACb,8EAAkE;AAClE,uDAAoD;AACpD,+CAAyE;AACzE,sEAA6C;AAC7C,6EAAuE;AAiD1D,QAAA,kBAAkB,GAAG,IAAA,qBAAa,EAE7C,SAAS,CAAC,CAAC;AAEb;;;;;;;;;;;GAWG;AACI,MAAM,mBAAmB,GAE5B,CAAC,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,WAAW,EACX,SAAS,EACT,iBAAiB,GAClB,EAAE,EAAE;IACH,MAAM,WAAW,GAAG,IAAA,eAAO,EACzB,GAAG,EAAE,CACH,CAAC;QACC,MAAM;QACN,cAAc,EAAE;YACd,uBAAuB,EAAE,sBAAW,CAAC,OAAO;YAC5C,GAAG,iBAAiB;SACrB;QACD,OAAO,EAAE,QAAQ,IAAI,SAAS;QAC9B,WAAW,EAAE,WAAW,IAAI,SAAS;KACtC,CAAyB,EAC5B,CAAC,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CACnD,CAAC;IAEF,MAAM,MAAM,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,IAAI,wBAAO,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,IAAI,yBAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IAEzD,4DAA4D;IAC5D,MAAM,EACJ,UAAU,EAAE,eAAe,EAC3B,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,SAAS,GAChB,GAAG,IAAA,8CAAoB,EAAC,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEzD,OAAO,CACL,8BAAC,0BAAkB,CAAC,QAAQ,IAC1B,KAAK,EAAE;YACL,MAAM;YACN,WAAW;YACX,eAAe;YACf,iBAAiB,EAAE,WAAW,CAAC,cAAc;YAC7C,kBAAkB,EAAE,kBAAkB,IAAI,IAAI;YAC9C,SAAS;YACT,aAAa,EAAE,CAAC,CAAC,SAAS,EAAE,YAAY;SACzC,IAEA,QAAQ,CACmB,CAC/B,CAAC;AACJ,CAAC,CAAC;AAjDW,QAAA,mBAAmB,uBAiD9B;AAEF;;;;GAIG;AACI,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,OAAO,GAAG,eAAK,CAAC,UAAU,CAAC,0BAAkB,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB;AAEF;;;;;GAKG;AACI,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,OAAO,GAAG,eAAK,CAAC,UAAU,CAAC,0BAAkB,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,CAAC;AAC7B,CAAC,CAAC;AARW,QAAA,mBAAmB,uBAQ9B;AAEF;;;GAGG;AACI,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,MAAM,OAAO,GAAG,eAAK,CAAC,UAAU,CAAC,0BAAkB,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,eAAe,CAAC;AACjC,CAAC,CAAC;AARW,QAAA,uBAAuB,2BAQlC","sourcesContent":["\"use client\";\nimport TamboAI, { ClientOptions } from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport React, { createContext, PropsWithChildren, useMemo } from \"react\";\nimport packageJson from \"../../package.json\";\nimport { useTamboSessionToken } from \"./hooks/use-tambo-session-token\";\n\nexport interface TamboClientProviderProps {\n  /**\n   * The URL of the Tambo API (only used for local development and debugging)\n   */\n  tamboUrl?: string;\n  /**\n   * The API key for the Tambo API. This typically comes from a variable like\n   * `process.env.NEXT_PUBLIC_TAMBO_API_KEY`\n   */\n  apiKey: string;\n  /**\n   * The environment to use for the Tambo API\n   */\n  environment?: \"production\" | \"staging\";\n\n  /**\n   * The user token to use to identify the user in the Tambo API. This token is\n   * a 3rd party token like a Google or GitHub access token, exchanged with the\n   * Tambo API to get a session token. This is used to securely identify the\n   * user when calling the Tambo API.\n   */\n  userToken?: string;\n\n  /**\n   * Additional headers to include in all requests to the Tambo API.\n   * These will be merged with the default headers.\n   */\n  additionalHeaders?: Record<string, string>;\n}\n\nexport interface TamboClientContextProps {\n  /** The TamboAI client */\n  client: TamboAI;\n  /** The tambo-specific query client */\n  queryClient: QueryClient;\n  /** Whether the session token is currently being updated */\n  isUpdatingToken: boolean;\n  /** Additional headers to include in all requests */\n  additionalHeaders?: Record<string, string>;\n  /** Error from token exchange, if any */\n  tokenExchangeError: Error | null;\n  /** The raw userToken value passed to the provider */\n  userToken: string | undefined;\n  /** Whether the token exchange succeeded */\n  hasValidToken: boolean;\n}\n\nexport const TamboClientContext = createContext<\n  TamboClientContextProps | undefined\n>(undefined);\n\n/**\n * The TamboClientProvider is a React provider that provides a TamboAI client\n * and a query client to the descendants of the provider.\n * @param props - The props for the TamboClientProvider\n * @param props.children - The children to wrap\n * @param props.tamboUrl - The URL of the Tambo API\n * @param props.apiKey - The API key for the Tambo API\n * @param props.environment - The environment to use for the Tambo API\n * @param props.userToken - The oauth access token to use to identify the user in the Tambo API\n * @param props.additionalHeaders - Additional headers to include in all requests\n * @returns The TamboClientProvider component\n */\nexport const TamboClientProvider: React.FC<\n  PropsWithChildren<TamboClientProviderProps>\n> = ({\n  children,\n  tamboUrl,\n  apiKey,\n  environment,\n  userToken,\n  additionalHeaders,\n}) => {\n  const tamboConfig = useMemo(\n    () =>\n      ({\n        apiKey,\n        defaultHeaders: {\n          \"X-Tambo-React-Version\": packageJson.version,\n          ...additionalHeaders,\n        },\n        baseURL: tamboUrl ?? undefined,\n        environment: environment ?? undefined,\n      }) satisfies ClientOptions,\n    [additionalHeaders, apiKey, tamboUrl, environment],\n  );\n\n  const client = useMemo(() => new TamboAI(tamboConfig), [tamboConfig]);\n  const queryClient = useMemo(() => new QueryClient(), []);\n\n  // Keep the session token updated and get the updating state\n  const {\n    isFetching: isUpdatingToken,\n    error: tokenExchangeError,\n    data: tokenData,\n  } = useTamboSessionToken(client, queryClient, userToken);\n\n  return (\n    <TamboClientContext.Provider\n      value={{\n        client,\n        queryClient,\n        isUpdatingToken,\n        additionalHeaders: tamboConfig.defaultHeaders,\n        tokenExchangeError: tokenExchangeError ?? null,\n        userToken,\n        hasValidToken: !!tokenData?.access_token,\n      }}\n    >\n      {children}\n    </TamboClientContext.Provider>\n  );\n};\n\n/**\n * The useTamboClient hook provides access to the TamboAI client\n * to the descendants of the TamboClientProvider.\n * @returns The TamboAI client\n */\nexport const useTamboClient = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\"useTamboClient must be used within a TamboClientProvider\");\n  }\n  return context.client;\n};\n\n/**\n * The useTamboQueryClient hook provides access to the tambo-specific query client\n * to the descendants of the TamboClientProvider.\n * @returns The tambo-specific query client\n * @private\n */\nexport const useTamboQueryClient = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useTamboQueryClient must be used within a TamboClientProvider\",\n    );\n  }\n  return context.queryClient;\n};\n\n/**\n * Hook to check if the session token is currently being updated\n * @returns true if the token is being refreshed, false otherwise\n */\nexport const useIsTamboTokenUpdating = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useIsTamboTokenUpdating must be used within a TamboClientProvider\",\n    );\n  }\n  return context.isUpdatingToken;\n};\n"]}
+{"version":3,"file":"tambo-client-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-client-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport TamboAI, { ClientOptions } from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport React, { createContext, PropsWithChildren, useMemo } from \"react\";\nimport packageJson from \"../../package.json\";\nimport { useTamboSessionToken } from \"./hooks/use-tambo-session-token\";\n\nexport interface TamboClientProviderProps {\n  /**\n   * The URL of the Tambo API (only used for local development and debugging)\n   */\n  tamboUrl?: string;\n  /**\n   * The API key for the Tambo API. This typically comes from a variable like\n   * `process.env.NEXT_PUBLIC_TAMBO_API_KEY`\n   */\n  apiKey: string;\n  /**\n   * The environment to use for the Tambo API\n   */\n  environment?: \"production\" | \"staging\";\n\n  /**\n   * The user token to use to identify the user in the Tambo API. This token is\n   * a 3rd party token like a Google or GitHub access token, exchanged with the\n   * Tambo API to get a session token. This is used to securely identify the\n   * user when calling the Tambo API.\n   */\n  userToken?: string;\n\n  /**\n   * Additional headers to include in all requests to the Tambo API.\n   * These will be merged with the default headers.\n   */\n  additionalHeaders?: Record<string, string>;\n\n  /**\n   * User key sent as a default query parameter on all API requests.\n   * Required if no bearer token (userToken) is provided.\n   */\n  userKey?: string;\n}\n\nexport interface TamboClientContextProps {\n  /** The TamboAI client */\n  client: TamboAI;\n  /** The tambo-specific query client */\n  queryClient: QueryClient;\n  /** Whether the session token is currently being updated */\n  isUpdatingToken: boolean;\n  /** Additional headers to include in all requests */\n  additionalHeaders?: Record<string, string>;\n  /** Error from token exchange, if any */\n  tokenExchangeError: Error | null;\n  /** The raw userToken value passed to the provider */\n  userToken: string | undefined;\n  /** Whether the token exchange succeeded */\n  hasValidToken: boolean;\n}\n\nexport const TamboClientContext = createContext<\n  TamboClientContextProps | undefined\n>(undefined);\n\n/**\n * The TamboClientProvider is a React provider that provides a TamboAI client\n * and a query client to the descendants of the provider.\n * @param props - The props for the TamboClientProvider\n * @param props.children - The children to wrap\n * @param props.tamboUrl - The URL of the Tambo API\n * @param props.apiKey - The API key for the Tambo API\n * @param props.environment - The environment to use for the Tambo API\n * @param props.userToken - The oauth access token to use to identify the user in the Tambo API\n * @param props.additionalHeaders - Additional headers to include in all requests\n * @param props.userKey - User key sent as a default query parameter on all API requests\n * @returns The TamboClientProvider component\n */\nexport const TamboClientProvider: React.FC<\n  PropsWithChildren<TamboClientProviderProps>\n> = ({\n  children,\n  tamboUrl,\n  apiKey,\n  environment,\n  userToken,\n  additionalHeaders,\n  userKey,\n}) => {\n  const tamboConfig = useMemo(\n    () =>\n      ({\n        apiKey,\n        defaultHeaders: {\n          \"X-Tambo-React-Version\": packageJson.version,\n          ...additionalHeaders,\n        },\n        defaultQuery: userKey ? { userKey } : undefined,\n        baseURL: tamboUrl ?? undefined,\n        environment: environment ?? undefined,\n      }) satisfies ClientOptions,\n    [additionalHeaders, apiKey, tamboUrl, environment, userKey],\n  );\n\n  const client = useMemo(() => new TamboAI(tamboConfig), [tamboConfig]);\n  const queryClient = useMemo(() => new QueryClient(), []);\n\n  // Keep the session token updated and get the updating state\n  const {\n    isFetching: isUpdatingToken,\n    error: tokenExchangeError,\n    data: tokenData,\n  } = useTamboSessionToken(client, queryClient, userToken);\n\n  return (\n    <TamboClientContext.Provider\n      value={{\n        client,\n        queryClient,\n        isUpdatingToken,\n        additionalHeaders: tamboConfig.defaultHeaders,\n        tokenExchangeError: tokenExchangeError ?? null,\n        userToken,\n        hasValidToken: !!tokenData?.access_token,\n      }}\n    >\n      {children}\n    </TamboClientContext.Provider>\n  );\n};\n\n/**\n * The useTamboClient hook provides access to the TamboAI client\n * to the descendants of the TamboClientProvider.\n * @returns The TamboAI client\n */\nexport const useTamboClient = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\"useTamboClient must be used within a TamboClientProvider\");\n  }\n  return context.client;\n};\n\n/**\n * The useTamboQueryClient hook provides access to the tambo-specific query client\n * to the descendants of the TamboClientProvider.\n * @returns The tambo-specific query client\n * @private\n */\nexport const useTamboQueryClient = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useTamboQueryClient must be used within a TamboClientProvider\",\n    );\n  }\n  return context.queryClient;\n};\n\n/**\n * Hook to check if the session token is currently being updated\n * @returns true if the token is being refreshed, false otherwise\n */\nexport const useIsTamboTokenUpdating = () => {\n  const context = React.useContext(TamboClientContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useIsTamboTokenUpdating must be used within a TamboClientProvider\",\n    );\n  }\n  return context.isUpdatingToken;\n};\n"]}

package/dist/providers/tambo-interactable-provider.d.ts

@@ -36,7 +36,7 @@ export declare const useCurrentInteractablesSnapshot: () => {
     propsSchema?: import("../schema").SupportedSchema;
     propsDefinition?: any;
     loadingComponent?: React.ComponentType<any>;
-    associatedTools?: import(".").TamboTool[];
+    associatedTools?: import("..").TamboTool[];
     annotations?: import("..").ToolAnnotations;
 }[];
 export {};

package/dist/providers/tambo-interactables-additional-context-edge-cases.test.js

@@ -9,17 +9,9 @@ const v4_1 = require("zod/v4");
 const with_tambo_interactable_1 = require("../hoc/with-tambo-interactable");
 const tambo_context_helpers_provider_1 = require("./tambo-context-helpers-provider");
 const tambo_interactable_provider_1 = require("./tambo-interactable-provider");
-const tambo_stubs_1 = require("./tambo-stubs");
+const tambo_v1_stub_provider_1 = require("../v1/providers/tambo-v1-stub-provider");
 function wrapperWithProviders(children) {
-    const thread = {
-        id: "t-1",
-        projectId: "p-1",
-        createdAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
-        messages: [],
-        metadata: {},
-    };
-    return (react_2.default.createElement(tambo_stubs_1.TamboStubProvider, { thread: thread, registerTool: () => { }, registerTools: () => { }, registerComponent: () => { }, addToolAssociation: () => { } },
+    return (react_2.default.createElement(tambo_v1_stub_provider_1.TamboStubProvider, null,
         react_2.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, null, children)));
 }
 describe("Interactables AdditionalContext - Edge Cases & Advanced Scenarios", () => {

package/dist/providers/tambo-interactables-additional-context-edge-cases.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-interactables-additional-context-edge-cases.test.js","sourceRoot":"","sources":["../../src/providers/tambo-interactables-additional-context-edge-cases.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod/v4\";\nimport { withTamboInteractable } from \"../hoc/with-tambo-interactable\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"./tambo-interactable-provider\";\nimport { TamboStubProvider } from \"./tambo-stubs\";\n\nfunction wrapperWithProviders(children: React.ReactNode) {\n  const thread = {\n    id: \"t-1\",\n    projectId: \"p-1\",\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n    messages: [],\n    metadata: {},\n  } as any;\n\n  return (\n    <TamboStubProvider\n      thread={thread}\n      registerTool={() => {}}\n      registerTools={() => {}}\n      registerComponent={() => {}}\n      addToolAssociation={() => {}}\n    >\n      <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n    </TamboStubProvider>\n  );\n}\n\ndescribe(\"Interactables AdditionalContext - Edge Cases & Advanced Scenarios\", () => {\n  test(\"handles components without propsSchema gracefully\", async () => {\n    const SimpleComponent: React.FC<{ text: string }> = ({ text }) => (\n      <div>{text}</div>\n    );\n\n    const InteractableSimpleComponent = withTamboInteractable(SimpleComponent, {\n      componentName: \"SimpleComponent\",\n      description: \"A component without schema\",\n      // No propsSchema provided\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableSimpleComponent text=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      const component = entry!.context.components[0];\n      expect(component.propsSchema).toBe(\"Not specified\");\n    });\n  });\n\n  test(\"handles component unmounting and remounting correctly\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        const interval = setInterval(() => {\n          void getAdditionalContext().then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          });\n        }, 50);\n        return () => {\n          mounted = false;\n          clearInterval(interval);\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const Host = () => {\n      const [showNote, setShowNote] = React.useState(true);\n\n      React.useEffect(() => {\n        // Toggle the note on/off to test unmounting\n        const timeout = setTimeout(() => setShowNote(false), 100);\n        const timeout2 = setTimeout(() => setShowNote(true), 200);\n        return () => {\n          clearTimeout(timeout);\n          clearTimeout(timeout2);\n        };\n      }, []);\n\n      return (\n        <TamboInteractableProvider>\n          {showNote && <InteractableNote title=\"dynamic note\" />}\n          <TestComponent />\n        </TamboInteractableProvider>\n      );\n    };\n\n    const { getByTestId } = render(wrapperWithProviders(<Host />));\n\n    await waitFor(\n      () => {\n        expect(getByTestId(\"ready\")).toBeInTheDocument();\n      },\n      { timeout: 1000 },\n    );\n\n    // Eventually should show the note again\n    await waitFor(\n      () => {\n        const entry = capturedContexts.find(\n          (c: any) => c.name === \"interactables\",\n        );\n        expect(entry?.context?.components).toHaveLength(1);\n      },\n      { timeout: 1000 },\n    );\n  });\n\n  test(\"context helper updates when props change from parent\", async () => {\n    const Counter: React.FC<{ count: number; label?: string }> = ({\n      count,\n      label = \"Count\",\n    }) => (\n      <div>\n        {label}: {count}\n      </div>\n    );\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter component\",\n      propsSchema: z.object({\n        count: z.number(),\n        label: z.string().optional(),\n      }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        const interval = setInterval(() => {\n          void getAdditionalContext().then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          });\n        }, 50);\n        return () => {\n          mounted = false;\n          clearInterval(interval);\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const Host = () => {\n      const [count, setCount] = React.useState(0);\n      const [label, setLabel] = React.useState(\"Items\");\n\n      React.useEffect(() => {\n        const timeout1 = setTimeout(() => setCount(5), 100);\n        const timeout2 = setTimeout(() => setLabel(\"Updated Items\"), 200);\n        return () => {\n          clearTimeout(timeout1);\n          clearTimeout(timeout2);\n        };\n      }, []);\n\n      return (\n        <TamboInteractableProvider>\n          <InteractableCounter count={count} label={label} />\n          <TestComponent />\n        </TamboInteractableProvider>\n      );\n    };\n\n    const { getByTestId } = render(wrapperWithProviders(<Host />));\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n    });\n\n    // Wait for updates to propagate\n    await waitFor(\n      () => {\n        const entry = capturedContexts.find(\n          (c: any) => c.name === \"interactables\",\n        );\n        if (entry?.context?.components?.[0]) {\n          const props = entry.context.components[0].props;\n          expect(props.count).toBe(5);\n          expect(props.label).toBe(\"Updated Items\");\n        }\n      },\n      { timeout: 1000 },\n    );\n  });\n\n  test(\"multiple providers with nested context helpers work correctly\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let outerContexts: any[] = [];\n    let innerContexts: any[] = [];\n\n    const OuterTestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            outerContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"outer-ready\">outer ready</div>;\n    };\n\n    const InnerTestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            innerContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"inner-ready\">inner ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"outer note\" />\n          <OuterTestComponent />\n          <TamboContextHelpersProvider\n            contextHelpers={{\n              customContext: () => ({ custom: \"inner\" }),\n            }}\n          >\n            <TamboInteractableProvider>\n              <InteractableNote title=\"inner note\" />\n              <InnerTestComponent />\n            </TamboInteractableProvider>\n          </TamboContextHelpersProvider>\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"outer-ready\")).toBeInTheDocument();\n      expect(getByTestId(\"inner-ready\")).toBeInTheDocument();\n    });\n\n    await waitFor(() => {\n      // Outer context should have outer note\n      const outerEntry = outerContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(outerEntry?.context?.components).toHaveLength(1);\n      expect(outerEntry?.context?.components[0]?.props?.title).toBe(\n        \"outer note\",\n      );\n\n      // Inner context should have inner note and custom context\n      const innerEntry = innerContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(innerEntry?.context?.components).toHaveLength(1);\n      expect(innerEntry?.context?.components[0]?.props?.title).toBe(\n        \"inner note\",\n      );\n\n      const customEntry = innerContexts.find(\n        (c: any) => c.name === \"customContext\",\n      );\n      expect(customEntry?.context).toEqual({ custom: \"inner\" });\n    });\n  });\n\n  test(\"provider cleanup removes helper when last provider unmounts\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        const interval = setInterval(() => {\n          void getAdditionalContext().then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          });\n        }, 50);\n        return () => {\n          mounted = false;\n          clearInterval(interval);\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const Host = () => {\n      const [showProvider, setShowProvider] = React.useState(true);\n\n      React.useEffect(() => {\n        const timeout = setTimeout(() => setShowProvider(false), 200);\n        return () => clearTimeout(timeout);\n      }, []);\n\n      return (\n        <>\n          {showProvider && (\n            <TamboInteractableProvider>\n              <InteractableNote title=\"will disappear\" />\n            </TamboInteractableProvider>\n          )}\n          <TestComponent />\n        </>\n      );\n    };\n\n    const { getByTestId } = render(wrapperWithProviders(<Host />));\n\n    // Initially should have the context\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n    });\n\n    // After provider unmounts, context should be gone\n    await waitFor(\n      () => {\n        const entry = capturedContexts.find(\n          (c: any) => c.name === \"interactables\",\n        );\n        expect(entry).toBeUndefined();\n      },\n      { timeout: 1000 },\n    );\n  });\n\n  test(\"helper error handling doesn't crash the system\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    // Mock console.error to capture error logs\n    const consoleSpy = jest\n      .spyOn(console, \"error\")\n      .mockImplementation(() => {});\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext, addContextHelper } =\n        useTamboContextHelpers();\n\n      React.useEffect(() => {\n        // Add a helper that throws an error\n        addContextHelper(\"errorHelper\", () => {\n          throw new Error(\"Test error in helper\");\n        });\n      }, [addContextHelper]);\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext()\n          .then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          })\n          .catch(() => {\n            // Should not reach here - errors should be handled gracefully\n          });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      // Should still have the interactables context despite the error\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n\n      // Error helper should not be present (filtered out)\n      const errorEntry = capturedContexts.find(\n        (c: any) => c.name === \"errorHelper\",\n      );\n      expect(errorEntry).toBeUndefined();\n    });\n\n    consoleSpy.mockRestore();\n  });\n});\n"]}
+{"version":3,"file":"tambo-interactables-additional-context-edge-cases.test.js","sourceRoot":"","sources":["../../src/providers/tambo-interactables-additional-context-edge-cases.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod/v4\";\nimport { withTamboInteractable } from \"../hoc/with-tambo-interactable\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"./tambo-interactable-provider\";\nimport { TamboStubProvider } from \"../v1/providers/tambo-v1-stub-provider\";\n\nfunction wrapperWithProviders(children: React.ReactNode) {\n  return (\n    <TamboStubProvider>\n      <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n    </TamboStubProvider>\n  );\n}\n\ndescribe(\"Interactables AdditionalContext - Edge Cases & Advanced Scenarios\", () => {\n  test(\"handles components without propsSchema gracefully\", async () => {\n    const SimpleComponent: React.FC<{ text: string }> = ({ text }) => (\n      <div>{text}</div>\n    );\n\n    const InteractableSimpleComponent = withTamboInteractable(SimpleComponent, {\n      componentName: \"SimpleComponent\",\n      description: \"A component without schema\",\n      // No propsSchema provided\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableSimpleComponent text=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      const component = entry!.context.components[0];\n      expect(component.propsSchema).toBe(\"Not specified\");\n    });\n  });\n\n  test(\"handles component unmounting and remounting correctly\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        const interval = setInterval(() => {\n          void getAdditionalContext().then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          });\n        }, 50);\n        return () => {\n          mounted = false;\n          clearInterval(interval);\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const Host = () => {\n      const [showNote, setShowNote] = React.useState(true);\n\n      React.useEffect(() => {\n        // Toggle the note on/off to test unmounting\n        const timeout = setTimeout(() => setShowNote(false), 100);\n        const timeout2 = setTimeout(() => setShowNote(true), 200);\n        return () => {\n          clearTimeout(timeout);\n          clearTimeout(timeout2);\n        };\n      }, []);\n\n      return (\n        <TamboInteractableProvider>\n          {showNote && <InteractableNote title=\"dynamic note\" />}\n          <TestComponent />\n        </TamboInteractableProvider>\n      );\n    };\n\n    const { getByTestId } = render(wrapperWithProviders(<Host />));\n\n    await waitFor(\n      () => {\n        expect(getByTestId(\"ready\")).toBeInTheDocument();\n      },\n      { timeout: 1000 },\n    );\n\n    // Eventually should show the note again\n    await waitFor(\n      () => {\n        const entry = capturedContexts.find(\n          (c: any) => c.name === \"interactables\",\n        );\n        expect(entry?.context?.components).toHaveLength(1);\n      },\n      { timeout: 1000 },\n    );\n  });\n\n  test(\"context helper updates when props change from parent\", async () => {\n    const Counter: React.FC<{ count: number; label?: string }> = ({\n      count,\n      label = \"Count\",\n    }) => (\n      <div>\n        {label}: {count}\n      </div>\n    );\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter component\",\n      propsSchema: z.object({\n        count: z.number(),\n        label: z.string().optional(),\n      }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        const interval = setInterval(() => {\n          void getAdditionalContext().then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          });\n        }, 50);\n        return () => {\n          mounted = false;\n          clearInterval(interval);\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const Host = () => {\n      const [count, setCount] = React.useState(0);\n      const [label, setLabel] = React.useState(\"Items\");\n\n      React.useEffect(() => {\n        const timeout1 = setTimeout(() => setCount(5), 100);\n        const timeout2 = setTimeout(() => setLabel(\"Updated Items\"), 200);\n        return () => {\n          clearTimeout(timeout1);\n          clearTimeout(timeout2);\n        };\n      }, []);\n\n      return (\n        <TamboInteractableProvider>\n          <InteractableCounter count={count} label={label} />\n          <TestComponent />\n        </TamboInteractableProvider>\n      );\n    };\n\n    const { getByTestId } = render(wrapperWithProviders(<Host />));\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n    });\n\n    // Wait for updates to propagate\n    await waitFor(\n      () => {\n        const entry = capturedContexts.find(\n          (c: any) => c.name === \"interactables\",\n        );\n        if (entry?.context?.components?.[0]) {\n          const props = entry.context.components[0].props;\n          expect(props.count).toBe(5);\n          expect(props.label).toBe(\"Updated Items\");\n        }\n      },\n      { timeout: 1000 },\n    );\n  });\n\n  test(\"multiple providers with nested context helpers work correctly\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let outerContexts: any[] = [];\n    let innerContexts: any[] = [];\n\n    const OuterTestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            outerContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"outer-ready\">outer ready</div>;\n    };\n\n    const InnerTestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            innerContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"inner-ready\">inner ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"outer note\" />\n          <OuterTestComponent />\n          <TamboContextHelpersProvider\n            contextHelpers={{\n              customContext: () => ({ custom: \"inner\" }),\n            }}\n          >\n            <TamboInteractableProvider>\n              <InteractableNote title=\"inner note\" />\n              <InnerTestComponent />\n            </TamboInteractableProvider>\n          </TamboContextHelpersProvider>\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"outer-ready\")).toBeInTheDocument();\n      expect(getByTestId(\"inner-ready\")).toBeInTheDocument();\n    });\n\n    await waitFor(() => {\n      // Outer context should have outer note\n      const outerEntry = outerContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(outerEntry?.context?.components).toHaveLength(1);\n      expect(outerEntry?.context?.components[0]?.props?.title).toBe(\n        \"outer note\",\n      );\n\n      // Inner context should have inner note and custom context\n      const innerEntry = innerContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(innerEntry?.context?.components).toHaveLength(1);\n      expect(innerEntry?.context?.components[0]?.props?.title).toBe(\n        \"inner note\",\n      );\n\n      const customEntry = innerContexts.find(\n        (c: any) => c.name === \"customContext\",\n      );\n      expect(customEntry?.context).toEqual({ custom: \"inner\" });\n    });\n  });\n\n  test(\"provider cleanup removes helper when last provider unmounts\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        const interval = setInterval(() => {\n          void getAdditionalContext().then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          });\n        }, 50);\n        return () => {\n          mounted = false;\n          clearInterval(interval);\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const Host = () => {\n      const [showProvider, setShowProvider] = React.useState(true);\n\n      React.useEffect(() => {\n        const timeout = setTimeout(() => setShowProvider(false), 200);\n        return () => clearTimeout(timeout);\n      }, []);\n\n      return (\n        <>\n          {showProvider && (\n            <TamboInteractableProvider>\n              <InteractableNote title=\"will disappear\" />\n            </TamboInteractableProvider>\n          )}\n          <TestComponent />\n        </>\n      );\n    };\n\n    const { getByTestId } = render(wrapperWithProviders(<Host />));\n\n    // Initially should have the context\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n    });\n\n    // After provider unmounts, context should be gone\n    await waitFor(\n      () => {\n        const entry = capturedContexts.find(\n          (c: any) => c.name === \"interactables\",\n        );\n        expect(entry).toBeUndefined();\n      },\n      { timeout: 1000 },\n    );\n  });\n\n  test(\"helper error handling doesn't crash the system\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    // Mock console.error to capture error logs\n    const consoleSpy = jest\n      .spyOn(console, \"error\")\n      .mockImplementation(() => {});\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext, addContextHelper } =\n        useTamboContextHelpers();\n\n      React.useEffect(() => {\n        // Add a helper that throws an error\n        addContextHelper(\"errorHelper\", () => {\n          throw new Error(\"Test error in helper\");\n        });\n      }, [addContextHelper]);\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext()\n          .then((contexts) => {\n            if (mounted) {\n              capturedContexts = contexts;\n            }\n          })\n          .catch(() => {\n            // Should not reach here - errors should be handled gracefully\n          });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      // Should still have the interactables context despite the error\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n\n      // Error helper should not be present (filtered out)\n      const errorEntry = capturedContexts.find(\n        (c: any) => c.name === \"errorHelper\",\n      );\n      expect(errorEntry).toBeUndefined();\n    });\n\n    consoleSpy.mockRestore();\n  });\n});\n"]}

package/dist/providers/tambo-interactables-additional-context.test.js

@@ -9,17 +9,9 @@ const v4_1 = require("zod/v4");
 const with_tambo_interactable_1 = require("../hoc/with-tambo-interactable");
 const tambo_context_helpers_provider_1 = require("./tambo-context-helpers-provider");
 const tambo_interactable_provider_1 = require("./tambo-interactable-provider");
-const tambo_stubs_1 = require("./tambo-stubs");
+const tambo_v1_stub_provider_1 = require("../v1/providers/tambo-v1-stub-provider");
 function wrapperWithProviders(children) {
-    const thread = {
-        id: "t-1",
-        projectId: "p-1",
-        createdAt: new Date().toISOString(),
-        updatedAt: new Date().toISOString(),
-        messages: [],
-        metadata: {},
-    };
-    return (react_2.default.createElement(tambo_stubs_1.TamboStubProvider, { thread: thread, registerTool: () => { }, registerTools: () => { }, registerComponent: () => { }, addToolAssociation: () => { } },
+    return (react_2.default.createElement(tambo_v1_stub_provider_1.TamboStubProvider, null,
         react_2.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, null, children)));
 }
 describe("Interactables AdditionalContext (provider-based)", () => {
@@ -273,15 +265,7 @@ describe("Interactables AdditionalContext (provider-based)", () => {
             }, [getAdditionalContext]);
             return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
         };
-        const thread = {
-            id: "t-1",
-            projectId: "p-1",
-            createdAt: new Date().toISOString(),
-            updatedAt: new Date().toISOString(),
-            messages: [],
-            metadata: {},
-        };
-        const { getByTestId } = (0, react_1.render)(react_2.default.createElement(tambo_stubs_1.TamboStubProvider, { thread: thread, registerTool: () => { }, registerTools: () => { }, registerComponent: () => { }, addToolAssociation: () => { } },
+        const { getByTestId } = (0, react_1.render)(react_2.default.createElement(tambo_v1_stub_provider_1.TamboStubProvider, null,
             react_2.default.createElement(DisabledContextHelpers, null,
                 react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
                     react_2.default.createElement(InteractableNote, { title: "should not appear" }),

package/dist/providers/tambo-interactables-additional-context.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-interactables-additional-context.test.js","sourceRoot":"","sources":["../../src/providers/tambo-interactables-additional-context.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod/v4\";\nimport { withTamboInteractable } from \"../hoc/with-tambo-interactable\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport {\n  TamboInteractableProvider,\n  useCurrentInteractablesSnapshot,\n} from \"./tambo-interactable-provider\";\nimport { TamboStubProvider } from \"./tambo-stubs\";\n\nfunction wrapperWithProviders(children: React.ReactNode) {\n  const thread = {\n    id: \"t-1\",\n    projectId: \"p-1\",\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n    messages: [],\n    metadata: {},\n  } as any;\n\n  return (\n    <TamboStubProvider\n      thread={thread}\n      registerTool={() => {}}\n      registerTools={() => {}}\n      registerComponent={() => {}}\n      addToolAssociation={() => {}}\n    >\n      <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n    </TamboStubProvider>\n  );\n}\n\ndescribe(\"Interactables AdditionalContext (provider-based)\", () => {\n  test(\"registers default helper and returns payload with description and components\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"hello\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      expect(Array.isArray(entry?.context?.components)).toBe(true);\n      const comp = entry!.context.components[0];\n      expect(comp.componentName).toBe(\"Note\");\n      expect(comp.props).toEqual({ title: \"hello\" });\n    });\n  });\n\n  test(\"returns null when no interactable components are present\", async () => {\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <div>No interactables here</div>\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeUndefined(); // Should be filtered out when helper returns null\n    });\n  });\n\n  test(\"context includes proper AI prompt with clear instructions\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A simple note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      expect(Array.isArray(entry?.context?.components)).toBe(true);\n    });\n  });\n\n  test(\"includes component metadata in expected format\", async () => {\n    const Note: React.FC<{ title: string; color?: string }> = ({\n      title,\n      color = \"white\",\n    }) => <div className={`note-${color}`}>{title}</div>;\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A colorful note component\",\n      propsSchema: z.object({\n        title: z.string(),\n        color: z.string().optional(),\n      }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test note\" color=\"blue\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      const component = entry!.context.components[0];\n\n      expect(component).toMatchObject({\n        id: expect.any(String),\n        componentName: \"Note\",\n        description: \"A colorful note component\",\n        props: { title: \"test note\", color: \"blue\" },\n        propsSchema: \"Available - use component-specific update tools\",\n      });\n    });\n  });\n\n  test(\"snapshot hook returns immutable copies\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    const TestComponent = () => {\n      const snapshot = useCurrentInteractablesSnapshot();\n      const [testResult, setTestResult] = React.useState<string>(\"pending\");\n\n      React.useEffect(() => {\n        if (snapshot.length > 0) {\n          const originalLength = snapshot.length;\n\n          // Try to mutate the returned array and props\n          snapshot.push({\n            id: \"fake\",\n            name: \"Fake\",\n            description: \"\",\n            component: () => null,\n            props: {},\n          } as any);\n          (snapshot[0].props as any).title = \"MUTATED\";\n\n          // The mutations should succeed on the returned copy, proving it's a separate object\n          if (\n            snapshot.length === originalLength + 1 &&\n            snapshot[0].props.title === \"MUTATED\"\n          ) {\n            setTestResult(\"mutation-successful-but-isolated\");\n          } else {\n            setTestResult(\"mutation-failed\");\n          }\n        }\n      }, [snapshot]);\n\n      return <div data-testid=\"test-result\">{testResult}</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"immutable test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      const result = getByTestId(\"test-result\").textContent;\n      expect(result).toBe(\"mutation-successful-but-isolated\");\n    });\n  });\n\n  test(\"multiple interactables from same provider appear in context\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const Counter: React.FC<{ count: number }> = ({ count }) => (\n      <div>{count}</div>\n    );\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter\",\n      propsSchema: z.object({ count: z.number() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"first\" />\n          <InteractableCounter count={42} />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry?.context?.components).toHaveLength(2);\n\n      const components = entry!.context.components;\n      expect(components[0].componentName).toBe(\"Note\");\n      expect(components[0].props).toEqual({ title: \"first\" });\n      expect(components[1].componentName).toBe(\"Counter\");\n      expect(components[1].props).toEqual({ count: 42 });\n    });\n  });\n\n  test(\"can be disabled by returning null\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    // Create a context helpers provider with a disabled interactables helper\n    const DisabledContextHelpers = ({\n      children,\n    }: {\n      children: React.ReactNode;\n    }) => (\n      <TamboContextHelpersProvider\n        contextHelpers={{\n          [\"interactables\"]: () => null,\n        }}\n      >\n        {children}\n      </TamboContextHelpersProvider>\n    );\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const thread = {\n      id: \"t-1\",\n      projectId: \"p-1\",\n      createdAt: new Date().toISOString(),\n      updatedAt: new Date().toISOString(),\n      messages: [],\n      metadata: {},\n    } as any;\n\n    const { getByTestId } = render(\n      <TamboStubProvider\n        thread={thread}\n        registerTool={() => {}}\n        registerTools={() => {}}\n        registerComponent={() => {}}\n        addToolAssociation={() => {}}\n      >\n        <DisabledContextHelpers>\n          <TamboInteractableProvider>\n            <InteractableNote title=\"should not appear\" />\n            <TestComponent />\n          </TamboInteractableProvider>\n        </DisabledContextHelpers>\n      </TamboStubProvider>,\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeUndefined(); // Should be filtered out when helper returns null\n    });\n  });\n});\n"]}
+{"version":3,"file":"tambo-interactables-additional-context.test.js","sourceRoot":"","sources":["../../src/providers/tambo-interactables-additional-context.test.tsx"],"names":[],"mappings":";;;;;AAAA,kDAAyD;AACzD,kDAA0B;AAC1B,+BAA2B;AAC3B,4EAAuE;AACvE,qFAG0C;AAC1C,+EAGuC;AACvC,mFAA2E;AAE3E,SAAS,oBAAoB,CAAC,QAAyB;IACrD,OAAO,CACL,8BAAC,0CAAiB;QAChB,8BAAC,4DAA2B,QAAE,QAAQ,CAA+B,CACnD,CACrB,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAChE,IAAI,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC9F,MAAM,IAAI,GAAgC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,2CAAM,KAAK,CAAO,CAAC;QAE5E,MAAM,gBAAgB,GAAG,IAAA,+CAAqB,EAAC,IAAI,EAAE;YACnD,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,IAAI,gBAAgB,GAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAA,uDAAsB,GAAE,CAAC;YAE1D,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,GAAG,QAAQ,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC;YACJ,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAE3B,OAAO,sDAAiB,OAAO,YAAY,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,oBAAoB,CAClB,8BAAC,uDAAyB;YACxB,8BAAC,gBAAgB,IAAC,KAAK,EAAC,OAAO,GAAG;YAClC,8BAAC,aAAa,OAAG,CACS,CAC7B,CACF,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CACvC,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,KAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QAC1E,IAAI,gBAAgB,GAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAA,uDAAsB,GAAE,CAAC;YAE1D,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,GAAG,QAAQ,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC;YACJ,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAE3B,OAAO,sDAAiB,OAAO,YAAY,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,oBAAoB,CAClB,8BAAC,uDAAyB;YACxB,mEAAgC;YAChC,8BAAC,aAAa,OAAG,CACS,CAC7B,CACF,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CACvC,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,kDAAkD;QACnF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,IAAI,GAAgC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,2CAAM,KAAK,CAAO,CAAC;QAC5E,MAAM,gBAAgB,GAAG,IAAA,+CAAqB,EAAC,IAAI,EAAE;YACnD,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,eAAe;YAC5B,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,IAAI,gBAAgB,GAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAA,uDAAsB,GAAE,CAAC;YAE1D,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,GAAG,QAAQ,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC;YACJ,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAE3B,OAAO,sDAAiB,OAAO,YAAY,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,oBAAoB,CAClB,8BAAC,uDAAyB;YACxB,8BAAC,gBAAgB,IAAC,KAAK,EAAC,MAAM,GAAG;YACjC,8BAAC,aAAa,OAAG,CACS,CAC7B,CACF,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CACvC,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAgD,CAAC,EACzD,KAAK,EACL,KAAK,GAAG,OAAO,GAChB,EAAE,EAAE,CAAC,uCAAK,SAAS,EAAE,QAAQ,KAAK,EAAE,IAAG,KAAK,CAAO,CAAC;QAErD,MAAM,gBAAgB,GAAG,IAAA,+CAAqB,EAAC,IAAI,EAAE;YACnD,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,2BAA2B;YACxC,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE;gBACjB,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC7B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,gBAAgB,GAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAA,uDAAsB,GAAE,CAAC;YAE1D,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,GAAG,QAAQ,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC;YACJ,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAE3B,OAAO,sDAAiB,OAAO,YAAY,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,oBAAoB,CAClB,8BAAC,uDAAyB;YACxB,8BAAC,gBAAgB,IAAC,KAAK,EAAC,WAAW,EAAC,KAAK,EAAC,MAAM,GAAG;YACnD,8BAAC,aAAa,OAAG,CACS,CAC7B,CACF,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CACvC,CAAC;YACF,MAAM,SAAS,GAAG,KAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAE/C,MAAM,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC;gBAC9B,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;gBACtB,aAAa,EAAE,MAAM;gBACrB,WAAW,EAAE,2BAA2B;gBACxC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC5C,WAAW,EAAE,iDAAiD;aAC/D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAgC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,2CAAM,KAAK,CAAO,CAAC;QAC5E,MAAM,gBAAgB,GAAG,IAAA,+CAAqB,EAAC,IAAI,EAAE;YACnD,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,GAAE,CAAC;YACnD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,eAAK,CAAC,QAAQ,CAAS,SAAS,CAAC,CAAC;YAEtE,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;oBAEvC,6CAA6C;oBAC7C,QAAQ,CAAC,IAAI,CAAC;wBACZ,EAAE,EAAE,MAAM;wBACV,IAAI,EAAE,MAAM;wBACZ,WAAW,EAAE,EAAE;wBACf,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;wBACrB,KAAK,EAAE,EAAE;qBACH,CAAC,CAAC;oBACT,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAa,CAAC,KAAK,GAAG,SAAS,CAAC;oBAE7C,oFAAoF;oBACpF,IACE,QAAQ,CAAC,MAAM,KAAK,cAAc,GAAG,CAAC;wBACtC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EACrC,CAAC;wBACD,aAAa,CAAC,kCAAkC,CAAC,CAAC;oBACpD,CAAC;yBAAM,CAAC;wBACN,aAAa,CAAC,iBAAiB,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAEf,OAAO,sDAAiB,aAAa,IAAE,UAAU,CAAO,CAAC;QAC3D,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,oBAAoB,CAClB,8BAAC,uDAAyB;YACxB,8BAAC,gBAAgB,IAAC,KAAK,EAAC,gBAAgB,GAAG;YAC3C,8BAAC,aAAa,OAAG,CACS,CAC7B,CACF,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,IAAI,GAAgC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,2CAAM,KAAK,CAAO,CAAC;QAC5E,MAAM,OAAO,GAAgC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAC1D,2CAAM,KAAK,CAAO,CACnB,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAA,+CAAqB,EAAC,IAAI,EAAE;YACnD,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,MAAM,mBAAmB,GAAG,IAAA,+CAAqB,EAAC,OAAO,EAAE;YACzD,aAAa,EAAE,SAAS;YACxB,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,IAAI,gBAAgB,GAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAA,uDAAsB,GAAE,CAAC;YAE1D,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,GAAG,QAAQ,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC;YACJ,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAE3B,OAAO,sDAAiB,OAAO,YAAY,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,oBAAoB,CAClB,8BAAC,uDAAyB;YACxB,8BAAC,gBAAgB,IAAC,KAAK,EAAC,OAAO,GAAG;YAClC,8BAAC,mBAAmB,IAAC,KAAK,EAAE,EAAE,GAAI;YAClC,8BAAC,aAAa,OAAG,CACS,CAC7B,CACF,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CACvC,CAAC;YACF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAEnD,MAAM,UAAU,GAAG,KAAM,CAAC,OAAO,CAAC,UAAU,CAAC;YAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACxD,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpD,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,IAAI,GAAgC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,2CAAM,KAAK,CAAO,CAAC;QAC5E,MAAM,gBAAgB,GAAG,IAAA,+CAAqB,EAAC,IAAI,EAAE;YACnD,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,MAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,yEAAyE;QACzE,MAAM,sBAAsB,GAAG,CAAC,EAC9B,QAAQ,GAGT,EAAE,EAAE,CAAC,CACJ,8BAAC,4DAA2B,IAC1B,cAAc,EAAE;gBACd,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI;aAC9B,IAEA,QAAQ,CACmB,CAC/B,CAAC;QAEF,IAAI,gBAAgB,GAAU,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAA,uDAAsB,GAAE,CAAC;YAE1D,eAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,OAAO,GAAG,IAAI,CAAC;gBACnB,KAAK,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5C,IAAI,OAAO,EAAE,CAAC;wBACZ,gBAAgB,GAAG,QAAQ,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,OAAO,GAAG,KAAK,CAAC;gBAClB,CAAC,CAAC;YACJ,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAE3B,OAAO,sDAAiB,OAAO,YAAY,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,cAAM,EAC5B,8BAAC,0CAAiB;YAChB,8BAAC,sBAAsB;gBACrB,8BAAC,uDAAyB;oBACxB,8BAAC,gBAAgB,IAAC,KAAK,EAAC,mBAAmB,GAAG;oBAC9C,8BAAC,aAAa,OAAG,CACS,CACL,CACP,CACrB,CAAC;QAEF,MAAM,IAAA,eAAO,EAAC,GAAG,EAAE;YACjB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CACjC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CACvC,CAAC;YACF,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,kDAAkD;QACnF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod/v4\";\nimport { withTamboInteractable } from \"../hoc/with-tambo-interactable\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport {\n  TamboInteractableProvider,\n  useCurrentInteractablesSnapshot,\n} from \"./tambo-interactable-provider\";\nimport { TamboStubProvider } from \"../v1/providers/tambo-v1-stub-provider\";\n\nfunction wrapperWithProviders(children: React.ReactNode) {\n  return (\n    <TamboStubProvider>\n      <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n    </TamboStubProvider>\n  );\n}\n\ndescribe(\"Interactables AdditionalContext (provider-based)\", () => {\n  test(\"registers default helper and returns payload with description and components\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"hello\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      expect(Array.isArray(entry?.context?.components)).toBe(true);\n      const comp = entry!.context.components[0];\n      expect(comp.componentName).toBe(\"Note\");\n      expect(comp.props).toEqual({ title: \"hello\" });\n    });\n  });\n\n  test(\"returns null when no interactable components are present\", async () => {\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <div>No interactables here</div>\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeUndefined(); // Should be filtered out when helper returns null\n    });\n  });\n\n  test(\"context includes proper AI prompt with clear instructions\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A simple note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      expect(Array.isArray(entry?.context?.components)).toBe(true);\n    });\n  });\n\n  test(\"includes component metadata in expected format\", async () => {\n    const Note: React.FC<{ title: string; color?: string }> = ({\n      title,\n      color = \"white\",\n    }) => <div className={`note-${color}`}>{title}</div>;\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A colorful note component\",\n      propsSchema: z.object({\n        title: z.string(),\n        color: z.string().optional(),\n      }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test note\" color=\"blue\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      const component = entry!.context.components[0];\n\n      expect(component).toMatchObject({\n        id: expect.any(String),\n        componentName: \"Note\",\n        description: \"A colorful note component\",\n        props: { title: \"test note\", color: \"blue\" },\n        propsSchema: \"Available - use component-specific update tools\",\n      });\n    });\n  });\n\n  test(\"snapshot hook returns immutable copies\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    const TestComponent = () => {\n      const snapshot = useCurrentInteractablesSnapshot();\n      const [testResult, setTestResult] = React.useState<string>(\"pending\");\n\n      React.useEffect(() => {\n        if (snapshot.length > 0) {\n          const originalLength = snapshot.length;\n\n          // Try to mutate the returned array and props\n          snapshot.push({\n            id: \"fake\",\n            name: \"Fake\",\n            description: \"\",\n            component: () => null,\n            props: {},\n          } as any);\n          (snapshot[0].props as any).title = \"MUTATED\";\n\n          // The mutations should succeed on the returned copy, proving it's a separate object\n          if (\n            snapshot.length === originalLength + 1 &&\n            snapshot[0].props.title === \"MUTATED\"\n          ) {\n            setTestResult(\"mutation-successful-but-isolated\");\n          } else {\n            setTestResult(\"mutation-failed\");\n          }\n        }\n      }, [snapshot]);\n\n      return <div data-testid=\"test-result\">{testResult}</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"immutable test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      const result = getByTestId(\"test-result\").textContent;\n      expect(result).toBe(\"mutation-successful-but-isolated\");\n    });\n  });\n\n  test(\"multiple interactables from same provider appear in context\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const Counter: React.FC<{ count: number }> = ({ count }) => (\n      <div>{count}</div>\n    );\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter\",\n      propsSchema: z.object({ count: z.number() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"first\" />\n          <InteractableCounter count={42} />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry?.context?.components).toHaveLength(2);\n\n      const components = entry!.context.components;\n      expect(components[0].componentName).toBe(\"Note\");\n      expect(components[0].props).toEqual({ title: \"first\" });\n      expect(components[1].componentName).toBe(\"Counter\");\n      expect(components[1].props).toEqual({ count: 42 });\n    });\n  });\n\n  test(\"can be disabled by returning null\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    // Create a context helpers provider with a disabled interactables helper\n    const DisabledContextHelpers = ({\n      children,\n    }: {\n      children: React.ReactNode;\n    }) => (\n      <TamboContextHelpersProvider\n        contextHelpers={{\n          [\"interactables\"]: () => null,\n        }}\n      >\n        {children}\n      </TamboContextHelpersProvider>\n    );\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        void getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      <TamboStubProvider>\n        <DisabledContextHelpers>\n          <TamboInteractableProvider>\n            <InteractableNote title=\"should not appear\" />\n            <TestComponent />\n          </TamboInteractableProvider>\n        </DisabledContextHelpers>\n      </TamboStubProvider>,\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeUndefined(); // Should be filtered out when helper returns null\n    });\n  });\n});\n"]}

package/dist/providers/tambo-mcp-token-provider.d.ts

@@ -1,8 +1,7 @@
-import React, { PropsWithChildren } from "react";
+import React, { type PropsWithChildren } from "react";
 export interface TamboMcpTokenContextProps {
     /**
      * The current MCP access token for the internal Tambo MCP server.
-     * Prefers thread-specific token over threadless token.
      */
     mcpAccessToken: string | null;
     /**
@@ -15,15 +14,8 @@ export interface TamboMcpTokenContextProps {
  * Provider for managing the MCP access token that is returned by the Tambo API.
  * This token is used to authenticate with the internal Tambo MCP server.
  *
- * Token selection logic:
- * - Returns the current thread's mcpAccessToken if available
- * - Returns null if no thread or thread has no token
- *
- * Token fetching:
- * - Thread-specific token: always fetched when switching to thread without token
- * - Tokens are fetched regardless of client-side MCP server configuration
- *   to support server-side MCP servers that are not visible to the provider
- * - Threadless tokens must be fetched by individual hooks/callbacks using contextKey
+ * Exposes the base URL and a null token by default. Token fetching is handled
+ * by the useTamboMcpToken hook which supports contextKey-based token retrieval.
  * @internal
  * @param props - The provider props
  * @param props.children - The children to wrap
@@ -31,13 +23,12 @@ export interface TamboMcpTokenContextProps {
  */
 export declare const TamboMcpTokenProvider: React.FC<PropsWithChildren>;
 /**
- * Hook to access the current MCP access token with optional threadless token fetching.
+ * Hook to access the current MCP access token with optional token fetching.
  *
- * Token selection logic:
- * 1. If current thread has mcpAccessToken → use thread-specific token
- * 2. Else if contextKey provided and no thread (or placeholder thread) → fetch and use threadless token
- * 3. Else → null
- * @param contextKey - Optional context key for fetching threadless tokens when not in a thread
+ * Token fetching logic:
+ * - If contextKey is provided → fetches a token using that contextKey
+ * - Otherwise → returns null
+ * @param contextKey - Optional context key for fetching tokens
  * @returns The current MCP access token and base URL
  */
 export declare const useTamboMcpToken: (contextKey?: string) => TamboMcpTokenContextProps;