@reverbia/sdk 1.0.0-next.20251211090814 → 1.0.0-next.20251212092701

package/dist/expo/index.d.mts

@@ -379,6 +379,8 @@ type UseChatResult = BaseUseChatResult & {
  *   - `sendMessage`: An async function to send chat messages
  *   - `stop`: A function to abort the current request
  *
+ * @category Hooks
+ *
  * @example
  * ```tsx
  * const { isLoading, sendMessage, stop } = useChat({
@@ -430,6 +432,7 @@ type UseImageGenerationResult = {
 };
 /**
  * React hook for generating images using the LLM API.
+ * @category Hooks
  */
 declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
 
@@ -460,6 +463,7 @@ type UseModelsResult = {
 /**
  * React hook for fetching available LLM models.
  * Automatically fetches all available models.
+ * @category Hooks
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 

package/dist/expo/index.d.ts

@@ -379,6 +379,8 @@ type UseChatResult = BaseUseChatResult & {
  *   - `sendMessage`: An async function to send chat messages
  *   - `stop`: A function to abort the current request
  *
+ * @category Hooks
+ *
  * @example
  * ```tsx
  * const { isLoading, sendMessage, stop } = useChat({
@@ -430,6 +432,7 @@ type UseImageGenerationResult = {
 };
 /**
  * React hook for generating images using the LLM API.
+ * @category Hooks
  */
 declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
 
@@ -460,6 +463,7 @@ type UseModelsResult = {
 /**
  * React hook for fetching available LLM models.
  * Automatically fetches all available models.
+ * @category Hooks
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 

package/dist/next/index.d.mts

@@ -15,6 +15,8 @@
  *
  * export default withReverbia(nextConfig);
  * ```
+ *
+ * @module
  */
 declare const withReverbia: (nextConfig?: any) => any;
 

package/dist/next/index.d.ts

@@ -15,6 +15,8 @@
  *
  * export default withReverbia(nextConfig);
  * ```
+ *
+ * @module
  */
 declare const withReverbia: (nextConfig?: any) => any;
 

package/dist/react/index.cjs

@@ -1858,9 +1858,69 @@ var saveMemory = async (memory) => {
 var saveMemories = async (memories) => {
   await Promise.all(memories.map((memory) => saveMemory(memory)));
 };
+var updateMemoryById = async (id, updates, existingMemory, embedding, embeddingModel) => {
+  const now = Date.now();
+  const updatedMemory = {
+    ...updates,
+    updatedAt: now
+  };
+  if ("namespace" in updates || "key" in updates || "value" in updates) {
+    const namespace = updates.namespace ?? existingMemory.namespace;
+    const key = updates.key ?? existingMemory.key;
+    const value = updates.value ?? existingMemory.value;
+    const newUniqueKey = `${namespace}:${key}:${value}`;
+    if (newUniqueKey !== existingMemory.uniqueKey) {
+      const conflicting = await getMemory(namespace, key, value);
+      if (conflicting) {
+        throw new Error(
+          `A memory with uniqueKey "${newUniqueKey}" already exists (id: ${conflicting.id})`
+        );
+      }
+    }
+    updatedMemory.compositeKey = `${namespace}:${key}`;
+    updatedMemory.uniqueKey = newUniqueKey;
+  }
+  updatedMemory.embedding = embedding;
+  updatedMemory.embeddingModel = embeddingModel;
+  return await memoryDb.transaction("rw", memoryDb.memories, async () => {
+    await memoryDb.memories.update(id, updatedMemory);
+    return await memoryDb.memories.get(id);
+  });
+};
 var getAllMemories = async () => {
   return memoryDb.memories.toArray();
 };
+var getMemoryById = async (id) => {
+  return memoryDb.memories.get(id);
+};
+var getMemoriesByNamespace = async (namespace) => {
+  return memoryDb.memories.where("namespace").equals(namespace).toArray();
+};
+var getMemories = async (namespace, key) => {
+  const compositeKey = `${namespace}:${key}`;
+  return memoryDb.memories.where("compositeKey").equals(compositeKey).toArray();
+};
+var getMemory = async (namespace, key, value) => {
+  const uniqueKey = `${namespace}:${key}:${value}`;
+  return memoryDb.memories.where("uniqueKey").equals(uniqueKey).first();
+};
+var deleteMemories = async (namespace, key) => {
+  const compositeKey = `${namespace}:${key}`;
+  await memoryDb.memories.where("compositeKey").equals(compositeKey).delete();
+};
+var deleteMemory = async (namespace, key, value) => {
+  const uniqueKey = `${namespace}:${key}:${value}`;
+  const existing = await memoryDb.memories.where("uniqueKey").equals(uniqueKey).first();
+  if (existing?.id) {
+    await memoryDb.memories.delete(existing.id);
+  }
+};
+var deleteMemoryById = async (id) => {
+  await memoryDb.memories.delete(id);
+};
+var clearAllMemories = async () => {
+  await memoryDb.memories.clear();
+};
 var cosineSimilarity = (a, b) => {
   if (a.length !== b.length) {
     throw new Error("Vectors must have the same length");
@@ -2327,9 +2387,173 @@ function useMemory(options = {}) {
     },
     [embeddingModel, embeddingProvider, getToken, baseUrl]
   );
+  const fetchAllMemories = (0, import_react2.useCallback)(async () => {
+    try {
+      return await getAllMemories();
+    } catch (error) {
+      throw new Error(
+        "Failed to fetch all memories: " + (error instanceof Error ? error.message : String(error))
+      );
+    }
+  }, []);
+  const fetchMemoriesByNamespace = (0, import_react2.useCallback)(
+    async (namespace) => {
+      if (!namespace) {
+        throw new Error("Missing required field: namespace");
+      }
+      try {
+        return await getMemoriesByNamespace(namespace);
+      } catch (error) {
+        throw new Error(
+          `Failed to fetch memories for namespace "${namespace}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const fetchMemoriesByKey = (0, import_react2.useCallback)(
+    async (namespace, key) => {
+      if (!namespace || !key) {
+        throw new Error("Missing required fields: namespace, key");
+      }
+      try {
+        return await getMemories(namespace, key);
+      } catch (error) {
+        throw new Error(
+          `Failed to fetch memories for "${namespace}:${key}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const updateMemory = (0, import_react2.useCallback)(
+    async (id, updates) => {
+      if (!Number.isInteger(id) || id <= 0) {
+        throw new Error("id must be a non-negative integer");
+      }
+      try {
+        const embeddingModelToUse = embeddingProvider === "api" ? embeddingModel ?? DEFAULT_API_EMBEDDING_MODEL : embeddingModel && embeddingModel !== DEFAULT_API_EMBEDDING_MODEL ? embeddingModel : DEFAULT_LOCAL_EMBEDDING_MODEL;
+        const embeddingOptions = {
+          model: embeddingModelToUse,
+          provider: embeddingProvider,
+          getToken: getToken || void 0,
+          baseUrl
+        };
+        if (!updates.type || !updates.namespace || !updates.key || !updates.value || !updates.rawEvidence || updates.confidence === void 0 || updates.confidence === null || updates.pii === void 0 || updates.pii === null) {
+          throw new Error(
+            "Missing required fields: type, namespace, key, value, rawEvidence, confidence, pii"
+          );
+        }
+        const existingMemory = await getMemoryById(id);
+        if (!existingMemory) {
+          throw new Error(`Memory with id ${id} not found`);
+        }
+        const embeddingFieldsChanged = updates.value !== void 0 && updates.value !== existingMemory.value || updates.rawEvidence !== void 0 && updates.rawEvidence !== existingMemory.rawEvidence || updates.type !== void 0 && updates.type !== existingMemory.type || updates.namespace !== void 0 && updates.namespace !== existingMemory.namespace || updates.key !== void 0 && updates.key !== existingMemory.key;
+        if (!embeddingFieldsChanged) {
+          return existingMemory;
+        }
+        const memory = {
+          type: updates.type,
+          namespace: updates.namespace,
+          key: updates.key,
+          value: updates.value,
+          rawEvidence: updates.rawEvidence,
+          confidence: updates.confidence,
+          pii: updates.pii
+        };
+        let embedding = existingMemory.embedding ?? [];
+        let embeddingModelToStore = existingMemory.embeddingModel ?? "";
+        if (generateEmbeddings && embeddingModelToUse) {
+          try {
+            embedding = await generateEmbeddingForMemory(
+              memory,
+              embeddingOptions
+            );
+            embeddingModelToStore = embeddingModelToUse;
+          } catch (embeddingError) {
+            console.error(
+              "Failed to generate embedding, keeping existing:",
+              embeddingError
+            );
+          }
+        }
+        return await updateMemoryById(
+          id,
+          updates,
+          existingMemory,
+          embedding,
+          embeddingModelToStore
+        );
+      } catch (error) {
+        throw new Error(
+          `Failed to update memory ${id}: ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    [embeddingModel, embeddingProvider, generateEmbeddings, getToken, baseUrl]
+  );
+  const removeMemory = (0, import_react2.useCallback)(
+    async (namespace, key, value) => {
+      if (!namespace || !key || !value) {
+        throw new Error("Missing required fields: namespace, key, value");
+      }
+      try {
+        await deleteMemory(namespace, key, value);
+      } catch (error) {
+        throw new Error(
+          `Failed to delete memory "${namespace}:${key}:${value}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const removeMemoryById = (0, import_react2.useCallback)(async (id) => {
+    if (!Number.isInteger(id) || id <= 0) {
+      throw new Error("id must be a non-negative integer");
+    }
+    try {
+      await deleteMemoryById(id);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete memory with id ${id}: ` + (error instanceof Error ? error.message : String(error))
+      );
+    }
+  }, []);
+  const removeMemories = (0, import_react2.useCallback)(
+    async (namespace, key) => {
+      if (!namespace || !key) {
+        throw new Error("Missing required fields: namespace, key");
+      }
+      try {
+        await deleteMemories(namespace, key);
+      } catch (error) {
+        throw new Error(
+          `Failed to delete memories for "${namespace}:${key}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const clearMemories = (0, import_react2.useCallback)(async () => {
+    try {
+      await clearAllMemories();
+    } catch (error) {
+      throw new Error(
+        "Failed to clear all memories: " + (error instanceof Error ? error.message : String(error))
+      );
+    }
+  }, []);
   return {
     extractMemoriesFromMessage,
-    searchMemories
+    searchMemories,
+    fetchAllMemories,
+    fetchMemoriesByNamespace,
+    fetchMemoriesByKey,
+    updateMemory,
+    removeMemory,
+    removeMemoryById,
+    removeMemories,
+    clearMemories
   };
 }
 

package/dist/react/index.d.mts

@@ -524,6 +524,8 @@ type UseChatResult = BaseUseChatResult & {
  * @param options.toolSelectorModel - The model to use for tool selection.
  * @param options.onToolExecution - Callback function to be called when a tool is executed.
  *
+ * @category Hooks
+ *
  * @returns An object containing:
  *   - `isLoading`: A boolean indicating whether a request is currently in progress
  *   - `isSelectingTool`: A boolean indicating whether tool selection is in progress
@@ -612,6 +614,7 @@ declare function requestEncryptionKey(walletAddress: string, signMessage: SignMe
  * Hook that provides on-demand encryption key management.
  * @param signMessage - Function to sign a message (from Privy's useSignMessage)
  * @returns Functions to request encryption keys
+ * @category Hooks
  */
 declare function useEncryption(signMessage: SignMessageFn): {
     requestEncryptionKey: (walletAddress: string) => Promise<void>;
@@ -698,10 +701,58 @@ type UseMemoryResult = {
     searchMemories: (query: string, limit?: number, minSimilarity?: number) => Promise<Array<StoredMemoryItem & {
         similarity: number;
     }>>;
+    /**
+     * Get all memories stored in IndexedDB
+     * @returns Array of all stored memories
+     */
+    fetchAllMemories: () => Promise<StoredMemoryItem[]>;
+    /**
+     * Get memories filtered by namespace
+     * @param namespace The namespace to filter by
+     * @returns Array of memories in the specified namespace
+     */
+    fetchMemoriesByNamespace: (namespace: string) => Promise<StoredMemoryItem[]>;
+    /**
+     * Get memories by namespace and key
+     * @param namespace The namespace
+     * @param key The key within the namespace
+     * @returns Array of memories matching the namespace and key
+     */
+    fetchMemoriesByKey: (namespace: string, key: string) => Promise<StoredMemoryItem[]>;
+    /**
+     * Update a memory by its ID
+     * @param id The memory ID
+     * @param updates Partial memory fields to update
+     * @returns The updated memory or undefined if not found
+     */
+    updateMemory: (id: number, updates: Partial<StoredMemoryItem & MemoryItem>) => Promise<StoredMemoryItem | undefined>;
+    /**
+     * Delete a specific memory by namespace, key, and value
+     * @param namespace The namespace
+     * @param key The key
+     * @param value The value
+     */
+    removeMemory: (namespace: string, key: string, value: string) => Promise<void>;
+    /**
+     * Delete a memory by its ID
+     * @param id The memory ID
+     */
+    removeMemoryById: (id: number) => Promise<void>;
+    /**
+     * Delete all memories by namespace and key
+     * @param namespace The namespace
+     * @param key The key
+     */
+    removeMemories: (namespace: string, key: string) => Promise<void>;
+    /**
+     * Clear all memories from IndexedDB
+     */
+    clearMemories: () => Promise<void>;
 };
 /**
  * Standalone hook for extracting memories from user messages.
  * Can be composed with other hooks like useChat, useFiles, etc.
+ * @category Hooks
  */
 declare function useMemory(options?: UseMemoryOptions): UseMemoryResult;
 
@@ -710,6 +761,10 @@ interface PdfFile {
     mediaType?: string;
     filename?: string;
 }
+/**
+ * React hook for extracting text from PDF files.
+ * @category Hooks
+ */
 declare function usePdf(): {
     extractPdfContext: (files: PdfFile[]) => Promise<string | null>;
     isProcessing: boolean;
@@ -721,6 +776,10 @@ interface OCRFile {
     filename?: string;
     language?: string;
 }
+/**
+ * React hook for extracting text from images using OCR.
+ * @category Hooks
+ */
 declare function useOCR(): {
     extractOCRContext: (files: OCRFile[]) => Promise<string | null>;
     isProcessing: boolean;
@@ -754,6 +813,7 @@ type UseModelsResult = {
 /**
  * React hook for fetching available LLM models.
  * Automatically fetches all available models.
+ * @category Hooks
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 
@@ -805,6 +865,7 @@ type UseSearchResult = {
  *
  * @param options - Configuration options for the search hook
  * @returns Object containing search function, results, loading state, and error
+ * @category Hooks
  *
  * @example
  * ```tsx
@@ -852,6 +913,7 @@ type UseImageGenerationResult = {
 };
 /**
  * React hook for generating images using the LLM API.
+ * @category Hooks
  */
 declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
 

package/dist/react/index.d.ts

@@ -524,6 +524,8 @@ type UseChatResult = BaseUseChatResult & {
  * @param options.toolSelectorModel - The model to use for tool selection.
  * @param options.onToolExecution - Callback function to be called when a tool is executed.
  *
+ * @category Hooks
+ *
  * @returns An object containing:
  *   - `isLoading`: A boolean indicating whether a request is currently in progress
  *   - `isSelectingTool`: A boolean indicating whether tool selection is in progress
@@ -612,6 +614,7 @@ declare function requestEncryptionKey(walletAddress: string, signMessage: SignMe
  * Hook that provides on-demand encryption key management.
  * @param signMessage - Function to sign a message (from Privy's useSignMessage)
  * @returns Functions to request encryption keys
+ * @category Hooks
  */
 declare function useEncryption(signMessage: SignMessageFn): {
     requestEncryptionKey: (walletAddress: string) => Promise<void>;
@@ -698,10 +701,58 @@ type UseMemoryResult = {
     searchMemories: (query: string, limit?: number, minSimilarity?: number) => Promise<Array<StoredMemoryItem & {
         similarity: number;
     }>>;
+    /**
+     * Get all memories stored in IndexedDB
+     * @returns Array of all stored memories
+     */
+    fetchAllMemories: () => Promise<StoredMemoryItem[]>;
+    /**
+     * Get memories filtered by namespace
+     * @param namespace The namespace to filter by
+     * @returns Array of memories in the specified namespace
+     */
+    fetchMemoriesByNamespace: (namespace: string) => Promise<StoredMemoryItem[]>;
+    /**
+     * Get memories by namespace and key
+     * @param namespace The namespace
+     * @param key The key within the namespace
+     * @returns Array of memories matching the namespace and key
+     */
+    fetchMemoriesByKey: (namespace: string, key: string) => Promise<StoredMemoryItem[]>;
+    /**
+     * Update a memory by its ID
+     * @param id The memory ID
+     * @param updates Partial memory fields to update
+     * @returns The updated memory or undefined if not found
+     */
+    updateMemory: (id: number, updates: Partial<StoredMemoryItem & MemoryItem>) => Promise<StoredMemoryItem | undefined>;
+    /**
+     * Delete a specific memory by namespace, key, and value
+     * @param namespace The namespace
+     * @param key The key
+     * @param value The value
+     */
+    removeMemory: (namespace: string, key: string, value: string) => Promise<void>;
+    /**
+     * Delete a memory by its ID
+     * @param id The memory ID
+     */
+    removeMemoryById: (id: number) => Promise<void>;
+    /**
+     * Delete all memories by namespace and key
+     * @param namespace The namespace
+     * @param key The key
+     */
+    removeMemories: (namespace: string, key: string) => Promise<void>;
+    /**
+     * Clear all memories from IndexedDB
+     */
+    clearMemories: () => Promise<void>;
 };
 /**
  * Standalone hook for extracting memories from user messages.
  * Can be composed with other hooks like useChat, useFiles, etc.
+ * @category Hooks
  */
 declare function useMemory(options?: UseMemoryOptions): UseMemoryResult;
 
@@ -710,6 +761,10 @@ interface PdfFile {
     mediaType?: string;
     filename?: string;
 }
+/**
+ * React hook for extracting text from PDF files.
+ * @category Hooks
+ */
 declare function usePdf(): {
     extractPdfContext: (files: PdfFile[]) => Promise<string | null>;
     isProcessing: boolean;
@@ -721,6 +776,10 @@ interface OCRFile {
     filename?: string;
     language?: string;
 }
+/**
+ * React hook for extracting text from images using OCR.
+ * @category Hooks
+ */
 declare function useOCR(): {
     extractOCRContext: (files: OCRFile[]) => Promise<string | null>;
     isProcessing: boolean;
@@ -754,6 +813,7 @@ type UseModelsResult = {
 /**
  * React hook for fetching available LLM models.
  * Automatically fetches all available models.
+ * @category Hooks
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 
@@ -805,6 +865,7 @@ type UseSearchResult = {
  *
  * @param options - Configuration options for the search hook
  * @returns Object containing search function, results, loading state, and error
+ * @category Hooks
  *
  * @example
  * ```tsx
@@ -852,6 +913,7 @@ type UseImageGenerationResult = {
 };
 /**
  * React hook for generating images using the LLM API.
+ * @category Hooks
  */
 declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
 

package/dist/react/index.mjs

@@ -1804,9 +1804,69 @@ var saveMemory = async (memory) => {
 var saveMemories = async (memories) => {
   await Promise.all(memories.map((memory) => saveMemory(memory)));
 };
+var updateMemoryById = async (id, updates, existingMemory, embedding, embeddingModel) => {
+  const now = Date.now();
+  const updatedMemory = {
+    ...updates,
+    updatedAt: now
+  };
+  if ("namespace" in updates || "key" in updates || "value" in updates) {
+    const namespace = updates.namespace ?? existingMemory.namespace;
+    const key = updates.key ?? existingMemory.key;
+    const value = updates.value ?? existingMemory.value;
+    const newUniqueKey = `${namespace}:${key}:${value}`;
+    if (newUniqueKey !== existingMemory.uniqueKey) {
+      const conflicting = await getMemory(namespace, key, value);
+      if (conflicting) {
+        throw new Error(
+          `A memory with uniqueKey "${newUniqueKey}" already exists (id: ${conflicting.id})`
+        );
+      }
+    }
+    updatedMemory.compositeKey = `${namespace}:${key}`;
+    updatedMemory.uniqueKey = newUniqueKey;
+  }
+  updatedMemory.embedding = embedding;
+  updatedMemory.embeddingModel = embeddingModel;
+  return await memoryDb.transaction("rw", memoryDb.memories, async () => {
+    await memoryDb.memories.update(id, updatedMemory);
+    return await memoryDb.memories.get(id);
+  });
+};
 var getAllMemories = async () => {
   return memoryDb.memories.toArray();
 };
+var getMemoryById = async (id) => {
+  return memoryDb.memories.get(id);
+};
+var getMemoriesByNamespace = async (namespace) => {
+  return memoryDb.memories.where("namespace").equals(namespace).toArray();
+};
+var getMemories = async (namespace, key) => {
+  const compositeKey = `${namespace}:${key}`;
+  return memoryDb.memories.where("compositeKey").equals(compositeKey).toArray();
+};
+var getMemory = async (namespace, key, value) => {
+  const uniqueKey = `${namespace}:${key}:${value}`;
+  return memoryDb.memories.where("uniqueKey").equals(uniqueKey).first();
+};
+var deleteMemories = async (namespace, key) => {
+  const compositeKey = `${namespace}:${key}`;
+  await memoryDb.memories.where("compositeKey").equals(compositeKey).delete();
+};
+var deleteMemory = async (namespace, key, value) => {
+  const uniqueKey = `${namespace}:${key}:${value}`;
+  const existing = await memoryDb.memories.where("uniqueKey").equals(uniqueKey).first();
+  if (existing?.id) {
+    await memoryDb.memories.delete(existing.id);
+  }
+};
+var deleteMemoryById = async (id) => {
+  await memoryDb.memories.delete(id);
+};
+var clearAllMemories = async () => {
+  await memoryDb.memories.clear();
+};
 var cosineSimilarity = (a, b) => {
   if (a.length !== b.length) {
     throw new Error("Vectors must have the same length");
@@ -2273,9 +2333,173 @@ function useMemory(options = {}) {
     },
     [embeddingModel, embeddingProvider, getToken, baseUrl]
   );
+  const fetchAllMemories = useCallback2(async () => {
+    try {
+      return await getAllMemories();
+    } catch (error) {
+      throw new Error(
+        "Failed to fetch all memories: " + (error instanceof Error ? error.message : String(error))
+      );
+    }
+  }, []);
+  const fetchMemoriesByNamespace = useCallback2(
+    async (namespace) => {
+      if (!namespace) {
+        throw new Error("Missing required field: namespace");
+      }
+      try {
+        return await getMemoriesByNamespace(namespace);
+      } catch (error) {
+        throw new Error(
+          `Failed to fetch memories for namespace "${namespace}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const fetchMemoriesByKey = useCallback2(
+    async (namespace, key) => {
+      if (!namespace || !key) {
+        throw new Error("Missing required fields: namespace, key");
+      }
+      try {
+        return await getMemories(namespace, key);
+      } catch (error) {
+        throw new Error(
+          `Failed to fetch memories for "${namespace}:${key}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const updateMemory = useCallback2(
+    async (id, updates) => {
+      if (!Number.isInteger(id) || id <= 0) {
+        throw new Error("id must be a non-negative integer");
+      }
+      try {
+        const embeddingModelToUse = embeddingProvider === "api" ? embeddingModel ?? DEFAULT_API_EMBEDDING_MODEL : embeddingModel && embeddingModel !== DEFAULT_API_EMBEDDING_MODEL ? embeddingModel : DEFAULT_LOCAL_EMBEDDING_MODEL;
+        const embeddingOptions = {
+          model: embeddingModelToUse,
+          provider: embeddingProvider,
+          getToken: getToken || void 0,
+          baseUrl
+        };
+        if (!updates.type || !updates.namespace || !updates.key || !updates.value || !updates.rawEvidence || updates.confidence === void 0 || updates.confidence === null || updates.pii === void 0 || updates.pii === null) {
+          throw new Error(
+            "Missing required fields: type, namespace, key, value, rawEvidence, confidence, pii"
+          );
+        }
+        const existingMemory = await getMemoryById(id);
+        if (!existingMemory) {
+          throw new Error(`Memory with id ${id} not found`);
+        }
+        const embeddingFieldsChanged = updates.value !== void 0 && updates.value !== existingMemory.value || updates.rawEvidence !== void 0 && updates.rawEvidence !== existingMemory.rawEvidence || updates.type !== void 0 && updates.type !== existingMemory.type || updates.namespace !== void 0 && updates.namespace !== existingMemory.namespace || updates.key !== void 0 && updates.key !== existingMemory.key;
+        if (!embeddingFieldsChanged) {
+          return existingMemory;
+        }
+        const memory = {
+          type: updates.type,
+          namespace: updates.namespace,
+          key: updates.key,
+          value: updates.value,
+          rawEvidence: updates.rawEvidence,
+          confidence: updates.confidence,
+          pii: updates.pii
+        };
+        let embedding = existingMemory.embedding ?? [];
+        let embeddingModelToStore = existingMemory.embeddingModel ?? "";
+        if (generateEmbeddings && embeddingModelToUse) {
+          try {
+            embedding = await generateEmbeddingForMemory(
+              memory,
+              embeddingOptions
+            );
+            embeddingModelToStore = embeddingModelToUse;
+          } catch (embeddingError) {
+            console.error(
+              "Failed to generate embedding, keeping existing:",
+              embeddingError
+            );
+          }
+        }
+        return await updateMemoryById(
+          id,
+          updates,
+          existingMemory,
+          embedding,
+          embeddingModelToStore
+        );
+      } catch (error) {
+        throw new Error(
+          `Failed to update memory ${id}: ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    [embeddingModel, embeddingProvider, generateEmbeddings, getToken, baseUrl]
+  );
+  const removeMemory = useCallback2(
+    async (namespace, key, value) => {
+      if (!namespace || !key || !value) {
+        throw new Error("Missing required fields: namespace, key, value");
+      }
+      try {
+        await deleteMemory(namespace, key, value);
+      } catch (error) {
+        throw new Error(
+          `Failed to delete memory "${namespace}:${key}:${value}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const removeMemoryById = useCallback2(async (id) => {
+    if (!Number.isInteger(id) || id <= 0) {
+      throw new Error("id must be a non-negative integer");
+    }
+    try {
+      await deleteMemoryById(id);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete memory with id ${id}: ` + (error instanceof Error ? error.message : String(error))
+      );
+    }
+  }, []);
+  const removeMemories = useCallback2(
+    async (namespace, key) => {
+      if (!namespace || !key) {
+        throw new Error("Missing required fields: namespace, key");
+      }
+      try {
+        await deleteMemories(namespace, key);
+      } catch (error) {
+        throw new Error(
+          `Failed to delete memories for "${namespace}:${key}": ` + (error instanceof Error ? error.message : String(error))
+        );
+      }
+    },
+    []
+  );
+  const clearMemories = useCallback2(async () => {
+    try {
+      await clearAllMemories();
+    } catch (error) {
+      throw new Error(
+        "Failed to clear all memories: " + (error instanceof Error ? error.message : String(error))
+      );
+    }
+  }, []);
   return {
     extractMemoriesFromMessage,
-    searchMemories
+    searchMemories,
+    fetchAllMemories,
+    fetchMemoriesByNamespace,
+    fetchMemoriesByKey,
+    updateMemory,
+    removeMemory,
+    removeMemoryById,
+    removeMemories,
+    clearMemories
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251211090814",
+  "version": "1.0.0-next.20251212092701",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -56,7 +56,7 @@
     "test": "vitest run",
     "build": "tsup",
     "prepublishOnly": "pnpm build",
-    "docs": "typedoc src/client/index.ts",
+    "docs": "typedoc",
     "generate": "pnpm run spec && pnpm run docs"
   },
   "repository": {