@reverbia/sdk 1.0.0-next.20251202085655 → 1.0.0-next.20251202085711

package/dist/react/index.cjs

@@ -38,7 +38,8 @@ __export(index_exports, {
   formatMemoriesForChat: () => formatMemoriesForChat,
   useChat: () => useChat,
   useEncryption: () => useEncryption,
-  useMemory: () => useMemory
+  useMemory: () => useMemory,
+  useModels: () => useModels
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1409,6 +1410,12 @@ var postApiV1Embeddings = (options) => {
     }
   });
 };
+var getApiV1Models = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/v1/models",
+    ...options
+  });
+};
 
 // src/lib/memory/embeddings.ts
 var generateEmbeddingForText = async (text, options = {}) => {
@@ -1744,6 +1751,110 @@ function useMemory(options = {}) {
   };
 }
 
+// src/react/useModels.ts
+var import_react4 = 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)(() => {
+    getTokenRef.current = getToken;
+    baseUrlRef.current = baseUrl;
+    providerRef.current = provider;
+  });
+  (0, import_react4.useEffect)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const fetchModels = (0, import_react4.useCallback)(async () => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    const abortController = new AbortController();
+    abortControllerRef.current = abortController;
+    const signal = abortController.signal;
+    setIsLoading(true);
+    setError(null);
+    try {
+      let token;
+      if (getTokenRef.current) {
+        token = await getTokenRef.current() ?? void 0;
+      }
+      if (signal.aborted) return;
+      const headers = {};
+      if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+      let allModels = [];
+      let nextPageToken;
+      do {
+        if (signal.aborted) return;
+        const response = await getApiV1Models({
+          baseUrl: baseUrlRef.current,
+          headers,
+          query: {
+            provider: providerRef.current,
+            page_token: nextPageToken
+          },
+          signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error ?? "Failed to fetch models";
+          throw new Error(errorMsg);
+        }
+        if (response.data) {
+          const newModels = response.data.data || [];
+          allModels = [...allModels, ...newModels];
+          nextPageToken = response.data.next_page_token;
+        }
+      } while (nextPageToken);
+      if (signal.aborted) return;
+      setModels(allModels);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        return;
+      }
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      if (!signal.aborted) {
+        setIsLoading(false);
+      }
+      if (abortControllerRef.current === abortController) {
+        abortControllerRef.current = null;
+      }
+    }
+  }, []);
+  const refetch = (0, import_react4.useCallback)(async () => {
+    setModels([]);
+    await fetchModels();
+  }, [fetchModels]);
+  const hasFetchedRef = (0, import_react4.useRef)(false);
+  (0, import_react4.useEffect)(() => {
+    if (autoFetch && !hasFetchedRef.current) {
+      hasFetchedRef.current = true;
+      fetchModels();
+    }
+    if (!autoFetch) {
+      hasFetchedRef.current = false;
+    }
+  }, [autoFetch, fetchModels]);
+  return {
+    models,
+    isLoading,
+    error,
+    refetch
+  };
+}
+
 // src/lib/memory/chat.ts
 var formatMemoriesForChat = (memories, format = "compact") => {
   if (memories.length === 0) {
@@ -1808,5 +1919,6 @@ var extractConversationContext = (messages, maxMessages = 3) => {
   formatMemoriesForChat,
   useChat,
   useEncryption,
-  useMemory
+  useMemory,
+  useModels
 });

package/dist/react/index.d.mts

@@ -77,6 +77,99 @@ type LlmapiMessage = {
     content?: string;
     role?: LlmapiRole;
 };
+type LlmapiModel = {
+    architecture?: LlmapiModelArchitecture;
+    /**
+     * CanonicalSlug is the canonical slug for the model
+     */
+    canonical_slug?: string;
+    /**
+     * ContextLength is the maximum context length in tokens
+     */
+    context_length?: number;
+    /**
+     * Created is the Unix timestamp of when the model was created
+     */
+    created?: number;
+    /**
+     * DefaultParameters contains default parameter values
+     */
+    default_parameters?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Description describes the model and its capabilities
+     */
+    description?: string;
+    /**
+     * HuggingFaceID is the Hugging Face model identifier
+     */
+    hugging_face_id?: string;
+    /**
+     * ID is the model identifier (e.g., "openai/gpt-4")
+     */
+    id?: string;
+    /**
+     * MaxInputTokens is the maximum input tokens
+     */
+    max_input_tokens?: number;
+    /**
+     * MaxOutputTokens is the maximum output tokens
+     */
+    max_output_tokens?: number;
+    /**
+     * Name is the human-readable model name (optional)
+     */
+    name?: string;
+    /**
+     * OwnedBy is the organization that owns the model
+     */
+    owned_by?: string;
+    per_request_limits?: LlmapiModelPerRequestLimits;
+    pricing?: LlmapiModelPricing;
+    /**
+     * SupportedMethods is a list of supported API methods
+     */
+    supported_methods?: Array<string>;
+    /**
+     * SupportedParameters is a list of supported parameter names
+     */
+    supported_parameters?: Array<string>;
+    top_provider?: LlmapiModelTopProvider;
+};
+/**
+ * Architecture describes the model's technical capabilities
+ */
+type LlmapiModelArchitecture = {
+    instruct_type?: string;
+    modality?: string;
+    prompt_formatting?: string;
+    tokenizer?: string;
+};
+/**
+ * PerRequestLimits contains rate limiting information
+ */
+type LlmapiModelPerRequestLimits = {
+    completion_tokens?: number;
+    prompt_tokens?: number;
+};
+/**
+ * Pricing contains the pricing structure for using this model
+ */
+type LlmapiModelPricing = {
+    completion?: string;
+    image?: string;
+    prompt?: string;
+    request?: string;
+};
+/**
+ * TopProvider contains configuration details for the primary provider
+ */
+type LlmapiModelTopProvider = {
+    context_length?: number;
+    is_moderated?: boolean;
+    max_completion_tokens?: number;
+};
 /**
  * Role is the message role (system, user, assistant)
  */
@@ -296,6 +389,36 @@ type UseMemoryResult = {
  */
 declare function useMemory(options?: UseMemoryOptions): UseMemoryResult;
 
+type UseModelsOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Optional filter for specific provider (e.g. "openai")
+     */
+    provider?: string;
+    /**
+     * Whether to fetch models automatically on mount (default: true)
+     */
+    autoFetch?: boolean;
+};
+type UseModelsResult = {
+    models: LlmapiModel[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * React hook for fetching available LLM models.
+ * Automatically fetches all available models.
+ */
+declare function useModels(options?: UseModelsOptions): UseModelsResult;
+
 /**
  * Format memories into a context string that can be included in chat messages
  * @param memories Array of memories with similarity scores
@@ -325,4 +448,4 @@ declare const extractConversationContext: (messages: Array<{
     content: string;
 }>, maxMessages?: number) => string;
 
-export { createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, extractConversationContext, formatMemoriesForChat, useChat, useEncryption, useMemory };
+export { createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, extractConversationContext, formatMemoriesForChat, useChat, useEncryption, useMemory, useModels };

package/dist/react/index.d.ts

@@ -77,6 +77,99 @@ type LlmapiMessage = {
     content?: string;
     role?: LlmapiRole;
 };
+type LlmapiModel = {
+    architecture?: LlmapiModelArchitecture;
+    /**
+     * CanonicalSlug is the canonical slug for the model
+     */
+    canonical_slug?: string;
+    /**
+     * ContextLength is the maximum context length in tokens
+     */
+    context_length?: number;
+    /**
+     * Created is the Unix timestamp of when the model was created
+     */
+    created?: number;
+    /**
+     * DefaultParameters contains default parameter values
+     */
+    default_parameters?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Description describes the model and its capabilities
+     */
+    description?: string;
+    /**
+     * HuggingFaceID is the Hugging Face model identifier
+     */
+    hugging_face_id?: string;
+    /**
+     * ID is the model identifier (e.g., "openai/gpt-4")
+     */
+    id?: string;
+    /**
+     * MaxInputTokens is the maximum input tokens
+     */
+    max_input_tokens?: number;
+    /**
+     * MaxOutputTokens is the maximum output tokens
+     */
+    max_output_tokens?: number;
+    /**
+     * Name is the human-readable model name (optional)
+     */
+    name?: string;
+    /**
+     * OwnedBy is the organization that owns the model
+     */
+    owned_by?: string;
+    per_request_limits?: LlmapiModelPerRequestLimits;
+    pricing?: LlmapiModelPricing;
+    /**
+     * SupportedMethods is a list of supported API methods
+     */
+    supported_methods?: Array<string>;
+    /**
+     * SupportedParameters is a list of supported parameter names
+     */
+    supported_parameters?: Array<string>;
+    top_provider?: LlmapiModelTopProvider;
+};
+/**
+ * Architecture describes the model's technical capabilities
+ */
+type LlmapiModelArchitecture = {
+    instruct_type?: string;
+    modality?: string;
+    prompt_formatting?: string;
+    tokenizer?: string;
+};
+/**
+ * PerRequestLimits contains rate limiting information
+ */
+type LlmapiModelPerRequestLimits = {
+    completion_tokens?: number;
+    prompt_tokens?: number;
+};
+/**
+ * Pricing contains the pricing structure for using this model
+ */
+type LlmapiModelPricing = {
+    completion?: string;
+    image?: string;
+    prompt?: string;
+    request?: string;
+};
+/**
+ * TopProvider contains configuration details for the primary provider
+ */
+type LlmapiModelTopProvider = {
+    context_length?: number;
+    is_moderated?: boolean;
+    max_completion_tokens?: number;
+};
 /**
  * Role is the message role (system, user, assistant)
  */
@@ -296,6 +389,36 @@ type UseMemoryResult = {
  */
 declare function useMemory(options?: UseMemoryOptions): UseMemoryResult;
 
+type UseModelsOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Optional filter for specific provider (e.g. "openai")
+     */
+    provider?: string;
+    /**
+     * Whether to fetch models automatically on mount (default: true)
+     */
+    autoFetch?: boolean;
+};
+type UseModelsResult = {
+    models: LlmapiModel[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * React hook for fetching available LLM models.
+ * Automatically fetches all available models.
+ */
+declare function useModels(options?: UseModelsOptions): UseModelsResult;
+
 /**
  * Format memories into a context string that can be included in chat messages
  * @param memories Array of memories with similarity scores
@@ -325,4 +448,4 @@ declare const extractConversationContext: (messages: Array<{
     content: string;
 }>, maxMessages?: number) => string;
 
-export { createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, extractConversationContext, formatMemoriesForChat, useChat, useEncryption, useMemory };
+export { createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, extractConversationContext, formatMemoriesForChat, useChat, useEncryption, useMemory, useModels };

package/dist/react/index.mjs

@@ -1365,6 +1365,12 @@ var postApiV1Embeddings = (options) => {
     }
   });
 };
+var getApiV1Models = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/v1/models",
+    ...options
+  });
+};
 
 // src/lib/memory/embeddings.ts
 var generateEmbeddingForText = async (text, options = {}) => {
@@ -1700,6 +1706,110 @@ function useMemory(options = {}) {
   };
 }
 
+// src/react/useModels.ts
+import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef4, useState as useState2 } 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 getTokenRef = useRef4(getToken);
+  const baseUrlRef = useRef4(baseUrl);
+  const providerRef = useRef4(provider);
+  const abortControllerRef = useRef4(null);
+  useEffect3(() => {
+    getTokenRef.current = getToken;
+    baseUrlRef.current = baseUrl;
+    providerRef.current = provider;
+  });
+  useEffect3(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const fetchModels = useCallback3(async () => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    const abortController = new AbortController();
+    abortControllerRef.current = abortController;
+    const signal = abortController.signal;
+    setIsLoading(true);
+    setError(null);
+    try {
+      let token;
+      if (getTokenRef.current) {
+        token = await getTokenRef.current() ?? void 0;
+      }
+      if (signal.aborted) return;
+      const headers = {};
+      if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+      let allModels = [];
+      let nextPageToken;
+      do {
+        if (signal.aborted) return;
+        const response = await getApiV1Models({
+          baseUrl: baseUrlRef.current,
+          headers,
+          query: {
+            provider: providerRef.current,
+            page_token: nextPageToken
+          },
+          signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error ?? "Failed to fetch models";
+          throw new Error(errorMsg);
+        }
+        if (response.data) {
+          const newModels = response.data.data || [];
+          allModels = [...allModels, ...newModels];
+          nextPageToken = response.data.next_page_token;
+        }
+      } while (nextPageToken);
+      if (signal.aborted) return;
+      setModels(allModels);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        return;
+      }
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      if (!signal.aborted) {
+        setIsLoading(false);
+      }
+      if (abortControllerRef.current === abortController) {
+        abortControllerRef.current = null;
+      }
+    }
+  }, []);
+  const refetch = useCallback3(async () => {
+    setModels([]);
+    await fetchModels();
+  }, [fetchModels]);
+  const hasFetchedRef = useRef4(false);
+  useEffect3(() => {
+    if (autoFetch && !hasFetchedRef.current) {
+      hasFetchedRef.current = true;
+      fetchModels();
+    }
+    if (!autoFetch) {
+      hasFetchedRef.current = false;
+    }
+  }, [autoFetch, fetchModels]);
+  return {
+    models,
+    isLoading,
+    error,
+    refetch
+  };
+}
+
 // src/lib/memory/chat.ts
 var formatMemoriesForChat = (memories, format = "compact") => {
   if (memories.length === 0) {
@@ -1763,5 +1873,6 @@ export {
   formatMemoriesForChat,
   useChat,
   useEncryption,
-  useMemory
+  useMemory,
+  useModels
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251202085655",
+  "version": "1.0.0-next.20251202085711",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",