@xopcai/xopc 0.0.89 → 0.0.91

package/dist/src/notes/store.js

@@ -0,0 +1,317 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { buildNoteIndexMeta } from "./note-index-meta.js";
+import { resolveNoteHistoryDir, resolveNoteItemPath, resolveNoteMediaDir, resolveNotesDir, resolveNotesIndexPath } from "./paths.js";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+//#region src/notes/store.ts
+init_write_file_atomic();
+init_logger();
+const log = createLogger("NotesStore");
+const DEFAULT_INDEX = {
+	version: 3,
+	notes: []
+};
+const INDEX_VERSION = 3;
+const DEBOUNCE_MS = 500;
+function noteToIndexEntry(note) {
+	const { snippet, coverAttachmentId, voiceAttachmentId, voiceDurationSec, attachmentNames } = buildNoteIndexMeta(note);
+	return {
+		id: note.id,
+		title: note.title || void 0,
+		kind: note.kind,
+		status: note.status,
+		createdAt: note.createdAt,
+		updatedAt: note.updatedAt,
+		pinned: note.pinned || void 0,
+		tags: note.tags?.length ? note.tags : void 0,
+		snippet,
+		coverAttachmentId,
+		voiceAttachmentId,
+		voiceDurationSec,
+		attachmentNames
+	};
+}
+var NotesStore = class {
+	indexCache = null;
+	dirty = false;
+	saveTimeout = null;
+	initialized = false;
+	async initialize() {
+		if (this.initialized) return;
+		const indexPath = resolveNotesIndexPath();
+		try {
+			await access(indexPath);
+			await this.loadIndex();
+			if ((this.indexCache?.version ?? 0) < INDEX_VERSION) await this.rebuildIndexFromItems();
+		} catch {
+			await this.writeIndex(DEFAULT_INDEX);
+			this.indexCache = DEFAULT_INDEX;
+		}
+		this.initialized = true;
+		log.debug("NotesStore initialized");
+	}
+	async addNote(note) {
+		const index = await this.loadIndex();
+		await this.writeNoteItem(note);
+		index.notes.push(noteToIndexEntry(note));
+		index.version++;
+		this.scheduleIndexSave(index);
+	}
+	async getNote(id) {
+		const itemPath = resolveNoteItemPath(id);
+		try {
+			const content = await readFile(itemPath, "utf-8");
+			return JSON.parse(content);
+		} catch (err) {
+			if ((err && typeof err === "object" && "code" in err ? err.code : "") !== "ENOENT") log.debug({
+				err,
+				id
+			}, "Failed to read note item");
+			return null;
+		}
+	}
+	async updateNote(id, patch) {
+		const existing = await this.getNote(id);
+		if (!existing) return null;
+		const updated = {
+			...existing,
+			...patch,
+			id: existing.id,
+			createdAt: existing.createdAt,
+			updatedAt: Date.now()
+		};
+		await this.writeNoteItem(updated);
+		const index = await this.loadIndex();
+		const idx = index.notes.findIndex((n) => n.id === id);
+		if (idx !== -1) index.notes[idx] = noteToIndexEntry(updated);
+		index.version++;
+		this.scheduleIndexSave(index);
+		return updated;
+	}
+	async deleteNote(id) {
+		if (!await this.getNote(id)) return false;
+		await rm(resolveNoteItemPath(id), { force: true }).catch((err) => {
+			log.warn({
+				err,
+				id
+			}, "Failed to remove note item file");
+		});
+		await rm(resolveNoteMediaDir(id), {
+			recursive: true,
+			force: true
+		}).catch(() => void 0);
+		const index = await this.loadIndex();
+		const before = index.notes.length;
+		index.notes = index.notes.filter((n) => n.id !== id);
+		if (index.notes.length === before) log.debug({ id }, "Deleted note file but index entry was missing");
+		index.version++;
+		this.scheduleIndexSave(index);
+		return true;
+	}
+	async listNotes(query = {}) {
+		let results = (await this.loadIndex()).notes;
+		if (query.status) results = results.filter((n) => n.status === query.status);
+		else results = results.filter((n) => n.status !== "trashed");
+		if (query.kind) results = results.filter((n) => n.kind === query.kind);
+		if (query.tag) results = results.filter((n) => n.tags?.includes(query.tag));
+		if (query.pinned !== void 0) results = results.filter((n) => Boolean(n.pinned) === query.pinned);
+		if (query.search) {
+			const term = query.search.toLowerCase();
+			results = results.filter((n) => n.title?.toLowerCase().includes(term) || n.snippet?.toLowerCase().includes(term) || n.tags?.some((t) => t.toLowerCase().includes(term)) || n.attachmentNames?.some((name) => name.includes(term)));
+		}
+		const sortField = query.sortBy || "createdAt";
+		const sortDir = query.sortOrder === "asc" ? 1 : -1;
+		results = [...results].sort((a, b) => (a[sortField] - b[sortField]) * sortDir);
+		const total = results.length;
+		const offset = query.offset || 0;
+		const limit = Math.min(query.limit || 50, 200);
+		return {
+			items: results.slice(offset, offset + limit),
+			total
+		};
+	}
+	async saveAttachment(noteId, fileName, buffer) {
+		const mediaDir = resolveNoteMediaDir(noteId);
+		await mkdir(mediaDir, { recursive: true });
+		const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, "_")}`;
+		await writeFile(join(mediaDir, safeName), buffer);
+		return {
+			relativePath: safeName,
+			size: buffer.length
+		};
+	}
+	resolveAttachmentPath(noteId, relativePath) {
+		return join(resolveNoteMediaDir(noteId), relativePath);
+	}
+	async deleteAttachmentFile(noteId, relativePath) {
+		await rm(this.resolveAttachmentPath(noteId, relativePath), { force: true }).catch((err) => {
+			log.warn({
+				err,
+				noteId,
+				relativePath
+			}, "Failed to remove note attachment file");
+		});
+	}
+	async saveSnapshot(note, trigger) {
+		const historyDir = resolveNoteHistoryDir(note.id);
+		await mkdir(historyDir, { recursive: true });
+		const snapshot = {
+			noteId: note.id,
+			timestamp: Date.now(),
+			trigger,
+			title: note.title,
+			text: note.text,
+			blocks: note.blocks,
+			tags: note.tags,
+			kind: note.kind,
+			status: note.status
+		};
+		await writeTextAtomic(join(historyDir, `${snapshot.timestamp}.json`), JSON.stringify(snapshot, null, 2));
+		log.debug({
+			noteId: note.id,
+			trigger,
+			timestamp: snapshot.timestamp
+		}, "Snapshot saved");
+	}
+	async listSnapshots(noteId) {
+		const historyDir = resolveNoteHistoryDir(noteId);
+		let files;
+		try {
+			files = await readdir(historyDir);
+		} catch {
+			return [];
+		}
+		const entries = [];
+		for (const file of files) {
+			if (!file.endsWith(".json")) continue;
+			const timestamp = parseInt(file.slice(0, -5), 10);
+			if (!Number.isFinite(timestamp)) continue;
+			try {
+				const content = await readFile(join(historyDir, file), "utf-8");
+				const snapshot = JSON.parse(content);
+				const rawText = snapshot.text ?? "";
+				entries.push({
+					timestamp: snapshot.timestamp,
+					trigger: snapshot.trigger,
+					snippet: rawText.slice(0, 80) || void 0
+				});
+			} catch {
+				log.debug({
+					noteId,
+					file
+				}, "Skipped unreadable snapshot");
+			}
+		}
+		entries.sort((a, b) => b.timestamp - a.timestamp);
+		return entries;
+	}
+	async getSnapshot(noteId, timestamp) {
+		const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);
+		try {
+			const content = await readFile(filePath, "utf-8");
+			return JSON.parse(content);
+		} catch {
+			return null;
+		}
+	}
+	async pruneSnapshots(noteId, maxCount) {
+		const historyDir = resolveNoteHistoryDir(noteId);
+		let files;
+		try {
+			files = await readdir(historyDir);
+		} catch {
+			return;
+		}
+		const jsonFiles = files.filter((f) => f.endsWith(".json")).sort();
+		if (jsonFiles.length <= maxCount) return;
+		const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);
+		for (const file of toDelete) await rm(join(historyDir, file), { force: true }).catch(() => void 0);
+		log.debug({
+			noteId,
+			deleted: toDelete.length
+		}, "Pruned old snapshots");
+	}
+	async deleteAllSnapshots(noteId) {
+		await rm(resolveNoteHistoryDir(noteId), {
+			recursive: true,
+			force: true
+		}).catch(() => void 0);
+	}
+	async flush() {
+		if (!this.dirty || !this.indexCache) return;
+		if (this.saveTimeout) {
+			clearTimeout(this.saveTimeout);
+			this.saveTimeout = null;
+		}
+		await this.writeIndex(this.indexCache);
+		this.dirty = false;
+	}
+	async loadIndex() {
+		if (this.indexCache) return this.indexCache;
+		const indexPath = resolveNotesIndexPath();
+		try {
+			const content = await readFile(indexPath, "utf-8");
+			const data = JSON.parse(content);
+			if (!data.notes || !Array.isArray(data.notes)) {
+				log.warn("Notes index invalid, resetting");
+				this.indexCache = DEFAULT_INDEX;
+				return this.indexCache;
+			}
+			this.indexCache = data;
+			return data;
+		} catch {
+			this.indexCache = DEFAULT_INDEX;
+			return this.indexCache;
+		}
+	}
+	async writeIndex(data) {
+		await writeTextAtomic(resolveNotesIndexPath(), JSON.stringify(data, null, 2));
+		log.debug({ count: data.notes.length }, "Notes index saved");
+	}
+	async writeNoteItem(note) {
+		await writeTextAtomic(resolveNoteItemPath(note.id), JSON.stringify(note, null, 2));
+	}
+	scheduleIndexSave(data) {
+		this.indexCache = data;
+		this.dirty = true;
+		if (this.saveTimeout) clearTimeout(this.saveTimeout);
+		this.saveTimeout = setTimeout(() => {
+			this.flush().catch((err) => {
+				log.error({ err }, "Failed to flush notes index");
+			});
+		}, DEBOUNCE_MS);
+	}
+	async rebuildIndexFromItems() {
+		const itemsDir = join(resolveNotesDir(), "items");
+		let files;
+		try {
+			files = await readdir(itemsDir);
+		} catch {
+			this.indexCache = DEFAULT_INDEX;
+			await this.writeIndex(DEFAULT_INDEX);
+			return;
+		}
+		const entries = [];
+		for (const file of files) {
+			if (!file.endsWith(".json")) continue;
+			const noteId = file.slice(0, -5);
+			const note = await this.getNote(noteId);
+			if (note) entries.push(noteToIndexEntry(note));
+		}
+		entries.sort((a, b) => b.createdAt - a.createdAt);
+		const index = {
+			version: INDEX_VERSION,
+			notes: entries
+		};
+		this.indexCache = index;
+		await this.writeIndex(index);
+		log.debug({ count: entries.length }, "Notes index rebuilt");
+	}
+};
+//#endregion
+export { NotesStore };
+
+//# sourceMappingURL=store.js.map

package/dist/src/notes/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, access, mkdir, writeFile, rm, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { createLogger } from '../utils/logger.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNotesDir, resolveNotesIndexPath, resolveNoteItemPath, resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesIndexFile,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nconst DEFAULT_INDEX: NotesIndexFile = { version: 3, notes: [] };\nconst INDEX_VERSION = 3;\nconst DEBOUNCE_MS = 500;\n\nfunction noteToIndexEntry(note: Note): NoteIndexEntry {\n  const { snippet, coverAttachmentId, voiceAttachmentId, voiceDurationSec, attachmentNames } = buildNoteIndexMeta(note);\n  return {\n    id: note.id,\n    title: note.title || undefined,\n    kind: note.kind,\n    status: note.status,\n    createdAt: note.createdAt,\n    updatedAt: note.updatedAt,\n    pinned: note.pinned || undefined,\n    tags: note.tags?.length ? note.tags : undefined,\n    snippet,\n    coverAttachmentId,\n    voiceAttachmentId,\n    voiceDurationSec,\n    attachmentNames,\n  };\n}\n\nexport class NotesStore {\n  private indexCache: NotesIndexFile | null = null;\n  private dirty = false;\n  private saveTimeout: ReturnType<typeof setTimeout> | null = null;\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    const indexPath = resolveNotesIndexPath();\n    try {\n      await access(indexPath);\n      await this.loadIndex();\n      if ((this.indexCache?.version ?? 0) < INDEX_VERSION) {\n        await this.rebuildIndexFromItems();\n      }\n    } catch {\n      await this.writeIndex(DEFAULT_INDEX);\n      this.indexCache = DEFAULT_INDEX;\n    }\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    const index = await this.loadIndex();\n    await this.writeNoteItem(note);\n    index.notes.push(noteToIndexEntry(note));\n    index.version++;\n    this.scheduleIndexSave(index);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    const itemPath = resolveNoteItemPath(id);\n    try {\n      const content = await readFile(itemPath, 'utf-8');\n      return JSON.parse(content) as Note;\n    } catch (err) {\n      const code = err && typeof err === 'object' && 'code' in err\n        ? (err as NodeJS.ErrnoException).code : '';\n      if (code !== 'ENOENT') {\n        log.debug({ err, id }, 'Failed to read note item');\n      }\n      return null;\n    }\n  }\n\n  async updateNote(id: string, patch: Partial<Note>): Promise<Note | null> {\n    const existing = await this.getNote(id);\n    if (!existing) return null;\n\n    const updated: Note = {\n      ...existing,\n      ...patch,\n      id: existing.id,\n      createdAt: existing.createdAt,\n      updatedAt: Date.now(),\n    };\n\n    await this.writeNoteItem(updated);\n\n    const index = await this.loadIndex();\n    const idx = index.notes.findIndex((n) => n.id === id);\n    if (idx !== -1) {\n      index.notes[idx] = noteToIndexEntry(updated);\n    }\n    index.version++;\n    this.scheduleIndexSave(index);\n\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    const existing = await this.getNote(id);\n    if (!existing) return false;\n\n    const itemPath = resolveNoteItemPath(id);\n    await rm(itemPath, { force: true }).catch((err) => {\n      log.warn({ err, id }, 'Failed to remove note item file');\n    });\n\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n\n    const index = await this.loadIndex();\n    const before = index.notes.length;\n    index.notes = index.notes.filter((n) => n.id !== id);\n    if (index.notes.length === before) {\n      log.debug({ id }, 'Deleted note file but index entry was missing');\n    }\n    index.version++;\n    this.scheduleIndexSave(index);\n\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{ items: NoteIndexEntry[]; total: number }> {\n    const index = await this.loadIndex();\n    let results = index.notes;\n\n    if (query.status) {\n      results = results.filter((n) => n.status === query.status);\n    } else {\n      results = results.filter((n) => n.status !== 'trashed');\n    }\n    if (query.kind) {\n      results = results.filter((n) => n.kind === query.kind);\n    }\n    if (query.tag) {\n      results = results.filter((n) => n.tags?.includes(query.tag!));\n    }\n    if (query.pinned !== undefined) {\n      results = results.filter((n) => Boolean(n.pinned) === query.pinned);\n    }\n    if (query.search) {\n      const term = query.search.toLowerCase();\n      results = results.filter((n) =>\n        n.title?.toLowerCase().includes(term) ||\n        n.snippet?.toLowerCase().includes(term) ||\n        n.tags?.some((t) => t.toLowerCase().includes(term)) ||\n        n.attachmentNames?.some((name) => name.includes(term)),\n      );\n    }\n\n    const sortField = query.sortBy || 'createdAt';\n    const sortDir = query.sortOrder === 'asc' ? 1 : -1;\n    results = [...results].sort((a, b) => (a[sortField] - b[sortField]) * sortDir);\n\n    const total = results.length;\n    const offset = query.offset || 0;\n    const limit = Math.min(query.limit || 50, 200);\n    const items = results.slice(offset, offset + limit);\n\n    return { items, total };\n  }\n\n  async saveAttachment(\n    noteId: string,\n    fileName: string,\n    buffer: Buffer,\n  ): Promise<{ relativePath: string; size: number }> {\n    const mediaDir = resolveNoteMediaDir(noteId);\n    await mkdir(mediaDir, { recursive: true });\n    const safeName = `${randomUUID().slice(0, 8)}_${fileName.replace(/[^a-zA-Z0-9._-]/g, '_')}`;\n    const filePath = join(mediaDir, safeName);\n    await writeFile(filePath, buffer);\n    return { relativePath: safeName, size: buffer.length };\n  }\n\n  resolveAttachmentPath(noteId: string, relativePath: string): string {\n    return join(resolveNoteMediaDir(noteId), relativePath);\n  }\n\n  async deleteAttachmentFile(noteId: string, relativePath: string): Promise<void> {\n    const filePath = this.resolveAttachmentPath(noteId, relativePath);\n    await rm(filePath, { force: true }).catch((err) => {\n      log.warn({ err, noteId, relativePath }, 'Failed to remove note attachment file');\n    });\n  }\n\n  async saveSnapshot(note: Note, trigger: SnapshotTrigger): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(note.id);\n    await mkdir(historyDir, { recursive: true });\n    const snapshot: NoteSnapshot = {\n      noteId: note.id,\n      timestamp: Date.now(),\n      trigger,\n      title: note.title,\n      text: note.text,\n      blocks: note.blocks,\n      tags: note.tags,\n      kind: note.kind,\n      status: note.status,\n    };\n    const filePath = join(historyDir, `${snapshot.timestamp}.json`);\n    await writeTextAtomic(filePath, JSON.stringify(snapshot, null, 2));\n    log.debug({ noteId: note.id, trigger, timestamp: snapshot.timestamp }, 'Snapshot saved');\n  }\n\n  async listSnapshots(noteId: string): Promise<NoteSnapshotEntry[]> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return [];\n    }\n    const entries: NoteSnapshotEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const timestamp = parseInt(file.slice(0, -'.json'.length), 10);\n      if (!Number.isFinite(timestamp)) continue;\n      try {\n        const content = await readFile(join(historyDir, file), 'utf-8');\n        const snapshot = JSON.parse(content) as NoteSnapshot;\n        const rawText = snapshot.text ?? '';\n        entries.push({\n          timestamp: snapshot.timestamp,\n          trigger: snapshot.trigger,\n          snippet: rawText.slice(0, 80) || undefined,\n        });\n      } catch {\n        log.debug({ noteId, file }, 'Skipped unreadable snapshot');\n      }\n    }\n    entries.sort((a, b) => b.timestamp - a.timestamp);\n    return entries;\n  }\n\n  async getSnapshot(noteId: string, timestamp: number): Promise<NoteSnapshot | null> {\n    const filePath = join(resolveNoteHistoryDir(noteId), `${timestamp}.json`);\n    try {\n      const content = await readFile(filePath, 'utf-8');\n      return JSON.parse(content) as NoteSnapshot;\n    } catch {\n      return null;\n    }\n  }\n\n  async pruneSnapshots(noteId: string, maxCount: number): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    let files: string[];\n    try {\n      files = await readdir(historyDir);\n    } catch {\n      return;\n    }\n    const jsonFiles = files\n      .filter((f) => f.endsWith('.json'))\n      .sort();\n    if (jsonFiles.length <= maxCount) return;\n    const toDelete = jsonFiles.slice(0, jsonFiles.length - maxCount);\n    for (const file of toDelete) {\n      await rm(join(historyDir, file), { force: true }).catch(() => undefined);\n    }\n    log.debug({ noteId, deleted: toDelete.length }, 'Pruned old snapshots');\n  }\n\n  async deleteAllSnapshots(noteId: string): Promise<void> {\n    const historyDir = resolveNoteHistoryDir(noteId);\n    await rm(historyDir, { recursive: true, force: true }).catch(() => undefined);\n  }\n\n  async flush(): Promise<void> {\n    if (!this.dirty || !this.indexCache) return;\n    if (this.saveTimeout) {\n      clearTimeout(this.saveTimeout);\n      this.saveTimeout = null;\n    }\n    await this.writeIndex(this.indexCache);\n    this.dirty = false;\n  }\n\n  private async loadIndex(): Promise<NotesIndexFile> {\n    if (this.indexCache) return this.indexCache;\n    const indexPath = resolveNotesIndexPath();\n    try {\n      const content = await readFile(indexPath, 'utf-8');\n      const data = JSON.parse(content) as NotesIndexFile;\n      if (!data.notes || !Array.isArray(data.notes)) {\n        log.warn('Notes index invalid, resetting');\n        this.indexCache = DEFAULT_INDEX;\n        return this.indexCache;\n      }\n      this.indexCache = data;\n      return data;\n    } catch {\n      this.indexCache = DEFAULT_INDEX;\n      return this.indexCache;\n    }\n  }\n\n  private async writeIndex(data: NotesIndexFile): Promise<void> {\n    const indexPath = resolveNotesIndexPath();\n    await writeTextAtomic(indexPath, JSON.stringify(data, null, 2));\n    log.debug({ count: data.notes.length }, 'Notes index saved');\n  }\n\n  private async writeNoteItem(note: Note): Promise<void> {\n    const itemPath = resolveNoteItemPath(note.id);\n    await writeTextAtomic(itemPath, JSON.stringify(note, null, 2));\n  }\n\n  private scheduleIndexSave(data: NotesIndexFile): void {\n    this.indexCache = data;\n    this.dirty = true;\n    if (this.saveTimeout) {\n      clearTimeout(this.saveTimeout);\n    }\n    this.saveTimeout = setTimeout(() => {\n      this.flush().catch((err) => {\n        log.error({ err }, 'Failed to flush notes index');\n      });\n    }, DEBOUNCE_MS);\n  }\n\n  private async rebuildIndexFromItems(): Promise<void> {\n    const itemsDir = join(resolveNotesDir(), 'items');\n    let files: string[];\n    try {\n      files = await readdir(itemsDir);\n    } catch {\n      this.indexCache = DEFAULT_INDEX;\n      await this.writeIndex(DEFAULT_INDEX);\n      return;\n    }\n\n    const entries: NoteIndexEntry[] = [];\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue;\n      const noteId = file.slice(0, -'.json'.length);\n      const note = await this.getNote(noteId);\n      if (note) {\n        entries.push(noteToIndexEntry(note));\n      }\n    }\n\n    entries.sort((a, b) => b.createdAt - a.createdAt);\n    const index: NotesIndexFile = { version: INDEX_VERSION, notes: entries };\n    this.indexCache = index;\n    await this.writeIndex(index);\n    log.debug({ count: entries.length }, 'Notes index rebuilt');\n  }\n}\n"],"mappings":"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"}

package/dist/src/notes/types.d.ts

@@ -0,0 +1,162 @@
+export type NoteKind = 'thought' | 'todo' | 'voice' | 'media' | 'bookmark' | 'mixed';
+export type NoteStatus = 'inbox' | 'processed' | 'archived' | 'trashed';
+export type CaptureChannel = 'app' | 'web' | 'electron' | 'tui' | 'telegram' | 'wechat' | 'feishu';
+export type NoteBlockType = 'paragraph' | 'heading' | 'todo' | 'bulletList' | 'numberedList' | 'quote' | 'code' | 'divider' | 'image' | 'aiSuggestion';
+export interface BaseNoteBlock {
+    id: string;
+    type: NoteBlockType;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface TextNoteBlock extends BaseNoteBlock {
+    type: 'paragraph' | 'heading' | 'bulletList' | 'numberedList' | 'quote' | 'code' | 'aiSuggestion';
+    text: string;
+    level?: 1 | 2 | 3;
+    indent?: number;
+}
+export interface TodoNoteBlock extends BaseNoteBlock {
+    type: 'todo';
+    text: string;
+    checked: boolean;
+}
+export interface DividerNoteBlock extends BaseNoteBlock {
+    type: 'divider';
+}
+export interface ImageNoteBlock extends BaseNoteBlock {
+    type: 'image';
+    attachmentId: string;
+    alt?: string;
+    width?: number;
+}
+export type NoteBlock = TextNoteBlock | TodoNoteBlock | DividerNoteBlock | ImageNoteBlock;
+export type NotePatchOperation = {
+    type: 'replaceBlocks';
+    blocks: NoteBlock[];
+} | {
+    type: 'insertBlocksAfter';
+    afterBlockId: string;
+    blocks: NoteBlock[];
+} | {
+    type: 'updateBlock';
+    blockId: string;
+    patch: Partial<NoteBlock>;
+} | {
+    type: 'updateMetadata';
+    title?: string;
+    tags?: string[];
+    status?: NoteStatus;
+};
+export interface NoteAiPatch {
+    id: string;
+    summary: string;
+    operations: NotePatchOperation[];
+}
+export interface NoteAttachment {
+    id: string;
+    type: 'image' | 'video' | 'audio' | 'file';
+    mimeType: string;
+    fileName: string;
+    size: number;
+    relativePath: string;
+    transcript?: string;
+    duration?: number;
+}
+export interface NoteAiMeta {
+    summary?: string;
+    intent?: 'action_item' | 'idea' | 'reference' | 'question' | 'log';
+    extractedTodos?: Array<{
+        text: string;
+        deadline?: string;
+        done: boolean;
+    }>;
+    suggestedTags?: string[];
+}
+export interface NoteAiDeepMeta {
+    processedAt: number;
+    priority?: 'high' | 'medium' | 'low';
+    relatedNoteIds?: string[];
+    relatedGoalId?: string;
+    insights?: string;
+}
+export interface CaptureSource {
+    channel: CaptureChannel;
+    platform?: 'ios' | 'android';
+}
+export interface Note {
+    id: string;
+    title?: string;
+    kind: NoteKind;
+    status: NoteStatus;
+    text?: string;
+    blocks?: NoteBlock[];
+    attachments?: NoteAttachment[];
+    createdAt: number;
+    updatedAt: number;
+    capturedVia: CaptureSource;
+    ai?: NoteAiMeta;
+    aiDeep?: NoteAiDeepMeta;
+    tags?: string[];
+    pinned?: boolean;
+    localVersion?: number;
+    remoteVersion?: number;
+}
+export interface NoteIndexEntry {
+    id: string;
+    title?: string;
+    kind: NoteKind;
+    status: NoteStatus;
+    createdAt: number;
+    updatedAt: number;
+    pinned?: boolean;
+    tags?: string[];
+    snippet?: string;
+    /** First image attachment id for list thumbnails. */
+    coverAttachmentId?: string;
+    /** First audio attachment id for inline voice playback. */
+    voiceAttachmentId?: string;
+    /** Duration in seconds of the voice attachment (when available). */
+    voiceDurationSec?: number;
+    /** Lowercased attachment file names for list search. */
+    attachmentNames?: string[];
+}
+export interface NotesIndexFile {
+    version: number;
+    notes: NoteIndexEntry[];
+}
+export type SnapshotTrigger = 'edit' | 'ai_edit' | 'sync' | 'restore';
+export interface NoteSnapshot {
+    noteId: string;
+    timestamp: number;
+    trigger: SnapshotTrigger;
+    title?: string;
+    text?: string;
+    blocks?: NoteBlock[];
+    tags?: string[];
+    kind: NoteKind;
+    status: NoteStatus;
+}
+export interface NoteSnapshotEntry {
+    timestamp: number;
+    trigger: SnapshotTrigger;
+    snippet?: string;
+}
+export interface NotesListQuery {
+    status?: NoteStatus;
+    kind?: NoteKind;
+    tag?: string;
+    pinned?: boolean;
+    search?: string;
+    limit?: number;
+    offset?: number;
+    sortBy?: 'createdAt' | 'updatedAt';
+    sortOrder?: 'asc' | 'desc';
+}
+export interface CreateNoteParams {
+    title?: string;
+    text?: string;
+    blocks?: NoteBlock[];
+    kind?: NoteKind;
+    tags?: string[];
+    capturedVia: CaptureSource;
+    pinned?: boolean;
+}

package/dist/src/notes/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/routing/resolve-route.d.ts

@@ -3,6 +3,7 @@
  *
  * Combines binding rules, identity links, and config to pick an agent and session keys.
  */
+import type { LocalizedText } from '../config/localized-text.js';
 import type { BindingRule, RouteInput, RouteResult } from './bindings.js';
 /**
  * Route context type (alias for RouteInput)
@@ -52,7 +53,8 @@ export interface AgentConfig {
     /** Registered agents */
     list?: Array<{
         id: string;
-        name?: string;
+        name?: LocalizedText;
+        description?: LocalizedText;
         enabled?: boolean;
         [key: string]: unknown;
     }>;

package/dist/src/routing/resolve-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-route.js","names":["resolveDefaultAgentIdFromConfig","resolveBindingRoute"],"sources":["../../../src/routing/resolve-route.ts"],"sourcesContent":["/**\n * Route resolution\n *\n * Combines binding rules, identity links, and config to pick an agent and session keys.\n */\n\nimport { resolveDefaultAgentId as resolveDefaultAgentIdFromConfig } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport type { BindingRule, RouteInput, RouteResult } from './bindings.js';\n\n/**\n * Route context type (alias for RouteInput)\n */\nexport type RouteContext = RouteInput;\nimport { parseBindingRules, resolveRoute as resolveBindingRoute } from './bindings.js';\nimport { buildSessionKey, normalizeSessionKey, parseSessionKey } from './session-key.js';\nimport {\n  buildAgentMainSessionKey,\n  buildAgentPeerSessionKey,\n} from './agent-session-key.js';\nimport { normalizeAccountId } from './account-id.js';\n\n/**\n * Identity link map: canonical peer id -> aliases across channels.\n *\n * Shape: `{ canonicalName: [alias1, alias2, ...] }`\n */\nexport type IdentityLinks = Record<string, string[]>;\n\n/**\n * Session-related routing options.\n */\nexport interface SessionConfig {\n  scope?: 'per-sender' | 'global';\n  mainKey?: string;\n  /** How DM sessions are scoped / merged */\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n  /** Cross-channel identity aliases */\n  identityLinks?: IdentityLinks;\n  resetTriggers?: string[];\n  idleMinutes?: number;\n  reset?: {\n    mode?: 'daily' | 'idle';\n    atHour?: number;\n    idleMinutes?: number;\n  };\n  resetByType?: {\n    direct?: SessionConfig['reset'];\n    group?: SessionConfig['reset'];\n    thread?: SessionConfig['reset'];\n  };\n  resetByChannel?: Record<string, NonNullable<SessionConfig['reset']>>;\n  /** Optional session store tuning */\n  storage?: {\n    pruneAfterMs?: number;\n    maxEntries?: number;\n  };\n}\n\n/**\n * Agent list and default id from config.\n */\nexport interface AgentConfig {\n  /** Default agent id */\n  default?: string;\n  /** Registered agents */\n  list?: Array<{\n    id: string;\n    name?: string;\n    enabled?: boolean;\n    [key: string]: unknown;\n  }>;\n}\n\n/**\n * Subset of app config used for routing.\n */\nexport interface RoutingConfig {\n  agents?: AgentConfig;\n  bindings?: BindingRule[] | any[];\n  session?: SessionConfig;\n}\n\n/**\n * Input to `resolveRoute`.\n */\nexport interface ResolveRouteInput extends RouteInput {\n  /** Routing config snapshot */\n  config: RoutingConfig;\n  /** Optional thread id for threaded channels */\n  threadId?: string | null;\n}\n\n/**\n * Resolved route including session keys.\n */\nexport interface ResolveRouteResult extends RouteResult {\n  /** Active session key for this turn */\n  sessionKey: string;\n  /** Main session key (DM merge target) */\n  mainSessionKey: string;\n  /** Whether routing used the main or a per-session key */\n  lastRoutePolicy: 'main' | 'session';\n}\n\n/**\n * Apply identity links and return a canonical lowercased peer id.\n */\nexport function applyIdentityLinks(\n  peerId: string,\n  channel: string,\n  identityLinks?: IdentityLinks\n): string {\n  if (!identityLinks) {\n    return peerId.toLowerCase();\n  }\n  \n  const normalizedPeerId = peerId.trim().toLowerCase();\n  if (!normalizedPeerId) {\n    return normalizedPeerId;\n  }\n  \n  const candidates = new Set<string>();\n  candidates.add(normalizedPeerId);\n  \n  const channelPrefix = channel.trim().toLowerCase();\n  if (channelPrefix) {\n    candidates.add(`${channelPrefix}:${normalizedPeerId}`);\n  }\n  \n  // Match any alias to its canonical id\n  for (const [canonical, aliases] of Object.entries(identityLinks)) {\n    if (!Array.isArray(aliases)) {\n      continue;\n    }\n    \n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (candidates.has(normalizedAlias)) {\n        return canonical.trim().toLowerCase();\n      }\n    }\n  }\n  \n  return normalizedPeerId;\n}\n\n/**\n * Default agent id from config (`agents.default`, `list[].default`, or `main`).\n */\nexport function getDefaultAgentId(config: RoutingConfig): string {\n  return resolveDefaultAgentIdFromConfig(config as Config);\n}\n\n/**\n * Whether `agentId` appears in the enabled agent list (or list is absent).\n */\nexport function agentExists(agentId: string, config: RoutingConfig): boolean {\n  if (!config.agents?.list) {\n    return true; // No list: treat every id as valid\n  }\n  \n  return config.agents.list.some(\n    (agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase()\n  );\n}\n\n/**\n * Return `agentId` if listed, otherwise the default agent id.\n */\nexport function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string {\n  if (!agentId) {\n    return getDefaultAgentId(config);\n  }\n  \n  if (agentExists(agentId, config)) {\n    return agentId.toLowerCase();\n  }\n  \n  return getDefaultAgentId(config);\n}\n\n/**\n * Thin wrapper around `buildSessionKey` for route inputs.\n */\nexport function buildRouteSessionKey(\n  agentId: string,\n  channel: string,\n  accountId: string,\n  peerKind: string,\n  peerId: string,\n  threadId?: string | null,\n  scopeId?: string | null,\n): string {\n  return buildSessionKey({\n    agentId,\n    source: channel,\n    accountId,\n    peerKind,\n    peerId,\n    threadId: threadId || undefined,\n    scopeId: scopeId || undefined,\n    dmScope: peerKind === 'dm' || peerKind === 'direct' ? 'per-account-channel-peer' : undefined,\n  });\n}\n\n/**\n * Map session vs main key to policy label.\n */\nexport function deriveLastRoutePolicy(\n  sessionKey: string,\n  mainSessionKey: string\n): 'main' | 'session' {\n  return sessionKey === mainSessionKey ? 'main' : 'session';\n}\n\n/**\n * Resolve agent and session keys from channel context and config.\n */\nexport function resolveRoute(input: ResolveRouteInput): ResolveRouteResult {\n  const { config, threadId } = input;\n  \n  const channel = (input.channel ?? '').trim().toLowerCase() || 'unknown';\n  const accountId = normalizeAccountId(input.accountId);\n  const peerKind = (input.peerKind ?? 'dm').toLowerCase();\n  const rawPeerId = (input.peerId ?? '').trim();\n  \n  const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});\n  \n  const rules = Array.isArray(config.bindings)\n    ? parseBindingRules({ bindings: config.bindings })\n    : [];\n  \n  const bindingResult = resolveBindingRoute(\n    {\n      channel,\n      accountId,\n      peerKind: input.peerKind,\n      peerId: rawPeerId,\n      guildId: input.guildId,\n      teamId: input.teamId,\n      memberRoleIds: input.memberRoleIds,\n    },\n    rules,\n    getDefaultAgentId(config)\n  );\n  \n  const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);\n  \n  const dmScope = config.session?.dmScope ?? 'main';\n\n  let sessionKey: string;\n  let mainSessionKey: string;\n\n  const identityLinks = config.session?.identityLinks;\n  const mainKey = undefined;\n\n  if (peerKind === 'dm' || peerKind === 'direct') {\n    mainSessionKey = buildAgentMainSessionKey({ agentId, mainKey });\n\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: 'direct',\n      peerId,\n      identityLinks,\n      dmScope,\n    });\n  } else {\n    const mappedKind = peerKind === 'group' || peerKind === 'channel' ? peerKind : peerKind;\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId,\n      identityLinks,\n    });\n    mainSessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId: 'main',\n      identityLinks,\n    });\n  }\n\n  if (threadId && !sessionKey.includes(':thread:')) {\n    sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;\n  }\n  \n  sessionKey = normalizeSessionKey(sessionKey);\n  mainSessionKey = normalizeSessionKey(mainSessionKey);\n  \n  return {\n    ...bindingResult,\n    agentId,\n    sessionKey,\n    mainSessionKey,\n    lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey),\n  };\n}\n\n/**\n * Parse basic routing fields from a session key string.\n */\nexport function resolveRouteFromSessionKey(\n  sessionKey: string,\n  _config: RoutingConfig\n): { agentId: string; source: string; accountId: string; peerKind: string; peerId: string } | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) {\n    return null;\n  }\n  \n  return {\n    agentId: parsed.agentId,\n    source: parsed.source,\n    accountId: parsed.accountId,\n    peerKind: parsed.peerKind,\n    peerId: parsed.peerId,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve-route.js","names":["resolveDefaultAgentIdFromConfig","resolveBindingRoute"],"sources":["../../../src/routing/resolve-route.ts"],"sourcesContent":["/**\n * Route resolution\n *\n * Combines binding rules, identity links, and config to pick an agent and session keys.\n */\n\nimport { resolveDefaultAgentId as resolveDefaultAgentIdFromConfig } from '../agent/agent-scope.js';\nimport type { Config } from '../config/schema.js';\nimport type { LocalizedText } from '../config/localized-text.js';\nimport type { BindingRule, RouteInput, RouteResult } from './bindings.js';\n\n/**\n * Route context type (alias for RouteInput)\n */\nexport type RouteContext = RouteInput;\nimport { parseBindingRules, resolveRoute as resolveBindingRoute } from './bindings.js';\nimport { buildSessionKey, normalizeSessionKey, parseSessionKey } from './session-key.js';\nimport {\n  buildAgentMainSessionKey,\n  buildAgentPeerSessionKey,\n} from './agent-session-key.js';\nimport { normalizeAccountId } from './account-id.js';\n\n/**\n * Identity link map: canonical peer id -> aliases across channels.\n *\n * Shape: `{ canonicalName: [alias1, alias2, ...] }`\n */\nexport type IdentityLinks = Record<string, string[]>;\n\n/**\n * Session-related routing options.\n */\nexport interface SessionConfig {\n  scope?: 'per-sender' | 'global';\n  mainKey?: string;\n  /** How DM sessions are scoped / merged */\n  dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-account-channel-peer';\n  /** Cross-channel identity aliases */\n  identityLinks?: IdentityLinks;\n  resetTriggers?: string[];\n  idleMinutes?: number;\n  reset?: {\n    mode?: 'daily' | 'idle';\n    atHour?: number;\n    idleMinutes?: number;\n  };\n  resetByType?: {\n    direct?: SessionConfig['reset'];\n    group?: SessionConfig['reset'];\n    thread?: SessionConfig['reset'];\n  };\n  resetByChannel?: Record<string, NonNullable<SessionConfig['reset']>>;\n  /** Optional session store tuning */\n  storage?: {\n    pruneAfterMs?: number;\n    maxEntries?: number;\n  };\n}\n\n/**\n * Agent list and default id from config.\n */\nexport interface AgentConfig {\n  /** Default agent id */\n  default?: string;\n  /** Registered agents */\n  list?: Array<{\n    id: string;\n    name?: LocalizedText;\n    description?: LocalizedText;\n    enabled?: boolean;\n    [key: string]: unknown;\n  }>;\n}\n\n/**\n * Subset of app config used for routing.\n */\nexport interface RoutingConfig {\n  agents?: AgentConfig;\n  bindings?: BindingRule[] | any[];\n  session?: SessionConfig;\n}\n\n/**\n * Input to `resolveRoute`.\n */\nexport interface ResolveRouteInput extends RouteInput {\n  /** Routing config snapshot */\n  config: RoutingConfig;\n  /** Optional thread id for threaded channels */\n  threadId?: string | null;\n}\n\n/**\n * Resolved route including session keys.\n */\nexport interface ResolveRouteResult extends RouteResult {\n  /** Active session key for this turn */\n  sessionKey: string;\n  /** Main session key (DM merge target) */\n  mainSessionKey: string;\n  /** Whether routing used the main or a per-session key */\n  lastRoutePolicy: 'main' | 'session';\n}\n\n/**\n * Apply identity links and return a canonical lowercased peer id.\n */\nexport function applyIdentityLinks(\n  peerId: string,\n  channel: string,\n  identityLinks?: IdentityLinks\n): string {\n  if (!identityLinks) {\n    return peerId.toLowerCase();\n  }\n  \n  const normalizedPeerId = peerId.trim().toLowerCase();\n  if (!normalizedPeerId) {\n    return normalizedPeerId;\n  }\n  \n  const candidates = new Set<string>();\n  candidates.add(normalizedPeerId);\n  \n  const channelPrefix = channel.trim().toLowerCase();\n  if (channelPrefix) {\n    candidates.add(`${channelPrefix}:${normalizedPeerId}`);\n  }\n  \n  // Match any alias to its canonical id\n  for (const [canonical, aliases] of Object.entries(identityLinks)) {\n    if (!Array.isArray(aliases)) {\n      continue;\n    }\n    \n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (candidates.has(normalizedAlias)) {\n        return canonical.trim().toLowerCase();\n      }\n    }\n  }\n  \n  return normalizedPeerId;\n}\n\n/**\n * Default agent id from config (`agents.default`, `list[].default`, or `main`).\n */\nexport function getDefaultAgentId(config: RoutingConfig): string {\n  return resolveDefaultAgentIdFromConfig(config as Config);\n}\n\n/**\n * Whether `agentId` appears in the enabled agent list (or list is absent).\n */\nexport function agentExists(agentId: string, config: RoutingConfig): boolean {\n  if (!config.agents?.list) {\n    return true; // No list: treat every id as valid\n  }\n  \n  return config.agents.list.some(\n    (agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase()\n  );\n}\n\n/**\n * Return `agentId` if listed, otherwise the default agent id.\n */\nexport function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string {\n  if (!agentId) {\n    return getDefaultAgentId(config);\n  }\n  \n  if (agentExists(agentId, config)) {\n    return agentId.toLowerCase();\n  }\n  \n  return getDefaultAgentId(config);\n}\n\n/**\n * Thin wrapper around `buildSessionKey` for route inputs.\n */\nexport function buildRouteSessionKey(\n  agentId: string,\n  channel: string,\n  accountId: string,\n  peerKind: string,\n  peerId: string,\n  threadId?: string | null,\n  scopeId?: string | null,\n): string {\n  return buildSessionKey({\n    agentId,\n    source: channel,\n    accountId,\n    peerKind,\n    peerId,\n    threadId: threadId || undefined,\n    scopeId: scopeId || undefined,\n    dmScope: peerKind === 'dm' || peerKind === 'direct' ? 'per-account-channel-peer' : undefined,\n  });\n}\n\n/**\n * Map session vs main key to policy label.\n */\nexport function deriveLastRoutePolicy(\n  sessionKey: string,\n  mainSessionKey: string\n): 'main' | 'session' {\n  return sessionKey === mainSessionKey ? 'main' : 'session';\n}\n\n/**\n * Resolve agent and session keys from channel context and config.\n */\nexport function resolveRoute(input: ResolveRouteInput): ResolveRouteResult {\n  const { config, threadId } = input;\n  \n  const channel = (input.channel ?? '').trim().toLowerCase() || 'unknown';\n  const accountId = normalizeAccountId(input.accountId);\n  const peerKind = (input.peerKind ?? 'dm').toLowerCase();\n  const rawPeerId = (input.peerId ?? '').trim();\n  \n  const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});\n  \n  const rules = Array.isArray(config.bindings)\n    ? parseBindingRules({ bindings: config.bindings })\n    : [];\n  \n  const bindingResult = resolveBindingRoute(\n    {\n      channel,\n      accountId,\n      peerKind: input.peerKind,\n      peerId: rawPeerId,\n      guildId: input.guildId,\n      teamId: input.teamId,\n      memberRoleIds: input.memberRoleIds,\n    },\n    rules,\n    getDefaultAgentId(config)\n  );\n  \n  const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);\n  \n  const dmScope = config.session?.dmScope ?? 'main';\n\n  let sessionKey: string;\n  let mainSessionKey: string;\n\n  const identityLinks = config.session?.identityLinks;\n  const mainKey = undefined;\n\n  if (peerKind === 'dm' || peerKind === 'direct') {\n    mainSessionKey = buildAgentMainSessionKey({ agentId, mainKey });\n\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: 'direct',\n      peerId,\n      identityLinks,\n      dmScope,\n    });\n  } else {\n    const mappedKind = peerKind === 'group' || peerKind === 'channel' ? peerKind : peerKind;\n    sessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId,\n      identityLinks,\n    });\n    mainSessionKey = buildAgentPeerSessionKey({\n      agentId,\n      mainKey,\n      channel,\n      accountId,\n      peerKind: mappedKind as 'group' | 'channel',\n      peerId: 'main',\n      identityLinks,\n    });\n  }\n\n  if (threadId && !sessionKey.includes(':thread:')) {\n    sessionKey = `${sessionKey}:thread:${threadId.toLowerCase()}`;\n  }\n  \n  sessionKey = normalizeSessionKey(sessionKey);\n  mainSessionKey = normalizeSessionKey(mainSessionKey);\n  \n  return {\n    ...bindingResult,\n    agentId,\n    sessionKey,\n    mainSessionKey,\n    lastRoutePolicy: deriveLastRoutePolicy(sessionKey, mainSessionKey),\n  };\n}\n\n/**\n * Parse basic routing fields from a session key string.\n */\nexport function resolveRouteFromSessionKey(\n  sessionKey: string,\n  _config: RoutingConfig\n): { agentId: string; source: string; accountId: string; peerKind: string; peerId: string } | null {\n  const parsed = parseSessionKey(sessionKey);\n  if (!parsed) {\n    return null;\n  }\n  \n  return {\n    agentId: parsed.agentId,\n    source: parsed.source,\n    accountId: parsed.accountId,\n    peerKind: parsed.peerKind,\n    peerId: parsed.peerId,\n  };\n}\n"],"mappings":"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"}

package/dist/src/session/store.d.ts

@@ -22,6 +22,7 @@ export declare class SessionStore {
     private compactor;
     private storeMutationDepth;
     private storeMutationChain;
+    private allSessionsMapCache?;
     /** Cache of per-agent sessions dirs to avoid re-resolution on every call. */
     private agentSessionsDirCache;
     constructor(options: SessionStoreOptions, windowConfig?: Partial<WindowConfig>, compactionConfig?: Partial<CompactionConfig>);
@@ -39,10 +40,11 @@ export declare class SessionStore {
     private transcriptPathForEntry;
     private readMapForKey;
     private readMap;
+    private invalidateAllSessionsMapCache;
+    private discoverSessionMapPaths;
     /**
-     * OpenClaw-aligned: read sessions.json from ALL known agents and merge into a single map.
-     * Used by aggregation queries (list, getByAgent, getByAccount, etc.) so the gateway UI
-     * can display sessions across all agents.
+     * Unified cross-agent aggregation entry for global session views.
+     * Reads configured agents plus existing per-agent session maps under the state directory.
      */
     private readAllMaps;
     private getDiskEntry;