@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/storage/sqlite/memory-records-repository.js

@@ -0,0 +1,309 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { escapeFts5Query } from "./fts.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/memory-records-repository.ts
+function parseStringArray(json) {
+	try {
+		const parsed = JSON.parse(json);
+		return Array.isArray(parsed) ? parsed.filter((v) => typeof v === "string") : [];
+	} catch {
+		return [];
+	}
+}
+function parseSource(json) {
+	try {
+		const parsed = JSON.parse(json);
+		return parsed && typeof parsed === "object" ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function rowToRecord(row) {
+	return {
+		id: row.record_id,
+		kind: row.kind,
+		scope: {
+			agentId: row.agent_id,
+			...row.workspace_id ? { workspaceId: row.workspace_id } : {},
+			...row.session_key ? { sessionKey: row.session_key } : {}
+		},
+		content: row.content,
+		source: parseSource(row.source_json),
+		...row.confidence != null ? { confidence: row.confidence } : {},
+		createdAt: new Date(row.created_at).toISOString(),
+		updatedAt: new Date(row.updated_at).toISOString(),
+		tags: parseStringArray(row.tags_json)
+	};
+}
+function bm25ToScore(rank) {
+	return Math.max(0, Math.min(1, 1 / (1 + Math.max(0, rank))));
+}
+function upsertMemoryRecordFts(db, row) {
+	db.prepare(`DELETE FROM memory_records_fts WHERE record_id = ?`).run(row.id);
+	if (!row.content.trim()) return;
+	db.prepare(`INSERT INTO memory_records_fts (
+      content, record_id, provider_id, kind, agent_id, workspace_id
+    ) VALUES (?, ?, ?, ?, ?, ?)`).run(row.content, row.id, row.providerId, row.kind, row.agentId, row.workspaceId ?? null);
+}
+function upsertMemoryRecord(input) {
+	const id = input.id ?? randomUUID();
+	const now = input.nowMs ?? Date.now();
+	const source = {
+		...input.source ?? {},
+		provider: input.source?.provider ?? input.providerId
+	};
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO memory_records (
+        record_id, provider_id, kind, agent_id, workspace_id, session_key,
+        content, source_json, confidence, tags_json, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(record_id) DO UPDATE SET
+        provider_id = excluded.provider_id,
+        kind = excluded.kind,
+        agent_id = excluded.agent_id,
+        workspace_id = excluded.workspace_id,
+        session_key = excluded.session_key,
+        content = excluded.content,
+        source_json = excluded.source_json,
+        confidence = excluded.confidence,
+        tags_json = excluded.tags_json,
+        updated_at = excluded.updated_at`).run(id, input.providerId, input.kind, input.agentId, input.workspaceId ?? null, input.sessionKey ?? null, input.content, JSON.stringify(source), input.confidence ?? null, JSON.stringify(input.tags ?? []), now, now);
+		upsertMemoryRecordFts(db, {
+			...input,
+			id
+		});
+	});
+	return {
+		id,
+		kind: input.kind,
+		scope: {
+			agentId: input.agentId,
+			...input.workspaceId ? { workspaceId: input.workspaceId } : {},
+			...input.sessionKey ? { sessionKey: input.sessionKey } : {}
+		},
+		content: input.content,
+		source,
+		...input.confidence != null ? { confidence: input.confidence } : {},
+		createdAt: new Date(now).toISOString(),
+		updatedAt: new Date(now).toISOString(),
+		tags: input.tags ?? []
+	};
+}
+function getMemoryRecord(recordId) {
+	const row = getSqliteDatabase().prepare(`SELECT * FROM memory_records WHERE record_id = ?`).get(recordId);
+	return row ? rowToRecord(row) : null;
+}
+function listMemoryRecords(options = {}) {
+	const where = [];
+	const params = [];
+	if (options.providerId) {
+		where.push("provider_id = ?");
+		params.push(options.providerId);
+	}
+	if (options.agentId) {
+		where.push("agent_id = ?");
+		params.push(options.agentId);
+	}
+	if (options.workspaceId) {
+		where.push("workspace_id = ?");
+		params.push(options.workspaceId);
+	}
+	if (options.kind) {
+		where.push("kind = ?");
+		params.push(options.kind);
+	}
+	const limit = Math.max(1, Math.min(500, options.limit ?? 100));
+	const offset = Math.max(0, options.offset ?? 0);
+	return getSqliteDatabase().prepare(`SELECT * FROM memory_records
+       ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+       ORDER BY updated_at DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map(rowToRecord);
+}
+function searchMemoryRecords(options) {
+	const query = escapeFts5Query(options.query);
+	if (!query) return [];
+	const filters = ["memory_records_fts MATCH ?"];
+	const params = [query];
+	if (options.agentId) {
+		filters.push("f.agent_id = ?");
+		params.push(options.agentId);
+	}
+	if (options.workspaceId) {
+		filters.push("f.workspace_id = ?");
+		params.push(options.workspaceId);
+	}
+	if (options.providerId) {
+		filters.push("f.provider_id = ?");
+		params.push(options.providerId);
+	}
+	if (options.kinds && options.kinds.length > 0) {
+		filters.push(`f.kind IN (${options.kinds.map(() => "?").join(", ")})`);
+		params.push(...options.kinds);
+	}
+	const maxResults = Math.max(1, Math.min(50, options.maxResults ?? 5));
+	const minScore = options.minScore ?? 0;
+	return getSqliteDatabase().prepare(`SELECT
+        r.*,
+        bm25(memory_records_fts) AS rank
+       FROM memory_records_fts f
+       JOIN memory_records r ON r.record_id = f.record_id
+       WHERE ${filters.join(" AND ")}
+       ORDER BY rank
+       LIMIT ?`).all(...params, maxResults * 3).map((row) => {
+		const record = rowToRecord(row);
+		return {
+			record,
+			score: bm25ToScore(row.rank),
+			snippet: record.content,
+			citation: {
+				providerId: row.provider_id,
+				recordId: row.record_id,
+				path: record.source.path,
+				lineStart: record.source.lineStart,
+				lineEnd: record.source.lineEnd,
+				createdAt: record.createdAt
+			}
+		};
+	}).filter((result) => result.score >= minScore).slice(0, maxResults);
+}
+function deleteMemoryRecord(recordId) {
+	return runSqliteWriteTransaction((db) => {
+		db.prepare(`DELETE FROM memory_records_fts WHERE record_id = ?`).run(recordId);
+		return db.prepare(`DELETE FROM memory_records WHERE record_id = ?`).run(recordId).changes > 0;
+	});
+}
+function appendMemorySignal(input) {
+	const id = randomUUID();
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO memory_signals (
+        signal_id, source, record_id, provider_id, agent_id, workspace_id,
+        session_key, score, content, metadata_json, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.signal.source, input.signal.recordId ?? null, input.providerId ?? null, input.agentId ?? null, input.workspaceId ?? null, input.sessionKey ?? null, input.signal.score ?? null, input.signal.content ?? null, JSON.stringify(input.signal.metadata ?? {}), now);
+		if (input.signal.recordId) db.prepare(`UPDATE memory_records
+         SET recall_count = recall_count + 1, last_recalled_at = ?, updated_at = MAX(updated_at, ?)
+         WHERE record_id = ?`).run(now, now, input.signal.recordId);
+	});
+	return id;
+}
+function listMemorySignals(options = {}) {
+	const where = [];
+	const params = [];
+	if (options.recordId) {
+		where.push("record_id = ?");
+		params.push(options.recordId);
+	}
+	if (options.providerId) {
+		where.push("provider_id = ?");
+		params.push(options.providerId);
+	}
+	if (options.agentId) {
+		where.push("agent_id = ?");
+		params.push(options.agentId);
+	}
+	if (options.workspaceId) {
+		where.push("workspace_id = ?");
+		params.push(options.workspaceId);
+	}
+	const limit = Math.max(1, Math.min(500, options.limit ?? 100));
+	return getSqliteDatabase().prepare(`SELECT * FROM memory_signals
+       ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+       ORDER BY created_at DESC
+       LIMIT ?`).all(...params, limit).map((row) => {
+		let metadata = {};
+		try {
+			const parsed = JSON.parse(row.metadata_json);
+			if (parsed && typeof parsed === "object") metadata = parsed;
+		} catch {
+			metadata = {};
+		}
+		return {
+			signalId: row.signal_id,
+			source: row.source,
+			...row.record_id ? { recordId: row.record_id } : {},
+			...row.provider_id ? { providerId: row.provider_id } : {},
+			...row.agent_id ? { agentId: row.agent_id } : {},
+			...row.workspace_id ? { workspaceId: row.workspace_id } : {},
+			...row.session_key ? { sessionKey: row.session_key } : {},
+			...row.score != null ? { score: row.score } : {},
+			...row.content ? { content: row.content } : {},
+			metadata,
+			createdAt: new Date(row.created_at).toISOString()
+		};
+	});
+}
+function getMemoryProviderState(providerId, scopeKey) {
+	const row = getSqliteDatabase().prepare(`SELECT state_json FROM memory_provider_state WHERE provider_id = ? AND scope_key = ?`).get(providerId, scopeKey);
+	if (!row) return null;
+	try {
+		return JSON.parse(row.state_json);
+	} catch {
+		return null;
+	}
+}
+function setMemoryProviderState(providerId, scopeKey, state) {
+	const now = Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO memory_provider_state (provider_id, scope_key, state_json, updated_at)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(provider_id, scope_key) DO UPDATE SET
+         state_json = excluded.state_json,
+         updated_at = excluded.updated_at`).run(providerId, scopeKey, JSON.stringify(state ?? null), now);
+	});
+}
+function appendMemoryTraceEvent(input) {
+	const id = randomUUID();
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO memory_trace_events (
+        trace_id, session_key, turn_id, phase, provider_id, request_json,
+        result_count, selected_record_ids_json, skipped_reason, error, duration_ms, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.sessionKey ?? null, input.turnId ?? null, input.phase, input.providerId, JSON.stringify(input.request ?? {}), input.resultCount ?? null, JSON.stringify(input.selectedRecordIds ?? []), input.skippedReason ?? null, input.error ?? null, Math.max(0, Math.floor(input.durationMs ?? 0)), now);
+	});
+	return id;
+}
+function listMemoryTraceEvents(options = {}) {
+	const where = [];
+	const params = [];
+	if (options.providerId) {
+		where.push("provider_id = ?");
+		params.push(options.providerId);
+	}
+	if (options.sessionKey) {
+		where.push("session_key = ?");
+		params.push(options.sessionKey);
+	}
+	if (options.phase) {
+		where.push("phase = ?");
+		params.push(options.phase);
+	}
+	const limit = Math.max(1, Math.min(500, options.limit ?? 100));
+	return getSqliteDatabase().prepare(`SELECT * FROM memory_trace_events
+       ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+       ORDER BY created_at DESC
+       LIMIT ?`).all(...params, limit).map((row) => ({
+		traceId: row.trace_id,
+		...row.session_key ? { sessionKey: row.session_key } : {},
+		...row.turn_id ? { turnId: row.turn_id } : {},
+		phase: row.phase,
+		providerId: row.provider_id,
+		request: parseJsonValue(row.request_json, {}),
+		...row.result_count != null ? { resultCount: row.result_count } : {},
+		selectedRecordIds: parseStringArray(row.selected_record_ids_json),
+		...row.skipped_reason ? { skippedReason: row.skipped_reason } : {},
+		...row.error ? { error: row.error } : {},
+		durationMs: row.duration_ms,
+		createdAt: new Date(row.created_at).toISOString()
+	}));
+}
+function parseJsonValue(json, fallback) {
+	try {
+		return JSON.parse(json);
+	} catch {
+		return fallback;
+	}
+}
+//#endregion
+export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setMemoryProviderState, upsertMemoryRecord };
+
+//# sourceMappingURL=memory-records-repository.js.map

package/dist/src/storage/sqlite/memory-records-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-records-repository.js","names":[],"sources":["../../../../src/storage/sqlite/memory-records-repository.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type {\n  MemoryKind,\n  MemoryRecord,\n  MemorySearchResult,\n  MemorySignal,\n} from '../../agent/memory/types.js';\nimport { escapeFts5Query } from './fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\ntype MemoryRecordRow = {\n  record_id: string;\n  provider_id: string;\n  kind: string;\n  agent_id: string;\n  workspace_id: string | null;\n  session_key: string | null;\n  content: string;\n  source_json: string;\n  confidence: number | null;\n  tags_json: string;\n  created_at: number;\n  updated_at: number;\n};\n\ntype MemoryRecordSearchRow = MemoryRecordRow & {\n  rank: number;\n};\n\nexport interface UpsertMemoryRecordInput {\n  id?: string;\n  providerId: string;\n  kind: MemoryKind;\n  agentId: string;\n  workspaceId?: string;\n  sessionKey?: string;\n  content: string;\n  source?: MemoryRecord['source'];\n  confidence?: number;\n  tags?: string[];\n  nowMs?: number;\n}\n\nexport interface ListMemoryRecordsOptions {\n  providerId?: string;\n  agentId?: string;\n  workspaceId?: string;\n  kind?: MemoryKind;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface SearchMemoryRecordsOptions {\n  query: string;\n  agentId?: string;\n  workspaceId?: string;\n  providerId?: string;\n  kinds?: MemoryKind[];\n  maxResults?: number;\n  minScore?: number;\n}\n\nexport interface AppendMemorySignalInput {\n  signal: MemorySignal;\n  providerId?: string;\n  agentId?: string;\n  workspaceId?: string;\n  sessionKey?: string;\n  nowMs?: number;\n}\n\nexport interface MemorySignalRowPayload {\n  signalId: string;\n  source: string;\n  recordId?: string;\n  providerId?: string;\n  agentId?: string;\n  workspaceId?: string;\n  sessionKey?: string;\n  score?: number;\n  content?: string;\n  metadata: Record<string, unknown>;\n  createdAt: string;\n}\n\ntype MemorySignalRow = {\n  signal_id: string;\n  source: string;\n  record_id: string | null;\n  provider_id: string | null;\n  agent_id: string | null;\n  workspace_id: string | null;\n  session_key: string | null;\n  score: number | null;\n  content: string | null;\n  metadata_json: string;\n  created_at: number;\n};\n\ntype MemoryTraceRow = {\n  trace_id: string;\n  session_key: string | null;\n  turn_id: string | null;\n  phase: string;\n  provider_id: string;\n  request_json: string;\n  result_count: number | null;\n  selected_record_ids_json: string;\n  skipped_reason: string | null;\n  error: string | null;\n  duration_ms: number;\n  created_at: number;\n};\n\nexport interface AppendMemoryTraceEventInput {\n  sessionKey?: string;\n  turnId?: string;\n  phase: 'search' | 'read' | 'write' | 'update' | 'delete' | 'sync' | 'inject' | 'test';\n  providerId: string;\n  request?: unknown;\n  resultCount?: number;\n  selectedRecordIds?: string[];\n  skippedReason?: string;\n  error?: string;\n  durationMs?: number;\n  nowMs?: number;\n}\n\nexport interface MemoryTraceEventPayload {\n  traceId: string;\n  sessionKey?: string;\n  turnId?: string;\n  phase: string;\n  providerId: string;\n  request: unknown;\n  resultCount?: number;\n  selectedRecordIds: string[];\n  skippedReason?: string;\n  error?: string;\n  durationMs: number;\n  createdAt: string;\n}\n\nfunction parseStringArray(json: string): string[] {\n  try {\n    const parsed = JSON.parse(json) as unknown;\n    return Array.isArray(parsed) ? parsed.filter((v): v is string => typeof v === 'string') : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction parseSource(json: string): MemoryRecord['source'] {\n  try {\n    const parsed = JSON.parse(json) as unknown;\n    return parsed && typeof parsed === 'object' ? (parsed as MemoryRecord['source']) : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction rowToRecord(row: MemoryRecordRow): MemoryRecord {\n  return {\n    id: row.record_id,\n    kind: row.kind as MemoryKind,\n    scope: {\n      agentId: row.agent_id,\n      ...(row.workspace_id ? { workspaceId: row.workspace_id } : {}),\n      ...(row.session_key ? { sessionKey: row.session_key } : {}),\n    },\n    content: row.content,\n    source: parseSource(row.source_json),\n    ...(row.confidence != null ? { confidence: row.confidence } : {}),\n    createdAt: new Date(row.created_at).toISOString(),\n    updatedAt: new Date(row.updated_at).toISOString(),\n    tags: parseStringArray(row.tags_json),\n  };\n}\n\nfunction bm25ToScore(rank: number): number {\n  return Math.max(0, Math.min(1, 1 / (1 + Math.max(0, rank))));\n}\n\nfunction upsertMemoryRecordFts(\n  db: ReturnType<typeof getSqliteDatabase>,\n  row: Pick<UpsertMemoryRecordInput, 'providerId' | 'kind' | 'agentId' | 'workspaceId' | 'content'> & { id: string },\n): void {\n  db.prepare(`DELETE FROM memory_records_fts WHERE record_id = ?`).run(row.id);\n  if (!row.content.trim()) return;\n  db.prepare(\n    `INSERT INTO memory_records_fts (\n      content, record_id, provider_id, kind, agent_id, workspace_id\n    ) VALUES (?, ?, ?, ?, ?, ?)`,\n  ).run(row.content, row.id, row.providerId, row.kind, row.agentId, row.workspaceId ?? null);\n}\n\nexport function upsertMemoryRecord(input: UpsertMemoryRecordInput): MemoryRecord {\n  const id = input.id ?? randomUUID();\n  const now = input.nowMs ?? Date.now();\n  const source = {\n    ...(input.source ?? {}),\n    provider: input.source?.provider ?? input.providerId,\n  };\n\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO memory_records (\n        record_id, provider_id, kind, agent_id, workspace_id, session_key,\n        content, source_json, confidence, tags_json, created_at, updated_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n      ON CONFLICT(record_id) DO UPDATE SET\n        provider_id = excluded.provider_id,\n        kind = excluded.kind,\n        agent_id = excluded.agent_id,\n        workspace_id = excluded.workspace_id,\n        session_key = excluded.session_key,\n        content = excluded.content,\n        source_json = excluded.source_json,\n        confidence = excluded.confidence,\n        tags_json = excluded.tags_json,\n        updated_at = excluded.updated_at`,\n    ).run(\n      id,\n      input.providerId,\n      input.kind,\n      input.agentId,\n      input.workspaceId ?? null,\n      input.sessionKey ?? null,\n      input.content,\n      JSON.stringify(source),\n      input.confidence ?? null,\n      JSON.stringify(input.tags ?? []),\n      now,\n      now,\n    );\n    upsertMemoryRecordFts(db, { ...input, id });\n  });\n\n  return {\n    id,\n    kind: input.kind,\n    scope: {\n      agentId: input.agentId,\n      ...(input.workspaceId ? { workspaceId: input.workspaceId } : {}),\n      ...(input.sessionKey ? { sessionKey: input.sessionKey } : {}),\n    },\n    content: input.content,\n    source,\n    ...(input.confidence != null ? { confidence: input.confidence } : {}),\n    createdAt: new Date(now).toISOString(),\n    updatedAt: new Date(now).toISOString(),\n    tags: input.tags ?? [],\n  };\n}\n\nexport function getMemoryRecord(recordId: string): MemoryRecord | null {\n  const row = getSqliteDatabase()\n    .prepare(`SELECT * FROM memory_records WHERE record_id = ?`)\n    .get(recordId) as MemoryRecordRow | undefined;\n  return row ? rowToRecord(row) : null;\n}\n\nexport function listMemoryRecords(options: ListMemoryRecordsOptions = {}): MemoryRecord[] {\n  const where: string[] = [];\n  const params: Array<string | number | null> = [];\n  if (options.providerId) {\n    where.push('provider_id = ?');\n    params.push(options.providerId);\n  }\n  if (options.agentId) {\n    where.push('agent_id = ?');\n    params.push(options.agentId);\n  }\n  if (options.workspaceId) {\n    where.push('workspace_id = ?');\n    params.push(options.workspaceId);\n  }\n  if (options.kind) {\n    where.push('kind = ?');\n    params.push(options.kind);\n  }\n  const limit = Math.max(1, Math.min(500, options.limit ?? 100));\n  const offset = Math.max(0, options.offset ?? 0);\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT * FROM memory_records\n       ${where.length > 0 ? `WHERE ${where.join(' AND ')}` : ''}\n       ORDER BY updated_at DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset) as MemoryRecordRow[];\n  return rows.map(rowToRecord);\n}\n\nexport function searchMemoryRecords(options: SearchMemoryRecordsOptions): MemorySearchResult[] {\n  const query = escapeFts5Query(options.query);\n  if (!query) return [];\n\n  const filters: string[] = ['memory_records_fts MATCH ?'];\n  const params: Array<string | number | null> = [query];\n  if (options.agentId) {\n    filters.push('f.agent_id = ?');\n    params.push(options.agentId);\n  }\n  if (options.workspaceId) {\n    filters.push('f.workspace_id = ?');\n    params.push(options.workspaceId);\n  }\n  if (options.providerId) {\n    filters.push('f.provider_id = ?');\n    params.push(options.providerId);\n  }\n  if (options.kinds && options.kinds.length > 0) {\n    filters.push(`f.kind IN (${options.kinds.map(() => '?').join(', ')})`);\n    params.push(...options.kinds);\n  }\n\n  const maxResults = Math.max(1, Math.min(50, options.maxResults ?? 5));\n  const minScore = options.minScore ?? 0;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT\n        r.*,\n        bm25(memory_records_fts) AS rank\n       FROM memory_records_fts f\n       JOIN memory_records r ON r.record_id = f.record_id\n       WHERE ${filters.join(' AND ')}\n       ORDER BY rank\n       LIMIT ?`,\n    )\n    .all(...params, maxResults * 3) as MemoryRecordSearchRow[];\n\n  return rows\n    .map((row) => {\n      const record = rowToRecord(row);\n      const score = bm25ToScore(row.rank);\n      return {\n        record,\n        score,\n        snippet: record.content,\n        citation: {\n          providerId: row.provider_id,\n          recordId: row.record_id,\n          path: record.source.path,\n          lineStart: record.source.lineStart,\n          lineEnd: record.source.lineEnd,\n          createdAt: record.createdAt,\n        },\n      };\n    })\n    .filter((result) => result.score >= minScore)\n    .slice(0, maxResults);\n}\n\nexport function deleteMemoryRecord(recordId: string): boolean {\n  return runSqliteWriteTransaction((db) => {\n    db.prepare(`DELETE FROM memory_records_fts WHERE record_id = ?`).run(recordId);\n    const result = db.prepare(`DELETE FROM memory_records WHERE record_id = ?`).run(recordId);\n    return result.changes > 0;\n  });\n}\n\nexport function appendMemorySignal(input: AppendMemorySignalInput): string {\n  const id = randomUUID();\n  const now = input.nowMs ?? Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO memory_signals (\n        signal_id, source, record_id, provider_id, agent_id, workspace_id,\n        session_key, score, content, metadata_json, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      id,\n      input.signal.source,\n      input.signal.recordId ?? null,\n      input.providerId ?? null,\n      input.agentId ?? null,\n      input.workspaceId ?? null,\n      input.sessionKey ?? null,\n      input.signal.score ?? null,\n      input.signal.content ?? null,\n      JSON.stringify(input.signal.metadata ?? {}),\n      now,\n    );\n    if (input.signal.recordId) {\n      db.prepare(\n        `UPDATE memory_records\n         SET recall_count = recall_count + 1, last_recalled_at = ?, updated_at = MAX(updated_at, ?)\n         WHERE record_id = ?`,\n      ).run(now, now, input.signal.recordId);\n    }\n  });\n  return id;\n}\n\nexport function listMemorySignals(options: {\n  recordId?: string;\n  providerId?: string;\n  agentId?: string;\n  workspaceId?: string;\n  limit?: number;\n} = {}): MemorySignalRowPayload[] {\n  const where: string[] = [];\n  const params: Array<string | number | null> = [];\n  if (options.recordId) {\n    where.push('record_id = ?');\n    params.push(options.recordId);\n  }\n  if (options.providerId) {\n    where.push('provider_id = ?');\n    params.push(options.providerId);\n  }\n  if (options.agentId) {\n    where.push('agent_id = ?');\n    params.push(options.agentId);\n  }\n  if (options.workspaceId) {\n    where.push('workspace_id = ?');\n    params.push(options.workspaceId);\n  }\n  const limit = Math.max(1, Math.min(500, options.limit ?? 100));\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT * FROM memory_signals\n       ${where.length > 0 ? `WHERE ${where.join(' AND ')}` : ''}\n       ORDER BY created_at DESC\n       LIMIT ?`,\n    )\n    .all(...params, limit) as MemorySignalRow[];\n  return rows.map((row) => {\n    let metadata: Record<string, unknown> = {};\n    try {\n      const parsed = JSON.parse(row.metadata_json) as unknown;\n      if (parsed && typeof parsed === 'object') metadata = parsed as Record<string, unknown>;\n    } catch {\n      metadata = {};\n    }\n    return {\n      signalId: row.signal_id,\n      source: row.source,\n      ...(row.record_id ? { recordId: row.record_id } : {}),\n      ...(row.provider_id ? { providerId: row.provider_id } : {}),\n      ...(row.agent_id ? { agentId: row.agent_id } : {}),\n      ...(row.workspace_id ? { workspaceId: row.workspace_id } : {}),\n      ...(row.session_key ? { sessionKey: row.session_key } : {}),\n      ...(row.score != null ? { score: row.score } : {}),\n      ...(row.content ? { content: row.content } : {}),\n      metadata,\n      createdAt: new Date(row.created_at).toISOString(),\n    };\n  });\n}\n\nexport function getMemoryProviderState(providerId: string, scopeKey: string): unknown | null {\n  const row = getSqliteDatabase()\n    .prepare(`SELECT state_json FROM memory_provider_state WHERE provider_id = ? AND scope_key = ?`)\n    .get(providerId, scopeKey) as { state_json: string } | undefined;\n  if (!row) return null;\n  try {\n    return JSON.parse(row.state_json) as unknown;\n  } catch {\n    return null;\n  }\n}\n\nexport function setMemoryProviderState(providerId: string, scopeKey: string, state: unknown): void {\n  const now = Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO memory_provider_state (provider_id, scope_key, state_json, updated_at)\n       VALUES (?, ?, ?, ?)\n       ON CONFLICT(provider_id, scope_key) DO UPDATE SET\n         state_json = excluded.state_json,\n         updated_at = excluded.updated_at`,\n    ).run(providerId, scopeKey, JSON.stringify(state ?? null), now);\n  });\n}\n\nexport function appendMemoryTraceEvent(input: AppendMemoryTraceEventInput): string {\n  const id = randomUUID();\n  const now = input.nowMs ?? Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO memory_trace_events (\n        trace_id, session_key, turn_id, phase, provider_id, request_json,\n        result_count, selected_record_ids_json, skipped_reason, error, duration_ms, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      id,\n      input.sessionKey ?? null,\n      input.turnId ?? null,\n      input.phase,\n      input.providerId,\n      JSON.stringify(input.request ?? {}),\n      input.resultCount ?? null,\n      JSON.stringify(input.selectedRecordIds ?? []),\n      input.skippedReason ?? null,\n      input.error ?? null,\n      Math.max(0, Math.floor(input.durationMs ?? 0)),\n      now,\n    );\n  });\n  return id;\n}\n\nexport function listMemoryTraceEvents(options: {\n  providerId?: string;\n  sessionKey?: string;\n  phase?: string;\n  limit?: number;\n} = {}): MemoryTraceEventPayload[] {\n  const where: string[] = [];\n  const params: Array<string | number | null> = [];\n  if (options.providerId) {\n    where.push('provider_id = ?');\n    params.push(options.providerId);\n  }\n  if (options.sessionKey) {\n    where.push('session_key = ?');\n    params.push(options.sessionKey);\n  }\n  if (options.phase) {\n    where.push('phase = ?');\n    params.push(options.phase);\n  }\n  const limit = Math.max(1, Math.min(500, options.limit ?? 100));\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT * FROM memory_trace_events\n       ${where.length > 0 ? `WHERE ${where.join(' AND ')}` : ''}\n       ORDER BY created_at DESC\n       LIMIT ?`,\n    )\n    .all(...params, limit) as MemoryTraceRow[];\n  return rows.map((row) => ({\n    traceId: row.trace_id,\n    ...(row.session_key ? { sessionKey: row.session_key } : {}),\n    ...(row.turn_id ? { turnId: row.turn_id } : {}),\n    phase: row.phase,\n    providerId: row.provider_id,\n    request: parseJsonValue(row.request_json, {}),\n    ...(row.result_count != null ? { resultCount: row.result_count } : {}),\n    selectedRecordIds: parseStringArray(row.selected_record_ids_json),\n    ...(row.skipped_reason ? { skippedReason: row.skipped_reason } : {}),\n    ...(row.error ? { error: row.error } : {}),\n    durationMs: row.duration_ms,\n    createdAt: new Date(row.created_at).toISOString(),\n  }));\n}\n\nfunction parseJsonValue(json: string, fallback: unknown): unknown {\n  try {\n    return JSON.parse(json) as unknown;\n  } catch {\n    return fallback;\n  }\n}\n"],"mappings":"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"}

