@tambo-ai/react 0.71.0 → 0.72.0

package/dist/v1/hooks/use-tambo-v1-thread-input.js

@@ -0,0 +1,76 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTamboV1ThreadInput = useTamboV1ThreadInput;
+/**
+ * useTamboV1ThreadInput - Thread Input Hook for v1 API
+ *
+ * Manages thread input state and message submission, mirroring
+ * the beta SDK's useTamboThreadInput API.
+ */
+const react_1 = require("react");
+const use_tambo_v1_send_message_1 = require("./use-tambo-v1-send-message");
+/**
+ * Hook to manage thread input state and message submission.
+ *
+ * Provides a similar API to the beta SDK's useTamboThreadInput,
+ * managing input value state and providing a submit function.
+ * @param threadId - Optional thread ID to send messages to. If not provided, creates new thread
+ * @returns Thread input state and submit function
+ * @example
+ * ```tsx
+ * function ChatInput({ threadId }: { threadId?: string }) {
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
+ *     console.log('Sent to thread:', result.threadId);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input
+ *         value={value}
+ *         onChange={(e) => setValue(e.target.value)}
+ *         disabled={isPending}
+ *       />
+ *       <button type="submit" disabled={isPending || !value.trim()}>
+ *         Send
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+function useTamboV1ThreadInput(threadId) {
+    const [value, setValue] = (0, react_1.useState)("");
+    const mutation = (0, use_tambo_v1_send_message_1.useTamboV1SendMessage)(threadId);
+    const submit = (0, react_1.useCallback)(async (options) => {
+        const trimmedValue = value.trim();
+        if (!trimmedValue) {
+            throw new Error("Message cannot be empty");
+        }
+        const result = await mutation.mutateAsync({
+            message: {
+                role: "user",
+                content: [{ type: "text", text: trimmedValue }],
+            },
+            debug: options?.debug,
+        });
+        // Clear input on successful submission
+        setValue("");
+        return result;
+    }, [value, mutation]);
+    return {
+        value,
+        setValue,
+        submit,
+        isPending: mutation.isPending,
+        isError: mutation.isError,
+        error: mutation.error,
+        isSuccess: mutation.isSuccess,
+        reset: mutation.reset,
+    };
+}
+//# sourceMappingURL=use-tambo-v1-thread-input.js.map

package/dist/v1/hooks/use-tambo-v1-thread-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread-input.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread-input.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AA0Eb,sDAuCC;AA/GD;;;;;GAKG;AAEH,iCAA8C;AAC9C,2EAAoE;AA+BpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,SAAgB,qBAAqB,CACnC,QAAiB;IAEjB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAA,iDAAqB,EAAC,QAAQ,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAA,mBAAW,EACxB,KAAK,EAAE,OAAuB,EAAE,EAAE;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC;YACxC,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;aAChD;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;QAEH,uCAAuC;QACvC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEb,OAAO,MAAM,CAAC;IAChB,CAAC,EACD,CAAC,KAAK,EAAE,QAAQ,CAAC,CAClB,CAAC;IAEF,OAAO;QACL,KAAK;QACL,QAAQ;QACR,MAAM;QACN,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC","sourcesContent":["\"use client\";\n\n/**\n * useTamboV1ThreadInput - Thread Input Hook for v1 API\n *\n * Manages thread input state and message submission, mirroring\n * the beta SDK's useTamboThreadInput API.\n */\n\nimport { useCallback, useState } from \"react\";\nimport { useTamboV1SendMessage } from \"./use-tambo-v1-send-message\";\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 * Return type for useTamboV1ThreadInput hook\n */\nexport interface UseTamboV1ThreadInputReturn {\n  /** Current value of the input field */\n  value: string;\n  /** Function to update the input value */\n  setValue: React.Dispatch<React.SetStateAction<string>>;\n  /** Submit the current input. Clears input on success. */\n  submit: (\n    options?: SubmitOptions,\n  ) => Promise<{ threadId: string | undefined }>;\n  isPending: boolean;\n  isError: boolean;\n  error: Error | null;\n  isSuccess: boolean;\n  reset: () => void;\n}\n\n/**\n * Hook to manage thread input state and message submission.\n *\n * Provides a similar API to the beta SDK's useTamboThreadInput,\n * managing input value state and providing a submit function.\n * @param threadId - Optional thread ID to send messages to. If not provided, creates new thread\n * @returns Thread input state and submit function\n * @example\n * ```tsx\n * function ChatInput({ threadId }: { threadId?: string }) {\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);\n *\n *   const handleSubmit = async (e: React.FormEvent) => {\n *     e.preventDefault();\n *     const result = await submit();\n *     console.log('Sent to thread:', result.threadId);\n *   };\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       <input\n *         value={value}\n *         onChange={(e) => setValue(e.target.value)}\n *         disabled={isPending}\n *       />\n *       <button type=\"submit\" disabled={isPending || !value.trim()}>\n *         Send\n *       </button>\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadInput(\n  threadId?: string,\n): UseTamboV1ThreadInputReturn {\n  const [value, setValue] = useState(\"\");\n  const mutation = useTamboV1SendMessage(threadId);\n\n  const submit = useCallback(\n    async (options?: SubmitOptions) => {\n      const trimmedValue = value.trim();\n      if (!trimmedValue) {\n        throw new Error(\"Message cannot be empty\");\n      }\n\n      const result = await mutation.mutateAsync({\n        message: {\n          role: \"user\",\n          content: [{ type: \"text\", text: trimmedValue }],\n        },\n        debug: options?.debug,\n      });\n\n      // Clear input on successful submission\n      setValue(\"\");\n\n      return result;\n    },\n    [value, mutation],\n  );\n\n  return {\n    value,\n    setValue,\n    submit,\n    isPending: mutation.isPending,\n    isError: mutation.isError,\n    error: mutation.error,\n    isSuccess: mutation.isSuccess,\n    reset: mutation.reset,\n  };\n}\n"]}

