@tambo-ai/react 0.70.0 → 0.71.0

package/dist/v1/providers/tambo-v1-stream-context.js

@@ -0,0 +1,230 @@
+"use strict";
+"use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TamboV1StreamProvider = TamboV1StreamProvider;
+exports.useStreamState = useStreamState;
+exports.useStreamDispatch = useStreamDispatch;
+exports.useThreadManagement = useThreadManagement;
+/**
+ * Stream Context Provider for v1 API
+ *
+ * Manages streaming state using React Context and useReducer.
+ * Provides state and dispatch to child components via separate contexts
+ * following the split-context pattern for optimal re-render performance.
+ */
+// React is used implicitly for JSX transformation (jsx: "react" in tsconfig)
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const react_1 = __importStar(require("react"));
+const event_accumulator_1 = require("../utils/event-accumulator");
+/**
+ * Context for accessing stream state (read-only).
+ * Separated from dispatch context to prevent unnecessary re-renders.
+ */
+const StreamStateContext = (0, react_1.createContext)(null);
+/**
+ * Context for dispatching events to the stream reducer.
+ * Separated from state context to prevent unnecessary re-renders.
+ */
+const StreamDispatchContext = (0, react_1.createContext)(null);
+/**
+ * Context for thread management functions.
+ * Separated from state to prevent unnecessary re-renders.
+ */
+const ThreadManagementContext = (0, react_1.createContext)(null);
+/**
+ * Creates initial stream state from props.
+ * @param props - Provider props
+ * @returns Initial stream state
+ */
+function createInitialState(props) {
+    const { initialThread, threadId } = props;
+    // Initialize with empty threadMap
+    const threadMap = {};
+    // If threadId is provided, initialize that thread
+    if (threadId) {
+        // Create initial thread state (immutably)
+        const baseState = (0, event_accumulator_1.createInitialThreadState)(threadId);
+        // If initial thread data provided, merge it immutably
+        const threadState = initialThread
+            ? {
+                ...baseState,
+                thread: {
+                    ...baseState.thread,
+                    ...initialThread,
+                    id: threadId, // Always use the provided threadId
+                },
+            }
+            : baseState;
+        threadMap[threadId] = threadState;
+    }
+    return {
+        threadMap,
+        currentThreadId: threadId ?? null,
+    };
+}
+/**
+ * Provider component for stream state management.
+ *
+ * Uses useReducer with streamReducer to accumulate AG-UI events into
+ * thread state. Provides state, dispatch, and thread management via separate contexts.
+ * @returns JSX element wrapping children with stream contexts
+ * @example
+ * ```tsx
+ * <TamboV1StreamProvider threadId="thread_123">
+ *   <ChatInterface />
+ * </TamboV1StreamProvider>
+ * ```
+ */
+function TamboV1StreamProvider(props) {
+    const { children } = props;
+    const initialState = (0, react_1.useMemo)(() => createInitialState(props), 
+    // Only recompute if threadId changes
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [props.threadId]);
+    const [state, dispatch] = (0, react_1.useReducer)(event_accumulator_1.streamReducer, initialState);
+    // Thread management functions
+    const initThread = (0, react_1.useCallback)((threadId, initialThread) => {
+        dispatch({ type: "INIT_THREAD", threadId, initialThread });
+    }, []);
+    const switchThread = (0, react_1.useCallback)((threadId) => {
+        dispatch({ type: "SET_CURRENT_THREAD", threadId });
+    }, []);
+    const startNewThread = (0, react_1.useCallback)(() => {
+        const tempId = `temp_${crypto.randomUUID()}`;
+        // Use atomic START_NEW_THREAD action to prevent race conditions
+        // when multiple calls happen concurrently (e.g., double-click)
+        dispatch({ type: "START_NEW_THREAD", threadId: tempId });
+        return tempId;
+    }, []);
+    const threadManagement = (0, react_1.useMemo)(() => ({
+        initThread,
+        switchThread,
+        startNewThread,
+    }), [initThread, switchThread, startNewThread]);
+    return (react_1.default.createElement(StreamStateContext.Provider, { value: state },
+        react_1.default.createElement(StreamDispatchContext.Provider, { value: dispatch },
+            react_1.default.createElement(ThreadManagementContext.Provider, { value: threadManagement }, children))));
+}
+/**
+ * Hook to access stream state.
+ *
+ * Must be used within TamboV1StreamProvider.
+ * @returns Current stream state
+ * @throws {Error} if used outside TamboV1StreamProvider
+ * @example
+ * ```tsx
+ * function ChatMessages() {
+ *   const { thread, streaming } = useStreamState();
+ *
+ *   return (
+ *     <div>
+ *       {thread.messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {streaming.status === 'streaming' && <LoadingIndicator />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useStreamState() {
+    const context = (0, react_1.useContext)(StreamStateContext);
+    if (!context) {
+        throw new Error("useStreamState must be used within TamboV1StreamProvider");
+    }
+    return context;
+}
+/**
+ * Hook to access stream dispatch function.
+ *
+ * Must be used within TamboV1StreamProvider.
+ * @returns Dispatch function for sending events to reducer
+ * @throws {Error} if used outside TamboV1StreamProvider
+ * @example
+ * ```tsx
+ * function StreamHandler() {
+ *   const dispatch = useStreamDispatch();
+ *
+ *   useEffect(() => {
+ *     async function handleStream() {
+ *       for await (const event of streamEvents) {
+ *         dispatch({ type: 'EVENT', event });
+ *       }
+ *     }
+ *     handleStream();
+ *   }, [dispatch]);
+ *
+ *   return null;
+ * }
+ * ```
+ */
+function useStreamDispatch() {
+    const context = (0, react_1.useContext)(StreamDispatchContext);
+    if (!context) {
+        throw new Error("useStreamDispatch must be used within TamboV1StreamProvider");
+    }
+    return context;
+}
+/**
+ * Hook to access thread management functions.
+ *
+ * Must be used within TamboV1StreamProvider.
+ * @returns Thread management functions
+ * @throws {Error} if used outside TamboV1StreamProvider
+ * @example
+ * ```tsx
+ * function ThreadSwitcher() {
+ *   const { switchThread, startNewThread } = useThreadManagement();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => switchThread('thread_123')}>
+ *         Load Thread
+ *       </button>
+ *       <button onClick={startNewThread}>
+ *         New Chat
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useThreadManagement() {
+    const context = (0, react_1.useContext)(ThreadManagementContext);
+    if (!context) {
+        throw new Error("useThreadManagement must be used within TamboV1StreamProvider");
+    }
+    return context;
+}
+//# sourceMappingURL=tambo-v1-stream-context.js.map

package/dist/v1/providers/tambo-v1-stream-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-stream-context.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-stream-context.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * Stream Context Provider for v1 API\n *\n * Manages streaming state using React Context and useReducer.\n * Provides state and dispatch to child components via separate contexts\n * following the split-context pattern for optimal re-render performance.\n */\n\n// React is used implicitly for JSX transformation (jsx: \"react\" in tsconfig)\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport React, {\n  createContext,\n  useReducer,\n  useContext,\n  useMemo,\n  useCallback,\n  type ReactNode,\n  type Dispatch,\n} from \"react\";\nimport {\n  streamReducer,\n  createInitialThreadState,\n  type StreamState,\n  type StreamAction,\n} from \"../utils/event-accumulator\";\nimport type { TamboV1Thread } from \"../types/thread\";\n\n/**\n * Thread management functions exposed by the stream context.\n */\nexport interface ThreadManagement {\n  /**\n   * Initialize a new thread in the stream context.\n   * Use this before sending messages to a new thread.\n   * @param threadId - The thread ID to initialize\n   * @param initialThread - Optional initial thread data\n   */\n  initThread: (\n    threadId: string,\n    initialThread?: Partial<TamboV1Thread>,\n  ) => void;\n\n  /**\n   * Switch the current active thread.\n   * Does not fetch thread data - use useTamboV1Thread for that.\n   * @param threadId - The thread ID to switch to, or null to clear\n   */\n  switchThread: (threadId: string | null) => void;\n\n  /**\n   * Start a new thread (generates a temporary ID).\n   * The actual thread ID will be assigned when the first message is sent.\n   * @returns The temporary thread ID\n   */\n  startNewThread: () => string;\n}\n\n/**\n * Context for accessing stream state (read-only).\n * Separated from dispatch context to prevent unnecessary re-renders.\n */\nconst StreamStateContext = createContext<StreamState | null>(null);\n\n/**\n * Context for dispatching events to the stream reducer.\n * Separated from state context to prevent unnecessary re-renders.\n */\nconst StreamDispatchContext = createContext<Dispatch<StreamAction> | null>(\n  null,\n);\n\n/**\n * Context for thread management functions.\n * Separated from state to prevent unnecessary re-renders.\n */\nconst ThreadManagementContext = createContext<ThreadManagement | null>(null);\n\n/**\n * Props for TamboV1StreamProvider\n */\nexport interface TamboV1StreamProviderProps {\n  children: ReactNode;\n\n  /**\n   * Initial thread state (optional).\n   * If not provided, an empty thread will be created.\n   */\n  initialThread?: Partial<TamboV1Thread>;\n\n  /**\n   * Thread ID for the stream context.\n   * Used to initialize the thread if initialThread is not provided.\n   */\n  threadId?: string;\n}\n\n/**\n * Creates initial stream state from props.\n * @param props - Provider props\n * @returns Initial stream state\n */\nfunction createInitialState(props: TamboV1StreamProviderProps): StreamState {\n  const { initialThread, threadId } = props;\n\n  // Initialize with empty threadMap\n  const threadMap: Record<\n    string,\n    ReturnType<typeof createInitialThreadState>\n  > = {};\n\n  // If threadId is provided, initialize that thread\n  if (threadId) {\n    // Create initial thread state (immutably)\n    const baseState = createInitialThreadState(threadId);\n\n    // If initial thread data provided, merge it immutably\n    const threadState = initialThread\n      ? {\n          ...baseState,\n          thread: {\n            ...baseState.thread,\n            ...initialThread,\n            id: threadId, // Always use the provided threadId\n          },\n        }\n      : baseState;\n\n    threadMap[threadId] = threadState;\n  }\n\n  return {\n    threadMap,\n    currentThreadId: threadId ?? null,\n  };\n}\n\n/**\n * Provider component for stream state management.\n *\n * Uses useReducer with streamReducer to accumulate AG-UI events into\n * thread state. Provides state, dispatch, and thread management via separate contexts.\n * @returns JSX element wrapping children with stream contexts\n * @example\n * ```tsx\n * <TamboV1StreamProvider threadId=\"thread_123\">\n *   <ChatInterface />\n * </TamboV1StreamProvider>\n * ```\n */\nexport function TamboV1StreamProvider(props: TamboV1StreamProviderProps) {\n  const { children } = props;\n\n  const initialState = useMemo(\n    () => createInitialState(props),\n    // Only recompute if threadId changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [props.threadId],\n  );\n\n  const [state, dispatch] = useReducer(streamReducer, initialState);\n\n  // Thread management functions\n  const initThread = useCallback(\n    (threadId: string, initialThread?: Partial<TamboV1Thread>) => {\n      dispatch({ type: \"INIT_THREAD\", threadId, initialThread });\n    },\n    [],\n  );\n\n  const switchThread = useCallback((threadId: string | null) => {\n    dispatch({ type: \"SET_CURRENT_THREAD\", threadId });\n  }, []);\n\n  const startNewThread = useCallback(() => {\n    const tempId = `temp_${crypto.randomUUID()}`;\n    // Use atomic START_NEW_THREAD action to prevent race conditions\n    // when multiple calls happen concurrently (e.g., double-click)\n    dispatch({ type: \"START_NEW_THREAD\", threadId: tempId });\n    return tempId;\n  }, []);\n\n  const threadManagement = useMemo<ThreadManagement>(\n    () => ({\n      initThread,\n      switchThread,\n      startNewThread,\n    }),\n    [initThread, switchThread, startNewThread],\n  );\n\n  return (\n    <StreamStateContext.Provider value={state}>\n      <StreamDispatchContext.Provider value={dispatch}>\n        <ThreadManagementContext.Provider value={threadManagement}>\n          {children}\n        </ThreadManagementContext.Provider>\n      </StreamDispatchContext.Provider>\n    </StreamStateContext.Provider>\n  );\n}\n\n/**\n * Hook to access stream state.\n *\n * Must be used within TamboV1StreamProvider.\n * @returns Current stream state\n * @throws {Error} if used outside TamboV1StreamProvider\n * @example\n * ```tsx\n * function ChatMessages() {\n *   const { thread, streaming } = useStreamState();\n *\n *   return (\n *     <div>\n *       {thread.messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {streaming.status === 'streaming' && <LoadingIndicator />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useStreamState(): StreamState {\n  const context = useContext(StreamStateContext);\n\n  if (!context) {\n    throw new Error(\"useStreamState must be used within TamboV1StreamProvider\");\n  }\n\n  return context;\n}\n\n/**\n * Hook to access stream dispatch function.\n *\n * Must be used within TamboV1StreamProvider.\n * @returns Dispatch function for sending events to reducer\n * @throws {Error} if used outside TamboV1StreamProvider\n * @example\n * ```tsx\n * function StreamHandler() {\n *   const dispatch = useStreamDispatch();\n *\n *   useEffect(() => {\n *     async function handleStream() {\n *       for await (const event of streamEvents) {\n *         dispatch({ type: 'EVENT', event });\n *       }\n *     }\n *     handleStream();\n *   }, [dispatch]);\n *\n *   return null;\n * }\n * ```\n */\nexport function useStreamDispatch(): Dispatch<StreamAction> {\n  const context = useContext(StreamDispatchContext);\n\n  if (!context) {\n    throw new Error(\n      \"useStreamDispatch must be used within TamboV1StreamProvider\",\n    );\n  }\n\n  return context;\n}\n\n/**\n * Hook to access thread management functions.\n *\n * Must be used within TamboV1StreamProvider.\n * @returns Thread management functions\n * @throws {Error} if used outside TamboV1StreamProvider\n * @example\n * ```tsx\n * function ThreadSwitcher() {\n *   const { switchThread, startNewThread } = useThreadManagement();\n *\n *   return (\n *     <div>\n *       <button onClick={() => switchThread('thread_123')}>\n *         Load Thread\n *       </button>\n *       <button onClick={startNewThread}>\n *         New Chat\n *       </button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useThreadManagement(): ThreadManagement {\n  const context = useContext(ThreadManagementContext);\n\n  if (!context) {\n    throw new Error(\n      \"useThreadManagement must be used within TamboV1StreamProvider\",\n    );\n  }\n\n  return context;\n}\n"]}

