@tambo-ai/react 0.71.0 → 0.73.0

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

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

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

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

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

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

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

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

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

@@ -5,18 +5,43 @@
  * 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, ToolUseContent, ToolResultContent, ComponentContent, 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";
+/**
+ * Streaming state for component content blocks.
+ * Tracks the lifecycle of component prop/state streaming.
+ */
+export type ComponentStreamingState = "started" | "streaming" | "done";
+/**
+ * Extended ComponentContent with streaming state and rendered element.
+ * Used by the v1 SDK to track component rendering lifecycle.
+ */
+export interface V1ComponentContent 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
+     */
+    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;
+}
 /**
  * Message role (from SDK)
  */
 export type MessageRole = "user" | "assistant";
 /**
- * Union type of all content block types
+ * Union type of all content block types.
+ * Uses V1ComponentContent which includes streaming state and rendered component.
  */
-export type Content = TextContent | ToolUseContent | ToolResultContent | ComponentContent | ResourceContent;
+export type Content = TextContent | ToolUseContent | ToolResultContent | V1ComponentContent | ResourceContent;
 /**
  * Message in a thread (simplified from SDK's MessageGetResponse)
  */

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;AAGH,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;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,WAAW,GACX,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,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;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"}

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 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\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 * Message role (from SDK)\n */\nexport type MessageRole = \"user\" | \"assistant\";\n\n/**\n * Union type of all content block types\n */\nexport type Content =\n  | TextContent\n  | ToolUseContent\n  | ToolResultContent\n  | ComponentContent\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\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"]}

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

@@ -0,0 +1,37 @@
+/**
+ * Component Renderer Utility for v1 API
+ *
+ * Provides the component content context for rendered components.
+ * Components can use useV1ComponentContent() to access their context.
+ */
+import React from "react";
+/**
+ * Context for component content blocks.
+ * Provides access to the component ID and thread ID for component state hooks.
+ */
+export interface V1ComponentContentContext {
+    /** Component instance ID */
+    componentId: string;
+    /** Thread ID the component belongs to */
+    threadId: string;
+    /** Message ID the component belongs to */
+    messageId: string;
+    /** Component name */
+    componentName: string;
+}
+/**
+ * Provider for component content context.
+ * Wraps rendered components to provide access to component metadata.
+ * @returns Provider component with memoized context value
+ */
+export declare function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }: V1ComponentContentContext & {
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * Hook to access the current component content context.
+ * Must be used within a rendered component.
+ * @returns Component content context
+ * @throws {Error} If used outside a rendered component
+ */
+export declare function useV1ComponentContent(): V1ComponentContentContext;
+//# sourceMappingURL=component-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,GACd,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAY3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,yBAAyB,CAQjE"}

package/dist/v1/utils/component-renderer.js

@@ -0,0 +1,70 @@
+"use strict";
+"use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1ComponentContentProvider = V1ComponentContentProvider;
+exports.useV1ComponentContent = useV1ComponentContent;
+/**
+ * Component Renderer Utility for v1 API
+ *
+ * Provides the component content context for rendered components.
+ * Components can use useV1ComponentContent() to access their context.
+ */
+const react_1 = __importStar(require("react"));
+const ComponentContentContext = (0, react_1.createContext)(null);
+/**
+ * Provider for component content context.
+ * Wraps rendered components to provide access to component metadata.
+ * @returns Provider component with memoized context value
+ */
+function V1ComponentContentProvider({ children, componentId, threadId, messageId, componentName, }) {
+    // Memoize context value to prevent unnecessary re-renders of consumers
+    const value = (0, react_1.useMemo)(() => ({ componentId, threadId, messageId, componentName }), [componentId, threadId, messageId, componentName]);
+    return (react_1.default.createElement(ComponentContentContext.Provider, { value: value }, children));
+}
+/**
+ * Hook to access the current component content context.
+ * Must be used within a rendered component.
+ * @returns Component content context
+ * @throws {Error} If used outside a rendered component
+ */
+function useV1ComponentContent() {
+    const context = (0, react_1.useContext)(ComponentContentContext);
+    if (!context) {
+        throw new Error("useV1ComponentContent must be used within a rendered component");
+    }
+    return context;
+}
+//# sourceMappingURL=component-renderer.js.map

package/dist/v1/utils/component-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-renderer.js","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCb,gEAkBC;AAQD,sDAQC;AAnED;;;;;GAKG;AAEH,+CAAkE;AAiBlE,MAAM,uBAAuB,GAAG,IAAA,qBAAa,EAC3C,IAAI,CACL,CAAC;AAEF;;;;GAIG;AACH,SAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,GAC6C;IAC1D,uEAAuE;IACvE,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAC3D,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,CAClD,CAAC;IAEF,OAAO,CACL,8BAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IAC3C,QAAQ,CACwB,CACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["\"use client\";\n\n/**\n * Component Renderer Utility for v1 API\n *\n * Provides the component content context for rendered components.\n * Components can use useV1ComponentContent() to access their context.\n */\n\nimport React, { createContext, useContext, useMemo } from \"react\";\n\n/**\n * Context for component content blocks.\n * Provides access to the component ID and thread ID for component state hooks.\n */\nexport interface V1ComponentContentContext {\n  /** Component instance ID */\n  componentId: string;\n  /** Thread ID the component belongs to */\n  threadId: string;\n  /** Message ID the component belongs to */\n  messageId: string;\n  /** Component name */\n  componentName: string;\n}\n\nconst ComponentContentContext = createContext<V1ComponentContentContext | null>(\n  null,\n);\n\n/**\n * Provider for component content context.\n * Wraps rendered components to provide access to component metadata.\n * @returns Provider component with memoized context value\n */\nexport function V1ComponentContentProvider({\n  children,\n  componentId,\n  threadId,\n  messageId,\n  componentName,\n}: V1ComponentContentContext & { children: React.ReactNode }) {\n  // Memoize context value to prevent unnecessary re-renders of consumers\n  const value = useMemo(\n    () => ({ componentId, threadId, messageId, componentName }),\n    [componentId, threadId, messageId, componentName],\n  );\n\n  return (\n    <ComponentContentContext.Provider value={value}>\n      {children}\n    </ComponentContentContext.Provider>\n  );\n}\n\n/**\n * Hook to access the current component content context.\n * Must be used within a rendered component.\n * @returns Component content context\n * @throws {Error} If used outside a rendered component\n */\nexport function useV1ComponentContent(): V1ComponentContentContext {\n  const context = useContext(ComponentContentContext);\n  if (!context) {\n    throw new Error(\n      \"useV1ComponentContent must be used within a rendered component\",\n    );\n  }\n  return context;\n}\n"]}

