@tambo-ai/react 0.72.0 → 0.73.1

package/esm/v1/providers/tambo-v1-stub-provider.test.js

@@ -0,0 +1,157 @@
+import { renderHook } from "@testing-library/react";
+import React from "react";
+import { TamboV1StubProvider } from "./tambo-v1-stub-provider";
+import { useTamboV1 } from "../hooks/use-tambo-v1";
+import { useTamboV1ThreadInput } from "../hooks/use-tambo-v1-thread-input";
+import { useTamboRegistry } from "../../providers/tambo-registry-provider";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+describe("TamboV1StubProvider", () => {
+    const mockThread = {
+        id: "thread_123",
+        messages: [
+            {
+                id: "msg_1",
+                role: "user",
+                content: [{ type: "text", text: "Hello" }],
+                createdAt: "2024-01-01T00:00:00Z",
+            },
+            {
+                id: "msg_2",
+                role: "assistant",
+                content: [{ type: "text", text: "Hi there!" }],
+                createdAt: "2024-01-01T00:00:01Z",
+            },
+        ],
+        status: "idle",
+        createdAt: "2024-01-01T00:00:00Z",
+        updatedAt: "2024-01-01T00:00:01Z",
+    };
+    describe("useTamboV1", () => {
+        it("provides thread data via useTamboV1", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread }, children));
+            const { result } = renderHook(() => useTamboV1("thread_123"), {
+                wrapper,
+            });
+            expect(result.current.messages).toHaveLength(2);
+            expect(result.current.messages[0].id).toBe("msg_1");
+            expect(result.current.messages[1].id).toBe("msg_2");
+            expect(result.current.isIdle).toBe(true);
+            expect(result.current.isStreaming).toBe(false);
+        });
+        it("returns empty messages when no thread provided", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, null, children));
+            const { result } = renderHook(() => useTamboV1("stub_thread"), {
+                wrapper,
+            });
+            expect(result.current.messages).toHaveLength(0);
+            expect(result.current.isIdle).toBe(true);
+        });
+        it("shows streaming state when isStreaming prop is true", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread, isStreaming: true }, children));
+            const { result } = renderHook(() => useTamboV1("thread_123"), {
+                wrapper,
+            });
+            expect(result.current.isStreaming).toBe(true);
+            expect(result.current.isIdle).toBe(false);
+        });
+    });
+    describe("useTamboV1ThreadInput", () => {
+        it("provides thread input context", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread }, children));
+            const { result } = renderHook(() => useTamboV1ThreadInput(), { wrapper });
+            expect(result.current.value).toBe("");
+            expect(result.current.threadId).toBe("thread_123");
+            expect(typeof result.current.setValue).toBe("function");
+            expect(typeof result.current.submit).toBe("function");
+        });
+        it("uses initial input value when provided", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread, inputValue: "Hello world" }, children));
+            const { result } = renderHook(() => useTamboV1ThreadInput(), { wrapper });
+            expect(result.current.value).toBe("Hello world");
+        });
+        it("calls custom onSubmit when provided", async () => {
+            const mockOnSubmit = jest
+                .fn()
+                .mockResolvedValue({ threadId: "new_thread" });
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread, onSubmit: mockOnSubmit }, children));
+            const { result } = renderHook(() => useTamboV1ThreadInput(), { wrapper });
+            const response = await result.current.submit();
+            expect(mockOnSubmit).toHaveBeenCalled();
+            expect(response.threadId).toBe("new_thread");
+        });
+    });
+    describe("Registry", () => {
+        it("registers provided components", () => {
+            const TestComponent = () => React.createElement("div", null, "Test");
+            const components = [
+                {
+                    name: "TestComponent",
+                    description: "A test component",
+                    component: TestComponent,
+                },
+            ];
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread, components: components }, children));
+            const { result } = renderHook(() => useTamboRegistry(), { wrapper });
+            expect(result.current.componentList.TestComponent).toBeDefined();
+            expect(result.current.componentList.TestComponent.name).toBe("TestComponent");
+        });
+        it("registers provided tools", () => {
+            const tools = [
+                {
+                    name: "testTool",
+                    description: "A test tool",
+                    tool: async () => "result",
+                },
+            ];
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread, tools: tools }, children));
+            const { result } = renderHook(() => useTamboRegistry(), { wrapper });
+            expect(result.current.toolRegistry.testTool).toBeDefined();
+            expect(result.current.toolRegistry.testTool.name).toBe("testTool");
+        });
+    });
+    describe("Client", () => {
+        it("provides stub client", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread }, children));
+            const { result } = renderHook(() => useTamboClient(), { wrapper });
+            expect(result.current).toBeDefined();
+        });
+    });
+    describe("Thread management", () => {
+        it("provides thread management functions", () => {
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread }, children));
+            const { result } = renderHook(() => useTamboV1("thread_123"), {
+                wrapper,
+            });
+            expect(typeof result.current.startNewThread).toBe("function");
+            expect(typeof result.current.switchThread).toBe("function");
+            expect(typeof result.current.initThread).toBe("function");
+        });
+        it("calls custom onStartNewThread when provided", () => {
+            const mockStartNewThread = jest.fn().mockReturnValue("custom_thread_id");
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: mockThread, onStartNewThread: mockStartNewThread }, children));
+            const { result } = renderHook(() => useTamboV1("thread_123"), {
+                wrapper,
+            });
+            const newThreadId = result.current.startNewThread();
+            expect(mockStartNewThread).toHaveBeenCalled();
+            expect(newThreadId).toBe("custom_thread_id");
+        });
+    });
+    describe("Messages-only thread", () => {
+        it("accepts just messages array instead of full thread", () => {
+            const messages = [
+                {
+                    id: "msg_1",
+                    role: "user",
+                    content: [{ type: "text", text: "Hello" }],
+                    createdAt: "2024-01-01T00:00:00Z",
+                },
+            ];
+            const wrapper = ({ children }) => (React.createElement(TamboV1StubProvider, { thread: { messages }, threadId: "custom_id" }, children));
+            const { result } = renderHook(() => useTamboV1("custom_id"), { wrapper });
+            expect(result.current.messages).toHaveLength(1);
+            expect(result.current.messages[0].id).toBe("msg_1");
+        });
+    });
+});
+//# sourceMappingURL=tambo-v1-stub-provider.test.js.map

