@tambo-ai/react 0.47.0 → 0.49.0

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

@@ -0,0 +1,299 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const react_2 = __importDefault(require("react"));
+const zod_1 = require("zod");
+const tambo_context_helpers_provider_1 = require("../tambo-context-helpers-provider");
+const tambo_interactable_provider_1 = require("../tambo-interactable-provider");
+const tambo_stubs_1 = require("../tambo-stubs");
+const with_tambo_interactable_1 = require("../hoc/with-tambo-interactable");
+function wrapperWithProviders(children) {
+    const thread = {
+        id: "t-1",
+        projectId: "p-1",
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        messages: [],
+        metadata: {},
+    };
+    return (react_2.default.createElement(tambo_stubs_1.TamboStubProvider, { thread: thread, registerTool: () => { }, registerTools: () => { }, registerComponent: () => { }, addToolAssociation: () => { } },
+        react_2.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, null, children)));
+}
+describe("Interactables AdditionalContext (provider-based)", () => {
+    test("registers default helper and returns payload with description and components", async () => {
+        const Note = ({ title }) => react_2.default.createElement("div", null, title);
+        const InteractableNote = (0, with_tambo_interactable_1.withTamboInteractable)(Note, {
+            componentName: "Note",
+            description: "A note",
+            propsSchema: zod_1.z.object({ title: zod_1.z.string() }),
+        });
+        let capturedContexts = [];
+        const TestComponent = () => {
+            const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
+            react_2.default.useEffect(() => {
+                let mounted = true;
+                getAdditionalContext().then((contexts) => {
+                    if (mounted) {
+                        capturedContexts = contexts;
+                    }
+                });
+                return () => {
+                    mounted = false;
+                };
+            }, [getAdditionalContext]);
+            return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
+        };
+        const { getByTestId } = (0, react_1.render)(wrapperWithProviders(react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+            react_2.default.createElement(InteractableNote, { title: "hello" }),
+            react_2.default.createElement(TestComponent, null))));
+        await (0, react_1.waitFor)(() => {
+            expect(getByTestId("ready")).toBeInTheDocument();
+            const entry = capturedContexts.find((c) => c.name === "interactables");
+            expect(entry).toBeDefined();
+            expect(entry?.context?.description).toMatch(/interactable components/i);
+            expect(Array.isArray(entry?.context?.components)).toBe(true);
+            const comp = entry.context.components[0];
+            expect(comp.componentName).toBe("Note");
+            expect(comp.props).toEqual({ title: "hello" });
+        });
+    });
+    test("returns null when no interactable components are present", async () => {
+        let capturedContexts = [];
+        const TestComponent = () => {
+            const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
+            react_2.default.useEffect(() => {
+                let mounted = true;
+                getAdditionalContext().then((contexts) => {
+                    if (mounted) {
+                        capturedContexts = contexts;
+                    }
+                });
+                return () => {
+                    mounted = false;
+                };
+            }, [getAdditionalContext]);
+            return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
+        };
+        const { getByTestId } = (0, react_1.render)(wrapperWithProviders(react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+            react_2.default.createElement("div", null, "No interactables here"),
+            react_2.default.createElement(TestComponent, null))));
+        await (0, react_1.waitFor)(() => {
+            expect(getByTestId("ready")).toBeInTheDocument();
+            const entry = capturedContexts.find((c) => c.name === "interactables");
+            expect(entry).toBeUndefined(); // Should be filtered out when helper returns null
+        });
+    });
+    test("context includes proper AI prompt with clear instructions", async () => {
+        const Note = ({ title }) => react_2.default.createElement("div", null, title);
+        const InteractableNote = (0, with_tambo_interactable_1.withTamboInteractable)(Note, {
+            componentName: "Note",
+            description: "A simple note",
+            propsSchema: zod_1.z.object({ title: zod_1.z.string() }),
+        });
+        let capturedContexts = [];
+        const TestComponent = () => {
+            const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
+            react_2.default.useEffect(() => {
+                let mounted = true;
+                getAdditionalContext().then((contexts) => {
+                    if (mounted) {
+                        capturedContexts = contexts;
+                    }
+                });
+                return () => {
+                    mounted = false;
+                };
+            }, [getAdditionalContext]);
+            return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
+        };
+        const { getByTestId } = (0, react_1.render)(wrapperWithProviders(react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+            react_2.default.createElement(InteractableNote, { title: "test" }),
+            react_2.default.createElement(TestComponent, null))));
+        await (0, react_1.waitFor)(() => {
+            expect(getByTestId("ready")).toBeInTheDocument();
+            const entry = capturedContexts.find((c) => c.name === "interactables");
+            expect(entry?.context?.description).toContain("interactable components");
+            expect(entry?.context?.description).toContain("visible on the page");
+            expect(entry?.context?.description).toContain("you can read and modify");
+            expect(entry?.context?.description).toContain("tools to update");
+        });
+    });
+    test("includes component metadata in expected format", async () => {
+        const Note = ({ title, color = "white", }) => react_2.default.createElement("div", { className: `note-${color}` }, title);
+        const InteractableNote = (0, with_tambo_interactable_1.withTamboInteractable)(Note, {
+            componentName: "Note",
+            description: "A colorful note component",
+            propsSchema: zod_1.z.object({
+                title: zod_1.z.string(),
+                color: zod_1.z.string().optional(),
+            }),
+        });
+        let capturedContexts = [];
+        const TestComponent = () => {
+            const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
+            react_2.default.useEffect(() => {
+                let mounted = true;
+                getAdditionalContext().then((contexts) => {
+                    if (mounted) {
+                        capturedContexts = contexts;
+                    }
+                });
+                return () => {
+                    mounted = false;
+                };
+            }, [getAdditionalContext]);
+            return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
+        };
+        const { getByTestId } = (0, react_1.render)(wrapperWithProviders(react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+            react_2.default.createElement(InteractableNote, { title: "test note", color: "blue" }),
+            react_2.default.createElement(TestComponent, null))));
+        await (0, react_1.waitFor)(() => {
+            expect(getByTestId("ready")).toBeInTheDocument();
+            const entry = capturedContexts.find((c) => c.name === "interactables");
+            const component = entry.context.components[0];
+            expect(component).toMatchObject({
+                id: expect.any(String),
+                componentName: "Note",
+                description: "A colorful note component",
+                props: { title: "test note", color: "blue" },
+                propsSchema: "Available - use component-specific update tools",
+            });
+        });
+    });
+    test("snapshot hook returns immutable copies", async () => {
+        const Note = ({ title }) => react_2.default.createElement("div", null, title);
+        const InteractableNote = (0, with_tambo_interactable_1.withTamboInteractable)(Note, {
+            componentName: "Note",
+            description: "A note",
+            propsSchema: zod_1.z.object({ title: zod_1.z.string() }),
+        });
+        const TestComponent = () => {
+            const snapshot = (0, tambo_interactable_provider_1.useCurrentInteractablesSnapshot)();
+            const [testResult, setTestResult] = react_2.default.useState("pending");
+            react_2.default.useEffect(() => {
+                if (snapshot.length > 0) {
+                    const originalLength = snapshot.length;
+                    // Try to mutate the returned array and props
+                    snapshot.push({
+                        id: "fake",
+                        name: "Fake",
+                        description: "",
+                        component: () => null,
+                        props: {},
+                    });
+                    snapshot[0].props.title = "MUTATED";
+                    // The mutations should succeed on the returned copy, proving it's a separate object
+                    if (snapshot.length === originalLength + 1 &&
+                        snapshot[0].props.title === "MUTATED") {
+                        setTestResult("mutation-successful-but-isolated");
+                    }
+                    else {
+                        setTestResult("mutation-failed");
+                    }
+                }
+            }, [snapshot]);
+            return react_2.default.createElement("div", { "data-testid": "test-result" }, testResult);
+        };
+        const { getByTestId } = (0, react_1.render)(wrapperWithProviders(react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+            react_2.default.createElement(InteractableNote, { title: "immutable test" }),
+            react_2.default.createElement(TestComponent, null))));
+        await (0, react_1.waitFor)(() => {
+            const result = getByTestId("test-result").textContent;
+            expect(result).toBe("mutation-successful-but-isolated");
+        });
+    });
+    test("multiple interactables from same provider appear in context", async () => {
+        const Note = ({ title }) => react_2.default.createElement("div", null, title);
+        const Counter = ({ count }) => (react_2.default.createElement("div", null, count));
+        const InteractableNote = (0, with_tambo_interactable_1.withTamboInteractable)(Note, {
+            componentName: "Note",
+            description: "A note",
+            propsSchema: zod_1.z.object({ title: zod_1.z.string() }),
+        });
+        const InteractableCounter = (0, with_tambo_interactable_1.withTamboInteractable)(Counter, {
+            componentName: "Counter",
+            description: "A counter",
+            propsSchema: zod_1.z.object({ count: zod_1.z.number() }),
+        });
+        let capturedContexts = [];
+        const TestComponent = () => {
+            const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
+            react_2.default.useEffect(() => {
+                let mounted = true;
+                getAdditionalContext().then((contexts) => {
+                    if (mounted) {
+                        capturedContexts = contexts;
+                    }
+                });
+                return () => {
+                    mounted = false;
+                };
+            }, [getAdditionalContext]);
+            return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
+        };
+        const { getByTestId } = (0, react_1.render)(wrapperWithProviders(react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+            react_2.default.createElement(InteractableNote, { title: "first" }),
+            react_2.default.createElement(InteractableCounter, { count: 42 }),
+            react_2.default.createElement(TestComponent, null))));
+        await (0, react_1.waitFor)(() => {
+            expect(getByTestId("ready")).toBeInTheDocument();
+            const entry = capturedContexts.find((c) => c.name === "interactables");
+            expect(entry?.context?.components).toHaveLength(2);
+            const components = entry.context.components;
+            expect(components[0].componentName).toBe("Note");
+            expect(components[0].props).toEqual({ title: "first" });
+            expect(components[1].componentName).toBe("Counter");
+            expect(components[1].props).toEqual({ count: 42 });
+        });
+    });
+    test("can be disabled by returning null", async () => {
+        const Note = ({ title }) => react_2.default.createElement("div", null, title);
+        const InteractableNote = (0, with_tambo_interactable_1.withTamboInteractable)(Note, {
+            componentName: "Note",
+            description: "A note",
+            propsSchema: zod_1.z.object({ title: zod_1.z.string() }),
+        });
+        // Create a context helpers provider with a disabled interactables helper
+        const DisabledContextHelpers = ({ children, }) => (react_2.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, { contextHelpers: {
+                ["interactables"]: () => null,
+            } }, children));
+        let capturedContexts = [];
+        const TestComponent = () => {
+            const { getAdditionalContext } = (0, tambo_context_helpers_provider_1.useTamboContextHelpers)();
+            react_2.default.useEffect(() => {
+                let mounted = true;
+                getAdditionalContext().then((contexts) => {
+                    if (mounted) {
+                        capturedContexts = contexts;
+                    }
+                });
+                return () => {
+                    mounted = false;
+                };
+            }, [getAdditionalContext]);
+            return react_2.default.createElement("div", { "data-testid": "ready" }, "ready");
+        };
+        const thread = {
+            id: "t-1",
+            projectId: "p-1",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            messages: [],
+            metadata: {},
+        };
+        const { getByTestId } = (0, react_1.render)(react_2.default.createElement(tambo_stubs_1.TamboStubProvider, { thread: thread, registerTool: () => { }, registerTools: () => { }, registerComponent: () => { }, addToolAssociation: () => { } },
+            react_2.default.createElement(DisabledContextHelpers, null,
+                react_2.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
+                    react_2.default.createElement(InteractableNote, { title: "should not appear" }),
+                    react_2.default.createElement(TestComponent, null)))));
+        await (0, react_1.waitFor)(() => {
+            expect(getByTestId("ready")).toBeInTheDocument();
+            const entry = capturedContexts.find((c) => c.name === "interactables");
+            expect(entry).toBeUndefined(); // Should be filtered out when helper returns null
+        });
+    });
+});
+//# sourceMappingURL=tambo-interactables-additional-context.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-interactables-additional-context.test.js","sourceRoot":"","sources":["../../../src/providers/__tests__/tambo-interactables-additional-context.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { render, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod\";\nimport {\n  useTamboContextHelpers,\n  TamboContextHelpersProvider,\n} from \"../tambo-context-helpers-provider\";\nimport {\n  TamboInteractableProvider,\n  useCurrentInteractablesSnapshot,\n} from \"../tambo-interactable-provider\";\nimport { TamboStubProvider } from \"../tambo-stubs\";\nimport { withTamboInteractable } from \"../hoc/with-tambo-interactable\";\n\nfunction wrapperWithProviders(children: React.ReactNode) {\n  const thread = {\n    id: \"t-1\",\n    projectId: \"p-1\",\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n    messages: [],\n    metadata: {},\n  } as any;\n\n  return (\n    <TamboStubProvider\n      thread={thread}\n      registerTool={() => {}}\n      registerTools={() => {}}\n      registerComponent={() => {}}\n      addToolAssociation={() => {}}\n    >\n      <TamboContextHelpersProvider>{children}</TamboContextHelpersProvider>\n    </TamboStubProvider>\n  );\n}\n\ndescribe(\"Interactables AdditionalContext (provider-based)\", () => {\n  test(\"registers default helper and returns payload with description and components\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"hello\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeDefined();\n      expect(entry?.context?.description).toMatch(/interactable components/i);\n      expect(Array.isArray(entry?.context?.components)).toBe(true);\n      const comp = entry!.context.components[0];\n      expect(comp.componentName).toBe(\"Note\");\n      expect(comp.props).toEqual({ title: \"hello\" });\n    });\n  });\n\n  test(\"returns null when no interactable components are present\", async () => {\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <div>No interactables here</div>\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeUndefined(); // Should be filtered out when helper returns null\n    });\n  });\n\n  test(\"context includes proper AI prompt with clear instructions\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A simple note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry?.context?.description).toContain(\"interactable components\");\n      expect(entry?.context?.description).toContain(\"visible on the page\");\n      expect(entry?.context?.description).toContain(\"you can read and modify\");\n      expect(entry?.context?.description).toContain(\"tools to update\");\n    });\n  });\n\n  test(\"includes component metadata in expected format\", async () => {\n    const Note: React.FC<{ title: string; color?: string }> = ({\n      title,\n      color = \"white\",\n    }) => <div className={`note-${color}`}>{title}</div>;\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A colorful note component\",\n      propsSchema: z.object({\n        title: z.string(),\n        color: z.string().optional(),\n      }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"test note\" color=\"blue\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      const component = entry!.context.components[0];\n\n      expect(component).toMatchObject({\n        id: expect.any(String),\n        componentName: \"Note\",\n        description: \"A colorful note component\",\n        props: { title: \"test note\", color: \"blue\" },\n        propsSchema: \"Available - use component-specific update tools\",\n      });\n    });\n  });\n\n  test(\"snapshot hook returns immutable copies\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    const TestComponent = () => {\n      const snapshot = useCurrentInteractablesSnapshot();\n      const [testResult, setTestResult] = React.useState<string>(\"pending\");\n\n      React.useEffect(() => {\n        if (snapshot.length > 0) {\n          const originalLength = snapshot.length;\n\n          // Try to mutate the returned array and props\n          snapshot.push({\n            id: \"fake\",\n            name: \"Fake\",\n            description: \"\",\n            component: () => null,\n            props: {},\n          } as any);\n          (snapshot[0].props as any).title = \"MUTATED\";\n\n          // The mutations should succeed on the returned copy, proving it's a separate object\n          if (\n            snapshot.length === originalLength + 1 &&\n            snapshot[0].props.title === \"MUTATED\"\n          ) {\n            setTestResult(\"mutation-successful-but-isolated\");\n          } else {\n            setTestResult(\"mutation-failed\");\n          }\n        }\n      }, [snapshot]);\n\n      return <div data-testid=\"test-result\">{testResult}</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"immutable test\" />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      const result = getByTestId(\"test-result\").textContent;\n      expect(result).toBe(\"mutation-successful-but-isolated\");\n    });\n  });\n\n  test(\"multiple interactables from same provider appear in context\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const Counter: React.FC<{ count: number }> = ({ count }) => (\n      <div>{count}</div>\n    );\n\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter\",\n      propsSchema: z.object({ count: z.number() }),\n    });\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const { getByTestId } = render(\n      wrapperWithProviders(\n        <TamboInteractableProvider>\n          <InteractableNote title=\"first\" />\n          <InteractableCounter count={42} />\n          <TestComponent />\n        </TamboInteractableProvider>,\n      ),\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry?.context?.components).toHaveLength(2);\n\n      const components = entry!.context.components;\n      expect(components[0].componentName).toBe(\"Note\");\n      expect(components[0].props).toEqual({ title: \"first\" });\n      expect(components[1].componentName).toBe(\"Counter\");\n      expect(components[1].props).toEqual({ count: 42 });\n    });\n  });\n\n  test(\"can be disabled by returning null\", async () => {\n    const Note: React.FC<{ title: string }> = ({ title }) => <div>{title}</div>;\n    const InteractableNote = withTamboInteractable(Note, {\n      componentName: \"Note\",\n      description: \"A note\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    // Create a context helpers provider with a disabled interactables helper\n    const DisabledContextHelpers = ({\n      children,\n    }: {\n      children: React.ReactNode;\n    }) => (\n      <TamboContextHelpersProvider\n        contextHelpers={{\n          [\"interactables\"]: () => null,\n        }}\n      >\n        {children}\n      </TamboContextHelpersProvider>\n    );\n\n    let capturedContexts: any[] = [];\n    const TestComponent = () => {\n      const { getAdditionalContext } = useTamboContextHelpers();\n\n      React.useEffect(() => {\n        let mounted = true;\n        getAdditionalContext().then((contexts) => {\n          if (mounted) {\n            capturedContexts = contexts;\n          }\n        });\n        return () => {\n          mounted = false;\n        };\n      }, [getAdditionalContext]);\n\n      return <div data-testid=\"ready\">ready</div>;\n    };\n\n    const thread = {\n      id: \"t-1\",\n      projectId: \"p-1\",\n      createdAt: new Date().toISOString(),\n      updatedAt: new Date().toISOString(),\n      messages: [],\n      metadata: {},\n    } as any;\n\n    const { getByTestId } = render(\n      <TamboStubProvider\n        thread={thread}\n        registerTool={() => {}}\n        registerTools={() => {}}\n        registerComponent={() => {}}\n        addToolAssociation={() => {}}\n      >\n        <DisabledContextHelpers>\n          <TamboInteractableProvider>\n            <InteractableNote title=\"should not appear\" />\n            <TestComponent />\n          </TamboInteractableProvider>\n        </DisabledContextHelpers>\n      </TamboStubProvider>,\n    );\n\n    await waitFor(() => {\n      expect(getByTestId(\"ready\")).toBeInTheDocument();\n      const entry = capturedContexts.find(\n        (c: any) => c.name === \"interactables\",\n      );\n      expect(entry).toBeUndefined(); // Should be filtered out when helper returns null\n    });\n  });\n});\n"]}

