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

package/dist/react/index.cjs

@@ -46680,8 +46680,10 @@ __export(index_exports, {
   selectTool: () => selectTool,
   useChat: () => useChat,
   useEncryption: () => useEncryption,
+  useImageGeneration: () => useImageGeneration,
   useMemory: () => useMemory,
-  useModels: () => useModels
+  useModels: () => useModels,
+  useSearch: () => useSearch
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -48430,12 +48432,32 @@ var postApiV1Embeddings = (options) => {
     }
   });
 };
+var postApiV1ImagesGenerations = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/v1/images/generations",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var getApiV1Models = (options) => {
   return (options?.client ?? client).get({
     url: "/api/v1/models",
     ...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";
@@ -48913,6 +48935,172 @@ function useModels(options = {}) {
   };
 }
 
+// src/react/useSearch.ts
+var import_react5 = 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)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  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_react6.useCallback)(
+    async (args) => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      try {
+        if (!getToken) {
+          throw new Error("Token getter function is required.");
+        }
+        const token = await getToken();
+        if (!token) {
+          throw new Error("No access token available.");
+        }
+        const response = await postApiV1ImagesGenerations({
+          baseUrl,
+          body: args,
+          headers: {
+            Authorization: `Bearer ${token}`
+          },
+          signal: abortController.signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error || "Failed to generate image";
+          throw new Error(errorMsg);
+        }
+        if (!response.data) {
+          throw new Error("No data received from image generation API");
+        }
+        const result = response.data;
+        if (onFinish) {
+          onFinish(result);
+        }
+        return { data: result, error: null };
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return { data: null, error: "Request aborted" };
+        }
+        const errorMsg = err instanceof Error ? err.message : "Failed to generate image.";
+        const errorObj = err instanceof Error ? err : new Error(errorMsg);
+        if (onError) {
+          onError(errorObj);
+        }
+        return { data: null, error: errorMsg };
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          setIsLoading(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [getToken, baseUrl, onFinish, onError]
+  );
+  return {
+    isLoading,
+    generateImage,
+    stop
+  };
+}
+
 // src/lib/memory/chat.ts
 var formatMemoriesForChat = (memories, format = "compact") => {
   if (memories.length === 0) {
@@ -48980,8 +49168,10 @@ var extractConversationContext = (messages, maxMessages = 3) => {
   selectTool,
   useChat,
   useEncryption,
+  useImageGeneration,
   useMemory,
-  useModels
+  useModels,
+  useSearch
 });
 /*! Bundled license information:
 

package/dist/react/index.d.mts

@@ -67,6 +67,96 @@ type LlmapiChoice = {
     index?: number;
     message?: LlmapiMessage;
 };
+/**
+ * ExtraFields contains additional metadata such as provider/model information.
+ */
+type LlmapiImageGenerationExtraFields = {
+    /**
+     * ModelRequested is the model identifier that the client asked for.
+     */
+    model_requested?: string;
+    /**
+     * Provider is the gateway that serviced this request.
+     */
+    provider?: string;
+    /**
+     * RequestType is always "image_generation".
+     */
+    request_type?: string;
+};
+type LlmapiImageGenerationImage = {
+    /**
+     * B64JSON is the base64 payload for models that can only return binary.
+     */
+    b64_json?: string;
+    /**
+     * URL is the signed URL to download the image.
+     */
+    url?: string;
+};
+type LlmapiImageGenerationRequest = {
+    /**
+     * Model is the model identifier to use for generation (e.g., "gpt-image-1").
+     */
+    model?: string;
+    /**
+     * Prompt is the text description of the desired image.
+     */
+    prompt?: string;
+    /**
+     * Quality targets a quality preset (e.g., "auto", "high").
+     */
+    quality?: string;
+    /**
+     * ResponseFormat controls how the generated image is returned (e.g., "url" or "b64_json").
+     */
+    response_format?: string;
+    /**
+     * Size controls the dimensions of the generated image (e.g., "1024x1024").
+     */
+    size?: string;
+};
+type LlmapiImageGenerationResponse = {
+    /**
+     * Created is the Unix timestamp when the image was generated.
+     */
+    created?: number;
+    extra_fields?: LlmapiImageGenerationExtraFields;
+    /**
+     * Images contains the generated images.
+     */
+    images?: Array<LlmapiImageGenerationImage>;
+    /**
+     * Model is the model identifier that generated the image.
+     */
+    model?: string;
+    /**
+     * Provider is the gateway that produced the image.
+     */
+    provider?: string;
+    usage?: LlmapiImageGenerationUsage;
+};
+/**
+ * Usage documents token usage (when available).
+ */
+type LlmapiImageGenerationUsage = {
+    /**
+     * CostMicroUSD is the inference cost for this image generation request
+     */
+    cost_micro_usd?: number;
+    /**
+     * InputTokens is the number of tokens sent in the prompt.
+     */
+    input_tokens?: number;
+    /**
+     * OutputTokens is the number of tokens returned by the model.
+     */
+    output_tokens?: number;
+    /**
+     * TotalTokens is the total number of tokens consumed.
+     */
+    total_tokens?: number;
+};
 /**
  * Message is the generated message
  */
@@ -198,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
@@ -554,6 +718,83 @@ 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
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Callback function to be called when the generation finishes successfully.
+     */
+    onFinish?: (response: LlmapiImageGenerationResponse) => void;
+    /**
+     * Callback function to be called when an unexpected error is encountered.
+     */
+    onError?: (error: Error) => void;
+};
+type GenerateImageArgs = LlmapiImageGenerationRequest;
+type GenerateImageResult = {
+    data: LlmapiImageGenerationResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseImageGenerationResult = {
+    isLoading: boolean;
+    generateImage: (args: GenerateImageArgs) => Promise<GenerateImageResult>;
+    stop: () => void;
+};
+/**
+ * React hook for generating images using the LLM API.
+ */
+declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
+
 /**
  * Format memories into a context string that can be included in chat messages
  * @param memories Array of memories with similarity scores
@@ -605,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, 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

@@ -67,6 +67,96 @@ type LlmapiChoice = {
     index?: number;
     message?: LlmapiMessage;
 };
+/**
+ * ExtraFields contains additional metadata such as provider/model information.
+ */
+type LlmapiImageGenerationExtraFields = {
+    /**
+     * ModelRequested is the model identifier that the client asked for.
+     */
+    model_requested?: string;
+    /**
+     * Provider is the gateway that serviced this request.
+     */
+    provider?: string;
+    /**
+     * RequestType is always "image_generation".
+     */
+    request_type?: string;
+};
+type LlmapiImageGenerationImage = {
+    /**
+     * B64JSON is the base64 payload for models that can only return binary.
+     */
+    b64_json?: string;
+    /**
+     * URL is the signed URL to download the image.
+     */
+    url?: string;
+};
+type LlmapiImageGenerationRequest = {
+    /**
+     * Model is the model identifier to use for generation (e.g., "gpt-image-1").
+     */
+    model?: string;
+    /**
+     * Prompt is the text description of the desired image.
+     */
+    prompt?: string;
+    /**
+     * Quality targets a quality preset (e.g., "auto", "high").
+     */
+    quality?: string;
+    /**
+     * ResponseFormat controls how the generated image is returned (e.g., "url" or "b64_json").
+     */
+    response_format?: string;
+    /**
+     * Size controls the dimensions of the generated image (e.g., "1024x1024").
+     */
+    size?: string;
+};
+type LlmapiImageGenerationResponse = {
+    /**
+     * Created is the Unix timestamp when the image was generated.
+     */
+    created?: number;
+    extra_fields?: LlmapiImageGenerationExtraFields;
+    /**
+     * Images contains the generated images.
+     */
+    images?: Array<LlmapiImageGenerationImage>;
+    /**
+     * Model is the model identifier that generated the image.
+     */
+    model?: string;
+    /**
+     * Provider is the gateway that produced the image.
+     */
+    provider?: string;
+    usage?: LlmapiImageGenerationUsage;
+};
+/**
+ * Usage documents token usage (when available).
+ */
+type LlmapiImageGenerationUsage = {
+    /**
+     * CostMicroUSD is the inference cost for this image generation request
+     */
+    cost_micro_usd?: number;
+    /**
+     * InputTokens is the number of tokens sent in the prompt.
+     */
+    input_tokens?: number;
+    /**
+     * OutputTokens is the number of tokens returned by the model.
+     */
+    output_tokens?: number;
+    /**
+     * TotalTokens is the total number of tokens consumed.
+     */
+    total_tokens?: number;
+};
 /**
  * Message is the generated message
  */
@@ -198,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
@@ -554,6 +718,83 @@ 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
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Callback function to be called when the generation finishes successfully.
+     */
+    onFinish?: (response: LlmapiImageGenerationResponse) => void;
+    /**
+     * Callback function to be called when an unexpected error is encountered.
+     */
+    onError?: (error: Error) => void;
+};
+type GenerateImageArgs = LlmapiImageGenerationRequest;
+type GenerateImageResult = {
+    data: LlmapiImageGenerationResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseImageGenerationResult = {
+    isLoading: boolean;
+    generateImage: (args: GenerateImageArgs) => Promise<GenerateImageResult>;
+    stop: () => void;
+};
+/**
+ * React hook for generating images using the LLM API.
+ */
+declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
+
 /**
  * Format memories into a context string that can be included in chat messages
  * @param memories Array of memories with similarity scores
@@ -605,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, 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

@@ -1745,12 +1745,32 @@ var postApiV1Embeddings = (options) => {
     }
   });
 };
+var postApiV1ImagesGenerations = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/v1/images/generations",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var getApiV1Models = (options) => {
   return (options?.client ?? client).get({
     url: "/api/v1/models",
     ...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";
@@ -2228,6 +2248,172 @@ function useModels(options = {}) {
   };
 }
 
+// src/react/useSearch.ts
+import { useCallback as useCallback4, useEffect as useEffect4, useRef as useRef5, useState as useState3 } from "react";
+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 () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  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 = useCallback5(
+    async (args) => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      try {
+        if (!getToken) {
+          throw new Error("Token getter function is required.");
+        }
+        const token = await getToken();
+        if (!token) {
+          throw new Error("No access token available.");
+        }
+        const response = await postApiV1ImagesGenerations({
+          baseUrl,
+          body: args,
+          headers: {
+            Authorization: `Bearer ${token}`
+          },
+          signal: abortController.signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error || "Failed to generate image";
+          throw new Error(errorMsg);
+        }
+        if (!response.data) {
+          throw new Error("No data received from image generation API");
+        }
+        const result = response.data;
+        if (onFinish) {
+          onFinish(result);
+        }
+        return { data: result, error: null };
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return { data: null, error: "Request aborted" };
+        }
+        const errorMsg = err instanceof Error ? err.message : "Failed to generate image.";
+        const errorObj = err instanceof Error ? err : new Error(errorMsg);
+        if (onError) {
+          onError(errorObj);
+        }
+        return { data: null, error: errorMsg };
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          setIsLoading(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [getToken, baseUrl, onFinish, onError]
+  );
+  return {
+    isLoading,
+    generateImage,
+    stop
+  };
+}
+
 // src/lib/memory/chat.ts
 var formatMemoriesForChat = (memories, format = "compact") => {
   if (memories.length === 0) {
@@ -2294,6 +2480,8 @@ export {
   selectTool,
   useChat,
   useEncryption,
+  useImageGeneration,
   useMemory,
-  useModels
+  useModels,
+  useSearch
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251202130234",
+  "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": {