@tambo-ai/react 0.73.0 → 0.74.0

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

@@ -8,10 +8,11 @@
  * This mirrors the beta SDK's TamboThreadInputProvider pattern.
  */
 import React, { createContext, useCallback, useContext, useState, } from "react";
-import { useMessageImages, } from "../../hooks/use-message-images";
-import { useTamboMutation, } from "../../hooks/react-query-hooks";
-import { useTamboV1SendMessage } from "../hooks/use-tambo-v1-send-message";
-import { useStreamState } from "./tambo-v1-stream-context";
+import { useMessageImages, } from "../../hooks/use-message-images.js";
+import { useTamboMutation, } from "../../hooks/react-query-hooks.js";
+import { useTamboV1SendMessage } from "../hooks/use-tambo-v1-send-message.js";
+import { isPlaceholderThreadId } from "../utils/event-accumulator.js";
+import { useStreamDispatch, useStreamState } from "./tambo-v1-stream-context.js";
 // Error messages for various input-related error scenarios.
 // TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps
 // failures into a small, stable set of user-facing error codes (at minimum:
@@ -61,14 +62,14 @@ export const TamboV1ThreadInputContext = createContext(undefined);
  */
 export function TamboV1ThreadInputProvider({ children }) {
     const [inputValue, setInputValue] = useState("");
-    const [threadId, setThreadId] = useState(undefined);
     const imageState = useMessageImages();
     const streamState = useStreamState();
-    // Use the current thread from stream state if no explicit threadId is set
-    const inheritedThreadId = streamState.currentThreadId ?? undefined;
-    const effectiveThreadId = threadId ?? inheritedThreadId;
-    const shouldAdoptThreadId = threadId === undefined && inheritedThreadId === undefined;
-    const sendMessage = useTamboV1SendMessage(effectiveThreadId);
+    const dispatch = useStreamDispatch();
+    // Use the current thread from stream state directly
+    // Placeholder ID indicates a new thread should be created
+    const currentThreadId = streamState.currentThreadId ?? undefined;
+    const isNewThread = isPlaceholderThreadId(currentThreadId);
+    const sendMessage = useTamboV1SendMessage(currentThreadId);
     const submitFn = useCallback(async (options) => {
         const trimmedValue = inputValue.trim();
         // Check if we have content to send
@@ -87,20 +88,22 @@ export function TamboV1ThreadInputProvider({ children }) {
                 role: "user",
                 content,
             },
+            userMessageText: trimmedValue, // Pass text for optimistic display
             debug: options?.debug,
         });
         // Clear input and images after successful submission
         setInputValue("");
         imageState.clearImages();
-        // Update threadId if a new thread was created
-        if (result.threadId && shouldAdoptThreadId) {
-            setThreadId(result.threadId);
+        // Update stream context's currentThreadId if a new thread was created
+        if (result.threadId && isNewThread) {
+            dispatch({ type: "SET_CURRENT_THREAD", threadId: result.threadId });
         }
         return result;
     }, 
     // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).
-    [inputValue, imageState, sendMessage, shouldAdoptThreadId]);
+    [inputValue, imageState, sendMessage, isNewThread, dispatch]);
     const { mutateAsync: submitAsync, mutate: _unusedSubmit, ...mutationState } = useTamboMutation({
+        mutationKey: ["v1-thread-input", currentThreadId],
         mutationFn: submitFn,
     });
     const contextValue = {
@@ -113,8 +116,7 @@ export function TamboV1ThreadInputProvider({ children }) {
         addImages: imageState.addImages,
         removeImage: imageState.removeImage,
         clearImages: imageState.clearImages,
-        threadId: effectiveThreadId,
-        setThreadId,
+        threadId: currentThreadId,
     };
     return (React.createElement(TamboV1ThreadInputContext.Provider, { value: contextValue }, children));
 }

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-v1-thread-input-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-thread-input-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,GAET,MAAM,OAAO,CAAC;AACf,OAAO,EACL,gBAAgB,GAEjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,gBAAgB,GAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,4DAA4D;AAC5D,8EAA8E;AAC9E,4EAA4E;AAC5E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,yBAAyB;IAChC,UAAU,EAAE,wBAAwB;CAC5B,CAAC;AAEX,SAAS,4BAA4B,CACnC,KAAkB;IAElB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,QAAQ,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,IAAI;YACpB,uEAAuE;YACvE,gCAAgC;YAChC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;SAC1C;KACF,CAAC;AACJ,CAAC;AAkED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAEpD,SAAS,CAAC,CAAC;AAEb;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAE,QAAQ,EAAqB;IACxE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,0EAA0E;IAC1E,MAAM,iBAAiB,GAAG,WAAW,CAAC,eAAe,IAAI,SAAS,CAAC;IACnE,MAAM,iBAAiB,GAAG,QAAQ,IAAI,iBAAiB,CAAC;IACxD,MAAM,mBAAmB,GACvB,QAAQ,KAAK,SAAS,IAAI,iBAAiB,KAAK,SAAS,CAAC;IAC5D,MAAM,WAAW,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,WAAW,CAC1B,KAAK,EACH,OAAuB,EACoB,EAAE;QAC7C,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QAEvC,mCAAmC;QACnC,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC;YAC3C,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,OAAO;aACR;YACD,KAAK,EAAE,OAAO,EAAE,KAAK;SACtB,CAAC,CAAC;QAEH,qDAAqD;QACrD,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,UAAU,CAAC,WAAW,EAAE,CAAC;QAEzB,8CAA8C;QAC9C,IAAI,MAAM,CAAC,QAAQ,IAAI,mBAAmB,EAAE,CAAC;YAC3C,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,mFAAmF;IACnF,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAC3D,CAAC;IAEF,MAAM,EACJ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,aAAa,EACrB,GAAG,aAAa,EACjB,GAAG,gBAAgB,CAAC;QACnB,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAmC;QACnD,GAAG,aAAa;QAChB,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,aAAa;QACvB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,QAAQ,EAAE,iBAAiB;QAC3B,WAAW;KACZ,CAAC;IAEF,OAAO,CACL,oBAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,IACpD,QAAQ,CAC0B,CACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["\"use client\";\n\n/**\n * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API\n *\n * Provides shared input state across all components, enabling features like\n * suggestions to update the input field directly.\n *\n * This mirrors the beta SDK's TamboThreadInputProvider pattern.\n */\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useState,\n  type PropsWithChildren,\n} from \"react\";\nimport {\n  useMessageImages,\n  type StagedImage,\n} from \"../../hooks/use-message-images\";\nimport {\n  useTamboMutation,\n  type UseTamboMutationResult,\n} from \"../../hooks/react-query-hooks\";\nimport { useTamboV1SendMessage } from \"../hooks/use-tambo-v1-send-message\";\nimport type { InputMessage } from \"../types/message\";\nimport { useStreamState } from \"./tambo-v1-stream-context\";\n\n// Error messages for various input-related error scenarios.\n// TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps\n// failures into a small, stable set of user-facing error codes (at minimum:\n// connectivity failures vs non-2xx responses).\nexport const INPUT_ERROR_MESSAGES = {\n  EMPTY: \"Message cannot be empty\",\n  VALIDATION: \"Invalid message format\",\n} as const;\n\nfunction stagedImageToResourceContent(\n  image: StagedImage,\n): InputMessage[\"content\"][number] {\n  if (!image.dataUrl.startsWith(\"data:\")) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const commaIndex = image.dataUrl.indexOf(\",\");\n  if (commaIndex === -1) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const header = image.dataUrl.slice(\"data:\".length, commaIndex);\n  const [mimeType, ...params] = header.split(\";\");\n  const isBase64 = params.includes(\"base64\");\n\n  if (mimeType !== image.type || !isBase64) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  return {\n    type: \"resource\",\n    resource: {\n      name: image.name,\n      mimeType: image.type,\n      // Shared.Resource.blob expects base64-encoded data; this is the base64\n      // payload from the `data:` URL.\n      blob: image.dataUrl.slice(commaIndex + 1),\n    },\n  };\n}\n\n/**\n * Options for submitting a message\n */\nexport interface SubmitOptions {\n  /**\n   * Enable debug logging for the stream\n   */\n  debug?: boolean;\n}\n\n/**\n * Context props for thread input state\n */\nexport interface TamboV1ThreadInputContextProps extends Omit<\n  UseTamboMutationResult<\n    { threadId: string | undefined },\n    Error,\n    SubmitOptions | undefined\n  >,\n  \"mutate\" | \"mutateAsync\"\n> {\n  /** Current value of the input field */\n  value: string;\n\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: React.Dispatch<React.SetStateAction<string>>;\n\n  /**\n   * Function to submit the current input value\n   * @param options - Submission options\n   * @returns Promise with the threadId\n   */\n  submit: (\n    options?: SubmitOptions,\n  ) => Promise<{ threadId: string | undefined }>;\n\n  /** Currently staged images */\n  images: StagedImage[];\n\n  /** Add a single image */\n  addImage: (file: File) => Promise<void>;\n\n  /** Add multiple images */\n  addImages: (files: File[]) => Promise<void>;\n\n  /** Remove an image by id */\n  removeImage: (id: string) => void;\n\n  /** Clear all staged images */\n  clearImages: () => void;\n\n  /** Current thread ID being used for input */\n  threadId: string | undefined;\n\n  /**\n   * Set the thread ID for input submission.\n   * If not set, a new thread will be created on submit.\n   */\n  setThreadId: React.Dispatch<React.SetStateAction<string | undefined>>;\n}\n\n/**\n * Context for thread input state.\n * @internal\n */\nexport const TamboV1ThreadInputContext = createContext<\n  TamboV1ThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components.\n *\n * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components\n * all share the same input state.\n * @param props - Provider props\n * @param props.children - Child components\n * @returns Thread input context provider\n */\nexport function TamboV1ThreadInputProvider({ children }: PropsWithChildren) {\n  const [inputValue, setInputValue] = useState(\"\");\n  const [threadId, setThreadId] = useState<string | undefined>(undefined);\n  const imageState = useMessageImages();\n  const streamState = useStreamState();\n\n  // Use the current thread from stream state if no explicit threadId is set\n  const inheritedThreadId = streamState.currentThreadId ?? undefined;\n  const effectiveThreadId = threadId ?? inheritedThreadId;\n  const shouldAdoptThreadId =\n    threadId === undefined && inheritedThreadId === undefined;\n  const sendMessage = useTamboV1SendMessage(effectiveThreadId);\n\n  const submitFn = useCallback(\n    async (\n      options?: SubmitOptions,\n    ): Promise<{ threadId: string | undefined }> => {\n      const trimmedValue = inputValue.trim();\n\n      // Check if we have content to send\n      if (!trimmedValue && imageState.images.length === 0) {\n        throw new Error(INPUT_ERROR_MESSAGES.EMPTY);\n      }\n\n      const content: InputMessage[\"content\"] = [];\n\n      if (trimmedValue) {\n        content.push({ type: \"text\", text: trimmedValue });\n      }\n\n      for (const image of imageState.images) {\n        content.push(stagedImageToResourceContent(image));\n      }\n\n      const result = await sendMessage.mutateAsync({\n        message: {\n          role: \"user\",\n          content,\n        },\n        debug: options?.debug,\n      });\n\n      // Clear input and images after successful submission\n      setInputValue(\"\");\n      imageState.clearImages();\n\n      // Update threadId if a new thread was created\n      if (result.threadId && shouldAdoptThreadId) {\n        setThreadId(result.threadId);\n      }\n\n      return result;\n    },\n    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).\n    [inputValue, imageState, sendMessage, shouldAdoptThreadId],\n  );\n\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationFn: submitFn,\n  });\n\n  const contextValue: TamboV1ThreadInputContextProps = {\n    ...mutationState,\n    value: inputValue,\n    setValue: setInputValue,\n    submit: submitAsync,\n    images: imageState.images,\n    addImage: imageState.addImage,\n    addImages: imageState.addImages,\n    removeImage: imageState.removeImage,\n    clearImages: imageState.clearImages,\n    threadId: effectiveThreadId,\n    setThreadId,\n  };\n\n  return (\n    <TamboV1ThreadInputContext.Provider value={contextValue}>\n      {children}\n    </TamboV1ThreadInputContext.Provider>\n  );\n}\n\n/**\n * Hook to access the shared thread input state.\n *\n * All components using this hook share the same input state, enabling\n * features like suggestions to update the input field directly.\n * @returns The shared thread input context\n * @throws {Error} If used outside TamboV1ThreadInputProvider\n * @example\n * ```tsx\n * function ChatInput() {\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>\n *       <input\n *         value={value}\n *         onChange={(e) => setValue(e.target.value)}\n *         disabled={isPending}\n *       />\n *       <button type=\"submit\" disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadInput(): TamboV1ThreadInputContextProps {\n  const context = useContext(TamboV1ThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboV1ThreadInput must be used within TamboV1ThreadInputProvider\",\n    );\n  }\n  return context;\n}\n"]}
+{"version":3,"file":"tambo-v1-thread-input-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-thread-input-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * TamboV1ThreadInputProvider - Shared Thread Input Context for v1 API\n *\n * Provides shared input state across all components, enabling features like\n * suggestions to update the input field directly.\n *\n * This mirrors the beta SDK's TamboThreadInputProvider pattern.\n */\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useState,\n  type PropsWithChildren,\n} from \"react\";\nimport {\n  useMessageImages,\n  type StagedImage,\n} from \"../../hooks/use-message-images\";\nimport {\n  useTamboMutation,\n  type UseTamboMutationResult,\n} from \"../../hooks/react-query-hooks\";\nimport { useTamboV1SendMessage } from \"../hooks/use-tambo-v1-send-message\";\nimport type { InputMessage } from \"../types/message\";\nimport { isPlaceholderThreadId } from \"../utils/event-accumulator\";\nimport { useStreamDispatch, useStreamState } from \"./tambo-v1-stream-context\";\n\n// Error messages for various input-related error scenarios.\n// TODO: Reintroduce explicit `NETWORK` and `SERVER` keys once `submit()` maps\n// failures into a small, stable set of user-facing error codes (at minimum:\n// connectivity failures vs non-2xx responses).\nexport const INPUT_ERROR_MESSAGES = {\n  EMPTY: \"Message cannot be empty\",\n  VALIDATION: \"Invalid message format\",\n} as const;\n\nfunction stagedImageToResourceContent(\n  image: StagedImage,\n): InputMessage[\"content\"][number] {\n  if (!image.dataUrl.startsWith(\"data:\")) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const commaIndex = image.dataUrl.indexOf(\",\");\n  if (commaIndex === -1) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  const header = image.dataUrl.slice(\"data:\".length, commaIndex);\n  const [mimeType, ...params] = header.split(\";\");\n  const isBase64 = params.includes(\"base64\");\n\n  if (mimeType !== image.type || !isBase64) {\n    throw new Error(INPUT_ERROR_MESSAGES.VALIDATION);\n  }\n\n  return {\n    type: \"resource\",\n    resource: {\n      name: image.name,\n      mimeType: image.type,\n      // Shared.Resource.blob expects base64-encoded data; this is the base64\n      // payload from the `data:` URL.\n      blob: image.dataUrl.slice(commaIndex + 1),\n    },\n  };\n}\n\n/**\n * Options for submitting a message\n */\nexport interface SubmitOptions {\n  /**\n   * Enable debug logging for the stream\n   */\n  debug?: boolean;\n}\n\n/**\n * Context props for thread input state\n */\nexport interface TamboV1ThreadInputContextProps extends Omit<\n  UseTamboMutationResult<\n    { threadId: string | undefined },\n    Error,\n    SubmitOptions | undefined\n  >,\n  \"mutate\" | \"mutateAsync\"\n> {\n  /** Current value of the input field */\n  value: string;\n\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: React.Dispatch<React.SetStateAction<string>>;\n\n  /**\n   * Function to submit the current input value\n   * @param options - Submission options\n   * @returns Promise with the threadId\n   */\n  submit: (\n    options?: SubmitOptions,\n  ) => Promise<{ threadId: string | undefined }>;\n\n  /** Currently staged images */\n  images: StagedImage[];\n\n  /** Add a single image */\n  addImage: (file: File) => Promise<void>;\n\n  /** Add multiple images */\n  addImages: (files: File[]) => Promise<void>;\n\n  /** Remove an image by id */\n  removeImage: (id: string) => void;\n\n  /** Clear all staged images */\n  clearImages: () => void;\n\n  /** Current thread ID being used for input (from stream state) */\n  threadId: string | undefined;\n}\n\n/**\n * Context for thread input state.\n * @internal\n */\nexport const TamboV1ThreadInputContext = createContext<\n  TamboV1ThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components.\n *\n * This ensures that useTamboV1ThreadInput, useTamboV1Suggestions, and other components\n * all share the same input state.\n * @param props - Provider props\n * @param props.children - Child components\n * @returns Thread input context provider\n */\nexport function TamboV1ThreadInputProvider({ children }: PropsWithChildren) {\n  const [inputValue, setInputValue] = useState(\"\");\n  const imageState = useMessageImages();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n\n  // Use the current thread from stream state directly\n  // Placeholder ID indicates a new thread should be created\n  const currentThreadId = streamState.currentThreadId ?? undefined;\n  const isNewThread = isPlaceholderThreadId(currentThreadId);\n  const sendMessage = useTamboV1SendMessage(currentThreadId);\n\n  const submitFn = useCallback(\n    async (\n      options?: SubmitOptions,\n    ): Promise<{ threadId: string | undefined }> => {\n      const trimmedValue = inputValue.trim();\n\n      // Check if we have content to send\n      if (!trimmedValue && imageState.images.length === 0) {\n        throw new Error(INPUT_ERROR_MESSAGES.EMPTY);\n      }\n\n      const content: InputMessage[\"content\"] = [];\n\n      if (trimmedValue) {\n        content.push({ type: \"text\", text: trimmedValue });\n      }\n\n      for (const image of imageState.images) {\n        content.push(stagedImageToResourceContent(image));\n      }\n\n      const result = await sendMessage.mutateAsync({\n        message: {\n          role: \"user\",\n          content,\n        },\n        userMessageText: trimmedValue, // Pass text for optimistic display\n        debug: options?.debug,\n      });\n\n      // Clear input and images after successful submission\n      setInputValue(\"\");\n      imageState.clearImages();\n\n      // Update stream context's currentThreadId if a new thread was created\n      if (result.threadId && isNewThread) {\n        dispatch({ type: \"SET_CURRENT_THREAD\", threadId: result.threadId });\n      }\n\n      return result;\n    },\n    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).\n    [inputValue, imageState, sendMessage, isNewThread, dispatch],\n  );\n\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationKey: [\"v1-thread-input\", currentThreadId],\n    mutationFn: submitFn,\n  });\n\n  const contextValue: TamboV1ThreadInputContextProps = {\n    ...mutationState,\n    value: inputValue,\n    setValue: setInputValue,\n    submit: submitAsync,\n    images: imageState.images,\n    addImage: imageState.addImage,\n    addImages: imageState.addImages,\n    removeImage: imageState.removeImage,\n    clearImages: imageState.clearImages,\n    threadId: currentThreadId,\n  };\n\n  return (\n    <TamboV1ThreadInputContext.Provider value={contextValue}>\n      {children}\n    </TamboV1ThreadInputContext.Provider>\n  );\n}\n\n/**\n * Hook to access the shared thread input state.\n *\n * All components using this hook share the same input state, enabling\n * features like suggestions to update the input field directly.\n * @returns The shared thread input context\n * @throws {Error} If used outside TamboV1ThreadInputProvider\n * @example\n * ```tsx\n * function ChatInput() {\n *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput();\n *\n *   return (\n *     <form onSubmit={(e) => { e.preventDefault(); submit(); }}>\n *       <input\n *         value={value}\n *         onChange={(e) => setValue(e.target.value)}\n *         disabled={isPending}\n *       />\n *       <button type=\"submit\" disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadInput(): TamboV1ThreadInputContextProps {\n  const context = useContext(TamboV1ThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboV1ThreadInput must be used within TamboV1ThreadInputProvider\",\n    );\n  }\n  return context;\n}\n"]}

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

