@tambo-ai/react 0.59.0 → 0.62.0

package/esm/hooks/use-tambo-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-voice.d.ts","sourceRoot":"","sources":["../../src/hooks/use-tambo-voice.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa;;;;;;;;EAyE5B"}

package/esm/hooks/use-tambo-voice.js

@@ -0,0 +1,71 @@
+import { useCallback, useEffect, useState } from "react";
+import { useReactMediaRecorder } from "react-media-recorder";
+import { useTamboClient } from "../providers/tambo-client-provider";
+import { useTamboMutation } from "./react-query-hooks";
+/**
+ * Exposes functionality to record speech and transcribe it using the Tambo API.
+ * @returns An object with:
+ * - startRecording: A function to start recording audio and reset the current transcript.
+ * - stopRecording: A function to stop recording audio and automatically kick off transcription.
+ * - isRecording: A boolean indicating if the user is recording audio.
+ * - isTranscribing: A boolean indicating if the audio is being transcribed.
+ * - transcript: The transcript of the recorded audio.
+ * - transcriptionError: An error message if the transcription fails.
+ * - mediaAccessError: An error message if microphone access fails.
+ */
+export function useTamboVoice() {
+    const [transcript, setTranscript] = useState(null);
+    const client = useTamboClient();
+    const { status, startRecording: startMediaRecording, stopRecording: stopMediaRecording, mediaBlobUrl, error: mediaAccessError, } = useReactMediaRecorder({
+        audio: true,
+        video: false,
+        blobPropertyBag: { type: "audio/webm" },
+    });
+    const isRecording = status === "recording";
+    const transcriptionMutation = useTamboMutation({
+        mutationFn: async (blobUrl) => {
+            const response = await fetch(blobUrl);
+            const audioBlob = await response.blob();
+            const file = new File([audioBlob], "recording.webm", {
+                type: "audio/webm",
+            });
+            return await client.beta.audio.transcribe({ file });
+        },
+        onSuccess: (transcription) => {
+            setTranscript(transcription);
+        },
+    });
+    // Trigger transcription when recording stops and we have a blob URL
+    const shouldTranscribe = status === "stopped" &&
+        mediaBlobUrl &&
+        !transcriptionMutation.isPending &&
+        !transcriptionMutation.isSuccess;
+    useEffect(() => {
+        if (shouldTranscribe) {
+            transcriptionMutation.mutate(mediaBlobUrl);
+        }
+    }, [shouldTranscribe, mediaBlobUrl, transcriptionMutation]);
+    const startRecording = useCallback(() => {
+        if (isRecording)
+            return;
+        // Reset state when starting new recording
+        setTranscript(null);
+        transcriptionMutation.reset(); // Clear any previous mutation state
+        startMediaRecording();
+    }, [isRecording, startMediaRecording, transcriptionMutation]);
+    const stopRecording = useCallback(() => {
+        if (isRecording) {
+            stopMediaRecording();
+        }
+    }, [isRecording, stopMediaRecording]);
+    return {
+        startRecording,
+        stopRecording,
+        isRecording,
+        mediaAccessError: mediaAccessError ?? null,
+        isTranscribing: transcriptionMutation.isPending,
+        transcript,
+        transcriptionError: transcriptionMutation.error?.message ?? null,
+    };
+}
+//# sourceMappingURL=use-tambo-voice.js.map

