@reverbia/sdk 1.0.0-next.20251209143100 → 1.0.0-next.20251212012743

package/dist/react/index.cjs

@@ -1279,7 +1279,8 @@ function useChat(options) {
       messages,
       model,
       onData,
-      runTools = true
+      runTools = true,
+      headers
     }) => {
       const messagesValidation = validateMessages(messages);
       if (!messagesValidation.valid) {
@@ -1468,7 +1469,8 @@ Please inform the user about this issue and try to help them alternatively.`
             },
             headers: {
               "Content-Type": "application/json",
-              Authorization: `Bearer ${token}`
+              Authorization: `Bearer ${token}`,
+              ...headers
             },
             signal: abortController.signal
           });
@@ -1856,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");
@@ -2325,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

@@ -456,6 +456,10 @@ type SendMessageArgs = BaseSendMessageArgs & {
      * Defaults to true if tools are configured.
      */
     runTools?: boolean;
+    /**
+     * Optional custom headers to include with the request.
+     */
+    headers?: Record<string, string>;
 };
 type SendMessageResult = {
     data: LlmapiChatCompletionResponse;
@@ -694,6 +698,53 @@ 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.

package/dist/react/index.d.ts

@@ -456,6 +456,10 @@ type SendMessageArgs = BaseSendMessageArgs & {
      * Defaults to true if tools are configured.
      */
     runTools?: boolean;
+    /**
+     * Optional custom headers to include with the request.
+     */
+    headers?: Record<string, string>;
 };
 type SendMessageResult = {
     data: LlmapiChatCompletionResponse;
@@ -694,6 +698,53 @@ 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.

package/dist/react/index.mjs

@@ -1225,7 +1225,8 @@ function useChat(options) {
       messages,
       model,
       onData,
-      runTools = true
+      runTools = true,
+      headers
     }) => {
       const messagesValidation = validateMessages(messages);
       if (!messagesValidation.valid) {
@@ -1414,7 +1415,8 @@ Please inform the user about this issue and try to help them alternatively.`
             },
             headers: {
               "Content-Type": "application/json",
-              Authorization: `Bearer ${token}`
+              Authorization: `Bearer ${token}`,
+              ...headers
             },
             signal: abortController.signal
           });
@@ -1802,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");
@@ -2271,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.20251209143100",
+  "version": "1.0.0-next.20251212012743",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",