package/esm/v1/providers/tambo-v1-stub-provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-stub-provider.test.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-stub-provider.test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAGvE,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,MAAM,UAAU,GAAkB;QAChC,EAAE,EAAE,YAAY;QAChB,QAAQ,EAAE;YACR;gBACE,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,SAAS,EAAE,sBAAsB;aAClC;YACD;gBACE,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC9C,SAAS,EAAE,sBAAsB;aAClC;SACF;QACD,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,sBAAsB;KAClC,CAAC;IAEF,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,IACpC,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,QAAE,QAAQ,CAAuB,CACtD,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;gBAC7D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,EAAE,WAAW,UACjD,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,IACpC,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACnD,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAC,aAAa,IAC9D,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,YAAY,GAAG,IAAI;iBACtB,EAAE,EAAE;iBACJ,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,IAC5D,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAE/C,MAAM,CAAC,YAAY,CAAC,CAAC,gBAAgB,EAAE,CAAC;YACxC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,wCAAe,CAAC;YAC5C,MAAM,UAAU,GAAG;gBACjB;oBACE,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,kBAAkB;oBAC/B,SAAS,EAAE,aAAa;iBACzB;aACF,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,IAC5D,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAC1D,eAAe,CAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,KAAK,GAAG;gBACZ;oBACE,IAAI,EAAE,UAAU;oBAChB,WAAW,EAAE,aAAa;oBAC1B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ;iBAC3B;aACF,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAY,IACzD,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,IACpC,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,UAAU,IACpC,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9D,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5D,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,kBAAkB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;YAEzE,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAClB,MAAM,EAAE,UAAU,EAClB,gBAAgB,EAAE,kBAAkB,IAEnC,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;gBAC5D,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAEpD,MAAM,CAAC,kBAAkB,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAC9C,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,QAAQ,GAAG;gBACf;oBACE,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;oBACnD,SAAS,EAAE,sBAAsB;iBAClC;aACF,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,oBAAC,mBAAmB,IAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAC,WAAW,IAC5D,QAAQ,CACW,CACvB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { renderHook } from \"@testing-library/react\";\nimport React from \"react\";\nimport { TamboV1StubProvider } from \"./tambo-v1-stub-provider\";\nimport { useTamboV1 } from \"../hooks/use-tambo-v1\";\nimport { useTamboV1ThreadInput } from \"../hooks/use-tambo-v1-thread-input\";\nimport { useTamboRegistry } from \"../../providers/tambo-registry-provider\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport type { TamboV1Thread } from \"../types/thread\";\n\ndescribe(\"TamboV1StubProvider\", () => {\n  const mockThread: TamboV1Thread = {\n    id: \"thread_123\",\n    messages: [\n      {\n        id: \"msg_1\",\n        role: \"user\",\n        content: [{ type: \"text\", text: \"Hello\" }],\n        createdAt: \"2024-01-01T00:00:00Z\",\n      },\n      {\n        id: \"msg_2\",\n        role: \"assistant\",\n        content: [{ type: \"text\", text: \"Hi there!\" }],\n        createdAt: \"2024-01-01T00:00:01Z\",\n      },\n    ],\n    status: \"idle\",\n    createdAt: \"2024-01-01T00:00:00Z\",\n    updatedAt: \"2024-01-01T00:00:01Z\",\n  };\n\n  describe(\"useTamboV1\", () => {\n    it(\"provides thread data via useTamboV1\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n        wrapper,\n      });\n\n      expect(result.current.messages).toHaveLength(2);\n      expect(result.current.messages[0].id).toBe(\"msg_1\");\n      expect(result.current.messages[1].id).toBe(\"msg_2\");\n      expect(result.current.isIdle).toBe(true);\n      expect(result.current.isStreaming).toBe(false);\n    });\n\n    it(\"returns empty messages when no thread provided\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider>{children}</TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1(\"stub_thread\"), {\n        wrapper,\n      });\n\n      expect(result.current.messages).toHaveLength(0);\n      expect(result.current.isIdle).toBe(true);\n    });\n\n    it(\"shows streaming state when isStreaming prop is true\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread} isStreaming>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n        wrapper,\n      });\n\n      expect(result.current.isStreaming).toBe(true);\n      expect(result.current.isIdle).toBe(false);\n    });\n  });\n\n  describe(\"useTamboV1ThreadInput\", () => {\n    it(\"provides thread input context\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1ThreadInput(), { wrapper });\n\n      expect(result.current.value).toBe(\"\");\n      expect(result.current.threadId).toBe(\"thread_123\");\n      expect(typeof result.current.setValue).toBe(\"function\");\n      expect(typeof result.current.submit).toBe(\"function\");\n    });\n\n    it(\"uses initial input value when provided\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread} inputValue=\"Hello world\">\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1ThreadInput(), { wrapper });\n\n      expect(result.current.value).toBe(\"Hello world\");\n    });\n\n    it(\"calls custom onSubmit when provided\", async () => {\n      const mockOnSubmit = jest\n        .fn()\n        .mockResolvedValue({ threadId: \"new_thread\" });\n\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread} onSubmit={mockOnSubmit}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1ThreadInput(), { wrapper });\n\n      const response = await result.current.submit();\n\n      expect(mockOnSubmit).toHaveBeenCalled();\n      expect(response.threadId).toBe(\"new_thread\");\n    });\n  });\n\n  describe(\"Registry\", () => {\n    it(\"registers provided components\", () => {\n      const TestComponent = () => <div>Test</div>;\n      const components = [\n        {\n          name: \"TestComponent\",\n          description: \"A test component\",\n          component: TestComponent,\n        },\n      ];\n\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread} components={components}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n      expect(result.current.componentList.TestComponent).toBeDefined();\n      expect(result.current.componentList.TestComponent.name).toBe(\n        \"TestComponent\",\n      );\n    });\n\n    it(\"registers provided tools\", () => {\n      const tools = [\n        {\n          name: \"testTool\",\n          description: \"A test tool\",\n          tool: async () => \"result\",\n        },\n      ];\n\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread} tools={tools as any}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n      expect(result.current.toolRegistry.testTool).toBeDefined();\n      expect(result.current.toolRegistry.testTool.name).toBe(\"testTool\");\n    });\n  });\n\n  describe(\"Client\", () => {\n    it(\"provides stub client\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboClient(), { wrapper });\n\n      expect(result.current).toBeDefined();\n    });\n  });\n\n  describe(\"Thread management\", () => {\n    it(\"provides thread management functions\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={mockThread}>\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n        wrapper,\n      });\n\n      expect(typeof result.current.startNewThread).toBe(\"function\");\n      expect(typeof result.current.switchThread).toBe(\"function\");\n      expect(typeof result.current.initThread).toBe(\"function\");\n    });\n\n    it(\"calls custom onStartNewThread when provided\", () => {\n      const mockStartNewThread = jest.fn().mockReturnValue(\"custom_thread_id\");\n\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider\n          thread={mockThread}\n          onStartNewThread={mockStartNewThread}\n        >\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n        wrapper,\n      });\n\n      const newThreadId = result.current.startNewThread();\n\n      expect(mockStartNewThread).toHaveBeenCalled();\n      expect(newThreadId).toBe(\"custom_thread_id\");\n    });\n  });\n\n  describe(\"Messages-only thread\", () => {\n    it(\"accepts just messages array instead of full thread\", () => {\n      const messages = [\n        {\n          id: \"msg_1\",\n          role: \"user\" as const,\n          content: [{ type: \"text\" as const, text: \"Hello\" }],\n          createdAt: \"2024-01-01T00:00:00Z\",\n        },\n      ];\n\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StubProvider thread={{ messages }} threadId=\"custom_id\">\n          {children}\n        </TamboV1StubProvider>\n      );\n\n      const { result } = renderHook(() => useTamboV1(\"custom_id\"), { wrapper });\n\n      expect(result.current.messages).toHaveLength(1);\n      expect(result.current.messages[0].id).toBe(\"msg_1\");\n    });\n  });\n});\n"]}