package/esm/hooks/use-tambo-voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-voice.js","sourceRoot":"","sources":["../../src/hooks/use-tambo-voice.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,EACJ,MAAM,EACN,cAAc,EAAE,mBAAmB,EACnC,aAAa,EAAE,kBAAkB,EACjC,YAAY,EACZ,KAAK,EAAE,gBAAgB,GACxB,GAAG,qBAAqB,CAAC;QACxB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,KAAK;QACZ,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;KACxC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,KAAK,WAAW,CAAC;IAE3C,MAAM,qBAAqB,GAAG,gBAAgB,CAI5C;QACA,UAAU,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;YACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,EAAE,gBAAgB,EAAE;gBACnD,IAAI,EAAE,YAAY;aACnB,CAAC,CAAC;YAEH,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,SAAS,EAAE,CAAC,aAAa,EAAE,EAAE;YAC3B,aAAa,CAAC,aAAa,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,gBAAgB,GACpB,MAAM,KAAK,SAAS;QACpB,YAAY;QACZ,CAAC,qBAAqB,CAAC,SAAS;QAChC,CAAC,qBAAqB,CAAC,SAAS,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,gBAAgB,EAAE,CAAC;YACrB,qBAAqB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,EAAE,CAAC,gBAAgB,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAE5D,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,IAAI,WAAW;YAAE,OAAO;QAExB,0CAA0C;QAC1C,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,qBAAqB,CAAC,KAAK,EAAE,CAAC,CAAC,oCAAoC;QACnE,mBAAmB,EAAE,CAAC;IACxB,CAAC,EAAE,CAAC,WAAW,EAAE,mBAAmB,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAE9D,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,IAAI,WAAW,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;QACvB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEtC,OAAO;QACL,cAAc;QACd,aAAa;QACb,WAAW;QACX,gBAAgB,EAAE,gBAAgB,IAAI,IAAI;QAC1C,cAAc,EAAE,qBAAqB,CAAC,SAAS;QAC/C,UAAU;QACV,kBAAkB,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI;KACjE,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { useReactMediaRecorder } from \"react-media-recorder\";\nimport { useTamboClient } from \"../providers/tambo-client-provider\";\nimport { useTamboMutation } from \"./react-query-hooks\";\n\n/**\n * Exposes functionality to record speech and transcribe it using the Tambo API.\n * @returns An object with:\n * - startRecording: A function to start recording audio and reset the current transcript.\n * - stopRecording: A function to stop recording audio and automatically kick off transcription.\n * - isRecording: A boolean indicating if the user is recording audio.\n * - isTranscribing: A boolean indicating if the audio is being transcribed.\n * - transcript: The transcript of the recorded audio.\n * - transcriptionError: An error message if the transcription fails.\n * - mediaAccessError: An error message if microphone access fails.\n */\nexport function useTamboVoice() {\n  const [transcript, setTranscript] = useState<string | null>(null);\n  const client = useTamboClient();\n  const {\n    status,\n    startRecording: startMediaRecording,\n    stopRecording: stopMediaRecording,\n    mediaBlobUrl,\n    error: mediaAccessError,\n  } = useReactMediaRecorder({\n    audio: true,\n    video: false,\n    blobPropertyBag: { type: \"audio/webm\" },\n  });\n\n  const isRecording = status === \"recording\";\n\n  const transcriptionMutation = useTamboMutation<\n    string,\n    Error,\n    string // blobUrl parameter\n  >({\n    mutationFn: async (blobUrl: string) => {\n      const response = await fetch(blobUrl);\n      const audioBlob = await response.blob();\n      const file = new File([audioBlob], \"recording.webm\", {\n        type: \"audio/webm\",\n      });\n\n      return await client.beta.audio.transcribe({ file });\n    },\n    onSuccess: (transcription) => {\n      setTranscript(transcription);\n    },\n  });\n\n  // Trigger transcription when recording stops and we have a blob URL\n  const shouldTranscribe =\n    status === \"stopped\" &&\n    mediaBlobUrl &&\n    !transcriptionMutation.isPending &&\n    !transcriptionMutation.isSuccess;\n\n  useEffect(() => {\n    if (shouldTranscribe) {\n      transcriptionMutation.mutate(mediaBlobUrl);\n    }\n  }, [shouldTranscribe, mediaBlobUrl, transcriptionMutation]);\n\n  const startRecording = useCallback(() => {\n    if (isRecording) return;\n\n    // Reset state when starting new recording\n    setTranscript(null);\n    transcriptionMutation.reset(); // Clear any previous mutation state\n    startMediaRecording();\n  }, [isRecording, startMediaRecording, transcriptionMutation]);\n\n  const stopRecording = useCallback(() => {\n    if (isRecording) {\n      stopMediaRecording();\n    }\n  }, [isRecording, stopMediaRecording]);\n\n  return {\n    startRecording,\n    stopRecording,\n    isRecording,\n    mediaAccessError: mediaAccessError ?? null,\n    isTranscribing: transcriptionMutation.isPending,\n    transcript,\n    transcriptionError: transcriptionMutation.error?.message ?? null,\n  };\n}\n"]}

