@reverbia/sdk 1.0.0-next.20251208094446 → 1.0.0-next.20251208111334

package/dist/index.d.mts

@@ -40,11 +40,11 @@ type LlmapiChatCompletionRequest = {
     /**
      * Messages is the conversation history
      */
-    messages?: Array<LlmapiMessage>;
+    messages: Array<LlmapiMessage>;
     /**
      * Model is the model identifier
      */
-    model?: string;
+    model: string;
     /**
      * Stream indicates if response should be streamed
      */
@@ -149,11 +149,11 @@ type LlmapiEmbeddingRequest = {
     /**
      * Input text or tokens to embed (can be string, []string, []int, or [][]int)
      */
-    input?: unknown;
+    input: unknown;
     /**
      * Model identifier in 'provider/model' format
      */
-    model?: string;
+    model: string;
 };
 type LlmapiEmbeddingResponse = {
     /**
@@ -219,11 +219,11 @@ type LlmapiImageGenerationRequest = {
     /**
      * Model is the model identifier to use for generation (e.g., "gpt-image-1").
      */
-    model?: string;
+    model: string;
     /**
      * Prompt is the text description of the desired image.
      */
-    prompt?: string;
+    prompt: string;
     /**
      * Quality targets a quality preset (e.g., "auto", "high").
      */
@@ -466,7 +466,7 @@ type LlmapiSearchRequest = {
     /**
      * Search query. Can be a single string or array of strings.
      */
-    query?: Array<string>;
+    query: Array<string>;
     /**
      * List of domains to filter results (max 20 domains).
      */
@@ -474,7 +474,7 @@ type LlmapiSearchRequest = {
     /**
      * The search provider to use.
      */
-    search_tool_name?: string;
+    search_tool_name: string;
 };
 type LlmapiSearchResponse = {
     extra_fields?: LlmapiSearchExtraFields;

package/dist/index.d.ts

@@ -40,11 +40,11 @@ type LlmapiChatCompletionRequest = {
     /**
      * Messages is the conversation history
      */
-    messages?: Array<LlmapiMessage>;
+    messages: Array<LlmapiMessage>;
     /**
      * Model is the model identifier
      */
-    model?: string;
+    model: string;
     /**
      * Stream indicates if response should be streamed
      */
@@ -149,11 +149,11 @@ type LlmapiEmbeddingRequest = {
     /**
      * Input text or tokens to embed (can be string, []string, []int, or [][]int)
      */
-    input?: unknown;
+    input: unknown;
     /**
      * Model identifier in 'provider/model' format
      */
-    model?: string;
+    model: string;
 };
 type LlmapiEmbeddingResponse = {
     /**
@@ -219,11 +219,11 @@ type LlmapiImageGenerationRequest = {
     /**
      * Model is the model identifier to use for generation (e.g., "gpt-image-1").
      */
-    model?: string;
+    model: string;
     /**
      * Prompt is the text description of the desired image.
      */
-    prompt?: string;
+    prompt: string;
     /**
      * Quality targets a quality preset (e.g., "auto", "high").
      */
@@ -466,7 +466,7 @@ type LlmapiSearchRequest = {
     /**
      * Search query. Can be a single string or array of strings.
      */
-    query?: Array<string>;
+    query: Array<string>;
     /**
      * List of domains to filter results (max 20 domains).
      */
@@ -474,7 +474,7 @@ type LlmapiSearchRequest = {
     /**
      * The search provider to use.
      */
-    search_tool_name?: string;
+    search_tool_name: string;
 };
 type LlmapiSearchResponse = {
     extra_fields?: LlmapiSearchExtraFields;

package/dist/react/index.cjs

@@ -47400,6 +47400,7 @@ __export(index_exports, {
   useImageGeneration: () => useImageGeneration,
   useMemory: () => useMemory,
   useModels: () => useModels,
+  useOCR: () => useOCR,
   usePdf: () => usePdf,
   useSearch: () => useSearch
 });
@@ -49064,7 +49065,7 @@ var generateEmbeddingForText = async (text, options = {}) => {
       baseUrl,
       body: {
         input: text,
-        model: model2
+        model: model2 ?? DEFAULT_API_EMBEDDING_MODEL
       },
       headers: {
         Authorization: `Bearer ${token}`
@@ -49439,6 +49440,31 @@ async function extractTextFromPdf(pdfDataUrl) {
     throw error;
   }
 }
+async function convertPdfToImages(pdfDataUrl) {
+  const images = [];
+  try {
+    const loadingTask = pdfjs.getDocument(pdfDataUrl);
+    const pdf = await loadingTask.promise;
+    for (let i = 1; i <= pdf.numPages; i++) {
+      const page = await pdf.getPage(i);
+      const viewport = page.getViewport({ scale: 1.5 });
+      const canvas = document.createElement("canvas");
+      const context = canvas.getContext("2d");
+      if (!context) continue;
+      canvas.height = viewport.height;
+      canvas.width = viewport.width;
+      await page.render({
+        canvasContext: context,
+        viewport
+      }).promise;
+      images.push(canvas.toDataURL("image/png"));
+    }
+  } catch (error) {
+    console.error("Error converting PDF to images:", error);
+    throw error;
+  }
+  return images;
+}
 
 // src/react/usePdf.ts
 var PDF_MIME_TYPE = "application/pdf";
@@ -49491,23 +49517,114 @@ ${text}`;
   };
 }
 
-// src/react/useModels.ts
+// src/react/useOCR.ts
 var import_react4 = require("react");
+var import_tesseract = __toESM(require("tesseract.js"));
+function useOCR() {
+  const [isProcessing, setIsProcessing] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
+  const extractOCRContext = (0, import_react4.useCallback)(
+    async (files) => {
+      setIsProcessing(true);
+      setError(null);
+      try {
+        if (files.length === 0) {
+          return null;
+        }
+        const contexts = await Promise.all(
+          files.map(async (file) => {
+            try {
+              let imagesToProcess = [];
+              const language = file.language || "eng";
+              const filename = file.filename || (file.url instanceof File ? file.url.name : "");
+              let isPdf = false;
+              if (typeof file.url === "string") {
+                isPdf = file.url.toLowerCase().endsWith(".pdf") || (filename?.toLowerCase().endsWith(".pdf") ?? false);
+              } else if (file.url instanceof Blob) {
+                isPdf = file.url.type === "application/pdf" || (filename?.toLowerCase().endsWith(".pdf") ?? false);
+              }
+              if (isPdf) {
+                let pdfUrl;
+                let shouldRevoke = false;
+                if (typeof file.url === "string") {
+                  pdfUrl = file.url;
+                } else {
+                  pdfUrl = URL.createObjectURL(file.url);
+                  shouldRevoke = true;
+                }
+                try {
+                  const pdfImages = await convertPdfToImages(pdfUrl);
+                  imagesToProcess = pdfImages;
+                } catch (e) {
+                  console.error("Failed to convert PDF to images", e);
+                  throw e;
+                } finally {
+                  if (shouldRevoke) {
+                    URL.revokeObjectURL(pdfUrl);
+                  }
+                }
+              } else {
+                imagesToProcess = [file.url];
+              }
+              const pageTexts = [];
+              for (const image of imagesToProcess) {
+                const result = await import_tesseract.default.recognize(image, language);
+                pageTexts.push(result.data.text);
+              }
+              const text = pageTexts.join("\n\n");
+              if (!text.trim()) {
+                console.warn(
+                  `No text found in OCR source ${filename || "unknown"}`
+                );
+                return null;
+              }
+              return `[Context from OCR attachment ${filename || "unknown"}]:
+${text}`;
+            } catch (err) {
+              console.error(
+                `Failed to process OCR for ${file.filename || "unknown"}:`,
+                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 {
+    extractOCRContext,
+    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();
@@ -49515,7 +49632,7 @@ function useModels(options = {}) {
       }
     };
   }, []);
-  const fetchModels = (0, import_react4.useCallback)(async () => {
+  const fetchModels = (0, import_react5.useCallback)(async () => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
     }
@@ -49573,12 +49690,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();
@@ -49596,15 +49713,15 @@ function useModels(options = {}) {
 }
 
 // src/react/useSearch.ts
-var import_react5 = require("react");
+var import_react6 = require("react");
 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)(() => {
+  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();
@@ -49612,7 +49729,7 @@ function useSearch(options = {}) {
       }
     };
   }, []);
-  const search = (0, import_react5.useCallback)(
+  const search = (0, import_react6.useCallback)(
     async (query, searchOptions = {}) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -49680,12 +49797,12 @@ function useSearch(options = {}) {
 }
 
 // src/react/useImageGeneration.ts
-var import_react6 = require("react");
+var import_react7 = 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)(() => {
+  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();
@@ -49693,13 +49810,13 @@ function useImageGeneration(options = {}) {
       }
     };
   }, []);
-  const stop = (0, import_react6.useCallback)(() => {
+  const stop = (0, import_react7.useCallback)(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
   }, []);
-  const generateImage = (0, import_react6.useCallback)(
+  const generateImage = (0, import_react7.useCallback)(
     async (args) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -49836,6 +49953,7 @@ init_selector();
   useImageGeneration,
   useMemory,
   useModels,
+  useOCR,
   usePdf,
   useSearch
 });

package/dist/react/index.d.mts

@@ -98,11 +98,11 @@ type LlmapiImageGenerationRequest = {
     /**
      * Model is the model identifier to use for generation (e.g., "gpt-image-1").
      */
-    model?: string;
+    model: string;
     /**
      * Prompt is the text description of the desired image.
      */
-    prompt?: string;
+    prompt: string;
     /**
      * Quality targets a quality preset (e.g., "auto", "high").
      */
@@ -301,32 +301,6 @@ type LlmapiSearchExtraFields = {
      */
     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;
     /**
@@ -722,6 +696,17 @@ declare function usePdf(): {
     error: Error | null;
 };
 
+interface OCRFile {
+    url: string | File | Blob;
+    filename?: string;
+    language?: string;
+}
+declare function useOCR(): {
+    extractOCRContext: (files: OCRFile[]) => Promise<string | null>;
+    isProcessing: boolean;
+    error: Error | null;
+};
+
 type UseModelsOptions = {
     /**
      * Custom function to get auth token for API calls
@@ -766,7 +751,28 @@ type UseSearchOptions = {
      */
     onError?: (error: Error) => void;
 };
-type SearchOptions = Omit<LlmapiSearchRequest, "query">;
+type SearchOptions = {
+    /**
+     * Country code for search results (e.g., "us", "gb")
+     */
+    country?: string;
+    /**
+     * Maximum number of results to return
+     */
+    max_results?: number;
+    /**
+     * Maximum tokens per page
+     */
+    max_tokens_per_page?: number;
+    /**
+     * List of domains to filter results (max 20 domains)
+     */
+    search_domain_filter?: string[];
+    /**
+     * The search provider to use
+     */
+    search_tool_name?: string;
+};
 type UseSearchResult = {
     isLoading: boolean;
     search: (query: string | string[], options?: SearchOptions) => Promise<LlmapiSearchResponse | null>;
@@ -880,4 +886,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type PdfFile, type SignMessageFn, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, hasEncryptionKey, requestEncryptionKey, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, usePdf, useSearch };
+export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type OCRFile, type PdfFile, type SignMessageFn, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, hasEncryptionKey, requestEncryptionKey, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, useOCR, usePdf, useSearch };

package/dist/react/index.d.ts

@@ -98,11 +98,11 @@ type LlmapiImageGenerationRequest = {
     /**
      * Model is the model identifier to use for generation (e.g., "gpt-image-1").
      */
-    model?: string;
+    model: string;
     /**
      * Prompt is the text description of the desired image.
      */
-    prompt?: string;
+    prompt: string;
     /**
      * Quality targets a quality preset (e.g., "auto", "high").
      */
@@ -301,32 +301,6 @@ type LlmapiSearchExtraFields = {
      */
     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;
     /**
@@ -722,6 +696,17 @@ declare function usePdf(): {
     error: Error | null;
 };
 
+interface OCRFile {
+    url: string | File | Blob;
+    filename?: string;
+    language?: string;
+}
+declare function useOCR(): {
+    extractOCRContext: (files: OCRFile[]) => Promise<string | null>;
+    isProcessing: boolean;
+    error: Error | null;
+};
+
 type UseModelsOptions = {
     /**
      * Custom function to get auth token for API calls
@@ -766,7 +751,28 @@ type UseSearchOptions = {
      */
     onError?: (error: Error) => void;
 };
-type SearchOptions = Omit<LlmapiSearchRequest, "query">;
+type SearchOptions = {
+    /**
+     * Country code for search results (e.g., "us", "gb")
+     */
+    country?: string;
+    /**
+     * Maximum number of results to return
+     */
+    max_results?: number;
+    /**
+     * Maximum tokens per page
+     */
+    max_tokens_per_page?: number;
+    /**
+     * List of domains to filter results (max 20 domains)
+     */
+    search_domain_filter?: string[];
+    /**
+     * The search provider to use
+     */
+    search_tool_name?: string;
+};
 type UseSearchResult = {
     isLoading: boolean;
     search: (query: string | string[], options?: SearchOptions) => Promise<LlmapiSearchResponse | null>;
@@ -880,4 +886,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type PdfFile, type SignMessageFn, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, hasEncryptionKey, requestEncryptionKey, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, usePdf, useSearch };
+export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type OCRFile, type PdfFile, type SignMessageFn, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, hasEncryptionKey, requestEncryptionKey, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels, useOCR, usePdf, useSearch };

package/dist/react/index.mjs

@@ -1665,7 +1665,7 @@ var generateEmbeddingForText = async (text, options = {}) => {
       baseUrl,
       body: {
         input: text,
-        model: model2
+        model: model2 ?? DEFAULT_API_EMBEDDING_MODEL
       },
       headers: {
         Authorization: `Bearer ${token}`
@@ -2040,6 +2040,31 @@ async function extractTextFromPdf(pdfDataUrl) {
     throw error;
   }
 }
+async function convertPdfToImages(pdfDataUrl) {
+  const images = [];
+  try {
+    const loadingTask = pdfjs.getDocument(pdfDataUrl);
+    const pdf = await loadingTask.promise;
+    for (let i = 1; i <= pdf.numPages; i++) {
+      const page = await pdf.getPage(i);
+      const viewport = page.getViewport({ scale: 1.5 });
+      const canvas = document.createElement("canvas");
+      const context = canvas.getContext("2d");
+      if (!context) continue;
+      canvas.height = viewport.height;
+      canvas.width = viewport.width;
+      await page.render({
+        canvasContext: context,
+        viewport
+      }).promise;
+      images.push(canvas.toDataURL("image/png"));
+    }
+  } catch (error) {
+    console.error("Error converting PDF to images:", error);
+    throw error;
+  }
+  return images;
+}
 
 // src/react/usePdf.ts
 var PDF_MIME_TYPE = "application/pdf";
@@ -2092,13 +2117,104 @@ ${text}`;
   };
 }
 
+// src/react/useOCR.ts
+import { useCallback as useCallback4, useState as useState3 } from "react";
+import Tesseract from "tesseract.js";
+function useOCR() {
+  const [isProcessing, setIsProcessing] = useState3(false);
+  const [error, setError] = useState3(null);
+  const extractOCRContext = useCallback4(
+    async (files) => {
+      setIsProcessing(true);
+      setError(null);
+      try {
+        if (files.length === 0) {
+          return null;
+        }
+        const contexts = await Promise.all(
+          files.map(async (file) => {
+            try {
+              let imagesToProcess = [];
+              const language = file.language || "eng";
+              const filename = file.filename || (file.url instanceof File ? file.url.name : "");
+              let isPdf = false;
+              if (typeof file.url === "string") {
+                isPdf = file.url.toLowerCase().endsWith(".pdf") || (filename?.toLowerCase().endsWith(".pdf") ?? false);
+              } else if (file.url instanceof Blob) {
+                isPdf = file.url.type === "application/pdf" || (filename?.toLowerCase().endsWith(".pdf") ?? false);
+              }
+              if (isPdf) {
+                let pdfUrl;
+                let shouldRevoke = false;
+                if (typeof file.url === "string") {
+                  pdfUrl = file.url;
+                } else {
+                  pdfUrl = URL.createObjectURL(file.url);
+                  shouldRevoke = true;
+                }
+                try {
+                  const pdfImages = await convertPdfToImages(pdfUrl);
+                  imagesToProcess = pdfImages;
+                } catch (e) {
+                  console.error("Failed to convert PDF to images", e);
+                  throw e;
+                } finally {
+                  if (shouldRevoke) {
+                    URL.revokeObjectURL(pdfUrl);
+                  }
+                }
+              } else {
+                imagesToProcess = [file.url];
+              }
+              const pageTexts = [];
+              for (const image of imagesToProcess) {
+                const result = await Tesseract.recognize(image, language);
+                pageTexts.push(result.data.text);
+              }
+              const text = pageTexts.join("\n\n");
+              if (!text.trim()) {
+                console.warn(
+                  `No text found in OCR source ${filename || "unknown"}`
+                );
+                return null;
+              }
+              return `[Context from OCR attachment ${filename || "unknown"}]:
+${text}`;
+            } catch (err) {
+              console.error(
+                `Failed to process OCR for ${file.filename || "unknown"}:`,
+                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 {
+    extractOCRContext,
+    isProcessing,
+    error
+  };
+}
+
 // src/react/useModels.ts
-import { useCallback as useCallback4, useEffect as useEffect2, useRef as useRef3, useState as useState3 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect2, useRef as useRef3, useState as useState4 } from "react";
 function useModels(options = {}) {
   const { getToken, baseUrl = BASE_URL, provider, autoFetch = true } = options;
-  const [models, setModels] = useState3([]);
-  const [isLoading, setIsLoading] = useState3(false);
-  const [error, setError] = useState3(null);
+  const [models, setModels] = useState4([]);
+  const [isLoading, setIsLoading] = useState4(false);
+  const [error, setError] = useState4(null);
   const getTokenRef = useRef3(getToken);
   const baseUrlRef = useRef3(baseUrl);
   const providerRef = useRef3(provider);
@@ -2116,7 +2232,7 @@ function useModels(options = {}) {
       }
     };
   }, []);
-  const fetchModels = useCallback4(async () => {
+  const fetchModels = useCallback5(async () => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
     }
@@ -2174,7 +2290,7 @@ function useModels(options = {}) {
       }
     }
   }, []);
-  const refetch = useCallback4(async () => {
+  const refetch = useCallback5(async () => {
     setModels([]);
     await fetchModels();
   }, [fetchModels]);
@@ -2197,13 +2313,13 @@ function useModels(options = {}) {
 }
 
 // src/react/useSearch.ts
-import { useCallback as useCallback5, useEffect as useEffect3, useRef as useRef4, useState as useState4 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect3, useRef as useRef4, useState as useState5 } 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 [isLoading, setIsLoading] = useState5(false);
+  const [results, setResults] = useState5(null);
+  const [response, setResponse] = useState5(null);
+  const [error, setError] = useState5(null);
   const abortControllerRef = useRef4(null);
   useEffect3(() => {
     return () => {
@@ -2213,7 +2329,7 @@ function useSearch(options = {}) {
       }
     };
   }, []);
-  const search = useCallback5(
+  const search = useCallback6(
     async (query, searchOptions = {}) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -2281,10 +2397,10 @@ function useSearch(options = {}) {
 }
 
 // src/react/useImageGeneration.ts
-import { useCallback as useCallback6, useEffect as useEffect4, useRef as useRef5, useState as useState5 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect4, useRef as useRef5, useState as useState6 } from "react";
 function useImageGeneration(options = {}) {
   const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
-  const [isLoading, setIsLoading] = useState5(false);
+  const [isLoading, setIsLoading] = useState6(false);
   const abortControllerRef = useRef5(null);
   useEffect4(() => {
     return () => {
@@ -2294,13 +2410,13 @@ function useImageGeneration(options = {}) {
       }
     };
   }, []);
-  const stop = useCallback6(() => {
+  const stop = useCallback7(() => {
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
   }, []);
-  const generateImage = useCallback6(
+  const generateImage = useCallback7(
     async (args) => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -2433,6 +2549,7 @@ export {
   useImageGeneration,
   useMemory,
   useModels,
+  useOCR,
   usePdf,
   useSearch
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251208094446",
+  "version": "1.0.0-next.20251208111334",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -72,9 +72,10 @@
   "homepage": "https://github.com/zeta-chain/ai-sdk#readme",
   "dependencies": {
     "@huggingface/transformers": "^3.8.0",
+    "@reverbia/portal": "1.0.0-next.20251208093751",
+    "ai": "5.0.93",
     "pdfjs-dist": "^4.10.38",
-    "@reverbia/portal": "1.0.0-next.20251202220311",
-    "ai": "5.0.93"
+    "tesseract.js": "^6.0.1"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "0.87.2",