package/dist/v1/hooks/use-tambo-v1-thread-input.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-tambo-v1-thread-input.test.d.ts.map

package/dist/v1/hooks/use-tambo-v1-thread-input.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread-input.test.d.ts","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread-input.test.tsx"],"names":[],"mappings":""}

package/dist/v1/hooks/use-tambo-v1-thread-input.test.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const use_tambo_v1_thread_input_1 = require("./use-tambo-v1-thread-input");
+// Create mock functions
+const mockMutateAsync = jest.fn();
+const mockMutate = jest.fn();
+const mockReset = jest.fn();
+// Mock useTamboV1SendMessage module
+jest.mock("./use-tambo-v1-send-message");
+const use_tambo_v1_send_message_1 = require("./use-tambo-v1-send-message");
+// Helper to set up the mock with default values
+function setupMock(overrides = {}) {
+    const mockReturn = {
+        mutateAsync: mockMutateAsync,
+        mutate: mockMutate,
+        isPending: false,
+        isError: false,
+        error: null,
+        isSuccess: false,
+        isIdle: true,
+        isPaused: false,
+        status: "idle",
+        data: undefined,
+        variables: undefined,
+        failureCount: 0,
+        failureReason: null,
+        reset: mockReset,
+        context: undefined,
+        submittedAt: 0,
+        ...overrides,
+    };
+    jest.mocked(use_tambo_v1_send_message_1.useTamboV1SendMessage).mockReturnValue(mockReturn);
+    return mockReturn;
+}
+describe("useTamboV1ThreadInput", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockMutateAsync.mockResolvedValue({ threadId: "thread_123" });
+        setupMock();
+    });
+    describe("State Management", () => {
+        it("initializes with empty value", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            expect(result.current.value).toBe("");
+        });
+        it("updates value via setValue", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            (0, react_1.act)(() => {
+                result.current.setValue("Hello world");
+            });
+            expect(result.current.value).toBe("Hello world");
+        });
+        it("supports functional updates for setValue", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            (0, react_1.act)(() => {
+                result.current.setValue("Hello");
+            });
+            (0, react_1.act)(() => {
+                result.current.setValue((prev) => `${prev} world`);
+            });
+            expect(result.current.value).toBe("Hello world");
+        });
+    });
+    describe("Submit Behavior", () => {
+        it("submits message and clears input on success", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)("thread_123"));
+            (0, react_1.act)(() => {
+                result.current.setValue("Test message");
+            });
+            await (0, react_1.act)(async () => {
+                const response = await result.current.submit();
+                expect(response.threadId).toBe("thread_123");
+            });
+            // Input should be cleared
+            expect(result.current.value).toBe("");
+            // Should have called mutateAsync with correct message format
+            expect(mockMutateAsync).toHaveBeenCalledWith({
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: "Test message" }],
+                },
+                debug: undefined,
+            });
+        });
+        it("throws error when submitting empty message", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            await expect(result.current.submit()).rejects.toThrow("Message cannot be empty");
+            expect(mockMutateAsync).not.toHaveBeenCalled();
+        });
+        it("throws error when submitting whitespace-only message", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            (0, react_1.act)(() => {
+                result.current.setValue("   ");
+            });
+            await expect(result.current.submit()).rejects.toThrow("Message cannot be empty");
+            expect(mockMutateAsync).not.toHaveBeenCalled();
+        });
+        it("passes debug option to mutation", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            (0, react_1.act)(() => {
+                result.current.setValue("Debug message");
+            });
+            await (0, react_1.act)(async () => {
+                await result.current.submit({ debug: true });
+            });
+            expect(mockMutateAsync).toHaveBeenCalledWith({
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: "Debug message" }],
+                },
+                debug: true,
+            });
+        });
+        it("trims whitespace from message", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            (0, react_1.act)(() => {
+                result.current.setValue("  Trimmed message  ");
+            });
+            await (0, react_1.act)(async () => {
+                await result.current.submit();
+            });
+            expect(mockMutateAsync).toHaveBeenCalledWith({
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: "Trimmed message" }],
+                },
+                debug: undefined,
+            });
+        });
+    });
+    describe("Thread ID Handling", () => {
+        it("passes threadId to useTamboV1SendMessage", () => {
+            (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)("custom_thread_id"));
+            expect(use_tambo_v1_send_message_1.useTamboV1SendMessage).toHaveBeenCalledWith("custom_thread_id");
+        });
+        it("passes undefined threadId when not provided", () => {
+            (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            expect(use_tambo_v1_send_message_1.useTamboV1SendMessage).toHaveBeenCalledWith(undefined);
+        });
+    });
+    describe("Mutation State", () => {
+        it("exposes isPending state", () => {
+            setupMock({ isPending: true });
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            expect(result.current.isPending).toBe(true);
+        });
+        it("exposes isError state", () => {
+            setupMock({ isError: true, error: new Error("Test error") });
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            expect(result.current.isError).toBe(true);
+            expect(result.current.error?.message).toBe("Test error");
+        });
+        it("exposes isSuccess state", () => {
+            setupMock({ isSuccess: true });
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            expect(result.current.isSuccess).toBe(true);
+        });
+        it("exposes reset function", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)());
+            (0, react_1.act)(() => {
+                result.current.reset();
+            });
+            expect(mockReset).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=use-tambo-v1-thread-input.test.js.map

package/dist/v1/hooks/use-tambo-v1-thread-input.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread-input.test.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread-input.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { renderHook, act } from \"@testing-library/react\";\nimport { useTamboV1ThreadInput } from \"./use-tambo-v1-thread-input\";\n\n// Create mock functions\nconst mockMutateAsync = jest.fn();\nconst mockMutate = jest.fn();\nconst mockReset = jest.fn();\n\n// Mock useTamboV1SendMessage module\njest.mock(\"./use-tambo-v1-send-message\");\n\nimport { useTamboV1SendMessage } from \"./use-tambo-v1-send-message\";\n\n// Helper to set up the mock with default values\nfunction setupMock(overrides: Record<string, unknown> = {}) {\n  const mockReturn = {\n    mutateAsync: mockMutateAsync,\n    mutate: mockMutate,\n    isPending: false as const,\n    isError: false as const,\n    error: null,\n    isSuccess: false as const,\n    isIdle: true as const,\n    isPaused: false as const,\n    status: \"idle\" as const,\n    data: undefined,\n    variables: undefined,\n    failureCount: 0,\n    failureReason: null,\n    reset: mockReset,\n    context: undefined,\n    submittedAt: 0,\n    ...overrides,\n  };\n  jest.mocked(useTamboV1SendMessage).mockReturnValue(mockReturn);\n  return mockReturn;\n}\n\ndescribe(\"useTamboV1ThreadInput\", () => {\n  beforeEach(() => {\n    jest.clearAllMocks();\n    mockMutateAsync.mockResolvedValue({ threadId: \"thread_123\" });\n    setupMock();\n  });\n\n  describe(\"State Management\", () => {\n    it(\"initializes with empty value\", () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      expect(result.current.value).toBe(\"\");\n    });\n\n    it(\"updates value via setValue\", () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      act(() => {\n        result.current.setValue(\"Hello world\");\n      });\n\n      expect(result.current.value).toBe(\"Hello world\");\n    });\n\n    it(\"supports functional updates for setValue\", () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      act(() => {\n        result.current.setValue(\"Hello\");\n      });\n\n      act(() => {\n        result.current.setValue((prev) => `${prev} world`);\n      });\n\n      expect(result.current.value).toBe(\"Hello world\");\n    });\n  });\n\n  describe(\"Submit Behavior\", () => {\n    it(\"submits message and clears input on success\", async () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput(\"thread_123\"));\n\n      act(() => {\n        result.current.setValue(\"Test message\");\n      });\n\n      await act(async () => {\n        const response = await result.current.submit();\n        expect(response.threadId).toBe(\"thread_123\");\n      });\n\n      // Input should be cleared\n      expect(result.current.value).toBe(\"\");\n\n      // Should have called mutateAsync with correct message format\n      expect(mockMutateAsync).toHaveBeenCalledWith({\n        message: {\n          role: \"user\",\n          content: [{ type: \"text\", text: \"Test message\" }],\n        },\n        debug: undefined,\n      });\n    });\n\n    it(\"throws error when submitting empty message\", async () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      await expect(result.current.submit()).rejects.toThrow(\n        \"Message cannot be empty\",\n      );\n\n      expect(mockMutateAsync).not.toHaveBeenCalled();\n    });\n\n    it(\"throws error when submitting whitespace-only message\", async () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      act(() => {\n        result.current.setValue(\"   \");\n      });\n\n      await expect(result.current.submit()).rejects.toThrow(\n        \"Message cannot be empty\",\n      );\n\n      expect(mockMutateAsync).not.toHaveBeenCalled();\n    });\n\n    it(\"passes debug option to mutation\", async () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      act(() => {\n        result.current.setValue(\"Debug message\");\n      });\n\n      await act(async () => {\n        await result.current.submit({ debug: true });\n      });\n\n      expect(mockMutateAsync).toHaveBeenCalledWith({\n        message: {\n          role: \"user\",\n          content: [{ type: \"text\", text: \"Debug message\" }],\n        },\n        debug: true,\n      });\n    });\n\n    it(\"trims whitespace from message\", async () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      act(() => {\n        result.current.setValue(\"  Trimmed message  \");\n      });\n\n      await act(async () => {\n        await result.current.submit();\n      });\n\n      expect(mockMutateAsync).toHaveBeenCalledWith({\n        message: {\n          role: \"user\",\n          content: [{ type: \"text\", text: \"Trimmed message\" }],\n        },\n        debug: undefined,\n      });\n    });\n  });\n\n  describe(\"Thread ID Handling\", () => {\n    it(\"passes threadId to useTamboV1SendMessage\", () => {\n      renderHook(() => useTamboV1ThreadInput(\"custom_thread_id\"));\n\n      expect(useTamboV1SendMessage).toHaveBeenCalledWith(\"custom_thread_id\");\n    });\n\n    it(\"passes undefined threadId when not provided\", () => {\n      renderHook(() => useTamboV1ThreadInput());\n\n      expect(useTamboV1SendMessage).toHaveBeenCalledWith(undefined);\n    });\n  });\n\n  describe(\"Mutation State\", () => {\n    it(\"exposes isPending state\", () => {\n      setupMock({ isPending: true });\n\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      expect(result.current.isPending).toBe(true);\n    });\n\n    it(\"exposes isError state\", () => {\n      setupMock({ isError: true, error: new Error(\"Test error\") });\n\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      expect(result.current.isError).toBe(true);\n      expect(result.current.error?.message).toBe(\"Test error\");\n    });\n\n    it(\"exposes isSuccess state\", () => {\n      setupMock({ isSuccess: true });\n\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      expect(result.current.isSuccess).toBe(true);\n    });\n\n    it(\"exposes reset function\", () => {\n      const { result } = renderHook(() => useTamboV1ThreadInput());\n\n      act(() => {\n        result.current.reset();\n      });\n\n      expect(mockReset).toHaveBeenCalled();\n    });\n  });\n});\n"]}