@@ -40,12 +40,20 @@ export type ComponentStateDeltaEvent = TamboCustomEventEnvelope<"tambo.component
 export type ComponentEndEvent = TamboCustomEventEnvelope<"tambo.component.end", {
     componentId: string;
 }>;
+/**
+ * Pending tool call information from awaiting_input event
+ */
+export interface PendingToolCall {
+    toolCallId: string;
+    toolName: string;
+    arguments: string;
+}
 /**
  * Run awaiting input event (custom: tambo.run.awaiting_input)
  * Signals that the run is paused waiting for client-side tool execution
  */
 export type RunAwaitingInputEvent = TamboCustomEventEnvelope<"tambo.run.awaiting_input", {
-    pendingToolCallIds: string[];
+    pendingToolCalls: PendingToolCall[];
 }>;
 /**
  * Union type of Tambo-specific custom events

package/esm/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;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"}
+{"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;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAC1D,0BAA0B,EAC1B;IACE,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC,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/esm/v1/types/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/v1/types/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgFH;;GAEG;AACH,MAAM,wBAAwB,GAAG;IAC/B,uBAAuB;IACvB,6BAA6B;IAC7B,6BAA6B;IAC7B,qBAAqB;IACrB,0BAA0B;CAClB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,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,MAAM,UAAU,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"]}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/v1/types/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyFH;;GAEG;AACH,MAAM,wBAAwB,GAAG;IAC/B,uBAAuB;IACvB,6BAA6B;IAC7B,6BAA6B;IAC7B,qBAAqB;IACrB,0BAA0B;CAClB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,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,MAAM,UAAU,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 * Pending tool call information from awaiting_input event\n */\nexport interface PendingToolCall {\n  toolCallId: string;\n  toolName: string;\n  arguments: string;\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    pendingToolCalls: PendingToolCall[];\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/esm/v1/types/event.test.js

@@ -1,5 +1,5 @@
 import { EventType } from "@ag-ui/core";
-import { isTamboCustomEvent } from "./event";
+import { isTamboCustomEvent } from "./event.js";
 describe("isTamboCustomEvent", () => {
     it("returns true for tambo.component.start event", () => {
         const event = {
@@ -37,7 +37,11 @@ describe("isTamboCustomEvent", () => {
         const event = {
             type: EventType.CUSTOM,
             name: "tambo.run.awaiting_input",
-            value: { pendingToolCallIds: ["tool1"] },
+            value: {
+                pendingToolCalls: [
+                    { toolCallId: "tool1", toolName: "test", arguments: "{}" },
+                ],
+            },
         };
         expect(isTamboCustomEvent(event)).toBe(true);
     });

package/esm/v1/types/event.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.test.js","sourceRoot":"","sources":["../../../src/v1/types/event.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventType } from \"@ag-ui/core\";\nimport { isTamboCustomEvent } from \"./event\";\n\ndescribe(\"isTamboCustomEvent\", () => {\n  it(\"returns true for tambo.component.start event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.start\",\n      value: { messageId: \"msg1\", componentId: \"comp1\", componentName: \"Test\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.props_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.props_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.state_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.state_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.end event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.end\",\n      value: { componentId: \"comp1\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.run.awaiting_input event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.run.awaiting_input\",\n      value: { pendingToolCallIds: [\"tool1\"] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns false for unknown custom event name\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"unknown.event\",\n      value: {},\n    };\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is undefined\", () => {\n    const event: { name?: string } = {};\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is not a string\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: 123,\n      value: {},\n    };\n    expect(isTamboCustomEvent(event as unknown as { name?: string })).toBe(\n      false,\n    );\n  });\n\n  it(\"returns false for empty object\", () => {\n    expect(isTamboCustomEvent({})).toBe(false);\n  });\n});\n"]}
+{"version":3,"file":"event.test.js","sourceRoot":"","sources":["../../../src/v1/types/event.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventType } from \"@ag-ui/core\";\nimport { isTamboCustomEvent } from \"./event\";\n\ndescribe(\"isTamboCustomEvent\", () => {\n  it(\"returns true for tambo.component.start event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.start\",\n      value: { messageId: \"msg1\", componentId: \"comp1\", componentName: \"Test\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.props_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.props_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.state_delta event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.state_delta\",\n      value: { componentId: \"comp1\", operations: [] },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.component.end event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.component.end\",\n      value: { componentId: \"comp1\" },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns true for tambo.run.awaiting_input event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.run.awaiting_input\",\n      value: {\n        pendingToolCalls: [\n          { toolCallId: \"tool1\", toolName: \"test\", arguments: \"{}\" },\n        ],\n      },\n    };\n    expect(isTamboCustomEvent(event)).toBe(true);\n  });\n\n  it(\"returns false for unknown custom event name\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"unknown.event\",\n      value: {},\n    };\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is undefined\", () => {\n    const event: { name?: string } = {};\n    expect(isTamboCustomEvent(event)).toBe(false);\n  });\n\n  it(\"returns false when name is not a string\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: 123,\n      value: {},\n    };\n    expect(isTamboCustomEvent(event as unknown as { name?: string })).toBe(\n      false,\n    );\n  });\n\n  it(\"returns false for empty object\", () => {\n    expect(isTamboCustomEvent({})).toBe(false);\n  });\n});\n"]}

package/esm/v1/types/message.d.ts

@@ -6,7 +6,7 @@
  * contains an array of content blocks (text, tool calls, tool results, components).
  */
 import type { ReactElement } from "react";
-export type { TextContent, ToolUseContent, ToolResultContent, ComponentContent, ResourceContent, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+export type { TextContent, ToolResultContent, ResourceContent, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
 export type { InputMessage } from "@tambo-ai/typescript-sdk/resources/threads/runs";
 export type { MessageListResponse, MessageGetResponse, } from "@tambo-ai/typescript-sdk/resources/threads/messages";
 import type { TextContent, ToolUseContent, ToolResultContent, ComponentContent, ResourceContent } from "@tambo-ai/typescript-sdk/resources/threads/threads";
@@ -25,23 +25,69 @@ export interface V1ComponentContent extends ComponentContent {
      * - 'started': Component block created, awaiting props
      * - 'streaming': Props are being streamed
      * - 'done': Props streaming complete
+     *
+     * Optional for historical messages loaded from API (defaults to "done").
      */
-    streamingState: ComponentStreamingState;
+    streamingState?: ComponentStreamingState;
     /**
      * The rendered React element for this component.
      * undefined if not yet rendered, null if the component couldn't be found in the registry.
      */
     renderedComponent?: ReactElement | null;
 }
+/**
+ * Special display properties that can be included in tool input.
+ * These are used to customize tool status messages shown in the UI.
+ */
+export interface TamboToolDisplayProps {
+    /** Generic display message for the tool */
+    _tambo_displayMessage?: string;
+    /** Message shown while the tool is executing */
+    _tambo_statusMessage?: string;
+    /** Message shown after the tool completes */
+    _tambo_completionStatusMessage?: string;
+}
+/**
+ * Extended ToolUseContent with computed state properties.
+ * Used by the v1 SDK to provide pre-computed tool state to consumers.
+ *
+ * Note: The computed properties are populated by `useTamboV1()` hook.
+ * When accessed via lower-level APIs, they may be undefined.
+ */
+export interface V1ToolUseContent extends Omit<ToolUseContent, "input"> {
+    /**
+     * Tool input parameters with internal `_tambo_*` properties removed.
+     * Consumers see only the actual tool parameters.
+     */
+    input: Record<string, unknown>;
+    /**
+     * Whether this tool call has completed (has a matching tool_result).
+     * Computed by `useTamboV1()` based on presence of matching tool_result.
+     */
+    hasCompleted?: boolean;
+    /**
+     * The status message to display, resolved based on tool execution state.
+     * Automatically updates as tool progresses through execution lifecycle.
+     * Computed by `useTamboV1()`.
+     */
+    statusMessage?: string;
+    /**
+     * Extracted Tambo display properties from the tool input.
+     * Consumers can use these for custom rendering if needed.
+     * Computed by `useTamboV1()`.
+     */
+    tamboDisplayProps?: TamboToolDisplayProps;
+}
 /**
  * Message role (from SDK)
+ * Includes 'system' to accommodate messages loaded from API.
  */
-export type MessageRole = "user" | "assistant";
+export type MessageRole = "user" | "assistant" | "system";
 /**
  * Union type of all content block types.
- * Uses V1ComponentContent which includes streaming state and rendered component.
+ * Uses V1ComponentContent and V1ToolUseContent which include computed state.
  */
-export type Content = TextContent | ToolUseContent | ToolResultContent | V1ComponentContent | ResourceContent;
+export type Content = TextContent | V1ToolUseContent | ToolResultContent | V1ComponentContent | ResourceContent;
 /**
  * Message in a thread (simplified from SDK's MessageGetResponse)
  */
@@ -52,9 +98,21 @@ export interface TamboV1Message {
     role: MessageRole;
     /** Content blocks in the message */
     content: Content[];
-    /** When the message was created */
-    createdAt: string;
+    /** When the message was created (optional for historical messages loaded from API) */
+    createdAt?: string;
     /** Message metadata */
     metadata?: Record<string, unknown>;
+    /**
+     * Reasoning content from the model (transient - only during streaming).
+     * Each element is a reasoning "chunk" - models may emit multiple reasoning blocks.
+     * This data is not persisted to the database and will not be present in
+     * messages loaded from the API.
+     */
+    reasoning?: string[];
+    /**
+     * Duration of the reasoning phase in milliseconds (for display purposes).
+     * Populated when reasoning completes.
+     */
+    reasoningDurationMS?: number;
 }
 //# sourceMappingURL=message.d.ts.map

package/esm/v1/types/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAEpF,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qDAAqD,CAAC;AAG7D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,oDAAoD,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,cAAc,EAAE,uBAAuB,CAAC;IAExC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAEpF,YAAY,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qDAAqD,CAAC;AAG7D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,oDAAoD,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,uBAAuB,CAAC;IAEzC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACrE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,OAAO,EAAE,OAAO,EAAE,CAAC;IAEnB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/esm/v1/types/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Message and Content Types for v1 API\n *\n * Re-exports message and content types from `@tambo-ai/typescript-sdk`.\n * Messages use Anthropic-style content blocks pattern where a message\n * contains an array of content blocks (text, tool calls, tool results, components).\n */\n\nimport type { ReactElement } from \"react\";\n\n// Re-export content block types from TypeScript SDK\nexport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n// Re-export message types from TypeScript SDK\nexport type { InputMessage } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\n\nexport type {\n  MessageListResponse,\n  MessageGetResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/messages\";\n\n// Import for Content union type\nimport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Streaming state for component content blocks.\n * Tracks the lifecycle of component prop/state streaming.\n */\nexport type ComponentStreamingState = \"started\" | \"streaming\" | \"done\";\n\n/**\n * Extended ComponentContent with streaming state and rendered element.\n * Used by the v1 SDK to track component rendering lifecycle.\n */\nexport interface V1ComponentContent extends ComponentContent {\n  /**\n   * Current streaming state of this component's props.\n   * - 'started': Component block created, awaiting props\n   * - 'streaming': Props are being streamed\n   * - 'done': Props streaming complete\n   */\n  streamingState: ComponentStreamingState;\n\n  /**\n   * The rendered React element for this component.\n   * undefined if not yet rendered, null if the component couldn't be found in the registry.\n   */\n  renderedComponent?: ReactElement | null;\n}\n\n/**\n * Message role (from SDK)\n */\nexport type MessageRole = \"user\" | \"assistant\";\n\n/**\n * Union type of all content block types.\n * Uses V1ComponentContent which includes streaming state and rendered component.\n */\nexport type Content =\n  | TextContent\n  | ToolUseContent\n  | ToolResultContent\n  | V1ComponentContent\n  | ResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboV1Message {\n  /** Unique message identifier */\n  id: string;\n\n  /** Message role (user or assistant) */\n  role: MessageRole;\n\n  /** Content blocks in the message */\n  content: Content[];\n\n  /** When the message was created */\n  createdAt: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n}\n"]}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Message and Content Types for v1 API\n *\n * Re-exports message and content types from `@tambo-ai/typescript-sdk`.\n * Messages use Anthropic-style content blocks pattern where a message\n * contains an array of content blocks (text, tool calls, tool results, components).\n */\n\nimport type { ReactElement } from \"react\";\n\n// Re-export content block types from TypeScript SDK\n// Note: ToolUseContent and ComponentContent are NOT re-exported - use V1ToolUseContent\n// and V1ComponentContent instead, which include computed state properties.\nexport type {\n  TextContent,\n  ToolResultContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n// Re-export message types from TypeScript SDK\nexport type { InputMessage } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\n\nexport type {\n  MessageListResponse,\n  MessageGetResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/messages\";\n\n// Import for Content union type\nimport type {\n  TextContent,\n  ToolUseContent,\n  ToolResultContent,\n  ComponentContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Streaming state for component content blocks.\n * Tracks the lifecycle of component prop/state streaming.\n */\nexport type ComponentStreamingState = \"started\" | \"streaming\" | \"done\";\n\n/**\n * Extended ComponentContent with streaming state and rendered element.\n * Used by the v1 SDK to track component rendering lifecycle.\n */\nexport interface V1ComponentContent extends ComponentContent {\n  /**\n   * Current streaming state of this component's props.\n   * - 'started': Component block created, awaiting props\n   * - 'streaming': Props are being streamed\n   * - 'done': Props streaming complete\n   *\n   * Optional for historical messages loaded from API (defaults to \"done\").\n   */\n  streamingState?: ComponentStreamingState;\n\n  /**\n   * The rendered React element for this component.\n   * undefined if not yet rendered, null if the component couldn't be found in the registry.\n   */\n  renderedComponent?: ReactElement | null;\n}\n\n/**\n * Special display properties that can be included in tool input.\n * These are used to customize tool status messages shown in the UI.\n */\nexport interface TamboToolDisplayProps {\n  /** Generic display message for the tool */\n  _tambo_displayMessage?: string;\n  /** Message shown while the tool is executing */\n  _tambo_statusMessage?: string;\n  /** Message shown after the tool completes */\n  _tambo_completionStatusMessage?: string;\n}\n\n/**\n * Extended ToolUseContent with computed state properties.\n * Used by the v1 SDK to provide pre-computed tool state to consumers.\n *\n * Note: The computed properties are populated by `useTamboV1()` hook.\n * When accessed via lower-level APIs, they may be undefined.\n */\nexport interface V1ToolUseContent extends Omit<ToolUseContent, \"input\"> {\n  /**\n   * Tool input parameters with internal `_tambo_*` properties removed.\n   * Consumers see only the actual tool parameters.\n   */\n  input: Record<string, unknown>;\n\n  /**\n   * Whether this tool call has completed (has a matching tool_result).\n   * Computed by `useTamboV1()` based on presence of matching tool_result.\n   */\n  hasCompleted?: boolean;\n\n  /**\n   * The status message to display, resolved based on tool execution state.\n   * Automatically updates as tool progresses through execution lifecycle.\n   * Computed by `useTamboV1()`.\n   */\n  statusMessage?: string;\n\n  /**\n   * Extracted Tambo display properties from the tool input.\n   * Consumers can use these for custom rendering if needed.\n   * Computed by `useTamboV1()`.\n   */\n  tamboDisplayProps?: TamboToolDisplayProps;\n}\n\n/**\n * Message role (from SDK)\n * Includes 'system' to accommodate messages loaded from API.\n */\nexport type MessageRole = \"user\" | \"assistant\" | \"system\";\n\n/**\n * Union type of all content block types.\n * Uses V1ComponentContent and V1ToolUseContent which include computed state.\n */\nexport type Content =\n  | TextContent\n  | V1ToolUseContent\n  | ToolResultContent\n  | V1ComponentContent\n  | ResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboV1Message {\n  /** Unique message identifier */\n  id: string;\n\n  /** Message role (user or assistant) */\n  role: MessageRole;\n\n  /** Content blocks in the message */\n  content: Content[];\n\n  /** When the message was created (optional for historical messages loaded from API) */\n  createdAt?: string;\n\n  /** Message metadata */\n  metadata?: Record<string, unknown>;\n\n  /**\n   * Reasoning content from the model (transient - only during streaming).\n   * Each element is a reasoning \"chunk\" - models may emit multiple reasoning blocks.\n   * This data is not persisted to the database and will not be present in\n   * messages loaded from the API.\n   */\n  reasoning?: string[];\n\n  /**\n   * Duration of the reasoning phase in milliseconds (for display purposes).\n   * Populated when reasoning completes.\n   */\n  reasoningDurationMS?: number;\n}\n"]}

package/esm/v1/types/thread.d.ts

@@ -4,7 +4,7 @@
  * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines
  * React-specific extensions for streaming state management.
  */
-import type { TamboV1Message } from "./message";
+import type { TamboV1Message } from "./message.js";
 export type { ThreadCreateResponse, ThreadRetrieveResponse, ThreadListResponse, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
 /**
  * Run status indicates the current state of the thread
@@ -29,6 +29,8 @@ export interface TamboV1Thread {
     createdAt: string;
     /** When the thread was last updated */
     updatedAt: string;
+    /** Whether the last run was cancelled (resets to false when a new run starts) */
+    lastRunCancelled: boolean;
 }
 /**
  * Streaming state tracks the progress of an active run
@@ -43,6 +45,8 @@ export interface StreamingState {
     messageId?: string;
     /** When the current run started */
     startTime?: number;
+    /** When reasoning started (for duration calculation) */
+    reasoningStartTime?: number;
     /** Error information if status is 'error' */
     error?: {
         message: string;

package/esm/v1/types/thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oDAAoD,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,yBAAyB;IACzB,MAAM,EAAE,SAAS,CAAC;IAElB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,SAAS,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oDAAoD,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,yBAAyB;IACzB,MAAM,EAAE,SAAS,CAAC;IAElB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,iFAAiF;IACjF,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,SAAS,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,6CAA6C;IAC7C,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/esm/v1/types/thread.js.map

@@ -1 +1 @@
-{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Thread Types for v1 API\n *\n * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines\n * React-specific extensions for streaming state management.\n */\n\nimport type { TamboV1Message } from \"./message\";\n\n// Re-export thread types from TypeScript SDK\nexport type {\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Run status indicates the current state of the thread\n */\nexport type RunStatus = \"idle\" | \"waiting\" | \"streaming\" | \"complete\" | \"error\";\n\n/**\n * Thread represents a conversation with the AI\n * Extended from SDK's ThreadRetrieveResponse with additional fields for React state\n */\nexport interface TamboV1Thread {\n  /** Unique thread identifier */\n  id: string;\n\n  /** Thread title/name */\n  title?: string;\n\n  /** Messages in the thread */\n  messages: TamboV1Message[];\n\n  /** Current run status */\n  status: RunStatus;\n\n  /** Thread metadata */\n  metadata?: Record<string, unknown>;\n\n  /** When the thread was created */\n  createdAt: string;\n\n  /** When the thread was last updated */\n  updatedAt: string;\n}\n\n/**\n * Streaming state tracks the progress of an active run\n * This is React-specific and not part of the SDK\n */\nexport interface StreamingState {\n  /** Current streaming status */\n  status: RunStatus;\n\n  /** Active run ID (if streaming) */\n  runId?: string;\n\n  /** Active message ID being streamed */\n  messageId?: string;\n\n  /** When the current run started */\n  startTime?: number;\n\n  /** Error information if status is 'error' */\n  error?: {\n    message: string;\n    code?: string;\n  };\n}\n"]}
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/v1/types/thread.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Thread Types for v1 API\n *\n * Re-exports thread types from `@tambo-ai/typescript-sdk` and defines\n * React-specific extensions for streaming state management.\n */\n\nimport type { TamboV1Message } from \"./message\";\n\n// Re-export thread types from TypeScript SDK\nexport type {\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Run status indicates the current state of the thread\n */\nexport type RunStatus = \"idle\" | \"waiting\" | \"streaming\" | \"complete\" | \"error\";\n\n/**\n * Thread represents a conversation with the AI\n * Extended from SDK's ThreadRetrieveResponse with additional fields for React state\n */\nexport interface TamboV1Thread {\n  /** Unique thread identifier */\n  id: string;\n\n  /** Thread title/name */\n  title?: string;\n\n  /** Messages in the thread */\n  messages: TamboV1Message[];\n\n  /** Current run status */\n  status: RunStatus;\n\n  /** Thread metadata */\n  metadata?: Record<string, unknown>;\n\n  /** When the thread was created */\n  createdAt: string;\n\n  /** When the thread was last updated */\n  updatedAt: string;\n\n  /** Whether the last run was cancelled (resets to false when a new run starts) */\n  lastRunCancelled: boolean;\n}\n\n/**\n * Streaming state tracks the progress of an active run\n * This is React-specific and not part of the SDK\n */\nexport interface StreamingState {\n  /** Current streaming status */\n  status: RunStatus;\n\n  /** Active run ID (if streaming) */\n  runId?: string;\n\n  /** Active message ID being streamed */\n  messageId?: string;\n\n  /** When the current run started */\n  startTime?: number;\n\n  /** When reasoning started (for duration calculation) */\n  reasoningStartTime?: number;\n\n  /** Error information if status is 'error' */\n  error?: {\n    message: string;\n    code?: string;\n  };\n}\n"]}

