@tambo-ai/react 0.41.2 → 0.42.1

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

@@ -62,7 +62,7 @@ const TamboInteractableProvider = ({ children, }) => {
     (0, react_1.useEffect)(() => {
         registerTool({
             name: "get_all_interactable_components",
-            description: "Get all currently interactable components with their details including their current props. These are components that you can interact with on behalf of the user.",
+            description: "Only use this tool if the user is asking about interactable components.Get all currently interactable components with their details including their current props. These are components that you can interact with on behalf of the user.",
             tool: () => {
                 return {
                     components: interactableComponents,

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-interactable-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-interactable-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["// react-sdk/src/providers/tambo-interactable-provider.tsx\n\"use client\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport { z } from \"zod\";\nimport {\n  TamboInteractableComponent,\n  type TamboInteractableContext,\n} from \"../model/tambo-interactable\";\nimport { useTamboComponent } from \"./tambo-component-provider\";\n\nconst TamboInteractableContext = createContext<TamboInteractableContext>({\n  interactableComponents: [],\n  addInteractableComponent: () => \"\",\n  removeInteractableComponent: () => {},\n  updateInteractableComponentProps: () => {},\n  getInteractableComponent: () => undefined,\n  getInteractableComponentsByName: () => [],\n  clearAllInteractableComponents: () => {},\n});\n\n/**\n * The TamboInteractableProvider manages a list of components that are currently\n * interactable, allowing tambo to interact with them by updating their props. It also registers tools\n * for Tambo to perform CRUD operations on the components list.\n * @param props - The props for the TamboInteractableProvider\n * @param props.children - The children to wrap\n * @returns The TamboInteractableProvider component\n */\nexport const TamboInteractableProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const [interactableComponents, setInteractableComponents] = useState<\n    TamboInteractableComponent[]\n  >([]);\n  const { registerTool } = useTamboComponent();\n\n  useEffect(() => {\n    registerTool({\n      name: \"get_all_interactable_components\",\n      description:\n        \"Get all currently interactable components with their details including their current props. These are components that you can interact with on behalf of the user.\",\n      tool: () => {\n        return {\n          components: interactableComponents,\n        };\n      },\n      toolSchema: z.function().returns(\n        z.object({\n          components: z.array(\n            z.object({\n              id: z.string(),\n              componentName: z.string(),\n              props: z.record(z.any()),\n              propsSchema: z.object({}).optional(),\n            }),\n          ),\n        }),\n      ),\n    });\n\n    registerTool({\n      name: \"get_interactable_component_by_id\",\n      description: \"Get a specific interactable component by its ID\",\n      tool: (componentId: string) => {\n        const component = interactableComponents.find(\n          (c) => c.id === componentId,\n        );\n\n        if (!component) {\n          return {\n            success: false,\n            error: `Component with ID ${componentId} not found`,\n          };\n        }\n\n        return {\n          success: true,\n          component: {\n            id: component.id,\n            componentName: component.name,\n            props: component.props,\n          },\n        };\n      },\n      toolSchema: z\n        .function()\n        .args(z.string())\n        .returns(\n          z.object({\n            success: z.boolean(),\n            component: z\n              .object({\n                id: z.string(),\n                componentName: z.string(),\n                props: z.record(z.any()),\n              })\n              .optional(),\n            error: z.string().optional(),\n          }),\n        ),\n    });\n\n    registerTool({\n      name: \"remove_interactable_component\",\n      description: \"Remove an interactable component from the system\",\n      tool: (componentId: string) => {\n        const component = interactableComponents.find(\n          (c) => c.id === componentId,\n        );\n\n        if (!component) {\n          return {\n            success: false,\n            error: `Component with ID ${componentId} not found`,\n          };\n        }\n\n        setInteractableComponents((prev) =>\n          prev.filter((c) => c.id !== componentId),\n        );\n\n        return {\n          success: true,\n          componentId,\n          removedComponent: {\n            id: component.id,\n            componentName: component.name,\n            props: component.props,\n          },\n        };\n      },\n      toolSchema: z\n        .function()\n        .args(z.string())\n        .returns(\n          z.object({\n            success: z.boolean(),\n            componentId: z.string(),\n            removedComponent: z.object({\n              id: z.string(),\n              componentName: z.string(),\n              props: z.record(z.any()),\n            }),\n            error: z.string().optional(),\n          }),\n        ),\n    });\n  }, [interactableComponents, registerTool]);\n\n  const updateInteractableComponentProps = useCallback(\n    (id: string, newProps: Record<string, any>) => {\n      let updateResult = \"Updated successfully\";\n\n      setInteractableComponents((prev) => {\n        const componentExists = prev.some((c) => c.id === id);\n\n        if (!componentExists) {\n          updateResult = `Error: Component with ID ${id} not found`;\n          return prev;\n        }\n\n        const updatedComponents = prev.map((c) =>\n          c.id === id ? { ...c, props: { ...c.props, ...newProps } } : c,\n        );\n\n        // Check if the update actually changed anything\n        const originalComponent = prev.find((c) => c.id === id);\n        const updatedComponent = updatedComponents.find((c) => c.id === id);\n\n        if (!originalComponent || !updatedComponent) {\n          updateResult = `Error: Failed to update component with ID ${id}`;\n          return prev;\n        }\n\n        // Check if props actually changed\n        const propsChanged =\n          JSON.stringify(originalComponent.props) !==\n          JSON.stringify(updatedComponent.props);\n\n        if (!propsChanged) {\n          updateResult = `Warning: No changes detected for component with ID ${id}. The update might not have worked.`;\n          return prev;\n        }\n\n        return updatedComponents;\n      });\n\n      return updateResult;\n    },\n    [],\n  );\n\n  const registerInteractableComponentUpdateTool = useCallback(\n    (component: TamboInteractableComponent) => {\n      const schemaForArgs =\n        typeof component.propsSchema === \"object\" &&\n        \"describe\" in component.propsSchema\n          ? component.propsSchema\n          : z.object({});\n\n      registerTool({\n        name: `update_interactable_component_${component.id}`,\n        description: `Update the props of interactable component ${component.id} (${component.name})`,\n        tool: (componentId: string, newProps: any) => {\n          return updateInteractableComponentProps(componentId, newProps);\n        },\n        toolSchema: z\n          .function()\n          .args(\n            z\n              .string()\n              .describe(\"The ID of the interactable component to update\"),\n            schemaForArgs.describe(\n              \"The new props to update the component with\",\n            ),\n          )\n          .returns(z.string()),\n      });\n    },\n    [registerTool, updateInteractableComponentProps],\n  );\n\n  const addInteractableComponent = useCallback(\n    (\n      component: Omit<TamboInteractableComponent, \"id\" | \"createdAt\">,\n    ): string => {\n      const id = `${component.name}-${Math.random().toString(36).substr(2, 9)}`;\n      const newComponent: TamboInteractableComponent = {\n        ...component,\n        id,\n      };\n\n      registerInteractableComponentUpdateTool(newComponent);\n\n      setInteractableComponents((prev) => {\n        return [...prev, newComponent];\n      });\n\n      return id;\n    },\n    [registerInteractableComponentUpdateTool],\n  );\n\n  const removeInteractableComponent = useCallback((id: string) => {\n    setInteractableComponents((prev) => prev.filter((c) => c.id !== id));\n  }, []);\n\n  const getInteractableComponent = useCallback(\n    (id: string) => {\n      return interactableComponents.find((c) => c.id === id);\n    },\n    [interactableComponents],\n  );\n\n  const getInteractableComponentsByName = useCallback(\n    (componentName: string) => {\n      return interactableComponents.filter((c) => c.name === componentName);\n    },\n    [interactableComponents],\n  );\n\n  const clearAllInteractableComponents = useCallback(() => {\n    setInteractableComponents([]);\n  }, []);\n\n  const value: TamboInteractableContext = {\n    interactableComponents,\n    addInteractableComponent,\n    removeInteractableComponent,\n    updateInteractableComponentProps,\n    getInteractableComponent,\n    getInteractableComponentsByName,\n    clearAllInteractableComponents,\n  };\n\n  return (\n    <TamboInteractableContext.Provider value={value}>\n      {children}\n    </TamboInteractableContext.Provider>\n  );\n};\n\n/**\n * The useTamboInteractable hook provides access to the interactable component\n * management functions.\n * @returns The interactable component management functions\n */\nexport const useTamboInteractable = () => {\n  return useContext(TamboInteractableContext);\n};\n"]}
+{"version":3,"file":"tambo-interactable-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-interactable-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["// react-sdk/src/providers/tambo-interactable-provider.tsx\n\"use client\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport { z } from \"zod\";\nimport {\n  TamboInteractableComponent,\n  type TamboInteractableContext,\n} from \"../model/tambo-interactable\";\nimport { useTamboComponent } from \"./tambo-component-provider\";\n\nconst TamboInteractableContext = createContext<TamboInteractableContext>({\n  interactableComponents: [],\n  addInteractableComponent: () => \"\",\n  removeInteractableComponent: () => {},\n  updateInteractableComponentProps: () => {},\n  getInteractableComponent: () => undefined,\n  getInteractableComponentsByName: () => [],\n  clearAllInteractableComponents: () => {},\n});\n\n/**\n * The TamboInteractableProvider manages a list of components that are currently\n * interactable, allowing tambo to interact with them by updating their props. It also registers tools\n * for Tambo to perform CRUD operations on the components list.\n * @param props - The props for the TamboInteractableProvider\n * @param props.children - The children to wrap\n * @returns The TamboInteractableProvider component\n */\nexport const TamboInteractableProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const [interactableComponents, setInteractableComponents] = useState<\n    TamboInteractableComponent[]\n  >([]);\n  const { registerTool } = useTamboComponent();\n\n  useEffect(() => {\n    registerTool({\n      name: \"get_all_interactable_components\",\n      description:\n        \"Only use this tool if the user is asking about interactable components.Get all currently interactable components with their details including their current props. These are components that you can interact with on behalf of the user.\",\n      tool: () => {\n        return {\n          components: interactableComponents,\n        };\n      },\n      toolSchema: z.function().returns(\n        z.object({\n          components: z.array(\n            z.object({\n              id: z.string(),\n              componentName: z.string(),\n              props: z.record(z.any()),\n              propsSchema: z.object({}).optional(),\n            }),\n          ),\n        }),\n      ),\n    });\n\n    registerTool({\n      name: \"get_interactable_component_by_id\",\n      description: \"Get a specific interactable component by its ID\",\n      tool: (componentId: string) => {\n        const component = interactableComponents.find(\n          (c) => c.id === componentId,\n        );\n\n        if (!component) {\n          return {\n            success: false,\n            error: `Component with ID ${componentId} not found`,\n          };\n        }\n\n        return {\n          success: true,\n          component: {\n            id: component.id,\n            componentName: component.name,\n            props: component.props,\n          },\n        };\n      },\n      toolSchema: z\n        .function()\n        .args(z.string())\n        .returns(\n          z.object({\n            success: z.boolean(),\n            component: z\n              .object({\n                id: z.string(),\n                componentName: z.string(),\n                props: z.record(z.any()),\n              })\n              .optional(),\n            error: z.string().optional(),\n          }),\n        ),\n    });\n\n    registerTool({\n      name: \"remove_interactable_component\",\n      description: \"Remove an interactable component from the system\",\n      tool: (componentId: string) => {\n        const component = interactableComponents.find(\n          (c) => c.id === componentId,\n        );\n\n        if (!component) {\n          return {\n            success: false,\n            error: `Component with ID ${componentId} not found`,\n          };\n        }\n\n        setInteractableComponents((prev) =>\n          prev.filter((c) => c.id !== componentId),\n        );\n\n        return {\n          success: true,\n          componentId,\n          removedComponent: {\n            id: component.id,\n            componentName: component.name,\n            props: component.props,\n          },\n        };\n      },\n      toolSchema: z\n        .function()\n        .args(z.string())\n        .returns(\n          z.object({\n            success: z.boolean(),\n            componentId: z.string(),\n            removedComponent: z.object({\n              id: z.string(),\n              componentName: z.string(),\n              props: z.record(z.any()),\n            }),\n            error: z.string().optional(),\n          }),\n        ),\n    });\n  }, [interactableComponents, registerTool]);\n\n  const updateInteractableComponentProps = useCallback(\n    (id: string, newProps: Record<string, any>) => {\n      let updateResult = \"Updated successfully\";\n\n      setInteractableComponents((prev) => {\n        const componentExists = prev.some((c) => c.id === id);\n\n        if (!componentExists) {\n          updateResult = `Error: Component with ID ${id} not found`;\n          return prev;\n        }\n\n        const updatedComponents = prev.map((c) =>\n          c.id === id ? { ...c, props: { ...c.props, ...newProps } } : c,\n        );\n\n        // Check if the update actually changed anything\n        const originalComponent = prev.find((c) => c.id === id);\n        const updatedComponent = updatedComponents.find((c) => c.id === id);\n\n        if (!originalComponent || !updatedComponent) {\n          updateResult = `Error: Failed to update component with ID ${id}`;\n          return prev;\n        }\n\n        // Check if props actually changed\n        const propsChanged =\n          JSON.stringify(originalComponent.props) !==\n          JSON.stringify(updatedComponent.props);\n\n        if (!propsChanged) {\n          updateResult = `Warning: No changes detected for component with ID ${id}. The update might not have worked.`;\n          return prev;\n        }\n\n        return updatedComponents;\n      });\n\n      return updateResult;\n    },\n    [],\n  );\n\n  const registerInteractableComponentUpdateTool = useCallback(\n    (component: TamboInteractableComponent) => {\n      const schemaForArgs =\n        typeof component.propsSchema === \"object\" &&\n        \"describe\" in component.propsSchema\n          ? component.propsSchema\n          : z.object({});\n\n      registerTool({\n        name: `update_interactable_component_${component.id}`,\n        description: `Update the props of interactable component ${component.id} (${component.name})`,\n        tool: (componentId: string, newProps: any) => {\n          return updateInteractableComponentProps(componentId, newProps);\n        },\n        toolSchema: z\n          .function()\n          .args(\n            z\n              .string()\n              .describe(\"The ID of the interactable component to update\"),\n            schemaForArgs.describe(\n              \"The new props to update the component with\",\n            ),\n          )\n          .returns(z.string()),\n      });\n    },\n    [registerTool, updateInteractableComponentProps],\n  );\n\n  const addInteractableComponent = useCallback(\n    (\n      component: Omit<TamboInteractableComponent, \"id\" | \"createdAt\">,\n    ): string => {\n      const id = `${component.name}-${Math.random().toString(36).substr(2, 9)}`;\n      const newComponent: TamboInteractableComponent = {\n        ...component,\n        id,\n      };\n\n      registerInteractableComponentUpdateTool(newComponent);\n\n      setInteractableComponents((prev) => {\n        return [...prev, newComponent];\n      });\n\n      return id;\n    },\n    [registerInteractableComponentUpdateTool],\n  );\n\n  const removeInteractableComponent = useCallback((id: string) => {\n    setInteractableComponents((prev) => prev.filter((c) => c.id !== id));\n  }, []);\n\n  const getInteractableComponent = useCallback(\n    (id: string) => {\n      return interactableComponents.find((c) => c.id === id);\n    },\n    [interactableComponents],\n  );\n\n  const getInteractableComponentsByName = useCallback(\n    (componentName: string) => {\n      return interactableComponents.filter((c) => c.name === componentName);\n    },\n    [interactableComponents],\n  );\n\n  const clearAllInteractableComponents = useCallback(() => {\n    setInteractableComponents([]);\n  }, []);\n\n  const value: TamboInteractableContext = {\n    interactableComponents,\n    addInteractableComponent,\n    removeInteractableComponent,\n    updateInteractableComponentProps,\n    getInteractableComponent,\n    getInteractableComponentsByName,\n    clearAllInteractableComponents,\n  };\n\n  return (\n    <TamboInteractableContext.Provider value={value}>\n      {children}\n    </TamboInteractableContext.Provider>\n  );\n};\n\n/**\n * The useTamboInteractable hook provides access to the interactable component\n * management functions.\n * @returns The interactable component management functions\n */\nexport const useTamboInteractable = () => {\n  return useContext(TamboInteractableContext);\n};\n"]}

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

@@ -2,6 +2,7 @@ import React, { PropsWithChildren } from "react";
 import { TamboInteractableContext } from "../model/tambo-interactable";
 import { TamboClientContextProps, TamboClientProviderProps } from "./tambo-client-provider";
 import { TamboComponentContextProps } from "./tambo-component-provider";
+import { TamboContextHelpersContextProps, TamboContextHelpersProviderProps } from "./tambo-context-helpers-provider";
 import { TamboRegistryProviderProps } from "./tambo-registry-provider";
 import { TamboThreadContextProps, TamboThreadProviderProps } from "./tambo-thread-provider";
 /**
@@ -15,10 +16,11 @@ import { TamboThreadContextProps, TamboThreadProviderProps } from "./tambo-threa
  * @param props.environment - The environment to use for the Tambo API
  * @param props.tools - The tools to register
  * @param props.streaming - Whether to stream the response by default. Defaults to true.
+ * @param props.contextHelpers - Configuration for which context helpers are enabled/disabled
  * @returns The TamboProvider component
  */
-export declare const TamboProvider: React.FC<PropsWithChildren<TamboClientProviderProps & TamboRegistryProviderProps & TamboThreadProviderProps>>;
-export type TamboContextProps = TamboClientContextProps & TamboThreadContextProps & TamboComponentContextProps & TamboInteractableContext;
+export declare const TamboProvider: React.FC<PropsWithChildren<TamboClientProviderProps & TamboRegistryProviderProps & TamboThreadProviderProps & TamboContextHelpersProviderProps>>;
+export type TamboContextProps = TamboClientContextProps & TamboThreadContextProps & TamboComponentContextProps & TamboInteractableContext & TamboContextHelpersContextProps;
 export declare const TamboContext: React.Context<TamboContextProps>;
 /**
  * TamboCompositeProvider is a provider that combines the TamboClient,

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAA6B,MAAM,OAAO,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,uBAAuB,EAEvB,wBAAwB,EAGzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAG3B,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EAEL,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EAEvB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAClC,iBAAiB,CACf,wBAAwB,GACtB,0BAA0B,GAC1B,wBAAwB,CAC3B,CAkCF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GACrD,uBAAuB,GACvB,0BAA0B,GAC1B,wBAAwB,CAAC;AAE3B,eAAO,MAAM,YAAY,kCAExB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAsB9D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,yBAEpB,CAAC"}
+{"version":3,"file":"tambo-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAA6B,MAAM,OAAO,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,uBAAuB,EAEvB,wBAAwB,EAGzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAG3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,+BAA+B,EAE/B,gCAAgC,EAEjC,MAAM,kCAAkC,CAAC;AAK1C,OAAO,EAEL,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,uBAAuB,EAEvB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAClC,iBAAiB,CACf,wBAAwB,GACtB,0BAA0B,GAC1B,wBAAwB,GACxB,gCAAgC,CACnC,CAqCF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GACrD,uBAAuB,GACvB,0BAA0B,GAC1B,wBAAwB,GACxB,+BAA+B,CAAC;AAElC,eAAO,MAAM,YAAY,kCAExB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAwB9D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,yBAEpB,CAAC"}

package/dist/providers/tambo-provider.js

@@ -38,6 +38,7 @@ exports.useTambo = exports.TamboCompositeProvider = exports.TamboContext = expor
 const react_1 = __importStar(require("react"));
 const tambo_client_provider_1 = require("./tambo-client-provider");
 const tambo_component_provider_1 = require("./tambo-component-provider");
+const tambo_context_helpers_provider_1 = require("./tambo-context-helpers-provider");
 const tambo_interactable_provider_1 = require("./tambo-interactable-provider");
 const tambo_registry_provider_1 = require("./tambo-registry-provider");
 const tambo_thread_provider_1 = require("./tambo-thread-provider");
@@ -52,19 +53,21 @@ const tambo_thread_provider_1 = require("./tambo-thread-provider");
  * @param props.environment - The environment to use for the Tambo API
  * @param props.tools - The tools to register
  * @param props.streaming - Whether to stream the response by default. Defaults to true.
+ * @param props.contextHelpers - Configuration for which context helpers are enabled/disabled
  * @returns The TamboProvider component
  */
-const TamboProvider = ({ children, tamboUrl, apiKey, userToken, components, environment, tools, streaming, }) => {
+const TamboProvider = ({ children, tamboUrl, apiKey, userToken, components, environment, tools, streaming, contextHelpers, }) => {
     // Should only be used in browser
     if (typeof window === "undefined") {
         console.error("TamboProvider must be used within a browser");
     }
     return (react_1.default.createElement(tambo_client_provider_1.TamboClientProvider, { tamboUrl: tamboUrl, apiKey: apiKey, environment: environment, userToken: userToken },
         react_1.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: components, tools: tools },
-            react_1.default.createElement(tambo_thread_provider_1.TamboThreadProvider, { streaming: streaming },
-                react_1.default.createElement(tambo_component_provider_1.TamboComponentProvider, null,
-                    react_1.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
-                        react_1.default.createElement(exports.TamboCompositeProvider, null, children)))))));
+            react_1.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, { contextHelpers: contextHelpers },
+                react_1.default.createElement(tambo_thread_provider_1.TamboThreadProvider, { streaming: streaming },
+                    react_1.default.createElement(tambo_component_provider_1.TamboComponentProvider, null,
+                        react_1.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+                            react_1.default.createElement(exports.TamboCompositeProvider, null, children))))))));
 };
 exports.TamboProvider = TamboProvider;
 exports.TamboContext = (0, react_1.createContext)({});