package/dist/v1/index.d.ts

@@ -10,7 +10,7 @@
  * import {
  *   TamboV1Provider,
  *   useTamboV1,
- *   useTamboV1SendMessage,
+ *   useTamboV1ThreadInput,
  * } from '@tambo-ai/react/v1';
  *
  * function App() {
@@ -28,21 +28,21 @@
  * function ChatInterface() {
  *   const [threadId, setThreadId] = useState<string>();
  *   const { messages, isStreaming } = useTamboV1(threadId);
- *   const sendMessage = useTamboV1SendMessage(threadId);
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
  *
- *   const handleSend = async (text: string) => {
- *     const result = await sendMessage.mutateAsync({
- *       message: { role: 'user', content: [{ type: 'text', text }] },
- *     });
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
  *     if (!threadId) setThreadId(result.threadId);
  *   };
  *
  *   return (
- *     <div>
+ *     <form onSubmit={handleSubmit}>
  *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
  *       {isStreaming && <LoadingIndicator />}
- *       <MessageInput onSend={handleSend} />
- *     </div>
+ *       <input value={value} onChange={(e) => setValue(e.target.value)} />
+ *       <button disabled={isPending}>Send</button>
+ *     </form>
  *   );
  * }
  * ```
@@ -57,17 +57,28 @@
  * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`
  * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`
  */
-export { TamboV1Provider, type TamboV1ProviderProps, } from "./providers/tambo-v1-provider";
+export { TamboV1Provider, useContextKey, type TamboV1ProviderProps, } from "./providers/tambo-v1-provider";
 export { TamboV1StreamProvider, useStreamState, useStreamDispatch, useThreadManagement, type ThreadManagement, } from "./providers/tambo-v1-stream-context";
 export { TamboRegistryProvider } from "../providers/tambo-registry-provider";
+export { TamboContextHelpersProvider, useTamboContextHelpers, } from "../providers/tambo-context-helpers-provider";
 export { useTamboV1, type UseTamboV1Return } from "./hooks/use-tambo-v1";
-export { useTamboV1Messages, type UseTamboV1MessagesReturn, } from "./hooks/use-tambo-v1-messages";
-export { useTamboV1SendMessage, type SendMessageOptions, } from "./hooks/use-tambo-v1-send-message";
+export { useTamboV1ThreadInput, type UseTamboV1ThreadInputReturn, type SubmitOptions, } from "./hooks/use-tambo-v1-thread-input";
 export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread";
 export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list";
+export { useTamboV1ComponentState, type UseTamboV1ComponentStateReturn, } from "./hooks/use-tambo-v1-component-state";
+export { useTamboClient } from "../providers/tambo-client-provider";
+export { useTamboRegistry } from "../providers/tambo-registry-provider";
+export { useV1ComponentContent, useV1ComponentContentOptional, renderComponentContent, renderMessageContent, renderMessageComponents, isComponentContent, type V1ComponentContentContext, type RenderComponentOptions, } from "./utils/component-renderer";
 export { applyJsonPatch } from "./utils/json-patch";
 export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion";
 export { executeClientTool, executeAllPendingTools, type PendingToolCall, } from "./utils/tool-executor";
 export { ToolCallTracker } from "./utils/tool-call-tracker";
 export { handleEventStream } from "./utils/stream-handler";
+export { defineTool } from "../util/registry";
+export { currentPageContextHelper, currentTimeContextHelper, } from "../context-helpers";
+export type { AdditionalContext, ContextHelperFn, ContextHelpers, } from "../context-helpers";
+export type { ComponentContextToolMetadata, ComponentRegistry, ParameterSpec, RegisteredComponent, TamboTool, ToolAnnotations, } from "../model/component-metadata";
+export { MCPTransport } from "../model/mcp-server-info";
+export type { McpServerInfo, NormalizedMcpServerInfo, } from "../model/mcp-server-info";
+export type { ListResourceItem, ReadResourceResult, ResourceSource, } from "../model/resource-info";
 //# sourceMappingURL=index.d.ts.map

package/dist/v1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAM7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAMxE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6CAA6C,CAAC;AAMrD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAMxE,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/dist/v1/index.js

@@ -11,7 +11,7 @@
  * import {
  *   TamboV1Provider,
  *   useTamboV1,
- *   useTamboV1SendMessage,
+ *   useTamboV1ThreadInput,
  * } from '@tambo-ai/react/v1';
  *
  * function App() {
@@ -29,21 +29,21 @@
  * function ChatInterface() {
  *   const [threadId, setThreadId] = useState<string>();
  *   const { messages, isStreaming } = useTamboV1(threadId);
- *   const sendMessage = useTamboV1SendMessage(threadId);
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
  *
- *   const handleSend = async (text: string) => {
- *     const result = await sendMessage.mutateAsync({
- *       message: { role: 'user', content: [{ type: 'text', text }] },
- *     });
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
  *     if (!threadId) setThreadId(result.threadId);
  *   };
  *
  *   return (
- *     <div>
+ *     <form onSubmit={handleSubmit}>
  *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
  *       {isStreaming && <LoadingIndicator />}
- *       <MessageInput onSend={handleSend} />
- *     </div>
+ *       <input value={value} onChange={(e) => setValue(e.target.value)} />
+ *       <button disabled={isPending}>Send</button>
+ *     </form>
  *   );
  * }
  * ```
@@ -59,12 +59,13 @@
  * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleEventStream = exports.ToolCallTracker = exports.executeAllPendingTools = exports.executeClientTool = exports.toAvailableTools = exports.toAvailableTool = exports.toAvailableComponents = exports.toAvailableComponent = exports.applyJsonPatch = exports.useTamboV1ThreadList = exports.useTamboV1Thread = exports.useTamboV1SendMessage = exports.useTamboV1Messages = exports.useTamboV1 = exports.TamboRegistryProvider = exports.useThreadManagement = exports.useStreamDispatch = exports.useStreamState = exports.TamboV1StreamProvider = exports.TamboV1Provider = void 0;
+exports.MCPTransport = exports.currentTimeContextHelper = exports.currentPageContextHelper = exports.defineTool = exports.handleEventStream = exports.ToolCallTracker = exports.executeAllPendingTools = exports.executeClientTool = exports.toAvailableTools = exports.toAvailableTool = exports.toAvailableComponents = exports.toAvailableComponent = exports.applyJsonPatch = exports.isComponentContent = exports.renderMessageComponents = exports.renderMessageContent = exports.renderComponentContent = exports.useV1ComponentContentOptional = exports.useV1ComponentContent = exports.useTamboRegistry = exports.useTamboClient = exports.useTamboV1ComponentState = exports.useTamboV1ThreadList = exports.useTamboV1Thread = exports.useTamboV1ThreadInput = exports.useTamboV1 = exports.useTamboContextHelpers = exports.TamboContextHelpersProvider = exports.TamboRegistryProvider = exports.useThreadManagement = exports.useStreamDispatch = exports.useStreamState = exports.TamboV1StreamProvider = exports.useContextKey = exports.TamboV1Provider = void 0;
 // =============================================================================
 // Providers
 // =============================================================================
 var tambo_v1_provider_1 = require("./providers/tambo-v1-provider");
 Object.defineProperty(exports, "TamboV1Provider", { enumerable: true, get: function () { return tambo_v1_provider_1.TamboV1Provider; } });
+Object.defineProperty(exports, "useContextKey", { enumerable: true, get: function () { return tambo_v1_provider_1.useContextKey; } });
 var tambo_v1_stream_context_1 = require("./providers/tambo-v1-stream-context");
 Object.defineProperty(exports, "TamboV1StreamProvider", { enumerable: true, get: function () { return tambo_v1_stream_context_1.TamboV1StreamProvider; } });
 Object.defineProperty(exports, "useStreamState", { enumerable: true, get: function () { return tambo_v1_stream_context_1.useStreamState; } });
@@ -73,19 +74,39 @@ Object.defineProperty(exports, "useThreadManagement", { enumerable: true, get: f
 // Re-export registry provider from beta SDK (works with v1)
 var tambo_registry_provider_1 = require("../providers/tambo-registry-provider");
 Object.defineProperty(exports, "TamboRegistryProvider", { enumerable: true, get: function () { return tambo_registry_provider_1.TamboRegistryProvider; } });
+// Re-export context helpers from beta SDK (works with v1)
+var tambo_context_helpers_provider_1 = require("../providers/tambo-context-helpers-provider");
+Object.defineProperty(exports, "TamboContextHelpersProvider", { enumerable: true, get: function () { return tambo_context_helpers_provider_1.TamboContextHelpersProvider; } });
+Object.defineProperty(exports, "useTamboContextHelpers", { enumerable: true, get: function () { return tambo_context_helpers_provider_1.useTamboContextHelpers; } });
 // =============================================================================
 // Hooks
 // =============================================================================
 var use_tambo_v1_1 = require("./hooks/use-tambo-v1");
 Object.defineProperty(exports, "useTamboV1", { enumerable: true, get: function () { return use_tambo_v1_1.useTamboV1; } });
-var use_tambo_v1_messages_1 = require("./hooks/use-tambo-v1-messages");
-Object.defineProperty(exports, "useTamboV1Messages", { enumerable: true, get: function () { return use_tambo_v1_messages_1.useTamboV1Messages; } });
-var use_tambo_v1_send_message_1 = require("./hooks/use-tambo-v1-send-message");
-Object.defineProperty(exports, "useTamboV1SendMessage", { enumerable: true, get: function () { return use_tambo_v1_send_message_1.useTamboV1SendMessage; } });
+var use_tambo_v1_thread_input_1 = require("./hooks/use-tambo-v1-thread-input");
+Object.defineProperty(exports, "useTamboV1ThreadInput", { enumerable: true, get: function () { return use_tambo_v1_thread_input_1.useTamboV1ThreadInput; } });
 var use_tambo_v1_thread_1 = require("./hooks/use-tambo-v1-thread");
 Object.defineProperty(exports, "useTamboV1Thread", { enumerable: true, get: function () { return use_tambo_v1_thread_1.useTamboV1Thread; } });
 var use_tambo_v1_thread_list_1 = require("./hooks/use-tambo-v1-thread-list");
 Object.defineProperty(exports, "useTamboV1ThreadList", { enumerable: true, get: function () { return use_tambo_v1_thread_list_1.useTamboV1ThreadList; } });
+var use_tambo_v1_component_state_1 = require("./hooks/use-tambo-v1-component-state");
+Object.defineProperty(exports, "useTamboV1ComponentState", { enumerable: true, get: function () { return use_tambo_v1_component_state_1.useTamboV1ComponentState; } });
+// Re-export client hook from beta SDK (works with v1)
+var tambo_client_provider_1 = require("../providers/tambo-client-provider");
+Object.defineProperty(exports, "useTamboClient", { enumerable: true, get: function () { return tambo_client_provider_1.useTamboClient; } });
+// Re-export registry hook from beta SDK (works with v1)
+var tambo_registry_provider_2 = require("../providers/tambo-registry-provider");
+Object.defineProperty(exports, "useTamboRegistry", { enumerable: true, get: function () { return tambo_registry_provider_2.useTamboRegistry; } });
+// =============================================================================
+// Component Rendering
+// =============================================================================
+var component_renderer_1 = require("./utils/component-renderer");
+Object.defineProperty(exports, "useV1ComponentContent", { enumerable: true, get: function () { return component_renderer_1.useV1ComponentContent; } });
+Object.defineProperty(exports, "useV1ComponentContentOptional", { enumerable: true, get: function () { return component_renderer_1.useV1ComponentContentOptional; } });
+Object.defineProperty(exports, "renderComponentContent", { enumerable: true, get: function () { return component_renderer_1.renderComponentContent; } });
+Object.defineProperty(exports, "renderMessageContent", { enumerable: true, get: function () { return component_renderer_1.renderMessageContent; } });
+Object.defineProperty(exports, "renderMessageComponents", { enumerable: true, get: function () { return component_renderer_1.renderMessageComponents; } });
+Object.defineProperty(exports, "isComponentContent", { enumerable: true, get: function () { return component_renderer_1.isComponentContent; } });
 // =============================================================================
 // Utilities
 // =============================================================================
@@ -103,4 +124,17 @@ var tool_call_tracker_1 = require("./utils/tool-call-tracker");
 Object.defineProperty(exports, "ToolCallTracker", { enumerable: true, get: function () { return tool_call_tracker_1.ToolCallTracker; } });
 var stream_handler_1 = require("./utils/stream-handler");
 Object.defineProperty(exports, "handleEventStream", { enumerable: true, get: function () { return stream_handler_1.handleEventStream; } });
+// =============================================================================
+// Re-exports from Beta SDK (compatible with v1)
+// =============================================================================
+// Tool definition helper
+var registry_1 = require("../util/registry");
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return registry_1.defineTool; } });
+// Built-in context helpers
+var context_helpers_1 = require("../context-helpers");
+Object.defineProperty(exports, "currentPageContextHelper", { enumerable: true, get: function () { return context_helpers_1.currentPageContextHelper; } });
+Object.defineProperty(exports, "currentTimeContextHelper", { enumerable: true, get: function () { return context_helpers_1.currentTimeContextHelper; } });
+// MCP server types
+var mcp_server_info_1 = require("../model/mcp-server-info");
+Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return mcp_server_info_1.MCPTransport; } });
 //# sourceMappingURL=index.js.map

