@tambo-ai/react 0.67.1 → 0.69.0

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

@@ -1,8 +1,10 @@
 // react-sdk/src/providers/tambo-interactable-provider.tsx
 "use client";
+import { deepEqual } from "fast-equals";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
 import { z } from "zod/v3";
 import { createInteractablesContextHelper } from "../context-helpers/current-interactables-context-helper";
+import { makeJsonSchemaPartial, schemaToJsonSchema } from "../schema";
 import { assertValidName } from "../util/validate-component-name";
 import { useTamboComponent } from "./tambo-component-provider";
 import { useTamboContextHelpers } from "./tambo-context-helpers-provider";
@@ -16,6 +18,8 @@ const TamboInteractableContext = createContext({
     clearAllInteractableComponents: () => { },
     setInteractableState: () => { },
     getInteractableComponentState: () => undefined,
+    setInteractableSelected: () => { },
+    clearInteractableSelections: () => { },
 });
 /**
  * The TamboInteractableProvider manages a list of components that are currently
@@ -169,32 +173,110 @@ export const TamboInteractableProvider = ({ children, }) => {
         });
         return "Updated successfully";
     }, []);
-    const registerInteractableComponentUpdateTool = useCallback((component, maxNameLength = 60) => {
-        const tamboToolNamePart = `update_component_`;
+    const updateInteractableComponentState = useCallback((componentId, newState) => {
+        if (!newState || Object.keys(newState).length === 0) {
+            return `Warning: No state values provided for component with ID ${componentId}.`;
+        }
+        setInteractableComponents((components = []) => {
+            const component = components.find((c) => c.id === componentId);
+            if (!component)
+                return components;
+            const prevState = component.state ?? {};
+            const updatedState = { ...prevState, ...newState };
+            if (deepEqual(prevState, updatedState))
+                return components;
+            // TODO(lachieh): validate state against schema?
+            const updated = {
+                ...component,
+                state: updatedState,
+            };
+            return components.map((c) => (c.id === componentId ? updated : c));
+        });
+        return "Updated successfully";
+    }, []);
+    const registerInteractableComponentPropsUpdateTool = useCallback((component, maxNameLength = 60) => {
+        const tamboToolNamePart = `update_component_props_`;
         const availableLength = maxNameLength - tamboToolNamePart.length;
         if (component.id.length > availableLength) {
             throw new Error(`Interactable component id ${component.id} is too long. It must be less than ${availableLength} characters.`);
         }
-        const schemaForArgs = typeof component.propsSchema === "object" &&
-            "describe" in component.propsSchema &&
-            "partial" in component.propsSchema
-            ? component.propsSchema.partial()
-            : z.object({});
+        // Build newProps schema as JSON Schema
+        let newPropsSchema;
+        if (component.propsSchema) {
+            // Convert any supported schema to JSON Schema, then make partial
+            const fullSchema = schemaToJsonSchema(component.propsSchema);
+            newPropsSchema = makeJsonSchemaPartial(fullSchema);
+        }
+        else {
+            // No schema - allow any properties
+            newPropsSchema = { type: "object", additionalProperties: true };
+        }
+        // Build the full input schema as JSON Schema
+        const inputSchema = {
+            type: "object",
+            properties: {
+                componentId: {
+                    type: "string",
+                    description: "The ID of the interactable component to update",
+                },
+                newProps: {
+                    ...newPropsSchema,
+                    description: "The props to update. Provide only the props you want to change.",
+                },
+            },
+            required: ["componentId", "newProps"],
+        };
         registerTool({
             name: `${tamboToolNamePart}${component.id}`,
-            description: `Update the props of interactable component ${component.id} (${component.name}). You can provide partial props (only the props you want to change) or complete props (all props). Only the props you specify will be updated.`,
+            description: `Update the props of interactable component ${component.id} (${component.name}). Provide partial props (only props to change).`,
             tool: ({ componentId, newProps }) => {
                 return updateInteractableComponentProps(componentId, newProps);
             },
-            inputSchema: z.object({
-                componentId: z
-                    .string()
-                    .describe("The ID of the interactable component to update"),
-                newProps: schemaForArgs.describe("The props to update the component with. You can provide partial props (only the props you want to change) or complete props (all props). Only the props you specify will be updated."),
-            }),
+            inputSchema,
             outputSchema: z.string(),
         });
     }, [registerTool, updateInteractableComponentProps]);
+    const registerInteractableComponentStateUpdateTool = useCallback((component, maxNameLength = 60) => {
+        const tamboToolNamePart = `update_component_state_`;
+        const availableLength = maxNameLength - tamboToolNamePart.length;
+        if (component.id.length > availableLength) {
+            throw new Error(`Interactable component id ${component.id} is too long. It must be less than ${availableLength} characters.`);
+        }
+        // Build newState schema as JSON Schema
+        let newStateSchema = {
+            type: "object",
+            additionalProperties: true,
+        };
+        if (component.stateSchema) {
+            // Convert any supported schema to JSON Schema, then make partial
+            const fullSchema = schemaToJsonSchema(component.stateSchema);
+            newStateSchema = makeJsonSchemaPartial(fullSchema);
+        }
+        // Build the full input schema as JSON Schema
+        const inputSchema = {
+            type: "object",
+            properties: {
+                componentId: {
+                    type: "string",
+                    description: "The ID of the interactable component to update",
+                },
+                newState: {
+                    ...newStateSchema,
+                    description: "The state values to update. Provide only the keys you want to change.",
+                },
+            },
+            required: ["componentId", "newState"],
+        };
+        registerTool({
+            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 }) => {
+                return updateInteractableComponentState(componentId, newState);
+            },
+            inputSchema,
+            outputSchema: z.string(),
+        });
+    }, [registerTool, updateInteractableComponentState]);
     const addInteractableComponent = useCallback((component) => {
         // Validate component name
         assertValidName(component.name, "component");
@@ -206,12 +288,16 @@ export const TamboInteractableProvider = ({ children, }) => {
             id,
             state: component.state ?? {},
         };
-        registerInteractableComponentUpdateTool(newComponent);
+        registerInteractableComponentPropsUpdateTool(newComponent);
+        registerInteractableComponentStateUpdateTool(newComponent);
         setInteractableComponents((prev) => {
             return [...prev, newComponent];
         });
         return id;
-    }, [registerInteractableComponentUpdateTool]);
+    }, [
+        registerInteractableComponentPropsUpdateTool,
+        registerInteractableComponentStateUpdateTool,
+    ]);
     const removeInteractableComponent = useCallback((id) => {
         setInteractableComponents((prev) => prev.filter((c) => c.id !== id));
     }, []);
@@ -234,7 +320,7 @@ export const TamboInteractableProvider = ({ children, }) => {
             const updated = {
                 ...component,
                 state: {
-                    ...(component.state ?? {}),
+                    ...component.state,
                     [key]: value,
                 },
             };
@@ -251,6 +337,27 @@ export const TamboInteractableProvider = ({ children, }) => {
         const component = interactableComponents.find((c) => c.id === componentId);
         return component?.state;
     }, [interactableComponents]);
+    const setInteractableSelected = useCallback((componentId, isSelected) => {
+        setInteractableComponents((prev) => {
+            let found = false;
+            const next = prev.map((component) => {
+                if (component.id !== componentId)
+                    return component;
+                found = true;
+                return component.isSelected === isSelected
+                    ? component
+                    : { ...component, isSelected: isSelected };
+            });
+            return found ? next : prev;
+        });
+    }, []);
+    const clearInteractableSelections = useCallback(() => {
+        setInteractableComponents((prev) => {
+            if (!prev.some((c) => c.isSelected))
+                return prev;
+            return prev.map((c) => (c.isSelected ? { ...c, isSelected: false } : c));
+        });
+    }, []);
     const value = {
         interactableComponents,
         addInteractableComponent,
@@ -261,6 +368,8 @@ export const TamboInteractableProvider = ({ children, }) => {
         clearAllInteractableComponents,
         setInteractableState: setInteractableStateValue,
         getInteractableComponentState,
+        setInteractableSelected,
+        clearInteractableSelections,
     };
     return (React.createElement(TamboInteractableContext.Provider, { value: value }, children));
 };

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  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 { assertValidName } from \"../util/validate-component-name\";\nimport { useTamboComponent } from \"./tambo-component-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});\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 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          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    }\n  }, [interactableComponents, registerTool]);\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 registerInteractableComponentUpdateTool = useCallback(\n    (component: TamboInteractableComponent, maxNameLength = 60) => {\n      const tamboToolNamePart = `update_component_`;\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      const schemaForArgs =\n        typeof component.propsSchema === \"object\" &&\n        \"describe\" in component.propsSchema &&\n        \"partial\" in component.propsSchema\n          ? (component.propsSchema as any).partial()\n          : z.object({});\n\n      registerTool({\n        name: `${tamboToolNamePart}${component.id}`,\n        description: `Update the props of interactable component ${component.id} (${component.name}). You can provide partial props (only the props you want to change) or complete props (all props). Only the props you specify will be updated.`,\n        tool: ({ componentId, newProps }) => {\n          return updateInteractableComponentProps(componentId, newProps);\n        },\n        inputSchema: z.object({\n          componentId: z\n            .string()\n            .describe(\"The ID of the interactable component to update\"),\n          newProps: schemaForArgs.describe(\n            \"The props to update the component with. You can provide partial props (only the props you want to change) or complete props (all props). Only the props you specify will be updated.\",\n          ),\n        }),\n        outputSchema: z.string(),\n      });\n    },\n    [registerTool, updateInteractableComponentProps],\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      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 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 value: TamboInteractableContext = {\n    interactableComponents,\n    addInteractableComponent,\n    removeInteractableComponent,\n    updateInteractableComponentProps,\n    getInteractableComponent,\n    getInteractableComponentsByName,\n    clearAllInteractableComponents,\n    setInteractableState: setInteractableStateValue,\n    getInteractableComponentState,\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 {\n  TamboInteractableComponent,\n  type TamboInteractableContext,\n} from \"../model/tambo-interactable\";\nimport { makeJsonSchemaPartial, schemaToJsonSchema } from \"../schema\";\nimport { assertValidName } from \"../util/validate-component-name\";\nimport { useTamboComponent } from \"./tambo-component-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 * 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 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          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    }\n  }, [interactableComponents, registerTool]);\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      });\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      });\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((id: string) => {\n    setInteractableComponents((prev) => prev.filter((c) => c.id !== id));\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    setInteractableComponents([]);\n  }, []);\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

@@ -54,4 +54,246 @@ describe("TamboInteractableProvider - State Tracking", () => {
         expect(state).toEqual({ count: 10 });
     });
 });
+describe("TamboInteractableProvider - State Update Tool Registration", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    const wrapper = ({ children }) => (React.createElement(TamboInteractableProvider, null, children));
+    it("should register both prop and state update tools when component is added", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: { title: "Test" },
+            propsSchema: z.object({ title: z.string() }),
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        // Should register both update_component_ and update_component_state_ tools
+        const registeredToolNames = mockRegisterTool.mock.calls.map((call) => call[0].name);
+        expect(registeredToolNames).toContain(`update_component_props_${componentId}`);
+        expect(registeredToolNames).toContain(`update_component_state_${componentId}`);
+    });
+    it("should register state update tool with correct description", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "MyComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        expect(stateToolCall).toBeDefined();
+        expect(stateToolCall[0].description).toContain(componentId);
+        expect(stateToolCall[0].description).toContain("MyComponent");
+    });
+    it("should allow state update tool to update multiple state values", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        // Find the state update tool and call it
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        const toolFn = stateToolCall[0].tool;
+        act(() => {
+            toolFn({ componentId, newState: { count: 5, name: "test" } });
+        });
+        const state = result.current.getInteractableComponentState(componentId);
+        expect(state).toEqual({ count: 5, name: "test" });
+    });
+    it("should preserve existing state when updating partial state", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        // Set initial state
+        act(() => {
+            result.current.setInteractableState(componentId, "existingKey", "value1");
+        });
+        // Find the state update tool and call it with a new key
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        const toolFn = stateToolCall[0].tool;
+        act(() => {
+            toolFn({ componentId, newState: { newKey: "value2" } });
+        });
+        const state = result.current.getInteractableComponentState(componentId);
+        expect(state).toEqual({ existingKey: "value1", newKey: "value2" });
+    });
+    it("should use stateSchema when provided for tool registration", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const stateSchema = z.object({
+            count: z.number(),
+            name: z.string(),
+        });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+            stateSchema,
+        };
+        act(() => {
+            result.current.addInteractableComponent(component);
+        });
+        // Find the state update tool
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        expect(stateToolCall).toBeDefined();
+        // The inputSchema should contain the partial stateSchema
+        expect(stateToolCall[0].inputSchema).toBeDefined();
+    });
+    it("should return warning when updating state with empty object", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        // Find the state update tool and call it with empty state
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        const toolFn = stateToolCall[0].tool;
+        let updateResult = "";
+        act(() => {
+            updateResult = toolFn({ componentId, newState: {} });
+        });
+        expect(updateResult).toContain("Warning");
+        expect(updateResult).toContain("No state values provided");
+    });
+    it("should preserve stateSchema in interactable component", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const stateSchema = z.object({
+            count: z.number(),
+        });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+            stateSchema,
+        };
+        let componentId = "";
+        act(() => {
+            componentId = result.current.addInteractableComponent(component);
+        });
+        const interactable = result.current.getInteractableComponent(componentId);
+        expect(interactable?.stateSchema).toBe(stateSchema);
+    });
+    it("should convert stateSchema to partial JSON Schema (no required fields)", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const stateSchema = z.object({
+            count: z.number(),
+            name: z.string(),
+        });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+            stateSchema,
+        };
+        act(() => {
+            result.current.addInteractableComponent(component);
+        });
+        // Find the state update tool
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        expect(stateToolCall).toBeDefined();
+        const inputSchema = stateToolCall[0].inputSchema;
+        // The newState property should not have required fields (partial schema)
+        expect(inputSchema.properties.newState).toBeDefined();
+        expect(inputSchema.properties.newState.required).toBeUndefined();
+        // But it should have the properties from the schema
+        expect(inputSchema.properties.newState.properties).toBeDefined();
+    });
+    it("should use additionalProperties when no stateSchema provided", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: {},
+            // No stateSchema
+        };
+        act(() => {
+            result.current.addInteractableComponent(component);
+        });
+        // Find the state update tool
+        const stateToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_state_"));
+        expect(stateToolCall).toBeDefined();
+        const inputSchema = stateToolCall[0].inputSchema;
+        // The newState property should allow additional properties
+        expect(inputSchema.properties.newState.additionalProperties).toBe(true);
+    });
+    it("should convert propsSchema to partial JSON Schema for props update tool", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const propsSchema = z.object({
+            title: z.string(),
+            count: z.number(),
+        });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: { title: "test", count: 0 },
+            propsSchema,
+        };
+        act(() => {
+            result.current.addInteractableComponent(component);
+        });
+        // Find the props update tool (not the state one)
+        const propsToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_") &&
+            !call[0].name.includes("state"));
+        expect(propsToolCall).toBeDefined();
+        const inputSchema = propsToolCall[0].inputSchema;
+        // The newProps property should not have required fields (partial schema)
+        expect(inputSchema.properties.newProps).toBeDefined();
+        expect(inputSchema.properties.newProps.required).toBeUndefined();
+        // But it should have the properties from the schema
+        expect(inputSchema.properties.newProps.properties).toBeDefined();
+    });
+    it("should use additionalProperties when no propsSchema provided", () => {
+        const { result } = renderHook(() => useTamboInteractable(), { wrapper });
+        const component = {
+            name: "TestComponent",
+            description: "A test component",
+            component: () => React.createElement("div", null, "Test"),
+            props: { title: "test" },
+            // No propsSchema
+        };
+        act(() => {
+            result.current.addInteractableComponent(component);
+        });
+        // Find the props update tool
+        const propsToolCall = mockRegisterTool.mock.calls.find((call) => call[0].name.startsWith("update_component_") &&
+            !call[0].name.includes("state"));
+        expect(propsToolCall).toBeDefined();
+        const inputSchema = propsToolCall[0].inputSchema;
+        // The newProps property should allow additional properties
+        expect(inputSchema.properties.newProps.additionalProperties).toBe(true);
+    });
+});
 //# sourceMappingURL=tambo-interactable-provider.test.js.map