package/dist/v1/utils/component-renderer.test.d.ts

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

package/dist/v1/utils/component-renderer.test.d.ts.map

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

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

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const react_2 = require("@testing-library/react");
+const component_renderer_1 = require("./component-renderer");
+// Test component that uses the content context
+const ContextAwareComponent = () => {
+    const context = (0, component_renderer_1.useV1ComponentContent)();
+    return (react_1.default.createElement("div", { "data-testid": "context-aware" },
+        react_1.default.createElement("span", { "data-testid": "componentId" }, context.componentId),
+        react_1.default.createElement("span", { "data-testid": "threadId" }, context.threadId),
+        react_1.default.createElement("span", { "data-testid": "messageId" }, context.messageId),
+        react_1.default.createElement("span", { "data-testid": "componentName" }, context.componentName)));
+};
+describe("V1ComponentContentProvider", () => {
+    it("provides context to child components", () => {
+        (0, react_2.render)(react_1.default.createElement(component_renderer_1.V1ComponentContentProvider, { componentId: "comp_123", threadId: "thread_456", messageId: "msg_789", componentName: "TestComponent" },
+            react_1.default.createElement(ContextAwareComponent, null)));
+        expect(react_2.screen.getByTestId("componentId")).toHaveTextContent("comp_123");
+        expect(react_2.screen.getByTestId("threadId")).toHaveTextContent("thread_456");
+        expect(react_2.screen.getByTestId("messageId")).toHaveTextContent("msg_789");
+        expect(react_2.screen.getByTestId("componentName")).toHaveTextContent("TestComponent");
+    });
+});
+describe("useV1ComponentContent", () => {
+    it("throws when used outside provider", () => {
+        function TestConsumer() {
+            (0, component_renderer_1.useV1ComponentContent)();
+            return react_1.default.createElement("div", null, "Should not render");
+        }
+        // Suppress React error boundary logs
+        const consoleSpy = jest.spyOn(console, "error").mockImplementation();
+        expect(() => (0, react_2.render)(react_1.default.createElement(TestConsumer, null))).toThrow("useV1ComponentContent must be used within a rendered component");
+        consoleSpy.mockRestore();
+    });
+    it("returns context when used within provider", () => {
+        (0, react_2.render)(react_1.default.createElement(component_renderer_1.V1ComponentContentProvider, { componentId: "comp_test", threadId: "thread_test", messageId: "msg_test", componentName: "TestComp" },
+            react_1.default.createElement(ContextAwareComponent, null)));
+        expect(react_2.screen.getByTestId("componentId")).toHaveTextContent("comp_test");
+    });
+});
+//# sourceMappingURL=component-renderer.test.js.map