package/dist/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,mEAGuC;AAFrC,oHAAA,eAAe,OAAA;AAIjB,+EAM6C;AAL3C,gIAAA,qBAAqB,OAAA;AACrB,yHAAA,cAAc,OAAA;AACd,4HAAA,iBAAiB,OAAA;AACjB,8HAAA,mBAAmB,OAAA;AAIrB,4DAA4D;AAC5D,gFAA6E;AAApE,gIAAA,qBAAqB,OAAA;AAE9B,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,qDAAyE;AAAhE,0GAAA,UAAU,OAAA;AAEnB,uEAGuC;AAFrC,2HAAA,kBAAkB,OAAA;AAIpB,+EAG2C;AAFzC,kIAAA,qBAAqB,OAAA;AAIvB,mEAA+D;AAAtD,uHAAA,gBAAgB,OAAA;AAEzB,6EAAwE;AAA/D,gIAAA,oBAAoB,OAAA;AAE7B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AAEvB,mEAKqC;AAJnC,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,sHAAA,eAAe,OAAA;AACf,uHAAA,gBAAgB,OAAA;AAGlB,uDAI+B;AAH7B,kHAAA,iBAAiB,OAAA;AACjB,uHAAA,sBAAsB,OAAA;AAIxB,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AAExB,yDAA2D;AAAlD,mHAAA,iBAAiB,OAAA","sourcesContent":["/**\n * `@tambo-ai/react/v1` - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   useTamboV1SendMessage,\n * } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard]}\n *       tools={[searchTool]}\n *     >\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const [threadId, setThreadId] = useState<string>();\n *   const { messages, isStreaming } = useTamboV1(threadId);\n *   const sendMessage = useTamboV1SendMessage(threadId);\n *\n *   const handleSend = async (text: string) => {\n *     const result = await sendMessage.mutateAsync({\n *       message: { role: 'user', content: [{ type: 'text', text }] },\n *     });\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <div>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <MessageInput onSend={handleSend} />\n *     </div>\n *   );\n * }\n * ```\n *\n * ## Type Imports\n *\n * Types are imported directly from specific files:\n * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`\n * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`\n * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`\n *\n * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`\n * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`\n */\n\n// =============================================================================\n// Providers\n// =============================================================================\n\nexport {\n  TamboV1Provider,\n  type TamboV1ProviderProps,\n} from \"./providers/tambo-v1-provider\";\n\nexport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"./providers/tambo-v1-stream-context\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1, type UseTamboV1Return } from \"./hooks/use-tambo-v1\";\n\nexport {\n  useTamboV1Messages,\n  type UseTamboV1MessagesReturn,\n} from \"./hooks/use-tambo-v1-messages\";\n\nexport {\n  useTamboV1SendMessage,\n  type SendMessageOptions,\n} from \"./hooks/use-tambo-v1-send-message\";\n\nexport { useTamboV1Thread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboV1ThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\nexport { applyJsonPatch } from \"./utils/json-patch\";\n\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n\nexport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\n\nexport { handleEventStream } from \"./utils/stream-handler\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,mEAIuC;AAHrC,oHAAA,eAAe,OAAA;AACf,kHAAA,aAAa,OAAA;AAIf,+EAM6C;AAL3C,gIAAA,qBAAqB,OAAA;AACrB,yHAAA,cAAc,OAAA;AACd,4HAAA,iBAAiB,OAAA;AACjB,8HAAA,mBAAmB,OAAA;AAIrB,4DAA4D;AAC5D,gFAA6E;AAApE,gIAAA,qBAAqB,OAAA;AAE9B,0DAA0D;AAC1D,8FAGqD;AAFnD,6IAAA,2BAA2B,OAAA;AAC3B,wIAAA,sBAAsB,OAAA;AAGxB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,qDAAyE;AAAhE,0GAAA,UAAU,OAAA;AAEnB,+EAI2C;AAHzC,kIAAA,qBAAqB,OAAA;AAKvB,mEAA+D;AAAtD,uHAAA,gBAAgB,OAAA;AAEzB,6EAAwE;AAA/D,gIAAA,oBAAoB,OAAA;AAE7B,qFAG8C;AAF5C,wIAAA,wBAAwB,OAAA;AAI1B,sDAAsD;AACtD,4EAAoE;AAA3D,uHAAA,cAAc,OAAA;AAEvB,wDAAwD;AACxD,gFAAwE;AAA/D,2HAAA,gBAAgB,OAAA;AAEzB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,iEASoC;AARlC,2HAAA,qBAAqB,OAAA;AACrB,mIAAA,6BAA6B,OAAA;AAC7B,4HAAA,sBAAsB,OAAA;AACtB,0HAAA,oBAAoB,OAAA;AACpB,6HAAA,uBAAuB,OAAA;AACvB,wHAAA,kBAAkB,OAAA;AAKpB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AAEvB,mEAKqC;AAJnC,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,sHAAA,eAAe,OAAA;AACf,uHAAA,gBAAgB,OAAA;AAGlB,uDAI+B;AAH7B,kHAAA,iBAAiB,OAAA;AACjB,uHAAA,sBAAsB,OAAA;AAIxB,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AAExB,yDAA2D;AAAlD,mHAAA,iBAAiB,OAAA;AAE1B,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAEhF,yBAAyB;AACzB,6CAA8C;AAArC,sGAAA,UAAU,OAAA;AAEnB,2BAA2B;AAC3B,sDAG4B;AAF1B,2HAAA,wBAAwB,OAAA;AACxB,2HAAA,wBAAwB,OAAA;AAoB1B,mBAAmB;AACnB,4DAAwD;AAA/C,+GAAA,YAAY,OAAA","sourcesContent":["/**\n * `@tambo-ai/react/v1` - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   useTamboV1ThreadInput,\n * } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard]}\n *       tools={[searchTool]}\n *     >\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const [threadId, setThreadId] = useState<string>();\n *   const { messages, isStreaming } = useTamboV1(threadId);\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);\n *\n *   const handleSubmit = async (e: React.FormEvent) => {\n *     e.preventDefault();\n *     const result = await submit();\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <input value={value} onChange={(e) => setValue(e.target.value)} />\n *       <button disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n *\n * ## Type Imports\n *\n * Types are imported directly from specific files:\n * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`\n * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`\n * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`\n *\n * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`\n * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`\n */\n\n// =============================================================================\n// Providers\n// =============================================================================\n\nexport {\n  TamboV1Provider,\n  useContextKey,\n  type TamboV1ProviderProps,\n} from \"./providers/tambo-v1-provider\";\n\nexport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"./providers/tambo-v1-stream-context\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// Re-export context helpers from beta SDK (works with v1)\nexport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../providers/tambo-context-helpers-provider\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1, type UseTamboV1Return } from \"./hooks/use-tambo-v1\";\n\nexport {\n  useTamboV1ThreadInput,\n  type UseTamboV1ThreadInputReturn,\n  type SubmitOptions,\n} from \"./hooks/use-tambo-v1-thread-input\";\n\nexport { useTamboV1Thread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboV1ThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\nexport {\n  useTamboV1ComponentState,\n  type UseTamboV1ComponentStateReturn,\n} from \"./hooks/use-tambo-v1-component-state\";\n\n// Re-export client hook from beta SDK (works with v1)\nexport { useTamboClient } from \"../providers/tambo-client-provider\";\n\n// Re-export registry hook from beta SDK (works with v1)\nexport { useTamboRegistry } from \"../providers/tambo-registry-provider\";\n\n// =============================================================================\n// Component Rendering\n// =============================================================================\n\nexport {\n  useV1ComponentContent,\n  useV1ComponentContentOptional,\n  renderComponentContent,\n  renderMessageContent,\n  renderMessageComponents,\n  isComponentContent,\n  type V1ComponentContentContext,\n  type RenderComponentOptions,\n} from \"./utils/component-renderer\";\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\nexport { applyJsonPatch } from \"./utils/json-patch\";\n\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n\nexport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\n\nexport { handleEventStream } from \"./utils/stream-handler\";\n\n// =============================================================================\n// Re-exports from Beta SDK (compatible with v1)\n// =============================================================================\n\n// Tool definition helper\nexport { defineTool } from \"../util/registry\";\n\n// Built-in context helpers\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"../context-helpers\";\n\n// Context helper types\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"../context-helpers\";\n\n// Component and tool types\nexport type {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  ParameterSpec,\n  RegisteredComponent,\n  TamboTool,\n  ToolAnnotations,\n} from \"../model/component-metadata\";\n\n// MCP server types\nexport { MCPTransport } from \"../model/mcp-server-info\";\nexport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\n\n// Resource types\nexport type {\n  ListResourceItem,\n  ReadResourceResult,\n  ResourceSource,\n} from \"../model/resource-info\";\n"]}

