@tambo-ai/react 0.59.0 → 0.60.0

package/dist/hooks/react-query-hooks.d.ts

@@ -1,4 +1,4 @@
-import { QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+import { QueriesOptions, QueriesResults, QueryKey, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
 /**
  * Wrapper around useQuery that uses the internal tambo query client.
  *
@@ -23,4 +23,17 @@ export type UseTamboMutationResult<TData = unknown, TError = Error, TVariables =
  * Type alias for the result of a query.
  */
 export type UseTamboQueryResult<TData = unknown, TError = Error> = UseQueryResult<TData, TError>;
+/**
+ * Wrapper around useQueries that uses the internal tambo query client.
+ * @param options - The options for the queries, same as useQueries from `@tanstack/react-query`
+ * @param options.queries - The queries to run, same as queries from useQueries from `@tanstack/react-query`
+ * @param options.combine - The function to combine the results of the queries, same as combine from useQueries from `@tanstack/react-query`
+ * @param options.subscribed - Whether to subscribe to the queries, same as subscribed from useQueries from `@tanstack/react-query`
+ * @returns The queries result
+ */
+export declare function useTamboQueries<T extends any[], TCombinedResult = QueriesResults<T>>({ queries, ...options }: {
+    queries: readonly [...QueriesOptions<T>];
+    combine?: (result: QueriesResults<T>) => TCombinedResult;
+    subscribed?: boolean;
+}): TCombinedResult;
 //# sourceMappingURL=react-query-hooks.d.ts.map

package/dist/hooks/react-query-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-query-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/react-query-hooks.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EAER,kBAAkB,EAClB,iBAAiB,EAEjB,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,YAAY,GAAG,OAAO,EACtB,MAAM,GAAG,KAAK,EACd,KAAK,GAAG,YAAY,EACpB,SAAS,SAAS,QAAQ,GAAG,QAAQ,EACrC,OAAO,EAAE,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,0EAGjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,KAAK,EACd,UAAU,GAAG,IAAI,EACjB,QAAQ,GAAG,OAAO,EAClB,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,0DAGjE;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,KAAK,EACd,UAAU,GAAG,IAAI,EACjB,QAAQ,GAAG,OAAO,IAChB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAC7B,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,KAAK,IACZ,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC"}
+{"version":3,"file":"react-query-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/react-query-hooks.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,cAAc,EACd,QAAQ,EAER,kBAAkB,EAClB,iBAAiB,EAGjB,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,YAAY,GAAG,OAAO,EACtB,MAAM,GAAG,KAAK,EACd,KAAK,GAAG,YAAY,EACpB,SAAS,SAAS,QAAQ,GAAG,QAAQ,EACrC,OAAO,EAAE,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,0EAGjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,KAAK,EACd,UAAU,GAAG,IAAI,EACjB,QAAQ,GAAG,OAAO,EAClB,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,0DAGjE;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,CAChC,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,KAAK,EACd,UAAU,GAAG,IAAI,EACjB,QAAQ,GAAG,OAAO,IAChB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAC7B,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,KAAK,IACZ,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAElC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,GAAG,EAAE,EACf,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,EACnC,EACA,OAAO,EACP,GAAG,OAAO,EACX,EAAE;IACD,OAAO,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,mBAGA"}

package/dist/hooks/react-query-hooks.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useTamboQuery = useTamboQuery;
 exports.useTamboMutation = useTamboMutation;
+exports.useTamboQueries = useTamboQueries;
 // tamboHooks.ts
 const react_query_1 = require("@tanstack/react-query");
 const tambo_client_provider_1 = require("../providers/tambo-client-provider");
@@ -27,4 +28,16 @@ function useTamboMutation(options) {
     const queryClient = (0, tambo_client_provider_1.useTamboQueryClient)();
     return (0, react_query_1.useMutation)(options, queryClient);
 }
+/**
+ * Wrapper around useQueries that uses the internal tambo query client.
+ * @param options - The options for the queries, same as useQueries from `@tanstack/react-query`
+ * @param options.queries - The queries to run, same as queries from useQueries from `@tanstack/react-query`
+ * @param options.combine - The function to combine the results of the queries, same as combine from useQueries from `@tanstack/react-query`
+ * @param options.subscribed - Whether to subscribe to the queries, same as subscribed from useQueries from `@tanstack/react-query`
+ * @returns The queries result
+ */
+function useTamboQueries({ queries, ...options }) {
+    const queryClient = (0, tambo_client_provider_1.useTamboQueryClient)();
+    return (0, react_query_1.useQueries)({ ...options, queries }, queryClient);
+}
 //# sourceMappingURL=react-query-hooks.js.map

package/dist/hooks/react-query-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-query-hooks.js","sourceRoot":"","sources":["../../src/hooks/react-query-hooks.ts"],"names":[],"mappings":";;AAmBA,sCAQC;AASD,4CAQC;AA5CD,gBAAgB;AAChB,uDAQ+B;AAC/B,8EAAyE;AAEzE;;;;;;GAMG;AACH,SAAgB,aAAa,CAK3B,OAAgE;IAChE,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,OAAO,IAAA,sBAAQ,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAK9B,OAAgE;IAChE,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,OAAO,IAAA,yBAAW,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["// tamboHooks.ts\nimport {\n  QueryKey,\n  useMutation,\n  UseMutationOptions,\n  UseMutationResult,\n  useQuery,\n  UseQueryOptions,\n  UseQueryResult,\n} from \"@tanstack/react-query\";\nimport { useTamboQueryClient } from \"../providers/tambo-client-provider\";\n\n/**\n * Wrapper around useQuery that uses the internal tambo query client.\n *\n * Use this instead of useQuery from `@tanstack/react-query`\n * @param options - The options for the query, same as useQuery from `@tanstack/react-query`\n * @returns The query result\n */\nexport function useTamboQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>) {\n  const queryClient = useTamboQueryClient();\n  return useQuery(options, queryClient);\n}\n\n/**\n * Wrapper around useMutation that uses the internal tambo query client.\n *\n * Use this instead of useMutation from `@tanstack/react-query`\n * @param options - The options for the mutation, same as useMutation from `@tanstack/react-query`\n * @returns The mutation result\n */\nexport function useTamboMutation<\n  TData = unknown,\n  TError = Error,\n  TVariables = void,\n  TContext = unknown,\n>(options: UseMutationOptions<TData, TError, TVariables, TContext>) {\n  const queryClient = useTamboQueryClient();\n  return useMutation(options, queryClient);\n}\n\n/**\n * Type alias for the result of a mutation.\n */\nexport type UseTamboMutationResult<\n  TData = unknown,\n  TError = Error,\n  TVariables = void,\n  TContext = unknown,\n> = UseMutationResult<TData, TError, TVariables, TContext>;\n\n/**\n * Type alias for the result of a query.\n */\nexport type UseTamboQueryResult<\n  TData = unknown,\n  TError = Error,\n> = UseQueryResult<TData, TError>;\n"]}
+{"version":3,"file":"react-query-hooks.js","sourceRoot":"","sources":["../../src/hooks/react-query-hooks.ts"],"names":[],"mappings":";;AAsBA,sCAQC;AASD,4CAQC;AA4BD,0CAaC;AAxFD,gBAAgB;AAChB,uDAW+B;AAC/B,8EAAyE;AAEzE;;;;;;GAMG;AACH,SAAgB,aAAa,CAK3B,OAAgE;IAChE,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,OAAO,IAAA,sBAAQ,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAK9B,OAAgE;IAChE,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,OAAO,IAAA,yBAAW,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAC3C,CAAC;AAoBD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAG7B,EACA,OAAO,EACP,GAAG,OAAO,EAKX;IACC,MAAM,WAAW,GAAG,IAAA,2CAAmB,GAAE,CAAC;IAC1C,OAAO,IAAA,wBAAU,EAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["// tamboHooks.ts\nimport {\n  QueriesOptions,\n  QueriesResults,\n  QueryKey,\n  useMutation,\n  UseMutationOptions,\n  UseMutationResult,\n  useQueries,\n  useQuery,\n  UseQueryOptions,\n  UseQueryResult,\n} from \"@tanstack/react-query\";\nimport { useTamboQueryClient } from \"../providers/tambo-client-provider\";\n\n/**\n * Wrapper around useQuery that uses the internal tambo query client.\n *\n * Use this instead of useQuery from `@tanstack/react-query`\n * @param options - The options for the query, same as useQuery from `@tanstack/react-query`\n * @returns The query result\n */\nexport function useTamboQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>) {\n  const queryClient = useTamboQueryClient();\n  return useQuery(options, queryClient);\n}\n\n/**\n * Wrapper around useMutation that uses the internal tambo query client.\n *\n * Use this instead of useMutation from `@tanstack/react-query`\n * @param options - The options for the mutation, same as useMutation from `@tanstack/react-query`\n * @returns The mutation result\n */\nexport function useTamboMutation<\n  TData = unknown,\n  TError = Error,\n  TVariables = void,\n  TContext = unknown,\n>(options: UseMutationOptions<TData, TError, TVariables, TContext>) {\n  const queryClient = useTamboQueryClient();\n  return useMutation(options, queryClient);\n}\n\n/**\n * Type alias for the result of a mutation.\n */\nexport type UseTamboMutationResult<\n  TData = unknown,\n  TError = Error,\n  TVariables = void,\n  TContext = unknown,\n> = UseMutationResult<TData, TError, TVariables, TContext>;\n\n/**\n * Type alias for the result of a query.\n */\nexport type UseTamboQueryResult<\n  TData = unknown,\n  TError = Error,\n> = UseQueryResult<TData, TError>;\n\n/**\n * Wrapper around useQueries that uses the internal tambo query client.\n * @param options - The options for the queries, same as useQueries from `@tanstack/react-query`\n * @param options.queries - The queries to run, same as queries from useQueries from `@tanstack/react-query`\n * @param options.combine - The function to combine the results of the queries, same as combine from useQueries from `@tanstack/react-query`\n * @param options.subscribed - Whether to subscribe to the queries, same as subscribed from useQueries from `@tanstack/react-query`\n * @returns The queries result\n */\nexport function useTamboQueries<\n  T extends any[],\n  TCombinedResult = QueriesResults<T>,\n>({\n  queries,\n  ...options\n}: {\n  queries: readonly [...QueriesOptions<T>];\n  combine?: (result: QueriesResults<T>) => TCombinedResult;\n  subscribed?: boolean;\n}) {\n  const queryClient = useTamboQueryClient();\n  return useQueries({ ...options, queries }, queryClient);\n}\n"]}

package/dist/index.js

@@ -59,4 +59,6 @@ Object.defineProperty(exports, "useTamboInteractable", { enumerable: true, get:
 var context_helpers_1 = require("./context-helpers");
 Object.defineProperty(exports, "currentPageContextHelper", { enumerable: true, get: function () { return context_helpers_1.currentPageContextHelper; } });
 Object.defineProperty(exports, "currentTimeContextHelper", { enumerable: true, get: function () { return context_helpers_1.currentTimeContextHelper; } });
+// Note MCP exports like TamboMcpProvider are available separately in the
+// @tambo-ai/react/mcp package
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,wKAAwK;;;;;;;;;;;;;;;;;AAExK,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,mEAGqC;AAFnC,2HAAA,oBAAoB,OAAA;AACpB,6HAAA,sBAAsB,OAAA;AAExB,iEAAgF;AAAvE,sHAAA,gBAAgB,OAAA;AACzB,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,0DAAwC;AACxC,2EAIyC;AAHvC,+HAAA,oBAAoB,OAAA;AAKtB,gCAAgC;AAChC,yCAwBqB;AAvBnB,gHAAA,mBAAmB,OAAA;AACnB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAC3B,oHAAA,uBAAuB,OAAA;AACvB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,qHAAA,wBAAwB,OAAA;AACxB,gHAAA,mBAAmB,OAAA;AACnB,oHAAA,uBAAuB,OAAA;AACvB,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,mHAAA,sBAAsB,OAAA;AACtB,oHAAA,uBAAuB,OAAA;AACvB,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,gHAAA,mBAAmB,OAAA;AAsBrB,+DAA+D;AAAtD,uHAAA,kBAAkB,OAAA;AAQ3B,mFAG6C;AAF3C,8HAAA,eAAe,OAAA;AAUjB,mFAIiD;AAH/C,2HAAA,qBAAqB,OAAoB;AAI3C,uFAGiD;AAF/C,8IAAA,+BAA+B,OAAA;AAC/B,mIAAA,oBAAoB,OAAA;AAGtB,0BAA0B;AAC1B,qDAG2B;AAFzB,2HAAA,wBAAwB,OAAA;AACxB,2HAAA,wBAAwB,OAAA","sourcesContent":["/** Exports for the library. Only publically available exports are re-exported here. Anything not exported here is not supported and may change or break at any time. */\n\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n} from \"./hooks/use-current-message\";\nexport { useMessageImages, type StagedImage } from \"./hooks/use-message-images\";\nexport { useTamboStreamingProps } from \"./hooks/use-streaming-props\";\nexport * from \"./hooks/use-suggestions\";\nexport {\n  useTamboStreamStatus,\n  type PropStatus,\n  type StreamStatus,\n} from \"./hooks/use-tambo-stream-status\";\n\n// Re-export provider components\nexport {\n  TamboClientProvider,\n  TamboComponentProvider,\n  TamboContextHelpersProvider,\n  TamboPropStreamProvider,\n  TamboProvider,\n  TamboStubProvider,\n  TamboThreadInputProvider,\n  TamboThreadProvider,\n  useIsTamboTokenUpdating,\n  useTambo,\n  useTamboClient,\n  useTamboContextHelpers,\n  useTamboGenerationStage,\n  useTamboStream,\n  useTamboThread,\n  useTamboThreadInput,\n  type TamboComponent,\n  type TamboContextHelpersContextProps,\n  type TamboContextHelpersProviderProps,\n  type TamboRegistryContext,\n  type TamboStubProviderProps,\n  type TamboThreadInputContextProps,\n  type TamboThreadProviderProps,\n} from \"./providers\";\n\n// Re-export types from Tambo Node SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nexport { useTamboThreadList } from \"./hooks/use-tambo-threads\";\nexport {\n  type ComponentContextToolMetadata,\n  type ComponentRegistry,\n  type ParameterSpec,\n  type RegisteredComponent,\n  type TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  type TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { type TamboThread } from \"./model/tambo-thread\";\nexport { type InitialTamboThreadMessage } from \"./providers/tambo-thread-provider\";\n\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"./model/tambo-interactable\";\nexport {\n  withTamboInteractable as withInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"./providers/hoc/with-tambo-interactable\";\nexport {\n  useCurrentInteractablesSnapshot,\n  useTamboInteractable,\n} from \"./providers/tambo-interactable-provider\";\n\n// Context helpers exports\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"./context-helpers\";\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"./context-helpers\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,wKAAwK;;;;;;;;;;;;;;;;;AAExK,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,mEAGqC;AAFnC,2HAAA,oBAAoB,OAAA;AACpB,6HAAA,sBAAsB,OAAA;AAExB,iEAAgF;AAAvE,sHAAA,gBAAgB,OAAA;AACzB,mEAAqE;AAA5D,6HAAA,sBAAsB,OAAA;AAC/B,0DAAwC;AACxC,2EAIyC;AAHvC,+HAAA,oBAAoB,OAAA;AAKtB,gCAAgC;AAChC,yCAwBqB;AAvBnB,gHAAA,mBAAmB,OAAA;AACnB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAC3B,oHAAA,uBAAuB,OAAA;AACvB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,qHAAA,wBAAwB,OAAA;AACxB,gHAAA,mBAAmB,OAAA;AACnB,oHAAA,uBAAuB,OAAA;AACvB,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,mHAAA,sBAAsB,OAAA;AACtB,oHAAA,uBAAuB,OAAA;AACvB,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,gHAAA,mBAAmB,OAAA;AAsBrB,+DAA+D;AAAtD,uHAAA,kBAAkB,OAAA;AAQ3B,mFAG6C;AAF3C,8HAAA,eAAe,OAAA;AAUjB,mFAIiD;AAH/C,2HAAA,qBAAqB,OAAoB;AAI3C,uFAGiD;AAF/C,8IAAA,+BAA+B,OAAA;AAC/B,mIAAA,oBAAoB,OAAA;AAGtB,0BAA0B;AAC1B,qDAG2B;AAFzB,2HAAA,wBAAwB,OAAA;AACxB,2HAAA,wBAAwB,OAAA;AAQ1B,yEAAyE;AACzE,8BAA8B","sourcesContent":["/** Exports for the library. Only publically available exports are re-exported here. Anything not exported here is not supported and may change or break at any time. */\n\nexport { useTamboComponentState } from \"./hooks/use-component-state\";\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n} from \"./hooks/use-current-message\";\nexport { useMessageImages, type StagedImage } from \"./hooks/use-message-images\";\nexport { useTamboStreamingProps } from \"./hooks/use-streaming-props\";\nexport * from \"./hooks/use-suggestions\";\nexport {\n  useTamboStreamStatus,\n  type PropStatus,\n  type StreamStatus,\n} from \"./hooks/use-tambo-stream-status\";\n\n// Re-export provider components\nexport {\n  TamboClientProvider,\n  TamboComponentProvider,\n  TamboContextHelpersProvider,\n  TamboPropStreamProvider,\n  TamboProvider,\n  TamboStubProvider,\n  TamboThreadInputProvider,\n  TamboThreadProvider,\n  useIsTamboTokenUpdating,\n  useTambo,\n  useTamboClient,\n  useTamboContextHelpers,\n  useTamboGenerationStage,\n  useTamboStream,\n  useTamboThread,\n  useTamboThreadInput,\n  type TamboComponent,\n  type TamboContextHelpersContextProps,\n  type TamboContextHelpersProviderProps,\n  type TamboRegistryContext,\n  type TamboStubProviderProps,\n  type TamboThreadInputContextProps,\n  type TamboThreadProviderProps,\n} from \"./providers\";\n\n// Re-export types from Tambo Node SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nexport { useTamboThreadList } from \"./hooks/use-tambo-threads\";\nexport {\n  type ComponentContextToolMetadata,\n  type ComponentRegistry,\n  type ParameterSpec,\n  type RegisteredComponent,\n  type TamboTool,\n} from \"./model/component-metadata\";\nexport {\n  GenerationStage,\n  type TamboThreadMessage,\n} from \"./model/generate-component-response\";\nexport { type TamboThread } from \"./model/tambo-thread\";\nexport { type InitialTamboThreadMessage } from \"./providers/tambo-thread-provider\";\n\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"./model/tambo-interactable\";\nexport {\n  withTamboInteractable as withInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"./providers/hoc/with-tambo-interactable\";\nexport {\n  useCurrentInteractablesSnapshot,\n  useTamboInteractable,\n} from \"./providers/tambo-interactable-provider\";\n\n// Context helpers exports\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"./context-helpers\";\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"./context-helpers\";\n\n// Note MCP exports like TamboMcpProvider are available separately in the\n// @tambo-ai/react/mcp package\n"]}

package/dist/mcp/__tests__/elicitation.test.d.ts

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

package/dist/mcp/__tests__/elicitation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.test.d.ts","sourceRoot":"","sources":["../../../src/mcp/__tests__/elicitation.test.tsx"],"names":[],"mappings":""}

package/dist/mcp/__tests__/elicitation.test.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const elicitation_1 = require("../elicitation");
+// Create a mock RequestHandlerExtra for testing
+function createMockExtra() {
+    return {
+        signal: new AbortController().signal,
+        requestId: "test-request-id",
+        sendNotification: (async () => { }),
+        sendRequest: (async () => ({ _meta: {} })),
+    };
+}
+describe("useElicitation", () => {
+    it("initializes with null state", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+        expect(result.current.elicitation).toBeNull();
+        expect(result.current.resolveElicitation).toBeNull();
+    });
+    it("provides state setters", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+        expect(typeof result.current.setElicitation).toBe("function");
+        expect(typeof result.current.setResolveElicitation).toBe("function");
+    });
+    it("provides a default elicitation handler", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+        expect(typeof result.current.defaultElicitationHandler).toBe("function");
+    });
+    describe("defaultElicitationHandler", () => {
+        it("sets elicitation state when called", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const request = {
+                params: {
+                    message: "Please provide your name",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string", description: "Your name" },
+                        },
+                        required: ["name"],
+                    },
+                },
+            };
+            // Start the handler but don't await yet
+            let handlerPromise;
+            const extra = createMockExtra();
+            (0, react_1.act)(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            // Elicitation should be set
+            expect(result.current.elicitation).toEqual({
+                message: "Please provide your name",
+                requestedSchema: request.params.requestedSchema,
+                signal: extra.signal,
+            });
+            // Resolve callback should be set
+            expect(result.current.resolveElicitation).not.toBeNull();
+            // Clean up by resolving
+            (0, react_1.act)(() => {
+                result.current.resolveElicitation?.({
+                    action: "cancel",
+                });
+            });
+            await handlerPromise;
+        });
+        it("resolves promise when resolveElicitation is called with accept", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const request = {
+                params: {
+                    message: "Enter your email",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            email: {
+                                type: "string",
+                                format: "email",
+                                description: "Email address",
+                            },
+                        },
+                    },
+                },
+            };
+            // Start the handler
+            let handlerPromise;
+            const extra = createMockExtra();
+            (0, react_1.act)(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            // Resolve with accept
+            const response = {
+                action: "accept",
+                content: { email: "test@example.com" },
+            };
+            (0, react_1.act)(() => {
+                result.current.resolveElicitation?.(response);
+            });
+            // Wait for promise to resolve
+            const resolvedValue = await handlerPromise;
+            expect(resolvedValue).toEqual(response);
+        });
+        it("resolves promise when resolveElicitation is called with decline", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const request = {
+                params: {
+                    message: "Provide input",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "string" },
+                        },
+                    },
+                },
+            };
+            let handlerPromise;
+            const extra = createMockExtra();
+            (0, react_1.act)(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            const response = {
+                action: "decline",
+            };
+            (0, react_1.act)(() => {
+                result.current.resolveElicitation?.(response);
+            });
+            const resolvedValue = await handlerPromise;
+            expect(resolvedValue).toEqual(response);
+        });
+        it("resolves promise when resolveElicitation is called with cancel", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const request = {
+                params: {
+                    message: "Provide input",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "string" },
+                        },
+                    },
+                },
+            };
+            let handlerPromise;
+            const extra = createMockExtra();
+            (0, react_1.act)(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            const response = {
+                action: "cancel",
+            };
+            (0, react_1.act)(() => {
+                result.current.resolveElicitation?.(response);
+            });
+            const resolvedValue = await handlerPromise;
+            expect(resolvedValue).toEqual(response);
+        });
+        it("handles multiple sequential elicitations", async () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            // First elicitation
+            const request1 = {
+                params: {
+                    message: "First request",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            field1: { type: "string" },
+                        },
+                    },
+                },
+            };
+            let promise1;
+            const extra1 = createMockExtra();
+            (0, react_1.act)(() => {
+                promise1 = result.current.defaultElicitationHandler(request1, extra1);
+            });
+            expect(result.current.elicitation?.message).toBe("First request");
+            (0, react_1.act)(() => {
+                result.current.resolveElicitation?.({
+                    action: "accept",
+                    content: { field1: "value1" },
+                });
+            });
+            const result1 = await promise1;
+            expect(result1).toEqual({
+                action: "accept",
+                content: { field1: "value1" },
+            });
+            // Second elicitation
+            const request2 = {
+                params: {
+                    message: "Second request",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            field2: { type: "number" },
+                        },
+                    },
+                },
+            };
+            let promise2;
+            const extra2 = createMockExtra();
+            (0, react_1.act)(() => {
+                promise2 = result.current.defaultElicitationHandler(request2, extra2);
+            });
+            expect(result.current.elicitation?.message).toBe("Second request");
+            (0, react_1.act)(() => {
+                result.current.resolveElicitation?.({
+                    action: "accept",
+                    content: { field2: 42 },
+                });
+            });
+            const result2 = await promise2;
+            expect(result2).toEqual({
+                action: "accept",
+                content: { field2: 42 },
+            });
+        });
+        it("maintains stable handler reference across re-renders", () => {
+            const { result, rerender } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const firstHandler = result.current.defaultElicitationHandler;
+            rerender();
+            const secondHandler = result.current.defaultElicitationHandler;
+            expect(firstHandler).toBe(secondHandler);
+        });
+    });
+    describe("state management", () => {
+        it("allows manual state updates via setElicitation", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const customElicitation = {
+                message: "Custom message",
+                requestedSchema: {
+                    type: "object",
+                    properties: {
+                        custom: { type: "boolean" },
+                    },
+                },
+            };
+            (0, react_1.act)(() => {
+                result.current.setElicitation(customElicitation);
+            });
+            expect(result.current.elicitation).toEqual(customElicitation);
+        });
+        it("allows clearing elicitation state", () => {
+            const { result } = (0, react_1.renderHook)(() => (0, elicitation_1.useElicitation)());
+            const elicitation = {
+                message: "Test",
+                requestedSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            };
+            (0, react_1.act)(() => {
+                result.current.setElicitation(elicitation);
+            });
+            expect(result.current.elicitation).not.toBeNull();
+            (0, react_1.act)(() => {
+                result.current.setElicitation(null);
+            });
+            expect(result.current.elicitation).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=elicitation.test.js.map

package/dist/mcp/__tests__/elicitation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elicitation.test.js","sourceRoot":"","sources":["../../../src/mcp/__tests__/elicitation.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { renderHook, act } from \"@testing-library/react\";\nimport {\n  useElicitation,\n  type TamboElicitationRequest,\n  type TamboElicitationResponse,\n} from \"../elicitation\";\nimport type { RequestHandlerExtra } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport type {\n  ClientNotification,\n  ClientRequest,\n} from \"@modelcontextprotocol/sdk/types.js\";\n\n// Create a mock RequestHandlerExtra for testing\nfunction createMockExtra(): RequestHandlerExtra<\n  ClientRequest,\n  ClientNotification\n> {\n  return {\n    signal: new AbortController().signal,\n    requestId: \"test-request-id\",\n\n    sendNotification: (async () => {}) as any,\n\n    sendRequest: (async () => ({ _meta: {} })) as any,\n  };\n}\n\ndescribe(\"useElicitation\", () => {\n  it(\"initializes with null state\", () => {\n    const { result } = renderHook(() => useElicitation());\n\n    expect(result.current.elicitation).toBeNull();\n    expect(result.current.resolveElicitation).toBeNull();\n  });\n\n  it(\"provides state setters\", () => {\n    const { result } = renderHook(() => useElicitation());\n\n    expect(typeof result.current.setElicitation).toBe(\"function\");\n    expect(typeof result.current.setResolveElicitation).toBe(\"function\");\n  });\n\n  it(\"provides a default elicitation handler\", () => {\n    const { result } = renderHook(() => useElicitation());\n\n    expect(typeof result.current.defaultElicitationHandler).toBe(\"function\");\n  });\n\n  describe(\"defaultElicitationHandler\", () => {\n    it(\"sets elicitation state when called\", async () => {\n      const { result } = renderHook(() => useElicitation());\n\n      const request: Parameters<\n        typeof result.current.defaultElicitationHandler\n      >[0] = {\n        params: {\n          message: \"Please provide your name\",\n          requestedSchema: {\n            type: \"object\",\n            properties: {\n              name: { type: \"string\", description: \"Your name\" },\n            },\n            required: [\"name\"],\n          },\n        },\n      };\n\n      // Start the handler but don't await yet\n      let handlerPromise: Promise<TamboElicitationResponse>;\n      const extra = createMockExtra();\n      act(() => {\n        handlerPromise = result.current.defaultElicitationHandler(\n          request,\n          extra,\n        );\n      });\n\n      // Elicitation should be set\n      expect(result.current.elicitation).toEqual({\n        message: \"Please provide your name\",\n        requestedSchema: request.params.requestedSchema,\n        signal: extra.signal,\n      });\n\n      // Resolve callback should be set\n      expect(result.current.resolveElicitation).not.toBeNull();\n\n      // Clean up by resolving\n      act(() => {\n        result.current.resolveElicitation?.({\n          action: \"cancel\",\n        });\n      });\n\n      await handlerPromise!;\n    });\n\n    it(\"resolves promise when resolveElicitation is called with accept\", async () => {\n      const { result } = renderHook(() => useElicitation());\n\n      const request: Parameters<\n        typeof result.current.defaultElicitationHandler\n      >[0] = {\n        params: {\n          message: \"Enter your email\",\n          requestedSchema: {\n            type: \"object\",\n            properties: {\n              email: {\n                type: \"string\",\n                format: \"email\",\n                description: \"Email address\",\n              },\n            },\n          },\n        },\n      };\n\n      // Start the handler\n      let handlerPromise: Promise<TamboElicitationResponse>;\n      const extra = createMockExtra();\n      act(() => {\n        handlerPromise = result.current.defaultElicitationHandler(\n          request,\n          extra,\n        );\n      });\n\n      // Resolve with accept\n      const response: TamboElicitationResponse = {\n        action: \"accept\",\n        content: { email: \"test@example.com\" },\n      };\n\n      act(() => {\n        result.current.resolveElicitation?.(response);\n      });\n\n      // Wait for promise to resolve\n      const resolvedValue = await handlerPromise!;\n\n      expect(resolvedValue).toEqual(response);\n    });\n\n    it(\"resolves promise when resolveElicitation is called with decline\", async () => {\n      const { result } = renderHook(() => useElicitation());\n\n      const request: Parameters<\n        typeof result.current.defaultElicitationHandler\n      >[0] = {\n        params: {\n          message: \"Provide input\",\n          requestedSchema: {\n            type: \"object\",\n            properties: {\n              value: { type: \"string\" },\n            },\n          },\n        },\n      };\n\n      let handlerPromise: Promise<TamboElicitationResponse>;\n      const extra = createMockExtra();\n      act(() => {\n        handlerPromise = result.current.defaultElicitationHandler(\n          request,\n          extra,\n        );\n      });\n\n      const response: TamboElicitationResponse = {\n        action: \"decline\",\n      };\n\n      act(() => {\n        result.current.resolveElicitation?.(response);\n      });\n\n      const resolvedValue = await handlerPromise!;\n\n      expect(resolvedValue).toEqual(response);\n    });\n\n    it(\"resolves promise when resolveElicitation is called with cancel\", async () => {\n      const { result } = renderHook(() => useElicitation());\n\n      const request: Parameters<\n        typeof result.current.defaultElicitationHandler\n      >[0] = {\n        params: {\n          message: \"Provide input\",\n          requestedSchema: {\n            type: \"object\",\n            properties: {\n              value: { type: \"string\" },\n            },\n          },\n        },\n      };\n\n      let handlerPromise: Promise<TamboElicitationResponse>;\n      const extra = createMockExtra();\n      act(() => {\n        handlerPromise = result.current.defaultElicitationHandler(\n          request,\n          extra,\n        );\n      });\n\n      const response: TamboElicitationResponse = {\n        action: \"cancel\",\n      };\n\n      act(() => {\n        result.current.resolveElicitation?.(response);\n      });\n\n      const resolvedValue = await handlerPromise!;\n\n      expect(resolvedValue).toEqual(response);\n    });\n\n    it(\"handles multiple sequential elicitations\", async () => {\n      const { result } = renderHook(() => useElicitation());\n\n      // First elicitation\n      const request1: Parameters<\n        typeof result.current.defaultElicitationHandler\n      >[0] = {\n        params: {\n          message: \"First request\",\n          requestedSchema: {\n            type: \"object\",\n            properties: {\n              field1: { type: \"string\" },\n            },\n          },\n        },\n      };\n\n      let promise1: Promise<TamboElicitationResponse>;\n      const extra1 = createMockExtra();\n      act(() => {\n        promise1 = result.current.defaultElicitationHandler(request1, extra1);\n      });\n\n      expect(result.current.elicitation?.message).toBe(\"First request\");\n\n      act(() => {\n        result.current.resolveElicitation?.({\n          action: \"accept\",\n          content: { field1: \"value1\" },\n        });\n      });\n\n      const result1 = await promise1!;\n      expect(result1).toEqual({\n        action: \"accept\",\n        content: { field1: \"value1\" },\n      });\n\n      // Second elicitation\n      const request2: Parameters<\n        typeof result.current.defaultElicitationHandler\n      >[0] = {\n        params: {\n          message: \"Second request\",\n          requestedSchema: {\n            type: \"object\",\n            properties: {\n              field2: { type: \"number\" },\n            },\n          },\n        },\n      };\n\n      let promise2: Promise<TamboElicitationResponse>;\n      const extra2 = createMockExtra();\n      act(() => {\n        promise2 = result.current.defaultElicitationHandler(request2, extra2);\n      });\n\n      expect(result.current.elicitation?.message).toBe(\"Second request\");\n\n      act(() => {\n        result.current.resolveElicitation?.({\n          action: \"accept\",\n          content: { field2: 42 },\n        });\n      });\n\n      const result2 = await promise2!;\n      expect(result2).toEqual({\n        action: \"accept\",\n        content: { field2: 42 },\n      });\n    });\n\n    it(\"maintains stable handler reference across re-renders\", () => {\n      const { result, rerender } = renderHook(() => useElicitation());\n\n      const firstHandler = result.current.defaultElicitationHandler;\n\n      rerender();\n\n      const secondHandler = result.current.defaultElicitationHandler;\n\n      expect(firstHandler).toBe(secondHandler);\n    });\n  });\n\n  describe(\"state management\", () => {\n    it(\"allows manual state updates via setElicitation\", () => {\n      const { result } = renderHook(() => useElicitation());\n\n      const customElicitation: TamboElicitationRequest = {\n        message: \"Custom message\",\n        requestedSchema: {\n          type: \"object\",\n          properties: {\n            custom: { type: \"boolean\" },\n          },\n        },\n      };\n\n      act(() => {\n        result.current.setElicitation(customElicitation);\n      });\n\n      expect(result.current.elicitation).toEqual(customElicitation);\n    });\n\n    it(\"allows clearing elicitation state\", () => {\n      const { result } = renderHook(() => useElicitation());\n\n      const elicitation: TamboElicitationRequest = {\n        message: \"Test\",\n        requestedSchema: {\n          type: \"object\",\n          properties: {},\n        },\n      };\n\n      act(() => {\n        result.current.setElicitation(elicitation);\n      });\n\n      expect(result.current.elicitation).not.toBeNull();\n\n      act(() => {\n        result.current.setElicitation(null);\n      });\n\n      expect(result.current.elicitation).toBeNull();\n    });\n  });\n});\n"]}

package/dist/mcp/__tests__/mcp-hooks.test.d.ts

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

package/dist/mcp/__tests__/mcp-hooks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-hooks.test.d.ts","sourceRoot":"","sources":["../../../src/mcp/__tests__/mcp-hooks.test.tsx"],"names":[],"mappings":""}