@reverbia/sdk 1.0.0-next.20251202225102 → 1.0.0-next.20251203130707

package/dist/react/index.cjs

@@ -46682,7 +46682,8 @@ __export(index_exports, {
   useEncryption: () => useEncryption,
   useImageGeneration: () => useImageGeneration,
   useMemory: () => useMemory,
-  useModels: () => useModels
+  useModels: () => useModels,
+  useSearch: () => useSearch
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -48447,6 +48448,16 @@ var getApiV1Models = (options) => {
     ...options
   });
 };
+var postApiV1Search = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/v1/search",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 
 // src/lib/memory/constants.ts
 var DEFAULT_LOCAL_EMBEDDING_MODEL = "Snowflake/snowflake-arctic-embed-xs";
@@ -48924,11 +48935,14 @@ function useModels(options = {}) {
   };
 }
 
-// src/react/useImageGeneration.ts
+// src/react/useSearch.ts
 var import_react5 = require("react");
-function useImageGeneration(options = {}) {
-  const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
+function useSearch(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onError } = options;
   const [isLoading, setIsLoading] = (0, import_react5.useState)(false);
+  const [results, setResults] = (0, import_react5.useState)(null);
+  const [response, setResponse] = (0, import_react5.useState)(null);
+  const [error, setError] = (0, import_react5.useState)(null);
   const abortControllerRef = (0, import_react5.useRef)(null);
   (0, import_react5.useEffect)(() => {
     return () => {
@@ -48938,13 +48952,94 @@ function useImageGeneration(options = {}) {
       }
     };
   }, []);
-  const stop = (0, import_react5.useCallback)(() => {
+  const search = (0, import_react5.useCallback)(
+    async (query, searchOptions = {}) => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      setError(null);
+      setResults(null);
+      setResponse(null);
+      try {
+        let token;
+        if (getToken) {
+          token = await getToken() ?? void 0;
+        }
+        if (abortController.signal.aborted) return null;
+        const queryArray = Array.isArray(query) ? query : [query];
+        const res = await postApiV1Search({
+          baseUrl,
+          body: {
+            query: queryArray,
+            ...searchOptions
+          },
+          headers: token ? {
+            Authorization: `Bearer ${token}`
+          } : void 0,
+          signal: abortController.signal
+        });
+        if (res.error) {
+          const errorMsg = res.error.error || res.error.message || "Failed to perform search";
+          throw new Error(errorMsg);
+        }
+        if (res.data) {
+          setResponse(res.data);
+          setResults(res.data.results || []);
+          return res.data;
+        }
+        return null;
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return null;
+        }
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        if (onError) {
+          onError(errorObj);
+        }
+        return null;
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          setIsLoading(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [baseUrl, getToken, onError]
+  );
+  return {
+    isLoading,
+    search,
+    results,
+    response,
+    error
+  };
+}
+
+// src/react/useImageGeneration.ts
+var import_react6 = require("react");
+function useImageGeneration(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
+  const [isLoading, setIsLoading] = (0, import_react6.useState)(false);
+  const abortControllerRef = (0, import_react6.useRef)(null);
+  (0, import_react6.useEffect)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const stop = (0, import_react6.useCallback)(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
   }, []);
-  const generateImage = (0, import_react5.useCallback)(
+  const generateImage = (0, import_react6.useCallback)(
     async (args) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -49075,7 +49170,8 @@ var extractConversationContext = (messages, maxMessages = 3) => {
   useEncryption,
   useImageGeneration,
   useMemory,
-  useModels
+  useModels,
+  useSearch
 });
 /*! Bundled license information:
 

package/dist/react/index.d.mts

@@ -288,6 +288,80 @@ type LlmapiModelTopProvider = {
  * Role is the message role (system, user, assistant)
  */
 type LlmapiRole = string;
+/**
+ * ExtraFields contains additional metadata.
+ */
+type LlmapiSearchExtraFields = {
+    /**
+     * RequestType is always "search".
+     */
+    request_type?: string;
+    /**
+     * SearchProvider is the search provider used (e.g., "perplexity", "google-pse").
+     */
+    search_provider?: string;
+};
+type LlmapiSearchRequest = {
+    /**
+     * Country code filter (e.g., "US", "GB", "DE").
+     */
+    country?: string;
+    /**
+     * Maximum number of results to return (1-20). Default: 10.
+     */
+    max_results?: number;
+    /**
+     * Maximum tokens per page to process. Default: 1024.
+     */
+    max_tokens_per_page?: number;
+    /**
+     * Search query. Can be a single string or array of strings.
+     */
+    query?: Array<string>;
+    /**
+     * List of domains to filter results (max 20 domains).
+     */
+    search_domain_filter?: Array<string>;
+    /**
+     * The search provider to use.
+     */
+    search_tool_name?: string;
+};
+type LlmapiSearchResponse = {
+    extra_fields?: LlmapiSearchExtraFields;
+    /**
+     * List of search results.
+     */
+    results?: Array<LlmapiSearchResult>;
+    usage?: LlmapiSearchUsage;
+};
+type LlmapiSearchResult = {
+    /**
+     * Optional publication or last updated date.
+     */
+    date?: string;
+    /**
+     * Text snippet from the result.
+     */
+    snippet?: string;
+    /**
+     * Title of the search result.
+     */
+    title?: string;
+    /**
+     * URL of the search result.
+     */
+    url?: string;
+};
+/**
+ * Usage contains usage information.
+ */
+type LlmapiSearchUsage = {
+    /**
+     * CostMicroUSD is the cost of this search in micro-dollars (USD × 1,000,000).
+     */
+    cost_micro_usd?: number;
+};
 
 /**
  * Parameter definition for a client-side tool
@@ -644,6 +718,47 @@ type UseModelsResult = {
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 
+type UseSearchOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Callback function to be called when an error is encountered.
+     */
+    onError?: (error: Error) => void;
+};
+type SearchOptions = Omit<LlmapiSearchRequest, "query">;
+type UseSearchResult = {
+    isLoading: boolean;
+    search: (query: string | string[], options?: SearchOptions) => Promise<LlmapiSearchResponse | null>;
+    results: LlmapiSearchResult[] | null;
+    response: LlmapiSearchResponse | null;
+    error: Error | null;
+};
+/**
+ * React hook for performing search operations using the AI SDK.
+ *
+ * @param options - Configuration options for the search hook
+ * @returns Object containing search function, results, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { search, results, isLoading } = useSearch({
+ *   getToken: async () => "my-token"
+ * });
+ *
+ * const handleSearch = async () => {
+ *   await search("What is ZetaChain?");
+ * };
+ * ```
+ */
+declare function useSearch(options?: UseSearchOptions): UseSearchResult;
+
 type UseImageGenerationOptions = {
     /**
      * Custom function to get auth token for API calls
@@ -731,4 +846,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels };
+export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, useSearch };

package/dist/react/index.d.ts

@@ -288,6 +288,80 @@ type LlmapiModelTopProvider = {
  * Role is the message role (system, user, assistant)
  */
 type LlmapiRole = string;
+/**
+ * ExtraFields contains additional metadata.
+ */
+type LlmapiSearchExtraFields = {
+    /**
+     * RequestType is always "search".
+     */
+    request_type?: string;
+    /**
+     * SearchProvider is the search provider used (e.g., "perplexity", "google-pse").
+     */
+    search_provider?: string;
+};
+type LlmapiSearchRequest = {
+    /**
+     * Country code filter (e.g., "US", "GB", "DE").
+     */
+    country?: string;
+    /**
+     * Maximum number of results to return (1-20). Default: 10.
+     */
+    max_results?: number;
+    /**
+     * Maximum tokens per page to process. Default: 1024.
+     */
+    max_tokens_per_page?: number;
+    /**
+     * Search query. Can be a single string or array of strings.
+     */
+    query?: Array<string>;
+    /**
+     * List of domains to filter results (max 20 domains).
+     */
+    search_domain_filter?: Array<string>;
+    /**
+     * The search provider to use.
+     */
+    search_tool_name?: string;
+};
+type LlmapiSearchResponse = {
+    extra_fields?: LlmapiSearchExtraFields;
+    /**
+     * List of search results.
+     */
+    results?: Array<LlmapiSearchResult>;
+    usage?: LlmapiSearchUsage;
+};
+type LlmapiSearchResult = {
+    /**
+     * Optional publication or last updated date.
+     */
+    date?: string;
+    /**
+     * Text snippet from the result.
+     */
+    snippet?: string;
+    /**
+     * Title of the search result.
+     */
+    title?: string;
+    /**
+     * URL of the search result.
+     */
+    url?: string;
+};
+/**
+ * Usage contains usage information.
+ */
+type LlmapiSearchUsage = {
+    /**
+     * CostMicroUSD is the cost of this search in micro-dollars (USD × 1,000,000).
+     */
+    cost_micro_usd?: number;
+};
 
 /**
  * Parameter definition for a client-side tool
@@ -644,6 +718,47 @@ type UseModelsResult = {
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 
+type UseSearchOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Callback function to be called when an error is encountered.
+     */
+    onError?: (error: Error) => void;
+};
+type SearchOptions = Omit<LlmapiSearchRequest, "query">;
+type UseSearchResult = {
+    isLoading: boolean;
+    search: (query: string | string[], options?: SearchOptions) => Promise<LlmapiSearchResponse | null>;
+    results: LlmapiSearchResult[] | null;
+    response: LlmapiSearchResponse | null;
+    error: Error | null;
+};
+/**
+ * React hook for performing search operations using the AI SDK.
+ *
+ * @param options - Configuration options for the search hook
+ * @returns Object containing search function, results, loading state, and error
+ *
+ * @example
+ * ```tsx
+ * const { search, results, isLoading } = useSearch({
+ *   getToken: async () => "my-token"
+ * });
+ *
+ * const handleSearch = async () => {
+ *   await search("What is ZetaChain?");
+ * };
+ * ```
+ */
+declare function useSearch(options?: UseSearchOptions): UseSearchResult;
+
 type UseImageGenerationOptions = {
     /**
      * Custom function to get auth token for API calls
@@ -731,4 +846,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels };
+export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, useSearch };

package/dist/react/index.mjs

@@ -1761,6 +1761,16 @@ var getApiV1Models = (options) => {
     ...options
   });
 };
+var postApiV1Search = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/v1/search",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 
 // src/lib/memory/constants.ts
 var DEFAULT_LOCAL_EMBEDDING_MODEL = "Snowflake/snowflake-arctic-embed-xs";
@@ -2238,11 +2248,14 @@ function useModels(options = {}) {
   };
 }
 
-// src/react/useImageGeneration.ts
+// src/react/useSearch.ts
 import { useCallback as useCallback4, useEffect as useEffect4, useRef as useRef5, useState as useState3 } from "react";
-function useImageGeneration(options = {}) {
-  const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
+function useSearch(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onError } = options;
   const [isLoading, setIsLoading] = useState3(false);
+  const [results, setResults] = useState3(null);
+  const [response, setResponse] = useState3(null);
+  const [error, setError] = useState3(null);
   const abortControllerRef = useRef5(null);
   useEffect4(() => {
     return () => {
@@ -2252,13 +2265,94 @@ function useImageGeneration(options = {}) {
       }
     };
   }, []);
-  const stop = useCallback4(() => {
+  const search = useCallback4(
+    async (query, searchOptions = {}) => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      setError(null);
+      setResults(null);
+      setResponse(null);
+      try {
+        let token;
+        if (getToken) {
+          token = await getToken() ?? void 0;
+        }
+        if (abortController.signal.aborted) return null;
+        const queryArray = Array.isArray(query) ? query : [query];
+        const res = await postApiV1Search({
+          baseUrl,
+          body: {
+            query: queryArray,
+            ...searchOptions
+          },
+          headers: token ? {
+            Authorization: `Bearer ${token}`
+          } : void 0,
+          signal: abortController.signal
+        });
+        if (res.error) {
+          const errorMsg = res.error.error || res.error.message || "Failed to perform search";
+          throw new Error(errorMsg);
+        }
+        if (res.data) {
+          setResponse(res.data);
+          setResults(res.data.results || []);
+          return res.data;
+        }
+        return null;
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return null;
+        }
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        setError(errorObj);
+        if (onError) {
+          onError(errorObj);
+        }
+        return null;
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          setIsLoading(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [baseUrl, getToken, onError]
+  );
+  return {
+    isLoading,
+    search,
+    results,
+    response,
+    error
+  };
+}
+
+// src/react/useImageGeneration.ts
+import { useCallback as useCallback5, useEffect as useEffect5, useRef as useRef6, useState as useState4 } from "react";
+function useImageGeneration(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
+  const [isLoading, setIsLoading] = useState4(false);
+  const abortControllerRef = useRef6(null);
+  useEffect5(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const stop = useCallback5(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
   }, []);
-  const generateImage = useCallback4(
+  const generateImage = useCallback5(
     async (args) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -2388,5 +2482,6 @@ export {
   useEncryption,
   useImageGeneration,
   useMemory,
-  useModels
+  useModels,
+  useSearch
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251202225102",
+  "version": "1.0.0-next.20251203130707",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -57,7 +57,7 @@
   "homepage": "https://github.com/zeta-chain/ai-sdk#readme",
   "dependencies": {
     "@huggingface/transformers": "^3.8.0",
-    "@reverbia/portal": "1.0.0-next.20251201184846",
+    "@reverbia/portal": "1.0.0-next.20251202220311",
     "ai": "5.0.93"
   },
   "devDependencies": {