package/esm/index.d.ts

@@ -5,6 +5,7 @@ export { useMessageImages, type StagedImage } from "./hooks/use-message-images";
 export { useTamboStreamingProps } from "./hooks/use-streaming-props";
 export * from "./hooks/use-suggestions";
 export { useTamboStreamStatus, type PropStatus, type StreamStatus, } from "./hooks/use-tambo-stream-status";
+export { useTamboVoice } from "./hooks/use-tambo-voice";
 export { TamboClientProvider, TamboComponentProvider, TamboContextHelpersProvider, TamboPropStreamProvider, TamboProvider, TamboStubProvider, TamboThreadInputProvider, TamboThreadProvider, useIsTamboTokenUpdating, useTambo, useTamboClient, useTamboContextHelpers, useTamboGenerationStage, useTamboStream, useTamboThread, useTamboThreadInput, type TamboComponent, type TamboContextHelpersContextProps, type TamboContextHelpersProviderProps, type TamboRegistryContext, type TamboStubProviderProps, type TamboThreadInputContextProps, type TamboThreadProviderProps, } from "./providers";
 export type { APIError, RateLimitError, TamboAIError, } from "@tambo-ai/typescript-sdk";
 export type { Suggestion, SuggestionGenerateParams, SuggestionGenerateResponse, SuggestionListResponse, } from "@tambo-ai/typescript-sdk/resources/beta/threads/suggestions";

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,YAAY,EACV,0BAA0B,IAAI,qBAAqB,EACnD,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,UAAU,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,YAAY,EACV,0BAA0B,IAAI,qBAAqB,EACnD,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/esm/index.js

@@ -5,6 +5,7 @@ export { useMessageImages } from "./hooks/use-message-images";
 export { useTamboStreamingProps } from "./hooks/use-streaming-props";
 export * from "./hooks/use-suggestions";
 export { useTamboStreamStatus, } from "./hooks/use-tambo-stream-status";
+export { useTamboVoice } from "./hooks/use-tambo-voice";
 // Re-export provider components
 export { TamboClientProvider, TamboComponentProvider, TamboContextHelpersProvider, TamboPropStreamProvider, TamboProvider, TamboStubProvider, TamboThreadInputProvider, TamboThreadProvider, useIsTamboTokenUpdating, useTambo, useTamboClient, useTamboContextHelpers, useTamboGenerationStage, useTamboStream, useTamboThread, useTamboThreadInput, } from "./providers";
 export { useTamboThreadList } from "./hooks/use-tambo-threads";
@@ -13,4 +14,6 @@ export { withTamboInteractable as withInteractable, } from "./providers/hoc/with
 export { useCurrentInteractablesSnapshot, useTamboInteractable, } from "./providers/tambo-interactable-provider";
 // Context helpers exports
 export { currentPageContextHelper, currentTimeContextHelper, } from "./context-helpers";
+// Note MCP exports like TamboMcpProvider are available separately in the
+// @tambo-ai/react/mcp package
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wKAAwK;AAExK,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAC;AAEzC,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,mBAAmB,GAQpB,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAQ7C,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAEjD,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC","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,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,oBAAoB,GAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,mBAAmB,GAQpB,MAAM,aAAa,CAAC;AAcrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,OAAO,EACL,eAAe,GAEhB,MAAM,qCAAqC,CAAC;AAQ7C,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAEjD,0BAA0B;AAC1B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAO3B,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\";\nexport { useTamboVoice } from \"./hooks/use-tambo-voice\";\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/esm/mcp/__tests__/elicitation.test.d.ts

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