package/dist/v1/providers/tambo-v1-stream-context.test.d.ts

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

package/dist/v1/providers/tambo-v1-stream-context.test.d.ts.map

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

package/dist/v1/providers/tambo-v1-stream-context.test.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@ag-ui/core");
+const react_1 = require("@testing-library/react");
+const react_2 = __importDefault(require("react"));
+const tambo_v1_stream_context_1 = require("./tambo-v1-stream-context");
+describe("TamboV1StreamProvider", () => {
+    describe("useStreamState", () => {
+        it("throws when used outside provider", () => {
+            // Suppress console.error for expected error
+            const consoleSpy = jest
+                .spyOn(console, "error")
+                .mockImplementation(() => { });
+            expect(() => {
+                (0, react_1.renderHook)(() => (0, tambo_v1_stream_context_1.useStreamState)());
+            }).toThrow("useStreamState must be used within TamboV1StreamProvider");
+            consoleSpy.mockRestore();
+        });
+        it("returns initial state with empty threadMap when no threadId", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, null, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_v1_stream_context_1.useStreamState)(), { wrapper });
+            expect(result.current.threadMap).toEqual({});
+            expect(result.current.currentThreadId).toBeNull();
+        });
+        it("initializes thread when threadId is provided", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, { threadId: "thread_123" }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_v1_stream_context_1.useStreamState)(), { wrapper });
+            expect(result.current.currentThreadId).toBe("thread_123");
+            expect(result.current.threadMap.thread_123).toBeDefined();
+            expect(result.current.threadMap.thread_123.thread.id).toBe("thread_123");
+            expect(result.current.threadMap.thread_123.thread.status).toBe("idle");
+            expect(result.current.threadMap.thread_123.thread.messages).toEqual([]);
+        });
+        it("merges initialThread with default state", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, { threadId: "thread_123", initialThread: {
+                    title: "Test Thread",
+                    metadata: { key: "value" },
+                } }, children));
+            const { result } = (0, react_1.renderHook)(() => (0, tambo_v1_stream_context_1.useStreamState)(), { wrapper });
+            expect(result.current.threadMap.thread_123.thread.title).toBe("Test Thread");
+            expect(result.current.threadMap.thread_123.thread.metadata).toEqual({
+                key: "value",
+            });
+            // Default values should still be set
+            expect(result.current.threadMap.thread_123.thread.status).toBe("idle");
+        });
+    });
+    describe("useStreamDispatch", () => {
+        it("throws when used outside provider", () => {
+            const consoleSpy = jest
+                .spyOn(console, "error")
+                .mockImplementation(() => { });
+            expect(() => {
+                (0, react_1.renderHook)(() => (0, tambo_v1_stream_context_1.useStreamDispatch)());
+            }).toThrow("useStreamDispatch must be used within TamboV1StreamProvider");
+            consoleSpy.mockRestore();
+        });
+        it("dispatches events to update state", () => {
+            const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, { threadId: "thread_123" }, children));
+            const { result } = (0, react_1.renderHook)(() => ({
+                state: (0, tambo_v1_stream_context_1.useStreamState)(),
+                dispatch: (0, tambo_v1_stream_context_1.useStreamDispatch)(),
+            }), { wrapper });
+            const runStartedEvent = {
+                type: core_1.EventType.RUN_STARTED,
+                runId: "run_1",
+                threadId: "thread_123",
+            };
+            (0, react_1.act)(() => {
+                result.current.dispatch({
+                    type: "EVENT",
+                    event: runStartedEvent,
+                    threadId: "thread_123",
+                });
+            });
+            expect(result.current.state.threadMap.thread_123.thread.status).toBe("streaming");
+            expect(result.current.state.threadMap.thread_123.streaming.status).toBe("streaming");
+            expect(result.current.state.threadMap.thread_123.streaming.runId).toBe("run_1");
+        });
+    });
+});
+//# sourceMappingURL=tambo-v1-stream-context.test.js.map

