@xopcai/xopc 0.0.104 → 0.0.105

package/dist/src/notes/store.js

@@ -4,6 +4,7 @@ import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { buildNoteIndexMeta } from "./note-index-meta.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "../storage/sqlite/notes-repository.js";
+import { deleteNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveNoteHistoryDir, resolveNoteMediaDir } from "./paths.js";
 import { randomUUID } from "node:crypto";
@@ -46,6 +47,7 @@ var NotesStore = class {
 	async deleteNote(id) {
 		requireXopcDatabase();
 		if (!deleteNoteRecord(id)) return false;
+		deleteNoteAgentContextRecord(id);
 		await rm(resolveNoteMediaDir(id), {
 			recursive: true,
 			force: true

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

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, 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 {\n  deleteNoteRecord,\n  getNoteRecord,\n  listNoteRecords,\n  requireXopcDatabase,\n  upsertNoteRecord,\n} from '../storage/sqlite/index.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nexport class NotesStore {\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    requireXopcDatabase();\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    requireXopcDatabase();\n    upsertNoteRecord(note);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    requireXopcDatabase();\n    return getNoteRecord(id);\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    requireXopcDatabase();\n    upsertNoteRecord(updated);\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    requireXopcDatabase();\n    const deleted = deleteNoteRecord(id);\n    if (!deleted) {\n      return false;\n    }\n\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{\n    items: NoteIndexEntry[];\n    total: number;\n    limit: number;\n    offset: number;\n    hasMore: boolean;\n  }> {\n    requireXopcDatabase();\n    return listNoteRecords(query);\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      markdown: note.markdown,\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.markdown ?? '';\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.filter((f) => f.endsWith('.json')).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  /** No-op: SQLite writes are synchronous. Kept for API compatibility with tests. */\n  async flush(): Promise<void> {}\n}\n\nexport { buildNoteIndexMeta };\n"],"mappings":";;;;;;;;;;;;wBAIgE;aACd;AAmBlD,MAAM,MAAM,aAAa,aAAa;AAEtC,IAAa,aAAb,MAAwB;CACtB,cAAsB;CAEtB,MAAM,aAA4B;AAChC,MAAI,KAAK,YAAa;AACtB,uBAAqB;AACrB,OAAK,cAAc;AACnB,MAAI,MAAM,yBAAyB;;CAGrC,MAAM,QAAQ,MAA2B;AACvC,uBAAqB;AACrB,mBAAiB,KAAK;;CAGxB,MAAM,QAAQ,IAAkC;AAC9C,uBAAqB;AACrB,SAAO,cAAc,GAAG;;CAG1B,MAAM,WAAW,IAAY,OAA4C;EACvE,MAAM,WAAW,MAAM,KAAK,QAAQ,GAAG;AACvC,MAAI,CAAC,SAAU,QAAO;EAEtB,MAAM,UAAgB;GACpB,GAAG;GACH,GAAG;GACH,IAAI,SAAS;GACb,WAAW,SAAS;GACpB,WAAW,KAAK,KAAK;GACtB;AAED,uBAAqB;AACrB,mBAAiB,QAAQ;AACzB,SAAO;;CAGT,MAAM,WAAW,IAA8B;AAC7C,uBAAqB;AAErB,MAAI,CADY,iBAAiB,GACrB,CACV,QAAO;AAIT,QAAM,GADW,oBAAoB,GACpB,EAAE;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC,CAAC,YAAY,KAAA,EAAU;AAC3E,SAAO;;CAGT,MAAM,UAAU,QAAwB,EAAE,EAMvC;AACD,uBAAqB;AACrB,SAAO,gBAAgB,MAAM;;CAG/B,MAAM,eACJ,QACA,UACA,QACiD;EACjD,MAAM,WAAW,oBAAoB,OAAO;AAC5C,QAAM,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC;EAC1C,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,SAAS,QAAQ,oBAAoB,IAAI;AAEzF,QAAM,UADW,KAAK,UAAU,SACR,EAAE,OAAO;AACjC,SAAO;GAAE,cAAc;GAAU,MAAM,OAAO;GAAQ;;CAGxD,sBAAsB,QAAgB,cAA8B;AAClE,SAAO,KAAK,oBAAoB,OAAO,EAAE,aAAa;;CAGxD,MAAM,qBAAqB,QAAgB,cAAqC;AAE9E,QAAM,GADW,KAAK,sBAAsB,QAAQ,aACnC,EAAE,EAAE,OAAO,MAAM,CAAC,CAAC,OAAO,QAAQ;AACjD,OAAI,KAAK;IAAE;IAAK;IAAQ;IAAc,EAAE,wCAAwC;IAChF;;CAGJ,MAAM,aAAa,MAAY,SAAyC;EACtE,MAAM,aAAa,sBAAsB,KAAK,GAAG;AACjD,QAAM,MAAM,YAAY,EAAE,WAAW,MAAM,CAAC;EAC5C,MAAM,WAAyB;GAC7B,QAAQ,KAAK;GACb,WAAW,KAAK,KAAK;GACrB;GACA,OAAO,KAAK;GACZ,UAAU,KAAK;GACf,MAAM,KAAK;GACX,MAAM,KAAK;GACX,QAAQ,KAAK;GACd;AAED,QAAM,gBADW,KAAK,YAAY,GAAG,SAAS,UAAU,OAC1B,EAAE,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;AAClE,MAAI,MAAM;GAAE,QAAQ,KAAK;GAAI;GAAS,WAAW,SAAS;GAAW,EAAE,iBAAiB;;CAG1F,MAAM,cAAc,QAA8C;EAChE,MAAM,aAAa,sBAAsB,OAAO;EAChD,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,QAAQ,WAAW;UAC3B;AACN,UAAO,EAAE;;EAEX,MAAM,UAA+B,EAAE;AACvC,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,CAAC,KAAK,SAAS,QAAQ,CAAE;GAC7B,MAAM,YAAY,SAAS,KAAK,MAAM,GAAG,GAAgB,EAAE,GAAG;AAC9D,OAAI,CAAC,OAAO,SAAS,UAAU,CAAE;AACjC,OAAI;IACF,MAAM,UAAU,MAAM,SAAS,KAAK,YAAY,KAAK,EAAE,QAAQ;IAC/D,MAAM,WAAW,KAAK,MAAM,QAAQ;IACpC,MAAM,UAAU,SAAS,YAAY;AACrC,YAAQ,KAAK;KACX,WAAW,SAAS;KACpB,SAAS,SAAS;KAClB,SAAS,QAAQ,MAAM,GAAG,GAAG,IAAI,KAAA;KAClC,CAAC;WACI;AACN,QAAI,MAAM;KAAE;KAAQ;KAAM,EAAE,8BAA8B;;;AAG9D,UAAQ,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,UAAU;AACjD,SAAO;;CAGT,MAAM,YAAY,QAAgB,WAAiD;EACjF,MAAM,WAAW,KAAK,sBAAsB,OAAO,EAAE,GAAG,UAAU,OAAO;AACzE,MAAI;GACF,MAAM,UAAU,MAAM,SAAS,UAAU,QAAQ;AACjD,UAAO,KAAK,MAAM,QAAQ;UACpB;AACN,UAAO;;;CAIX,MAAM,eAAe,QAAgB,UAAiC;EACpE,MAAM,aAAa,sBAAsB,OAAO;EAChD,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,QAAQ,WAAW;UAC3B;AACN;;EAEF,MAAM,YAAY,MAAM,QAAQ,MAAM,EAAE,SAAS,QAAQ,CAAC,CAAC,MAAM;AACjE,MAAI,UAAU,UAAU,SAAU;EAClC,MAAM,WAAW,UAAU,MAAM,GAAG,UAAU,SAAS,SAAS;AAChE,OAAK,MAAM,QAAQ,SACjB,OAAM,GAAG,KAAK,YAAY,KAAK,EAAE,EAAE,OAAO,MAAM,CAAC,CAAC,YAAY,KAAA,EAAU;AAE1E,MAAI,MAAM;GAAE;GAAQ,SAAS,SAAS;GAAQ,EAAE,uBAAuB;;CAGzE,MAAM,mBAAmB,QAA+B;AAEtD,QAAM,GADa,sBAAsB,OACtB,EAAE;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC,CAAC,YAAY,KAAA,EAAU;;;CAI/E,MAAM,QAAuB"}
+{"version":3,"file":"store.js","names":[],"sources":["../../../src/notes/store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile, 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 {\n  deleteNoteAgentContextRecord,\n  deleteNoteRecord,\n  getNoteRecord,\n  listNoteRecords,\n  requireXopcDatabase,\n  upsertNoteRecord,\n} from '../storage/sqlite/index.js';\nimport { buildNoteIndexMeta } from './note-index-meta.js';\nimport { resolveNoteMediaDir, resolveNoteHistoryDir } from './paths.js';\nimport type {\n  Note,\n  NoteIndexEntry,\n  NoteSnapshot,\n  NoteSnapshotEntry,\n  NotesListQuery,\n  SnapshotTrigger,\n} from './types.js';\n\nconst log = createLogger('NotesStore');\n\nexport class NotesStore {\n  private initialized = false;\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n    requireXopcDatabase();\n    this.initialized = true;\n    log.debug('NotesStore initialized');\n  }\n\n  async addNote(note: Note): Promise<void> {\n    requireXopcDatabase();\n    upsertNoteRecord(note);\n  }\n\n  async getNote(id: string): Promise<Note | null> {\n    requireXopcDatabase();\n    return getNoteRecord(id);\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    requireXopcDatabase();\n    upsertNoteRecord(updated);\n    return updated;\n  }\n\n  async deleteNote(id: string): Promise<boolean> {\n    requireXopcDatabase();\n    const deleted = deleteNoteRecord(id);\n    if (!deleted) {\n      return false;\n    }\n\n    deleteNoteAgentContextRecord(id);\n    const mediaDir = resolveNoteMediaDir(id);\n    await rm(mediaDir, { recursive: true, force: true }).catch(() => undefined);\n    return true;\n  }\n\n  async listNotes(query: NotesListQuery = {}): Promise<{\n    items: NoteIndexEntry[];\n    total: number;\n    limit: number;\n    offset: number;\n    hasMore: boolean;\n  }> {\n    requireXopcDatabase();\n    return listNoteRecords(query);\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      markdown: note.markdown,\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.markdown ?? '';\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.filter((f) => f.endsWith('.json')).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  /** No-op: SQLite writes are synchronous. Kept for API compatibility with tests. */\n  async flush(): Promise<void> {}\n}\n\nexport { buildNoteIndexMeta };\n"],"mappings":"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"}

package/dist/src/share/share-thumbnail.js

@@ -2,9 +2,9 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { resolveStateDir } from "../config/paths-state.js";
 import { init_paths } from "../config/paths.js";
-import { loadPlaywrightCoreModule } from "../browser/providers/playwright-doctor.js";
 import { getShareStore } from "./share-store.js";
 import { getSiteShareStore } from "./site-share-store.js";
+import { loadPlaywrightCoreModule } from "../browser/providers/playwright-doctor.js";
 import { mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 //#region src/share/share-thumbnail.ts

package/dist/src/storage/sqlite/index.d.ts

@@ -11,5 +11,6 @@ export { deleteSessionRecord, ensureSessionRecord, getCurrentTranscriptId, getGl
 export { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckpointDetail, listCompactionCheckpoints, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreCompactionCheckpoint, } from './transcript-repository.js';
 export { appendCronRun, deleteCronRunsForJob, readAllCronRuns, readCronJobHistory, } from './cron-run-repository.js';
 export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } from './notes-repository.js';
+export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';
 export { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex, type MemorySearchHit, } from './memory-index-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';

package/dist/src/storage/sqlite/index.js

@@ -12,6 +12,7 @@ import { deleteSessionRecord, ensureSessionRecord, findSessionKeyByTranscriptId,
 import { appendTranscriptEntry, captureCompactionCheckpoint, getCompactionCheckpointDetail, listCompactionCheckpoints, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreCompactionCheckpoint } from "./transcript-repository.js";
 import { appendCronRun, deleteCronRunsForJob, readAllCronRuns, readCronJobHistory } from "./cron-run-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
+import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
 import { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex } from "./memory-index-repository.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCronRun, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, deleteCronRunsForJob, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, extractRoutingFromSessionKey, findSessionKeyByTranscriptId, getCompactionCheckpointDetail, getCurrentTranscriptId, getGlobalSessionStats, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listCompactionCheckpoints, listNoteRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, parseSessionKeySource, patchSessionMetadata, readAllCronRuns, readCronJobHistory, readSchemaVersion, readSchemaVersionForTest, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveAgentIdFromSessionKey, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, sessionConfigRowToConfig, sessionRowToMetadata, setSessionConfig, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertNoteRecord };
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendCronRun, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, deleteCronRunsForJob, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, extractRoutingFromSessionKey, findSessionKeyByTranscriptId, getCompactionCheckpointDetail, getCurrentTranscriptId, getGlobalSessionStats, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listCompactionCheckpoints, listNoteRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, parseSessionKeySource, patchSessionMetadata, readAllCronRuns, readCronJobHistory, readSchemaVersion, readSchemaVersionForTest, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveAgentIdFromSessionKey, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, sessionConfigRowToConfig, sessionRowToMetadata, setSessionConfig, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/migrations/005_add_note_agent_contexts.sql

@@ -0,0 +1,10 @@
+CREATE TABLE IF NOT EXISTS note_agent_contexts (
+  note_id TEXT PRIMARY KEY,
+  note_updated_at INTEGER NOT NULL,
+  context_version TEXT NOT NULL,
+  generated_at INTEGER NOT NULL,
+  payload_json TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_note_agent_contexts_generated
+  ON note_agent_contexts(generated_at DESC);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 4;
+export declare const XOPC_DB_SCHEMA_VERSION = 5;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 4;
+const XOPC_DB_SCHEMA_VERSION = 5;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 4;
+	const targetVersion = options.targetVersion ?? 5;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 4;
+	const appVersion = options.targetVersion ?? 5;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 4;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 5;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 3;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 4;
+export const XOPC_DB_SCHEMA_VERSION = 5;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/note-agent-context-repository.d.ts

@@ -0,0 +1,10 @@
+export interface NoteAgentContextRecord<T = unknown> {
+    noteId: string;
+    noteUpdatedAt: number;
+    contextVersion: string;
+    generatedAt: number;
+    payload: T;
+}
+export declare function getNoteAgentContextRecord<T = unknown>(noteId: string): NoteAgentContextRecord<T> | null;
+export declare function upsertNoteAgentContextRecord(record: NoteAgentContextRecord): void;
+export declare function deleteNoteAgentContextRecord(noteId: string): void;

package/dist/src/storage/sqlite/note-agent-context-repository.js

@@ -0,0 +1,35 @@
+import { requireXopcDatabase } from "./connection.js";
+//#region src/storage/sqlite/note-agent-context-repository.ts
+function getNoteAgentContextRecord(noteId) {
+	const row = requireXopcDatabase().db.prepare(`
+    SELECT note_id, note_updated_at, context_version, generated_at, payload_json
+    FROM note_agent_contexts
+    WHERE note_id = ?
+  `).get(noteId);
+	if (!row) return null;
+	return {
+		noteId: row.note_id,
+		noteUpdatedAt: row.note_updated_at,
+		contextVersion: row.context_version,
+		generatedAt: row.generated_at,
+		payload: JSON.parse(row.payload_json)
+	};
+}
+function upsertNoteAgentContextRecord(record) {
+	requireXopcDatabase().db.prepare(`
+    INSERT INTO note_agent_contexts (note_id, note_updated_at, context_version, generated_at, payload_json)
+    VALUES (?, ?, ?, ?, ?)
+    ON CONFLICT(note_id) DO UPDATE SET
+      note_updated_at = excluded.note_updated_at,
+      context_version = excluded.context_version,
+      generated_at = excluded.generated_at,
+      payload_json = excluded.payload_json
+  `).run(record.noteId, record.noteUpdatedAt, record.contextVersion, record.generatedAt, JSON.stringify(record.payload));
+}
+function deleteNoteAgentContextRecord(noteId) {
+	requireXopcDatabase().db.prepare(`DELETE FROM note_agent_contexts WHERE note_id = ?`).run(noteId);
+}
+//#endregion
+export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord };
+
+//# sourceMappingURL=note-agent-context-repository.js.map

package/dist/src/storage/sqlite/note-agent-context-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-agent-context-repository.js","names":[],"sources":["../../../../src/storage/sqlite/note-agent-context-repository.ts"],"sourcesContent":["import { requireXopcDatabase } from './connection.js';\n\nexport interface NoteAgentContextRecord<T = unknown> {\n  noteId: string;\n  noteUpdatedAt: number;\n  contextVersion: string;\n  generatedAt: number;\n  payload: T;\n}\n\nexport function getNoteAgentContextRecord<T = unknown>(noteId: string): NoteAgentContextRecord<T> | null {\n  const db = requireXopcDatabase().db;\n  const row = db.prepare(`\n    SELECT note_id, note_updated_at, context_version, generated_at, payload_json\n    FROM note_agent_contexts\n    WHERE note_id = ?\n  `).get(noteId) as { note_id: string; note_updated_at: number; context_version: string; generated_at: number; payload_json: string } | undefined;\n  if (!row) return null;\n  return {\n    noteId: row.note_id,\n    noteUpdatedAt: row.note_updated_at,\n    contextVersion: row.context_version,\n    generatedAt: row.generated_at,\n    payload: JSON.parse(row.payload_json) as T,\n  };\n}\n\nexport function upsertNoteAgentContextRecord(record: NoteAgentContextRecord): void {\n  const db = requireXopcDatabase().db;\n  db.prepare(`\n    INSERT INTO note_agent_contexts (note_id, note_updated_at, context_version, generated_at, payload_json)\n    VALUES (?, ?, ?, ?, ?)\n    ON CONFLICT(note_id) DO UPDATE SET\n      note_updated_at = excluded.note_updated_at,\n      context_version = excluded.context_version,\n      generated_at = excluded.generated_at,\n      payload_json = excluded.payload_json\n  `).run(\n    record.noteId,\n    record.noteUpdatedAt,\n    record.contextVersion,\n    record.generatedAt,\n    JSON.stringify(record.payload),\n  );\n}\n\nexport function deleteNoteAgentContextRecord(noteId: string): void {\n  const db = requireXopcDatabase().db;\n  db.prepare(`DELETE FROM note_agent_contexts WHERE note_id = ?`).run(noteId);\n}\n"],"mappings":";;AAUA,SAAgB,0BAAuC,QAAkD;CAEvG,MAAM,MADK,qBAAqB,CAAC,GAClB,QAAQ;;;;IAIrB,CAAC,IAAI,OAAO;AACd,KAAI,CAAC,IAAK,QAAO;AACjB,QAAO;EACL,QAAQ,IAAI;EACZ,eAAe,IAAI;EACnB,gBAAgB,IAAI;EACpB,aAAa,IAAI;EACjB,SAAS,KAAK,MAAM,IAAI,aAAa;EACtC;;AAGH,SAAgB,6BAA6B,QAAsC;AACtE,sBAAqB,CAAC,GAC9B,QAAQ;;;;;;;;IAQT,CAAC,IACD,OAAO,QACP,OAAO,eACP,OAAO,gBACP,OAAO,aACP,KAAK,UAAU,OAAO,QAAQ,CAC/B;;AAGH,SAAgB,6BAA6B,QAAsB;AACtD,sBAAqB,CAAC,GAC9B,QAAQ,oDAAoD,CAAC,IAAI,OAAO"}

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 3;
 	}
-	applyPendingMigrations(db, { targetVersion: 4 });
+	applyPendingMigrations(db, { targetVersion: 5 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.104",
+  "version": "0.0.105",
   "description": "Goal Loop OS for long-term AI work: a local-first multi-surface agent system with workflow automation, multi-agent routing, and extensibility via extensions/skills.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -118,7 +118,7 @@
     "@vitejs/plugin-react-swc": "^4.3.1",
     "cross-env": "^10.1.0",
     "dependency-cruiser": "^17.4.3",
-    "electron": "^41.7.1",
+    "electron": "^42.4.1",
     "electron-builder": "^26.12.1",
     "electron-vite": "^6.0.0-beta.1",
     "esbuild": "^0.28.1",
@@ -182,7 +182,7 @@
     "electron:server:build": "node scripts/build-electron-server.mjs",
     "electron:frpc:download": "node --import tsx/esm scripts/download-frpc-binaries.mjs",
     "electron:frpc:download:all": "node --import tsx/esm scripts/download-frpc-binaries.mjs --all",
-    "electron:build": "pnpm run electron:vite:build:package && pnpm run electron:server:build && pnpm run electron:package",
+    "electron:build": "pnpm run build:web && pnpm run electron:vite:build:package && pnpm run electron:server:build && pnpm run electron:package",
     "electron:preview": "cross-env ELECTRON_ENTRY=out/main/index.js electron-vite preview"
   }
 }