package/esm/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/esm/mcp/__tests__/elicitation.test.js

@@ -0,0 +1,259 @@
+import { renderHook, act } from "@testing-library/react";
+import { useElicitation, } from "../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 } = renderHook(() => useElicitation());
+        expect(result.current.elicitation).toBeNull();
+        expect(result.current.resolveElicitation).toBeNull();
+    });
+    it("provides state setters", () => {
+        const { result } = renderHook(() => useElicitation());
+        expect(typeof result.current.setElicitation).toBe("function");
+        expect(typeof result.current.setResolveElicitation).toBe("function");
+    });
+    it("provides a default elicitation handler", () => {
+        const { result } = renderHook(() => useElicitation());
+        expect(typeof result.current.defaultElicitationHandler).toBe("function");
+    });
+    describe("defaultElicitationHandler", () => {
+        it("sets elicitation state when called", async () => {
+            const { result } = renderHook(() => 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();
+            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
+            act(() => {
+                result.current.resolveElicitation?.({
+                    action: "cancel",
+                });
+            });
+            await handlerPromise;
+        });
+        it("resolves promise when resolveElicitation is called with accept", async () => {
+            const { result } = renderHook(() => 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();
+            act(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            // Resolve with accept
+            const response = {
+                action: "accept",
+                content: { email: "test@example.com" },
+            };
+            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 } = renderHook(() => useElicitation());
+            const request = {
+                params: {
+                    message: "Provide input",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "string" },
+                        },
+                    },
+                },
+            };
+            let handlerPromise;
+            const extra = createMockExtra();
+            act(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            const response = {
+                action: "decline",
+            };
+            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 } = renderHook(() => useElicitation());
+            const request = {
+                params: {
+                    message: "Provide input",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            value: { type: "string" },
+                        },
+                    },
+                },
+            };
+            let handlerPromise;
+            const extra = createMockExtra();
+            act(() => {
+                handlerPromise = result.current.defaultElicitationHandler(request, extra);
+            });
+            const response = {
+                action: "cancel",
+            };
+            act(() => {
+                result.current.resolveElicitation?.(response);
+            });
+            const resolvedValue = await handlerPromise;
+            expect(resolvedValue).toEqual(response);
+        });
+        it("handles multiple sequential elicitations", async () => {
+            const { result } = renderHook(() => useElicitation());
+            // First elicitation
+            const request1 = {
+                params: {
+                    message: "First request",
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            field1: { type: "string" },
+                        },
+                    },
+                },
+            };
+            let promise1;
+            const extra1 = createMockExtra();
+            act(() => {
+                promise1 = result.current.defaultElicitationHandler(request1, extra1);
+            });
+            expect(result.current.elicitation?.message).toBe("First request");
+            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();
+            act(() => {
+                promise2 = result.current.defaultElicitationHandler(request2, extra2);
+            });
+            expect(result.current.elicitation?.message).toBe("Second request");
+            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 } = renderHook(() => 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 } = renderHook(() => useElicitation());
+            const customElicitation = {
+                message: "Custom message",
+                requestedSchema: {
+                    type: "object",
+                    properties: {
+                        custom: { type: "boolean" },
+                    },
+                },
+            };
+            act(() => {
+                result.current.setElicitation(customElicitation);
+            });
+            expect(result.current.elicitation).toEqual(customElicitation);
+        });
+        it("allows clearing elicitation state", () => {
+            const { result } = renderHook(() => useElicitation());
+            const elicitation = {
+                message: "Test",
+                requestedSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            };
+            act(() => {
+                result.current.setElicitation(elicitation);
+            });
+            expect(result.current.elicitation).not.toBeNull();
+            act(() => {
+                result.current.setElicitation(null);
+            });
+            expect(result.current.elicitation).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=elicitation.test.js.map

package/esm/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/esm/mcp/__tests__/mcp-hooks.test.d.ts

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

package/esm/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":""}