@tambo-ai/react 1.2.1 → 1.2.3

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

@@ -21,20 +21,8 @@ const TamboInteractableContext = createContext({
     setInteractableSelected: () => { },
     clearInteractableSelections: () => { },
 });
-/**
- * Returns the per-component tool names that get registered for a given interactable ID.
- * @param id - The interactable component ID
- * @returns The tool names for props and state updates
- */
-function perComponentToolNames(id) {
-    return [`update_component_props_${id}`, `update_component_state_${id}`];
-}
-/** Tool names registered globally when at least one interactable component exists. */
-const GLOBAL_INTERACTABLE_TOOL_NAMES = [
-    "get_all_interactable_components",
-    "get_interactable_component_by_id",
-    "remove_interactable_component",
-];
+/** Synthetic owner ID used to track global interactable tools in the registry. */
+const GLOBAL_INTERACTABLE_OWNER = "__interactable_global__";
 /**
  * The TamboInteractableProvider manages a list of components that are currently
  * interactable, allowing tambo to interact with them by updating their props. It also registers tools
@@ -45,8 +33,29 @@ const GLOBAL_INTERACTABLE_TOOL_NAMES = [
  */
 export const TamboInteractableProvider = ({ children, }) => {
     const [interactableComponents, setInteractableComponents] = useState([]);
+    const [, setToolComponentOwnership] = useState({});
     const { registerTool, unregisterTools } = useTamboRegistry();
     const { addContextHelper, removeContextHelper } = useTamboContextHelpers();
+    const registerToolForComponent = useCallback((componentId, tool) => {
+        registerTool(tool);
+        setToolComponentOwnership((prev) => {
+            const existing = prev[componentId] ?? [];
+            if (existing.includes(tool.name))
+                return prev;
+            return { ...prev, [componentId]: [...existing, tool.name] };
+        });
+    }, [registerTool]);
+    const unregisterToolsForComponent = useCallback((componentId) => {
+        setToolComponentOwnership((prev) => {
+            const toolNames = prev[componentId];
+            if (!toolNames || toolNames.length === 0)
+                return prev;
+            unregisterTools(toolNames);
+            const next = { ...prev };
+            delete next[componentId];
+            return next;
+        });
+    }, [unregisterTools]);
     // Create a stable context helper function for interactable components
     const interactablesContextHelper = useMemo(() => createInteractablesContextHelper(interactableComponents), [interactableComponents]);
     // Register the interactables context helper
@@ -58,7 +67,7 @@ export const TamboInteractableProvider = ({ children, }) => {
     }, [interactablesContextHelper, addContextHelper, removeContextHelper]);
     useEffect(() => {
         if (interactableComponents.length > 0) {
-            registerTool({
+            registerToolForComponent(GLOBAL_INTERACTABLE_OWNER, {
                 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: () => {
@@ -76,7 +85,7 @@ export const TamboInteractableProvider = ({ children, }) => {
                     })),
                 }),
             });
-            registerTool({
+            registerToolForComponent(GLOBAL_INTERACTABLE_OWNER, {
                 name: "get_interactable_component_by_id",
                 description: "Get a specific interactable component by its ID",
                 tool: ({ componentId }) => {
@@ -116,7 +125,7 @@ export const TamboInteractableProvider = ({ children, }) => {
                     }),
                 ]),
             });
-            registerTool({
+            registerToolForComponent(GLOBAL_INTERACTABLE_OWNER, {
                 name: "remove_interactable_component",
                 description: "Remove an interactable component from the system",
                 tool: ({ componentId }) => {
@@ -127,7 +136,7 @@ export const TamboInteractableProvider = ({ children, }) => {
                             error: `Component with ID ${componentId} not found`,
                         };
                     }
-                    unregisterTools(perComponentToolNames(componentId));
+                    unregisterToolsForComponent(componentId);
                     setInteractableComponents((prev) => prev.filter((c) => c.id !== componentId));
                     return {
                         success: true,
@@ -161,9 +170,13 @@ export const TamboInteractableProvider = ({ children, }) => {
         }
         else {
             // No interactable components — remove the global tools
-            unregisterTools(GLOBAL_INTERACTABLE_TOOL_NAMES);
+            unregisterToolsForComponent(GLOBAL_INTERACTABLE_OWNER);
         }
-    }, [interactableComponents, registerTool, unregisterTools]);
+    }, [
+        interactableComponents,
+        registerToolForComponent,
+        unregisterToolsForComponent,
+    ]);
     const updateInteractableComponentProps = useCallback((id, newProps) => {
         if (!newProps || Object.keys(newProps).length === 0) {
             return `Warning: No props provided for component with ID ${id}.`;
@@ -245,10 +258,10 @@ export const TamboInteractableProvider = ({ children, }) => {
             },
             required: ["componentId", "newProps"],
         };
-        registerTool({
+        registerToolForComponent(component.id, {
             name: `${tamboToolNamePart}${component.id}`,
             description: `Update the props of interactable component ${component.id} (${component.name}). Provide partial props (only props to change).`,
-            tool: ({ componentId, newProps }) => {
+            tool: ({ componentId, newProps, }) => {
                 return updateInteractableComponentProps(componentId, newProps);
             },
             inputSchema,
@@ -258,7 +271,7 @@ export const TamboInteractableProvider = ({ children, }) => {
                 ...component.annotations,
             },
         });
-    }, [registerTool, updateInteractableComponentProps]);
+    }, [registerToolForComponent, updateInteractableComponentProps]);
     const registerInteractableComponentStateUpdateTool = useCallback((component, maxNameLength = 60) => {
         const tamboToolNamePart = `update_component_state_`;
         const availableLength = maxNameLength - tamboToolNamePart.length;
@@ -290,10 +303,10 @@ export const TamboInteractableProvider = ({ children, }) => {
             },
             required: ["componentId", "newState"],
         };
-        registerTool({
+        registerToolForComponent(component.id, {
             name: `${tamboToolNamePart}${component.id}`,
             description: `Update the state of interactable component ${component.id} (${component.name}). You may provide partial state (only keys to change).`,
-            tool: ({ componentId, newState }) => {
+            tool: ({ componentId, newState, }) => {
                 return updateInteractableComponentState(componentId, newState);
             },
             inputSchema,
@@ -303,7 +316,7 @@ export const TamboInteractableProvider = ({ children, }) => {
                 ...component.annotations,
             },
         });
-    }, [registerTool, updateInteractableComponentState]);
+    }, [registerToolForComponent, updateInteractableComponentState]);
     const addInteractableComponent = useCallback((component) => {
         // Validate component name
         assertValidName(component.name, "component");
@@ -326,9 +339,9 @@ export const TamboInteractableProvider = ({ children, }) => {
         registerInteractableComponentStateUpdateTool,
     ]);
     const removeInteractableComponent = useCallback((id) => {
-        unregisterTools(perComponentToolNames(id));
+        unregisterToolsForComponent(id);
         setInteractableComponents((prev) => prev.filter((c) => c.id !== id));
-    }, [unregisterTools]);
+    }, [unregisterToolsForComponent]);
     const getInteractableComponent = useCallback((id) => {
         return interactableComponents.find((c) => c.id === id);
     }, [interactableComponents]);
@@ -336,10 +349,11 @@ export const TamboInteractableProvider = ({ children, }) => {
         return interactableComponents.filter((c) => c.name === componentName);
     }, [interactableComponents]);
     const clearAllInteractableComponents = useCallback(() => {
-        const toolNames = interactableComponents.flatMap((c) => perComponentToolNames(c.id));
-        unregisterTools(toolNames);
+        for (const component of interactableComponents) {
+            unregisterToolsForComponent(component.id);
+        }
         setInteractableComponents([]);
-    }, [interactableComponents, unregisterTools]);
+    }, [interactableComponents, unregisterToolsForComponent]);
     const setInteractableStateValue = useCallback((componentId, key, value) => {
         setInteractableComponents((prev) => {
             const component = prev.find((c) => c.id === componentId);

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 { deepEqual } from \"fast-equals\";\nimport { JSONSchema7 } from \"json-schema\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport { z } from \"zod/v3\";\nimport { createInteractablesContextHelper } from \"../context-helpers/current-interactables-context-helper\";\nimport {\n  TamboInteractableComponent,\n  type TamboInteractableContext,\n} from \"../model/tambo-interactable\";\nimport { makeJsonSchemaPartial, schemaToJsonSchema } from \"../schema\";\nimport { assertValidName } from \"../util/validate-component-name\";\nimport { useTamboRegistry } from \"./tambo-registry-provider\";\nimport { useTamboContextHelpers } from \"./tambo-context-helpers-provider\";\n\nconst TamboInteractableContext = createContext<TamboInteractableContext>({\n  interactableComponents: [],\n  addInteractableComponent: () => \"\",\n  removeInteractableComponent: () => {},\n  updateInteractableComponentProps: () => \"\",\n  getInteractableComponent: () => undefined,\n  getInteractableComponentsByName: () => [],\n  clearAllInteractableComponents: () => {},\n  setInteractableState: () => {},\n  getInteractableComponentState: () => undefined,\n  setInteractableSelected: () => {},\n  clearInteractableSelections: () => {},\n});\n\n/**\n * Returns the per-component tool names that get registered for a given interactable ID.\n * @param id - The interactable component ID\n * @returns The tool names for props and state updates\n */\nfunction perComponentToolNames(id: string): [string, string] {\n  return [`update_component_props_${id}`, `update_component_state_${id}`];\n}\n\n/** Tool names registered globally when at least one interactable component exists. */\nconst GLOBAL_INTERACTABLE_TOOL_NAMES = [\n  \"get_all_interactable_components\",\n  \"get_interactable_component_by_id\",\n  \"remove_interactable_component\",\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, unregisterTools } = useTamboRegistry();\n  const { addContextHelper, removeContextHelper } = useTamboContextHelpers();\n\n  // Create a stable context helper function for interactable components\n  const interactablesContextHelper = useMemo(\n    () => createInteractablesContextHelper(interactableComponents),\n    [interactableComponents],\n  );\n\n  // Register the interactables context helper\n  useEffect(() => {\n    addContextHelper(\"interactables\", interactablesContextHelper);\n\n    return () => {\n      removeContextHelper(\"interactables\");\n    };\n  }, [interactablesContextHelper, 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        inputSchema: z.object({}),\n        outputSchema: z.object({\n          components: z.array(\n            z.object({\n              id: z.string(),\n              name: z.string(),\n              props: z.record(z.string(), z.any()),\n              propsSchema: z.record(z.string(), z.any()).optional(),\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 }) => {\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            } as const;\n          }\n\n          return {\n            success: true,\n            component: {\n              id: component.id,\n              componentName: component.name,\n              props: component.props,\n            },\n          } as const;\n        },\n        inputSchema: z.object({\n          componentId: z.string().describe(\"The ID of the component\"),\n        }),\n        outputSchema: z.discriminatedUnion(\"success\", [\n          z.object({\n            success: z.literal(true),\n            component: z\n              .object({\n                id: z.string(),\n                componentName: z.string(),\n                props: z.record(z.string(), z.any()),\n              })\n              .optional(),\n          }),\n          z.object({\n            success: z.literal(false),\n            error: z.string(),\n          }),\n        ]),\n      });\n\n      registerTool({\n        name: \"remove_interactable_component\",\n        description: \"Remove an interactable component from the system\",\n        tool: ({ componentId }) => {\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            } as const;\n          }\n\n          unregisterTools(perComponentToolNames(componentId));\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          } as const;\n        },\n        inputSchema: z.object({\n          componentId: z.string().describe(\"The ID of the component\"),\n        }),\n        outputSchema: z.discriminatedUnion(\"success\", [\n          z.object({\n            success: z.literal(true),\n            componentId: z.string(),\n            removedComponent: z.object({\n              id: z.string(),\n              componentName: z.string(),\n              props: z.record(z.string(), z.any()),\n            }),\n          }),\n          z.object({\n            success: z.literal(false),\n            error: z.string(),\n          }),\n        ]),\n      });\n    } else {\n      // No interactable components — remove the global tools\n      unregisterTools(GLOBAL_INTERACTABLE_TOOL_NAMES);\n    }\n  }, [interactableComponents, registerTool, unregisterTools]);\n\n  const updateInteractableComponentProps = useCallback(\n    (id: string, newProps: Record<string, any>): string => {\n      if (!newProps || Object.keys(newProps).length === 0) {\n        return `Warning: No props provided for component with ID ${id}.`;\n      }\n\n      setInteractableComponents((prev) => {\n        const component = prev.find((c) => c.id === id);\n        if (!component) {\n          return prev;\n        }\n\n        // Compare props shallowly\n        const propsChanged = Object.entries(newProps).some(([key, value]) => {\n          return component.props[key] !== value;\n        });\n\n        if (!propsChanged) {\n          return prev; // unchanged\n        }\n\n        // Apply partial update\n        const updated = {\n          ...component,\n          props: { ...component.props, ...newProps },\n        };\n\n        const updatedComponents = [...prev];\n        const idx = prev.findIndex((c) => c.id === id);\n        updatedComponents[idx] = updated;\n\n        return updatedComponents;\n      });\n\n      return \"Updated successfully\";\n    },\n    [],\n  );\n\n  const updateInteractableComponentState = useCallback(\n    (componentId: string, newState: Record<string, unknown>): string => {\n      if (!newState || Object.keys(newState).length === 0) {\n        return `Warning: No state values provided for component with ID ${componentId}.`;\n      }\n\n      setInteractableComponents((components = []) => {\n        const component = components.find((c) => c.id === componentId);\n        if (!component) return components;\n\n        const prevState = component.state ?? {};\n        const updatedState = { ...prevState, ...newState };\n        if (deepEqual(prevState, updatedState)) return components;\n\n        // TODO(lachieh): validate state against schema?\n\n        const updated = {\n          ...component,\n          state: updatedState,\n        };\n\n        return components.map((c) => (c.id === componentId ? updated : c));\n      });\n\n      return \"Updated successfully\";\n    },\n    [],\n  );\n\n  const registerInteractableComponentPropsUpdateTool = useCallback(\n    (component: TamboInteractableComponent, maxNameLength = 60) => {\n      const tamboToolNamePart = `update_component_props_`;\n      const availableLength = maxNameLength - tamboToolNamePart.length;\n      if (component.id.length > availableLength) {\n        throw new Error(\n          `Interactable component id ${component.id} is too long. It must be less than ${availableLength} characters.`,\n        );\n      }\n\n      // Build newProps schema as JSON Schema\n      let newPropsSchema: JSONSchema7;\n      if (component.propsSchema) {\n        // Convert any supported schema to JSON Schema, then make partial\n        const fullSchema = schemaToJsonSchema(component.propsSchema);\n        newPropsSchema = makeJsonSchemaPartial(fullSchema);\n      } else {\n        // No schema - allow any properties\n        newPropsSchema = { type: \"object\", additionalProperties: true };\n      }\n\n      // Build the full input schema as JSON Schema\n      const inputSchema: JSONSchema7 = {\n        type: \"object\",\n        properties: {\n          componentId: {\n            type: \"string\",\n            description: \"The ID of the interactable component to update\",\n          },\n          newProps: {\n            ...newPropsSchema,\n            description:\n              \"The props to update. Provide only the props you want to change.\",\n          },\n        },\n        required: [\"componentId\", \"newProps\"],\n      };\n\n      registerTool({\n        name: `${tamboToolNamePart}${component.id}`,\n        description: `Update the props of interactable component ${component.id} (${component.name}). Provide partial props (only props to change).`,\n        tool: ({ componentId, newProps }) => {\n          return updateInteractableComponentProps(componentId, newProps);\n        },\n        inputSchema,\n        outputSchema: z.string(),\n        annotations: {\n          tamboStreamableHint: true,\n          ...component.annotations,\n        },\n      });\n    },\n    [registerTool, updateInteractableComponentProps],\n  );\n\n  const registerInteractableComponentStateUpdateTool = useCallback(\n    (component: TamboInteractableComponent, maxNameLength = 60) => {\n      const tamboToolNamePart = `update_component_state_`;\n      const availableLength = maxNameLength - tamboToolNamePart.length;\n      if (component.id.length > availableLength) {\n        throw new Error(\n          `Interactable component id ${component.id} is too long. It must be less than ${availableLength} characters.`,\n        );\n      }\n\n      // Build newState schema as JSON Schema\n      let newStateSchema: JSONSchema7 = {\n        type: \"object\",\n        additionalProperties: true,\n      };\n      if (component.stateSchema) {\n        // Convert any supported schema to JSON Schema, then make partial\n        const fullSchema = schemaToJsonSchema(component.stateSchema);\n        newStateSchema = makeJsonSchemaPartial(fullSchema);\n      }\n\n      // Build the full input schema as JSON Schema\n      const inputSchema: JSONSchema7 = {\n        type: \"object\",\n        properties: {\n          componentId: {\n            type: \"string\",\n            description: \"The ID of the interactable component to update\",\n          },\n          newState: {\n            ...newStateSchema,\n            description:\n              \"The state values to update. Provide only the keys you want to change.\",\n          },\n        },\n        required: [\"componentId\", \"newState\"],\n      };\n\n      registerTool({\n        name: `${tamboToolNamePart}${component.id}`,\n        description: `Update the state of interactable component ${component.id} (${component.name}). You may provide partial state (only keys to change).`,\n        tool: ({ componentId, newState }) => {\n          return updateInteractableComponentState(componentId, newState);\n        },\n        inputSchema,\n        outputSchema: z.string(),\n        annotations: {\n          tamboStreamableHint: true,\n          ...component.annotations,\n        },\n      });\n    },\n    [registerTool, updateInteractableComponentState],\n  );\n\n  const addInteractableComponent = useCallback(\n    (\n      component: Omit<TamboInteractableComponent, \"id\" | \"createdAt\">,\n    ): string => {\n      // Validate component name\n      assertValidName(component.name, \"component\");\n\n      // Add a random part to the component name to make it unique when using multiple instances of the same component.\n      const tamboGeneratedNamePart = `-${Math.random().toString(36).slice(2, 5)}`;\n      const id = `${component.name}${tamboGeneratedNamePart}`;\n      const newComponent: TamboInteractableComponent = {\n        ...component,\n        id,\n        state: component.state ?? {},\n      };\n\n      registerInteractableComponentPropsUpdateTool(newComponent);\n      registerInteractableComponentStateUpdateTool(newComponent);\n\n      setInteractableComponents((prev) => {\n        return [...prev, newComponent];\n      });\n\n      return id;\n    },\n    [\n      registerInteractableComponentPropsUpdateTool,\n      registerInteractableComponentStateUpdateTool,\n    ],\n  );\n\n  const removeInteractableComponent = useCallback(\n    (id: string) => {\n      unregisterTools(perComponentToolNames(id));\n      setInteractableComponents((prev) => prev.filter((c) => c.id !== id));\n    },\n    [unregisterTools],\n  );\n\n  const getInteractableComponent = useCallback(\n    <P, S>(id: string): TamboInteractableComponent<P, S> | undefined => {\n      return interactableComponents.find((c) => c.id === id) as\n        | TamboInteractableComponent<P, S>\n        | undefined;\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    const toolNames = interactableComponents.flatMap((c) =>\n      perComponentToolNames(c.id),\n    );\n    unregisterTools(toolNames);\n    setInteractableComponents([]);\n  }, [interactableComponents, unregisterTools]);\n\n  const setInteractableStateValue = useCallback(\n    (componentId: string, key: string, value: unknown) => {\n      setInteractableComponents((prev) => {\n        const component = prev.find((c) => c.id === componentId);\n        if (!component) {\n          console.warn(\n            `Tried to update state for component ${componentId} but it was not found.`,\n          );\n          return prev;\n        }\n\n        const updated = {\n          ...component,\n          state: {\n            ...component.state,\n            [key]: value,\n          },\n        };\n\n        const updatedComponents = prev.map((component) => {\n          if (component.id === componentId) {\n            return updated;\n          }\n          return component;\n        });\n\n        return updatedComponents;\n      });\n    },\n    [],\n  );\n\n  const getInteractableComponentState = useCallback(\n    (componentId: string) => {\n      const component = interactableComponents.find(\n        (c) => c.id === componentId,\n      );\n      return component?.state;\n    },\n    [interactableComponents],\n  );\n\n  const setInteractableSelected = useCallback(\n    (componentId: string, isSelected: boolean) => {\n      setInteractableComponents((prev) => {\n        let found = false;\n        const next = prev.map((component) => {\n          if (component.id !== componentId) return component;\n          found = true;\n          return component.isSelected === isSelected\n            ? component\n            : { ...component, isSelected: isSelected };\n        });\n        return found ? next : prev;\n      });\n    },\n    [],\n  );\n\n  const clearInteractableSelections = useCallback(() => {\n    setInteractableComponents((prev) => {\n      if (!prev.some((c) => c.isSelected)) return prev;\n      return prev.map((c) => (c.isSelected ? { ...c, isSelected: false } : c));\n    });\n  }, []);\n\n  const value: TamboInteractableContext = {\n    interactableComponents,\n    addInteractableComponent,\n    removeInteractableComponent,\n    updateInteractableComponentProps,\n    getInteractableComponent,\n    getInteractableComponentsByName,\n    clearAllInteractableComponents,\n    setInteractableState: setInteractableStateValue,\n    getInteractableComponentState,\n    setInteractableSelected,\n    clearInteractableSelections,\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  // 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"]}
+{"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 { deepEqual } from \"fast-equals\";\nimport { JSONSchema7 } from \"json-schema\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport { z } from \"zod/v3\";\nimport { createInteractablesContextHelper } from \"../context-helpers/current-interactables-context-helper\";\nimport type { TamboTool } from \"../model/component-metadata\";\nimport {\n  TamboInteractableComponent,\n  type TamboInteractableContext,\n} from \"../model/tambo-interactable\";\nimport { makeJsonSchemaPartial, schemaToJsonSchema } from \"../schema\";\nimport { assertValidName } from \"../util/validate-component-name\";\nimport { useTamboRegistry } from \"./tambo-registry-provider\";\nimport { useTamboContextHelpers } from \"./tambo-context-helpers-provider\";\n\nconst TamboInteractableContext = createContext<TamboInteractableContext>({\n  interactableComponents: [],\n  addInteractableComponent: () => \"\",\n  removeInteractableComponent: () => {},\n  updateInteractableComponentProps: () => \"\",\n  getInteractableComponent: () => undefined,\n  getInteractableComponentsByName: () => [],\n  clearAllInteractableComponents: () => {},\n  setInteractableState: () => {},\n  getInteractableComponentState: () => undefined,\n  setInteractableSelected: () => {},\n  clearInteractableSelections: () => {},\n});\n\n/** Synthetic owner ID used to track global interactable tools in the registry. */\nconst GLOBAL_INTERACTABLE_OWNER = \"__interactable_global__\";\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 [, setToolComponentOwnership] = useState<Record<string, string[]>>({});\n  const { registerTool, unregisterTools } = useTamboRegistry();\n  const { addContextHelper, removeContextHelper } = useTamboContextHelpers();\n\n  const registerToolForComponent = useCallback(\n    (componentId: string, tool: TamboTool) => {\n      registerTool(tool);\n      setToolComponentOwnership((prev) => {\n        const existing = prev[componentId] ?? [];\n        if (existing.includes(tool.name)) return prev;\n        return { ...prev, [componentId]: [...existing, tool.name] };\n      });\n    },\n    [registerTool],\n  );\n\n  const unregisterToolsForComponent = useCallback(\n    (componentId: string) => {\n      setToolComponentOwnership((prev) => {\n        const toolNames = prev[componentId];\n        if (!toolNames || toolNames.length === 0) return prev;\n        unregisterTools(toolNames);\n        const next = { ...prev };\n        delete next[componentId];\n        return next;\n      });\n    },\n    [unregisterTools],\n  );\n\n  // Create a stable context helper function for interactable components\n  const interactablesContextHelper = useMemo(\n    () => createInteractablesContextHelper(interactableComponents),\n    [interactableComponents],\n  );\n\n  // Register the interactables context helper\n  useEffect(() => {\n    addContextHelper(\"interactables\", interactablesContextHelper);\n\n    return () => {\n      removeContextHelper(\"interactables\");\n    };\n  }, [interactablesContextHelper, addContextHelper, removeContextHelper]);\n\n  useEffect(() => {\n    if (interactableComponents.length > 0) {\n      registerToolForComponent(GLOBAL_INTERACTABLE_OWNER, {\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        inputSchema: z.object({}),\n        outputSchema: z.object({\n          components: z.array(\n            z.object({\n              id: z.string(),\n              name: z.string(),\n              props: z.record(z.string(), z.any()),\n              propsSchema: z.record(z.string(), z.any()).optional(),\n            }),\n          ),\n        }),\n      });\n\n      registerToolForComponent(GLOBAL_INTERACTABLE_OWNER, {\n        name: \"get_interactable_component_by_id\",\n        description: \"Get a specific interactable component by its ID\",\n        tool: ({ componentId }: { 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            } as const;\n          }\n\n          return {\n            success: true,\n            component: {\n              id: component.id,\n              componentName: component.name,\n              props: component.props,\n            },\n          } as const;\n        },\n        inputSchema: z.object({\n          componentId: z.string().describe(\"The ID of the component\"),\n        }),\n        outputSchema: z.discriminatedUnion(\"success\", [\n          z.object({\n            success: z.literal(true),\n            component: z\n              .object({\n                id: z.string(),\n                componentName: z.string(),\n                props: z.record(z.string(), z.any()),\n              })\n              .optional(),\n          }),\n          z.object({\n            success: z.literal(false),\n            error: z.string(),\n          }),\n        ]),\n      });\n\n      registerToolForComponent(GLOBAL_INTERACTABLE_OWNER, {\n        name: \"remove_interactable_component\",\n        description: \"Remove an interactable component from the system\",\n        tool: ({ componentId }: { 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            } as const;\n          }\n\n          unregisterToolsForComponent(componentId);\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          } as const;\n        },\n        inputSchema: z.object({\n          componentId: z.string().describe(\"The ID of the component\"),\n        }),\n        outputSchema: z.discriminatedUnion(\"success\", [\n          z.object({\n            success: z.literal(true),\n            componentId: z.string(),\n            removedComponent: z.object({\n              id: z.string(),\n              componentName: z.string(),\n              props: z.record(z.string(), z.any()),\n            }),\n          }),\n          z.object({\n            success: z.literal(false),\n            error: z.string(),\n          }),\n        ]),\n      });\n    } else {\n      // No interactable components — remove the global tools\n      unregisterToolsForComponent(GLOBAL_INTERACTABLE_OWNER);\n    }\n  }, [\n    interactableComponents,\n    registerToolForComponent,\n    unregisterToolsForComponent,\n  ]);\n\n  const updateInteractableComponentProps = useCallback(\n    (id: string, newProps: Record<string, any>): string => {\n      if (!newProps || Object.keys(newProps).length === 0) {\n        return `Warning: No props provided for component with ID ${id}.`;\n      }\n\n      setInteractableComponents((prev) => {\n        const component = prev.find((c) => c.id === id);\n        if (!component) {\n          return prev;\n        }\n\n        // Compare props shallowly\n        const propsChanged = Object.entries(newProps).some(([key, value]) => {\n          return component.props[key] !== value;\n        });\n\n        if (!propsChanged) {\n          return prev; // unchanged\n        }\n\n        // Apply partial update\n        const updated = {\n          ...component,\n          props: { ...component.props, ...newProps },\n        };\n\n        const updatedComponents = [...prev];\n        const idx = prev.findIndex((c) => c.id === id);\n        updatedComponents[idx] = updated;\n\n        return updatedComponents;\n      });\n\n      return \"Updated successfully\";\n    },\n    [],\n  );\n\n  const updateInteractableComponentState = useCallback(\n    (componentId: string, newState: Record<string, unknown>): string => {\n      if (!newState || Object.keys(newState).length === 0) {\n        return `Warning: No state values provided for component with ID ${componentId}.`;\n      }\n\n      setInteractableComponents((components = []) => {\n        const component = components.find((c) => c.id === componentId);\n        if (!component) return components;\n\n        const prevState = component.state ?? {};\n        const updatedState = { ...prevState, ...newState };\n        if (deepEqual(prevState, updatedState)) return components;\n\n        // TODO(lachieh): validate state against schema?\n\n        const updated = {\n          ...component,\n          state: updatedState,\n        };\n\n        return components.map((c) => (c.id === componentId ? updated : c));\n      });\n\n      return \"Updated successfully\";\n    },\n    [],\n  );\n\n  const registerInteractableComponentPropsUpdateTool = useCallback(\n    (component: TamboInteractableComponent, maxNameLength = 60) => {\n      const tamboToolNamePart = `update_component_props_`;\n      const availableLength = maxNameLength - tamboToolNamePart.length;\n      if (component.id.length > availableLength) {\n        throw new Error(\n          `Interactable component id ${component.id} is too long. It must be less than ${availableLength} characters.`,\n        );\n      }\n\n      // Build newProps schema as JSON Schema\n      let newPropsSchema: JSONSchema7;\n      if (component.propsSchema) {\n        // Convert any supported schema to JSON Schema, then make partial\n        const fullSchema = schemaToJsonSchema(component.propsSchema);\n        newPropsSchema = makeJsonSchemaPartial(fullSchema);\n      } else {\n        // No schema - allow any properties\n        newPropsSchema = { type: \"object\", additionalProperties: true };\n      }\n\n      // Build the full input schema as JSON Schema\n      const inputSchema: JSONSchema7 = {\n        type: \"object\",\n        properties: {\n          componentId: {\n            type: \"string\",\n            description: \"The ID of the interactable component to update\",\n          },\n          newProps: {\n            ...newPropsSchema,\n            description:\n              \"The props to update. Provide only the props you want to change.\",\n          },\n        },\n        required: [\"componentId\", \"newProps\"],\n      };\n\n      registerToolForComponent(component.id, {\n        name: `${tamboToolNamePart}${component.id}`,\n        description: `Update the props of interactable component ${component.id} (${component.name}). Provide partial props (only props to change).`,\n        tool: ({\n          componentId,\n          newProps,\n        }: {\n          componentId: string;\n          newProps: Record<string, unknown>;\n        }) => {\n          return updateInteractableComponentProps(componentId, newProps);\n        },\n        inputSchema,\n        outputSchema: z.string(),\n        annotations: {\n          tamboStreamableHint: true,\n          ...component.annotations,\n        },\n      });\n    },\n    [registerToolForComponent, updateInteractableComponentProps],\n  );\n\n  const registerInteractableComponentStateUpdateTool = useCallback(\n    (component: TamboInteractableComponent, maxNameLength = 60) => {\n      const tamboToolNamePart = `update_component_state_`;\n      const availableLength = maxNameLength - tamboToolNamePart.length;\n      if (component.id.length > availableLength) {\n        throw new Error(\n          `Interactable component id ${component.id} is too long. It must be less than ${availableLength} characters.`,\n        );\n      }\n\n      // Build newState schema as JSON Schema\n      let newStateSchema: JSONSchema7 = {\n        type: \"object\",\n        additionalProperties: true,\n      };\n      if (component.stateSchema) {\n        // Convert any supported schema to JSON Schema, then make partial\n        const fullSchema = schemaToJsonSchema(component.stateSchema);\n        newStateSchema = makeJsonSchemaPartial(fullSchema);\n      }\n\n      // Build the full input schema as JSON Schema\n      const inputSchema: JSONSchema7 = {\n        type: \"object\",\n        properties: {\n          componentId: {\n            type: \"string\",\n            description: \"The ID of the interactable component to update\",\n          },\n          newState: {\n            ...newStateSchema,\n            description:\n              \"The state values to update. Provide only the keys you want to change.\",\n          },\n        },\n        required: [\"componentId\", \"newState\"],\n      };\n\n      registerToolForComponent(component.id, {\n        name: `${tamboToolNamePart}${component.id}`,\n        description: `Update the state of interactable component ${component.id} (${component.name}). You may provide partial state (only keys to change).`,\n        tool: ({\n          componentId,\n          newState,\n        }: {\n          componentId: string;\n          newState: Record<string, unknown>;\n        }) => {\n          return updateInteractableComponentState(componentId, newState);\n        },\n        inputSchema,\n        outputSchema: z.string(),\n        annotations: {\n          tamboStreamableHint: true,\n          ...component.annotations,\n        },\n      });\n    },\n    [registerToolForComponent, updateInteractableComponentState],\n  );\n\n  const addInteractableComponent = useCallback(\n    (\n      component: Omit<TamboInteractableComponent, \"id\" | \"createdAt\">,\n    ): string => {\n      // Validate component name\n      assertValidName(component.name, \"component\");\n\n      // Add a random part to the component name to make it unique when using multiple instances of the same component.\n      const tamboGeneratedNamePart = `-${Math.random().toString(36).slice(2, 5)}`;\n      const id = `${component.name}${tamboGeneratedNamePart}`;\n      const newComponent: TamboInteractableComponent = {\n        ...component,\n        id,\n        state: component.state ?? {},\n      };\n\n      registerInteractableComponentPropsUpdateTool(newComponent);\n      registerInteractableComponentStateUpdateTool(newComponent);\n\n      setInteractableComponents((prev) => {\n        return [...prev, newComponent];\n      });\n\n      return id;\n    },\n    [\n      registerInteractableComponentPropsUpdateTool,\n      registerInteractableComponentStateUpdateTool,\n    ],\n  );\n\n  const removeInteractableComponent = useCallback(\n    (id: string) => {\n      unregisterToolsForComponent(id);\n      setInteractableComponents((prev) => prev.filter((c) => c.id !== id));\n    },\n    [unregisterToolsForComponent],\n  );\n\n  const getInteractableComponent = useCallback(\n    <P, S>(id: string): TamboInteractableComponent<P, S> | undefined => {\n      return interactableComponents.find((c) => c.id === id) as\n        | TamboInteractableComponent<P, S>\n        | undefined;\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    for (const component of interactableComponents) {\n      unregisterToolsForComponent(component.id);\n    }\n    setInteractableComponents([]);\n  }, [interactableComponents, unregisterToolsForComponent]);\n\n  const setInteractableStateValue = useCallback(\n    (componentId: string, key: string, value: unknown) => {\n      setInteractableComponents((prev) => {\n        const component = prev.find((c) => c.id === componentId);\n        if (!component) {\n          console.warn(\n            `Tried to update state for component ${componentId} but it was not found.`,\n          );\n          return prev;\n        }\n\n        const updated = {\n          ...component,\n          state: {\n            ...component.state,\n            [key]: value,\n          },\n        };\n\n        const updatedComponents = prev.map((component) => {\n          if (component.id === componentId) {\n            return updated;\n          }\n          return component;\n        });\n\n        return updatedComponents;\n      });\n    },\n    [],\n  );\n\n  const getInteractableComponentState = useCallback(\n    (componentId: string) => {\n      const component = interactableComponents.find(\n        (c) => c.id === componentId,\n      );\n      return component?.state;\n    },\n    [interactableComponents],\n  );\n\n  const setInteractableSelected = useCallback(\n    (componentId: string, isSelected: boolean) => {\n      setInteractableComponents((prev) => {\n        let found = false;\n        const next = prev.map((component) => {\n          if (component.id !== componentId) return component;\n          found = true;\n          return component.isSelected === isSelected\n            ? component\n            : { ...component, isSelected: isSelected };\n        });\n        return found ? next : prev;\n      });\n    },\n    [],\n  );\n\n  const clearInteractableSelections = useCallback(() => {\n    setInteractableComponents((prev) => {\n      if (!prev.some((c) => c.isSelected)) return prev;\n      return prev.map((c) => (c.isSelected ? { ...c, isSelected: false } : c));\n    });\n  }, []);\n\n  const value: TamboInteractableContext = {\n    interactableComponents,\n    addInteractableComponent,\n    removeInteractableComponent,\n    updateInteractableComponentProps,\n    getInteractableComponent,\n    getInteractableComponentsByName,\n    clearAllInteractableComponents,\n    setInteractableState: setInteractableStateValue,\n    getInteractableComponentState,\n    setInteractableSelected,\n    clearInteractableSelections,\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  // 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/esm/providers/tambo-interactable-provider.test.js

@@ -74,7 +74,7 @@ describe("TamboInteractableProvider - State Update Tool Registration", () => {
         act(() => {
             componentId = result.current.addInteractableComponent(component);
         });
-        // Should register both update_component_ and update_component_state_ tools
+        // Should register both update_component_ and update_component_state_ tools via registerToolForComponent
         const registeredToolNames = mockRegisterTool.mock.calls.map((call) => call[0].name);
         expect(registeredToolNames).toContain(`update_component_props_${componentId}`);
         expect(registeredToolNames).toContain(`update_component_state_${componentId}`);
@@ -96,6 +96,33 @@ describe("TamboInteractableProvider - State Update Tool Registration", () => {
         expect(stateToolCall[0].description).toContain(componentId);
         expect(stateToolCall[0].description).toContain("MyComponent");
     });
+    it("should allow props update tool to update component props", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: { title: "original" },
+            propsSchema: z.object({ title: z.string() }),
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        // Find the props update tool and call it
+        const propsToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_props_"));
+        const toolFn = propsToolCall[0].tool;
+        let updateResult = "";
+        act(() => {
+            updateResult = toolFn({
+                componentId,
+                newProps: { title: "updated" },
+            });
+        });
+        expect(updateResult).toBe("Updated successfully");
+        const comp = result.current.getInteractableComponent(componentId);
+        expect(comp?.props.title).toBe("updated");
+    });
     it("should allow state update tool to update multiple state values", () => {
         const { result } = renderHook(() => useTamboInteractable(), { wrapper });
         const component = {
@@ -361,10 +388,11 @@ describe("TamboInteractableProvider - State Update Tool Registration", () => {
         act(() => {
             result.current.removeInteractableComponent(componentId);
         });
-        expect(mockUnregisterTools).toHaveBeenCalledWith([
+        // Should unregister the per-component tools by name
+        expect(mockUnregisterTools).toHaveBeenCalledWith(expect.arrayContaining([
             `update_component_props_${componentId}`,
             `update_component_state_${componentId}`,
-        ]);
+        ]));
     });
     it("should unregister global tools when all components are removed", () => {
         const wrapper = ({ children }) => (React.createElement(TamboInteractableProvider, null, children));
@@ -383,26 +411,88 @@ describe("TamboInteractableProvider - State Update Tool Registration", () => {
         act(() => {
             result.current.removeInteractableComponent(componentId);
         });
-        // Should also unregister global interactable tools once list is empty
-        expect(mockUnregisterTools).toHaveBeenCalledWith([
+        // Should unregister global interactable tools once list is empty
+        expect(mockUnregisterTools).toHaveBeenCalledWith(expect.arrayContaining([
             "get_all_interactable_components",
             "get_interactable_component_by_id",
             "remove_interactable_component",
-        ]);
+        ]));
+    });
+    it("should register global tools that return component data", () => {
+        const wrapper = ({ children }) => (React.createElement(TamboInteractableProvider, null, children));
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        act(() => {
+            result.current.addInteractableComponent({
+                name: "Widget",
+                description: "test widget",
+                component: () => null,
+                props: { color: "red" },
+            });
+        });
+        // Find the global get_all tool
+        const getAllCall = mockRegisterTool.mock.calls.find((call) => call[0].name === "get_all_interactable_components");
+        expect(getAllCall).toBeDefined();
+        const getAllResult = getAllCall[0].tool();
+        expect(getAllResult.components).toHaveLength(1);
+        expect(getAllResult.components[0].name).toBe("Widget");
+    });
+    it("should register global get_by_id tool that finds a component", () => {
+        const wrapper = ({ children }) => (React.createElement(TamboInteractableProvider, null, children));
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        let componentId;
+        act(() => {
+            componentId = result.current.addInteractableComponent({
+                name: "Widget",
+                description: "test",
+                component: () => null,
+                props: { x: 1 },
+            });
+        });
+        const getByIdCall = mockRegisterTool.mock.calls.find((call) => call[0].name === "get_interactable_component_by_id");
+        expect(getByIdCall).toBeDefined();
+        const found = getByIdCall[0].tool({ componentId: componentId });
+        expect(found.success).toBe(true);
+        expect(found.component.componentName).toBe("Widget");
+        const notFound = getByIdCall[0].tool({ componentId: "nonexistent" });
+        expect(notFound.success).toBe(false);
+        expect(notFound.error).toContain("not found");
+    });
+    it("should register global remove tool that removes a component", () => {
+        const wrapper = ({ children }) => (React.createElement(TamboInteractableProvider, null, children));
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        let componentId;
+        act(() => {
+            componentId = result.current.addInteractableComponent({
+                name: "Widget",
+                description: "test",
+                component: () => null,
+                props: {},
+            });
+        });
+        const removeCall = mockRegisterTool.mock.calls.find((call) => call[0].name === "remove_interactable_component");
+        expect(removeCall).toBeDefined();
+        // Remove nonexistent
+        const notFound = removeCall[0].tool({ componentId: "nonexistent" });
+        expect(notFound.success).toBe(false);
+        // Remove existing
+        let removeResult;
+        act(() => {
+            removeResult = removeCall[0].tool({ componentId: componentId });
+        });
+        expect(removeResult.success).toBe(true);
+        expect(removeResult.removedComponent.componentName).toBe("Widget");
     });
     it("should unregister all per-component tools when clearing all components", () => {
         const wrapper = ({ children }) => (React.createElement(TamboInteractableProvider, null, children));
         const { result } = renderHook(() => useTamboInteractable(), { wrapper });
-        let id1;
-        let id2;
         act(() => {
-            id1 = result.current.addInteractableComponent({
+            result.current.addInteractableComponent({
                 name: "A",
                 description: "test",
                 component: () => null,
                 props: {},
             });
-            id2 = result.current.addInteractableComponent({
+            result.current.addInteractableComponent({
                 name: "B",
                 description: "test",
                 component: () => null,
@@ -413,12 +503,8 @@ describe("TamboInteractableProvider - State Update Tool Registration", () => {
         act(() => {
             result.current.clearAllInteractableComponents();
         });
-        expect(mockUnregisterTools).toHaveBeenCalledWith(expect.arrayContaining([
-            `update_component_props_${id1}`,
-            `update_component_state_${id1}`,
-            `update_component_props_${id2}`,
-            `update_component_state_${id2}`,
-        ]));
+        // Should unregister tools for both components
+        expect(mockUnregisterTools).toHaveBeenCalled();
     });
 });
 //# sourceMappingURL=tambo-interactable-provider.test.js.map