package/dist/v1/providers/tambo-v1-stream-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-stream-context.test.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-stream-context.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { EventType, type RunStartedEvent } from \"@ag-ui/core\";\nimport { renderHook, act } from \"@testing-library/react\";\nimport React from \"react\";\nimport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n} from \"./tambo-v1-stream-context\";\n\ndescribe(\"TamboV1StreamProvider\", () => {\n  describe(\"useStreamState\", () => {\n    it(\"throws when used outside provider\", () => {\n      // Suppress console.error for expected error\n      const consoleSpy = jest\n        .spyOn(console, \"error\")\n        .mockImplementation(() => {});\n\n      expect(() => {\n        renderHook(() => useStreamState());\n      }).toThrow(\"useStreamState must be used within TamboV1StreamProvider\");\n\n      consoleSpy.mockRestore();\n    });\n\n    it(\"returns initial state with empty threadMap when no threadId\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StreamProvider>{children}</TamboV1StreamProvider>\n      );\n\n      const { result } = renderHook(() => useStreamState(), { wrapper });\n\n      expect(result.current.threadMap).toEqual({});\n      expect(result.current.currentThreadId).toBeNull();\n    });\n\n    it(\"initializes thread when threadId is provided\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StreamProvider threadId=\"thread_123\">\n          {children}\n        </TamboV1StreamProvider>\n      );\n\n      const { result } = renderHook(() => useStreamState(), { wrapper });\n\n      expect(result.current.currentThreadId).toBe(\"thread_123\");\n      expect(result.current.threadMap.thread_123).toBeDefined();\n      expect(result.current.threadMap.thread_123.thread.id).toBe(\"thread_123\");\n      expect(result.current.threadMap.thread_123.thread.status).toBe(\"idle\");\n      expect(result.current.threadMap.thread_123.thread.messages).toEqual([]);\n    });\n\n    it(\"merges initialThread with default state\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StreamProvider\n          threadId=\"thread_123\"\n          initialThread={{\n            title: \"Test Thread\",\n            metadata: { key: \"value\" },\n          }}\n        >\n          {children}\n        </TamboV1StreamProvider>\n      );\n\n      const { result } = renderHook(() => useStreamState(), { wrapper });\n\n      expect(result.current.threadMap.thread_123.thread.title).toBe(\n        \"Test Thread\",\n      );\n      expect(result.current.threadMap.thread_123.thread.metadata).toEqual({\n        key: \"value\",\n      });\n      // Default values should still be set\n      expect(result.current.threadMap.thread_123.thread.status).toBe(\"idle\");\n    });\n  });\n\n  describe(\"useStreamDispatch\", () => {\n    it(\"throws when used outside provider\", () => {\n      const consoleSpy = jest\n        .spyOn(console, \"error\")\n        .mockImplementation(() => {});\n\n      expect(() => {\n        renderHook(() => useStreamDispatch());\n      }).toThrow(\"useStreamDispatch must be used within TamboV1StreamProvider\");\n\n      consoleSpy.mockRestore();\n    });\n\n    it(\"dispatches events to update state\", () => {\n      const wrapper = ({ children }: { children: React.ReactNode }) => (\n        <TamboV1StreamProvider threadId=\"thread_123\">\n          {children}\n        </TamboV1StreamProvider>\n      );\n\n      const { result } = renderHook(\n        () => ({\n          state: useStreamState(),\n          dispatch: useStreamDispatch(),\n        }),\n        { wrapper },\n      );\n\n      const runStartedEvent: RunStartedEvent = {\n        type: EventType.RUN_STARTED,\n        runId: \"run_1\",\n        threadId: \"thread_123\",\n      };\n\n      act(() => {\n        result.current.dispatch({\n          type: \"EVENT\",\n          event: runStartedEvent,\n          threadId: \"thread_123\",\n        });\n      });\n\n      expect(result.current.state.threadMap.thread_123.thread.status).toBe(\n        \"streaming\",\n      );\n      expect(result.current.state.threadMap.thread_123.streaming.status).toBe(\n        \"streaming\",\n      );\n      expect(result.current.state.threadMap.thread_123.streaming.runId).toBe(\n        \"run_1\",\n      );\n    });\n  });\n});\n"]}