@@ -81,12 +84,14 @@ const TamboCompositeProvider = ({ children, }) => {
     const queryClient = (0, tambo_client_provider_1.useTamboQueryClient)();
     const componentRegistry = (0, tambo_component_provider_1.useTamboComponent)();
     const interactableComponents = (0, tambo_interactable_provider_1.useTamboInteractable)();
+    const contextHelpers = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
     return (react_1.default.createElement(exports.TamboContext.Provider, { value: {
             client,
             queryClient,
             ...componentRegistry,
             ...threads,
             ...interactableComponents,
+            ...contextHelpers,
         } }, children));
 };
 exports.TamboCompositeProvider = TamboCompositeProvider;

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACb,+CAA4E;AAE5E,mEAMiC;AACjC,yEAIoC;AACpC,+EAGuC;AACvC,uEAGmC;AACnC,mEAKiC;AAEjC;;;;;;;;;;;;GAYG;AACI,MAAM,aAAa,GAMtB,CAAC,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,UAAU,EACV,WAAW,EACX,KAAK,EACL,SAAS,GACV,EAAE,EAAE;IACH,iCAAiC;IACjC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CACL,8BAAC,2CAAmB,IAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS;QAEpB,8BAAC,+CAAqB,IAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK;YACzD,8BAAC,2CAAmB,IAAC,SAAS,EAAE,SAAS;gBACvC,8BAAC,iDAAsB;oBACrB,8BAAC,uDAAyB;wBACxB,8BAAC,8BAAsB,QAAE,QAAQ,CAA0B,CACjC,CACL,CACL,CACA,CACJ,CACvB,CAAC;AACJ,CAAC,CAAC;AAvCW,QAAA,aAAa,iBAuCxB;AAOW,QAAA,YAAY,GAAG,IAAA,qBAAa,EACvC,EAAuB,CACxB,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,sBAAsB,GAAgC,CAAC,EAClE,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,OAAO,GAAG,IAAA,sCAAc,GAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAA,sCAAc,GAAE,CAAC;IAChC,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,IAAA,4CAAiB,GAAE,CAAC;IAC9C,MAAM,sBAAsB,GAAG,IAAA,kDAAoB,GAAE,CAAC;IAEtD,OAAO,CACL,8BAAC,oBAAY,CAAC,QAAQ,IACpB,KAAK,EAAE;YACL,MAAM;YACN,WAAW;YACX,GAAG,iBAAiB;YACpB,GAAG,OAAO;YACV,GAAG,sBAAsB;SAC1B,IAEA,QAAQ,CACa,CACzB,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,sBAAsB,0BAsBjC;AAEF;;;;;;;GAOG;AACI,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,OAAO,IAAA,kBAAU,EAAC,oBAAY,CAAC,CAAC;AAClC,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB","sourcesContent":["\"use client\";\nimport React, { PropsWithChildren, createContext, useContext } from \"react\";\nimport { TamboInteractableContext } from \"../model/tambo-interactable\";\nimport {\n  TamboClientContextProps,\n  TamboClientProvider,\n  TamboClientProviderProps,\n  useTamboClient,\n  useTamboQueryClient,\n} from \"./tambo-client-provider\";\nimport {\n  TamboComponentContextProps,\n  TamboComponentProvider,\n  useTamboComponent,\n} from \"./tambo-component-provider\";\nimport {\n  TamboInteractableProvider,\n  useTamboInteractable,\n} from \"./tambo-interactable-provider\";\nimport {\n  TamboRegistryProvider,\n  TamboRegistryProviderProps,\n} from \"./tambo-registry-provider\";\nimport {\n  TamboThreadContextProps,\n  TamboThreadProvider,\n  TamboThreadProviderProps,\n  useTamboThread,\n} from \"./tambo-thread-provider\";\n\n/**\n * The TamboProvider gives full access to the whole Tambo API. This includes the\n * TamboAI client, the component registry, the current thread context, and interactable components.\n * @param props - The props for the TamboProvider\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.components - The components to register\n * @param props.environment - The environment to use for the Tambo API\n * @param props.tools - The tools to register\n * @param props.streaming - Whether to stream the response by default. Defaults to true.\n * @returns The TamboProvider component\n */\nexport const TamboProvider: React.FC<\n  PropsWithChildren<\n    TamboClientProviderProps &\n      TamboRegistryProviderProps &\n      TamboThreadProviderProps\n  >\n> = ({\n  children,\n  tamboUrl,\n  apiKey,\n  userToken,\n  components,\n  environment,\n  tools,\n  streaming,\n}) => {\n  // Should only be used in browser\n  if (typeof window === \"undefined\") {\n    console.error(\"TamboProvider must be used within a browser\");\n  }\n\n  return (\n    <TamboClientProvider\n      tamboUrl={tamboUrl}\n      apiKey={apiKey}\n      environment={environment}\n      userToken={userToken}\n    >\n      <TamboRegistryProvider components={components} tools={tools}>\n        <TamboThreadProvider streaming={streaming}>\n          <TamboComponentProvider>\n            <TamboInteractableProvider>\n              <TamboCompositeProvider>{children}</TamboCompositeProvider>\n            </TamboInteractableProvider>\n          </TamboComponentProvider>\n        </TamboThreadProvider>\n      </TamboRegistryProvider>\n    </TamboClientProvider>\n  );\n};\n\nexport type TamboContextProps = TamboClientContextProps &\n  TamboThreadContextProps &\n  TamboComponentContextProps &\n  TamboInteractableContext;\n\nexport const TamboContext = createContext<TamboContextProps>(\n  {} as TamboContextProps,\n);\n\n/**\n * TamboCompositeProvider is a provider that combines the TamboClient,\n * TamboThread, TamboComponent, and TamboInteractable providers\n * @param props - The props for the TamboCompositeProvider\n * @param props.children - The children to wrap\n * @returns The wrapped component\n */\nexport const TamboCompositeProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const threads = useTamboThread();\n  const client = useTamboClient();\n  const queryClient = useTamboQueryClient();\n  const componentRegistry = useTamboComponent();\n  const interactableComponents = useTamboInteractable();\n\n  return (\n    <TamboContext.Provider\n      value={{\n        client,\n        queryClient,\n        ...componentRegistry,\n        ...threads,\n        ...interactableComponents,\n      }}\n    >\n      {children}\n    </TamboContext.Provider>\n  );\n};\n\n/**\n * The useTambo hook provides access to the Tambo API. This is the primary entrypoint\n * for the Tambo React SDK.\n *\n * This includes the TamboAI client, the component registry, the current thread context,\n * and interactable component management.\n * @returns The Tambo API\n */\nexport const useTambo = () => {\n  return useContext(TamboContext);\n};\n"]}
+{"version":3,"file":"tambo-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACb,+CAA4E;AAE5E,mEAMiC;AACjC,yEAIoC;AACpC,qFAK0C;AAC1C,+EAGuC;AACvC,uEAGmC;AACnC,mEAKiC;AAEjC;;;;;;;;;;;;;GAaG;AACI,MAAM,aAAa,GAOtB,CAAC,EACH,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,SAAS,EACT,UAAU,EACV,WAAW,EACX,KAAK,EACL,SAAS,EACT,cAAc,GACf,EAAE,EAAE;IACH,iCAAiC;IACjC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CACL,8BAAC,2CAAmB,IAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS;QAEpB,8BAAC,+CAAqB,IAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK;YACzD,8BAAC,4DAA2B,IAAC,cAAc,EAAE,cAAc;gBACzD,8BAAC,2CAAmB,IAAC,SAAS,EAAE,SAAS;oBACvC,8BAAC,iDAAsB;wBACrB,8BAAC,uDAAyB;4BACxB,8BAAC,8BAAsB,QAAE,QAAQ,CAA0B,CACjC,CACL,CACL,CACM,CACR,CACJ,CACvB,CAAC;AACJ,CAAC,CAAC;AA3CW,QAAA,aAAa,iBA2CxB;AAQW,QAAA,YAAY,GAAG,IAAA,qBAAa,EACvC,EAAuB,CACxB,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,sBAAsB,GAAgC,CAAC,EAClE,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,OAAO,GAAG,IAAA,sCAAc,GAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAA,sCAAc,GAAE,CAAC;IAChC,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,IAAA,4CAAiB,GAAE,CAAC;IAC9C,MAAM,sBAAsB,GAAG,IAAA,kDAAoB,GAAE,CAAC;IACtD,MAAM,cAAc,GAAG,IAAA,uDAAsB,GAAE,CAAC;IAEhD,OAAO,CACL,8BAAC,oBAAY,CAAC,QAAQ,IACpB,KAAK,EAAE;YACL,MAAM;YACN,WAAW;YACX,GAAG,iBAAiB;YACpB,GAAG,OAAO;YACV,GAAG,sBAAsB;YACzB,GAAG,cAAc;SAClB,IAEA,QAAQ,CACa,CACzB,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,sBAAsB,0BAwBjC;AAEF;;;;;;;GAOG;AACI,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,OAAO,IAAA,kBAAU,EAAC,oBAAY,CAAC,CAAC;AAClC,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB","sourcesContent":["\"use client\";\nimport React, { PropsWithChildren, createContext, useContext } from \"react\";\nimport { TamboInteractableContext } from \"../model/tambo-interactable\";\nimport {\n  TamboClientContextProps,\n  TamboClientProvider,\n  TamboClientProviderProps,\n  useTamboClient,\n  useTamboQueryClient,\n} from \"./tambo-client-provider\";\nimport {\n  TamboComponentContextProps,\n  TamboComponentProvider,\n  useTamboComponent,\n} from \"./tambo-component-provider\";\nimport {\n  TamboContextHelpersContextProps,\n  TamboContextHelpersProvider,\n  TamboContextHelpersProviderProps,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport {\n  TamboInteractableProvider,\n  useTamboInteractable,\n} from \"./tambo-interactable-provider\";\nimport {\n  TamboRegistryProvider,\n  TamboRegistryProviderProps,\n} from \"./tambo-registry-provider\";\nimport {\n  TamboThreadContextProps,\n  TamboThreadProvider,\n  TamboThreadProviderProps,\n  useTamboThread,\n} from \"./tambo-thread-provider\";\n\n/**\n * The TamboProvider gives full access to the whole Tambo API. This includes the\n * TamboAI client, the component registry, the current thread context, and interactable components.\n * @param props - The props for the TamboProvider\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.components - The components to register\n * @param props.environment - The environment to use for the Tambo API\n * @param props.tools - The tools to register\n * @param props.streaming - Whether to stream the response by default. Defaults to true.\n * @param props.contextHelpers - Configuration for which context helpers are enabled/disabled\n * @returns The TamboProvider component\n */\nexport const TamboProvider: React.FC<\n  PropsWithChildren<\n    TamboClientProviderProps &\n      TamboRegistryProviderProps &\n      TamboThreadProviderProps &\n      TamboContextHelpersProviderProps\n  >\n> = ({\n  children,\n  tamboUrl,\n  apiKey,\n  userToken,\n  components,\n  environment,\n  tools,\n  streaming,\n  contextHelpers,\n}) => {\n  // Should only be used in browser\n  if (typeof window === \"undefined\") {\n    console.error(\"TamboProvider must be used within a browser\");\n  }\n\n  return (\n    <TamboClientProvider\n      tamboUrl={tamboUrl}\n      apiKey={apiKey}\n      environment={environment}\n      userToken={userToken}\n    >\n      <TamboRegistryProvider components={components} tools={tools}>\n        <TamboContextHelpersProvider contextHelpers={contextHelpers}>\n          <TamboThreadProvider streaming={streaming}>\n            <TamboComponentProvider>\n              <TamboInteractableProvider>\n                <TamboCompositeProvider>{children}</TamboCompositeProvider>\n              </TamboInteractableProvider>\n            </TamboComponentProvider>\n          </TamboThreadProvider>\n        </TamboContextHelpersProvider>\n      </TamboRegistryProvider>\n    </TamboClientProvider>\n  );\n};\n\nexport type TamboContextProps = TamboClientContextProps &\n  TamboThreadContextProps &\n  TamboComponentContextProps &\n  TamboInteractableContext &\n  TamboContextHelpersContextProps;\n\nexport const TamboContext = createContext<TamboContextProps>(\n  {} as TamboContextProps,\n);\n\n/**\n * TamboCompositeProvider is a provider that combines the TamboClient,\n * TamboThread, TamboComponent, and TamboInteractable providers\n * @param props - The props for the TamboCompositeProvider\n * @param props.children - The children to wrap\n * @returns The wrapped component\n */\nexport const TamboCompositeProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const threads = useTamboThread();\n  const client = useTamboClient();\n  const queryClient = useTamboQueryClient();\n  const componentRegistry = useTamboComponent();\n  const interactableComponents = useTamboInteractable();\n  const contextHelpers = useTamboContextHelpers();\n\n  return (\n    <TamboContext.Provider\n      value={{\n        client,\n        queryClient,\n        ...componentRegistry,\n        ...threads,\n        ...interactableComponents,\n        ...contextHelpers,\n      }}\n    >\n      {children}\n    </TamboContext.Provider>\n  );\n};\n\n/**\n * The useTambo hook provides access to the Tambo API. This is the primary entrypoint\n * for the Tambo React SDK.\n *\n * This includes the TamboAI client, the component registry, the current thread context,\n * and interactable component management.\n * @returns The Tambo API\n */\nexport const useTambo = () => {\n  return useContext(TamboContext);\n};\n"]}