package/dist/v1/providers/tambo-v1-provider.d.ts

@@ -4,6 +4,7 @@
  * Composes the necessary providers for the v1 SDK:
  * - TamboClientProvider: API client and authentication
  * - TamboRegistryProvider: Component and tool registration
+ * - TamboContextHelpersProvider: Context helper functions
  * - TamboV1StreamProvider: Streaming state management
  *
  * This provider should wrap your entire application or the portion
@@ -13,7 +14,14 @@ import React, { type PropsWithChildren } from "react";
 import { QueryClient } from "@tanstack/react-query";
 import { type TamboClientProviderProps } from "../../providers/tambo-client-provider";
 import { type TamboRegistryProviderProps } from "../../providers/tambo-registry-provider";
+import type { ContextHelpers } from "../../context-helpers";
 import type { McpServerInfo } from "../../model/mcp-server-info";
+import type { ListResourceItem, ResourceSource } from "../../model/resource-info";
+/**
+ * Hook to access the contextKey from TamboV1Provider.
+ * @returns The contextKey if provided, undefined otherwise
+ */
+export declare function useContextKey(): string | undefined;
 /**
  * Props for TamboV1Provider
  */
@@ -38,6 +46,35 @@ export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "ap
      * If not provided, an error will be thrown for unknown tools.
      */
     onCallUnregisteredTool?: TamboRegistryProviderProps["onCallUnregisteredTool"];