package/dist/v1/types/component.d.ts

@@ -3,8 +3,11 @@
  *
  * Defines how React components are registered and made available to the AI.
  *
- * TODO: Once @tambo-ai/typescript-sdk/v1 is released, import AvailableComponent
- * from the SDK package.
+ * Note: AvailableComponent is defined locally to match RunCreateParams.AvailableComponent
+ * from the SDK. The SDK exports two different AvailableComponent types:
+ * - `shared.AvailableComponent` has `props` and `contextTools` fields
+ * - `RunCreateParams.AvailableComponent` has `propsSchema` and `stateSchema` fields
+ * We need the latter for v1 API calls, so we define it locally to avoid confusion.
  */
 import type { ComponentType } from "react";
 /**

package/dist/v1/types/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/v1/types/component.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,oCAAoC;IACpC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAE9B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEhE,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IAEpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/v1/types/component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,oCAAoC;IACpC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAE9B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEhE,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IAEpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/v1/types/component.js

@@ -4,8 +4,11 @@
  *
  * Defines how React components are registered and made available to the AI.
  *
- * TODO: Once @tambo-ai/typescript-sdk/v1 is released, import AvailableComponent
- * from the SDK package.
+ * Note: AvailableComponent is defined locally to match RunCreateParams.AvailableComponent
+ * from the SDK. The SDK exports two different AvailableComponent types:
+ * - `shared.AvailableComponent` has `props` and `contextTools` fields
+ * - `RunCreateParams.AvailableComponent` has `propsSchema` and `stateSchema` fields
+ * We need the latter for v1 API calls, so we define it locally to avoid confusion.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=component.js.map

package/dist/v1/types/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/v1/types/component.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG","sourcesContent":["/**\n * Component Types for v1 API\n *\n * Defines how React components are registered and made available to the AI.\n *\n * TODO: Once @tambo-ai/typescript-sdk/v1 is released, import AvailableComponent\n * from the SDK package.\n */\n\nimport type { ComponentType } from \"react\";\n\n/**\n * Component registration metadata for the AI\n * This is what gets sent to the API in the `available_components` field\n */\nexport interface AvailableComponent {\n  /** Component name (must be unique) */\n  name: string;\n\n  /** Human-readable description for the AI */\n  description: string;\n\n  /** JSON Schema describing component props */\n  propsSchema: Record<string, unknown>;\n\n  /** JSON Schema describing component state (optional) */\n  stateSchema?: Record<string, unknown>;\n}\n\n/**\n * Component registration for React SDK\n * Extends AvailableComponent with the actual React component\n */\nexport interface TamboV1Component extends AvailableComponent {\n  /** The React component to render */\n  component: ComponentType<any>;\n\n  /** Initial state factory (optional) */\n  initialState?: () => Record<string, unknown>;\n}\n\n/**\n * Props passed to components when rendered\n */\nexport interface TamboComponentProps<\n  TProps extends Record<string, unknown> = Record<string, unknown>,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** Component props from AI */\n  props: TProps;\n\n  /** Component state (can be updated by AI or client) */\n  state?: TState;\n\n  /** Unique component instance ID */\n  componentId: string;\n\n  /** Whether this component is currently streaming */\n  isStreaming?: boolean;\n}\n"]}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/v1/types/component.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * Component Types for v1 API\n *\n * Defines how React components are registered and made available to the AI.\n *\n * Note: AvailableComponent is defined locally to match RunCreateParams.AvailableComponent\n * from the SDK. The SDK exports two different AvailableComponent types:\n * - `shared.AvailableComponent` has `props` and `contextTools` fields\n * - `RunCreateParams.AvailableComponent` has `propsSchema` and `stateSchema` fields\n * We need the latter for v1 API calls, so we define it locally to avoid confusion.\n */\n\nimport type { ComponentType } from \"react\";\n\n/**\n * Component registration metadata for the AI\n * This is what gets sent to the API in the `available_components` field\n */\nexport interface AvailableComponent {\n  /** Component name (must be unique) */\n  name: string;\n\n  /** Human-readable description for the AI */\n  description: string;\n\n  /** JSON Schema describing component props */\n  propsSchema: Record<string, unknown>;\n\n  /** JSON Schema describing component state (optional) */\n  stateSchema?: Record<string, unknown>;\n}\n\n/**\n * Component registration for React SDK\n * Extends AvailableComponent with the actual React component\n */\nexport interface TamboV1Component extends AvailableComponent {\n  /** The React component to render */\n  component: ComponentType<any>;\n\n  /** Initial state factory (optional) */\n  initialState?: () => Record<string, unknown>;\n}\n\n/**\n * Props passed to components when rendered\n */\nexport interface TamboComponentProps<\n  TProps extends Record<string, unknown> = Record<string, unknown>,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** Component props from AI */\n  props: TProps;\n\n  /** Component state (can be updated by AI or client) */\n  state?: TState;\n\n  /** Unique component instance ID */\n  componentId: string;\n\n  /** Whether this component is currently streaming */\n  isStreaming?: boolean;\n}\n"]}