package/esm/v1/providers/tambo-v1-thread-input-provider.d.ts

@@ -0,0 +1,105 @@
+/**
+ * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API
+ *
+ * Provides shared input state across all components, enabling features like
+ * suggestions to update the input field directly.
+ *
+ * This mirrors the beta SDK's TamboThreadInputProvider pattern.
+ */
+import React, { type PropsWithChildren } from "react";
+import { type StagedImage } from "../../hooks/use-message-images";
+import { type UseTamboMutationResult } from "../../hooks/react-query-hooks";
+export declare const INPUT_ERROR_MESSAGES: {
+    readonly EMPTY: "Message cannot be empty";
+    readonly VALIDATION: "Invalid message format";
+};
+/**
+ * Options for submitting a message
+ */
+export interface SubmitOptions {
+    /**
+     * Enable debug logging for the stream
+     */
+    debug?: boolean;
+}
+/**
+ * Context props for thread input state
+ */
+export interface TamboV1ThreadInputContextProps extends Omit<UseTamboMutationResult<{
+    threadId: string | undefined;
+}, Error, SubmitOptions | undefined>, "mutate" | "mutateAsync"> {
+    /** Current value of the input field */
+    value: string;
+    /**
+     * Function to update the input value
+     * @param value - New value for the input field
+     */
+    setValue: React.Dispatch<React.SetStateAction<string>>;
+    /**
+     * Function to submit the current input value
+     * @param options - Submission options
+     * @returns Promise with the threadId
+     */
+    submit: (options?: SubmitOptions) => Promise<{
+        threadId: string | undefined;
+    }>;
+    /** Currently staged images */
+    images: StagedImage[];
+    /** Add a single image */
+    addImage: (file: File) => Promise<void>;
+    /** Add multiple images */
+    addImages: (files: File[]) => Promise<void>;
+    /** Remove an image by id */
+    removeImage: (id: string) => void;
+    /** Clear all staged images */
+    clearImages: () => void;
+    /** Current thread ID being used for input */
+    threadId: string | undefined;
+    /**
+     * Set the thread ID for input submission.
+     * If not set, a new thread will be created on submit.
+     */
+    setThreadId: React.Dispatch<React.SetStateAction<string | undefined>>;
+}
+/**
+ * Context for thread input state.
+ * @internal
+ */
+export declare const TamboV1ThreadInputContext: React.Context<TamboV1ThreadInputContextProps | undefined>;
+/**
+ * Provider that manages shared thread input state across all components.
+ *
+ * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components
+ * all share the same input state.
+ * @param props - Provider props
+ * @param props.children - Child components
+ * @returns Thread input context provider
+ */
+export declare function TamboV1ThreadInputProvider({ children }: PropsWithChildren): React.JSX.Element;
+/**
+ * Hook to access the shared thread input state.
+ *
+ * All components using this hook share the same input state, enabling
+ * features like suggestions to update the input field directly.
+ * @returns The shared thread input context
+ * @throws {Error} If used outside TamboV1ThreadInputProvider
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();
+ *
+ *   return (
+ *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>
+ *       <input
+ *         value={value}
+ *         onChange={(e) => setValue(e.target.value)}
+ *         disabled={isPending}
+ *       />
+ *       <button type="submit" disabled={isPending}>Send</button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTamboV1ThreadInput(): TamboV1ThreadInputContextProps;
+//# sourceMappingURL=tambo-v1-thread-input-provider.d.ts.map

package/esm/v1/providers/tambo-v1-thread-input-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-thread-input-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-thread-input-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EAKZ,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AASvC,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAkCX;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAC1D,sBAAsB,CACpB;IAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAChC,KAAK,EACL,aAAa,GAAG,SAAS,CAC1B,EACD,QAAQ,GAAG,aAAa,CACzB;IACC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD;;;;OAIG;IACH,MAAM,EAAE,CACN,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAE/C,8BAA8B;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,yBAAyB;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,0BAA0B;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,4BAA4B;IAC5B,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B;;;OAGG;IACH,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACvE;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,2DAE1B,CAAC;AAEb;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,qBAoFzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,IAAI,8BAA8B,CAQtE"}

package/esm/v1/providers/tambo-v1-thread-input-provider.js

@@ -0,0 +1,153 @@
+"use client";
+/**
+ * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API
+ *
+ * Provides shared input state across all components, enabling features like
+ * suggestions to update the input field directly.
+ *
+ * This mirrors the beta SDK's TamboThreadInputProvider pattern.
+ */
+import React, { createContext, useCallback, useContext, useState, } from "react";
+import { useMessageImages, } from "../../hooks/use-message-images";
+import { useTamboMutation, } from "../../hooks/react-query-hooks";
+import { useTamboV1SendMessage } from "../hooks/use-tambo-v1-send-message";
+import { useStreamState } from "./tambo-v1-stream-context";
+// Error messages for various input-related error scenarios.
+// TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps
+// failures into a small, stable set of user-facing error codes (at minimum:
+// connectivity failures vs non-2xx responses).
+export const INPUT_ERROR_MESSAGES = {
+    EMPTY: "Message cannot be empty",
+    VALIDATION: "Invalid message format",
+};
+function stagedImageToResourceContent(image) {
+    if (!image.dataUrl.startsWith("data:")) {
+        throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);
+    }
+    const commaIndex = image.dataUrl.indexOf(",");
+    if (commaIndex === -1) {
+        throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);
+    }
+    const header = image.dataUrl.slice("data:".length, commaIndex);
+    const [mimeType, ...params] = header.split(";");
+    const isBase64 = params.includes("base64");
+    if (mimeType !== image.type || !isBase64) {
+        throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);
+    }
+    return {
+        type: "resource",
+        resource: {
+            name: image.name,
+            mimeType: image.type,
+            // Shared.Resource.blob expects base64-encoded data; this is the base64
+            // payload from the `data:` URL.
+            blob: image.dataUrl.slice(commaIndex + 1),
+        },
+    };
+}
+/**
+ * Context for thread input state.
+ * @internal
+ */
+export const TamboV1ThreadInputContext = createContext(undefined);
+/**
+ * Provider that manages shared thread input state across all components.
+ *
+ * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components
+ * all share the same input state.
+ * @param props - Provider props
+ * @param props.children - Child components
+ * @returns Thread input context provider
+ */
+export function TamboV1ThreadInputProvider({ children }) {
+    const [inputValue, setInputValue] = useState("");
+    const [threadId, setThreadId] = useState(undefined);
+    const imageState = useMessageImages();
+    const streamState = useStreamState();
+    // Use the current thread from stream state if no explicit threadId is set
+    const inheritedThreadId = streamState.currentThreadId ?? undefined;
+    const effectiveThreadId = threadId ?? inheritedThreadId;
+    const shouldAdoptThreadId = threadId === undefined && inheritedThreadId === undefined;
+    const sendMessage = useTamboV1SendMessage(effectiveThreadId);
+    const submitFn = useCallback(async (options) => {
+        const trimmedValue = inputValue.trim();
+        // Check if we have content to send
+        if (!trimmedValue && imageState.images.length === 0) {
+            throw new Error(INPUT_ERROR_MESSAGES.EMPTY);
+        }
+        const content = [];
+        if (trimmedValue) {
+            content.push({ type: "text", text: trimmedValue });
+        }
+        for (const image of imageState.images) {
+            content.push(stagedImageToResourceContent(image));
+        }
+        const result = await sendMessage.mutateAsync({
+            message: {
+                role: "user",
+                content,
+            },
+            debug: options?.debug,
+        });
+        // Clear input and images after successful submission
+        setInputValue("");
+        imageState.clearImages();
+        // Update threadId if a new thread was created
+        if (result.threadId && shouldAdoptThreadId) {
+            setThreadId(result.threadId);
+        }
+        return result;
+    }, 
+    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).
+    [inputValue, imageState, sendMessage, shouldAdoptThreadId]);
+    const { mutateAsync: submitAsync, mutate: _unusedSubmit, ...mutationState } = useTamboMutation({
+        mutationFn: submitFn,
+    });
+    const contextValue = {
+        ...mutationState,
+        value: inputValue,
+        setValue: setInputValue,
+        submit: submitAsync,
+        images: imageState.images,
+        addImage: imageState.addImage,
+        addImages: imageState.addImages,
+        removeImage: imageState.removeImage,
+        clearImages: imageState.clearImages,
+        threadId: effectiveThreadId,
+        setThreadId,
+    };
+    return (React.createElement(TamboV1ThreadInputContext.Provider, { value: contextValue }, children));
+}
+/**
+ * Hook to access the shared thread input state.
+ *
+ * All components using this hook share the same input state, enabling
+ * features like suggestions to update the input field directly.
+ * @returns The shared thread input context
+ * @throws {Error} If used outside TamboV1ThreadInputProvider
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();
+ *
+ *   return (
+ *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>
+ *       <input
+ *         value={value}
+ *         onChange={(e) => setValue(e.target.value)}
+ *         disabled={isPending}
+ *       />
+ *       <button type="submit" disabled={isPending}>Send</button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export function useTamboV1ThreadInput() {
+    const context = useContext(TamboV1ThreadInputContext);
+    if (!context) {
+        throw new Error("useTamboV1ThreadInput must be used within TamboV1ThreadInputProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=tambo-v1-thread-input-provider.js.map

package/esm/v1/providers/tambo-v1-thread-input-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-thread-input-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-thread-input-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API\n *\n * Provides shared input state across all components, enabling features like\n * suggestions to update the input field directly.\n *\n * This mirrors the beta SDK's TamboThreadInputProvider pattern.\n */\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useState,\n  type PropsWithChildren,\n} from \"react\";\nimport {\n  useMessageImages,\n  type StagedImage,\n} from \"../../hooks/use-message-images\";\nimport {\n  useTamboMutation,\n  type UseTamboMutationResult,\n} from \"../../hooks/react-query-hooks\";\nimport { useTamboV1SendMessage } from \"../hooks/use-tambo-v1-send-message\";\nimport type { InputMessage } from \"../types/message\";\nimport { useStreamState } from \"./tambo-v1-stream-context\";\n\n// Error messages for various input-related error scenarios.\n// TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps\n// failures into a small, stable set of user-facing error codes (at minimum:\n// connectivity failures vs non-2xx responses).\nexport const INPUT_ERROR_MESSAGES = {\n  EMPTY: \"Message cannot be empty\",\n  VALIDATION: \"Invalid message format\",\n} as const;\n\nfunction stagedImageToResourceContent(\n  image: StagedImage,\n): InputMessage[\"content\"][number] {\n  if (!image.dataUrl.startsWith(\"data:\")) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const commaIndex = image.dataUrl.indexOf(\",\");\n  if (commaIndex === -1) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const header = image.dataUrl.slice(\"data:\".length, commaIndex);\n  const [mimeType, ...params] = header.split(\";\");\n  const isBase64 = params.includes(\"base64\");\n\n  if (mimeType !== image.type || !isBase64) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  return {\n    type: \"resource\",\n    resource: {\n      name: image.name,\n      mimeType: image.type,\n      // Shared.Resource.blob expects base64-encoded data; this is the base64\n      // payload from the `data:` URL.\n      blob: image.dataUrl.slice(commaIndex + 1),\n    },\n  };\n}\n\n/**\n * Options for submitting a message\n */\nexport interface SubmitOptions {\n  /**\n   * Enable debug logging for the stream\n   */\n  debug?: boolean;\n}\n\n/**\n * Context props for thread input state\n */\nexport interface TamboV1ThreadInputContextProps extends Omit<\n  UseTamboMutationResult<\n    { threadId: string | undefined },\n    Error,\n    SubmitOptions | undefined\n  >,\n  \"mutate\" | \"mutateAsync\"\n> {\n  /** Current value of the input field */\n  value: string;\n\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: React.Dispatch<React.SetStateAction<string>>;\n\n  /**\n   * Function to submit the current input value\n   * @param options - Submission options\n   * @returns Promise with the threadId\n   */\n  submit: (\n    options?: SubmitOptions,\n  ) => Promise<{ threadId: string | undefined }>;\n\n  /** Currently staged images */\n  images: StagedImage[];\n\n  /** Add a single image */\n  addImage: (file: File) => Promise<void>;\n\n  /** Add multiple images */\n  addImages: (files: File[]) => Promise<void>;\n\n  /** Remove an image by id */\n  removeImage: (id: string) => void;\n\n  /** Clear all staged images */\n  clearImages: () => void;\n\n  /** Current thread ID being used for input */\n  threadId: string | undefined;\n\n  /**\n   * Set the thread ID for input submission.\n   * If not set, a new thread will be created on submit.\n   */\n  setThreadId: React.Dispatch<React.SetStateAction<string | undefined>>;\n}\n\n/**\n * Context for thread input state.\n * @internal\n */\nexport const TamboV1ThreadInputContext = createContext<\n  TamboV1ThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components.\n *\n * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components\n * all share the same input state.\n * @param props - Provider props\n * @param props.children - Child components\n * @returns Thread input context provider\n */\nexport function TamboV1ThreadInputProvider({ children }: PropsWithChildren) {\n  const [inputValue, setInputValue] = useState(\"\");\n  const [threadId, setThreadId] = useState<string | undefined>(undefined);\n  const imageState = useMessageImages();\n  const streamState = useStreamState();\n\n  // Use the current thread from stream state if no explicit threadId is set\n  const inheritedThreadId = streamState.currentThreadId ?? undefined;\n  const effectiveThreadId = threadId ?? inheritedThreadId;\n  const shouldAdoptThreadId =\n    threadId === undefined && inheritedThreadId === undefined;\n  const sendMessage = useTamboV1SendMessage(effectiveThreadId);\n\n  const submitFn = useCallback(\n    async (\n      options?: SubmitOptions,\n    ): Promise<{ threadId: string | undefined }> => {\n      const trimmedValue = inputValue.trim();\n\n      // Check if we have content to send\n      if (!trimmedValue && imageState.images.length === 0) {\n        throw new Error(INPUT_ERROR_MESSAGES.EMPTY);\n      }\n\n      const content: InputMessage[\"content\"] = [];\n\n      if (trimmedValue) {\n        content.push({ type: \"text\", text: trimmedValue });\n      }\n\n      for (const image of imageState.images) {\n        content.push(stagedImageToResourceContent(image));\n      }\n\n      const result = await sendMessage.mutateAsync({\n        message: {\n          role: \"user\",\n          content,\n        },\n        debug: options?.debug,\n      });\n\n      // Clear input and images after successful submission\n      setInputValue(\"\");\n      imageState.clearImages();\n\n      // Update threadId if a new thread was created\n      if (result.threadId && shouldAdoptThreadId) {\n        setThreadId(result.threadId);\n      }\n\n      return result;\n    },\n    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).\n    [inputValue, imageState, sendMessage, shouldAdoptThreadId],\n  );\n\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationFn: submitFn,\n  });\n\n  const contextValue: TamboV1ThreadInputContextProps = {\n    ...mutationState,\n    value: inputValue,\n    setValue: setInputValue,\n    submit: submitAsync,\n    images: imageState.images,\n    addImage: imageState.addImage,\n    addImages: imageState.addImages,\n    removeImage: imageState.removeImage,\n    clearImages: imageState.clearImages,\n    threadId: effectiveThreadId,\n    setThreadId,\n  };\n\n  return (\n    <TamboV1ThreadInputContext.Provider value={contextValue}>\n      {children}\n    </TamboV1ThreadInputContext.Provider>\n  );\n}\n\n/**\n * Hook to access the shared thread input state.\n *\n * All components using this hook share the same input state, enabling\n * features like suggestions to update the input field directly.\n * @returns The shared thread input context\n * @throws {Error} If used outside TamboV1ThreadInputProvider\n * @example\n * ```tsx\n * function ChatInput() {\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>\n *       <input\n *         value={value}\n *         onChange={(e) => setValue(e.target.value)}\n *         disabled={isPending}\n *       />\n *       <button type=\"submit\" disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadInput(): TamboV1ThreadInputContextProps {\n  const context = useContext(TamboV1ThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboV1ThreadInput must be used within TamboV1ThreadInputProvider\",\n    );\n  }\n  return context;\n}\n"]}

