@docsearch/react 4.5.0-beta.0 → 4.5.0-beta.2

package/dist/esm/index.d.ts

@@ -121,11 +121,26 @@ interface SearchIndexTool {
         hits?: any[];
     };
 }
+interface AgentStudioSearchTool {
+    input: {
+        index: string;
+        query: string;
+        number_of_results: number;
+        facet_filters: any | null;
+    };
+    output: {
+        hits?: any[];
+        nbHits?: number;
+        queryID?: string;
+    };
+}
+type Tools = {
+    searchIndex: SearchIndexTool;
+    algolia_search_index: AgentStudioSearchTool;
+};
 type AIMessage = UIMessage<{
     stopped?: boolean;
-}, UIDataTypes, {
-    searchIndex: SearchIndexTool;
-}>;
+}, UIDataTypes, Tools>;
 
 type StoredDocSearchHit = Omit<DocSearchHit, '_highlightResult' | '_snippetResult'>;
 type StoredAskAiMessage = AIMessage & {
@@ -183,7 +198,7 @@ type DocSearchAskAi = {
     /**
      * The assistant ID to use for the ask AI feature.
      */
-    assistantId: string | null;
+    assistantId: string;
     /**
      * The search parameters to use for the ask AI feature.
      */
@@ -231,13 +246,16 @@ interface DocSearchProps {
      * Return `true` to prevent the default modal Ask AI flow (no toggle, no sendMessage).
      * Useful to route Ask AI into a different UI (e.g. `@docsearch/sidepanel-js`) without flicker.
      */
+    interceptAskAiEvent?: (initialMessage: InitialAskAiMessage) => boolean | void;
     /**
-     * Intercept Ask AI events (prompt submit, suggested question selection, etc).
+     * **Experimental:** Whether to use Agent Studio as the chat backend.
+     *
+     * This is an experimental feature and its API may change without notice in future releases.
+     * Use with caution in production environments.
      *
-     * Return `true` to prevent *all* default Ask AI behavior that would normally follow
-     * (no toggle, no sendMessage, no internal Ask AI state updates).
+     * @default false
      */
-    interceptAskAiEvent?: (initialMessage: InitialAskAiMessage) => boolean | void;
+    agentStudio?: boolean;
     /**
      * Theme overrides applied to the modal and related components.
      */
@@ -488,21 +506,31 @@ type DocSearchModalProps = DocSearchProps & {
     translations?: ModalTranslations;
     isHybridModeSupported?: boolean;
 };
-declare function DocSearchModal({ appId, apiKey, askAi, maxResultsPerGroup, theme, onClose, transformItems, hitComponent, resultsFooterComponent, navigator, initialScrollY, transformSearchClient, disableUserPersonalization, initialQuery: initialQueryFromProp, translations, getMissingResultsUrl, insights, onAskAiToggle, interceptAskAiEvent, isAskAiActive, recentSearchesLimit, recentSearchesWithFavoritesLimit, indices, indexName, searchParameters, isHybridModeSupported, ...props }: DocSearchModalProps): JSX.Element;
+declare function DocSearchModal({ appId, apiKey, askAi, maxResultsPerGroup, theme, onClose, transformItems, hitComponent, resultsFooterComponent, navigator, initialScrollY, transformSearchClient, disableUserPersonalization, initialQuery: initialQueryFromProp, translations, getMissingResultsUrl, insights, onAskAiToggle, interceptAskAiEvent, isAskAiActive, recentSearchesLimit, recentSearchesWithFavoritesLimit, indices, indexName, searchParameters, isHybridModeSupported, agentStudio, ...props }: DocSearchModalProps): JSX.Element;
 
 interface UseDocSearchKeyboardEventsProps {
     isOpen: boolean;
     onOpen: () => void;
     onClose: () => void;
+    /**
+     * Deprecated: Still here for backwards compat.
+     *
+     * @deprecated
+     */
     onInput?: (event: KeyboardEvent) => void;
-    searchButtonRef: React.RefObject<HTMLButtonElement | null>;
+    /**
+     * Deprecated: Still here for backwards compat.
+     *
+     * @deprecated
+     */
+    searchButtonRef?: React.RefObject<HTMLButtonElement | null>;
     isAskAiActive: boolean;
     onAskAiToggle: (toggle: boolean) => void;
     keyboardShortcuts?: KeyboardShortcuts;
 }
-declare function useDocSearchKeyboardEvents({ isOpen, onOpen, onClose, onInput, isAskAiActive, onAskAiToggle, searchButtonRef, keyboardShortcuts, }: UseDocSearchKeyboardEventsProps): void;
+declare function useDocSearchKeyboardEvents({ isOpen, onOpen, onClose, isAskAiActive, onAskAiToggle, keyboardShortcuts, }: UseDocSearchKeyboardEventsProps): void;
 
-declare const version = "4.5.0-beta.0";
+declare const version = "4.5.0-beta.2";
 
 export { DocSearch, DocSearchButton, DocSearchInner, DocSearchModal, useDocSearchKeyboardEvents, version };
 export type { AskAiSearchParameters, ButtonTranslations, DocSearchAskAi, DocSearchButtonProps, DocSearchHit, DocSearchIndex, DocSearchModalProps, DocSearchProps, DocSearchState, DocSearchTheme, DocSearchTransformClient, DocSearchTranslations, InternalDocSearchHit, KeyboardShortcuts, ModalTranslations, StoredAskAiMessage, StoredAskAiState, StoredDocSearchHit, SuggestedQuestion, SuggestedQuestionHit, UseDocSearchKeyboardEventsProps };