package/dist/v1/types/event.d.ts

@@ -2,9 +2,10 @@
  * Tambo-specific Custom Event Types for v1 Streaming API
  *
  * Defines custom events specific to Tambo functionality.
- * For standard AG-UI events, import directly from @ag-ui/core.
+ * For standard AG-UI events, import directly from `@ag-ui/core`.
  */
 import type { CustomEvent } from "@ag-ui/core";
+import type { Operation } from "fast-json-patch";
 type TamboCustomEventEnvelope<TName extends string, TValue> = Omit<CustomEvent, "name" | "value"> & {
     name: TName;
     value: TValue;
@@ -23,7 +24,7 @@ export type ComponentStartEvent = TamboCustomEventEnvelope<"tambo.component.star
  */
 export type ComponentPropsDeltaEvent = TamboCustomEventEnvelope<"tambo.component.props_delta", {
     componentId: string;
-    operations: JsonPatchOperation[];
+    operations: Operation[];
 }>;
 /**
  * Component state delta event (custom: tambo.component.state_delta)
@@ -31,7 +32,7 @@ export type ComponentPropsDeltaEvent = TamboCustomEventEnvelope<"tambo.component
  */
 export type ComponentStateDeltaEvent = TamboCustomEventEnvelope<"tambo.component.state_delta", {
     componentId: string;
-    operations: JsonPatchOperation[];
+    operations: Operation[];
 }>;
 /**
  * Component end event (custom: tambo.component.end)
@@ -46,18 +47,26 @@ export type ComponentEndEvent = TamboCustomEventEnvelope<"tambo.component.end",
 export type RunAwaitingInputEvent = TamboCustomEventEnvelope<"tambo.run.awaiting_input", {
     pendingToolCallIds: string[];
 }>;
-/**
- * JSON Patch operation (RFC 6902)
- */
-export interface JsonPatchOperation {
-    op: "add" | "remove" | "replace" | "move" | "copy" | "test";
-    path: string;
-    value?: unknown;
-    from?: string;
-}
 /**
  * Union type of Tambo-specific custom events
  */
 export type TamboCustomEvent = ComponentStartEvent | ComponentPropsDeltaEvent | ComponentStateDeltaEvent | ComponentEndEvent | RunAwaitingInputEvent;
+/**
+ * Type guard to check if an event is a Tambo custom event.
+ * Validates that the event has a name matching known Tambo custom event types.
+ * @param event - Event object to check
+ * @param event.name - Event name to match against known Tambo event types
+ * @returns True if event is a TamboCustomEvent
+ */
+export declare function isTamboCustomEvent(event: {
+    name?: string;
+}): event is TamboCustomEvent;
+/**
+ * Casts a CustomEvent to the specific TamboCustomEvent type based on its name.
+ * Uses exhaustive type checking to ensure all event types are handled.
+ * @param event - The CustomEvent to cast
+ * @returns The properly typed TamboCustomEvent, or undefined if not a known Tambo event
+ */
+export declare function asTamboCustomEvent(event: CustomEvent): TamboCustomEvent | undefined;
 export {};
 //# sourceMappingURL=event.d.ts.map

package/dist/v1/types/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/v1/types/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,wBAAwB,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,IAAI,IAAI,CAChE,WAAW,EACX,MAAM,GAAG,OAAO,CACjB,GAAG;IACF,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,CACxD,uBAAuB,EACvB;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,CAC7D,6BAA6B,EAC7B;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,CAC7D,6BAA6B,EAC7B;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CACtD,qBAAqB,EACrB;IACE,WAAW,EAAE,MAAM,CAAC;CACrB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAC1D,0BAA0B,EAC1B;IACE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,iBAAiB,GACjB,qBAAqB,CAAC"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/v1/types/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,KAAK,wBAAwB,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,IAAI,IAAI,CAChE,WAAW,EACX,MAAM,GAAG,OAAO,CACjB,GAAG;IACF,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,CACxD,uBAAuB,EACvB;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,CAC7D,6BAA6B,EAC7B;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,CAC7D,6BAA6B,EAC7B;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CACtD,qBAAqB,EACrB;IACE,WAAW,EAAE,MAAM,CAAC;CACrB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAC1D,0BAA0B,EAC1B;IACE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,iBAAiB,GACjB,qBAAqB,CAAC;AAa1B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,KAAK,IAAI,gBAAgB,CAK5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,GACjB,gBAAgB,GAAG,SAAS,CAe9B"}