package/esm/v1/utils/component-renderer.d.ts

@@ -1,5 +1,10 @@
-import type { ComponentRegistry } from "../../model/component-metadata";
-import type { Content, TamboV1Message, V1ComponentContent } from "../types/message";
+/**
+ * Component Renderer Utility for v1 API
+ *
+ * Provides the component content context for rendered components.
+ * Components can use useV1ComponentContent() to access their context.
+ */
+import React from "react";
 /**
  * Context for component content blocks.
  * Provides access to the component ID and thread ID for component state hooks.
@@ -14,6 +19,14 @@ export interface V1ComponentContentContext {
     /** Component name */
     componentName: string;
 }
+/**
+ * Provider for component content context.
+ * Wraps rendered components to provide access to component metadata.
+ * @returns Provider component with memoized context value
+ */
+export declare function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }: V1ComponentContentContext & {
+    children: React.ReactNode;
+}): React.JSX.Element;
 /**
  * Hook to access the current component content context.
  * Must be used within a rendered component.
@@ -21,69 +34,4 @@ export interface V1ComponentContentContext {
  * @throws {Error} If used outside a rendered component
  */
 export declare function useV1ComponentContent(): V1ComponentContentContext;
-/**
- * Hook to optionally access the current component content context.
- * Returns null if not within a rendered component.
- * @returns Component content context or null
- */
-export declare function useV1ComponentContentOptional(): V1ComponentContentContext | null;
-/**
- * Options for rendering a component content block.
- */
-export interface RenderComponentOptions {
-    /** Thread ID for the component context */
-    threadId: string;
-    /** Message ID the component belongs to */
-    messageId: string;
-    /** Component registry to look up components */
-    componentList: ComponentRegistry;
-}
-/**
- * Check if a content block is a component.
- * @param content - Content block to check
- * @returns True if content is a V1ComponentContent
- */
-export declare function isComponentContent(content: Content): content is V1ComponentContent;
-/**
- * Render a component content block into a React element.
- *
- * Looks up the component in the registry, creates a React element with props,
- * and wraps it with the component content context provider.
- * @param content - Component content block to render
- * @param options - Rendering options including registry and context info
- * @returns V1ComponentContent with the renderedComponent attached
- * @example
- * ```tsx
- * const rendered = renderComponentContent(componentContent, {
- *   threadId: 'thread_123',
- *   messageId: 'msg_456',
- *   componentList: registry.componentList,
- * });
- *
- * // Use in JSX:
- * {rendered.renderedComponent}
- * ```
- */
-export declare function renderComponentContent(content: V1ComponentContent, options: RenderComponentOptions): V1ComponentContent;
-/**
- * Render all component content blocks in a message.
- *
- * Renders component content blocks and attaches renderedComponent.
- * Non-component content blocks are passed through unchanged.
- * @param content - Array of content blocks
- * @param options - Rendering options including registry and context info
- * @returns Array of content with rendered components
- */
-export declare function renderMessageContent(content: Content[], options: RenderComponentOptions): Content[];
-/**
- * Render all components in a message.
- *
- * Creates a new message object with all component content blocks rendered.
- * @param message - Message to render components for
- * @param options - Rendering options (threadId is extracted from message if not provided)
- * @returns Message with rendered component content
- */
-export declare function renderMessageComponents(message: TamboV1Message, options: Omit<RenderComponentOptions, "messageId"> & {
-    threadId: string;
-}): TamboV1Message;
 //# sourceMappingURL=component-renderer.d.ts.map

package/esm/v1/utils/component-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAuDA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AA+BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,yBAAyB,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,kBAAkB,CAE/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,sBAAsB,GAC9B,kBAAkB,CAwDpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,EAAE,CAQX;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxE,cAAc,CAUhB"}
+{"version":3,"file":"component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,GACd,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAY3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAQjE"}