package/esm/v1/utils/component-renderer.test.js

@@ -1,6 +1,6 @@
 import React from "react";
 import { render, screen } from "@testing-library/react";
-import { useV1ComponentContent, V1ComponentContentProvider, } from "./component-renderer";
+import { useV1ComponentContent, V1ComponentContentProvider, } from "./component-renderer.js";
 // Test component that uses the content context
 const ContextAwareComponent = () => {
     const context = useV1ComponentContent();

package/esm/v1/utils/event-accumulator.d.ts

@@ -5,7 +5,8 @@
  * Used with useReducer to accumulate events into thread state.
  */
 import type { AGUIEvent } from "@ag-ui/core";
-import type { StreamingState, TamboV1Thread } from "../types/thread";
+import type { TamboV1Message } from "../types/message.js";
+import type { StreamingState, TamboV1Thread } from "../types/thread.js";
 /**
  * Error thrown when an unreachable case is reached in a switch statement.
  * This indicates a programming error where not all cases were handled.
@@ -38,7 +39,7 @@ export interface StreamState {
     /**
      * Current active thread ID (for UI context)
      */
-    currentThreadId: string | null;
+    currentThreadId: string;
 }
 /**
  * Event action - dispatches an AG-UI event to update thread state.
@@ -61,7 +62,7 @@ export interface InitThreadAction {
  */
 export interface SetCurrentThreadAction {
     type: "SET_CURRENT_THREAD";
-    threadId: string | null;
+    threadId: string;
 }
 /**
  * Start new thread action - atomically creates and switches to a new thread.
@@ -72,10 +73,33 @@ export interface StartNewThreadAction {
     threadId: string;
     initialThread?: Partial<TamboV1Thread>;
 }
+/**
+ * Load thread messages action - loads messages from API into stream state.
+ * Used when switching to an existing thread to populate its messages.
+ */
+export interface LoadThreadMessagesAction {
+    type: "LOAD_THREAD_MESSAGES";
+    threadId: string;
+    messages: TamboV1Message[];
+    /**
+     * If true, skip loading if the thread is currently streaming.
+     * This prevents overwriting in-flight streaming messages.
+     */
+    skipIfStreaming?: boolean;
+}
+/**
+ * Update thread title action - sets the title on a thread.
+ * Used after auto-generating a thread name via the API.
+ */
+export interface UpdateThreadTitleAction {
+    type: "UPDATE_THREAD_TITLE";
+    threadId: string;
+    title: string;
+}
 /**
  * Action type for the stream reducer.
  */
