@tambo-ai/react 0.46.5 → 0.48.0

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

@@ -3,6 +3,8 @@
 import React, { createContext, useCallback, useContext, useEffect, useState, } from "react";
 import { z } from "zod";
 import { useTamboComponent } from "./tambo-component-provider";
+import { useTamboContextHelpers } from "./tambo-context-helpers-provider";
+import { createInteractablesContextHelper } from "../context-helpers/current-interactables-context-helper";
 const TamboInteractableContext = createContext({
     interactableComponents: [],
     addInteractableComponent: () => "",
@@ -23,95 +25,109 @@ const TamboInteractableContext = createContext({
 export const TamboInteractableProvider = ({ children, }) => {
     const [interactableComponents, setInteractableComponents] = useState([]);
     const { registerTool } = useTamboComponent();
+    const { addContextHelper, removeContextHelper } = useTamboContextHelpers();
+    // Create a stable context helper function
+    const contextHelper = useCallback(() => {
+        return createInteractablesContextHelper(() => interactableComponents)();
+    }, [interactableComponents]);
+    // Register the default interactables context helper
     useEffect(() => {
-        registerTool({
-            name: "get_all_interactable_components",
-            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,
-                };
-            },
-            toolSchema: z.function().returns(z.object({
-                components: z.array(z.object({
-                    id: z.string(),
-                    componentName: z.string(),
-                    props: z.record(z.any()),
-                    propsSchema: z.object({}).optional(),
+        addContextHelper("interactables", contextHelper);
+        return () => {
+            removeContextHelper("interactables");
+        };
+    }, [contextHelper, addContextHelper, removeContextHelper]);
+    useEffect(() => {
+        if (interactableComponents.length > 0) {
+            registerTool({
+                name: "get_all_interactable_components",
+                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,
+                    };
+                },
+                toolSchema: z.function().returns(z.object({
+                    components: z.array(z.object({
+                        id: z.string(),
+                        componentName: z.string(),
+                        props: z.record(z.any()),
+                        propsSchema: z.object({}).optional(),
+                    })),
                 })),
-            })),
-        });
-        registerTool({
-            name: "get_interactable_component_by_id",
-            description: "Get a specific interactable component by its ID",
-            tool: (componentId) => {
-                const component = interactableComponents.find((c) => c.id === componentId);
-                if (!component) {
+            });
+            registerTool({
+                name: "get_interactable_component_by_id",
+                description: "Get a specific interactable component by its ID",
+                tool: (componentId) => {
+                    const component = interactableComponents.find((c) => c.id === componentId);
+                    if (!component) {
+                        return {
+                            success: false,
+                            error: `Component with ID ${componentId} not found`,
+                        };
+                    }
                     return {
-                        success: false,
-                        error: `Component with ID ${componentId} not found`,
+                        success: true,
+                        component: {
+                            id: component.id,
+                            componentName: component.name,
+                            props: component.props,
+                        },
                     };
-                }
-                return {
-                    success: true,
-                    component: {
-                        id: component.id,
-                        componentName: component.name,
-                        props: component.props,
-                    },
-                };
-            },
-            toolSchema: z
-                .function()
-                .args(z.string())
-                .returns(z.object({
-                success: z.boolean(),
-                component: z
-                    .object({
-                    id: z.string(),
-                    componentName: z.string(),
-                    props: z.record(z.any()),
-                })
-                    .optional(),
-                error: z.string().optional(),
-            })),
-        });
-        registerTool({
-            name: "remove_interactable_component",
-            description: "Remove an interactable component from the system",
-            tool: (componentId) => {
-                const component = interactableComponents.find((c) => c.id === componentId);
-                if (!component) {
+                },
+                toolSchema: z
+                    .function()
+                    .args(z.string())
+                    .returns(z.object({
+                    success: z.boolean(),
+                    component: z
+                        .object({
+                        id: z.string(),
+                        componentName: z.string(),
+                        props: z.record(z.any()),
+                    })
+                        .optional(),
+                    error: z.string().optional(),
+                })),
+            });
+            registerTool({
+                name: "remove_interactable_component",
+                description: "Remove an interactable component from the system",
+                tool: (componentId) => {
+                    const component = interactableComponents.find((c) => c.id === componentId);
+                    if (!component) {
+                        return {
+                            success: false,
+                            error: `Component with ID ${componentId} not found`,
+                        };
+                    }
+                    setInteractableComponents((prev) => prev.filter((c) => c.id !== componentId));
                     return {
-                        success: false,
-                        error: `Component with ID ${componentId} not found`,
+                        success: true,
+                        componentId,
+                        removedComponent: {
+                            id: component.id,
+                            componentName: component.name,
+                            props: component.props,
+                        },
                     };
-                }
-                setInteractableComponents((prev) => prev.filter((c) => c.id !== componentId));
-                return {
-                    success: true,
-                    componentId,
-                    removedComponent: {
-                        id: component.id,
-                        componentName: component.name,
-                        props: component.props,
-                    },
-                };
-            },
-            toolSchema: z
-                .function()
-                .args(z.string())
-                .returns(z.object({
-                success: z.boolean(),
-                componentId: z.string(),
-                removedComponent: z.object({
-                    id: z.string(),
-                    componentName: z.string(),
-                    props: z.record(z.any()),
-                }),
-                error: z.string().optional(),
-            })),
-        });
+                },
+                toolSchema: z
+                    .function()
+                    .args(z.string())
+                    .returns(z.object({
+                    success: z.boolean(),
+                    componentId: z.string(),
+                    removedComponent: z.object({
+                        id: z.string(),
+                        componentName: z.string(),
+                        props: z.record(z.any()),
+                    }),
+                    error: z.string().optional(),
+                })),
+            });
+        }
     }, [interactableComponents, registerTool]);
     const updateInteractableComponentProps = useCallback((id, newProps) => {
         let updateResult = "Updated successfully";
@@ -160,7 +176,7 @@ export const TamboInteractableProvider = ({ children, }) => {
         });
     }, [registerTool, updateInteractableComponentProps]);
     const addInteractableComponent = useCallback((component) => {
-        const id = `${component.name}-${Math.random().toString(36).substr(2, 9)}`;
+        const id = `${component.name}-${Math.random().toString(36).slice(2, 11)}`;
         const newComponent = {
             ...component,
             id,
@@ -202,4 +218,19 @@ export const TamboInteractableProvider = ({ children, }) => {
 export const useTamboInteractable = () => {
     return useContext(TamboInteractableContext);
 };
+/**
+ * Hook to get a cloned snapshot of the current interactables.
+ * Returns a shallow copy of the array with cloned items and props to prevent
+ * external mutation from affecting internal state.
+ * @returns The current interactables snapshot (cloned).
+ */
+export const useCurrentInteractablesSnapshot = () => {
+    const { interactableComponents } = useTamboInteractable();
+    // Clone the array and each item/props to prevent mutation
+    const copy = interactableComponents.map((c) => ({
+        ...c,
+        props: { ...c.props },
+    }));
+    return copy;
+};
 //# sourceMappingURL=tambo-interactable-provider.js.map

package/esm/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        \"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"]}
+{"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\";\nimport { useTamboContextHelpers } from \"./tambo-context-helpers-provider\";\nimport { createInteractablesContextHelper } from \"../context-helpers/current-interactables-context-helper\";\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  const { addContextHelper, removeContextHelper } = useTamboContextHelpers();\n\n  // Create a stable context helper function\n  const contextHelper = useCallback(() => {\n    return createInteractablesContextHelper(() => interactableComponents)();\n  }, [interactableComponents]);\n\n  // Register the default interactables context helper\n  useEffect(() => {\n    addContextHelper(\"interactables\", contextHelper);\n\n    return () => {\n      removeContextHelper(\"interactables\");\n    };\n  }, [contextHelper, addContextHelper, removeContextHelper]);\n\n  useEffect(() => {\n    if (interactableComponents.length > 0) {\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    }\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).slice(2, 11)}`;\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\n/**\n * Hook to get a cloned snapshot of the current interactables.\n * Returns a shallow copy of the array with cloned items and props to prevent\n * external mutation from affecting internal state.\n * @returns The current interactables snapshot (cloned).\n */\nexport const useCurrentInteractablesSnapshot = () => {\n  const { interactableComponents } = useTamboInteractable();\n\n  // Clone the array and each item/props to prevent mutation\n  const copy = interactableComponents.map((c) => ({\n    ...c,\n    props: { ...c.props },\n  }));\n\n  return copy;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tambo-ai/react",
-  "version": "0.46.5",
+  "version": "0.48.0",
   "description": "React client package for Tambo AI",
   "repository": {
     "type": "git",
@@ -74,12 +74,12 @@
     "react-fast-compare": "^3.2.2",
     "ts-essentials": "^10.1.1",
     "ts-node": "^10.9.2",
-    "use-debounce": "^10.0.5",
+    "use-debounce": "^10.0.6",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },
   "devDependencies": {
-    "@eslint/js": "^9.34.0",
+    "@eslint/js": "^9.35.0",
     "@tambo-ai/eslint-config": "*",
     "@tambo-ai/typescript-config": "*",
     "@testing-library/jest-dom": "^6.8.0",
@@ -90,12 +90,12 @@
     "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",
     "concurrently": "^9.2.1",
-    "eslint": "^9.34.0",
-    "eslint-plugin-jsdoc": "^54.1.1",
+    "eslint": "^9.35.0",
+    "eslint-plugin-jsdoc": "^55.0.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.1.0",
-    "jest": "^30.1.1",
-    "jest-environment-jsdom": "^30.1.1",
+    "jest": "^30.1.3",
+    "jest-environment-jsdom": "^30.1.2",
     "lint-staged": "^16.1.5",
     "prettier": "^3.6.2",
     "prettier-2": "npm:prettier@^2",
@@ -103,6 +103,6 @@
     "react-dom": "^18.3.1",
     "ts-jest": "^29.4.1",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.41.0"
+    "typescript-eslint": "^8.43.0"
   }
 }

package/dist/mcp/mcp-tools-client.d.ts

@@ -1,96 +0,0 @@
-/**
- * Minimal Model Context Protocol (MCP) client using JSON-RPC 2.0
- * Supports only listTools() and callTool() operations
- */
-/**
- * Interface representing a Tool in the MCP
- */
-export interface Tool {
-    name: string;
-    description?: string;
-    inputSchema: {
-        type: "object";
-        properties: Record<string, any>;
-        required?: string[];
-    };
-    annotations?: Record<string, any>;
-}
-/**
- * Response from tools/list endpoint
- */
-export interface ListToolsResult {
-    tools: Tool[];
-}
-/**
- * Content type for tool responses
- */
-export interface ToolContent {
-    type: string;
-    text?: string;
-    annotations?: Record<string, any>;
-}
-/**
- * Response from tools/call endpoint
- */
-export interface CallToolResult {
-    content: ToolContent[];
-    isError?: boolean;
-}
-/**
- * A minimal TypeScript client for the Model Context Protocol (MCP)
- *
- * This client provides a streamlined interface to communicate with MCP servers
- * using JSON-RPC 2.0 over HTTP. It supports listing available tools and calling tools
- * with arguments, including support for Server-Sent Events (SSE) streaming responses.
- * @example
- * ```typescript
- * // Basic usage
- * const mcpClient = new MCPClient('https://example.com/mcp');
- * const tools = await mcpClient.listTools();
- * const toolResponse = await mcpClient.callTool('my-tool', { arg1: 'value1' });
- *
- * // For streaming responses:
- * const stream = await mcpClient.callToolStream('streaming-tool', { arg1: 'value1' });
- * for await (const chunk of mcpClient.parseStreamingResponses(stream)) {
- *   console.log('Received chunk:', chunk);
- * }
- * ```
- */
-export declare class MCPClient {
-    private baseUrl;
-    private headers;
-    private requestId;
-    /**
-     * Creates a new MCP client
-     * @param url - The base URL of the MCP server
-     * @param extraHeaders - Optional additional headers to include in requests
-     */
-    constructor(url: string, extraHeaders?: Record<string, string>);
-    /**
-     * Lists available tools on the MCP server
-     * @returns Promise resolving to the list of available tools
-     */
-    listTools(): Promise<ListToolsResult>;
-    /**
-     * Calls a tool with the provided arguments
-     * @param toolName - The name of the tool to call
-     * @param args - The arguments to pass to the tool
-     * @returns Promise resolving to the tool's response
-     */
-    callTool(toolName: string, args: any): Promise<CallToolResult>;
-    /**
-     * Calls a tool with the provided arguments and returns a stream of results
-     * @param toolName - The name of the tool to call
-     * @param args - The arguments to pass to the tool
-     * @returns ReadableStream of the tool's response
-     */
-    callToolStream(toolName: string, args: any): Promise<ReadableStream<Uint8Array>>;
-    /**
-     * Parse SSE messages from a stream into JSON-RPC responses
-     * @param stream - ReadableStream to parse
-     * @returns AsyncGenerator yielding parsed JSON-RPC responses
-     * @yields {CallToolResult} The parsed JSON-RPC response
-     */
-    parseStreamingResponses(stream: ReadableStream<Uint8Array>): AsyncGenerator<CallToolResult, void, unknown>;
-}
-//# sourceMappingURL=mcp-tools-client.d.ts.map

package/dist/mcp/mcp-tools-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools-client.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-tools-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAK;IAEtB;;;;OAIG;gBACS,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAS9D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAgC3C;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAmCpE;;;;;OAKG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAkCtC;;;;;OAKG;IACI,uBAAuB,CAC5B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,cAAc,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC;CAwCjD"}

package/dist/mcp/mcp-tools-client.js

@@ -1,178 +0,0 @@
-"use strict";
-/**
- * Minimal Model Context Protocol (MCP) client using JSON-RPC 2.0
- * Supports only listTools() and callTool() operations
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCPClient = void 0;
-/**
- * A minimal TypeScript client for the Model Context Protocol (MCP)
- *
- * This client provides a streamlined interface to communicate with MCP servers
- * using JSON-RPC 2.0 over HTTP. It supports listing available tools and calling tools
- * with arguments, including support for Server-Sent Events (SSE) streaming responses.
- * @example
- * ```typescript
- * // Basic usage
- * const mcpClient = new MCPClient('https://example.com/mcp');
- * const tools = await mcpClient.listTools();
- * const toolResponse = await mcpClient.callTool('my-tool', { arg1: 'value1' });
- *
- * // For streaming responses:
- * const stream = await mcpClient.callToolStream('streaming-tool', { arg1: 'value1' });
- * for await (const chunk of mcpClient.parseStreamingResponses(stream)) {
- *   console.log('Received chunk:', chunk);
- * }
- * ```
- */
-class MCPClient {
-    baseUrl;
-    headers;
-    requestId = 1;
-    /**
-     * Creates a new MCP client
-     * @param url - The base URL of the MCP server
-     * @param extraHeaders - Optional additional headers to include in requests
-     */
-    constructor(url, extraHeaders) {
-        this.baseUrl = url.endsWith("/") ? url : `${url}/`;
-        this.headers = {
-            "Content-Type": "application/json",
-            Accept: "application/json",
-            ...(extraHeaders ?? {}),
-        };
-    }
-    /**
-     * Lists available tools on the MCP server
-     * @returns Promise resolving to the list of available tools
-     */
-    async listTools() {
-        const jsonRpcRequest = {
-            jsonrpc: "2.0",
-            method: "tools/list",
-            params: {},
-            id: this.requestId++,
-        };
-        const response = await fetch(this.baseUrl, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(jsonRpcRequest),
-        });
-        if (!response.ok) {
-            throw new Error(`Failed to list tools: ${response.status} ${response.statusText}`);
-        }
-        const jsonRpcResponse = await response.json();
-        // Handle JSON-RPC error
-        if (jsonRpcResponse.error) {
-            throw new Error(`JSON-RPC error: ${jsonRpcResponse.error.code} - ${jsonRpcResponse.error.message}`);
-        }
-        return jsonRpcResponse.result;
-    }
-    /**
-     * Calls a tool with the provided arguments
-     * @param toolName - The name of the tool to call
-     * @param args - The arguments to pass to the tool
-     * @returns Promise resolving to the tool's response
-     */
-    async callTool(toolName, args) {
-        const jsonRpcRequest = {
-            jsonrpc: "2.0",
-            method: "tools/call",
-            params: {
-                name: toolName,
-                arguments: args,
-            },
-            id: this.requestId++,
-        };
-        const response = await fetch(this.baseUrl, {
-            method: "POST",
-            headers: this.headers,
-            body: JSON.stringify(jsonRpcRequest),
-        });
-        if (!response.ok) {
-            throw new Error(`Failed to call tool ${toolName}: ${response.status} ${response.statusText}`);
-        }
-        const jsonRpcResponse = await response.json();
-        // Handle JSON-RPC error
-        if (jsonRpcResponse.error) {
-            throw new Error(`JSON-RPC error: ${jsonRpcResponse.error.code} - ${jsonRpcResponse.error.message}`);
-        }
-        return jsonRpcResponse.result;
-    }
-    /**
-     * Calls a tool with the provided arguments and returns a stream of results
-     * @param toolName - The name of the tool to call
-     * @param args - The arguments to pass to the tool
-     * @returns ReadableStream of the tool's response
-     */
-    async callToolStream(toolName, args) {
-        const jsonRpcRequest = {
-            jsonrpc: "2.0",
-            method: "tools/call",
-            params: {
-                name: toolName,
-                arguments: args,
-            },
-            id: this.requestId++,
-        };
-        const response = await fetch(this.baseUrl, {
-            method: "POST",
-            headers: {
-                ...this.headers,
-                Accept: "text/event-stream",
-            },
-            body: JSON.stringify(jsonRpcRequest),
-        });
-        if (!response.ok) {
-            throw new Error(`Failed to call tool ${toolName}: ${response.status} ${response.statusText}`);
-        }
-        if (!response.body) {
-            throw new Error("Response body is null");
-        }
-        // Return the response body as a stream
-        return response.body;
-    }
-    /**
-     * Parse SSE messages from a stream into JSON-RPC responses
-     * @param stream - ReadableStream to parse
-     * @returns AsyncGenerator yielding parsed JSON-RPC responses
-     * @yields {CallToolResult} The parsed JSON-RPC response
-     */
-    async *parseStreamingResponses(stream) {
-        const reader = stream.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
-        try {
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done)
-                    break;
-                buffer += decoder.decode(value, { stream: true });
-                // Process complete SSE messages
-                const lines = buffer.split("\n\n");
-                buffer = lines.pop() ?? "";
-                for (const line of lines) {
-                    if (line.startsWith("data: ")) {
-                        const jsonData = line.slice(6).trim();
-                        try {
-                            const jsonRpcResponse = JSON.parse(jsonData);
-                            // Handle JSON-RPC error
-                            if (jsonRpcResponse.error) {
-                                throw new Error(`JSON-RPC error: ${jsonRpcResponse.error.code} - ${jsonRpcResponse.error.message}`);
-                            }
-                            yield jsonRpcResponse.result;
-                        }
-                        catch (e) {
-                            console.error("Failed to parse JSON:", e);
-                        }
-                    }
-                }
-            }
-        }
-        finally {
-            reader.releaseLock();
-        }
-    }
-}
-exports.MCPClient = MCPClient;
-//# sourceMappingURL=mcp-tools-client.js.map