package/dist/v1/utils/component-renderer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-renderer.test.js","sourceRoot":"","sources":["../../../src/v1/utils/component-renderer.test.tsx"],"names":[],"mappings":";;;;;AAAA,kDAA0B;AAC1B,kDAAwD;AACxD,6DAG8B;AAE9B,+CAA+C;AAC/C,MAAM,qBAAqB,GAAa,GAAG,EAAE;IAC3C,MAAM,OAAO,GAAG,IAAA,0CAAqB,GAAE,CAAC;IACxC,OAAO,CACL,sDAAiB,eAAe;QAC9B,uDAAkB,aAAa,IAAE,OAAO,CAAC,WAAW,CAAQ;QAC5D,uDAAkB,UAAU,IAAE,OAAO,CAAC,QAAQ,CAAQ;QACtD,uDAAkB,WAAW,IAAE,OAAO,CAAC,SAAS,CAAQ;QACxD,uDAAkB,eAAe,IAAE,OAAO,CAAC,aAAa,CAAQ,CAC5D,CACP,CAAC;AACJ,CAAC,CAAC;AAEF,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,IAAA,cAAM,EACJ,8BAAC,+CAA0B,IACzB,WAAW,EAAC,UAAU,EACtB,QAAQ,EAAC,YAAY,EACrB,SAAS,EAAC,SAAS,EACnB,aAAa,EAAC,eAAe;YAE7B,8BAAC,qBAAqB,OAAG,CACE,CAC9B,CAAC;QAEF,MAAM,CAAC,cAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,CAAC,cAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACvE,MAAM,CAAC,cAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACrE,MAAM,CAAC,cAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAC3D,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,SAAS,YAAY;YACnB,IAAA,0CAAqB,GAAE,CAAC;YACxB,OAAO,+DAA4B,CAAC;QACtC,CAAC;QAED,qCAAqC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAErE,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,cAAM,EAAC,8BAAC,YAAY,OAAG,CAAC,CAAC,CAAC,OAAO,CAC5C,gEAAgE,CACjE,CAAC;QAEF,UAAU,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,IAAA,cAAM,EACJ,8BAAC,+CAA0B,IACzB,WAAW,EAAC,WAAW,EACvB,QAAQ,EAAC,aAAa,EACtB,SAAS,EAAC,UAAU,EACpB,aAAa,EAAC,UAAU;YAExB,8BAAC,qBAAqB,OAAG,CACE,CAC9B,CAAC;QAEF,MAAM,CAAC,cAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import React from \"react\";\nimport { render, screen } from \"@testing-library/react\";\nimport {\n  useV1ComponentContent,\n  V1ComponentContentProvider,\n} from \"./component-renderer\";\n\n// Test component that uses the content context\nconst ContextAwareComponent: React.FC = () => {\n  const context = useV1ComponentContent();\n  return (\n    <div data-testid=\"context-aware\">\n      <span data-testid=\"componentId\">{context.componentId}</span>\n      <span data-testid=\"threadId\">{context.threadId}</span>\n      <span data-testid=\"messageId\">{context.messageId}</span>\n      <span data-testid=\"componentName\">{context.componentName}</span>\n    </div>\n  );\n};\n\ndescribe(\"V1ComponentContentProvider\", () => {\n  it(\"provides context to child components\", () => {\n    render(\n      <V1ComponentContentProvider\n        componentId=\"comp_123\"\n        threadId=\"thread_456\"\n        messageId=\"msg_789\"\n        componentName=\"TestComponent\"\n      >\n        <ContextAwareComponent />\n      </V1ComponentContentProvider>,\n    );\n\n    expect(screen.getByTestId(\"componentId\")).toHaveTextContent(\"comp_123\");\n    expect(screen.getByTestId(\"threadId\")).toHaveTextContent(\"thread_456\");\n    expect(screen.getByTestId(\"messageId\")).toHaveTextContent(\"msg_789\");\n    expect(screen.getByTestId(\"componentName\")).toHaveTextContent(\n      \"TestComponent\",\n    );\n  });\n});\n\ndescribe(\"useV1ComponentContent\", () => {\n  it(\"throws when used outside provider\", () => {\n    function TestConsumer() {\n      useV1ComponentContent();\n      return <div>Should not render</div>;\n    }\n\n    // Suppress React error boundary logs\n    const consoleSpy = jest.spyOn(console, \"error\").mockImplementation();\n\n    expect(() => render(<TestConsumer />)).toThrow(\n      \"useV1ComponentContent must be used within a rendered component\",\n    );\n\n    consoleSpy.mockRestore();\n  });\n\n  it(\"returns context when used within provider\", () => {\n    render(\n      <V1ComponentContentProvider\n        componentId=\"comp_test\"\n        threadId=\"thread_test\"\n        messageId=\"msg_test\"\n        componentName=\"TestComp\"\n      >\n        <ContextAwareComponent />\n      </V1ComponentContentProvider>,\n    );\n\n    expect(screen.getByTestId(\"componentId\")).toHaveTextContent(\"comp_test\");\n  });\n});\n"]}