feat: add memory management actions and local filters in memory settings (#1467)

* Add MVP memory management actions

* Fix memory settings locale coverage

* Polish memory management interactions

* Add memory search and type filters

* Refine memory settings review feedback

* docs: simplify memory settings review setup

* fix: restore memory updater compatibility helpers

* fix: address memory settings review feedback

* docs: soften memory sample review wording

---------

Co-authored-by: Willem Jiang <willem.jiang@gmail.com>
Co-authored-by: JeffJiang <for-eleven@hotmail.com>

frontend/src/core/memory/api.ts

@@ -2,8 +2,38 @@ import { getBackendBaseURL } from "../config";
 
 import type { UserMemory } from "./types";
 
-export async function loadMemory() {
-  const memory = await fetch(`${getBackendBaseURL()}/api/memory`);
-  const json = await memory.json();
-  return json as UserMemory;
+async function readMemoryResponse(
+  response: Response,
+  fallbackMessage: string,
+): Promise<UserMemory> {
+  if (!response.ok) {
+    const errorData = (await response.json().catch(() => ({}))) as {
+      detail?: string;
+    };
+    throw new Error(errorData.detail ?? `${fallbackMessage}: ${response.statusText}`);
+  }
+
+  return response.json() as Promise<UserMemory>;
+}
+
+export async function loadMemory(): Promise<UserMemory> {
+  const response = await fetch(`${getBackendBaseURL()}/api/memory`);
+  return readMemoryResponse(response, "Failed to fetch memory");
+}
+
+export async function clearMemory(): Promise<UserMemory> {
+  const response = await fetch(`${getBackendBaseURL()}/api/memory`, {
+    method: "DELETE",
+  });
+  return readMemoryResponse(response, "Failed to clear memory");
+}
+
+export async function deleteMemoryFact(factId: string): Promise<UserMemory> {
+  const response = await fetch(
+    `${getBackendBaseURL()}/api/memory/facts/${encodeURIComponent(factId)}`,
+    {
+      method: "DELETE",
+    },
+  );
+  return readMemoryResponse(response, "Failed to delete memory fact");
 }

frontend/src/core/memory/hooks.ts

@@ -1,6 +1,7 @@
-import { useQuery } from "@tanstack/react-query";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 
-import { loadMemory } from "./api";
+import { clearMemory, deleteMemoryFact, loadMemory } from "./api";
+import type { UserMemory } from "./types";
 
 export function useMemory() {
   const { data, isLoading, error } = useQuery({
@@ -9,3 +10,25 @@ export function useMemory() {
   });
   return { memory: data ?? null, isLoading, error };
 }
+
+export function useClearMemory() {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: () => clearMemory(),
+    onSuccess: (memory) => {
+      queryClient.setQueryData<UserMemory>(["memory"], memory);
+    },
+  });
+}
+
+export function useDeleteMemoryFact() {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: (factId: string) => deleteMemoryFact(factId),
+    onSuccess: (memory) => {
+      queryClient.setQueryData<UserMemory>(["memory"], memory);
+    },
+  });
+}