package/dist/providers/tambo-stubs.d.ts

@@ -2,6 +2,7 @@ import TamboAI from "@tambo-ai/typescript-sdk";
 import React, { PropsWithChildren } from "react";
 import { TamboComponent, TamboTool } from "../model/component-metadata";
 import { TamboThread } from "../model/tambo-thread";
+import { TamboContextHelpersProviderProps } from "./tambo-context-helpers-provider";
 import { type TamboContextProps } from "./tambo-provider";
 /**
  * TamboStubProvider props - includes all the data that would normally be inferred
@@ -19,6 +20,8 @@ export interface TamboStubProviderProps extends Partial<TamboContextProps> {
     projectId?: string;
     /** Optional: Context key for thread list queries */
     contextKey?: string;
+    /** Optional: Configuration for which context helpers are enabled/disabled */
+    contextHelpers?: TamboContextHelpersProviderProps["contextHelpers"];
 }
 /**
  * The TamboStubProvider provides a way to use the Tambo API with static/stub data.
@@ -79,6 +82,7 @@ export interface TamboStubProviderProps extends Partial<TamboContextProps> {
  * @param props.threads - Optional threads data to populate thread list (overrides useTamboThreadList)
  * @param props.projectId - Optional project ID for query cache (defaults to thread.projectId)
  * @param props.contextKey - Optional context key for thread list queries
+ * @param props.contextHelpers - Optional configuration for which context helpers are enabled/disabled
  * @returns The TamboStubProvider component
  */
 export declare const TamboStubProvider: React.FC<PropsWithChildren<TamboStubProviderProps>>;