package/dist/v1/types/event.js

@@ -3,7 +3,52 @@
  * Tambo-specific Custom Event Types for v1 Streaming API
  *
  * Defines custom events specific to Tambo functionality.
- * For standard AG-UI events, import directly from @ag-ui/core.
+ * For standard AG-UI events, import directly from `@ag-ui/core`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTamboCustomEvent = isTamboCustomEvent;
+exports.asTamboCustomEvent = asTamboCustomEvent;
+/**
+ * Known Tambo custom event names for type narrowing
+ */
+const TAMBO_CUSTOM_EVENT_NAMES = [
+    "tambo.component.start",
+    "tambo.component.props_delta",
+    "tambo.component.state_delta",
+    "tambo.component.end",
+    "tambo.run.awaiting_input",
+];
+/**
+ * Type guard to check if an event is a Tambo custom event.
+ * Validates that the event has a name matching known Tambo custom event types.
+ * @param event - Event object to check
+ * @param event.name - Event name to match against known Tambo event types
+ * @returns True if event is a TamboCustomEvent
+ */
+function isTamboCustomEvent(event) {
+    return (typeof event.name === "string" &&
+        TAMBO_CUSTOM_EVENT_NAMES.includes(event.name));
+}
+/**
+ * Casts a CustomEvent to the specific TamboCustomEvent type based on its name.
+ * Uses exhaustive type checking to ensure all event types are handled.
+ * @param event - The CustomEvent to cast
+ * @returns The properly typed TamboCustomEvent, or undefined if not a known Tambo event
+ */
+function asTamboCustomEvent(event) {
+    switch (event.name) {
+        case "tambo.component.start":
+            return event;
+        case "tambo.component.props_delta":
+            return event;
+        case "tambo.component.state_delta":
+            return event;
+        case "tambo.component.end":
+            return event;
+        case "tambo.run.awaiting_input":
+            return event;
+        default:
+            return undefined;
+    }
+}
 //# sourceMappingURL=event.js.map

