Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

fix(ai): persist local agent generated images

tianma-if0de31ff8e7a7
diff --git a/apps/web/src/components/ai-sidebar/AiSidebar.tsx b/apps/web/src/components/ai-sidebar/AiSidebar.tsx
index d952a041..ea26b74b 100644
--- a/apps/web/src/components/ai-sidebar/AiSidebar.tsx
+++ b/apps/web/src/components/ai-sidebar/AiSidebar.tsx
@@ -2,7 +2,7 @@ import { useCallback, useEffect, useMemo, useRef, useState, type ClipboardEvent,
import { AnimatePresence } from "motion/react";
import * as m from "motion/react-m";
import { useTranslation } from "react-i18next";
-import { Check, ChevronDown, Loader2, PanelRightClose, Paperclip, Plus, Search, Sparkles, X } from "lucide-react";
+import { Check, ChevronDown, Download, Loader2, PanelRightClose, Paperclip, Plus, Search, Sparkles, X } from "lucide-react";
import type { CompanionAction, CompanionAnswer, CompanionEvent, CompanionTurn, CompanionTurnInput } from "@edgeever/shared";
import { buildRevisionDiffRows, createMemoLinkHref, parseMemoLinkHref } from "@edgeever/shared";
import { Button } from "@/components/ui/button";
@@ -70,6 +70,7 @@ import {
saveLocalAgentTurns,
type ChatThreadSummary,
} from "@/lib/local-agent-threads";
+import { LocalAgentImageStore } from "@/lib/local-agent-images";
import { sidebarRevealTransition } from "@/lib/motion";
import {
SELECTION_AI_LANGUAGES,
@@ -122,6 +123,7 @@ type LocalImage = { id: string; mediaType: string; base64: string };
const EMPTY_IMAGE_BYTES = new Uint8Array();
const MAX_LOCAL_IMAGES = 8;
+const localAgentImageStore = new LocalAgentImageStore();
type LocalTurn = {
id: string;
@@ -764,6 +766,7 @@ function AiSidebarSession({
const localTurnsRef = useRef(localTurns);
const localThreadIdRef = useRef(localThreadId);
const localPersistTimer = useRef<number | null>(null);
+ const imagesByTurn = useRef(new Map<string, Map<string, LocalImage>>());
localTurnsRef.current = localTurns;
localThreadIdRef.current = localThreadId;
const focusRef = useRef({ selectionMarkdown, contentMarkdown, memoId, notebookId, notebookTitle, noteTitle, companionAvailable });
@@ -818,12 +821,36 @@ function AiSidebarSession({
};
}, []);
+ useEffect(() => {
+ const turnIds = localTurnsRef.current.map((turn) => turn.id);
+ if (!turnIds.length) return;
+ void localAgentImageStore.list(turnIds).then((images) => {
+ if (!alive.current || !images.length) return;
+ const byTurn = new Map<string, LocalImage[]>();
+ for (const image of images) {
+ const list = byTurn.get(image.turnId) ?? [];
+ if (list.length < MAX_LOCAL_IMAGES) list.push({ id: image.id, mediaType: image.mediaType, base64: image.base64 });
+ byTurn.set(image.turnId, list);
+ }
+ setLocalTurns((previous) => previous.map((turn) => {
+ const saved = byTurn.get(turn.id);
+ if (!saved?.length) return turn;
+ const currentIds = new Set(turn.images.map((image) => image.id));
+ const restored = [...turn.images, ...saved.filter((image) => !currentIds.has(image.id))].slice(0, MAX_LOCAL_IMAGES);
+ return { ...turn, images: restored };
+ }));
+ }).catch(() => {
+ if (alive.current) setError(t("aiAssistant.sidebar.imageSaveFailed"));
+ });
+ }, [t]);
+
useEffect(() => {
if (!localTurns.length && !readStorage(AI_SIDEBAR_LOCAL_THREADS_KEY)) return;
if (localPersistTimer.current != null) window.clearTimeout(localPersistTimer.current);
localPersistTimer.current = window.setTimeout(() => {
try {
- saveLocalAgentTurns(window.localStorage, AI_SIDEBAR_LOCAL_THREADS_KEY, localTurnsRef.current);
+ const saved = saveLocalAgentTurns(window.localStorage, AI_SIDEBAR_LOCAL_THREADS_KEY, localTurnsRef.current);
+ if (saved) void localAgentImageStore.prune(saved.map((turn) => turn.id)).catch(() => undefined);
} catch {
// Private mode can reject storage writes. The open chat still stays in memory.
}
@@ -838,7 +865,8 @@ function AiSidebarSession({
if (localPersistTimer.current != null) window.clearTimeout(localPersistTimer.current);
if (!localTurnsRef.current.length && !readStorage(AI_SIDEBAR_LOCAL_THREADS_KEY)) return;
try {
- saveLocalAgentTurns(window.localStorage, AI_SIDEBAR_LOCAL_THREADS_KEY, localTurnsRef.current);
+ const saved = saveLocalAgentTurns(window.localStorage, AI_SIDEBAR_LOCAL_THREADS_KEY, localTurnsRef.current);
+ if (saved) void localAgentImageStore.prune(saved.map((turn) => turn.id)).catch(() => undefined);
} catch {
// The in-memory chat remains available until the page closes.
}
@@ -894,6 +922,16 @@ function AiSidebarSession({
return;
}
if (event.type === "image") {
+ const current = localTurnsRef.current.find((turn) => turn.id === turnId);
+ if (current?.status === "cancelled") return;
+ const known = imagesByTurn.current.get(turnId) ?? new Map(current?.images.map((image) => [image.id, image]) ?? []);
+ if ([...known.values()].some((image) => image.id !== event.id && image.mediaType === event.mediaType && image.base64 === event.base64)) return;
+ if (!known.has(event.id) && known.size >= MAX_LOCAL_IMAGES) return;
+ known.set(event.id, { id: event.id, mediaType: event.mediaType, base64: event.base64 });
+ imagesByTurn.current.set(turnId, known);
+ void localAgentImageStore.put({ turnId, id: event.id, mediaType: event.mediaType, base64: event.base64 }).catch(() => {
+ if (alive.current) setError(t("aiAssistant.sidebar.imageSaveFailed"));
+ });
setLocalTurns((previous) => previous.map((turn) => {
if (turn.id !== turnId || turn.status === "cancelled") return turn;
if (turn.images.some((image) => image.mediaType === event.mediaType && image.base64 === event.base64)) return turn;
@@ -1584,15 +1622,24 @@ function AiSidebarSession({
) : null}
{turn.images.length ? (
<div className="flex flex-col gap-2">
- {turn.images.map((image) => (
- <Image
- key={image.id}
- alt={t("aiAssistant.sidebar.generatedImage")}
- base64={image.base64}
- className="max-h-96"
- mediaType={image.mediaType}
- uint8Array={EMPTY_IMAGE_BYTES}
- />
+ {turn.images.map((image, index) => (
+ <div key={image.id} className="space-y-1">
+ <Image
+ alt={t("aiAssistant.sidebar.generatedImage")}
+ base64={image.base64}
+ className="max-h-96"
+ mediaType={image.mediaType}
+ uint8Array={EMPTY_IMAGE_BYTES}
+ />
+ <a
+ className="inline-flex items-center gap-1 rounded px-1 py-0.5 text-xs text-slate-600 hover:text-slate-950 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-slate-400"
+ download={`edgeever-image-${turn.id.slice(0, 8)}-${index + 1}.${image.mediaType === "image/jpeg" ? "jpg" : image.mediaType === "image/webp" ? "webp" : image.mediaType === "image/gif" ? "gif" : "png"}`}
+ href={`data:${image.mediaType};base64,${image.base64}`}
+ >
+ <Download className="size-3.5" aria-hidden="true" />
+ {t("aiAssistant.sidebar.downloadImage")}
+ </a>
+ </div>
))}
</div>
) : null}
diff --git a/apps/web/src/lib/local-agent-images.test.mjs b/apps/web/src/lib/local-agent-images.test.mjs
new file mode 100644
index 00000000..f20af34a
--- /dev/null
+++ b/apps/web/src/lib/local-agent-images.test.mjs
@@ -0,0 +1,46 @@
+import { describe, expect, test } from "bun:test";
+import { indexedDB } from "fake-indexeddb";
+import { LocalAgentImageStore } from "./local-agent-images.ts";
+import { parseLocalAgentTurns, serializeLocalAgentTurns } from "./local-agent-threads.ts";
+
+globalThis.indexedDB = indexedDB;
+
+const threadId = "11111111-1111-4111-8111-111111111111";
+const turnId = "22222222-2222-4222-8222-222222222222";
+
+describe("local agent generated images", () => {
+ test("restores an image beside an existing text-only transcript, even after interruption", async () => {
+ const legacy = serializeLocalAgentTurns([{
+ id: turnId,
+ threadId,
+ message: "画一只猫",
+ response: "",
+ reasoning: "",
+ tools: [],
+ images: [{ id: "cat", mediaType: "image/png", base64: "AAAA" }],
+ attachments: [],
+ status: "running",
+ createdAt: "2026-09-30T00:00:00.000Z",
+ }]);
+ expect(legacy).not.toContain("AAAA");
+
+ const first = new LocalAgentImageStore();
+ await first.put({ turnId, id: "cat", mediaType: "image/png", base64: "AAAA" });
+ await first.put({ turnId, id: "cat", mediaType: "image/png", base64: "BBBB" });
+ await first.put({ turnId: threadId, id: "orphan", mediaType: "image/png", base64: "CCCC" });
+
+ const restoredTurn = parseLocalAgentTurns(legacy)[0];
+ const reopened = new LocalAgentImageStore();
+ expect(restoredTurn.status).toBe("cancelled");
+ expect(await reopened.list([restoredTurn.id])).toEqual([
+ { turnId, id: "cat", mediaType: "image/png", base64: "BBBB" },
+ ]);
+ const failedTurn = parseLocalAgentTurns(legacy.replace('"status":"running"', '"status":"failed"'))[0];
+ expect(failedTurn.status).toBe("failed");
+ expect(await reopened.list([failedTurn.id])).toHaveLength(1);
+
+ await reopened.prune([restoredTurn.id]);
+ expect(await reopened.list([threadId])).toEqual([]);
+ expect(await reopened.list([turnId])).toHaveLength(1);
+ });
+});
diff --git a/apps/web/src/lib/local-agent-images.ts b/apps/web/src/lib/local-agent-images.ts
new file mode 100644
index 00000000..f0c0aaee
--- /dev/null
+++ b/apps/web/src/lib/local-agent-images.ts
@@ -0,0 +1,74 @@
+const DATABASE_NAME = "edgeever-local-agent-images-v1";
+const STORE_NAME = "images";
+const TURN_INDEX = "turnId";
+
+export type LocalAgentImage = {
+ turnId: string;
+ id: string;
+ mediaType: string;
+ base64: string;
+};
+
+const transactionDone = (transaction: IDBTransaction) => new Promise<void>((resolve, reject) => {
+ transaction.addEventListener("complete", () => resolve(), { once: true });
+ transaction.addEventListener("abort", () => reject(transaction.error ?? new Error("Image storage transaction aborted.")), { once: true });
+ transaction.addEventListener("error", () => reject(transaction.error ?? new Error("Image storage transaction failed.")), { once: true });
+});
+
+const requestResult = <T>(request: IDBRequest<T>) => new Promise<T>((resolve, reject) => {
+ request.addEventListener("success", () => resolve(request.result), { once: true });
+ request.addEventListener("error", () => reject(request.error ?? new Error("Image storage request failed.")), { once: true });
+});
+
+const openDatabase = () => new Promise<IDBDatabase>((resolve, reject) => {
+ const request = indexedDB.open(DATABASE_NAME, 1);
+ request.addEventListener("upgradeneeded", () => {
+ const store = request.result.createObjectStore(STORE_NAME, { keyPath: ["turnId", "id"] });
+ store.createIndex(TURN_INDEX, "turnId");
+ });
+ request.addEventListener("success", () => resolve(request.result), { once: true });
+ request.addEventListener("error", () => reject(request.error ?? new Error("Image storage is unavailable.")), { once: true });
+});
+
+export class LocalAgentImageStore {
+ private databasePromise: Promise<IDBDatabase> | null = null;
+
+ private database() {
+ this.databasePromise ??= openDatabase();
+ return this.databasePromise;
+ }
+
+ async put(image: LocalAgentImage) {
+ const database = await this.database();
+ const transaction = database.transaction(STORE_NAME, "readwrite");
+ transaction.objectStore(STORE_NAME).put(image);
+ await transactionDone(transaction);
+ }
+
+ async list(turnIds: readonly string[]): Promise<LocalAgentImage[]> {
+ if (!turnIds.length) return [];
+ const database = await this.database();
+ const transaction = database.transaction(STORE_NAME, "readonly");
+ const index = transaction.objectStore(STORE_NAME).index(TURN_INDEX);
+ const requests = turnIds.map((turnId) => requestResult(index.getAll(turnId) as IDBRequest<LocalAgentImage[]>));
+ const results = await Promise.all(requests);
+ await transactionDone(transaction);
+ return results.flat();
+ }
+
+ async prune(keptTurnIds: readonly string[]) {
+ const kept = new Set(keptTurnIds);
+ const database = await this.database();
+ const transaction = database.transaction(STORE_NAME, "readwrite");
+ const store = transaction.objectStore(STORE_NAME);
+ const cursorRequest = store.openKeyCursor();
+ cursorRequest.addEventListener("success", () => {
+ const cursor = cursorRequest.result;
+ if (!cursor) return;
+ const [turnId] = cursor.key as [string, string];
+ if (!kept.has(turnId)) store.delete(cursor.key);
+ cursor.continue();
+ });
+ await transactionDone(transaction);
+ }
+}
diff --git a/apps/web/src/lib/local-agent-threads.ts b/apps/web/src/lib/local-agent-threads.ts
index 10540293..76f8b5c0 100644
--- a/apps/web/src/lib/local-agent-threads.ts
+++ b/apps/web/src/lib/local-agent-threads.ts
@@ -20,7 +20,7 @@ export type LocalAgentAttachmentRecord = {
byteLength: number;
};
-// Pictures stay on the live turn only. The stored transcript is text, so a reload does not keep generated images.
+// Generated pictures are stored separately in IndexedDB to keep large image data out of localStorage.
export type LocalAgentTurnRecord = {
id: string;
threadId: string;
@@ -161,17 +161,18 @@ export const saveLocalAgentTurns = (storage: StorageLike, key: string, turns: re
for (let attempt = 0; attempt < 8; attempt += 1) {
try {
storage.setItem(key, JSON.stringify({ version: LOCAL_AGENT_STORE_VERSION, turns: remaining }));
- return;
+ return remaining;
} catch {
const threads = turnsByThread(remaining);
if (threads.length > 1) {
remaining = threads.slice(0, -1).flatMap((thread) => thread.turns);
continue;
}
- if (remaining.length <= 1) return;
+ if (remaining.length <= 1) return null;
remaining = remaining.slice(Math.ceil(remaining.length / 2));
}
}
+ return null;
};
export const resolveLocalAgentThreadId = (
diff --git a/packages/shared/src/i18n/en-US.ts b/packages/shared/src/i18n/en-US.ts
index 2f51d8a2..5477291a 100644
--- a/packages/shared/src/i18n/en-US.ts
+++ b/packages/shared/src/i18n/en-US.ts
@@ -1367,6 +1367,8 @@ export const enUS = {
proposalDismiss: "Dismiss",
toolProgress: "{{name}} · {{status}}",
generatedImage: "Generated image",
+ downloadImage: "Download image",
+ imageSaveFailed: "The image could not be saved locally. Download it now; it may be lost when you close this page.",
},
agentSource: {
title: "Agent mode",
diff --git a/packages/shared/src/i18n/ja.ts b/packages/shared/src/i18n/ja.ts
index c8a21c99..09cb30c7 100644
--- a/packages/shared/src/i18n/ja.ts
+++ b/packages/shared/src/i18n/ja.ts
@@ -1367,6 +1367,8 @@ export const ja = {
proposalDismiss: "無視",
toolProgress: "{{name}} · {{status}}",
generatedImage: "生成された画像",
+ downloadImage: "画像をダウンロード",
+ imageSaveFailed: "画像を端末に保存できませんでした。今すぐダウンロードしてください。ページを閉じると失われる可能性があります。",
},
agentSource: {
title: "エージェントの動作モード",
diff --git a/packages/shared/src/i18n/zh-CN.ts b/packages/shared/src/i18n/zh-CN.ts
index c99a9996..73fdc16d 100644
--- a/packages/shared/src/i18n/zh-CN.ts
+++ b/packages/shared/src/i18n/zh-CN.ts
@@ -1367,6 +1367,8 @@ export const zhCN = {
proposalDismiss: "忽略",
toolProgress: "{{name}} · {{status}}",
generatedImage: "生成的图片",
+ downloadImage: "下载图片",
+ imageSaveFailed: "图片暂时无法保存到本机。请先下载图片,关闭页面后可能无法找回。",
},
agentSource: {
title: "Agent 运行模式",