package/dist/providers/tambo-stubs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-stubs.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-stubs.tsx"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAE/C,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAAa,MAAM,OAAO,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAO1B;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,OAAO,CAAC,iBAAiB,CAAC;IACxE,2CAA2C;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,mDAAmD;IACnD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAsID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CACtC,iBAAiB,CAAC,sBAAsB,CAAC,CAmH1C,CAAC"}
+{"version":3,"file":"tambo-stubs.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-stubs.tsx"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAE/C,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAAa,MAAM,OAAO,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,OAAO,EAEL,gCAAgC,EACjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAO1B;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,OAAO,CAAC,iBAAiB,CAAC;IACxE,2CAA2C;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,mDAAmD;IACnD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,gCAAgC,CAAC,gBAAgB,CAAC,CAAC;CACrE;AAsID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CACtC,iBAAiB,CAAC,sBAAsB,CAAC,CAsH1C,CAAC"}

package/dist/providers/tambo-stubs.js

@@ -40,6 +40,7 @@ const react_1 = __importStar(require("react"));
 const generate_component_response_1 = require("../model/generate-component-response");
 const tambo_client_provider_1 = require("./tambo-client-provider");
 const tambo_component_provider_1 = require("./tambo-component-provider");
+const tambo_context_helpers_provider_1 = require("./tambo-context-helpers-provider");
 const tambo_provider_1 = require("./tambo-provider");
 const tambo_registry_provider_1 = require("./tambo-registry-provider");
 const tambo_thread_provider_1 = require("./tambo-thread-provider");
@@ -185,9 +186,10 @@ const createDefaultCallbacks = () => ({
  * @param props.threads - Optional threads data to populate thread list (overrides useTamboThreadList)
  * @param props.projectId - Optional project ID for query cache (defaults to thread.projectId)
  * @param props.contextKey - Optional context key for thread list queries
+ * @param props.contextHelpers - Optional configuration for which context helpers are enabled/disabled
  * @returns The TamboStubProvider component
  */
-const TamboStubProvider = ({ children, thread, components = [], tools = [], threads, projectId, contextKey, ...overrides }) => {
+const TamboStubProvider = ({ children, thread, components = [], tools = [], threads, projectId, contextKey, contextHelpers, ...overrides }) => {
     const defaults = createDefaultCallbacks();
     // Create stub client and queryClient
     const stubClient = {};
@@ -245,8 +247,9 @@ const TamboStubProvider = ({ children, thread, components = [], tools = [], thre
     return (react_1.default.createElement(TamboStubClientProvider, { client: stubClient, queryClient: stubQueryClient, threads: threads, projectId: resolvedProjectId, contextKey: contextKey },
         react_1.default.createElement(TamboStubRegistryProvider, { componentList: componentList, toolRegistry: toolRegistry, componentToolAssociations: componentToolAssociations, registerComponent: componentContextProps.registerComponent, registerTool: componentContextProps.registerTool, registerTools: componentContextProps.registerTools, addToolAssociation: componentContextProps.addToolAssociation },
             react_1.default.createElement(TamboStubThreadProvider, { ...threadContextProps },
-                react_1.default.createElement(tambo_component_provider_1.TamboComponentProvider, null,
-                    react_1.default.createElement(tambo_provider_1.TamboCompositeProvider, null, children))))));
+                react_1.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, { contextHelpers: contextHelpers },
+                    react_1.default.createElement(tambo_component_provider_1.TamboComponentProvider, null,
+                        react_1.default.createElement(tambo_provider_1.TamboCompositeProvider, null, children)))))));
 };
 exports.TamboStubProvider = TamboStubProvider;
 //# sourceMappingURL=tambo-stubs.js.map

package/dist/providers/tambo-stubs.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-stubs.js","sourceRoot":"","sources":["../../src/providers/tambo-stubs.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport React, { PropsWithChildren, useEffect } from \"react\";\nimport { TamboComponent, TamboTool } from \"../model/component-metadata\";\nimport { GenerationStage } from \"../model/generate-component-response\";\nimport { TamboThread } from \"../model/tambo-thread\";\nimport { TamboClientContext } from \"./tambo-client-provider\";\nimport {\n  TamboComponentContextProps,\n  TamboComponentProvider,\n} from \"./tambo-component-provider\";\nimport {\n  TamboCompositeProvider,\n  type TamboContextProps,\n} from \"./tambo-provider\";\nimport { TamboRegistryContext } from \"./tambo-registry-provider\";\nimport {\n  TamboThreadContext,\n  TamboThreadContextProps,\n} from \"./tambo-thread-provider\";\n\n/**\n * TamboStubProvider props - includes all the data that would normally be inferred\n */\nexport interface TamboStubProviderProps extends Partial<TamboContextProps> {\n  /** Required: The thread data to display */\n  thread: TamboThread;\n  /** Optional: Components registry - defaults to empty */\n  components?: TamboComponent[];\n  /** Optional: Tools registry - defaults to empty */\n  tools?: TamboTool[];\n  /** Optional: Threads data to populate thread list - overrides useTamboThreadList() */\n  threads?: Partial<TamboAI.Beta.Threads.ThreadsOffsetAndLimit>;\n  /** Optional: Project ID to use for query cache - defaults to thread.projectId */\n  projectId?: string;\n  /** Optional: Context key for thread list queries */\n  contextKey?: string;\n}\n\n/**\n * Stub client provider that accepts a client and queryClient as props\n * @returns The TamboStubClientProvider component\n */\nconst TamboStubClientProvider: React.FC<\n  PropsWithChildren<{\n    client: TamboAI;\n    queryClient: QueryClient;\n    threads?: Partial<TamboAI.Beta.Threads.ThreadsOffsetAndLimit>;\n    projectId?: string;\n    contextKey?: string;\n  }>\n> = ({ children, client, queryClient, threads, projectId, contextKey }) => {\n  // Prepopulate the query cache with threads data if provided\n  useEffect(() => {\n    if (threads) {\n      // Set the project ID in the cache\n      queryClient.setQueryData([\"projectId\"], projectId);\n\n      // Set the threads data in the cache using the same query key pattern as useTamboThreadList\n      queryClient.setQueryData([\"threads\", projectId, contextKey], threads);\n    }\n  }, [threads, projectId, contextKey, queryClient]);\n\n  return (\n    <TamboClientContext.Provider value={{ client, queryClient }}>\n      {children}\n    </TamboClientContext.Provider>\n  );\n};\n\n/**\n * Stub registry provider that accepts componentList, toolRegistry, and componentToolAssociations as props\n * @returns The TamboStubRegistryProvider component\n */\nconst TamboStubRegistryProvider: React.FC<\n  PropsWithChildren<{\n    componentList: Record<string, any>;\n    toolRegistry: Record<string, TamboTool>;\n    componentToolAssociations: Record<string, string[]>;\n    registerComponent: (options: TamboComponent) => void;\n    registerTool: (tool: TamboTool) => void;\n    registerTools: (tools: TamboTool[]) => void;\n    addToolAssociation: (componentName: string, tool: TamboTool) => void;\n  }>\n> = ({\n  children,\n  componentList,\n  toolRegistry,\n  componentToolAssociations,\n  registerComponent,\n  registerTool,\n  registerTools,\n  addToolAssociation,\n}) => {\n  return (\n    <TamboRegistryContext.Provider\n      value={{\n        componentList,\n        toolRegistry,\n        componentToolAssociations,\n        registerComponent,\n        registerTool,\n        registerTools,\n        addToolAssociation,\n      }}\n    >\n      {children}\n    </TamboRegistryContext.Provider>\n  );\n};\n\n/**\n * Stub thread provider that accepts all thread context props\n * @returns The TamboStubThreadProvider component\n */\nconst TamboStubThreadProvider: React.FC<\n  PropsWithChildren<TamboThreadContextProps>\n> = ({ children, ...threadContextProps }) => {\n  return (\n    <TamboThreadContext.Provider value={threadContextProps}>\n      {children}\n    </TamboThreadContext.Provider>\n  );\n};\n\n/**\n * Default no-op functions that throw errors - used when callbacks are not provided\n * @returns The default callbacks\n */\nconst createDefaultCallbacks = () => ({\n  switchCurrentThread: () => {\n    throw new Error(\"switchCurrentThread not implemented in stub\");\n  },\n  startNewThread: () => {\n    throw new Error(\"startNewThread not implemented in stub\");\n  },\n  updateThreadName: () => {\n    throw new Error(\"updateThreadName not implemented in stub\");\n  },\n  generateThreadName: () => {\n    throw new Error(\"generateThreadName not implemented in stub\");\n  },\n  addThreadMessage: () => {\n    throw new Error(\"addThreadMessage not implemented in stub\");\n  },\n  updateThreadMessage: () => {\n    throw new Error(\"updateThreadMessage not implemented in stub\");\n  },\n  setInputValue: () => {\n    throw new Error(\"setInputValue not implemented in stub\");\n  },\n  sendThreadMessage: () => {\n    throw new Error(\"sendThreadMessage not implemented in stub\");\n  },\n  registerComponent: () => {\n    throw new Error(\"registerComponent not implemented in stub\");\n  },\n  registerTool: () => {\n    throw new Error(\"registerTool not implemented in stub\");\n  },\n  registerTools: () => {\n    throw new Error(\"registerTools not implemented in stub\");\n  },\n  addToolAssociation: () => {\n    throw new Error(\"addToolAssociation not implemented in stub\");\n  },\n  cancel: () => {\n    throw new Error(\"cancel not implemented in stub\");\n  },\n});\n\n/**\n * The TamboStubProvider provides a way to use the Tambo API with static/stub data.\n * This is useful for testing, samples, and static UI development.\n *\n * Unlike TamboProvider, all data must be provided as props rather than being inferred.\n * @example\n * ```tsx\n * import { TamboStubProvider } from '@tambo-ai/react-sdk';\n *\n * const exampleThread = {\n *   id: \"example-thread\",\n *   messages: [\n *     {\n *       id: \"msg-1\",\n *       role: \"user\",\n *       content: [{ type: \"text\", text: \"Hello!\" }],\n *       createdAt: new Date().toISOString(),\n *       threadId: \"example-thread\",\n *       componentState: {},\n *     },\n *     {\n *       id: \"msg-2\",\n *       role: \"assistant\",\n *       content: [{ type: \"text\", text: \"Hi there!\" }],\n *       createdAt: new Date().toISOString(),\n *       threadId: \"example-thread\",\n *       componentState: {},\n *     }\n *   ],\n *   createdAt: new Date().toISOString(),\n *   projectId: \"example-project\",\n *   updatedAt: new Date().toISOString(),\n *   metadata: {},\n * };\n *\n * const exampleThreadList = [exampleThread];\n *\n * function MyComponent() {\n *   return (\n *     <TamboStubProvider\n *       thread={exampleThread}\n *       components={[]}\n *       tools={[]}\n *       threads={exampleThreadList}\n *       projectId=\"example-project\"\n *     >\n *       <MessageThreadFull />\n *     </TamboStubProvider>\n *   );\n * }\n * ```\n * @param props - The props for the TamboStubProvider\n * @param props.children - The children to wrap\n * @param props.thread - The thread data to display\n * @param props.components - Optional components registry\n * @param props.tools - Optional tools registry\n * @param props.threads - Optional threads data to populate thread list (overrides useTamboThreadList)\n * @param props.projectId - Optional project ID for query cache (defaults to thread.projectId)\n * @param props.contextKey - Optional context key for thread list queries\n * @returns The TamboStubProvider component\n */\nexport const TamboStubProvider: React.FC<\n  PropsWithChildren<TamboStubProviderProps>\n> = ({\n  children,\n  thread,\n  components = [],\n  tools = [],\n  threads,\n  projectId,\n  contextKey,\n  ...overrides\n}) => {\n  const defaults = createDefaultCallbacks();\n\n  // Create stub client and queryClient\n  const stubClient = {} as TamboAI;\n  const stubQueryClient = new QueryClient();\n\n  // Use provided projectId or fall back to thread's projectId\n  const resolvedProjectId = projectId ?? thread.projectId;\n\n  // Build component registry from components prop\n  const componentList = components.reduce(\n    (acc, component) => {\n      acc[component.name] = {\n        component: component.component,\n        loadingComponent: component.loadingComponent,\n        name: component.name,\n        description: component.description,\n        props: component.propsDefinition ?? {},\n        contextTools: [],\n      };\n      return acc;\n    },\n    {} as Record<string, any>,\n  );\n\n  // Build tool registry from tools prop\n  const toolRegistry = tools.reduce(\n    (acc, tool) => {\n      acc[tool.name] = tool;\n      return acc;\n    },\n    {} as Record<string, TamboTool>,\n  );\n\n  // Build tool associations from components\n  const componentToolAssociations = components.reduce(\n    (acc, component) => {\n      if (component.associatedTools) {\n        acc[component.name] = component.associatedTools.map(\n          (tool) => tool.name,\n        );\n      }\n      return acc;\n    },\n    {} as Record<string, string[]>,\n  );\n\n  // Merge defaults with provided overrides\n  const threadContextProps: TamboThreadContextProps = {\n    thread,\n    switchCurrentThread:\n      overrides.switchCurrentThread ?? defaults.switchCurrentThread,\n    startNewThread: overrides.startNewThread ?? defaults.startNewThread,\n    updateThreadName: overrides.updateThreadName ?? defaults.updateThreadName,\n    generateThreadName:\n      overrides.generateThreadName ?? defaults.generateThreadName,\n    addThreadMessage: overrides.addThreadMessage ?? defaults.addThreadMessage,\n    updateThreadMessage:\n      overrides.updateThreadMessage ?? defaults.updateThreadMessage,\n    inputValue: overrides.inputValue ?? \"\",\n    streaming: overrides.streaming ?? true,\n    setInputValue: overrides.setInputValue ?? defaults.setInputValue,\n    sendThreadMessage:\n      overrides.sendThreadMessage ?? defaults.sendThreadMessage,\n    generationStage: overrides.generationStage ?? GenerationStage.IDLE,\n    generationStatusMessage: overrides.generationStatusMessage ?? \"\",\n    isIdle: overrides.isIdle ?? true,\n    cancel: overrides.cancel ?? defaults.cancel,\n  };\n\n  const componentContextProps: TamboComponentContextProps = {\n    registerComponent:\n      overrides.registerComponent ?? defaults.registerComponent,\n    registerTool: overrides.registerTool ?? defaults.registerTool,\n    registerTools: overrides.registerTools ?? defaults.registerTools,\n    addToolAssociation:\n      overrides.addToolAssociation ?? defaults.addToolAssociation,\n  };\n\n  return (\n    <TamboStubClientProvider\n      client={stubClient}\n      queryClient={stubQueryClient}\n      threads={threads}\n      projectId={resolvedProjectId}\n      contextKey={contextKey}\n    >\n      <TamboStubRegistryProvider\n        componentList={componentList}\n        toolRegistry={toolRegistry}\n        componentToolAssociations={componentToolAssociations}\n        registerComponent={componentContextProps.registerComponent}\n        registerTool={componentContextProps.registerTool}\n        registerTools={componentContextProps.registerTools}\n        addToolAssociation={componentContextProps.addToolAssociation}\n      >\n        <TamboStubThreadProvider {...threadContextProps}>\n          <TamboComponentProvider>\n            <TamboCompositeProvider>{children}</TamboCompositeProvider>\n          </TamboComponentProvider>\n        </TamboStubThreadProvider>\n      </TamboStubRegistryProvider>\n    </TamboStubClientProvider>\n  );\n};\n"]}
+{"version":3,"file":"tambo-stubs.js","sourceRoot":"","sources":["../../src/providers/tambo-stubs.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport React, { PropsWithChildren, useEffect } from \"react\";\nimport { TamboComponent, TamboTool } from \"../model/component-metadata\";\nimport { GenerationStage } from \"../model/generate-component-response\";\nimport { TamboThread } from \"../model/tambo-thread\";\nimport { TamboClientContext } from \"./tambo-client-provider\";\nimport {\n  TamboComponentContextProps,\n  TamboComponentProvider,\n} from \"./tambo-component-provider\";\nimport {\n  TamboContextHelpersProvider,\n  TamboContextHelpersProviderProps,\n} from \"./tambo-context-helpers-provider\";\nimport {\n  TamboCompositeProvider,\n  type TamboContextProps,\n} from \"./tambo-provider\";\nimport { TamboRegistryContext } from \"./tambo-registry-provider\";\nimport {\n  TamboThreadContext,\n  TamboThreadContextProps,\n} from \"./tambo-thread-provider\";\n\n/**\n * TamboStubProvider props - includes all the data that would normally be inferred\n */\nexport interface TamboStubProviderProps extends Partial<TamboContextProps> {\n  /** Required: The thread data to display */\n  thread: TamboThread;\n  /** Optional: Components registry - defaults to empty */\n  components?: TamboComponent[];\n  /** Optional: Tools registry - defaults to empty */\n  tools?: TamboTool[];\n  /** Optional: Threads data to populate thread list - overrides useTamboThreadList() */\n  threads?: Partial<TamboAI.Beta.Threads.ThreadsOffsetAndLimit>;\n  /** Optional: Project ID to use for query cache - defaults to thread.projectId */\n  projectId?: string;\n  /** Optional: Context key for thread list queries */\n  contextKey?: string;\n  /** Optional: Configuration for which context helpers are enabled/disabled */\n  contextHelpers?: TamboContextHelpersProviderProps[\"contextHelpers\"];\n}\n\n/**\n * Stub client provider that accepts a client and queryClient as props\n * @returns The TamboStubClientProvider component\n */\nconst TamboStubClientProvider: React.FC<\n  PropsWithChildren<{\n    client: TamboAI;\n    queryClient: QueryClient;\n    threads?: Partial<TamboAI.Beta.Threads.ThreadsOffsetAndLimit>;\n    projectId?: string;\n    contextKey?: string;\n  }>\n> = ({ children, client, queryClient, threads, projectId, contextKey }) => {\n  // Prepopulate the query cache with threads data if provided\n  useEffect(() => {\n    if (threads) {\n      // Set the project ID in the cache\n      queryClient.setQueryData([\"projectId\"], projectId);\n\n      // Set the threads data in the cache using the same query key pattern as useTamboThreadList\n      queryClient.setQueryData([\"threads\", projectId, contextKey], threads);\n    }\n  }, [threads, projectId, contextKey, queryClient]);\n\n  return (\n    <TamboClientContext.Provider value={{ client, queryClient }}>\n      {children}\n    </TamboClientContext.Provider>\n  );\n};\n\n/**\n * Stub registry provider that accepts componentList, toolRegistry, and componentToolAssociations as props\n * @returns The TamboStubRegistryProvider component\n */\nconst TamboStubRegistryProvider: React.FC<\n  PropsWithChildren<{\n    componentList: Record<string, any>;\n    toolRegistry: Record<string, TamboTool>;\n    componentToolAssociations: Record<string, string[]>;\n    registerComponent: (options: TamboComponent) => void;\n    registerTool: (tool: TamboTool) => void;\n    registerTools: (tools: TamboTool[]) => void;\n    addToolAssociation: (componentName: string, tool: TamboTool) => void;\n  }>\n> = ({\n  children,\n  componentList,\n  toolRegistry,\n  componentToolAssociations,\n  registerComponent,\n  registerTool,\n  registerTools,\n  addToolAssociation,\n}) => {\n  return (\n    <TamboRegistryContext.Provider\n      value={{\n        componentList,\n        toolRegistry,\n        componentToolAssociations,\n        registerComponent,\n        registerTool,\n        registerTools,\n        addToolAssociation,\n      }}\n    >\n      {children}\n    </TamboRegistryContext.Provider>\n  );\n};\n\n/**\n * Stub thread provider that accepts all thread context props\n * @returns The TamboStubThreadProvider component\n */\nconst TamboStubThreadProvider: React.FC<\n  PropsWithChildren<TamboThreadContextProps>\n> = ({ children, ...threadContextProps }) => {\n  return (\n    <TamboThreadContext.Provider value={threadContextProps}>\n      {children}\n    </TamboThreadContext.Provider>\n  );\n};\n\n/**\n * Default no-op functions that throw errors - used when callbacks are not provided\n * @returns The default callbacks\n */\nconst createDefaultCallbacks = () => ({\n  switchCurrentThread: () => {\n    throw new Error(\"switchCurrentThread not implemented in stub\");\n  },\n  startNewThread: () => {\n    throw new Error(\"startNewThread not implemented in stub\");\n  },\n  updateThreadName: () => {\n    throw new Error(\"updateThreadName not implemented in stub\");\n  },\n  generateThreadName: () => {\n    throw new Error(\"generateThreadName not implemented in stub\");\n  },\n  addThreadMessage: () => {\n    throw new Error(\"addThreadMessage not implemented in stub\");\n  },\n  updateThreadMessage: () => {\n    throw new Error(\"updateThreadMessage not implemented in stub\");\n  },\n  setInputValue: () => {\n    throw new Error(\"setInputValue not implemented in stub\");\n  },\n  sendThreadMessage: () => {\n    throw new Error(\"sendThreadMessage not implemented in stub\");\n  },\n  registerComponent: () => {\n    throw new Error(\"registerComponent not implemented in stub\");\n  },\n  registerTool: () => {\n    throw new Error(\"registerTool not implemented in stub\");\n  },\n  registerTools: () => {\n    throw new Error(\"registerTools not implemented in stub\");\n  },\n  addToolAssociation: () => {\n    throw new Error(\"addToolAssociation not implemented in stub\");\n  },\n  cancel: () => {\n    throw new Error(\"cancel not implemented in stub\");\n  },\n});\n\n/**\n * The TamboStubProvider provides a way to use the Tambo API with static/stub data.\n * This is useful for testing, samples, and static UI development.\n *\n * Unlike TamboProvider, all data must be provided as props rather than being inferred.\n * @example\n * ```tsx\n * import { TamboStubProvider } from '@tambo-ai/react-sdk';\n *\n * const exampleThread = {\n *   id: \"example-thread\",\n *   messages: [\n *     {\n *       id: \"msg-1\",\n *       role: \"user\",\n *       content: [{ type: \"text\", text: \"Hello!\" }],\n *       createdAt: new Date().toISOString(),\n *       threadId: \"example-thread\",\n *       componentState: {},\n *     },\n *     {\n *       id: \"msg-2\",\n *       role: \"assistant\",\n *       content: [{ type: \"text\", text: \"Hi there!\" }],\n *       createdAt: new Date().toISOString(),\n *       threadId: \"example-thread\",\n *       componentState: {},\n *     }\n *   ],\n *   createdAt: new Date().toISOString(),\n *   projectId: \"example-project\",\n *   updatedAt: new Date().toISOString(),\n *   metadata: {},\n * };\n *\n * const exampleThreadList = [exampleThread];\n *\n * function MyComponent() {\n *   return (\n *     <TamboStubProvider\n *       thread={exampleThread}\n *       components={[]}\n *       tools={[]}\n *       threads={exampleThreadList}\n *       projectId=\"example-project\"\n *     >\n *       <MessageThreadFull />\n *     </TamboStubProvider>\n *   );\n * }\n * ```\n * @param props - The props for the TamboStubProvider\n * @param props.children - The children to wrap\n * @param props.thread - The thread data to display\n * @param props.components - Optional components registry\n * @param props.tools - Optional tools registry\n * @param props.threads - Optional threads data to populate thread list (overrides useTamboThreadList)\n * @param props.projectId - Optional project ID for query cache (defaults to thread.projectId)\n * @param props.contextKey - Optional context key for thread list queries\n * @param props.contextHelpers - Optional configuration for which context helpers are enabled/disabled\n * @returns The TamboStubProvider component\n */\nexport const TamboStubProvider: React.FC<\n  PropsWithChildren<TamboStubProviderProps>\n> = ({\n  children,\n  thread,\n  components = [],\n  tools = [],\n  threads,\n  projectId,\n  contextKey,\n  contextHelpers,\n  ...overrides\n}) => {\n  const defaults = createDefaultCallbacks();\n\n  // Create stub client and queryClient\n  const stubClient = {} as TamboAI;\n  const stubQueryClient = new QueryClient();\n\n  // Use provided projectId or fall back to thread's projectId\n  const resolvedProjectId = projectId ?? thread.projectId;\n\n  // Build component registry from components prop\n  const componentList = components.reduce(\n    (acc, component) => {\n      acc[component.name] = {\n        component: component.component,\n        loadingComponent: component.loadingComponent,\n        name: component.name,\n        description: component.description,\n        props: component.propsDefinition ?? {},\n        contextTools: [],\n      };\n      return acc;\n    },\n    {} as Record<string, any>,\n  );\n\n  // Build tool registry from tools prop\n  const toolRegistry = tools.reduce(\n    (acc, tool) => {\n      acc[tool.name] = tool;\n      return acc;\n    },\n    {} as Record<string, TamboTool>,\n  );\n\n  // Build tool associations from components\n  const componentToolAssociations = components.reduce(\n    (acc, component) => {\n      if (component.associatedTools) {\n        acc[component.name] = component.associatedTools.map(\n          (tool) => tool.name,\n        );\n      }\n      return acc;\n    },\n    {} as Record<string, string[]>,\n  );\n\n  // Merge defaults with provided overrides\n  const threadContextProps: TamboThreadContextProps = {\n    thread,\n    switchCurrentThread:\n      overrides.switchCurrentThread ?? defaults.switchCurrentThread,\n    startNewThread: overrides.startNewThread ?? defaults.startNewThread,\n    updateThreadName: overrides.updateThreadName ?? defaults.updateThreadName,\n    generateThreadName:\n      overrides.generateThreadName ?? defaults.generateThreadName,\n    addThreadMessage: overrides.addThreadMessage ?? defaults.addThreadMessage,\n    updateThreadMessage:\n      overrides.updateThreadMessage ?? defaults.updateThreadMessage,\n    inputValue: overrides.inputValue ?? \"\",\n    streaming: overrides.streaming ?? true,\n    setInputValue: overrides.setInputValue ?? defaults.setInputValue,\n    sendThreadMessage:\n      overrides.sendThreadMessage ?? defaults.sendThreadMessage,\n    generationStage: overrides.generationStage ?? GenerationStage.IDLE,\n    generationStatusMessage: overrides.generationStatusMessage ?? \"\",\n    isIdle: overrides.isIdle ?? true,\n    cancel: overrides.cancel ?? defaults.cancel,\n  };\n\n  const componentContextProps: TamboComponentContextProps = {\n    registerComponent:\n      overrides.registerComponent ?? defaults.registerComponent,\n    registerTool: overrides.registerTool ?? defaults.registerTool,\n    registerTools: overrides.registerTools ?? defaults.registerTools,\n    addToolAssociation:\n      overrides.addToolAssociation ?? defaults.addToolAssociation,\n  };\n\n  return (\n    <TamboStubClientProvider\n      client={stubClient}\n      queryClient={stubQueryClient}\n      threads={threads}\n      projectId={resolvedProjectId}\n      contextKey={contextKey}\n    >\n      <TamboStubRegistryProvider\n        componentList={componentList}\n        toolRegistry={toolRegistry}\n        componentToolAssociations={componentToolAssociations}\n        registerComponent={componentContextProps.registerComponent}\n        registerTool={componentContextProps.registerTool}\n        registerTools={componentContextProps.registerTools}\n        addToolAssociation={componentContextProps.addToolAssociation}\n      >\n        <TamboStubThreadProvider {...threadContextProps}>\n          <TamboContextHelpersProvider contextHelpers={contextHelpers}>\n            <TamboComponentProvider>\n              <TamboCompositeProvider>{children}</TamboCompositeProvider>\n            </TamboComponentProvider>\n          </TamboContextHelpersProvider>\n        </TamboStubThreadProvider>\n      </TamboStubRegistryProvider>\n    </TamboStubClientProvider>\n  );\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-thread-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-thread-provider.tsx"],"names":[],"mappings":"AACA,OAAO,OAA0B,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,yDAAyD,CAAC;AACjF,OAAO,KAAK,EAAE,EAEZ,iBAAiB,EAOlB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,eAAe,EAEf,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAYpD,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,mCAAmC;IACnC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACjE,yBAAyB;IACzB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,6BAA6B;IAC7B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,gFAAgF;IAChF,kBAAkB,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,0CAA0C;IAC1C,gBAAgB,EAAE,CAChB,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,OAAO,KAClB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACnD,6CAA6C;IAC7C,mBAAmB,EAAE,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,OAAO,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB;IACtB,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2CAA2C;IAC3C,iBAAiB,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACzC,KACE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC,oFAAoF;IACpF,eAAe,EAAE,eAAe,CAAC;IACjC,6FAA6F;IAC7F,uBAAuB,EAAE,MAAM,CAAC;IAChC,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAOhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,wCA0D7B,CAAC;AAEH,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CACxC,iBAAiB,CAAC,wBAAwB,CAAC,CAwtB5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,+BAM1B,CAAC"}
+{"version":3,"file":"tambo-thread-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-thread-provider.tsx"],"names":[],"mappings":"AACA,OAAO,OAA0B,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,yDAAyD,CAAC;AACjF,OAAO,KAAK,EAAE,EAEZ,iBAAiB,EAOlB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,eAAe,EAEf,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAYpD,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,mCAAmC;IACnC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACjE,yBAAyB;IACzB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,6BAA6B;IAC7B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,gFAAgF;IAChF,kBAAkB,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,0CAA0C;IAC1C,gBAAgB,EAAE,CAChB,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,OAAO,KAClB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACnD,6CAA6C;IAC7C,mBAAmB,EAAE,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,OAAO,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB;IACtB,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,2CAA2C;IAC3C,iBAAiB,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACzC,KACE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC,oFAAoF;IACpF,eAAe,EAAE,eAAe,CAAC;IACjC,6FAA6F;IAC7F,uBAAuB,EAAE,MAAM,CAAC;IAChC,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAOhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,wCA0D7B,CAAC;AAEH,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CACxC,iBAAiB,CAAC,wBAAwB,CAAC,CAkuB5C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,+BAM1B,CAAC"}

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

