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

package/dist/react/index.cjs

@@ -3145,33 +3145,33 @@ var require_detect_libc = __commonJS({
       }
       return null;
     };
-    var version2 = async () => {
-      let version3 = null;
+    var version3 = async () => {
+      let version4 = null;
       if (isLinux()) {
-        version3 = await versionFromFilesystem();
-        if (!version3) {
-          version3 = versionFromReport();
+        version4 = await versionFromFilesystem();
+        if (!version4) {
+          version4 = versionFromReport();
         }
-        if (!version3) {
+        if (!version4) {
           const out = await safeCommand();
-          version3 = versionFromCommand(out);
+          version4 = versionFromCommand(out);
         }
       }
-      return version3;
+      return version4;
     };
     var versionSync = () => {
-      let version3 = null;
+      let version4 = null;
       if (isLinux()) {
-        version3 = versionFromFilesystemSync();
-        if (!version3) {
-          version3 = versionFromReport();
+        version4 = versionFromFilesystemSync();
+        if (!version4) {
+          version4 = versionFromReport();
         }
-        if (!version3) {
+        if (!version4) {
           const out = safeCommandSync();
-          version3 = versionFromCommand(out);
+          version4 = versionFromCommand(out);
         }
       }
-      return version3;
+      return version4;
     };
     module2.exports = {
       GLIBC,
@@ -3180,7 +3180,7 @@ var require_detect_libc = __commonJS({
       familySync,
       isNonGlibcLinux,
       isNonGlibcLinuxSync,
-      version: version2,
+      version: version3,
       versionSync
     };
   }
@@ -3370,31 +3370,31 @@ var require_semver = __commonJS({
     var parseOptions = require_parse_options();
     var { compareIdentifiers } = require_identifiers();
     var SemVer = class _SemVer {
-      constructor(version2, options) {
+      constructor(version3, options) {
         options = parseOptions(options);
-        if (version2 instanceof _SemVer) {
-          if (version2.loose === !!options.loose && version2.includePrerelease === !!options.includePrerelease) {
-            return version2;
+        if (version3 instanceof _SemVer) {
+          if (version3.loose === !!options.loose && version3.includePrerelease === !!options.includePrerelease) {
+            return version3;
           } else {
-            version2 = version2.version;
+            version3 = version3.version;
           }
-        } else if (typeof version2 !== "string") {
-          throw new TypeError(`Invalid version. Must be a string. Got type "${typeof version2}".`);
+        } else if (typeof version3 !== "string") {
+          throw new TypeError(`Invalid version. Must be a string. Got type "${typeof version3}".`);
         }
-        if (version2.length > MAX_LENGTH) {
+        if (version3.length > MAX_LENGTH) {
           throw new TypeError(
             `version is longer than ${MAX_LENGTH} characters`
           );
         }
-        debug("SemVer", version2, options);
+        debug("SemVer", version3, options);
         this.options = options;
         this.loose = !!options.loose;
         this.includePrerelease = !!options.includePrerelease;
-        const m = version2.trim().match(options.loose ? re[t.LOOSE] : re[t.FULL]);
+        const m = version3.trim().match(options.loose ? re[t.LOOSE] : re[t.FULL]);
         if (!m) {
-          throw new TypeError(`Invalid Version: ${version2}`);
+          throw new TypeError(`Invalid Version: ${version3}`);
         }
-        this.raw = version2;
+        this.raw = version3;
         this.major = +m[1];
         this.minor = +m[2];
         this.patch = +m[3];
@@ -3644,12 +3644,12 @@ var require_parse = __commonJS({
   "node_modules/.pnpm/semver@7.7.3/node_modules/semver/functions/parse.js"(exports2, module2) {
     "use strict";
     var SemVer = require_semver();
-    var parse = (version2, options, throwErrors = false) => {
-      if (version2 instanceof SemVer) {
-        return version2;
+    var parse = (version3, options, throwErrors = false) => {
+      if (version3 instanceof SemVer) {
+        return version3;
       }
       try {
-        return new SemVer(version2, options);
+        return new SemVer(version3, options);
       } catch (er) {
         if (!throwErrors) {
           return null;
@@ -3668,24 +3668,24 @@ var require_coerce = __commonJS({
     var SemVer = require_semver();
     var parse = require_parse();
     var { safeRe: re, t } = require_re();
-    var coerce = (version2, options) => {
-      if (version2 instanceof SemVer) {
-        return version2;
+    var coerce = (version3, options) => {
+      if (version3 instanceof SemVer) {
+        return version3;
       }
-      if (typeof version2 === "number") {
-        version2 = String(version2);
+      if (typeof version3 === "number") {
+        version3 = String(version3);
       }
-      if (typeof version2 !== "string") {
+      if (typeof version3 !== "string") {
         return null;
       }
       options = options || {};
       let match = null;
       if (!options.rtl) {
-        match = version2.match(options.includePrerelease ? re[t.COERCEFULL] : re[t.COERCE]);
+        match = version3.match(options.includePrerelease ? re[t.COERCEFULL] : re[t.COERCE]);
       } else {
         const coerceRtlRegex = options.includePrerelease ? re[t.COERCERTLFULL] : re[t.COERCERTL];
         let next;
-        while ((next = coerceRtlRegex.exec(version2)) && (!match || match.index + match[0].length !== version2.length)) {
+        while ((next = coerceRtlRegex.exec(version3)) && (!match || match.index + match[0].length !== version3.length)) {
           if (!match || next.index + next[0].length !== match.index + match[0].length) {
             match = next;
           }
@@ -3914,19 +3914,19 @@ var require_comparator = __commonJS({
       toString() {
         return this.value;
       }
-      test(version2) {
-        debug("Comparator.test", version2, this.options.loose);
-        if (this.semver === ANY || version2 === ANY) {
+      test(version3) {
+        debug("Comparator.test", version3, this.options.loose);
+        if (this.semver === ANY || version3 === ANY) {
           return true;
         }
-        if (typeof version2 === "string") {
+        if (typeof version3 === "string") {
           try {
-            version2 = new SemVer(version2, this.options);
+            version3 = new SemVer(version3, this.options);
           } catch (er) {
             return false;
           }
         }
-        return cmp(version2, this.operator, this.semver, this.options);
+        return cmp(version3, this.operator, this.semver, this.options);
       }
       intersects(comp, options) {
         if (!(comp instanceof _Comparator)) {
@@ -4102,19 +4102,19 @@ var require_range = __commonJS({
         });
       }
       // if ANY of the sets match ALL of its comparators, then pass
-      test(version2) {
-        if (!version2) {
+      test(version3) {
+        if (!version3) {
           return false;
         }
-        if (typeof version2 === "string") {
+        if (typeof version3 === "string") {
           try {
-            version2 = new SemVer(version2, this.options);
+            version3 = new SemVer(version3, this.options);
           } catch (er) {
             return false;
           }
         }
         for (let i = 0; i < this.set.length; i++) {
-          if (testSet(this.set[i], version2, this.options)) {
+          if (testSet(this.set[i], version3, this.options)) {
             return true;
           }
         }
@@ -4329,13 +4329,13 @@ var require_range = __commonJS({
       }
       return `${from} ${to}`.trim();
     };
-    var testSet = (set, version2, options) => {
+    var testSet = (set, version3, options) => {
       for (let i = 0; i < set.length; i++) {
-        if (!set[i].test(version2)) {
+        if (!set[i].test(version3)) {
           return false;
         }
       }
-      if (version2.prerelease.length && !options.includePrerelease) {
+      if (version3.prerelease.length && !options.includePrerelease) {
         for (let i = 0; i < set.length; i++) {
           debug(set[i].semver);
           if (set[i].semver === Comparator.ANY) {
@@ -4343,7 +4343,7 @@ var require_range = __commonJS({
           }
           if (set[i].semver.prerelease.length > 0) {
             const allowed = set[i].semver;
-            if (allowed.major === version2.major && allowed.minor === version2.minor && allowed.patch === version2.patch) {
+            if (allowed.major === version3.major && allowed.minor === version3.minor && allowed.patch === version3.patch) {
               return true;
             }
           }
@@ -4360,13 +4360,13 @@ var require_satisfies = __commonJS({
   "node_modules/.pnpm/semver@7.7.3/node_modules/semver/functions/satisfies.js"(exports2, module2) {
     "use strict";
     var Range = require_range();
-    var satisfies = (version2, range, options) => {
+    var satisfies = (version3, range, options) => {
       try {
         range = new Range(range, options);
       } catch (er) {
         return false;
       }
-      return range.test(version2);
+      return range.test(version3);
     };
     module2.exports = satisfies;
   }
@@ -38191,9 +38191,9 @@ ${fake_token_around_image}${global_img_token}` + image_token.repeat(image_seq_le
               );
             } else if (typeof process !== "undefined" && process?.release?.name === "node") {
               const IS_CI = !!process.env?.TESTING_REMOTELY;
-              const version2 = _env_js__WEBPACK_IMPORTED_MODULE_2__.env.version;
+              const version3 = _env_js__WEBPACK_IMPORTED_MODULE_2__.env.version;
               const headers = new Headers();
-              headers.set("User-Agent", `transformers.js/${version2}; is_ci/${IS_CI};`);
+              headers.set("User-Agent", `transformers.js/${version3}; is_ci/${IS_CI};`);
               const isHFURL = isValidUrl(urlOrPath, ["http:", "https:"], ["huggingface.co", "hf.co"]);
               if (isHFURL) {
                 const token = process.env?.HF_TOKEN ?? process.env?.HF_ACCESS_TOKEN;
@@ -46682,7 +46682,9 @@ __export(index_exports, {
   useEncryption: () => useEncryption,
   useImageGeneration: () => useImageGeneration,
   useMemory: () => useMemory,
-  useModels: () => useModels
+  useModels: () => useModels,
+  usePdf: () => usePdf,
+  useSearch: () => useSearch
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -48447,6 +48449,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";
@@ -48820,23 +48832,100 @@ function useMemory(options = {}) {
   };
 }
 
-// src/react/useModels.ts
+// src/react/usePdf.ts
 var import_react4 = require("react");
+
+// src/lib/pdf.ts
+var pdfjs = __toESM(require("pdfjs-dist"));
+pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+async function extractTextFromPdf(pdfDataUrl) {
+  try {
+    const loadingTask = pdfjs.getDocument(pdfDataUrl);
+    const pdf = await loadingTask.promise;
+    const textParts = [];
+    for (let i = 1; i <= pdf.numPages; i++) {
+      const page = await pdf.getPage(i);
+      const textContent = await page.getTextContent();
+      const pageText = textContent.items.map((item) => item.str).join(" ");
+      if (pageText.trim()) {
+        textParts.push(pageText);
+      }
+    }
+    return textParts.join("\n\n");
+  } catch (error) {
+    console.error("Error extracting text from PDF:", error);
+    throw error;
+  }
+}
+
+// src/react/usePdf.ts
+var PDF_MIME_TYPE = "application/pdf";
+function usePdf() {
+  const [isProcessing, setIsProcessing] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const extractPdfContext = (0, import_react4.useCallback)(
+    async (files) => {
+      setIsProcessing(true);
+      setError(null);
+      try {
+        const pdfFiles = files.filter(
+          (file) => file.mediaType === PDF_MIME_TYPE || file.filename?.toLowerCase().endsWith(".pdf")
+        );
+        if (pdfFiles.length === 0) {
+          return null;
+        }
+        const contexts = await Promise.all(
+          pdfFiles.map(async (file) => {
+            try {
+              const text = await extractTextFromPdf(file.url);
+              if (!text.trim()) {
+                console.warn(`No text found in PDF ${file.filename}`);
+                return null;
+              }
+              return `[Context from PDF attachment ${file.filename}]:
+${text}`;
+            } catch (err) {
+              console.error(`Failed to process PDF ${file.filename}:`, err);
+              return null;
+            }
+          })
+        );
+        const mergedContext = contexts.filter(Boolean).join("\n\n");
+        return mergedContext || null;
+      } catch (err) {
+        const processedError = err instanceof Error ? err : new Error(String(err));
+        setError(processedError);
+        throw processedError;
+      } finally {
+        setIsProcessing(false);
+      }
+    },
+    []
+  );
+  return {
+    extractPdfContext,
+    isProcessing,
+    error
+  };
+}
+
+// src/react/useModels.ts
+var import_react5 = require("react");
 function useModels(options = {}) {
   const { getToken, baseUrl = BASE_URL, provider, autoFetch = true } = options;
-  const [models, setModels] = (0, import_react4.useState)([]);
-  const [isLoading, setIsLoading] = (0, import_react4.useState)(false);
-  const [error, setError] = (0, import_react4.useState)(null);
-  const getTokenRef = (0, import_react4.useRef)(getToken);
-  const baseUrlRef = (0, import_react4.useRef)(baseUrl);
-  const providerRef = (0, import_react4.useRef)(provider);
-  const abortControllerRef = (0, import_react4.useRef)(null);
-  (0, import_react4.useEffect)(() => {
+  const [models, setModels] = (0, import_react5.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react5.useState)(false);
+  const [error, setError] = (0, import_react5.useState)(null);
+  const getTokenRef = (0, import_react5.useRef)(getToken);
+  const baseUrlRef = (0, import_react5.useRef)(baseUrl);
+  const providerRef = (0, import_react5.useRef)(provider);
+  const abortControllerRef = (0, import_react5.useRef)(null);
+  (0, import_react5.useEffect)(() => {
     getTokenRef.current = getToken;
     baseUrlRef.current = baseUrl;
     providerRef.current = provider;
   });
-  (0, import_react4.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -48844,7 +48933,7 @@ function useModels(options = {}) {
       }
     };
   }, []);
-  const fetchModels = (0, import_react4.useCallback)(async () => {
+  const fetchModels = (0, import_react5.useCallback)(async () => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
     }
@@ -48902,12 +48991,12 @@ function useModels(options = {}) {
       }
     }
   }, []);
-  const refetch = (0, import_react4.useCallback)(async () => {
+  const refetch = (0, import_react5.useCallback)(async () => {
     setModels([]);
     await fetchModels();
   }, [fetchModels]);
-  const hasFetchedRef = (0, import_react4.useRef)(false);
-  (0, import_react4.useEffect)(() => {
+  const hasFetchedRef = (0, import_react5.useRef)(false);
+  (0, import_react5.useEffect)(() => {
     if (autoFetch && !hasFetchedRef.current) {
       hasFetchedRef.current = true;
       fetchModels();
@@ -48924,13 +49013,97 @@ function useModels(options = {}) {
   };
 }
 
+// src/react/useSearch.ts
+var import_react6 = require("react");
+function useSearch(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onError } = options;
+  const [isLoading, setIsLoading] = (0, import_react6.useState)(false);
+  const [results, setResults] = (0, import_react6.useState)(null);
+  const [response, setResponse] = (0, import_react6.useState)(null);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const abortControllerRef = (0, import_react6.useRef)(null);
+  (0, import_react6.useEffect)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const search = (0, import_react6.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_react5 = require("react");
+var import_react7 = require("react");
 function useImageGeneration(options = {}) {
   const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
-  const [isLoading, setIsLoading] = (0, import_react5.useState)(false);
-  const abortControllerRef = (0, import_react5.useRef)(null);
-  (0, import_react5.useEffect)(() => {
+  const [isLoading, setIsLoading] = (0, import_react7.useState)(false);
+  const abortControllerRef = (0, import_react7.useRef)(null);
+  (0, import_react7.useEffect)(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -48938,13 +49111,13 @@ function useImageGeneration(options = {}) {
       }
     };
   }, []);
-  const stop = (0, import_react5.useCallback)(() => {
+  const stop = (0, import_react7.useCallback)(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
   }, []);
-  const generateImage = (0, import_react5.useCallback)(
+  const generateImage = (0, import_react7.useCallback)(
     async (args) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -49075,7 +49248,9 @@ var extractConversationContext = (messages, maxMessages = 3) => {
   useEncryption,
   useImageGeneration,
   useMemory,
-  useModels
+  useModels,
+  usePdf,
+  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
@@ -614,6 +688,17 @@ type UseMemoryResult = {
  */
 declare function useMemory(options?: UseMemoryOptions): UseMemoryResult;
 
+interface PdfFile {
+    url: string;
+    mediaType?: string;
+    filename?: string;
+}
+declare function usePdf(): {
+    extractPdfContext: (files: PdfFile[]) => Promise<string | null>;
+    isProcessing: boolean;
+    error: Error | null;
+};
+
 type UseModelsOptions = {
     /**
      * Custom function to get auth token for API calls
@@ -644,6 +729,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 +857,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 PdfFile, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, usePdf, 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
@@ -614,6 +688,17 @@ type UseMemoryResult = {
  */
 declare function useMemory(options?: UseMemoryOptions): UseMemoryResult;
 
+interface PdfFile {
+    url: string;
+    mediaType?: string;
+    filename?: string;
+}
+declare function usePdf(): {
+    extractPdfContext: (files: PdfFile[]) => Promise<string | null>;
+    isProcessing: boolean;
+    error: Error | null;
+};
+
 type UseModelsOptions = {
     /**
      * Custom function to get auth token for API calls
@@ -644,6 +729,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 +857,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 PdfFile, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, usePdf, 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";
@@ -2134,13 +2144,90 @@ function useMemory(options = {}) {
   };
 }
 
+// src/react/usePdf.ts
+import { useCallback as useCallback3, useState as useState2 } from "react";
+
+// src/lib/pdf.ts
+import * as pdfjs from "pdfjs-dist";
+pdfjs.GlobalWorkerOptions.workerSrc = `https://unpkg.com/pdfjs-dist@${pdfjs.version}/build/pdf.worker.min.mjs`;
+async function extractTextFromPdf(pdfDataUrl) {
+  try {
+    const loadingTask = pdfjs.getDocument(pdfDataUrl);
+    const pdf = await loadingTask.promise;
+    const textParts = [];
+    for (let i = 1; i <= pdf.numPages; i++) {
+      const page = await pdf.getPage(i);
+      const textContent = await page.getTextContent();
+      const pageText = textContent.items.map((item) => item.str).join(" ");
+      if (pageText.trim()) {
+        textParts.push(pageText);
+      }
+    }
+    return textParts.join("\n\n");
+  } catch (error) {
+    console.error("Error extracting text from PDF:", error);
+    throw error;
+  }
+}
+
+// src/react/usePdf.ts
+var PDF_MIME_TYPE = "application/pdf";
+function usePdf() {
+  const [isProcessing, setIsProcessing] = useState2(false);
+  const [error, setError] = useState2(null);
+  const extractPdfContext = useCallback3(
+    async (files) => {
+      setIsProcessing(true);
+      setError(null);
+      try {
+        const pdfFiles = files.filter(
+          (file) => file.mediaType === PDF_MIME_TYPE || file.filename?.toLowerCase().endsWith(".pdf")
+        );
+        if (pdfFiles.length === 0) {
+          return null;
+        }
+        const contexts = await Promise.all(
+          pdfFiles.map(async (file) => {
+            try {
+              const text = await extractTextFromPdf(file.url);
+              if (!text.trim()) {
+                console.warn(`No text found in PDF ${file.filename}`);
+                return null;
+              }
+              return `[Context from PDF attachment ${file.filename}]:
+${text}`;
+            } catch (err) {
+              console.error(`Failed to process PDF ${file.filename}:`, err);
+              return null;
+            }
+          })
+        );
+        const mergedContext = contexts.filter(Boolean).join("\n\n");
+        return mergedContext || null;
+      } catch (err) {
+        const processedError = err instanceof Error ? err : new Error(String(err));
+        setError(processedError);
+        throw processedError;
+      } finally {
+        setIsProcessing(false);
+      }
+    },
+    []
+  );
+  return {
+    extractPdfContext,
+    isProcessing,
+    error
+  };
+}
+
 // src/react/useModels.ts
-import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef4, useState as useState2 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect3, useRef as useRef4, useState as useState3 } from "react";
 function useModels(options = {}) {
   const { getToken, baseUrl = BASE_URL, provider, autoFetch = true } = options;
-  const [models, setModels] = useState2([]);
-  const [isLoading, setIsLoading] = useState2(false);
-  const [error, setError] = useState2(null);
+  const [models, setModels] = useState3([]);
+  const [isLoading, setIsLoading] = useState3(false);
+  const [error, setError] = useState3(null);
   const getTokenRef = useRef4(getToken);
   const baseUrlRef = useRef4(baseUrl);
   const providerRef = useRef4(provider);
@@ -2158,7 +2245,7 @@ function useModels(options = {}) {
       }
     };
   }, []);
-  const fetchModels = useCallback3(async () => {
+  const fetchModels = useCallback4(async () => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
     }
@@ -2216,7 +2303,7 @@ function useModels(options = {}) {
       }
     }
   }, []);
-  const refetch = useCallback3(async () => {
+  const refetch = useCallback4(async () => {
     setModels([]);
     await fetchModels();
   }, [fetchModels]);
@@ -2238,13 +2325,97 @@ function useModels(options = {}) {
   };
 }
 
+// src/react/useSearch.ts
+import { useCallback as useCallback5, useEffect as useEffect4, useRef as useRef5, useState as useState4 } from "react";
+function useSearch(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onError } = options;
+  const [isLoading, setIsLoading] = useState4(false);
+  const [results, setResults] = useState4(null);
+  const [response, setResponse] = useState4(null);
+  const [error, setError] = useState4(null);
+  const abortControllerRef = useRef5(null);
+  useEffect4(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const search = useCallback5(
+    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 useCallback4, useEffect as useEffect4, useRef as useRef5, useState as useState3 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect5, useRef as useRef6, useState as useState5 } from "react";
 function useImageGeneration(options = {}) {
   const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
-  const [isLoading, setIsLoading] = useState3(false);
-  const abortControllerRef = useRef5(null);
-  useEffect4(() => {
+  const [isLoading, setIsLoading] = useState5(false);
+  const abortControllerRef = useRef6(null);
+  useEffect5(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -2252,13 +2423,13 @@ function useImageGeneration(options = {}) {
       }
     };
   }, []);
-  const stop = useCallback4(() => {
+  const stop = useCallback6(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
   }, []);
-  const generateImage = useCallback4(
+  const generateImage = useCallback6(
     async (args) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -2388,5 +2559,7 @@ export {
   useEncryption,
   useImageGeneration,
   useMemory,
-  useModels
+  useModels,
+  usePdf,
+  useSearch
 };

package/package.json

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