@tambo-ai/react 0.73.0 → 0.74.0

package/esm/providers/tambo-interactables-additional-context-edge-cases.test.js

@@ -1,10 +1,10 @@
 import { render, waitFor } from "@testing-library/react";
 import React from "react";
 import { z } from "zod/v4";
-import { withTamboInteractable } from "../hoc/with-tambo-interactable";
-import { TamboContextHelpersProvider, useTamboContextHelpers, } from "./tambo-context-helpers-provider";
-import { TamboInteractableProvider } from "./tambo-interactable-provider";
-import { TamboStubProvider } from "./tambo-stubs";
+import { withTamboInteractable } from "../hoc/with-tambo-interactable.js";
+import { TamboContextHelpersProvider, useTamboContextHelpers, } from "./tambo-context-helpers-provider.js";
+import { TamboInteractableProvider } from "./tambo-interactable-provider.js";
+import { TamboStubProvider } from "./tambo-stubs.js";
 function wrapperWithProviders(children) {
     const thread = {
         id: "t-1",

package/esm/providers/tambo-interactables-additional-context.test.js

@@ -1,10 +1,10 @@
 import { render, waitFor } from "@testing-library/react";
 import React from "react";
 import { z } from "zod/v4";
-import { withTamboInteractable } from "../hoc/with-tambo-interactable";
-import { TamboContextHelpersProvider, useTamboContextHelpers, } from "./tambo-context-helpers-provider";
-import { TamboInteractableProvider, useCurrentInteractablesSnapshot, } from "./tambo-interactable-provider";
-import { TamboStubProvider } from "./tambo-stubs";
+import { withTamboInteractable } from "../hoc/with-tambo-interactable.js";
+import { TamboContextHelpersProvider, useTamboContextHelpers, } from "./tambo-context-helpers-provider.js";
+import { TamboInteractableProvider, useCurrentInteractablesSnapshot, } from "./tambo-interactable-provider.js";
+import { TamboStubProvider } from "./tambo-stubs.js";
 function wrapperWithProviders(children) {
     const thread = {
         id: "t-1",

package/esm/providers/tambo-mcp-token-provider.js

@@ -1,7 +1,7 @@
 "use client";
 import React, { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
-import { TamboClientContext } from "./tambo-client-provider";
-import { PLACEHOLDER_THREAD, TamboThreadContext, } from "./tambo-thread-provider";
+import { TamboClientContext } from "./tambo-client-provider.js";
+import { PLACEHOLDER_THREAD, TamboThreadContext, } from "./tambo-thread-provider.js";
 const TamboMcpTokenContext = createContext(undefined);
 /**
  * Provider for managing the MCP access token that is returned by the Tambo API.

package/esm/providers/tambo-prop-stream-provider/index.d.ts

@@ -7,13 +7,13 @@
 export declare const TamboPropStreamProvider: import("react").FC<{
     children?: import("react").ReactNode | undefined;
 }> & {
-    Streaming: import("react").FC<import("./types").StreamStateComponentProps>;
-    Pending: import("react").FC<import("./types").StreamStateComponentProps>;
-    Success: import("react").FC<import("./types").StreamStateComponentProps>;
+    Streaming: import("react").FC<import("./types.js").StreamStateComponentProps>;
+    Pending: import("react").FC<import("./types.js").StreamStateComponentProps>;
+    Success: import("react").FC<import("./types.js").StreamStateComponentProps>;
 };
-export { Pending } from "./pending";
-export { useTamboStream } from "./provider";
-export { Streaming } from "./streaming";
-export { Success } from "./success";
-export * from "./types";
+export { Pending } from "./pending.js";
+export { useTamboStream } from "./provider.js";
+export { Streaming } from "./streaming.js";
+export { Success } from "./success.js";
+export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/providers/tambo-prop-stream-provider/index.js

@@ -1,7 +1,7 @@
-import { Pending } from "./pending";
-import { TamboPropStreamProviderComponent } from "./provider";
-import { Streaming } from "./streaming";
-import { Success } from "./success";
+import { Pending } from "./pending.js";
+import { TamboPropStreamProviderComponent } from "./provider.js";
+import { Streaming } from "./streaming.js";
+import { Success } from "./success.js";
 /**
  * The TamboPropStreamProvider provides a context for managing stream states
  * with compound components for Pending, Streaming, and Success states.
@@ -14,9 +14,9 @@ export const TamboPropStreamProvider = Object.assign(TamboPropStreamProviderComp
     Success,
 });
 // Re-export components for individual use
-export { Pending } from "./pending";
-export { useTamboStream } from "./provider";
-export { Streaming } from "./streaming";
-export { Success } from "./success";
-export * from "./types";
+export { Pending } from "./pending.js";
+export { useTamboStream } from "./provider.js";
+export { Streaming } from "./streaming.js";
+export { Success } from "./success.js";
+export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/esm/providers/tambo-prop-stream-provider/pending.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { StreamStateComponentProps } from "./types";
+import { StreamStateComponentProps } from "./types.js";
 /**
  * Pending component that renders children when the stream has no data
  * @param props - The props for the Pending component

package/esm/providers/tambo-prop-stream-provider/pending.js

@@ -1,6 +1,6 @@
 import React from "react";
-import { useTamboStream } from "./provider";
-import { DEFAULT_STREAM_KEY } from "./types";
+import { useTamboStream } from "./provider.js";
+import { DEFAULT_STREAM_KEY } from "./types.js";
 /**
  * Pending component that renders children when the stream has no data
  * @param props - The props for the Pending component

package/esm/providers/tambo-prop-stream-provider/provider.d.ts

@@ -1,5 +1,5 @@
 import React, { PropsWithChildren } from "react";
-import { TamboPropStreamContextValue } from "./types";
+import { TamboPropStreamContextValue } from "./types.js";
 /**
  * Hook to use the TamboStream context
  * @returns The TamboStream context

package/esm/providers/tambo-prop-stream-provider/provider.js

@@ -1,7 +1,7 @@
 "use client";
 import React, { createContext, useCallback, useContext, useMemo, } from "react";
-import { useTamboStreamStatus } from "../../hooks/use-tambo-stream-status";
-import { DEFAULT_STREAM_KEY, } from "./types";
+import { useTamboStreamStatus } from "../../hooks/use-tambo-stream-status.js";
+import { DEFAULT_STREAM_KEY, } from "./types.js";
 const TamboPropStreamContext = createContext(null);
 /**
  * Hook to use the TamboStream context

package/esm/providers/tambo-prop-stream-provider/streaming.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { StreamStateComponentProps } from "./types";
+import { StreamStateComponentProps } from "./types.js";
 /**
  * Streaming component that renders children when the stream is in a streaming state
  * @param props - The props for the Streaming component

package/esm/providers/tambo-prop-stream-provider/streaming.js

@@ -1,6 +1,6 @@
 import React from "react";
-import { useTamboStream } from "./provider";
-import { DEFAULT_STREAM_KEY } from "./types";
+import { useTamboStream } from "./provider.js";
+import { DEFAULT_STREAM_KEY } from "./types.js";
 /**
  * Streaming component that renders children when the stream is in a streaming state
  * @param props - The props for the Streaming component

package/esm/providers/tambo-prop-stream-provider/success.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { StreamStateComponentProps } from "./types";
+import { StreamStateComponentProps } from "./types.js";
 /**
  * Success component that renders children when the stream has data
  * @param props - The props for the Success component

package/esm/providers/tambo-prop-stream-provider/success.js

@@ -1,6 +1,6 @@
 import React from "react";
-import { useTamboStream } from "./provider";
-import { DEFAULT_STREAM_KEY } from "./types";
+import { useTamboStream } from "./provider.js";
+import { DEFAULT_STREAM_KEY } from "./types.js";
 /**
  * Success component that renders children when the stream has data
  * @param props - The props for the Success component

package/esm/providers/tambo-prop-stream-provider/types.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { StreamStatus as HookStreamStatus } from "../../hooks/use-tambo-stream-status";
+import { StreamStatus as HookStreamStatus } from "../../hooks/use-tambo-stream-status.js";
 export declare const DEFAULT_STREAM_KEY = "default";
 export interface StreamStateComponentProps {
     /** The key to identify this stream state */

package/esm/providers/tambo-prop-stream-provider.test.js

@@ -1,9 +1,9 @@
 import { render, screen } from "@testing-library/react";
 import React from "react";
-import { useTamboCurrentMessage } from "../hooks/use-current-message";
-import { GenerationStage, } from "../model/generate-component-response";
-import { useTamboGenerationStage, useTamboThread, } from "../providers/tambo-thread-provider";
-import { TamboPropStreamProvider, useTamboStream, } from "./tambo-prop-stream-provider";
+import { useTamboCurrentMessage } from "../hooks/use-current-message.js";
+import { GenerationStage, } from "../model/generate-component-response.js";
+import { useTamboGenerationStage, useTamboThread, } from "../providers/tambo-thread-provider.js";
+import { TamboPropStreamProvider, useTamboStream, } from "./tambo-prop-stream-provider/index.js";
 // Mock the required providers
 jest.mock("../providers/tambo-thread-provider", () => ({
     useTamboThread: jest.fn(),

package/esm/providers/tambo-provider.d.ts

@@ -1,11 +1,11 @@
 import React, { PropsWithChildren } from "react";
-import { TamboInteractableContext } from "../model/tambo-interactable";
-import { TamboClientContextProps, TamboClientProviderProps } from "./tambo-client-provider";
-import { TamboComponentContextProps } from "./tambo-component-provider";
-import { ContextAttachmentState } from "./tambo-context-attachment-provider";
-import { TamboContextHelpersContextProps, TamboContextHelpersProviderProps } from "./tambo-context-helpers-provider";
-import { TamboRegistryProviderProps } from "./tambo-registry-provider";
-import { TamboGenerationStageContextProps, TamboThreadContextProps, TamboThreadProviderProps } from "./tambo-thread-provider";
+import { TamboInteractableContext } from "../model/tambo-interactable.js";
+import { TamboClientContextProps, TamboClientProviderProps } from "./tambo-client-provider.js";
+import { TamboComponentContextProps } from "./tambo-component-provider.js";
+import { ContextAttachmentState } from "./tambo-context-attachment-provider.js";
+import { TamboContextHelpersContextProps, TamboContextHelpersProviderProps } from "./tambo-context-helpers-provider.js";
+import { TamboRegistryProviderProps } from "./tambo-registry-provider.js";
+import { TamboGenerationStageContextProps, TamboThreadContextProps, TamboThreadProviderProps } from "./tambo-thread-provider.js";
 /**
  * The TamboProvider gives full access to the whole Tambo API. This includes the
  * TamboAI client, the component registry, the current thread context, and interactable components.
@@ -25,6 +25,9 @@ import { TamboGenerationStageContextProps, TamboThreadContextProps, TamboThreadP
  * @param props.contextKey - Optional context key passed to thread input provider for scoping threads
  * @param props.onCallUnregisteredTool - Callback function called when an unregistered tool is called
  * @param props.initialMessages - Initial messages to be included in new threads
+ * @param props.getResource - Optional getResource function for registry resources
+ * @param props.listResources - Optional listResources function for registry resources
+ * @param props.resources - Optional static resources for the registry
  * @returns The TamboProvider component
  */
 export declare const TamboProvider: React.FC<PropsWithChildren<TamboClientProviderProps & TamboRegistryProviderProps & TamboThreadProviderProps & TamboContextHelpersProviderProps>>;

package/esm/providers/tambo-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAA6B,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAEL,uBAAuB,EAEvB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAG3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EAGvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAE/B,gCAAgC,EAEjC,MAAM,kCAAkC,CAAC;AAM1C,OAAO,EAEL,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gCAAgC,EAChC,uBAAuB,EAEvB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAClC,iBAAiB,CACf,wBAAwB,GACtB,0BAA0B,GAC1B,wBAAwB,GACxB,gCAAgC,CACnC,CAiEF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GACrD,uBAAuB,GACvB,gCAAgC,GAChC,0BAA0B,GAC1B,wBAAwB,GACxB,+BAA+B,GAC/B,sBAAsB,CAAC;AAEzB,eAAO,MAAM,YAAY,kCAExB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAgC9D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,yBAEpB,CAAC"}
+{"version":3,"file":"tambo-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAA6B,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAEL,uBAAuB,EAEvB,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAG3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EAGvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAE/B,gCAAgC,EAEjC,MAAM,kCAAkC,CAAC;AAM1C,OAAO,EAEL,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gCAAgC,EAChC,uBAAuB,EAEvB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAClC,iBAAiB,CACf,wBAAwB,GACtB,0BAA0B,GAC1B,wBAAwB,GACxB,gCAAgC,CACnC,CAiEF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GACrD,uBAAuB,GACvB,gCAAgC,GAChC,0BAA0B,GAC1B,wBAAwB,GACxB,+BAA+B,GAC/B,sBAAsB,CAAC;AAEzB,eAAO,MAAM,YAAY,kCAExB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAgC9D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,yBAEpB,CAAC"}

package/esm/providers/tambo-provider.js

@@ -1,15 +1,15 @@
 "use client";
 import React, { createContext, useContext } from "react";
-import { TamboMcpProvider } from "../mcp/tambo-mcp-provider";
-import { TamboClientContext, TamboClientProvider, } from "./tambo-client-provider";
-import { TamboComponentProvider, useTamboComponent, } from "./tambo-component-provider";
-import { TamboContextAttachmentProvider, useTamboContextAttachment, } from "./tambo-context-attachment-provider";
-import { TamboContextHelpersProvider, useTamboContextHelpers, } from "./tambo-context-helpers-provider";
-import { TamboInteractableProvider, useTamboInteractable, } from "./tambo-interactable-provider";
-import { TamboMcpTokenProvider } from "./tambo-mcp-token-provider";
-import { TamboRegistryProvider, } from "./tambo-registry-provider";
-import { TamboThreadInputProvider } from "./tambo-thread-input-provider";
-import { TamboThreadProvider, useTamboThread, } from "./tambo-thread-provider";
+import { TamboMcpProvider } from "../mcp/tambo-mcp-provider.js";
+import { TamboClientContext, TamboClientProvider, } from "./tambo-client-provider.js";
+import { TamboComponentProvider, useTamboComponent, } from "./tambo-component-provider.js";
+import { TamboContextAttachmentProvider, useTamboContextAttachment, } from "./tambo-context-attachment-provider.js";
+import { TamboContextHelpersProvider, useTamboContextHelpers, } from "./tambo-context-helpers-provider.js";
+import { TamboInteractableProvider, useTamboInteractable, } from "./tambo-interactable-provider.js";
+import { TamboMcpTokenProvider } from "./tambo-mcp-token-provider.js";
+import { TamboRegistryProvider, } from "./tambo-registry-provider.js";
+import { TamboThreadInputProvider } from "./tambo-thread-input-provider.js";
+import { TamboThreadProvider, useTamboThread, } from "./tambo-thread-provider.js";
 /**
  * The TamboProvider gives full access to the whole Tambo API. This includes the
  * TamboAI client, the component registry, the current thread context, and interactable components.
@@ -29,6 +29,9 @@ import { TamboThreadProvider, useTamboThread, } from "./tambo-thread-provider";
  * @param props.contextKey - Optional context key passed to thread input provider for scoping threads
  * @param props.onCallUnregisteredTool - Callback function called when an unregistered tool is called
  * @param props.initialMessages - Initial messages to be included in new threads
+ * @param props.getResource - Optional getResource function for registry resources
+ * @param props.listResources - Optional listResources function for registry resources
+ * @param props.resources - Optional static resources for the registry
  * @returns The TamboProvider component
  */
 export const TamboProvider = ({ children, tamboUrl, apiKey, userToken, components, environment, tools, mcpServers, streaming, autoGenerateThreadName, autoGenerateNameThreshold, contextHelpers, contextKey, initialMessages, onCallUnregisteredTool, getResource, listResources, resources, }) => {

package/esm/providers/tambo-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, { PropsWithChildren, createContext, useContext } from \"react\";\nimport { TamboMcpProvider } from \"../mcp/tambo-mcp-provider\";\nimport { TamboInteractableContext } from \"../model/tambo-interactable\";\nimport {\n  TamboClientContext,\n  TamboClientContextProps,\n  TamboClientProvider,\n  TamboClientProviderProps,\n} from \"./tambo-client-provider\";\nimport {\n  TamboComponentContextProps,\n  TamboComponentProvider,\n  useTamboComponent,\n} from \"./tambo-component-provider\";\nimport {\n  ContextAttachmentState,\n  TamboContextAttachmentProvider,\n  useTamboContextAttachment,\n} from \"./tambo-context-attachment-provider\";\nimport {\n  TamboContextHelpersContextProps,\n  TamboContextHelpersProvider,\n  TamboContextHelpersProviderProps,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport {\n  TamboInteractableProvider,\n  useTamboInteractable,\n} from \"./tambo-interactable-provider\";\nimport { TamboMcpTokenProvider } from \"./tambo-mcp-token-provider\";\nimport {\n  TamboRegistryProvider,\n  TamboRegistryProviderProps,\n} from \"./tambo-registry-provider\";\nimport { TamboThreadInputProvider } from \"./tambo-thread-input-provider\";\nimport {\n  TamboGenerationStageContextProps,\n  TamboThreadContextProps,\n  TamboThreadProvider,\n  TamboThreadProviderProps,\n  useTamboThread,\n} from \"./tambo-thread-provider\";\n\n/**\n * The TamboProvider gives full access to the whole Tambo API. This includes the\n * TamboAI client, the component registry, the current thread context, and interactable components.\n * @param props - The props for the TamboProvider\n * @param props.children - The children to wrap\n * @param props.tamboUrl - The URL of the Tambo API\n * @param props.apiKey - The API key for the Tambo API\n * @param props.components - The components to register\n * @param props.environment - The environment to use for the Tambo API\n * @param props.tools - The tools to register\n * @param props.mcpServers - The MCP servers to register (metadata only - use TamboMcpProvider for connections)\n * @param props.streaming - Whether to stream the response by default. Defaults to true.\n * @param props.autoGenerateThreadName - Whether to automatically generate thread names. Defaults to true.\n * @param props.autoGenerateNameThreshold - The message count threshold at which the thread name will be auto-generated. Defaults to 3.\n * @param props.contextHelpers - Configuration for which context helpers are enabled/disabled\n * @param props.userToken - The user's OAuth token (access or ID) used to identify the user and exchange for a Tambo session token\n * @param props.contextKey - Optional context key passed to thread input provider for scoping threads\n * @param props.onCallUnregisteredTool - Callback function called when an unregistered tool is called\n * @param props.initialMessages - Initial messages to be included in new threads\n * @returns The TamboProvider component\n */\nexport const TamboProvider: React.FC<\n  PropsWithChildren<\n    TamboClientProviderProps &\n      TamboRegistryProviderProps &\n      TamboThreadProviderProps &\n      TamboContextHelpersProviderProps\n  >\n> = ({\n  children,\n  tamboUrl,\n  apiKey,\n  userToken,\n  components,\n  environment,\n  tools,\n  mcpServers,\n  streaming,\n  autoGenerateThreadName,\n  autoGenerateNameThreshold,\n  contextHelpers,\n  contextKey,\n  initialMessages,\n  onCallUnregisteredTool,\n  getResource,\n  listResources,\n  resources,\n}) => {\n  return (\n    <TamboClientProvider\n      tamboUrl={tamboUrl}\n      apiKey={apiKey}\n      environment={environment}\n      userToken={userToken}\n    >\n      <TamboRegistryProvider\n        components={components}\n        tools={tools}\n        mcpServers={mcpServers}\n        onCallUnregisteredTool={onCallUnregisteredTool}\n        getResource={getResource}\n        listResources={listResources}\n        resources={resources}\n      >\n        <TamboContextHelpersProvider contextHelpers={contextHelpers}>\n          <TamboThreadProvider\n            contextKey={contextKey}\n            streaming={streaming}\n            autoGenerateThreadName={autoGenerateThreadName}\n            autoGenerateNameThreshold={autoGenerateNameThreshold}\n            initialMessages={initialMessages}\n          >\n            <TamboMcpTokenProvider>\n              <TamboMcpProvider contextKey={contextKey}>\n                <TamboContextAttachmentProvider>\n                  <TamboComponentProvider>\n                    <TamboInteractableProvider>\n                      <TamboThreadInputProvider>\n                        <TamboCompositeProvider>\n                          {children}\n                        </TamboCompositeProvider>\n                      </TamboThreadInputProvider>\n                    </TamboInteractableProvider>\n                  </TamboComponentProvider>\n                </TamboContextAttachmentProvider>\n              </TamboMcpProvider>\n            </TamboMcpTokenProvider>\n          </TamboThreadProvider>\n        </TamboContextHelpersProvider>\n      </TamboRegistryProvider>\n    </TamboClientProvider>\n  );\n};\n\nexport type TamboContextProps = TamboClientContextProps &\n  TamboThreadContextProps &\n  TamboGenerationStageContextProps &\n  TamboComponentContextProps &\n  TamboInteractableContext &\n  TamboContextHelpersContextProps &\n  ContextAttachmentState;\n\nexport const TamboContext = createContext<TamboContextProps>(\n  {} as TamboContextProps,\n);\n\n/**\n * TamboCompositeProvider is a provider that combines the TamboClient,\n * TamboThread, TamboComponent, and TamboInteractable providers\n * @param props - The props for the TamboCompositeProvider\n * @param props.children - The children to wrap\n * @returns The wrapped component\n */\nexport const TamboCompositeProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const threads = useTamboThread();\n  const clientContext = useContext(TamboClientContext);\n  if (!clientContext) {\n    throw new Error(\n      \"TamboCompositeProvider must be used within a TamboClientProvider\",\n    );\n  }\n  const { client, queryClient, isUpdatingToken } = clientContext;\n  const componentRegistry = useTamboComponent();\n  const interactableComponents = useTamboInteractable();\n  const contextHelpers = useTamboContextHelpers();\n  const contextAttachment = useTamboContextAttachment();\n\n  return (\n    <TamboContext.Provider\n      value={{\n        client,\n        queryClient,\n        isUpdatingToken,\n        ...componentRegistry,\n        ...threads,\n        ...interactableComponents,\n        ...contextHelpers,\n        ...contextAttachment,\n      }}\n    >\n      {children}\n    </TamboContext.Provider>\n  );\n};\n\n/**\n * The useTambo hook provides access to the Tambo API. This is the primary entrypoint\n * for the Tambo React SDK.\n *\n * This includes the TamboAI client, the component registry, the current thread context,\n * and interactable component management.\n * @returns The Tambo API\n */\nexport const useTambo = () => {\n  return useContext(TamboContext);\n};\n"]}
+{"version":3,"file":"tambo-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, { PropsWithChildren, createContext, useContext } from \"react\";\nimport { TamboMcpProvider } from \"../mcp/tambo-mcp-provider\";\nimport { TamboInteractableContext } from \"../model/tambo-interactable\";\nimport {\n  TamboClientContext,\n  TamboClientContextProps,\n  TamboClientProvider,\n  TamboClientProviderProps,\n} from \"./tambo-client-provider\";\nimport {\n  TamboComponentContextProps,\n  TamboComponentProvider,\n  useTamboComponent,\n} from \"./tambo-component-provider\";\nimport {\n  ContextAttachmentState,\n  TamboContextAttachmentProvider,\n  useTamboContextAttachment,\n} from \"./tambo-context-attachment-provider\";\nimport {\n  TamboContextHelpersContextProps,\n  TamboContextHelpersProvider,\n  TamboContextHelpersProviderProps,\n  useTamboContextHelpers,\n} from \"./tambo-context-helpers-provider\";\nimport {\n  TamboInteractableProvider,\n  useTamboInteractable,\n} from \"./tambo-interactable-provider\";\nimport { TamboMcpTokenProvider } from \"./tambo-mcp-token-provider\";\nimport {\n  TamboRegistryProvider,\n  TamboRegistryProviderProps,\n} from \"./tambo-registry-provider\";\nimport { TamboThreadInputProvider } from \"./tambo-thread-input-provider\";\nimport {\n  TamboGenerationStageContextProps,\n  TamboThreadContextProps,\n  TamboThreadProvider,\n  TamboThreadProviderProps,\n  useTamboThread,\n} from \"./tambo-thread-provider\";\n\n/**\n * The TamboProvider gives full access to the whole Tambo API. This includes the\n * TamboAI client, the component registry, the current thread context, and interactable components.\n * @param props - The props for the TamboProvider\n * @param props.children - The children to wrap\n * @param props.tamboUrl - The URL of the Tambo API\n * @param props.apiKey - The API key for the Tambo API\n * @param props.components - The components to register\n * @param props.environment - The environment to use for the Tambo API\n * @param props.tools - The tools to register\n * @param props.mcpServers - The MCP servers to register (metadata only - use TamboMcpProvider for connections)\n * @param props.streaming - Whether to stream the response by default. Defaults to true.\n * @param props.autoGenerateThreadName - Whether to automatically generate thread names. Defaults to true.\n * @param props.autoGenerateNameThreshold - The message count threshold at which the thread name will be auto-generated. Defaults to 3.\n * @param props.contextHelpers - Configuration for which context helpers are enabled/disabled\n * @param props.userToken - The user's OAuth token (access or ID) used to identify the user and exchange for a Tambo session token\n * @param props.contextKey - Optional context key passed to thread input provider for scoping threads\n * @param props.onCallUnregisteredTool - Callback function called when an unregistered tool is called\n * @param props.initialMessages - Initial messages to be included in new threads\n * @param props.getResource - Optional getResource function for registry resources\n * @param props.listResources - Optional listResources function for registry resources\n * @param props.resources - Optional static resources for the registry\n * @returns The TamboProvider component\n */\nexport const TamboProvider: React.FC<\n  PropsWithChildren<\n    TamboClientProviderProps &\n      TamboRegistryProviderProps &\n      TamboThreadProviderProps &\n      TamboContextHelpersProviderProps\n  >\n> = ({\n  children,\n  tamboUrl,\n  apiKey,\n  userToken,\n  components,\n  environment,\n  tools,\n  mcpServers,\n  streaming,\n  autoGenerateThreadName,\n  autoGenerateNameThreshold,\n  contextHelpers,\n  contextKey,\n  initialMessages,\n  onCallUnregisteredTool,\n  getResource,\n  listResources,\n  resources,\n}) => {\n  return (\n    <TamboClientProvider\n      tamboUrl={tamboUrl}\n      apiKey={apiKey}\n      environment={environment}\n      userToken={userToken}\n    >\n      <TamboRegistryProvider\n        components={components}\n        tools={tools}\n        mcpServers={mcpServers}\n        onCallUnregisteredTool={onCallUnregisteredTool}\n        getResource={getResource}\n        listResources={listResources}\n        resources={resources}\n      >\n        <TamboContextHelpersProvider contextHelpers={contextHelpers}>\n          <TamboThreadProvider\n            contextKey={contextKey}\n            streaming={streaming}\n            autoGenerateThreadName={autoGenerateThreadName}\n            autoGenerateNameThreshold={autoGenerateNameThreshold}\n            initialMessages={initialMessages}\n          >\n            <TamboMcpTokenProvider>\n              <TamboMcpProvider contextKey={contextKey}>\n                <TamboContextAttachmentProvider>\n                  <TamboComponentProvider>\n                    <TamboInteractableProvider>\n                      <TamboThreadInputProvider>\n                        <TamboCompositeProvider>\n                          {children}\n                        </TamboCompositeProvider>\n                      </TamboThreadInputProvider>\n                    </TamboInteractableProvider>\n                  </TamboComponentProvider>\n                </TamboContextAttachmentProvider>\n              </TamboMcpProvider>\n            </TamboMcpTokenProvider>\n          </TamboThreadProvider>\n        </TamboContextHelpersProvider>\n      </TamboRegistryProvider>\n    </TamboClientProvider>\n  );\n};\n\nexport type TamboContextProps = TamboClientContextProps &\n  TamboThreadContextProps &\n  TamboGenerationStageContextProps &\n  TamboComponentContextProps &\n  TamboInteractableContext &\n  TamboContextHelpersContextProps &\n  ContextAttachmentState;\n\nexport const TamboContext = createContext<TamboContextProps>(\n  {} as TamboContextProps,\n);\n\n/**\n * TamboCompositeProvider is a provider that combines the TamboClient,\n * TamboThread, TamboComponent, and TamboInteractable providers\n * @param props - The props for the TamboCompositeProvider\n * @param props.children - The children to wrap\n * @returns The wrapped component\n */\nexport const TamboCompositeProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const threads = useTamboThread();\n  const clientContext = useContext(TamboClientContext);\n  if (!clientContext) {\n    throw new Error(\n      \"TamboCompositeProvider must be used within a TamboClientProvider\",\n    );\n  }\n  const { client, queryClient, isUpdatingToken } = clientContext;\n  const componentRegistry = useTamboComponent();\n  const interactableComponents = useTamboInteractable();\n  const contextHelpers = useTamboContextHelpers();\n  const contextAttachment = useTamboContextAttachment();\n\n  return (\n    <TamboContext.Provider\n      value={{\n        client,\n        queryClient,\n        isUpdatingToken,\n        ...componentRegistry,\n        ...threads,\n        ...interactableComponents,\n        ...contextHelpers,\n        ...contextAttachment,\n      }}\n    >\n      {children}\n    </TamboContext.Provider>\n  );\n};\n\n/**\n * The useTambo hook provides access to the Tambo API. This is the primary entrypoint\n * for the Tambo React SDK.\n *\n * This includes the TamboAI client, the component registry, the current thread context,\n * and interactable component management.\n * @returns The Tambo API\n */\nexport const useTambo = () => {\n  return useContext(TamboContext);\n};\n"]}

package/esm/providers/tambo-registry-provider.d.ts

@@ -1,8 +1,8 @@
 import type TamboAI from "@tambo-ai/typescript-sdk";
 import React, { PropsWithChildren } from "react";
-import type { ComponentRegistry, RegisterToolFn, RegisterToolsFn, TamboComponent, TamboTool, TamboToolRegistry } from "../model/component-metadata";
-import type { McpServerInfo, NormalizedMcpServerInfo } from "../model/mcp-server-info";
-import type { ListResourceItem, ResourceSource } from "../model/resource-info";
+import type { ComponentRegistry, RegisterToolFn, RegisterToolsFn, TamboComponent, TamboTool, TamboToolRegistry } from "../model/component-metadata.js";
+import type { McpServerInfo, NormalizedMcpServerInfo } from "../model/mcp-server-info.js";
+import type { ListResourceItem, ResourceSource } from "../model/resource-info.js";
 export interface TamboRegistryContext {
     componentList: ComponentRegistry;
     toolRegistry: TamboToolRegistry;

package/esm/providers/tambo-registry-provider.js

@@ -1,8 +1,8 @@
 "use client";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
-import { deduplicateMcpServers, normalizeServerInfo, } from "../util/mcp-server-utils";
-import { validateAndPrepareComponent, validateTool, validateToolAssociation, } from "../util/registry-validators";
-import { validateResource, validateResourceSource, } from "../util/resource-validators";
+import { deduplicateMcpServers, normalizeServerInfo, } from "../util/mcp-server-utils.js";
+import { validateAndPrepareComponent, validateTool, validateToolAssociation, } from "../util/registry-validators.js";
+import { validateResource, validateResourceSource, } from "../util/resource-validators.js";
 export const TamboRegistryContext = createContext({
     componentList: {},
     toolRegistry: {},

package/esm/providers/tambo-registry-provider.test.js

@@ -1,8 +1,8 @@
 import { act, renderHook } from "@testing-library/react";
 import React from "react";
 import { z } from "zod/v4";
-import { defineTool } from "../util/registry";
-import { TamboRegistryProvider, useTamboRegistry, } from "./tambo-registry-provider";
+import { defineTool } from "../util/registry.js";
+import { TamboRegistryProvider, useTamboRegistry, } from "./tambo-registry-provider.js";
 // Shared tool registry for all tests
 const createMockTools = () => [
     defineTool({

package/esm/providers/tambo-registry-schema-compat.test.js

@@ -10,8 +10,8 @@ import { act, renderHook } from "@testing-library/react";
 import React from "react";
 import * as z3 from "zod/v3";
 import * as z4 from "zod/v4";
-import { defineTool } from "../util/registry";
-import { TamboRegistryProvider, useTamboRegistry, } from "./tambo-registry-provider";
+import { defineTool } from "../util/registry.js";
+import { TamboRegistryProvider, useTamboRegistry, } from "./tambo-registry-provider.js";
 // Test component for registration tests
 const TestComponent = ({ message }) => (React.createElement("div", null, message));
 describe("Schema Compatibility", () => {

package/esm/providers/tambo-stubs.d.ts

@@ -1,9 +1,9 @@
 import TamboAI from "@tambo-ai/typescript-sdk";
 import React, { PropsWithChildren } from "react";
-import { TamboComponent, TamboTool } from "../model/component-metadata";
-import { TamboThread } from "../model/tambo-thread";
-import { TamboContextHelpersProviderProps } from "./tambo-context-helpers-provider";
-import { type TamboContextProps } from "./tambo-provider";
+import { TamboComponent, TamboTool } from "../model/component-metadata.js";
+import { TamboThread } from "../model/tambo-thread.js";
+import { TamboContextHelpersProviderProps } from "./tambo-context-helpers-provider.js";
+import { type TamboContextProps } from "./tambo-provider.js";
 /**
  * TamboStubProvider props - includes all the data that would normally be inferred
  */

package/esm/providers/tambo-stubs.js

@@ -1,15 +1,15 @@
 "use client";
 import { QueryClient } from "@tanstack/react-query";
 import React, { useEffect } from "react";
-import { GenerationStage } from "../model/generate-component-response";
-import { TamboClientContext } from "./tambo-client-provider";
-import { TamboComponentProvider, } from "./tambo-component-provider";
-import { TamboContextAttachmentProvider } from "./tambo-context-attachment-provider";
-import { TamboContextHelpersProvider, } from "./tambo-context-helpers-provider";
-import { TamboInteractableProvider } from "./tambo-interactable-provider";
-import { TamboCompositeProvider, } from "./tambo-provider";
-import { TamboRegistryContext } from "./tambo-registry-provider";
-import { TamboGenerationStageProvider, TamboThreadContext, } from "./tambo-thread-provider";
+import { GenerationStage } from "../model/generate-component-response.js";
+import { TamboClientContext } from "./tambo-client-provider.js";
+import { TamboComponentProvider, } from "./tambo-component-provider.js";
+import { TamboContextAttachmentProvider } from "./tambo-context-attachment-provider.js";
+import { TamboContextHelpersProvider, } from "./tambo-context-helpers-provider.js";
+import { TamboInteractableProvider } from "./tambo-interactable-provider.js";
+import { TamboCompositeProvider, } from "./tambo-provider.js";
+import { TamboRegistryContext } from "./tambo-registry-provider.js";
+import { TamboGenerationStageProvider, TamboThreadContext, } from "./tambo-thread-provider.js";
 /**
  * Stub client provider that accepts a client and queryClient as props
  * @returns The TamboStubClientProvider component

package/esm/providers/tambo-stubs.test.js

@@ -1,7 +1,7 @@
 import { renderHook } from "@testing-library/react";
 import React, { act } from "react";
-import { useTamboThreadList } from "../hooks/use-tambo-threads";
-import { TamboStubProvider } from "./tambo-stubs";
+import { useTamboThreadList } from "../hooks/use-tambo-threads.js";
+import { TamboStubProvider } from "./tambo-stubs.js";
 describe("TamboStubProvider threads functionality", () => {
     const mockThread = {
         id: "test-thread",

package/esm/providers/tambo-thread-input-provider.d.ts

@@ -1,6 +1,6 @@
 import React, { PropsWithChildren } from "react";
-import { UseTamboMutationResult } from "../hooks/react-query-hooks";
-import { StagedImage } from "../hooks/use-message-images";
+import { UseTamboMutationResult } from "../hooks/react-query-hooks.js";
+import { StagedImage } from "../hooks/use-message-images.js";
 /**
  * Error messages for various input-related error scenarios
  * These messages are used to provide user-friendly error feedback

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-thread-input-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-thread-input-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAEZ,iBAAiB,EAIlB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAoB,MAAM,6BAA6B,CAAC;AAa5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CACxD,sBAAsB,CACpB,IAAI,EACJ,KAAK,EACH;IACE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzC,GACD,SAAS,CACZ,EACD,QAAQ,GAAG,aAAa,CACzB;IACC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QACjB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,yBAAyB;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,0BAA0B;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,4BAA4B;IAC5B,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,eAAO,MAAM,uBAAuB,yDAExB,CAAC;AAEb;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAoKhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,oCAS/B,CAAC"}
+{"version":3,"file":"tambo-thread-input-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-thread-input-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAEZ,iBAAiB,EAIlB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAoB,MAAM,6BAA6B,CAAC;AAa5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CACxD,sBAAsB,CACpB,IAAI,EACJ,KAAK,EACH;IACE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzC,GACD,SAAS,CACZ,EACD,QAAQ,GAAG,aAAa,CACzB;IACC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QACjB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,yBAAyB;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,0BAA0B;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,4BAA4B;IAC5B,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,eAAO,MAAM,uBAAuB,yDAExB,CAAC;AAEb;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAqKhE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,oCAS/B,CAAC"}

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

@@ -1,15 +1,15 @@
 "use client";
 import React, { createContext, useCallback, useContext, useState, } from "react";
-import { useTamboMutation, } from "../hooks/react-query-hooks";
-import { useMessageImages } from "../hooks/use-message-images";
-import { useTamboMcpServers } from "../mcp/tambo-mcp-provider";
-import { ThreadInputError } from "../model/thread-input-error";
-import { validateInput } from "../model/validate-input";
-import { buildMessageContent } from "../util/message-builder";
-import { extractResourceUris, resolveResourceContents, } from "../util/resource-content-resolver";
-import { useTamboInteractable } from "./tambo-interactable-provider";
-import { useTamboRegistry } from "./tambo-registry-provider";
-import { useTamboThread } from "./tambo-thread-provider";
+import { useTamboMutation, } from "../hooks/react-query-hooks.js";
+import { useMessageImages } from "../hooks/use-message-images.js";
+import { useTamboMcpServers } from "../mcp/tambo-mcp-provider.js";
+import { ThreadInputError } from "../model/thread-input-error.js";
+import { validateInput } from "../model/validate-input.js";
+import { buildMessageContent } from "../util/message-builder.js";
+import { extractResourceUris, resolveResourceContents, } from "../util/resource-content-resolver.js";
+import { useTamboInteractable } from "./tambo-interactable-provider.js";
+import { useTamboRegistry } from "./tambo-registry-provider.js";
+import { useTamboThread } from "./tambo-thread-provider.js";
 /**
  * Error messages for various input-related error scenarios
  * These messages are used to provide user-friendly error feedback
@@ -110,6 +110,7 @@ export const TamboThreadInputProvider = ({ children, }) => {
         clearInteractableSelections,
     ]);
     const { mutateAsync: submitAsync, mutate: _unusedSubmit, ...mutationState } = useTamboMutation({
+        mutationKey: ["thread-input", thread.id],
         mutationFn: submit,
     });
     const value = {

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-thread-input-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-thread-input-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useState,\n} from \"react\";\nimport {\n  useTamboMutation,\n  UseTamboMutationResult,\n} from \"../hooks/react-query-hooks\";\nimport { StagedImage, useMessageImages } from \"../hooks/use-message-images\";\nimport { useTamboMcpServers } from \"../mcp/tambo-mcp-provider\";\nimport { ThreadInputError } from \"../model/thread-input-error\";\nimport { validateInput } from \"../model/validate-input\";\nimport { buildMessageContent } from \"../util/message-builder\";\nimport {\n  extractResourceUris,\n  resolveResourceContents,\n} from \"../util/resource-content-resolver\";\nimport { useTamboInteractable } from \"./tambo-interactable-provider\";\nimport { useTamboRegistry } from \"./tambo-registry-provider\";\nimport { useTamboThread } from \"./tambo-thread-provider\";\n\n/**\n * Error messages for various input-related error scenarios\n * These messages are used to provide user-friendly error feedback\n * @readonly\n */\nexport const INPUT_ERROR_MESSAGES = {\n  EMPTY: \"Message cannot be empty\",\n  NETWORK: \"Network error. Please check your connection\",\n  SERVER: \"Server error. Please try again\",\n  VALIDATION: \"Invalid message format\",\n} as const;\n\nexport interface TamboThreadInputContextProps extends Omit<\n  UseTamboMutationResult<\n    void,\n    Error,\n    | {\n        contextKey?: string;\n        streamResponse?: boolean;\n        forceToolChoice?: string;\n        additionalContext?: Record<string, any>;\n      }\n    | undefined\n  >,\n  \"mutate\" | \"mutateAsync\"\n> {\n  /** Current value of the input field */\n  value: string;\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: (value: React.SetStateAction<string>) => void;\n  /**\n   * Function to submit the current input value\n   * @param options - Submission options\n   */\n  submit: (options?: {\n    streamResponse?: boolean;\n    forceToolChoice?: string;\n    additionalContext?: Record<string, any>;\n    resourceNames?: Record<string, string>;\n  }) => Promise<void>;\n  /** Currently staged images */\n  images: StagedImage[];\n  /** Add a single image */\n  addImage: (file: File) => Promise<void>;\n  /** Add multiple images */\n  addImages: (files: File[]) => Promise<void>;\n  /** Remove an image by id */\n  removeImage: (id: string) => void;\n  /** Clear all staged images */\n  clearImages: () => void;\n}\n\nexport const TamboThreadInputContext = createContext<\n  TamboThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components\n * This ensures that useTamboThreadInput, useTamboSuggestions, and components\n * all share the same input state\n * @param props - The props for the TamboThreadInputProvider\n * @param props.children - The children to render.\n * @returns The thread input context\n */\nexport const TamboThreadInputProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const { thread, sendThreadMessage, contextKey } = useTamboThread();\n  const [inputValue, setInputValue] = useState(\"\");\n  const imageState = useMessageImages();\n  const mcpServers = useTamboMcpServers();\n  const { resourceSource } = useTamboRegistry();\n  const { clearInteractableSelections } = useTamboInteractable();\n  const submit = useCallback(\n    async ({\n      streamResponse,\n      forceToolChoice,\n      additionalContext,\n      resourceNames = {},\n    }: {\n      streamResponse?: boolean;\n      forceToolChoice?: string;\n      additionalContext?: Record<string, any>;\n      resourceNames?: Record<string, string>;\n    } = {}) => {\n      // Validate text input if present\n      if (inputValue?.trim()) {\n        const validation = validateInput(inputValue);\n        if (!validation.isValid) {\n          throw new ThreadInputError(\n            `Cannot submit message: ${validation.error ?? INPUT_ERROR_MESSAGES.VALIDATION}`,\n            { cause: validation.error },\n          );\n        }\n      }\n\n      // Check if we have content to send\n      if (!inputValue.trim() && imageState.images.length === 0) {\n        throw new ThreadInputError(INPUT_ERROR_MESSAGES.EMPTY, {\n          cause: \"No text or images to send\",\n        });\n      }\n\n      // Extract resource URIs from the input text and resolve content for client-side resources\n      // (registry and client-side MCP servers). Internal Tambo server resources are skipped\n      // since the backend can resolve them.\n      const resourceUris = extractResourceUris(inputValue);\n      const resolvedContent = await resolveResourceContents(\n        resourceUris,\n        mcpServers,\n        resourceSource ?? undefined,\n      );\n\n      // Build message content with text, images, resource names, and resolved content\n      const messageContent = buildMessageContent(\n        inputValue,\n        imageState.images,\n        resourceNames,\n        resolvedContent,\n      );\n\n      try {\n        await sendThreadMessage(inputValue || \"Image message\", {\n          threadId: thread.id,\n          contextKey,\n          streamResponse: streamResponse,\n          forceToolChoice: forceToolChoice,\n          additionalContext: additionalContext,\n          content: messageContent,\n        });\n        clearInteractableSelections();\n      } catch (error: unknown) {\n        // Handle image-related errors with friendly messages\n        if (imageState.images.length > 0) {\n          const errorMessage =\n            error instanceof Error ? error.message.toLowerCase() : \"\";\n\n          // Backend not yet supporting image content type\n          if (errorMessage.includes(\"unknown content part type: image\")) {\n            throw new ThreadInputError(\n              \"Image attachments are not yet supported by the backend. This feature is coming soon.\",\n              { cause: error },\n            );\n          }\n\n          // Handle specific model vision support errors\n          // OpenAI errors\n          if (\n            errorMessage.includes(\n              \"does not support image message content types\",\n            ) ||\n            (errorMessage.includes(\"invalid model\") &&\n              errorMessage.includes(\n                \"image_url is only supported by certain models\",\n              ))\n          ) {\n            throw new ThreadInputError(\n              \"This model doesn't support images. Please use GPT-4o, GPT-4 Turbo, or other vision-capable models.\",\n              { cause: error },\n            );\n          }\n\n          // Anthropic Claude errors\n          if (\n            errorMessage.includes(\"does not support image\") ||\n            errorMessage.includes(\"vision not supported\")\n          ) {\n            throw new ThreadInputError(\n              \"This Claude model doesn't support images. Please use Claude 3.5 Sonnet, Claude 3 Opus, or other vision-capable models.\",\n              { cause: error },\n            );\n          }\n\n          // Generic image/vision errors\n          if (\n            errorMessage.includes(\"image\") ||\n            errorMessage.includes(\"vision\")\n          ) {\n            throw new ThreadInputError(\n              \"This model doesn't support image attachments. Please use a vision-capable model.\",\n              { cause: error },\n            );\n          }\n        }\n\n        throw error;\n      }\n\n      // Clear text after successful submission\n      setInputValue(\"\");\n    },\n    [\n      inputValue,\n      sendThreadMessage,\n      thread.id,\n      contextKey,\n      imageState,\n      mcpServers,\n      resourceSource,\n      clearInteractableSelections,\n    ],\n  );\n\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationFn: submit,\n  });\n\n  const value = {\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  };\n\n  return (\n    <TamboThreadInputContext.Provider value={value}>\n      {children}\n    </TamboThreadInputContext.Provider>\n  );\n};\n\n/**\n * Hook to access the shared thread input state\n * contextKey parameter is not passed here anymore. Instead, use the contextKey prop in the TamboProvider.\n * @returns The thread input context\n */\nexport const useTamboThreadInput = () => {\n  const context = useContext(TamboThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboThreadInput must be used within a TamboThreadInputProvider\",\n    );\n  }\n\n  return context;\n};\n"]}
+{"version":3,"file":"tambo-thread-input-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-thread-input-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useCallback,\n  useContext,\n  useState,\n} from \"react\";\nimport {\n  useTamboMutation,\n  UseTamboMutationResult,\n} from \"../hooks/react-query-hooks\";\nimport { StagedImage, useMessageImages } from \"../hooks/use-message-images\";\nimport { useTamboMcpServers } from \"../mcp/tambo-mcp-provider\";\nimport { ThreadInputError } from \"../model/thread-input-error\";\nimport { validateInput } from \"../model/validate-input\";\nimport { buildMessageContent } from \"../util/message-builder\";\nimport {\n  extractResourceUris,\n  resolveResourceContents,\n} from \"../util/resource-content-resolver\";\nimport { useTamboInteractable } from \"./tambo-interactable-provider\";\nimport { useTamboRegistry } from \"./tambo-registry-provider\";\nimport { useTamboThread } from \"./tambo-thread-provider\";\n\n/**\n * Error messages for various input-related error scenarios\n * These messages are used to provide user-friendly error feedback\n * @readonly\n */\nexport const INPUT_ERROR_MESSAGES = {\n  EMPTY: \"Message cannot be empty\",\n  NETWORK: \"Network error. Please check your connection\",\n  SERVER: \"Server error. Please try again\",\n  VALIDATION: \"Invalid message format\",\n} as const;\n\nexport interface TamboThreadInputContextProps extends Omit<\n  UseTamboMutationResult<\n    void,\n    Error,\n    | {\n        contextKey?: string;\n        streamResponse?: boolean;\n        forceToolChoice?: string;\n        additionalContext?: Record<string, any>;\n      }\n    | undefined\n  >,\n  \"mutate\" | \"mutateAsync\"\n> {\n  /** Current value of the input field */\n  value: string;\n  /**\n   * Function to update the input value\n   * @param value - New value for the input field\n   */\n  setValue: (value: React.SetStateAction<string>) => void;\n  /**\n   * Function to submit the current input value\n   * @param options - Submission options\n   */\n  submit: (options?: {\n    streamResponse?: boolean;\n    forceToolChoice?: string;\n    additionalContext?: Record<string, any>;\n    resourceNames?: Record<string, string>;\n  }) => Promise<void>;\n  /** Currently staged images */\n  images: StagedImage[];\n  /** Add a single image */\n  addImage: (file: File) => Promise<void>;\n  /** Add multiple images */\n  addImages: (files: File[]) => Promise<void>;\n  /** Remove an image by id */\n  removeImage: (id: string) => void;\n  /** Clear all staged images */\n  clearImages: () => void;\n}\n\nexport const TamboThreadInputContext = createContext<\n  TamboThreadInputContextProps | undefined\n>(undefined);\n\n/**\n * Provider that manages shared thread input state across all components\n * This ensures that useTamboThreadInput, useTamboSuggestions, and components\n * all share the same input state\n * @param props - The props for the TamboThreadInputProvider\n * @param props.children - The children to render.\n * @returns The thread input context\n */\nexport const TamboThreadInputProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const { thread, sendThreadMessage, contextKey } = useTamboThread();\n  const [inputValue, setInputValue] = useState(\"\");\n  const imageState = useMessageImages();\n  const mcpServers = useTamboMcpServers();\n  const { resourceSource } = useTamboRegistry();\n  const { clearInteractableSelections } = useTamboInteractable();\n  const submit = useCallback(\n    async ({\n      streamResponse,\n      forceToolChoice,\n      additionalContext,\n      resourceNames = {},\n    }: {\n      streamResponse?: boolean;\n      forceToolChoice?: string;\n      additionalContext?: Record<string, any>;\n      resourceNames?: Record<string, string>;\n    } = {}) => {\n      // Validate text input if present\n      if (inputValue?.trim()) {\n        const validation = validateInput(inputValue);\n        if (!validation.isValid) {\n          throw new ThreadInputError(\n            `Cannot submit message: ${validation.error ?? INPUT_ERROR_MESSAGES.VALIDATION}`,\n            { cause: validation.error },\n          );\n        }\n      }\n\n      // Check if we have content to send\n      if (!inputValue.trim() && imageState.images.length === 0) {\n        throw new ThreadInputError(INPUT_ERROR_MESSAGES.EMPTY, {\n          cause: \"No text or images to send\",\n        });\n      }\n\n      // Extract resource URIs from the input text and resolve content for client-side resources\n      // (registry and client-side MCP servers). Internal Tambo server resources are skipped\n      // since the backend can resolve them.\n      const resourceUris = extractResourceUris(inputValue);\n      const resolvedContent = await resolveResourceContents(\n        resourceUris,\n        mcpServers,\n        resourceSource ?? undefined,\n      );\n\n      // Build message content with text, images, resource names, and resolved content\n      const messageContent = buildMessageContent(\n        inputValue,\n        imageState.images,\n        resourceNames,\n        resolvedContent,\n      );\n\n      try {\n        await sendThreadMessage(inputValue || \"Image message\", {\n          threadId: thread.id,\n          contextKey,\n          streamResponse: streamResponse,\n          forceToolChoice: forceToolChoice,\n          additionalContext: additionalContext,\n          content: messageContent,\n        });\n        clearInteractableSelections();\n      } catch (error: unknown) {\n        // Handle image-related errors with friendly messages\n        if (imageState.images.length > 0) {\n          const errorMessage =\n            error instanceof Error ? error.message.toLowerCase() : \"\";\n\n          // Backend not yet supporting image content type\n          if (errorMessage.includes(\"unknown content part type: image\")) {\n            throw new ThreadInputError(\n              \"Image attachments are not yet supported by the backend. This feature is coming soon.\",\n              { cause: error },\n            );\n          }\n\n          // Handle specific model vision support errors\n          // OpenAI errors\n          if (\n            errorMessage.includes(\n              \"does not support image message content types\",\n            ) ||\n            (errorMessage.includes(\"invalid model\") &&\n              errorMessage.includes(\n                \"image_url is only supported by certain models\",\n              ))\n          ) {\n            throw new ThreadInputError(\n              \"This model doesn't support images. Please use GPT-4o, GPT-4 Turbo, or other vision-capable models.\",\n              { cause: error },\n            );\n          }\n\n          // Anthropic Claude errors\n          if (\n            errorMessage.includes(\"does not support image\") ||\n            errorMessage.includes(\"vision not supported\")\n          ) {\n            throw new ThreadInputError(\n              \"This Claude model doesn't support images. Please use Claude 3.5 Sonnet, Claude 3 Opus, or other vision-capable models.\",\n              { cause: error },\n            );\n          }\n\n          // Generic image/vision errors\n          if (\n            errorMessage.includes(\"image\") ||\n            errorMessage.includes(\"vision\")\n          ) {\n            throw new ThreadInputError(\n              \"This model doesn't support image attachments. Please use a vision-capable model.\",\n              { cause: error },\n            );\n          }\n        }\n\n        throw error;\n      }\n\n      // Clear text after successful submission\n      setInputValue(\"\");\n    },\n    [\n      inputValue,\n      sendThreadMessage,\n      thread.id,\n      contextKey,\n      imageState,\n      mcpServers,\n      resourceSource,\n      clearInteractableSelections,\n    ],\n  );\n\n  const {\n    mutateAsync: submitAsync,\n    mutate: _unusedSubmit,\n    ...mutationState\n  } = useTamboMutation({\n    mutationKey: [\"thread-input\", thread.id],\n    mutationFn: submit,\n  });\n\n  const value = {\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  };\n\n  return (\n    <TamboThreadInputContext.Provider value={value}>\n      {children}\n    </TamboThreadInputContext.Provider>\n  );\n};\n\n/**\n * Hook to access the shared thread input state\n * contextKey parameter is not passed here anymore. Instead, use the contextKey prop in the TamboProvider.\n * @returns The thread input context\n */\nexport const useTamboThreadInput = () => {\n  const context = useContext(TamboThreadInputContext);\n  if (!context) {\n    throw new Error(\n      \"useTamboThreadInput must be used within a TamboThreadInputProvider\",\n    );\n  }\n\n  return context;\n};\n"]}

package/esm/providers/tambo-thread-provider-initial-messages.test.js

@@ -1,12 +1,12 @@
 import { advanceStream } from "@tambo-ai/typescript-sdk";
 import { act, renderHook } from "@testing-library/react";
 import React from "react";
-import { GenerationStage, } from "../model/generate-component-response";
-import { TamboClientContext, useTamboClient, useTamboQueryClient, } from "./tambo-client-provider";
-import { TamboContextHelpersProvider } from "./tambo-context-helpers-provider";
-import { TamboMcpTokenProvider } from "./tambo-mcp-token-provider";
-import { TamboRegistryProvider } from "./tambo-registry-provider";
-import { TamboThreadProvider, useTamboThread } from "./tambo-thread-provider";
+import { GenerationStage, } from "../model/generate-component-response.js";
+import { TamboClientContext, useTamboClient, useTamboQueryClient, } from "./tambo-client-provider.js";
+import { TamboContextHelpersProvider } from "./tambo-context-helpers-provider.js";
+import { TamboMcpTokenProvider } from "./tambo-mcp-token-provider.js";
+import { TamboRegistryProvider } from "./tambo-registry-provider.js";
+import { TamboThreadProvider, useTamboThread } from "./tambo-thread-provider.js";
 // Mock crypto.randomUUID
 Object.defineProperty(global, "crypto", {
     value: {

package/esm/providers/tambo-thread-provider.d.ts

@@ -1,8 +1,8 @@
 import TamboAI from "@tambo-ai/typescript-sdk";
 import { Thread } from "@tambo-ai/typescript-sdk/resources/beta/threads/threads";
 import React, { PropsWithChildren } from "react";
-import { GenerationStage, TamboThreadMessage } from "../model/generate-component-response";
-import { TamboThread } from "../model/tambo-thread";
+import { GenerationStage, TamboThreadMessage } from "../model/generate-component-response.js";
+import { TamboThread } from "../model/tambo-thread.js";
 export interface TamboGenerationStageContextProps {
     generationStage: GenerationStage;
     generationStatusMessage: string;