+    /**
+     * Static resources to register with the registry.
+     * These will be available for the AI to access.
+     */
+    resources?: ListResourceItem[];
+    /**
+     * Dynamic resource search function.
+     * Must be paired with getResource.
+     * Called when searching for resources dynamically.
+     */
+    listResources?: ResourceSource["listResources"];
+    /**
+     * Dynamic resource fetch function.
+     * Must be paired with listResources.
+     * Called when fetching a specific resource by URI.
+     */
+    getResource?: ResourceSource["getResource"];
+    /**
+     * Configuration for context helpers.
+     * A dictionary of functions that provide additional context to the AI.
+     * Each key becomes the context name, and the function returns the value.
+     */
+    contextHelpers?: ContextHelpers;
+    /**
+     * Optional context key for thread scoping/isolation.
+     * Threads created with the same contextKey are grouped together.
+     * Useful for multi-tenant applications or separating conversation contexts.
+     */
+    contextKey?: string;
     /**
      * Optional custom QueryClient instance.
      * If not provided, a default client will be created.
@@ -67,6 +104,11 @@ export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "ap
  * @param props.tools - Tools to register for client-side execution
  * @param props.mcpServers - MCP servers to register for additional tools/resources
  * @param props.onCallUnregisteredTool - Callback for handling unknown tool calls
+ * @param props.resources - Static resources to register with the AI
+ * @param props.listResources - Dynamic resource search function (must be paired with getResource)
+ * @param props.getResource - Dynamic resource fetch function (must be paired with listResources)
+ * @param props.contextHelpers - Configuration for context helper functions
+ * @param props.contextKey - Optional context key for thread scoping/isolation
  * @param props.queryClient - Optional custom React Query client
  * @param props.children - Child components
  * @returns Provider component tree
@@ -87,5 +129,5 @@ export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "ap
  * }
  * ```
  */
-export declare function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, queryClient, children, }: PropsWithChildren<TamboV1ProviderProps>): React.JSX.Element;
+export declare function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, contextKey, queryClient, children, }: PropsWithChildren<TamboV1ProviderProps>): React.JSX.Element;
 //# sourceMappingURL=tambo-v1-provider.d.ts.map

package/dist/v1/providers/tambo-v1-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAY,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,wBAAwB,EACxB,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CACpD;IACC;;;OAGG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAE5C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;IAExC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,0BAA0B,CAAC,wBAAwB,CAAC,CAAC;IAE9E;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBAoCzC"}
+{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAGZ,KAAK,iBAAiB,EAEvB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACf,MAAM,2BAA2B,CAAC;AAQnC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,wBAAwB,EACxB,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CACpD;IACC;;;OAGG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAE5C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;IAExC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,0BAA0B,CAAC,wBAAwB,CAAC,CAAC;IAE9E;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAE5C;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBA2CzC"}