@@ -42,6 +42,7 @@ const generate_component_1 = require("../util/generate-component");
 const registry_1 = require("../util/registry");
 const tool_caller_1 = require("../util/tool-caller");
 const tambo_client_provider_1 = require("./tambo-client-provider");
+const tambo_context_helpers_provider_1 = require("./tambo-context-helpers-provider");
 const tambo_registry_provider_1 = require("./tambo-registry-provider");
 /**
  * This is a stub entry for when the thread is not yet created, the first time
@@ -131,6 +132,7 @@ const TamboThreadProvider = ({ children, streaming = true }) => {
     });
     const client = (0, tambo_client_provider_1.useTamboClient)();
     const { componentList, toolRegistry, componentToolAssociations } = (0, tambo_registry_provider_1.useTamboRegistry)();
+    const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
     const [inputValue, setInputValue] = (0, react_1.useState)("");
     const [ignoreResponse, setIgnoreResponse] = (0, react_1.useState)(false);
     const ignoreResponseRef = (0, react_1.useRef)(ignoreResponse);
@@ -516,10 +518,16 @@ const TamboThreadProvider = ({ children, streaming = true }) => {
         setIgnoreResponse(false);
         const { threadId = currentThreadId ?? exports.PLACEHOLDER_THREAD.id, streamResponse = streaming, forceToolChoice, contextKey = currentThreadContextKey, additionalContext, } = options;
         updateThreadStatus(threadId, generate_component_response_1.GenerationStage.FETCHING_CONTEXT);
+        // Get additional context from enabled helpers
+        const helperContexts = await getAdditionalContext();
+        // Combine all contexts
         const combinedContext = {
-            system: (0, registry_1.getSystemContext)(),
             ...(additionalContext ?? {}),
         };
+        // Add helper contexts to combinedContext
+        for (const helperContext of helperContexts) {
+            combinedContext[helperContext.name] = helperContext.context;
+        }
         addThreadMessage({
             content: [{ type: "text", text: message }],
             renderedComponent: null,
@@ -619,6 +627,7 @@ const TamboThreadProvider = ({ children, streaming = true }) => {
         updateThreadStatus,
         handleAdvanceStream,
         streaming,
+        getAdditionalContext,
     ]);
     return (react_1.default.createElement(exports.TamboThreadContext.Provider, { value: {
             thread: currentThread,