@xopcai/xopc 0.0.124 → 0.0.126

package/dist/src/storage/sqlite/activity-repository.js

@@ -0,0 +1,208 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/activity-repository.ts
+function parseJson(json, fallback) {
+	try {
+		return JSON.parse(json);
+	} catch {
+		return fallback;
+	}
+}
+function eventFromRow(row) {
+	return {
+		id: row.id,
+		type: row.type,
+		primaryObject: {
+			kind: row.primary_object_kind,
+			id: row.primary_object_id,
+			title: row.primary_object_title ?? void 0
+		},
+		actor: parseJson(row.actor_json, { kind: "system" }),
+		initiator: row.initiator_json ? parseJson(row.initiator_json, void 0) : void 0,
+		source: parseJson(row.source_json, { kind: "system" }),
+		payload: parseJson(row.payload_json, {}),
+		visibility: row.visibility,
+		importance: row.importance,
+		createdAt: row.created_at
+	};
+}
+function scopeFromRow(row) {
+	return {
+		activityId: row.activity_id,
+		scopeKind: row.scope_kind,
+		scopeId: row.scope_id,
+		reason: row.reason
+	};
+}
+function relatedProjectFromRow(row) {
+	return {
+		activityId: row.activity_id,
+		projectId: row.project_id,
+		reason: row.reason,
+		confidence: row.confidence,
+		computedAt: row.computed_at
+	};
+}
+function objectLinkFromRow(row) {
+	return {
+		id: row.id,
+		from: {
+			kind: row.from_kind,
+			id: row.from_id,
+			title: row.from_title ?? void 0
+		},
+		to: {
+			kind: row.to_kind,
+			id: row.to_id,
+			title: row.to_title ?? void 0
+		},
+		relation: row.relation,
+		source: row.source,
+		createdAt: row.created_at
+	};
+}
+function listScopesForActivity(activityId) {
+	return getSqliteDatabase().prepare(`SELECT activity_id, scope_kind, scope_id, reason
+       FROM activity_scopes
+       WHERE activity_id = ?
+       ORDER BY scope_kind ASC, scope_id ASC, reason ASC`).all(activityId).map((row) => scopeFromRow(row));
+}
+function listRelatedProjectsForActivity(activityId) {
+	return getSqliteDatabase().prepare(`SELECT activity_id, project_id, reason, confidence, computed_at
+       FROM activity_related_projects
+       WHERE activity_id = ?
+       ORDER BY project_id ASC, reason ASC`).all(activityId).map((row) => relatedProjectFromRow(row));
+}
+function eventWithRelations(row) {
+	const event = eventFromRow(row);
+	return {
+		...event,
+		scopes: listScopesForActivity(event.id),
+		relatedProjects: listRelatedProjectsForActivity(event.id)
+	};
+}
+function normalizeLimit(limit) {
+	return Math.max(1, Math.min(100, Math.floor(limit ?? 50)));
+}
+function normalizeOffset(offset) {
+	return Math.max(0, Math.floor(offset ?? 0));
+}
+function visibilityClause(visibility, params) {
+	if (!visibility) return "";
+	params.push(visibility);
+	return "WHERE visibility = ?";
+}
+function listResult(rows, total, limit, offset) {
+	return {
+		items: rows.map(eventWithRelations),
+		total,
+		limit,
+		offset,
+		hasMore: offset + rows.length < total
+	};
+}
+function recordActivityEvent(input) {
+	const id = input.id ?? randomUUID();
+	const now = input.nowMs ?? Date.now();
+	const visibility = input.visibility ?? "timeline";
+	const importance = input.importance ?? "normal";
+	const payload = input.payload ?? {};
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO activity_events (
+        id, type, primary_object_kind, primary_object_id, primary_object_title,
+        actor_json, initiator_json, source_json, payload_json,
+        visibility, importance, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.type, input.primaryObject.kind, input.primaryObject.id, input.primaryObject.title ?? null, JSON.stringify(input.actor), input.initiator ? JSON.stringify(input.initiator) : null, JSON.stringify(input.source), JSON.stringify(payload), visibility, importance, now);
+		for (const scope of input.scopes ?? []) db.prepare(`INSERT OR IGNORE INTO activity_scopes (activity_id, scope_kind, scope_id, reason)
+         VALUES (?, ?, ?, ?)`).run(id, scope.scopeKind, scope.scopeId, scope.reason);
+		for (const related of input.relatedProjects ?? []) db.prepare(`INSERT OR REPLACE INTO activity_related_projects (
+          activity_id, project_id, reason, confidence, computed_at
+        ) VALUES (?, ?, ?, ?, ?)`).run(id, related.projectId, related.reason, related.confidence, related.computedAt ?? now);
+	});
+	const event = getActivityEventRecord(id);
+	if (!event) throw new Error(`Activity event was not persisted: ${id}`);
+	return event;
+}
+function getActivityEventRecord(id) {
+	const row = getSqliteDatabase().prepare(`SELECT *
+       FROM activity_events
+       WHERE id = ?`).get(id);
+	return row ? eventWithRelations(row) : null;
+}
+function listActivityRecords(options = {}) {
+	const limit = normalizeLimit(options.limit);
+	const offset = normalizeOffset(options.offset);
+	const params = [];
+	const where = visibilityClause(options.visibility, params);
+	const total = getSqliteDatabase().prepare(`SELECT COUNT(*) AS count FROM activity_events ${where}`).get(...params).count;
+	return listResult(getSqliteDatabase().prepare(`SELECT *
+       FROM activity_events
+       ${where}
+       ORDER BY created_at DESC, id DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => row), total, limit, offset);
+}
+function listObjectActivityRecords(options) {
+	const limit = normalizeLimit(options.limit);
+	const offset = normalizeOffset(options.offset);
+	const params = [options.object.kind, options.object.id];
+	const visibility = options.visibility ? "AND visibility = ?" : "";
+	if (options.visibility) params.push(options.visibility);
+	const total = getSqliteDatabase().prepare(`SELECT COUNT(*) AS count
+       FROM activity_events
+       WHERE primary_object_kind = ? AND primary_object_id = ?
+       ${visibility}`).get(...params).count;
+	return listResult(getSqliteDatabase().prepare(`SELECT *
+       FROM activity_events
+       WHERE primary_object_kind = ? AND primary_object_id = ?
+       ${visibility}
+       ORDER BY created_at DESC, id DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => row), total, limit, offset);
+}
+function listProjectActivityRecords(options) {
+	const limit = normalizeLimit(options.limit);
+	const offset = normalizeOffset(options.offset);
+	const params = ["project", options.projectId];
+	const relatedClause = options.includeRelated ? `OR EXISTS (
+        SELECT 1 FROM activity_related_projects ar
+        WHERE ar.activity_id = ae.id AND ar.project_id = ?
+      )` : "";
+	if (options.includeRelated) params.push(options.projectId);
+	const visibilityClauseSql = options.visibility ? "AND ae.visibility = ?" : "";
+	if (options.visibility) params.push(options.visibility);
+	const baseWhere = `EXISTS (
+      SELECT 1 FROM activity_scopes s
+      WHERE s.activity_id = ae.id AND s.scope_kind = ? AND s.scope_id = ?
+    ) ${relatedClause}`;
+	const total = getSqliteDatabase().prepare(`SELECT COUNT(*) AS count
+       FROM activity_events ae
+       WHERE (${baseWhere})
+       ${visibilityClauseSql}`).get(...params).count;
+	return listResult(getSqliteDatabase().prepare(`SELECT ae.*
+       FROM activity_events ae
+       WHERE (${baseWhere})
+       ${visibilityClauseSql}
+       ORDER BY ae.created_at DESC, ae.id DESC
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => row), total, limit, offset);
+}
+function createObjectLinkRecord(input) {
+	const id = input.id ?? randomUUID();
+	const now = input.nowMs ?? Date.now();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO object_links (
+        id, from_kind, from_id, from_title, to_kind, to_id, to_title, relation, source, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.from.kind, input.from.id, input.from.title ?? null, input.to.kind, input.to.id, input.to.title ?? null, input.relation, input.source, now);
+	});
+	const row = getSqliteDatabase().prepare(`SELECT * FROM object_links WHERE id = ?`).get(id);
+	if (!row) throw new Error(`Object link was not persisted: ${id}`);
+	return objectLinkFromRow(row);
+}
+function listObjectLinkRecords(object) {
+	return getSqliteDatabase().prepare(`SELECT *
+       FROM object_links
+       WHERE (from_kind = ? AND from_id = ?) OR (to_kind = ? AND to_id = ?)
+       ORDER BY created_at DESC, id DESC`).all(object.kind, object.id, object.kind, object.id).map((row) => objectLinkFromRow(row));
+}
+//#endregion
+export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent };
+
+//# sourceMappingURL=activity-repository.js.map

package/dist/src/storage/sqlite/activity-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-repository.js","names":[],"sources":["../../../../src/storage/sqlite/activity-repository.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type {\n  ActivityEvent,\n  ActivityEventWithRelations,\n  ActivityListResult,\n  ActivityObjectRef,\n  ActivityRelatedProject,\n  ActivityScope,\n  ActivitySource,\n  ActivityPrincipal,\n  CreateObjectLinkInput,\n  ListActivityOptions,\n  ListObjectActivityOptions,\n  ListProjectActivityOptions,\n  ObjectLink,\n  RecordActivityInput,\n} from '../../activity/types.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\ntype ActivityEventRow = {\n  id: string;\n  type: string;\n  primary_object_kind: string;\n  primary_object_id: string;\n  primary_object_title: string | null;\n  actor_json: string;\n  initiator_json: string | null;\n  source_json: string;\n  payload_json: string;\n  visibility: string;\n  importance: string;\n  created_at: number;\n};\n\ntype ActivityScopeRow = {\n  activity_id: string;\n  scope_kind: string;\n  scope_id: string;\n  reason: string;\n};\n\ntype ActivityRelatedProjectRow = {\n  activity_id: string;\n  project_id: string;\n  reason: string;\n  confidence: number;\n  computed_at: number;\n};\n\ntype ObjectLinkRow = {\n  id: string;\n  from_kind: string;\n  from_id: string;\n  from_title: string | null;\n  to_kind: string;\n  to_id: string;\n  to_title: string | null;\n  relation: string;\n  source: string;\n  created_at: number;\n};\n\ntype CountRow = { count: number };\ntype SqlParam = string | number | bigint | null;\n\nfunction parseJson<T>(json: string, fallback: T): T {\n  try {\n    return JSON.parse(json) as T;\n  } catch {\n    return fallback;\n  }\n}\n\nfunction eventFromRow(row: ActivityEventRow): ActivityEvent {\n  return {\n    id: row.id,\n    type: row.type,\n    primaryObject: {\n      kind: row.primary_object_kind as ActivityObjectRef['kind'],\n      id: row.primary_object_id,\n      title: row.primary_object_title ?? undefined,\n    },\n    actor: parseJson<ActivityPrincipal>(row.actor_json, { kind: 'system' }),\n    initiator: row.initiator_json ? parseJson<ActivityPrincipal | undefined>(row.initiator_json, undefined) : undefined,\n    source: parseJson<ActivitySource>(row.source_json, { kind: 'system' }),\n    payload: parseJson<Record<string, unknown>>(row.payload_json, {}),\n    visibility: row.visibility as ActivityEvent['visibility'],\n    importance: row.importance as ActivityEvent['importance'],\n    createdAt: row.created_at,\n  };\n}\n\nfunction scopeFromRow(row: ActivityScopeRow): ActivityScope {\n  return {\n    activityId: row.activity_id,\n    scopeKind: row.scope_kind as ActivityScope['scopeKind'],\n    scopeId: row.scope_id,\n    reason: row.reason as ActivityScope['reason'],\n  };\n}\n\nfunction relatedProjectFromRow(row: ActivityRelatedProjectRow): ActivityRelatedProject {\n  return {\n    activityId: row.activity_id,\n    projectId: row.project_id,\n    reason: row.reason as ActivityRelatedProject['reason'],\n    confidence: row.confidence,\n    computedAt: row.computed_at,\n  };\n}\n\nfunction objectLinkFromRow(row: ObjectLinkRow): ObjectLink {\n  return {\n    id: row.id,\n    from: {\n      kind: row.from_kind as ActivityObjectRef['kind'],\n      id: row.from_id,\n      title: row.from_title ?? undefined,\n    },\n    to: {\n      kind: row.to_kind as ActivityObjectRef['kind'],\n      id: row.to_id,\n      title: row.to_title ?? undefined,\n    },\n    relation: row.relation as ObjectLink['relation'],\n    source: row.source as ObjectLink['source'],\n    createdAt: row.created_at,\n  };\n}\n\nfunction listScopesForActivity(activityId: string): ActivityScope[] {\n  return getSqliteDatabase()\n    .prepare(\n      `SELECT activity_id, scope_kind, scope_id, reason\n       FROM activity_scopes\n       WHERE activity_id = ?\n       ORDER BY scope_kind ASC, scope_id ASC, reason ASC`,\n    )\n    .all(activityId)\n    .map((row) => scopeFromRow(row as ActivityScopeRow));\n}\n\nfunction listRelatedProjectsForActivity(activityId: string): ActivityRelatedProject[] {\n  return getSqliteDatabase()\n    .prepare(\n      `SELECT activity_id, project_id, reason, confidence, computed_at\n       FROM activity_related_projects\n       WHERE activity_id = ?\n       ORDER BY project_id ASC, reason ASC`,\n    )\n    .all(activityId)\n    .map((row) => relatedProjectFromRow(row as ActivityRelatedProjectRow));\n}\n\nfunction eventWithRelations(row: ActivityEventRow): ActivityEventWithRelations {\n  const event = eventFromRow(row);\n  return {\n    ...event,\n    scopes: listScopesForActivity(event.id),\n    relatedProjects: listRelatedProjectsForActivity(event.id),\n  };\n}\n\nfunction normalizeLimit(limit: number | undefined): number {\n  return Math.max(1, Math.min(100, Math.floor(limit ?? 50)));\n}\n\nfunction normalizeOffset(offset: number | undefined): number {\n  return Math.max(0, Math.floor(offset ?? 0));\n}\n\nfunction visibilityClause(visibility: string | undefined, params: SqlParam[]): string {\n  if (!visibility) return '';\n  params.push(visibility);\n  return 'WHERE visibility = ?';\n}\n\nfunction listResult(rows: ActivityEventRow[], total: number, limit: number, offset: number): ActivityListResult {\n  return {\n    items: rows.map(eventWithRelations),\n    total,\n    limit,\n    offset,\n    hasMore: offset + rows.length < total,\n  };\n}\n\nexport function recordActivityEvent(input: RecordActivityInput): ActivityEventWithRelations {\n  const id = input.id ?? randomUUID();\n  const now = input.nowMs ?? Date.now();\n  const visibility = input.visibility ?? 'timeline';\n  const importance = input.importance ?? 'normal';\n  const payload = input.payload ?? {};\n\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO activity_events (\n        id, type, primary_object_kind, primary_object_id, primary_object_title,\n        actor_json, initiator_json, source_json, payload_json,\n        visibility, importance, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      id,\n      input.type,\n      input.primaryObject.kind,\n      input.primaryObject.id,\n      input.primaryObject.title ?? null,\n      JSON.stringify(input.actor),\n      input.initiator ? JSON.stringify(input.initiator) : null,\n      JSON.stringify(input.source),\n      JSON.stringify(payload),\n      visibility,\n      importance,\n      now,\n    );\n\n    for (const scope of input.scopes ?? []) {\n      db.prepare(\n        `INSERT OR IGNORE INTO activity_scopes (activity_id, scope_kind, scope_id, reason)\n         VALUES (?, ?, ?, ?)`,\n      ).run(id, scope.scopeKind, scope.scopeId, scope.reason);\n    }\n\n    for (const related of input.relatedProjects ?? []) {\n      db.prepare(\n        `INSERT OR REPLACE INTO activity_related_projects (\n          activity_id, project_id, reason, confidence, computed_at\n        ) VALUES (?, ?, ?, ?, ?)`,\n      ).run(id, related.projectId, related.reason, related.confidence, related.computedAt ?? now);\n    }\n  });\n\n  const event = getActivityEventRecord(id);\n  if (!event) {\n    throw new Error(`Activity event was not persisted: ${id}`);\n  }\n  return event;\n}\n\nexport function getActivityEventRecord(id: string): ActivityEventWithRelations | null {\n  const row = getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM activity_events\n       WHERE id = ?`,\n    )\n    .get(id) as ActivityEventRow | undefined;\n  return row ? eventWithRelations(row) : null;\n}\n\nexport function listActivityRecords(options: ListActivityOptions = {}): ActivityListResult {\n  const limit = normalizeLimit(options.limit);\n  const offset = normalizeOffset(options.offset);\n  const params: SqlParam[] = [];\n  const where = visibilityClause(options.visibility, params);\n  const total = (getSqliteDatabase()\n    .prepare(`SELECT COUNT(*) AS count FROM activity_events ${where}`)\n    .get(...params) as CountRow).count;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM activity_events\n       ${where}\n       ORDER BY created_at DESC, id DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset)\n    .map((row) => row as ActivityEventRow);\n  return listResult(rows, total, limit, offset);\n}\n\nexport function listObjectActivityRecords(options: ListObjectActivityOptions): ActivityListResult {\n  const limit = normalizeLimit(options.limit);\n  const offset = normalizeOffset(options.offset);\n  const params: SqlParam[] = [options.object.kind, options.object.id];\n  const visibility = options.visibility ? 'AND visibility = ?' : '';\n  if (options.visibility) params.push(options.visibility);\n  const total = (getSqliteDatabase()\n    .prepare(\n      `SELECT COUNT(*) AS count\n       FROM activity_events\n       WHERE primary_object_kind = ? AND primary_object_id = ?\n       ${visibility}`,\n    )\n    .get(...params) as CountRow).count;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM activity_events\n       WHERE primary_object_kind = ? AND primary_object_id = ?\n       ${visibility}\n       ORDER BY created_at DESC, id DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset)\n    .map((row) => row as ActivityEventRow);\n  return listResult(rows, total, limit, offset);\n}\n\nexport function listProjectActivityRecords(options: ListProjectActivityOptions): ActivityListResult {\n  const limit = normalizeLimit(options.limit);\n  const offset = normalizeOffset(options.offset);\n  const params: SqlParam[] = ['project', options.projectId];\n  const relatedClause = options.includeRelated\n    ? `OR EXISTS (\n        SELECT 1 FROM activity_related_projects ar\n        WHERE ar.activity_id = ae.id AND ar.project_id = ?\n      )`\n    : '';\n  if (options.includeRelated) params.push(options.projectId);\n  const visibilityClauseSql = options.visibility ? 'AND ae.visibility = ?' : '';\n  if (options.visibility) params.push(options.visibility);\n\n  const baseWhere = `EXISTS (\n      SELECT 1 FROM activity_scopes s\n      WHERE s.activity_id = ae.id AND s.scope_kind = ? AND s.scope_id = ?\n    ) ${relatedClause}`;\n\n  const total = (getSqliteDatabase()\n    .prepare(\n      `SELECT COUNT(*) AS count\n       FROM activity_events ae\n       WHERE (${baseWhere})\n       ${visibilityClauseSql}`,\n    )\n    .get(...params) as CountRow).count;\n  const rows = getSqliteDatabase()\n    .prepare(\n      `SELECT ae.*\n       FROM activity_events ae\n       WHERE (${baseWhere})\n       ${visibilityClauseSql}\n       ORDER BY ae.created_at DESC, ae.id DESC\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset)\n    .map((row) => row as ActivityEventRow);\n  return listResult(rows, total, limit, offset);\n}\n\nexport function createObjectLinkRecord(input: CreateObjectLinkInput): ObjectLink {\n  const id = input.id ?? randomUUID();\n  const now = input.nowMs ?? Date.now();\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO object_links (\n        id, from_kind, from_id, from_title, to_kind, to_id, to_title, relation, source, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      id,\n      input.from.kind,\n      input.from.id,\n      input.from.title ?? null,\n      input.to.kind,\n      input.to.id,\n      input.to.title ?? null,\n      input.relation,\n      input.source,\n      now,\n    );\n  });\n  const row = getSqliteDatabase()\n    .prepare(`SELECT * FROM object_links WHERE id = ?`)\n    .get(id) as ObjectLinkRow | undefined;\n  if (!row) {\n    throw new Error(`Object link was not persisted: ${id}`);\n  }\n  return objectLinkFromRow(row);\n}\n\nexport function listObjectLinkRecords(object: ActivityObjectRef): ObjectLink[] {\n  return getSqliteDatabase()\n    .prepare(\n      `SELECT *\n       FROM object_links\n       WHERE (from_kind = ? AND from_id = ?) OR (to_kind = ? AND to_id = ?)\n       ORDER BY created_at DESC, id DESC`,\n    )\n    .all(object.kind, object.id, object.kind, object.id)\n    .map((row) => objectLinkFromRow(row as ObjectLinkRow));\n}\n"],"mappings":"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"}

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

@@ -1,9 +1,9 @@
 import { resolveXopcDatabasePath } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { ensureXopcDatabaseSchema } from "./schema.js";
 import { requireNodeSqlite } from "../../infra/node-sqlite.js";
 import { installSqliteTransientRejectionHandler } from "../../infra/unhandled-rejections.js";
-import { ensureXopcDatabaseSchema } from "./schema.js";
 import path from "node:path";
 import fs from "node:fs";
 import childProcess from "node:child_process";

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

@@ -14,3 +14,4 @@ export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgen
 export { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex, type MemorySearchHit, } from './memory-index-repository.js';
 export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemorySignalRowPayload, type MemoryTraceFeedback, type MemoryTraceEventPayload, type SearchMemoryRecordsOptions, type SetMemoryTraceFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
+export { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';

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

@@ -15,4 +15,5 @@ import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgen
 import { resolveAgentIdFromMemoriesDir, searchMemoryIndex, syncMemoryIndex } from "./memory-index-repository.js";
 import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, searchMemoryRecords, setMemoryProviderState, setMemoryTraceFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord } from "./memory-records-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, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionKeyBySessionId, getCompactionCheckpointDetail, getCurrentSessionId, getGlobalSessionStats, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listCompactionCheckpoints, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, summarizeMemoryRecallFeedback, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+import { createObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "./activity-repository.js";
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, buildDefaultSessionMetadata, buildGlobalSessionStats, captureCompactionCheckpoint, classifyStoredRow, closeXopcDatabase, createObjectLinkRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionKeyBySessionId, getActivityEventRecord, getCompactionCheckpointDetail, getCurrentSessionId, getGlobalSessionStats, getMemoryProviderState, getMemoryRecord, getNoteAgentContextRecord, getNoteRecord, getSessionConfig, getSessionMetadata, getSessionPersistedLevels, getSqliteDatabase, getXopcDatabase, hasSessionConfig, incrementSessionStatsOnAppend, inspectSchemaMigrationStatus, isXopcDatabaseOpen, listActivityRecords, listCompactionCheckpoints, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, loadCheckpointRows, loadLlmMessagesForSession, loadTranscriptRows, loadTranscriptRowsForSession, metadataToSessionInsert, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, readSchemaVersion, readSchemaVersionForTest, recordActivityEvent, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveAgentIdFromMemoriesDir, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreCompactionCheckpoint, runSqliteWriteTransaction, searchMemoryIndex, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setMemoryProviderState, setMemoryTraceFeedback, setSessionConfig, summarizeMemoryRecallFeedback, syncMemoryIndex, transcriptEntryRowToStoredRow, updateSessionConfig, updateSessionStats, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

package/dist/src/storage/sqlite/migrations/022_work_items.sql

@@ -0,0 +1,61 @@
+CREATE TABLE IF NOT EXISTS work_items (
+  id              TEXT PRIMARY KEY,
+  project_id      TEXT NOT NULL,
+  title           TEXT NOT NULL,
+  description     TEXT,
+  status          TEXT NOT NULL,
+  priority        TEXT NOT NULL DEFAULT 'normal',
+  owner_agent_id  TEXT,
+  next_action     TEXT,
+  blocked_reason  TEXT,
+  due_at          INTEGER,
+  completed_at    INTEGER,
+  archived_at     INTEGER,
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_items_project_status
+  ON work_items(project_id, status, archived_at, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS work_item_links (
+  id               TEXT PRIMARY KEY,
+  work_item_id     TEXT NOT NULL,
+  kind             TEXT NOT NULL,
+  target_id        TEXT NOT NULL,
+  title            TEXT,
+  status_snapshot  TEXT,
+  created_at       INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_links_item
+  ON work_item_links(work_item_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS work_item_events (
+  id            TEXT PRIMARY KEY,
+  work_item_id  TEXT NOT NULL,
+  type          TEXT NOT NULL,
+  payload_json  TEXT,
+  created_at    INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_events_item
+  ON work_item_events(work_item_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS work_item_update_suggestions (
+  id             TEXT PRIMARY KEY,
+  work_item_id   TEXT NOT NULL,
+  source_kind    TEXT NOT NULL,
+  source_id      TEXT NOT NULL,
+  status         TEXT NOT NULL,
+  patch_json     TEXT NOT NULL DEFAULT '{}',
+  progress_note  TEXT,
+  rationale      TEXT,
+  confidence     REAL,
+  created_at     INTEGER NOT NULL,
+  applied_at     INTEGER,
+  dismissed_at   INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_update_suggestions_item
+  ON work_item_update_suggestions(work_item_id, status, created_at DESC);

package/dist/src/storage/sqlite/migrations/023_work_item_attachments.sql

@@ -0,0 +1,15 @@
+CREATE TABLE IF NOT EXISTS work_item_attachments (
+  id            TEXT PRIMARY KEY,
+  work_item_id  TEXT NOT NULL,
+  media_uri     TEXT NOT NULL,
+  media_id      TEXT NOT NULL,
+  bucket        TEXT NOT NULL,
+  type          TEXT NOT NULL,
+  mime_type     TEXT NOT NULL,
+  file_name     TEXT NOT NULL,
+  size          INTEGER NOT NULL,
+  created_at    INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_work_item_attachments_item
+  ON work_item_attachments(work_item_id, created_at DESC);

package/dist/src/storage/sqlite/migrations/024_activity_events.sql

@@ -0,0 +1,62 @@
+CREATE TABLE IF NOT EXISTS activity_events (
+  id                    TEXT PRIMARY KEY,
+  type                  TEXT NOT NULL,
+  primary_object_kind   TEXT NOT NULL,
+  primary_object_id     TEXT NOT NULL,
+  primary_object_title  TEXT,
+  actor_json            TEXT NOT NULL,
+  initiator_json        TEXT,
+  source_json           TEXT NOT NULL,
+  payload_json          TEXT NOT NULL DEFAULT '{}',
+  visibility            TEXT NOT NULL,
+  importance            TEXT NOT NULL,
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_activity_events_created
+  ON activity_events(created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_activity_events_object_created
+  ON activity_events(primary_object_kind, primary_object_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS activity_scopes (
+  activity_id  TEXT NOT NULL,
+  scope_kind   TEXT NOT NULL,
+  scope_id     TEXT NOT NULL,
+  reason       TEXT NOT NULL,
+  PRIMARY KEY (activity_id, scope_kind, scope_id, reason)
+);
+
+CREATE INDEX IF NOT EXISTS idx_activity_scopes_scope
+  ON activity_scopes(scope_kind, scope_id, activity_id);
+
+CREATE TABLE IF NOT EXISTS object_links (
+  id          TEXT PRIMARY KEY,
+  from_kind   TEXT NOT NULL,
+  from_id     TEXT NOT NULL,
+  from_title  TEXT,
+  to_kind     TEXT NOT NULL,
+  to_id       TEXT NOT NULL,
+  to_title    TEXT,
+  relation    TEXT NOT NULL,
+  source      TEXT NOT NULL,
+  created_at  INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_object_links_from
+  ON object_links(from_kind, from_id);
+
+CREATE INDEX IF NOT EXISTS idx_object_links_to
+  ON object_links(to_kind, to_id);
+
+CREATE TABLE IF NOT EXISTS activity_related_projects (
+  activity_id  TEXT NOT NULL,
+  project_id   TEXT NOT NULL,
+  reason       TEXT NOT NULL,
+  confidence   REAL NOT NULL,
+  computed_at  INTEGER NOT NULL,
+  PRIMARY KEY (activity_id, project_id, reason)
+);
+
+CREATE INDEX IF NOT EXISTS idx_activity_related_projects_project
+  ON activity_related_projects(project_id, activity_id);

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 = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 21;
+export declare const XOPC_DB_SCHEMA_VERSION = 24;
 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 = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 21;
+const XOPC_DB_SCHEMA_VERSION = 24;
 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 ?? 21;
+	const targetVersion = options.targetVersion ?? 24;
 	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 ?? 21;
+	const appVersion = options.targetVersion ?? 24;
 	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 = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 21;\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 = 24;\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 = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 21;
+export const XOPC_DB_SCHEMA_VERSION = 24;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/row-mappers.js

@@ -1,7 +1,7 @@
-import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
 import "../../session/types.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { isTranscriptContextEntry } from "../../session/session-context-for-llm.js";
+import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
 //#region src/storage/sqlite/row-mappers.ts
 init_agent_session_key();
 function parseJson(raw) {

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

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