@tambo-ai/react 0.73.0 → 0.74.0

package/dist/v1/hooks/use-tambo-v1-suggestions.js

@@ -2,69 +2,67 @@
 "use client";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useTamboV1Suggestions = useTamboV1Suggestions;
+/**
+ * useTamboV1Suggestions - Suggestions Hook for v1 API
+ *
+ * Manages AI-powered suggestions for thread messages.
+ * Uses the v1 API endpoints for listing and creating suggestions.
+ */
 const react_1 = require("react");
 const tambo_client_provider_1 = require("../../providers/tambo-client-provider");
-const tambo_registry_provider_1 = require("../../providers/tambo-registry-provider");
-const registry_1 = require("../../util/registry");
 const react_query_hooks_1 = require("../../hooks/react-query-hooks");
-const query_utils_1 = require("../../util/query-utils");
+const tambo_registry_provider_1 = require("../../providers/tambo-registry-provider");
+const tambo_v1_provider_1 = require("../providers/tambo-v1-provider");
 const use_tambo_v1_1 = require("./use-tambo-v1");
 const use_tambo_v1_thread_input_1 = require("./use-tambo-v1-thread-input");
-function normalizeSuggestionGenerateResponse(response) {
-    if (response === undefined) {
-        return [];
-    }
-    if (Array.isArray(response)) {
-        return response;
-    }
-    throw new Error("Unexpected suggestions.generate response shape; expected an array");
-}
+const registry_conversion_1 = require("../utils/registry-conversion");
 /**
- * Hook for managing Tambo AI suggestions in a v1 thread.
- *
- * Automatically generates suggestions when the latest message is from the assistant
- * and the thread is idle (not streaming).
+ * Hook for managing AI-powered suggestions in a v1 thread.
  *
- * Uses the shared thread input context, so accepting a suggestion without submitting
- * will automatically update the input field value for any component using
- * useTamboV1ThreadInput.
- * @param options - Configuration options for suggestion generation
- * @returns Object containing suggestions state and control functions
+ * Provides functionality to:
+ * - Automatically generate suggestions when an assistant message arrives
+ * - Manually generate suggestions on demand
+ * - Accept suggestions by setting them as input or auto-submitting
+ * @param options - Configuration options
+ * @returns Suggestions state and control functions
  * @example
  * ```tsx
  * function SuggestionsPanel() {
- *   const { suggestions, accept, isPending } = useTamboV1Suggestions();
+ *   const {
+ *     suggestions,
+ *     accept,
+ *     isLoading,
+ *     selectedSuggestionId,
+ *   } = useTamboV1Suggestions();
+ *
+ *   if (isLoading) return <Spinner />;
  *
  *   return (
  *     <div>
- *       {suggestions.map(suggestion => (
+ *       {suggestions.map((suggestion) => (
  *         <button
  *           key={suggestion.id}
  *           onClick={() => accept({ suggestion })}
- *           disabled={isPending}
+ *           className={selectedSuggestionId === suggestion.id ? 'selected' : ''}
  *         >
- *           {suggestion.suggestion}
+ *           {suggestion.title}
  *         </button>
  *       ))}
  *     </div>
  *   );
  * }
- *
- * function ChatInput() {
- *   // This input will automatically show the accepted suggestion
- *   const { value, setValue, submit } = useTamboV1ThreadInput();
- *   return <input value={value} onChange={e => setValue(e.target.value)} />;
- * }
  * ```
  */
 function useTamboV1Suggestions(options = {}) {
-    const { maxSuggestions = 3 } = options;
-    // Use shared thread input context
-    const { setValue, submit, threadId } = (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)();
-    const { messages, isIdle } = (0, use_tambo_v1_1.useTamboV1)(threadId);
-    const tamboClient = (0, tambo_client_provider_1.useTamboClient)();
-    const { componentList, toolRegistry, componentToolAssociations } = (0, tambo_registry_provider_1.useTamboRegistry)();
+    const { maxSuggestions = 3, autoGenerate = true, queryOptions } = options;
+    const client = (0, tambo_client_provider_1.useTamboClient)();
+    const { userKey } = (0, tambo_v1_provider_1.useTamboV1Config)();
+    const { componentList } = (0, tambo_registry_provider_1.useTamboRegistry)();
+    const queryClient = (0, tambo_client_provider_1.useTamboQueryClient)();
+    const { messages, isIdle, currentThreadId } = (0, use_tambo_v1_1.useTamboV1)();
+    const { setValue: setInputValue, submit } = (0, use_tambo_v1_thread_input_1.useTamboV1ThreadInput)();
     const [selectedSuggestionId, setSelectedSuggestionId] = (0, react_1.useState)(null);
+    // Get the latest message info
     const latestMessage = messages[messages.length - 1];
     const isLatestFromAssistant = latestMessage?.role === "assistant";
     const latestMessageId = latestMessage?.id;
@@ -72,81 +70,149 @@ function useTamboV1Suggestions(options = {}) {
     (0, react_1.useEffect)(() => {
         setSelectedSuggestionId(null);
     }, [latestMessageId]);
-    const shouldGenerateSuggestions = latestMessageId && isLatestFromAssistant && isIdle && threadId;
-    // Use React Query to fetch suggestions when conditions are met
-    const suggestionsResult = (0, react_query_hooks_1.useTamboQuery)({
-        queryKey: [
-            "v1-suggestions",
-            shouldGenerateSuggestions ? latestMessageId : null,
-        ],
+    // Determine if we should fetch/generate suggestions
+    const shouldFetchSuggestions = currentThreadId &&
+        latestMessageId &&
+        isLatestFromAssistant &&
+        isIdle &&
+        autoGenerate;
+    const suggestionsQueryKey = [
+        "v1-suggestions",
+        currentThreadId ?? null,
+        latestMessageId ?? null,
+    ];
+    // Query to list existing suggestions
+    const suggestionsQuery = (0, react_query_hooks_1.useTamboQuery)({
+        queryKey: suggestionsQueryKey,
         queryFn: async () => {
-            if (!shouldGenerateSuggestions || !threadId || !latestMessageId) {
-                return [];
+            if (!shouldFetchSuggestions || !latestMessageId || !currentThreadId) {
+                return { suggestions: [], hasMore: false };
             }
-            // Get registered components from the registry
-            const components = (0, registry_1.getAvailableComponents)(componentList, toolRegistry, componentToolAssociations);
-            const response = await tamboClient.beta.threads.suggestions.generate(latestMessageId, {
-                id: threadId,
-                maxSuggestions,
-                availableComponents: components,
+            return await client.threads.suggestions.list(latestMessageId, {
+                threadId: currentThreadId,
+                userKey,
             });
-            return normalizeSuggestionGenerateResponse(response);
         },
-        enabled: Boolean(shouldGenerateSuggestions),
+        ...queryOptions,
+        enabled: Boolean(shouldFetchSuggestions),
         refetchOnWindowFocus: false,
         refetchOnReconnect: false,
         retry: false,
     });
-    // Accept suggestion mutation
-    const acceptMutationState = (0, react_query_hooks_1.useTamboMutation)({
-        mutationFn: async ({ suggestion, shouldSubmit = false }) => {
+    // Mutation to manually generate suggestions
+    const generateMutation = (0, react_query_hooks_1.useTamboMutation)({
+        mutationFn: async () => {
+            if (!currentThreadId || !latestMessageId || !isLatestFromAssistant) {
+                return undefined;
+            }
+            const availableComponents = (0, registry_conversion_1.toAvailableComponents)(componentList);
+            return await client.threads.suggestions.create(latestMessageId, {
+                threadId: currentThreadId,
+                maxSuggestions,
+                availableComponents,
+                userKey,
+            });
+        },
+        onSuccess: (data) => {
+            if (data && currentThreadId && latestMessageId) {
+                // Update the query cache with new suggestions
+                queryClient.setQueryData(suggestionsQueryKey, data);
+            }
+        },
+    });
+    const lastAutoGenerateMessageIdRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        lastAutoGenerateMessageIdRef.current = null;
+    }, [latestMessageId]);
+    const listSuggestionsCount = suggestionsQuery.data?.suggestions.length ?? 0;
+    const generateMutate = generateMutation.mutate;
+    const isGenerating = generateMutation.isPending;
+    const isListError = suggestionsQuery.isError;
+    const isListSuccess = suggestionsQuery.isSuccess;
+    (0, react_1.useEffect)(() => {
+        if (!shouldFetchSuggestions || !latestMessageId) {
+            return;
+        }
+        if (listSuggestionsCount > 0) {
+            return;
+        }
+        const shouldAutoGenerate = (isListSuccess && listSuggestionsCount === 0) || isListError;
+        if (!shouldAutoGenerate) {
+            return;
+        }
+        if (isGenerating) {
+            return;
+        }
+        if (lastAutoGenerateMessageIdRef.current === latestMessageId) {
+            return;
+        }
+        lastAutoGenerateMessageIdRef.current = latestMessageId;
+        generateMutate();
+    }, [
+        generateMutate,
+        isGenerating,
+        isListError,
+        isListSuccess,
+        latestMessageId,
+        listSuggestionsCount,
+        shouldFetchSuggestions,
+    ]);
+    // Mutation to accept a suggestion
+    const acceptMutation = (0, react_query_hooks_1.useTamboMutation)({
+        mutationFn: async ({ suggestion, shouldSubmit = false, }) => {
             const text = suggestion.detailedSuggestion?.trim();
             if (!text) {
-                throw new Error("Suggestion has no detailed content");
+                throw new Error("Suggestion has no content");
             }
             if (shouldSubmit) {
-                // Set the value first, then submit
-                setValue(text);
+                // Set value and submit
+                setInputValue(text);
                 await submit();
             }
             else {
-                // Just update the shared input value
-                setValue(text);
+                // Just set the input value
+                setInputValue(text);
             }
             setSelectedSuggestionId(suggestion.id);
         },
     });
-    // Generate suggestions mutation (for manual refresh)
-    const generateMutationState = (0, react_query_hooks_1.useTamboMutation)({
-        mutationFn: async (abortController) => {
-            if (!shouldGenerateSuggestions || !threadId || !latestMessageId) {
-                return [];
-            }
-            const components = (0, registry_1.getAvailableComponents)(componentList, toolRegistry, componentToolAssociations);
-            const response = await tamboClient.beta.threads.suggestions.generate(latestMessageId, {
-                id: threadId,
-                maxSuggestions,
-                availableComponents: components,
-            }, { signal: abortController.signal });
-            return normalizeSuggestionGenerateResponse(response);
-        },
-        retry: false,
-    });
-    // Use query data if available, otherwise use mutation data
+    // Generate callback
+    const generateMutateAsync = generateMutation.mutateAsync;
+    const generate = (0, react_1.useCallback)(async () => {
+        return await generateMutateAsync();
+    }, [generateMutateAsync]);
+    // Accept callback
+    const accept = (0, react_1.useCallback)(async (acceptOptions) => {
+        await acceptMutation.mutateAsync(acceptOptions);
+    }, [acceptMutation]);
+    // Get suggestions from query or mutation result
+    const queryData = suggestionsQuery.data;
+    const mutationData = generateMutation.data;
+    // Use mutation data if available (more recent), otherwise query data
+    const currentData = mutationData ?? queryData;
     const suggestions = isLatestFromAssistant
-        ? (suggestionsResult.data ?? generateMutationState.data ?? [])
+        ? (currentData?.suggestions ?? [])
         : [];
-    const accept = (0, react_1.useCallback)(async (acceptOptions) => {
-        await acceptMutationState.mutateAsync(acceptOptions);
-    }, [acceptMutationState]);
     return {
+        // Data
+        data: currentData,
         suggestions,
+        // Query state (matches react-query patterns)
+        isLoading: suggestionsQuery.isLoading,
+        isSuccess: suggestionsQuery.isSuccess,
+        isError: suggestionsQuery.isError,
+        error: suggestionsQuery.error,
+        isFetching: suggestionsQuery.isFetching,
+        // Generate mutation
+        generate,
+        isGenerating: generateMutation.isPending,
+        generateError: generateMutation.error,
+        // Accept mutation
         accept,
+        isAccepting: acceptMutation.isPending,
+        acceptError: acceptMutation.error,
+        // UI state
         selectedSuggestionId,
-        acceptResult: acceptMutationState,
-        generateResult: generateMutationState,
-        suggestionsResult,
-        ...(0, query_utils_1.combineMutationResults)(acceptMutationState, generateMutationState),
     };
 }
 //# sourceMappingURL=use-tambo-v1-suggestions.js.map

package/dist/v1/hooks/use-tambo-v1-suggestions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-tambo-v1-suggestions.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-suggestions.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * useTamboV1Suggestions - Suggestions Hook for v1 API\n *\n * Provides AI-generated suggestions based on the current thread state.\n * Uses the shared thread input context so accepting a suggestion\n * automatically updates the input field.\n */\n\nimport TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { useCallback, useEffect, useState } from \"react\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport { useTamboRegistry } from \"../../providers/tambo-registry-provider\";\nimport { getAvailableComponents } from \"../../util/registry\";\nimport {\n  useTamboMutation,\n  useTamboQuery,\n  type UseTamboMutationResult,\n  type UseTamboQueryResult,\n} from \"../../hooks/react-query-hooks\";\nimport {\n  CombinedMutationResult,\n  combineMutationResults,\n} from \"../../util/query-utils\";\nimport { useTamboV1 } from \"./use-tambo-v1\";\nimport { useTamboV1ThreadInput } from \"./use-tambo-v1-thread-input\";\n\ntype Suggestion = TamboAI.Beta.Threads.Suggestion;\n\n// The SDK defines this as an alias of `Suggestion[]`.\ntype SuggestionGenerateResponse =\n  TamboAI.Beta.Threads.Suggestions.SuggestionGenerateResponse;\n\ntype SuggestionsMutationData = void | SuggestionGenerateResponse;\n\nfunction normalizeSuggestionGenerateResponse(\n  response: unknown,\n): SuggestionGenerateResponse {\n  if (response === undefined) {\n    return [];\n  }\n\n  if (Array.isArray(response)) {\n    return response as SuggestionGenerateResponse;\n  }\n\n  throw new Error(\n    \"Unexpected suggestions.generate response shape; expected an array\",\n  );\n}\n\n/**\n * Configuration options for the useTamboV1Suggestions hook\n */\nexport interface UseTamboV1SuggestionsOptions {\n  /** Maximum number of suggestions to generate (1-10, default 3) */\n  maxSuggestions?: number;\n}\n\n/**\n * Return value interface for useTamboV1Suggestions hook\n */\nexport interface UseTamboV1SuggestionsResultInternal {\n  /** List of available suggestions */\n  suggestions: Suggestion[];\n\n  /** ID of the currently selected suggestion */\n  selectedSuggestionId: string | null;\n\n  /**\n   * Accept and apply a suggestion.\n   * If shouldSubmit is false, updates the shared input context value.\n   * If shouldSubmit is true, submits the suggestion directly.\n   * @param suggestion - The suggestion to accept\n   * @param shouldSubmit - Whether to automatically submit after accepting (default: false)\n   */\n  accept: (acceptOptions: {\n    suggestion: Suggestion;\n    shouldSubmit?: boolean;\n  }) => Promise<void>;\n\n  /** Result and network state for accepting a suggestion */\n  acceptResult: UseTamboMutationResult<\n    void,\n    Error,\n    { suggestion: Suggestion; shouldSubmit?: boolean }\n  >;\n\n  /** Result and network state for generating suggestions */\n  generateResult: UseTamboMutationResult<\n    SuggestionGenerateResponse,\n    Error,\n    AbortController\n  >;\n\n  /** The full suggestions query object from React Query */\n  suggestionsResult: UseTamboQueryResult<SuggestionGenerateResponse>;\n}\n\ntype UseTamboV1SuggestionsResult = CombinedMutationResult<\n  SuggestionsMutationData,\n  Error\n> &\n  UseTamboV1SuggestionsResultInternal;\n\n/**\n * Hook for managing Tambo AI suggestions in a v1 thread.\n *\n * Automatically generates suggestions when the latest message is from the assistant\n * and the thread is idle (not streaming).\n *\n * Uses the shared thread input context, so accepting a suggestion without submitting\n * will automatically update the input field value for any component using\n * useTamboV1ThreadInput.\n * @param options - Configuration options for suggestion generation\n * @returns Object containing suggestions state and control functions\n * @example\n * ```tsx\n * function SuggestionsPanel() {\n *   const { suggestions, accept, isPending } = useTamboV1Suggestions();\n *\n *   return (\n *     <div>\n *       {suggestions.map(suggestion => (\n *         <button\n *           key={suggestion.id}\n *           onClick={() => accept({ suggestion })}\n *           disabled={isPending}\n *         >\n *           {suggestion.suggestion}\n *         </button>\n *       ))}\n *     </div>\n *   );\n * }\n *\n * function ChatInput() {\n *   // This input will automatically show the accepted suggestion\n *   const { value, setValue, submit } = useTamboV1ThreadInput();\n *   return <input value={value} onChange={e => setValue(e.target.value)} />;\n * }\n * ```\n */\nexport function useTamboV1Suggestions(\n  options: UseTamboV1SuggestionsOptions = {},\n): UseTamboV1SuggestionsResult {\n  const { maxSuggestions = 3 } = options;\n\n  // Use shared thread input context\n  const { setValue, submit, threadId } = useTamboV1ThreadInput();\n\n  const { messages, isIdle } = useTamboV1(threadId);\n  const tamboClient = useTamboClient();\n  const { componentList, toolRegistry, componentToolAssociations } =\n    useTamboRegistry();\n\n  const [selectedSuggestionId, setSelectedSuggestionId] = useState<\n    string | null\n  >(null);\n\n  const latestMessage = messages[messages.length - 1];\n  const isLatestFromAssistant = latestMessage?.role === \"assistant\";\n  const latestMessageId = latestMessage?.id;\n\n  // Reset selected suggestion when the message changes\n  useEffect(() => {\n    setSelectedSuggestionId(null);\n  }, [latestMessageId]);\n\n  const shouldGenerateSuggestions =\n    latestMessageId && isLatestFromAssistant && isIdle && threadId;\n\n  // Use React Query to fetch suggestions when conditions are met\n  const suggestionsResult = useTamboQuery<SuggestionGenerateResponse>({\n    queryKey: [\n      \"v1-suggestions\",\n      shouldGenerateSuggestions ? latestMessageId : null,\n    ],\n    queryFn: async () => {\n      if (!shouldGenerateSuggestions || !threadId || !latestMessageId) {\n        return [];\n      }\n\n      // Get registered components from the registry\n      const components = getAvailableComponents(\n        componentList,\n        toolRegistry,\n        componentToolAssociations,\n      );\n\n      const response = await tamboClient.beta.threads.suggestions.generate(\n        latestMessageId,\n        {\n          id: threadId,\n          maxSuggestions,\n          availableComponents: components,\n        },\n      );\n\n      return normalizeSuggestionGenerateResponse(response);\n    },\n    enabled: Boolean(shouldGenerateSuggestions),\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n    retry: false,\n  });\n\n  // Accept suggestion mutation\n  const acceptMutationState = useTamboMutation<\n    void,\n    Error,\n    { suggestion: Suggestion; shouldSubmit?: boolean }\n  >({\n    mutationFn: async ({ suggestion, shouldSubmit = false }) => {\n      const text = suggestion.detailedSuggestion?.trim();\n      if (!text) {\n        throw new Error(\"Suggestion has no detailed content\");\n      }\n\n      if (shouldSubmit) {\n        // Set the value first, then submit\n        setValue(text);\n        await submit();\n      } else {\n        // Just update the shared input value\n        setValue(text);\n      }\n      setSelectedSuggestionId(suggestion.id);\n    },\n  });\n\n  // Generate suggestions mutation (for manual refresh)\n  const generateMutationState = useTamboMutation<\n    SuggestionGenerateResponse,\n    Error,\n    AbortController\n  >({\n    mutationFn: async (abortController: AbortController) => {\n      if (!shouldGenerateSuggestions || !threadId || !latestMessageId) {\n        return [];\n      }\n\n      const components = getAvailableComponents(\n        componentList,\n        toolRegistry,\n        componentToolAssociations,\n      );\n\n      const response = await tamboClient.beta.threads.suggestions.generate(\n        latestMessageId,\n        {\n          id: threadId,\n          maxSuggestions,\n          availableComponents: components,\n        },\n        { signal: abortController.signal },\n      );\n\n      return normalizeSuggestionGenerateResponse(response);\n    },\n    retry: false,\n  });\n\n  // Use query data if available, otherwise use mutation data\n  const suggestions = isLatestFromAssistant\n    ? (suggestionsResult.data ?? generateMutationState.data ?? [])\n    : [];\n\n  const accept = useCallback(\n    async (acceptOptions: {\n      suggestion: Suggestion;\n      shouldSubmit?: boolean;\n    }) => {\n      await acceptMutationState.mutateAsync(acceptOptions);\n    },\n    [acceptMutationState],\n  );\n\n  return {\n    suggestions,\n    accept,\n    selectedSuggestionId,\n    acceptResult: acceptMutationState,\n    generateResult: generateMutationState,\n    suggestionsResult,\n    ...combineMutationResults(acceptMutationState, generateMutationState),\n  };\n}\n"]}
+{"version":3,"file":"use-tambo-v1-suggestions.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-suggestions.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * useTamboV1Suggestions - Suggestions Hook for v1 API\n *\n * Manages AI-powered suggestions for thread messages.\n * Uses the v1 API endpoints for listing and creating suggestions.\n */\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type {\n  SuggestionCreateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/suggestions\";\nimport type { Suggestion } from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\nimport {\n  useTamboClient,\n  useTamboQueryClient,\n} from \"../../providers/tambo-client-provider\";\nimport { useTamboQuery, useTamboMutation } from \"../../hooks/react-query-hooks\";\nimport { useTamboRegistry } from \"../../providers/tambo-registry-provider\";\nimport { useTamboV1Config } from \"../providers/tambo-v1-provider\";\nimport { useTamboV1 } from \"./use-tambo-v1\";\nimport { useTamboV1ThreadInput } from \"./use-tambo-v1-thread-input\";\nimport { toAvailableComponents } from \"../utils/registry-conversion\";\n\n/**\n * Response type for suggestions queries (union of list and create responses)\n */\ntype SuggestionsQueryResponse =\n  | SuggestionListResponse\n  | SuggestionCreateResponse;\n\n/**\n * Configuration options for the useTamboV1Suggestions hook\n */\nexport interface UseTamboV1SuggestionsOptions {\n  /** Maximum number of suggestions to generate (1-10, default 3) */\n  maxSuggestions?: number;\n  /**\n   * Whether to automatically generate suggestions when the latest message is from the assistant.\n   * Default: true\n   */\n  autoGenerate?: boolean;\n  /**\n   * Additional React Query options for the suggestions query.\n   * Allows customizing caching, refetching behavior, etc.\n   */\n  queryOptions?: Omit<\n    UseQueryOptions<SuggestionsQueryResponse>,\n    \"queryKey\" | \"queryFn\" | \"enabled\"\n  >;\n}\n\n/**\n * Options for accepting a suggestion\n */\nexport interface AcceptSuggestionOptions {\n  /** The suggestion to accept */\n  suggestion: Suggestion;\n  /** Whether to automatically submit the suggestion after accepting (default: false) */\n  shouldSubmit?: boolean;\n}\n\n/**\n * Return type for useTamboV1Suggestions hook\n */\nexport interface UseTamboV1SuggestionsReturn {\n  // ---------------------------------------------------------------------------\n  // Data (mirrors react-query patterns)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * The raw response data from the suggestions query.\n   * Use this for direct access to the API response shape.\n   */\n  data: SuggestionsQueryResponse | undefined;\n\n  /** List of available suggestions for the current message (convenience accessor) */\n  suggestions: Suggestion[];\n\n  // ---------------------------------------------------------------------------\n  // Query state (matches react-query UseQueryResult)\n  // ---------------------------------------------------------------------------\n\n  /** Whether the suggestions query is loading (first fetch) */\n  isLoading: boolean;\n\n  /** Whether suggestions have been successfully loaded */\n  isSuccess: boolean;\n\n  /** Whether there was an error loading suggestions */\n  isError: boolean;\n\n  /** Error from loading suggestions, if any */\n  error: Error | null;\n\n  /** Whether the query is currently fetching (includes background refetches) */\n  isFetching: boolean;\n\n  // ---------------------------------------------------------------------------\n  // Generate mutation (for manual suggestion generation)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Manually generate new suggestions for the current message.\n   * Use this when autoGenerate is false or to refresh suggestions.\n   */\n  generate: () => Promise<SuggestionCreateResponse | undefined>;\n\n  /** Whether suggestions are being generated (mutation pending) */\n  isGenerating: boolean;\n\n  /** Error from generating suggestions, if any */\n  generateError: Error | null;\n\n  // ---------------------------------------------------------------------------\n  // Accept mutation (for applying a suggestion)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Accept and apply a suggestion.\n   * Sets the suggestion text as input value, optionally submitting it.\n   */\n  accept: (options: AcceptSuggestionOptions) => Promise<void>;\n\n  /** Whether accepting a suggestion is in progress */\n  isAccepting: boolean;\n\n  /** Error from accepting a suggestion, if any */\n  acceptError: Error | null;\n\n  // ---------------------------------------------------------------------------\n  // UI state\n  // ---------------------------------------------------------------------------\n\n  /** ID of the currently selected suggestion */\n  selectedSuggestionId: string | null;\n}\n\n/**\n * Hook for managing AI-powered suggestions in a v1 thread.\n *\n * Provides functionality to:\n * - Automatically generate suggestions when an assistant message arrives\n * - Manually generate suggestions on demand\n * - Accept suggestions by setting them as input or auto-submitting\n * @param options - Configuration options\n * @returns Suggestions state and control functions\n * @example\n * ```tsx\n * function SuggestionsPanel() {\n *   const {\n *     suggestions,\n *     accept,\n *     isLoading,\n *     selectedSuggestionId,\n *   } = useTamboV1Suggestions();\n *\n *   if (isLoading) return <Spinner />;\n *\n *   return (\n *     <div>\n *       {suggestions.map((suggestion) => (\n *         <button\n *           key={suggestion.id}\n *           onClick={() => accept({ suggestion })}\n *           className={selectedSuggestionId === suggestion.id ? 'selected' : ''}\n *         >\n *           {suggestion.title}\n *         </button>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useTamboV1Suggestions(\n  options: UseTamboV1SuggestionsOptions = {},\n): UseTamboV1SuggestionsReturn {\n  const { maxSuggestions = 3, autoGenerate = true, queryOptions } = options;\n\n  const client = useTamboClient();\n  const { userKey } = useTamboV1Config();\n  const { componentList } = useTamboRegistry();\n  const queryClient = useTamboQueryClient();\n\n  const { messages, isIdle, currentThreadId } = useTamboV1();\n  const { setValue: setInputValue, submit } = useTamboV1ThreadInput();\n\n  const [selectedSuggestionId, setSelectedSuggestionId] = useState<\n    string | null\n  >(null);\n\n  // Get the latest message info\n  const latestMessage = messages[messages.length - 1];\n  const isLatestFromAssistant = latestMessage?.role === \"assistant\";\n  const latestMessageId = latestMessage?.id;\n\n  // Reset selected suggestion when the message changes\n  useEffect(() => {\n    setSelectedSuggestionId(null);\n  }, [latestMessageId]);\n\n  // Determine if we should fetch/generate suggestions\n  const shouldFetchSuggestions =\n    currentThreadId &&\n    latestMessageId &&\n    isLatestFromAssistant &&\n    isIdle &&\n    autoGenerate;\n\n  const suggestionsQueryKey = [\n    \"v1-suggestions\",\n    currentThreadId ?? null,\n    latestMessageId ?? null,\n  ] as const;\n\n  // Query to list existing suggestions\n  const suggestionsQuery = useTamboQuery({\n    queryKey: suggestionsQueryKey,\n    queryFn: async (): Promise<SuggestionsQueryResponse> => {\n      if (!shouldFetchSuggestions || !latestMessageId || !currentThreadId) {\n        return { suggestions: [], hasMore: false };\n      }\n\n      return await client.threads.suggestions.list(latestMessageId, {\n        threadId: currentThreadId,\n        userKey,\n      });\n    },\n    ...queryOptions,\n    enabled: Boolean(shouldFetchSuggestions),\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n    retry: false,\n  });\n\n  // Mutation to manually generate suggestions\n  const generateMutation = useTamboMutation({\n    mutationFn: async () => {\n      if (!currentThreadId || !latestMessageId || !isLatestFromAssistant) {\n        return undefined;\n      }\n\n      const availableComponents = toAvailableComponents(componentList);\n\n      return await client.threads.suggestions.create(latestMessageId, {\n        threadId: currentThreadId,\n        maxSuggestions,\n        availableComponents,\n        userKey,\n      });\n    },\n    onSuccess: (data) => {\n      if (data && currentThreadId && latestMessageId) {\n        // Update the query cache with new suggestions\n        queryClient.setQueryData(suggestionsQueryKey, data);\n      }\n    },\n  });\n\n  const lastAutoGenerateMessageIdRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    lastAutoGenerateMessageIdRef.current = null;\n  }, [latestMessageId]);\n\n  const listSuggestionsCount = suggestionsQuery.data?.suggestions.length ?? 0;\n  const generateMutate = generateMutation.mutate;\n  const isGenerating = generateMutation.isPending;\n  const isListError = suggestionsQuery.isError;\n  const isListSuccess = suggestionsQuery.isSuccess;\n\n  useEffect(() => {\n    if (!shouldFetchSuggestions || !latestMessageId) {\n      return;\n    }\n\n    if (listSuggestionsCount > 0) {\n      return;\n    }\n\n    const shouldAutoGenerate =\n      (isListSuccess && listSuggestionsCount === 0) || isListError;\n\n    if (!shouldAutoGenerate) {\n      return;\n    }\n\n    if (isGenerating) {\n      return;\n    }\n\n    if (lastAutoGenerateMessageIdRef.current === latestMessageId) {\n      return;\n    }\n\n    lastAutoGenerateMessageIdRef.current = latestMessageId;\n    generateMutate();\n  }, [\n    generateMutate,\n    isGenerating,\n    isListError,\n    isListSuccess,\n    latestMessageId,\n    listSuggestionsCount,\n    shouldFetchSuggestions,\n  ]);\n\n  // Mutation to accept a suggestion\n  const acceptMutation = useTamboMutation({\n    mutationFn: async ({\n      suggestion,\n      shouldSubmit = false,\n    }: AcceptSuggestionOptions) => {\n      const text = suggestion.detailedSuggestion?.trim();\n      if (!text) {\n        throw new Error(\"Suggestion has no content\");\n      }\n\n      if (shouldSubmit) {\n        // Set value and submit\n        setInputValue(text);\n        await submit();\n      } else {\n        // Just set the input value\n        setInputValue(text);\n      }\n\n      setSelectedSuggestionId(suggestion.id);\n    },\n  });\n\n  // Generate callback\n  const generateMutateAsync = generateMutation.mutateAsync;\n  const generate = useCallback(async () => {\n    return await generateMutateAsync();\n  }, [generateMutateAsync]);\n\n  // Accept callback\n  const accept = useCallback(\n    async (acceptOptions: AcceptSuggestionOptions) => {\n      await acceptMutation.mutateAsync(acceptOptions);\n    },\n    [acceptMutation],\n  );\n\n  // Get suggestions from query or mutation result\n  const queryData = suggestionsQuery.data;\n  const mutationData = generateMutation.data;\n\n  // Use mutation data if available (more recent), otherwise query data\n  const currentData = mutationData ?? queryData;\n  const suggestions = isLatestFromAssistant\n    ? (currentData?.suggestions ?? [])\n    : [];\n\n  return {\n    // Data\n    data: currentData,\n    suggestions,\n\n    // Query state (matches react-query patterns)\n    isLoading: suggestionsQuery.isLoading,\n    isSuccess: suggestionsQuery.isSuccess,\n    isError: suggestionsQuery.isError,\n    error: suggestionsQuery.error,\n    isFetching: suggestionsQuery.isFetching,\n\n    // Generate mutation\n    generate,\n    isGenerating: generateMutation.isPending,\n    generateError: generateMutation.error,\n\n    // Accept mutation\n    accept,\n    isAccepting: acceptMutation.isPending,\n    acceptError: acceptMutation.error,\n\n    // UI state\n    selectedSuggestionId,\n  };\n}\n"]}