-export type StreamAction = EventAction | InitThreadAction | SetCurrentThreadAction | StartNewThreadAction;
+export type StreamAction = EventAction | InitThreadAction | SetCurrentThreadAction | StartNewThreadAction | LoadThreadMessagesAction | UpdateThreadTitleAction;
 /**
  * Create initial thread state for a new thread.
  * @param threadId - Unique thread identifier
@@ -83,7 +107,19 @@ export type StreamAction = EventAction | InitThreadAction | SetCurrentThreadActi
  */
 export declare function createInitialThreadState(threadId: string): ThreadState;
 /**
- * Create initial stream state with empty threadMap.
+ * Placeholder thread ID used for new threads before they get a real ID from the server.
+ * This allows optimistic UI updates (showing user messages immediately) before the
+ * server responds with the actual thread ID.
+ */
+export declare const PLACEHOLDER_THREAD_ID = "placeholder";
+/**
+ * Check if a thread ID is a placeholder (not a real API thread ID).
+ * @param threadId - Thread ID to check
+ * @returns True if this is a placeholder thread ID
+ */
+export declare function isPlaceholderThreadId(threadId: string | null | undefined): boolean;
+/**
+ * Create initial stream state with placeholder thread.
  * @returns Initial stream state
  */
 export declare function createInitialState(): StreamState;

package/esm/v1/utils/event-accumulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-accumulator.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/event-accumulator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EAYV,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,KAAK,EAAE,KAAK;CAIzB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvC;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,gBAAgB,GAChB,sBAAsB,GACtB,oBAAoB,CAAC;AASzB;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAatE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAKhD;AAuGD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,WAAW,CAwLb"}
+{"version":3,"file":"event-accumulator.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/event-accumulator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EAeV,MAAM,aAAa,CAAC;AAUrB,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrE;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,KAAK,EAAE,KAAK;CAIzB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEvC;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,gBAAgB,GAChB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,uBAAuB,CAAC;AAS5B;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CActE;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAOhD;AAuGD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,WAAW,CAiQb"}