@tambo-ai/react 1.0.3 → 1.2.0

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

@@ -49,7 +49,7 @@ const react_1 = __importStar(require("react"));
 const use_message_images_1 = require("../../hooks/use-message-images");
 const react_query_hooks_1 = require("../../hooks/react-query-hooks");
 const use_tambo_v1_send_message_1 = require("../hooks/use-tambo-v1-send-message");
-const event_accumulator_1 = require("../utils/event-accumulator");
+const client_1 = require("@tambo-ai/client");
 const use_tambo_v1_auth_state_1 = require("../hooks/use-tambo-v1-auth-state");
 const tambo_v1_stream_context_1 = require("./tambo-v1-stream-context");
 // Error messages for various input-related error scenarios.
@@ -108,7 +108,7 @@ function TamboThreadInputProvider({ children }) {
     // Use the current thread from stream state directly
     // Placeholder ID indicates a new thread should be created
     const currentThreadId = streamState.currentThreadId ?? undefined;
-    const isNewThread = (0, event_accumulator_1.isPlaceholderThreadId)(currentThreadId);
+    const isNewThread = (0, client_1.isPlaceholderThreadId)(currentThreadId);
     const sendMessage = (0, use_tambo_v1_send_message_1.useTamboSendMessage)(currentThreadId);
     const isIdentified = authState.status === "identified";
     const submitFn = (0, react_1.useCallback)(async (options) => {
@@ -117,6 +117,8 @@ function TamboThreadInputProvider({ children }) {
                 "Ensure a valid userKey or userToken is provided.");
         }
         const trimmedValue = inputValue.trim();
+        const valueAtSubmitTime = inputValue;
+        const imageIdsAtSubmitTime = imageState.images.map((image) => image.id);
         // Check if we have content to send
         if (!trimmedValue && imageState.images.length === 0) {
             throw new Error(exports.INPUT_ERROR_MESSAGES.EMPTY);
@@ -128,23 +130,37 @@ function TamboThreadInputProvider({ children }) {
         for (const image of imageState.images) {
             content.push(stagedImageToResourceContent(image));
         }
-        const result = await sendMessage.mutateAsync({
-            message: {
-                role: "user",
-                content,
-            },
-            userMessageText: trimmedValue, // Pass text for optimistic display
-            debug: options?.debug,
-            toolChoice: options?.toolChoice,
-        });
-        // Clear input and images after successful submission
+        // Optimistically clear submitted text so users can start typing the next
+        // message immediately while the current request is pending.
         setInputValue("");
-        imageState.clearImages();
-        // Update stream context's currentThreadId if a new thread was created
-        if (result.threadId && isNewThread) {
-            dispatch({ type: "SET_CURRENT_THREAD", threadId: result.threadId });
+        try {
+            const result = await sendMessage.mutateAsync({
+                message: {
+                    role: "user",
+                    content,
+                },
+                userMessageText: trimmedValue, // Pass text for optimistic display
+                debug: options?.debug,
+                toolChoice: options?.toolChoice,
+            });
+            // Clear only submitted images so images added while pending are kept.
+            if (imageIdsAtSubmitTime.length > 0) {
+                imageIdsAtSubmitTime.forEach((id) => {
+                    imageState.removeImage(id);
+                });
+            }
+            // 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;
+        }
+        catch (error) {
+            // If the user has not started typing a new message, restore the
+            // submitted value so failed sends don't silently lose input.
+            setInputValue((currentValue) => currentValue.length > 0 ? currentValue : valueAtSubmitTime);
+            throw error;
         }
-        return result;
     }, 
     // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).
     [inputValue, imageState, sendMessage, isNewThread, dispatch, isIdentified]);

package/dist/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":"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","sourcesContent":["\"use client\";\n\n/**\n * TamboThreadInputProvider - Shared Thread Input Context\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 TamboThreadInputProvider pattern from the legacy beta SDK.\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 { useTamboSendMessage } from \"../hooks/use-tambo-v1-send-message\";\nimport type { InputMessage } from \"../types/message\";\nimport type { ToolChoice } from \"../types/tool-choice\";\nimport { isPlaceholderThreadId } from \"../utils/event-accumulator\";\nimport { useTamboAuthState } from \"../hooks/use-tambo-v1-auth-state\";\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   * How the model should use tools. Defaults to \"auto\".\n   * - \"auto\": Model decides whether to use tools\n   * - \"required\": Model must use at least one tool\n   * - \"none\": Model cannot use tools\n   * - { name: \"toolName\" }: Model must use the specified tool\n   */\n  toolChoice?: ToolChoice;\n}\n\n/**\n * Context props for thread input state\n */\nexport interface TamboThreadInputContextProps 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  /** Whether the input should be disabled (pending submission or not authenticated) */\n  isDisabled: boolean;\n}\n\n/**\n * Context for thread input state.\n * @internal\n */\nexport const TamboThreadInputContext = createContext<\n  TamboThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components.\n *\n * This ensures that useTamboThreadInput, useTamboSuggestions, 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 TamboThreadInputProvider({ children }: PropsWithChildren) {\n  const [inputValue, setInputValue] = useState(\"\");\n  const imageState = useMessageImages();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n  const authState = useTamboAuthState();\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 = useTamboSendMessage(currentThreadId);\n\n  const isIdentified = authState.status === \"identified\";\n\n  const submitFn = useCallback(\n    async (\n      options?: SubmitOptions,\n    ): Promise<{ threadId: string | undefined }> => {\n      if (!isIdentified) {\n        throw new Error(\n          \"Cannot submit: authentication is not ready. \" +\n            \"Ensure a valid userKey or userToken is provided.\",\n        );\n      }\n\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        toolChoice: options?.toolChoice,\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, isIdentified],\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: TamboThreadInputContextProps = {\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    isDisabled: mutationState.isPending || !isIdentified,\n  };\n\n  return (\n    <TamboThreadInputContext.Provider value={contextValue}>\n      {children}\n    </TamboThreadInputContext.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 TamboThreadInputProvider\n * @example\n * ```tsx\n * function ChatInput() {\n *   const { value, setValue, submit, isPending } = useTamboThreadInput();\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 useTamboThreadInput(): TamboThreadInputContextProps {\n  const context = useContext(TamboThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboThreadInput must be used within TamboThreadInputProvider\",\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":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiKb,4DAkHC;AA2BD,kDAQC;AApTD;;;;;;;GAOG;AAEH,+CAMe;AACf,uEAGwC;AACxC,qEAGuC;AACvC,kFAAyE;AAGzE,6CAAyD;AACzD,8EAAqE;AACrE,uEAA8E;AAE9E,4DAA4D;AAC5D,8EAA8E;AAC9E,4EAA4E;AAC5E,+CAA+C;AAClC,QAAA,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,4BAAoB,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,4BAAoB,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,4BAAoB,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;AAwED;;;GAGG;AACU,QAAA,uBAAuB,GAAG,IAAA,qBAAa,EAElD,SAAS,CAAC,CAAC;AAEb;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAqB;IACtE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,IAAA,gBAAQ,EAAC,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAA,qCAAgB,GAAE,CAAC;IACtC,MAAM,WAAW,GAAG,IAAA,wCAAc,GAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAA,2CAAiB,GAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAA,2CAAiB,GAAE,CAAC;IAEtC,oDAAoD;IACpD,0DAA0D;IAC1D,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,IAAI,SAAS,CAAC;IACjE,MAAM,WAAW,GAAG,IAAA,8BAAqB,EAAC,eAAe,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,IAAA,+CAAmB,EAAC,eAAe,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,KAAK,YAAY,CAAC;IAEvD,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAC1B,KAAK,EACH,OAAuB,EACoB,EAAE;QAC7C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,8CAA8C;gBAC5C,kDAAkD,CACrD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,iBAAiB,GAAG,UAAU,CAAC;QACrC,MAAM,oBAAoB,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAExE,mCAAmC;QACnC,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,4BAAoB,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,yEAAyE;QACzE,4DAA4D;QAC5D,aAAa,CAAC,EAAE,CAAC,CAAC;QAElB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC;gBAC3C,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,OAAO;iBACR;gBACD,eAAe,EAAE,YAAY,EAAE,mCAAmC;gBAClE,KAAK,EAAE,OAAO,EAAE,KAAK;gBACrB,UAAU,EAAE,OAAO,EAAE,UAAU;aAChC,CAAC,CAAC;YAEH,sEAAsE;YACtE,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,oBAAoB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;oBAClC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC7B,CAAC,CAAC,CAAC;YACL,CAAC;YAED,sEAAsE;YACtE,IAAI,MAAM,CAAC,QAAQ,IAAI,WAAW,EAAE,CAAC;gBACnC,QAAQ,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gEAAgE;YAChE,6DAA6D;YAC7D,aAAa,CAAC,CAAC,YAAY,EAAE,EAAE,CAC7B,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAC3D,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,mFAAmF;IACnF,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAC3E,CAAC;IAEF,MAAM,EACJ,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,aAAa,EACrB,GAAG,aAAa,EACjB,GAAG,IAAA,oCAAgB,EAAC;QACnB,WAAW,EAAE,CAAC,iBAAiB,EAAE,eAAe,CAAC;QACjD,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAiC;QACjD,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,eAAe;QACzB,UAAU,EAAE,aAAa,CAAC,SAAS,IAAI,CAAC,YAAY;KACrD,CAAC;IAEF,OAAO,CACL,8BAAC,+BAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,IAClD,QAAQ,CACwB,CACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,mBAAmB;IACjC,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,+BAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["\"use client\";\n\n/**\n * TamboThreadInputProvider - Shared Thread Input Context\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 TamboThreadInputProvider pattern from the legacy beta SDK.\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 { useTamboSendMessage } from \"../hooks/use-tambo-v1-send-message\";\nimport type { InputMessage } from \"../types/message\";\nimport type { ToolChoice } from \"@tambo-ai/client\";\nimport { isPlaceholderThreadId } from \"@tambo-ai/client\";\nimport { useTamboAuthState } from \"../hooks/use-tambo-v1-auth-state\";\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   * How the model should use tools. Defaults to \"auto\".\n   * - \"auto\": Model decides whether to use tools\n   * - \"required\": Model must use at least one tool\n   * - \"none\": Model cannot use tools\n   * - { name: \"toolName\" }: Model must use the specified tool\n   */\n  toolChoice?: ToolChoice;\n}\n\n/**\n * Context props for thread input state\n */\nexport interface TamboThreadInputContextProps 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  /** Whether the input should be disabled (pending submission or not authenticated) */\n  isDisabled: boolean;\n}\n\n/**\n * Context for thread input state.\n * @internal\n */\nexport const TamboThreadInputContext = createContext<\n  TamboThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components.\n *\n * This ensures that useTamboThreadInput, useTamboSuggestions, 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 TamboThreadInputProvider({ children }: PropsWithChildren) {\n  const [inputValue, setInputValue] = useState(\"\");\n  const imageState = useMessageImages();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n  const authState = useTamboAuthState();\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 = useTamboSendMessage(currentThreadId);\n\n  const isIdentified = authState.status === \"identified\";\n\n  const submitFn = useCallback(\n    async (\n      options?: SubmitOptions,\n    ): Promise<{ threadId: string | undefined }> => {\n      if (!isIdentified) {\n        throw new Error(\n          \"Cannot submit: authentication is not ready. \" +\n            \"Ensure a valid userKey or userToken is provided.\",\n        );\n      }\n\n      const trimmedValue = inputValue.trim();\n      const valueAtSubmitTime = inputValue;\n      const imageIdsAtSubmitTime = imageState.images.map((image) => image.id);\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      // Optimistically clear submitted text so users can start typing the next\n      // message immediately while the current request is pending.\n      setInputValue(\"\");\n\n      try {\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          toolChoice: options?.toolChoice,\n        });\n\n        // Clear only submitted images so images added while pending are kept.\n        if (imageIdsAtSubmitTime.length > 0) {\n          imageIdsAtSubmitTime.forEach((id) => {\n            imageState.removeImage(id);\n          });\n        }\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      } catch (error) {\n        // If the user has not started typing a new message, restore the\n        // submitted value so failed sends don't silently lose input.\n        setInputValue((currentValue) =>\n          currentValue.length > 0 ? currentValue : valueAtSubmitTime,\n        );\n        throw error;\n      }\n    },\n    // `stagedImageToResourceContent` is a pure module-level helper (not a hook value).\n    [inputValue, imageState, sendMessage, isNewThread, dispatch, isIdentified],\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: TamboThreadInputContextProps = {\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    isDisabled: mutationState.isPending || !isIdentified,\n  };\n\n  return (\n    <TamboThreadInputContext.Provider value={contextValue}>\n      {children}\n    </TamboThreadInputContext.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 TamboThreadInputProvider\n * @example\n * ```tsx\n * function ChatInput() {\n *   const { value, setValue, submit, isPending } = useTamboThreadInput();\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 useTamboThreadInput(): TamboThreadInputContextProps {\n  const context = useContext(TamboThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboThreadInput must be used within TamboThreadInputProvider\",\n    );\n  }\n  return context;\n}\n"]}

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@ag-ui/core");
-const event_1 = require("./event");
+const client_1 = require("@tambo-ai/client");
 describe("isTamboCustomEvent", () => {
     it("returns true for tambo.component.start event", () => {
         const event = {
@@ -9,7 +9,7 @@ describe("isTamboCustomEvent", () => {
             name: "tambo.component.start",
             value: { messageId: "msg1", componentId: "comp1", componentName: "Test" },
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(true);
     });
     it("returns true for tambo.component.props_delta event", () => {
         const event = {
@@ -17,7 +17,7 @@ describe("isTamboCustomEvent", () => {
             name: "tambo.component.props_delta",
             value: { componentId: "comp1", operations: [] },
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(true);
     });
     it("returns true for tambo.component.state_delta event", () => {
         const event = {
@@ -25,7 +25,7 @@ describe("isTamboCustomEvent", () => {
             name: "tambo.component.state_delta",
             value: { componentId: "comp1", operations: [] },
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(true);
     });
     it("returns true for tambo.component.end event", () => {
         const event = {
@@ -33,7 +33,7 @@ describe("isTamboCustomEvent", () => {
             name: "tambo.component.end",
             value: { componentId: "comp1" },
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(true);
     });
     it("returns true for tambo.run.awaiting_input event", () => {
         const event = {
@@ -45,7 +45,7 @@ describe("isTamboCustomEvent", () => {
                 ],
             },
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(true);
     });
     it("returns true for tambo.message.parent event", () => {
         const event = {
@@ -53,7 +53,7 @@ describe("isTamboCustomEvent", () => {
             name: "tambo.message.parent",
             value: { messageId: "msg1", parentMessageId: "parent1" },
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(true);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(true);
     });
     it("returns false for unknown custom event name", () => {
         const event = {
@@ -61,11 +61,11 @@ describe("isTamboCustomEvent", () => {
             name: "unknown.event",
             value: {},
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(false);
     });
     it("returns false when name is undefined", () => {
         const event = {};
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(false);
     });
     it("returns false when name is not a string", () => {
         const event = {
@@ -73,10 +73,10 @@ describe("isTamboCustomEvent", () => {
             name: 123,
             value: {},
         };
-        expect((0, event_1.isTamboCustomEvent)(event)).toBe(false);
+        expect((0, client_1.isTamboCustomEvent)(event)).toBe(false);
     });
     it("returns false for empty object", () => {
-        expect((0, event_1.isTamboCustomEvent)({})).toBe(false);
+        expect((0, client_1.isTamboCustomEvent)({})).toBe(false);
     });
 });
 describe("asTamboCustomEvent", () => {
@@ -87,7 +87,7 @@ describe("asTamboCustomEvent", () => {
             value: { messageId: "msg1", parentMessageId: "parent1" },
             timestamp: 1234,
         };
-        const result = (0, event_1.asTamboCustomEvent)(event);
+        const result = (0, client_1.asTamboCustomEvent)(event);
         expect(result).toBeDefined();
         expect(result?.name).toBe("tambo.message.parent");
     });
@@ -98,7 +98,7 @@ describe("asTamboCustomEvent", () => {
             value: {},
             timestamp: 1234,
         };
-        expect((0, event_1.asTamboCustomEvent)(event)).toBeUndefined();
+        expect((0, client_1.asTamboCustomEvent)(event)).toBeUndefined();
     });
 });
 //# sourceMappingURL=event.test.js.map

package/dist/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, type CustomEvent } from \"@ag-ui/core\";\nimport { asTamboCustomEvent, 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 true for tambo.message.parent event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.message.parent\",\n      value: { messageId: \"msg1\", parentMessageId: \"parent1\" },\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\ndescribe(\"asTamboCustomEvent\", () => {\n  it(\"casts tambo.message.parent event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.message.parent\",\n      value: { messageId: \"msg1\", parentMessageId: \"parent1\" },\n      timestamp: 1234,\n    } as CustomEvent;\n\n    const result = asTamboCustomEvent(event);\n    expect(result).toBeDefined();\n    expect(result?.name).toBe(\"tambo.message.parent\");\n  });\n\n  it(\"returns undefined for unknown event name\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"unknown.event\",\n      value: {},\n      timestamp: 1234,\n    } as CustomEvent;\n\n    expect(asTamboCustomEvent(event)).toBeUndefined();\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, type CustomEvent } from \"@ag-ui/core\";\nimport { asTamboCustomEvent, isTamboCustomEvent } from \"@tambo-ai/client\";\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 true for tambo.message.parent event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.message.parent\",\n      value: { messageId: \"msg1\", parentMessageId: \"parent1\" },\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\ndescribe(\"asTamboCustomEvent\", () => {\n  it(\"casts tambo.message.parent event\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"tambo.message.parent\",\n      value: { messageId: \"msg1\", parentMessageId: \"parent1\" },\n      timestamp: 1234,\n    } as CustomEvent;\n\n    const result = asTamboCustomEvent(event);\n    expect(result).toBeDefined();\n    expect(result?.name).toBe(\"tambo.message.parent\");\n  });\n\n  it(\"returns undefined for unknown event name\", () => {\n    const event = {\n      type: EventType.CUSTOM,\n      name: \"unknown.event\",\n      value: {},\n      timestamp: 1234,\n    } as CustomEvent;\n\n    expect(asTamboCustomEvent(event)).toBeUndefined();\n  });\n});\n"]}

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

@@ -1,128 +1,31 @@
-/**
- * Message and Content Types
- *
- * Re-exports message and content types from `@tambo-ai/typescript-sdk`.
- * Messages use Anthropic-style content blocks pattern where a message
- * contains an array of content blocks (text, tool calls, tool results, components).
- */
 import type { ReactElement } from "react";
-export type { TextContent, ToolResultContent, ResourceContent, } from "@tambo-ai/typescript-sdk/resources/threads/threads";
-export type { InputMessage } from "@tambo-ai/typescript-sdk/resources/threads/runs";
-import type { RunCreateParams } from "@tambo-ai/typescript-sdk/resources/threads/runs";
-/**
- * Message type for initial messages that seed a new thread.
- * Supports system and assistant roles in addition to user,
- * and restricts content to text and resource blocks (no tool results).
- */
-export type InitialInputMessage = RunCreateParams.Thread.InitialMessage;
-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";
-/**
- * Streaming state for component content blocks.
- * Tracks the lifecycle of component prop/state streaming.
- */
-export type ComponentStreamingState = "started" | "streaming" | "done";
+import type { TamboComponentContent as BaseTamboComponentContent, TextContent, TamboToolUseContent, ToolResultContent, ResourceContent } from "@tambo-ai/client";
+import type { TamboThreadMessage as BaseTamboThreadMessage } from "@tambo-ai/client";
+export type { TextContent, ToolResultContent, ResourceContent, InputMessage, InitialInputMessage, MessageListResponse, MessageGetResponse, ComponentStreamingState, TamboToolDisplayProps, TamboToolUseContent, MessageRole, TamboThreadMessage, } from "@tambo-ai/client";
 /**
  * Extended ComponentContent with streaming state and rendered element.
- * Used by the SDK to track component rendering lifecycle.
+ * Used by the React SDK to track component rendering lifecycle.
+ *
+ * Extends the base client TamboComponentContent with the React-specific
+ * `renderedComponent` field.
  */
-export interface TamboComponentContent extends ComponentContent {
-    /**
-     * Current streaming state of this component's props.
-     * - '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;
+export interface TamboComponentContent extends BaseTamboComponentContent {
     /**
      * 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 {
-    /** 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 SDK to provide pre-computed tool state to consumers.
- *
- * Note: The computed properties are populated by `useTambo()` hook.
- * When accessed via lower-level APIs, they may be undefined.
- */
-export interface TamboToolUseContent 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 `useTambo()` 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 `useTambo()`.
-     */
-    statusMessage?: string;
-    /**
-     * Extracted Tambo display properties from the tool input.
-     * Consumers can use these for custom rendering if needed.
-     * Computed by `useTambo()`.
-     */
-    tamboDisplayProps?: TamboToolDisplayProps;
-}
-/**
- * Message role (from SDK)
- * Includes 'system' to accommodate messages loaded from API.
- */
-export type MessageRole = "user" | "assistant" | "system";
 /**
  * Union type of all content block types.
- * Uses TamboComponentContent and TamboToolUseContent which include computed state.
+ * Uses React-specific TamboComponentContent which includes renderedComponent.
  */
 export type Content = TextContent | TamboToolUseContent | ToolResultContent | TamboComponentContent | ResourceContent;
 /**
- * Message in a thread (simplified from SDK's MessageGetResponse)
+ * React-specific thread message type where component content blocks
+ * include `renderedComponent`. Returned by `useTambo().messages`.
  */
-export interface TamboThreadMessage {
-    /** Unique message identifier */
-    id: string;
-    /** Message role (user or assistant) */
-    role: MessageRole;
-    /** Content blocks in the message */
+export interface ReactTamboThreadMessage extends BaseTamboThreadMessage {
     content: Content[];
-    /** When the message was created (optional for historical messages loaded from API) */
-    createdAt?: string;
-    /** Message metadata */
-    metadata?: Record<string, unknown>;
-    /**
-     * The id of the parent message, if this message was created during
-     * generation of another message (e.g., MCP sampling or elicitation).
-     */
-    parentMessageId?: string;
-    /**
-     * 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/dist/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;AAK1C,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,oDAAoD,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC;AAExE,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,qBAAsB,SAAQ,gBAAgB;IAC7D;;;;;;;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,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACxE;;;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,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,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;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EACV,qBAAqB,IAAI,yBAAyB,EAClD,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAErF,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,mBAAmB,GACnB,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB"}

package/dist/v1/types/message.js

@@ -1,10 +1,3 @@
 "use strict";
-/**
- * Message and Content Types
- *
- * Re-exports message and content types from `@tambo-ai/typescript-sdk`.
- * Messages use Anthropic-style content blocks pattern where a message
- * contains an array of content blocks (text, tool calls, tool results, components).
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=message.js.map

package/dist/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\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 TamboToolUseContent\n// and TamboComponentContent 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\";\nimport type { RunCreateParams } from \"@tambo-ai/typescript-sdk/resources/threads/runs\";\n\n/**\n * Message type for initial messages that seed a new thread.\n * Supports system and assistant roles in addition to user,\n * and restricts content to text and resource blocks (no tool results).\n */\nexport type InitialInputMessage = RunCreateParams.Thread.InitialMessage;\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 SDK to track component rendering lifecycle.\n */\nexport interface TamboComponentContent 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  /** 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 SDK to provide pre-computed tool state to consumers.\n *\n * Note: The computed properties are populated by `useTambo()` hook.\n * When accessed via lower-level APIs, they may be undefined.\n */\nexport interface TamboToolUseContent 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 `useTambo()` 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 `useTambo()`.\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 `useTambo()`.\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 TamboComponentContent and TamboToolUseContent which include computed state.\n */\nexport type Content =\n  | TextContent\n  | TamboToolUseContent\n  | ToolResultContent\n  | TamboComponentContent\n  | ResourceContent;\n\n/**\n * Message in a thread (simplified from SDK's MessageGetResponse)\n */\nexport interface TamboThreadMessage {\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   * The id of the parent message, if this message was created during\n   * generation of another message (e.g., MCP sampling or elicitation).\n   */\n  parentMessageId?: string;\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"]}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/v1/types/message.ts"],"names":[],"mappings":"","sourcesContent":["// Re-exported from @tambo-ai/client, with React-specific extension for TamboComponentContent\nimport type { ReactElement } from \"react\";\nimport type {\n  TamboComponentContent as BaseTamboComponentContent,\n  TextContent,\n  TamboToolUseContent,\n  ToolResultContent,\n  ResourceContent,\n} from \"@tambo-ai/client\";\n\nimport type { TamboThreadMessage as BaseTamboThreadMessage } from \"@tambo-ai/client\";\n\nexport type {\n  TextContent,\n  ToolResultContent,\n  ResourceContent,\n  InputMessage,\n  InitialInputMessage,\n  MessageListResponse,\n  MessageGetResponse,\n  ComponentStreamingState,\n  TamboToolDisplayProps,\n  TamboToolUseContent,\n  MessageRole,\n  TamboThreadMessage,\n} from \"@tambo-ai/client\";\n\n/**\n * Extended ComponentContent with streaming state and rendered element.\n * Used by the React SDK to track component rendering lifecycle.\n *\n * Extends the base client TamboComponentContent with the React-specific\n * `renderedComponent` field.\n */\nexport interface TamboComponentContent extends BaseTamboComponentContent {\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 * Union type of all content block types.\n * Uses React-specific TamboComponentContent which includes renderedComponent.\n */\nexport type Content =\n  | TextContent\n  | TamboToolUseContent\n  | ToolResultContent\n  | TamboComponentContent\n  | ResourceContent;\n\n/**\n * React-specific thread message type where component content blocks\n * include `renderedComponent`. Returned by `useTambo().messages`.\n */\nexport interface ReactTamboThreadMessage extends BaseTamboThreadMessage {\n  content: Content[];\n}\n"]}