package/dist/providers/__tests__/tambo-registry-provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tambo-registry-provider.test.d.ts.map

package/dist/providers/__tests__/tambo-registry-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-registry-provider.test.d.ts","sourceRoot":"","sources":["../../../src/providers/__tests__/tambo-registry-provider.test.tsx"],"names":[],"mappings":""}

package/dist/providers/__tests__/tambo-registry-provider.test.js

@@ -0,0 +1,224 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const react_2 = __importDefault(require("react"));
+const zod_1 = require("zod");
+const tambo_registry_provider_1 = require("../tambo-registry-provider");
+// Shared tool registry for all tests
+const createMockTools = () => [
+    {
+        name: "test-tool-1",
+        description: "First test tool",
+        tool: jest.fn().mockResolvedValue("test-tool-1-result"),
+        toolSchema: zod_1.z
+            .function()
+            .args(zod_1.z.string().describe("input parameter"))
+            .returns(zod_1.z.string()),
+    },
+    {
+        name: "test-tool-2",
+        description: "Second test tool",
+        tool: jest.fn().mockResolvedValue("test-tool-2-result"),
+        toolSchema: zod_1.z
+            .function()
+            .args(zod_1.z.number().describe("number parameter"))
+            .returns(zod_1.z.string()),
+    },
+];
+const createMockComponents = (tools) => [
+    {
+        name: "TestComponent",
+        component: () => react_2.default.createElement("div", null, "TestComponent"),
+        description: "Test component",
+        propsSchema: zod_1.z.object({
+            test: zod_1.z.string(),
+        }),
+        associatedTools: tools,
+    },
+];
+describe("TamboRegistryProvider", () => {
+    const mockTools = createMockTools();
+    const mockComponents = createMockComponents(mockTools);
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe("Component and tool registration", () => {
+        it("should register components and tools correctly", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: mockComponents }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            expect(result.current.componentList).toHaveProperty("TestComponent");
+            expect(result.current.toolRegistry).toHaveProperty("test-tool-1");
+            expect(result.current.toolRegistry).toHaveProperty("test-tool-2");
+            expect(result.current.componentToolAssociations).toHaveProperty("TestComponent");
+            expect(result.current.componentToolAssociations.TestComponent).toEqual([
+                "test-tool-1",
+                "test-tool-2",
+            ]);
+        });
+        it("should provide onCallUnregisteredTool in context", () => {
+            const mockonCallUnregisteredTool = jest
+                .fn()
+                .mockResolvedValue("test-result");
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: mockComponents, onCallUnregisteredTool: mockonCallUnregisteredTool }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            // The onCallUnregisteredTool should be available in the context
+            expect(result.current.onCallUnregisteredTool).toBeDefined();
+            expect(typeof result.current.onCallUnregisteredTool).toBe("function");
+        });
+        it("should handle tool registration and association", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            // Register a new tool
+            (0, react_1.act)(() => {
+                result.current.registerTool(mockTools[0]);
+            });
+            expect(result.current.toolRegistry).toHaveProperty("test-tool-1");
+            // Register a new component
+            (0, react_1.act)(() => {
+                result.current.registerComponent(mockComponents[0]);
+            });
+            expect(result.current.componentList).toHaveProperty("TestComponent");
+            expect(result.current.componentToolAssociations).toHaveProperty("TestComponent");
+        });
+        it("should handle multiple tool registration", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            // Register multiple tools
+            (0, react_1.act)(() => {
+                result.current.registerTools(mockTools);
+            });
+            expect(result.current.toolRegistry).toHaveProperty("test-tool-1");
+            expect(result.current.toolRegistry).toHaveProperty("test-tool-2");
+            expect(Object.keys(result.current.toolRegistry)).toHaveLength(2);
+        });
+        it("should handle tool association with components", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: mockComponents }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            // Add a new tool association
+            (0, react_1.act)(() => {
+                const newTool = {
+                    name: "new-tool",
+                    description: "New tool",
+                    tool: jest.fn().mockResolvedValue("new-tool-result"),
+                    toolSchema: zod_1.z
+                        .function()
+                        .args(zod_1.z.string().describe("input"))
+                        .returns(zod_1.z.string()),
+                };
+                result.current.addToolAssociation("TestComponent", newTool);
+            });
+            expect(result.current.componentToolAssociations.TestComponent).toContain("new-tool");
+        });
+        it("should throw error when adding tool association to non-existent component", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            const newTool = {
+                name: "new-tool",
+                description: "New tool",
+                tool: jest.fn().mockResolvedValue("new-tool-result"),
+                toolSchema: zod_1.z
+                    .function()
+                    .args(zod_1.z.string().describe("input"))
+                    .returns(zod_1.z.string()),
+            };
+            expect(() => {
+                (0, react_1.act)(() => {
+                    result.current.addToolAssociation("NonExistentComponent", newTool);
+                });
+            }).toThrow("Component NonExistentComponent not found in registry");
+        });
+        it("should validate tool schemas and throw error for invalid schemas", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            const invalidTool = {
+                name: "invalid-tool",
+                description: "Invalid tool",
+                tool: jest.fn().mockResolvedValue("result"),
+                toolSchema: zod_1.z.record(zod_1.z.string()), // This should cause validation to fail
+            };
+            // This should throw during registration due to invalid schema
+            expect(() => {
+                (0, react_1.act)(() => {
+                    result.current.registerTool(invalidTool);
+                });
+            }).toThrow('z.record() is not supported in toolSchema of tool "invalid-tool"');
+        });
+        it("should validate component schemas and throw error for invalid schemas", () => {
+            const invalidComponent = {
+                name: "InvalidComponent",
+                component: () => react_2.default.createElement("div", null, "Invalid"),
+                description: "Invalid component",
+                propsSchema: zod_1.z.record(zod_1.z.string()), // This should cause validation to fail
+            };
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            // This should throw during registration due to invalid schema
+            expect(() => {
+                (0, react_1.act)(() => {
+                    result.current.registerComponent(invalidComponent);
+                });
+            }).toThrow('z.record() is not supported in propsSchema of component "InvalidComponent"');
+        });
+        it("should throw error when component has both propsSchema and propsDefinition", () => {
+            const invalidComponent = {
+                name: "InvalidComponent",
+                component: () => react_2.default.createElement("div", null, "Invalid"),
+                description: "Invalid component",
+                propsSchema: zod_1.z.object({ test: zod_1.z.string() }),
+                propsDefinition: { test: "string" }, // Both defined - should throw
+            };
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            expect(() => {
+                (0, react_1.act)(() => {
+                    result.current.registerComponent(invalidComponent);
+                });
+            }).toThrow("Component InvalidComponent cannot have both propsSchema and propsDefinition defined");
+        });
+        it("should throw error when component has neither propsSchema nor propsDefinition", () => {
+            const invalidComponent = {
+                name: "InvalidComponent",
+                component: () => react_2.default.createElement("div", null, "Invalid"),
+                description: "Invalid component",
+                // Neither propsSchema nor propsDefinition defined - should throw
+            };
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            expect(() => {
+                (0, react_1.act)(() => {
+                    result.current.registerComponent(invalidComponent);
+                });
+            }).toThrow("Component InvalidComponent must have either propsSchema (recommended) or propsDefinition defined");
+        });
+    });
+    describe("Tool call handling", () => {
+        it("should provide onCallUnregisteredTool callback for handling unknown tools", async () => {
+            const mockonCallUnregisteredTool = jest
+                .fn()
+                .mockResolvedValue("unknown-tool-result");
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: mockComponents, onCallUnregisteredTool: mockonCallUnregisteredTool }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            // Verify the callback is available
+            expect(result.current.onCallUnregisteredTool).toBeDefined();
+            expect(typeof result.current.onCallUnregisteredTool).toBe("function");
+            // Simulate calling the unknown tool handler
+            const toolName = "unknown-tool";
+            const args = [{ parameterName: "input", parameterValue: "test-input" }];
+            await (0, react_1.act)(async () => {
+                if (result.current.onCallUnregisteredTool) {
+                    await result.current.onCallUnregisteredTool(toolName, args);
+                }
+            });
+            expect(mockonCallUnregisteredTool).toHaveBeenCalledWith(toolName, args);
+        });
+        it("should handle onCallUnregisteredTool being undefined", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: mockComponents }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+            expect(result.current.onCallUnregisteredTool).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=tambo-registry-provider.test.js.map