package/dist/v1/types/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/v1/types/event.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","sourcesContent":["/**\n * Tambo-specific Custom Event Types for v1 Streaming API\n *\n * Defines custom events specific to Tambo functionality.\n * For standard AG-UI events, import directly from @ag-ui/core.\n */\n\nimport type { CustomEvent } from \"@ag-ui/core\";\n\ntype TamboCustomEventEnvelope<TName extends string, TValue> = Omit<\n  CustomEvent,\n  \"name\" | \"value\"\n> & {\n  name: TName;\n  value: TValue;\n};\n\n/**\n * Component start event (custom: tambo.component.start)\n */\nexport type ComponentStartEvent = TamboCustomEventEnvelope<\n  \"tambo.component.start\",\n  {\n    messageId: string;\n    componentId: string;\n    componentName: string;\n  }\n>;\n\n/**\n * Component props delta event (custom: tambo.component.props_delta)\n * Uses JSON Patch (RFC 6902) to update component props\n */\nexport type ComponentPropsDeltaEvent = TamboCustomEventEnvelope<\n  \"tambo.component.props_delta\",\n  {\n    componentId: string;\n    operations: JsonPatchOperation[];\n  }\n>;\n\n/**\n * Component state delta event (custom: tambo.component.state_delta)\n * Uses JSON Patch (RFC 6902) to update component state\n */\nexport type ComponentStateDeltaEvent = TamboCustomEventEnvelope<\n  \"tambo.component.state_delta\",\n  {\n    componentId: string;\n    operations: JsonPatchOperation[];\n  }\n>;\n\n/**\n * Component end event (custom: tambo.component.end)\n */\nexport type ComponentEndEvent = TamboCustomEventEnvelope<\n  \"tambo.component.end\",\n  {\n    componentId: string;\n  }\n>;\n\n/**\n * Run awaiting input event (custom: tambo.run.awaiting_input)\n * Signals that the run is paused waiting for client-side tool execution\n */\nexport type RunAwaitingInputEvent = TamboCustomEventEnvelope<\n  \"tambo.run.awaiting_input\",\n  {\n    pendingToolCallIds: string[];\n  }\n>;\n\n/**\n * JSON Patch operation (RFC 6902)\n */\nexport interface JsonPatchOperation {\n  op: \"add\" | \"remove\" | \"replace\" | \"move\" | \"copy\" | \"test\";\n  path: string;\n  value?: unknown;\n  from?: string; // For 'move' and 'copy' operations\n}\n\n/**\n * Union type of Tambo-specific custom events\n */\nexport type TamboCustomEvent =\n  | ComponentStartEvent\n  | ComponentPropsDeltaEvent\n  | ComponentStateDeltaEvent\n  | ComponentEndEvent\n  | RunAwaitingInputEvent;\n"]}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/v1/types/event.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAkGH,gDAOC;AAQD,gDAiBC;AAlDD;;GAEG;AACH,MAAM,wBAAwB,GAAG;IAC/B,uBAAuB;IACvB,6BAA6B;IAC7B,6BAA6B;IAC7B,qBAAqB;IACrB,0BAA0B;CAClB,CAAC;AAEX;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,KAElC;IACC,OAAO,CACL,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC7B,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CACrE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,KAAkB;IAElB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,uBAAuB;YAC1B,OAAO,KAA4B,CAAC;QACtC,KAAK,6BAA6B;YAChC,OAAO,KAAiC,CAAC;QAC3C,KAAK,6BAA6B;YAChC,OAAO,KAAiC,CAAC;QAC3C,KAAK,qBAAqB;YACxB,OAAO,KAA0B,CAAC;QACpC,KAAK,0BAA0B;YAC7B,OAAO,KAA8B,CAAC;QACxC;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Tambo-specific Custom Event Types for v1 Streaming API\n *\n * Defines custom events specific to Tambo functionality.\n * For standard AG-UI events, import directly from `@ag-ui/core`.\n */\n\nimport type { CustomEvent } from \"@ag-ui/core\";\nimport type { Operation } from \"fast-json-patch\";\n\ntype TamboCustomEventEnvelope<TName extends string, TValue> = Omit<\n  CustomEvent,\n  \"name\" | \"value\"\n> & {\n  name: TName;\n  value: TValue;\n};\n\n/**\n * Component start event (custom: tambo.component.start)\n */\nexport type ComponentStartEvent = TamboCustomEventEnvelope<\n  \"tambo.component.start\",\n  {\n    messageId: string;\n    componentId: string;\n    componentName: string;\n  }\n>;\n\n/**\n * Component props delta event (custom: tambo.component.props_delta)\n * Uses JSON Patch (RFC 6902) to update component props\n */\nexport type ComponentPropsDeltaEvent = TamboCustomEventEnvelope<\n  \"tambo.component.props_delta\",\n  {\n    componentId: string;\n    operations: Operation[];\n  }\n>;\n\n/**\n * Component state delta event (custom: tambo.component.state_delta)\n * Uses JSON Patch (RFC 6902) to update component state\n */\nexport type ComponentStateDeltaEvent = TamboCustomEventEnvelope<\n  \"tambo.component.state_delta\",\n  {\n    componentId: string;\n    operations: Operation[];\n  }\n>;\n\n/**\n * Component end event (custom: tambo.component.end)\n */\nexport type ComponentEndEvent = TamboCustomEventEnvelope<\n  \"tambo.component.end\",\n  {\n    componentId: string;\n  }\n>;\n\n/**\n * Run awaiting input event (custom: tambo.run.awaiting_input)\n * Signals that the run is paused waiting for client-side tool execution\n */\nexport type RunAwaitingInputEvent = TamboCustomEventEnvelope<\n  \"tambo.run.awaiting_input\",\n  {\n    pendingToolCallIds: string[];\n  }\n>;\n\n/**\n * Union type of Tambo-specific custom events\n */\nexport type TamboCustomEvent =\n  | ComponentStartEvent\n  | ComponentPropsDeltaEvent\n  | ComponentStateDeltaEvent\n  | ComponentEndEvent\n  | RunAwaitingInputEvent;\n\n/**\n * Known Tambo custom event names for type narrowing\n */\nconst TAMBO_CUSTOM_EVENT_NAMES = [\n  \"tambo.component.start\",\n  \"tambo.component.props_delta\",\n  \"tambo.component.state_delta\",\n  \"tambo.component.end\",\n  \"tambo.run.awaiting_input\",\n] as const;\n\n/**\n * Type guard to check if an event is a Tambo custom event.\n * Validates that the event has a name matching known Tambo custom event types.\n * @param event - Event object to check\n * @param event.name - Event name to match against known Tambo event types\n * @returns True if event is a TamboCustomEvent\n */\nexport function isTamboCustomEvent(event: {\n  name?: string;\n}): event is TamboCustomEvent {\n  return (\n    typeof event.name === \"string\" &&\n    (TAMBO_CUSTOM_EVENT_NAMES as readonly string[]).includes(event.name)\n  );\n}\n\n/**\n * Casts a CustomEvent to the specific TamboCustomEvent type based on its name.\n * Uses exhaustive type checking to ensure all event types are handled.\n * @param event - The CustomEvent to cast\n * @returns The properly typed TamboCustomEvent, or undefined if not a known Tambo event\n */\nexport function asTamboCustomEvent(\n  event: CustomEvent,\n): TamboCustomEvent | undefined {\n  switch (event.name) {\n    case \"tambo.component.start\":\n      return event as ComponentStartEvent;\n    case \"tambo.component.props_delta\":\n      return event as ComponentPropsDeltaEvent;\n    case \"tambo.component.state_delta\":\n      return event as ComponentStateDeltaEvent;\n    case \"tambo.component.end\":\n      return event as ComponentEndEvent;\n    case \"tambo.run.awaiting_input\":\n      return event as RunAwaitingInputEvent;\n    default:\n      return undefined;\n  }\n}\n"]}

package/dist/v1/types/event.test.d.ts

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

package/dist/v1/types/event.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.test.d.ts","sourceRoot":"","sources":["../../../src/v1/types/event.test.ts"],"names":[],"mappings":""}