package/dist/src/storage/sqlite/migrations/011_goal_context_messages.sql

@@ -0,0 +1,8 @@
+CREATE TABLE IF NOT EXISTS goal_context_messages (
+  goal_id           TEXT PRIMARY KEY,
+  text              TEXT NOT NULL DEFAULT '',
+  attachments_json  TEXT NOT NULL DEFAULT '[]',
+  created_at        INTEGER NOT NULL,
+  updated_at        INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);

package/dist/src/storage/sqlite/migrations/012_memory_records.sql

@@ -0,0 +1,63 @@
+CREATE TABLE IF NOT EXISTS memory_records (
+  record_id       TEXT PRIMARY KEY,
+  provider_id     TEXT NOT NULL,
+  kind            TEXT NOT NULL,
+  agent_id        TEXT NOT NULL,
+  workspace_id    TEXT,
+  session_key     TEXT,
+  content         TEXT NOT NULL,
+  source_json     TEXT NOT NULL,
+  confidence      REAL,
+  tags_json       TEXT NOT NULL DEFAULT '[]',
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  last_recalled_at INTEGER,
+  recall_count    INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_records_scope_updated
+  ON memory_records(agent_id, workspace_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_kind_updated
+  ON memory_records(kind, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_provider
+  ON memory_records(provider_id, updated_at DESC);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_records_fts USING fts5(
+  content,
+  record_id UNINDEXED,
+  provider_id UNINDEXED,
+  kind UNINDEXED,
+  agent_id UNINDEXED,
+  workspace_id UNINDEXED,
+  tokenize='unicode61'
+);
+
+CREATE TABLE IF NOT EXISTS memory_signals (
+  signal_id     TEXT PRIMARY KEY,
+  source        TEXT NOT NULL,
+  record_id     TEXT,
+  provider_id   TEXT,
+  agent_id      TEXT,
+  workspace_id  TEXT,
+  session_key   TEXT,
+  score         REAL,
+  content       TEXT,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at    INTEGER NOT NULL,
+  FOREIGN KEY (record_id) REFERENCES memory_records(record_id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_signals_created
+  ON memory_signals(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_signals_record_created
+  ON memory_signals(record_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_signals_scope_created
+  ON memory_signals(agent_id, workspace_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS memory_provider_state (
+  provider_id TEXT NOT NULL,
+  scope_key   TEXT NOT NULL,
+  state_json  TEXT NOT NULL,
+  updated_at  INTEGER NOT NULL,
+  PRIMARY KEY (provider_id, scope_key)
+);

package/dist/src/storage/sqlite/migrations/013_memory_trace_events.sql

@@ -0,0 +1,21 @@
+CREATE TABLE IF NOT EXISTS memory_trace_events (
+  trace_id              TEXT PRIMARY KEY,
+  session_key           TEXT,
+  turn_id               TEXT,
+  phase                 TEXT NOT NULL,
+  provider_id           TEXT NOT NULL,
+  request_json          TEXT NOT NULL DEFAULT '{}',
+  result_count          INTEGER,
+  selected_record_ids_json TEXT NOT NULL DEFAULT '[]',
+  skipped_reason        TEXT,
+  error                 TEXT,
+  duration_ms           INTEGER NOT NULL DEFAULT 0,
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_trace_created
+  ON memory_trace_events(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_trace_provider_created
+  ON memory_trace_events(provider_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_trace_session_created
+  ON memory_trace_events(session_key, created_at DESC);

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

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

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

@@ -10,9 +10,9 @@ import { fileURLToPath } from "node:url";
 init_logger();
 const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
-const XOPC_DB_BASELINE_SCHEMA_VERSION = 10;
+const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 10;
+const XOPC_DB_SCHEMA_VERSION = 13;
 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 ?? 10;
+	const targetVersion = options.targetVersion ?? 13;
 	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 ?? 10;
+	const appVersion = options.targetVersion ?? 13;
 	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 = 10;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 10;\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 = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 13;\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

@@ -16,10 +16,10 @@ import type { ApplyMigrationsOptions, SqlMigration } from './types.js';
 const log = createLogger('Sqlite:Migrations');
 
 /** Baseline schema version applied from schema.sql on first open. */
-export const XOPC_DB_BASELINE_SCHEMA_VERSION = 10;
+export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 10;
+export const XOPC_DB_SCHEMA_VERSION = 13;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

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

@@ -12,7 +12,7 @@ function bootstrapFreshDatabase(db) {
 	db.exec("BEGIN IMMEDIATE");
 	try {
 		db.exec(readSchemaSql());
-		setSchemaVersion(db, 10);
+		setSchemaVersion(db, 11);
 		db.exec("COMMIT");
 	} catch (error) {
 		try {
@@ -29,9 +29,9 @@ function ensureXopcDatabaseSchema(db) {
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion === 0) {
 		bootstrapFreshDatabase(db);
-		currentVersion = 10;
+		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 10 });
+	applyPendingMigrations(db, { targetVersion: 13 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };