@xopcai/xopc 0.0.95 → 0.0.97

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

@@ -0,0 +1,268 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { buildDefaultSessionMetadata, resolveAgentIdFromSessionKey } from "./session-metadata.js";
+import { buildGlobalSessionStats, metadataToSessionInsert, sessionRowToMetadata } from "./row-mappers.js";
+import { validateSessionId } from "../../session/session-id.js";
+import { escapeFts5Query } from "./fts.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/session-repository.ts
+const SESSION_COLUMNS = `
+  session_key, agent_id, current_transcript_id, status, name, tags_json,
+  created_at, updated_at, last_accessed_at, session_started_at, last_interaction_at,
+  source_channel, source_chat_id, session_type, routing_json, custom_data_json,
+  abort_cutoff_timestamp, message_count, estimated_tokens, compacted_count,
+  thinking_level, verbose_level
+`;
+const SELECT_SESSION = `SELECT ${SESSION_COLUMNS} FROM sessions WHERE session_key = ?`;
+function readSessionRow(db, sessionKey) {
+	return db.prepare(SELECT_SESSION).get(sessionKey);
+}
+function insertSessionAndTranscript(db, sessionKey, transcriptId, cwd, metadata) {
+	const row = metadataToSessionInsert(sessionKey, transcriptId, metadata);
+	db.prepare(`INSERT INTO sessions (
+      session_key, agent_id, current_transcript_id, status, name, tags_json,
+      created_at, updated_at, last_accessed_at, session_started_at, last_interaction_at,
+      source_channel, source_chat_id, session_type, routing_json, custom_data_json,
+      abort_cutoff_timestamp, message_count, estimated_tokens, compacted_count,
+      thinking_level, verbose_level
+    ) VALUES (
+      ?, ?, ?, ?, ?, ?,
+      ?, ?, ?, ?, ?,
+      ?, ?, ?, ?, ?,
+      ?, ?, ?, ?,
+      ?, ?
+    )`).run(row.sessionKey, row.agentId, row.transcriptId, row.status, row.name, row.tagsJson, row.createdAt, row.updatedAt, row.lastAccessedAt, row.sessionStartedAt, row.lastInteractionAt, row.sourceChannel, row.sourceChatId, row.sessionType, row.routingJson, row.customDataJson, row.abortCutoffTimestamp, row.messageCount, row.estimatedTokens, row.compactedCount, row.thinkingLevel, row.verboseLevel);
+	const now = Date.now();
+	db.prepare(`INSERT INTO transcripts (transcript_id, session_key, status, created_at, cwd)
+     VALUES (?, ?, 'active', ?, ?)`).run(transcriptId, sessionKey, now, cwd);
+}
+function ensureSessionInTransaction(db, sessionKey, cwd) {
+	const existing = readSessionRow(db, sessionKey);
+	if (existing) return sessionRowToMetadata(sessionKey, existing);
+	const transcriptId = validateSessionId(randomUUID());
+	const metadata = buildDefaultSessionMetadata(sessionKey);
+	metadata.transcriptId = transcriptId;
+	insertSessionAndTranscript(db, sessionKey, transcriptId, cwd, metadata);
+	const row = readSessionRow(db, sessionKey);
+	if (!row) throw new Error(`Failed to create session: ${sessionKey}`);
+	return sessionRowToMetadata(sessionKey, row);
+}
+function ensureSessionRecord(sessionKey, cwd) {
+	return runSqliteWriteTransaction((db) => ensureSessionInTransaction(db, sessionKey, cwd));
+}
+function readCurrentTranscriptId(db, sessionKey) {
+	return db.prepare(`SELECT current_transcript_id FROM sessions WHERE session_key = ?`).get(sessionKey)?.current_transcript_id ?? null;
+}
+function getSessionMetadata(sessionKey) {
+	const row = readSessionRow(getSqliteDatabase(), sessionKey);
+	if (!row) return null;
+	return sessionRowToMetadata(sessionKey, row);
+}
+function getCurrentTranscriptId(sessionKey) {
+	return readCurrentTranscriptId(getSqliteDatabase(), sessionKey);
+}
+function listSessionMetadata(query = {}) {
+	const db = getSqliteDatabase();
+	const conditions = [];
+	const params = [];
+	if (query.status) {
+		const statuses = Array.isArray(query.status) ? query.status : [query.status];
+		conditions.push(`status IN (${statuses.map(() => "?").join(", ")})`);
+		params.push(...statuses);
+	}
+	if (query.channel) {
+		const rawChannels = query.channel.split(",").map((c) => c.trim().toLowerCase()).filter(Boolean);
+		const channels = [...new Set(rawChannels.flatMap((c) => {
+			if (c === "webchat") return ["webchat", "ui"];
+			if (c === "gateway") return ["gateway", "webui"];
+			return [c];
+		}))];
+		if (channels.length === 0) return {
+			items: [],
+			total: 0,
+			limit: query.limit ?? 50,
+			offset: query.offset ?? 0,
+			hasMore: false
+		};
+		const directMatch = `LOWER(source_channel) IN (${channels.map(() => "?").join(", ")})`;
+		const keyPatterns = /* @__PURE__ */ new Set();
+		for (const c of channels) if (c === "webchat" || c === "ui") keyPatterns.add(`session_key LIKE 'agent:%:webchat:%'`);
+		else if (c === "gateway" || c === "webui") keyPatterns.add(`session_key LIKE 'agent:%:gateway:%'`);
+		else keyPatterns.add(`session_key LIKE 'agent:%:${c.replace(/'/g, "''")}:%'`);
+		const keyFallback = keyPatterns.size > 0 ? `(TRIM(COALESCE(source_channel, '')) = '' AND (${[...keyPatterns].join(" OR ")}))` : "";
+		conditions.push(keyFallback ? `(${directMatch} OR ${keyFallback})` : directMatch);
+		params.push(...channels);
+	}
+	if (query.tags?.length) for (const tag of query.tags) {
+		conditions.push(`tags_json LIKE ?`);
+		params.push(`%"${tag}"%`);
+	}
+	let searchKeys = null;
+	if (query.search?.trim()) {
+		const rawSearch = query.search.trim();
+		const ftsQuery = escapeFts5Query(rawSearch);
+		const ftsRows = db.prepare(`SELECT DISTINCT session_key FROM transcript_fts WHERE transcript_fts MATCH ? LIMIT 500`).all(ftsQuery);
+		const ftsKeys = new Set(ftsRows.map((r) => r.session_key));
+		const like = `%${rawSearch.toLowerCase()}%`;
+		const metaRows = db.prepare(`SELECT session_key FROM sessions
+         WHERE LOWER(session_key) LIKE ?
+            OR LOWER(COALESCE(name, '')) LIKE ?
+            OR LOWER(source_channel) LIKE ?
+            OR LOWER(source_chat_id) LIKE ?
+            OR LOWER(tags_json) LIKE ?`).all(like, like, like, like, like);
+		searchKeys = [...new Set([...ftsKeys, ...metaRows.map((r) => r.session_key)])];
+		if (searchKeys.length === 0) return {
+			items: [],
+			total: 0,
+			limit: query.limit ?? 50,
+			offset: query.offset ?? 0,
+			hasMore: false
+		};
+		conditions.push(`session_key IN (${searchKeys.map(() => "?").join(", ")})`);
+		params.push(...searchKeys);
+	}
+	const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+	const sortColumn = sessionSortColumn(query.sortBy);
+	const sortOrder = query.sortOrder === "asc" ? "ASC" : "DESC";
+	const total = db.prepare(`SELECT COUNT(*) AS total FROM sessions ${where}`).get(...params).total;
+	const limit = query.limit ?? 50;
+	const offset = query.offset ?? 0;
+	return {
+		items: db.prepare(`SELECT ${SESSION_COLUMNS} FROM sessions ${where}
+       ORDER BY ${sortColumn} ${sortOrder}
+       LIMIT ? OFFSET ?`).all(...params, limit, offset).map((row) => sessionRowToMetadata(row.session_key, row)),
+		total,
+		limit,
+		offset,
+		hasMore: offset + limit < total
+	};
+}
+function sessionSortColumn(sortBy) {
+	switch (sortBy) {
+		case "createdAt": return "created_at";
+		case "messageCount": return "message_count";
+		case "lastAccessedAt": return "last_accessed_at";
+		default: return "updated_at";
+	}
+}
+function patchSessionMetadata(sessionKey, updates) {
+	return runSqliteWriteTransaction((db) => {
+		const existing = readSessionRow(db, sessionKey);
+		if (!existing) throw new Error(`Session not found: ${sessionKey}`);
+		const merged = {
+			...sessionRowToMetadata(sessionKey, existing),
+			...updates,
+			key: sessionKey
+		};
+		const now = Date.now();
+		db.prepare(`UPDATE sessions SET
+        status = ?,
+        name = ?,
+        tags_json = ?,
+        updated_at = ?,
+        last_accessed_at = ?,
+        session_started_at = ?,
+        last_interaction_at = ?,
+        source_channel = ?,
+        source_chat_id = ?,
+        session_type = ?,
+        routing_json = ?,
+        custom_data_json = ?,
+        abort_cutoff_timestamp = ?,
+        message_count = ?,
+        estimated_tokens = ?,
+        compacted_count = ?,
+        thinking_level = ?,
+        verbose_level = ?
+      WHERE session_key = ?`).run(merged.status, merged.name ?? null, JSON.stringify(merged.tags ?? []), Date.parse(merged.updatedAt) || now, Date.parse(merged.lastAccessedAt) || now, merged.sessionStartedAt ? Date.parse(merged.sessionStartedAt) : existing.session_started_at, merged.lastInteractionAt ? Date.parse(merged.lastInteractionAt) : existing.last_interaction_at, merged.sourceChannel, merged.sourceChatId, merged.sessionType ?? null, merged.routing ? JSON.stringify(merged.routing) : null, merged.customData ? JSON.stringify(merged.customData) : null, merged.abortCutoffTimestamp ?? null, merged.messageCount, merged.estimatedTokens, merged.compactedCount, existing.thinking_level, existing.verbose_level, sessionKey);
+		const row = readSessionRow(db, sessionKey);
+		if (!row) throw new Error(`Session not found after patch: ${sessionKey}`);
+		return sessionRowToMetadata(sessionKey, row);
+	});
+}
+function updateSessionStats(sessionKey, stats) {
+	runSqliteWriteTransaction((db) => {
+		const now = stats.lastInteractionAt ?? Date.now();
+		db.prepare(`UPDATE sessions SET
+        message_count = ?,
+        estimated_tokens = ?,
+        updated_at = ?,
+        last_accessed_at = ?,
+        last_interaction_at = ?
+      WHERE session_key = ?`).run(stats.messageCount, stats.estimatedTokens, now, now, now, sessionKey);
+	});
+}
+function incrementSessionStatsOnAppend(sessionKey, tokenDelta = 0) {
+	runSqliteWriteTransaction((db) => {
+		const now = Date.now();
+		db.prepare(`UPDATE sessions SET
+        message_count = message_count + 1,
+        estimated_tokens = estimated_tokens + ?,
+        updated_at = ?,
+        last_accessed_at = ?,
+        last_interaction_at = ?
+      WHERE session_key = ?`).run(tokenDelta, now, now, now, sessionKey);
+	});
+}
+function resetSessionRecord(sessionKey, cwd) {
+	return runSqliteWriteTransaction((db) => {
+		const existing = readSessionRow(db, sessionKey);
+		if (!existing) return null;
+		const previousSessionId = existing.current_transcript_id;
+		const now = Date.now();
+		db.prepare(`UPDATE transcripts SET status = 'archived', archive_reason = 'reset', archived_at = ?
+       WHERE transcript_id = ?`).run(now, previousSessionId);
+		const newTranscriptId = validateSessionId(randomUUID());
+		db.prepare(`INSERT INTO transcripts (transcript_id, session_key, status, created_at, cwd)
+       VALUES (?, ?, 'active', ?, ?)`).run(newTranscriptId, sessionKey, now, cwd);
+		db.prepare(`UPDATE sessions SET
+        current_transcript_id = ?,
+        updated_at = ?,
+        session_started_at = ?,
+        last_interaction_at = NULL,
+        message_count = 0,
+        estimated_tokens = 0
+      WHERE session_key = ?`).run(newTranscriptId, now, now, sessionKey);
+		return {
+			sessionId: newTranscriptId,
+			previousSessionId
+		};
+	});
+}
+function deleteSessionRecord(sessionKey) {
+	return runSqliteWriteTransaction((db) => {
+		const existing = readSessionRow(db, sessionKey);
+		if (!existing) return false;
+		const now = Date.now();
+		db.prepare(`UPDATE transcripts SET status = 'archived', archive_reason = 'delete', archived_at = ?
+       WHERE transcript_id = ?`).run(now, existing.current_transcript_id);
+		db.prepare(`DELETE FROM sessions WHERE session_key = ?`).run(sessionKey);
+		return true;
+	});
+}
+function listSessionsByAgent(agentId) {
+	return getSqliteDatabase().prepare(`SELECT ${SESSION_COLUMNS} FROM sessions WHERE agent_id = ? ORDER BY updated_at DESC`).all(agentId.toLowerCase()).map((row) => sessionRowToMetadata(row.session_key, row));
+}
+function getSessionPersistedLevels(sessionKey) {
+	const row = getSqliteDatabase().prepare(`SELECT thinking_level, verbose_level FROM sessions WHERE session_key = ?`).get(sessionKey);
+	if (!row) return null;
+	return {
+		thinkingLevel: row.thinking_level,
+		verboseLevel: row.verbose_level
+	};
+}
+function findSessionKeyByTranscriptId(transcriptId) {
+	return getSqliteDatabase().prepare(`SELECT session_key FROM sessions WHERE current_transcript_id = ?`).get(transcriptId)?.session_key ?? null;
+}
+function getGlobalSessionStats() {
+	return buildGlobalSessionStats(listSessionMetadata({
+		limit: 1e5,
+		offset: 0
+	}).items);
+}
+function resolveSessionAgentId(sessionKey) {
+	return resolveAgentIdFromSessionKey(sessionKey);
+}
+//#endregion
+export { deleteSessionRecord, ensureSessionInTransaction, ensureSessionRecord, findSessionKeyByTranscriptId, getCurrentTranscriptId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, readCurrentTranscriptId, resetSessionRecord, resolveSessionAgentId, updateSessionStats };
+
+//# sourceMappingURL=session-repository.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-repository.js","names":[],"sources":["../../../../src/storage/sqlite/session-repository.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { validateSessionId } from '../../session/session-id.js';\nimport type { SessionListQuery, SessionMetadata, PaginatedResult } from '../../session/types.js';\nimport {\n  buildDefaultSessionMetadata,\n  resolveAgentIdFromSessionKey,\n} from './session-metadata.js';\nimport {\n  buildGlobalSessionStats,\n  metadataToSessionInsert,\n  sessionRowToMetadata,\n  type SessionRow,\n} from './row-mappers.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';\n\nconst SESSION_COLUMNS = `\n  session_key, agent_id, current_transcript_id, status, name, tags_json,\n  created_at, updated_at, last_accessed_at, session_started_at, last_interaction_at,\n  source_channel, source_chat_id, session_type, routing_json, custom_data_json,\n  abort_cutoff_timestamp, message_count, estimated_tokens, compacted_count,\n  thinking_level, verbose_level\n`;\n\nimport { escapeFts5Query } from './fts.js';\n\nconst SELECT_SESSION = `SELECT ${SESSION_COLUMNS} FROM sessions WHERE session_key = ?`;\n\nfunction readSessionRow(db: DatabaseSync, sessionKey: string): SessionRow | undefined {\n  return db.prepare(SELECT_SESSION).get(sessionKey) as SessionRow | undefined;\n}\n\nfunction insertSessionAndTranscript(\n  db: DatabaseSync,\n  sessionKey: string,\n  transcriptId: string,\n  cwd: string,\n  metadata: SessionMetadata,\n): void {\n  const row = metadataToSessionInsert(sessionKey, transcriptId, metadata);\n  db.prepare(\n    `INSERT INTO sessions (\n      session_key, agent_id, current_transcript_id, status, name, tags_json,\n      created_at, updated_at, last_accessed_at, session_started_at, last_interaction_at,\n      source_channel, source_chat_id, session_type, routing_json, custom_data_json,\n      abort_cutoff_timestamp, message_count, estimated_tokens, compacted_count,\n      thinking_level, verbose_level\n    ) VALUES (\n      ?, ?, ?, ?, ?, ?,\n      ?, ?, ?, ?, ?,\n      ?, ?, ?, ?, ?,\n      ?, ?, ?, ?,\n      ?, ?\n    )`,\n  ).run(\n    row.sessionKey,\n    row.agentId,\n    row.transcriptId,\n    row.status,\n    row.name,\n    row.tagsJson,\n    row.createdAt,\n    row.updatedAt,\n    row.lastAccessedAt,\n    row.sessionStartedAt,\n    row.lastInteractionAt,\n    row.sourceChannel,\n    row.sourceChatId,\n    row.sessionType,\n    row.routingJson,\n    row.customDataJson,\n    row.abortCutoffTimestamp,\n    row.messageCount,\n    row.estimatedTokens,\n    row.compactedCount,\n    row.thinkingLevel,\n    row.verboseLevel,\n  );\n\n  const now = Date.now();\n  db.prepare(\n    `INSERT INTO transcripts (transcript_id, session_key, status, created_at, cwd)\n     VALUES (?, ?, 'active', ?, ?)`,\n  ).run(transcriptId, sessionKey, now, cwd);\n}\n\nexport function ensureSessionInTransaction(\n  db: DatabaseSync,\n  sessionKey: string,\n  cwd: string,\n): SessionMetadata {\n  const existing = readSessionRow(db, sessionKey);\n  if (existing) {\n    return sessionRowToMetadata(sessionKey, existing);\n  }\n\n  const transcriptId = validateSessionId(randomUUID());\n  const metadata = buildDefaultSessionMetadata(sessionKey);\n  metadata.transcriptId = transcriptId;\n  insertSessionAndTranscript(db, sessionKey, transcriptId, cwd, metadata);\n  const row = readSessionRow(db, sessionKey);\n  if (!row) {\n    throw new Error(`Failed to create session: ${sessionKey}`);\n  }\n  return sessionRowToMetadata(sessionKey, row);\n}\n\nexport function ensureSessionRecord(sessionKey: string, cwd: string): SessionMetadata {\n  return runSqliteWriteTransaction((db) => ensureSessionInTransaction(db, sessionKey, cwd));\n}\n\nexport function readCurrentTranscriptId(db: DatabaseSync, sessionKey: string): string | null {\n  const row = db\n    .prepare(`SELECT current_transcript_id FROM sessions WHERE session_key = ?`)\n    .get(sessionKey) as { current_transcript_id?: string } | undefined;\n  return row?.current_transcript_id ?? null;\n}\n\nexport function getSessionMetadata(sessionKey: string): SessionMetadata | null {\n  const db = getSqliteDatabase();\n  const row = readSessionRow(db, sessionKey);\n  if (!row) {\n    return null;\n  }\n  return sessionRowToMetadata(sessionKey, row);\n}\n\nexport function getCurrentTranscriptId(sessionKey: string): string | null {\n  return readCurrentTranscriptId(getSqliteDatabase(), sessionKey);\n}\n\nexport function listSessionMetadata(query: SessionListQuery = {}): PaginatedResult<SessionMetadata> {\n  const db = getSqliteDatabase();\n  const conditions: string[] = [];\n  const params: Array<string | number> = [];\n\n  if (query.status) {\n    const statuses = Array.isArray(query.status) ? query.status : [query.status];\n    conditions.push(`status IN (${statuses.map(() => '?').join(', ')})`);\n    params.push(...statuses);\n  }\n\n  if (query.channel) {\n    const rawChannels = query.channel\n      .split(',')\n      .map((c) => c.trim().toLowerCase())\n      .filter(Boolean);\n    const channels = [\n      ...new Set(\n        rawChannels.flatMap((c) => {\n          if (c === 'webchat') return ['webchat', 'ui'];\n          if (c === 'gateway') return ['gateway', 'webui'];\n          return [c];\n        }),\n      ),\n    ];\n    if (channels.length === 0) {\n      return { items: [], total: 0, limit: query.limit ?? 50, offset: query.offset ?? 0, hasMore: false };\n    }\n    const directMatch = `LOWER(source_channel) IN (${channels.map(() => '?').join(', ')})`;\n    const keyPatterns = new Set<string>();\n    for (const c of channels) {\n      if (c === 'webchat' || c === 'ui') {\n        keyPatterns.add(`session_key LIKE 'agent:%:webchat:%'`);\n      } else if (c === 'gateway' || c === 'webui') {\n        keyPatterns.add(`session_key LIKE 'agent:%:gateway:%'`);\n      } else {\n        keyPatterns.add(`session_key LIKE 'agent:%:${c.replace(/'/g, \"''\")}:%'`);\n      }\n    }\n    const keyFallback =\n      keyPatterns.size > 0\n        ? `(TRIM(COALESCE(source_channel, '')) = '' AND (${[...keyPatterns].join(' OR ')}))`\n        : '';\n    conditions.push(keyFallback ? `(${directMatch} OR ${keyFallback})` : directMatch);\n    params.push(...channels);\n  }\n\n  if (query.tags?.length) {\n    for (const tag of query.tags) {\n      conditions.push(`tags_json LIKE ?`);\n      params.push(`%\"${tag}\"%`);\n    }\n  }\n\n  let searchKeys: string[] | null = null;\n  if (query.search?.trim()) {\n    const rawSearch = query.search.trim();\n    const ftsQuery = escapeFts5Query(rawSearch);\n    const ftsRows = db\n      .prepare(\n        `SELECT DISTINCT session_key FROM transcript_fts WHERE transcript_fts MATCH ? LIMIT 500`,\n      )\n      .all(ftsQuery) as Array<{ session_key: string }>;\n    const ftsKeys = new Set(ftsRows.map((r) => r.session_key));\n    const like = `%${rawSearch.toLowerCase()}%`;\n    const metaRows = db\n      .prepare(\n        `SELECT session_key FROM sessions\n         WHERE LOWER(session_key) LIKE ?\n            OR LOWER(COALESCE(name, '')) LIKE ?\n            OR LOWER(source_channel) LIKE ?\n            OR LOWER(source_chat_id) LIKE ?\n            OR LOWER(tags_json) LIKE ?`,\n      )\n      .all(like, like, like, like, like) as Array<{ session_key: string }>;\n    searchKeys = [...new Set([...ftsKeys, ...metaRows.map((r) => r.session_key)])];\n    if (searchKeys.length === 0) {\n      return { items: [], total: 0, limit: query.limit ?? 50, offset: query.offset ?? 0, hasMore: false };\n    }\n    conditions.push(`session_key IN (${searchKeys.map(() => '?').join(', ')})`);\n    params.push(...searchKeys);\n  }\n\n  const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';\n  const sortColumn = sessionSortColumn(query.sortBy);\n  const sortOrder = query.sortOrder === 'asc' ? 'ASC' : 'DESC';\n\n  const countRow = db\n    .prepare(`SELECT COUNT(*) AS total FROM sessions ${where}`)\n    .get(...params) as { total: number };\n  const total = countRow.total;\n\n  const limit = query.limit ?? 50;\n  const offset = query.offset ?? 0;\n  const rows = db\n    .prepare(\n      `SELECT ${SESSION_COLUMNS} FROM sessions ${where}\n       ORDER BY ${sortColumn} ${sortOrder}\n       LIMIT ? OFFSET ?`,\n    )\n    .all(...params, limit, offset) as SessionRow[];\n\n  const items = rows.map((row) => sessionRowToMetadata(row.session_key, row));\n  return { items, total, limit, offset, hasMore: offset + limit < total };\n}\n\nfunction sessionSortColumn(sortBy: SessionListQuery['sortBy']): string {\n  switch (sortBy) {\n    case 'createdAt':\n      return 'created_at';\n    case 'messageCount':\n      return 'message_count';\n    case 'lastAccessedAt':\n      return 'last_accessed_at';\n    case 'updatedAt':\n    default:\n      return 'updated_at';\n  }\n}\n\nexport function patchSessionMetadata(\n  sessionKey: string,\n  updates: Partial<SessionMetadata>,\n): SessionMetadata {\n  return runSqliteWriteTransaction((db) => {\n    const existing = readSessionRow(db, sessionKey);\n    if (!existing) {\n      throw new Error(`Session not found: ${sessionKey}`);\n    }\n\n    const current = sessionRowToMetadata(sessionKey, existing);\n    const merged = { ...current, ...updates, key: sessionKey };\n    const now = Date.now();\n\n    db.prepare(\n      `UPDATE sessions SET\n        status = ?,\n        name = ?,\n        tags_json = ?,\n        updated_at = ?,\n        last_accessed_at = ?,\n        session_started_at = ?,\n        last_interaction_at = ?,\n        source_channel = ?,\n        source_chat_id = ?,\n        session_type = ?,\n        routing_json = ?,\n        custom_data_json = ?,\n        abort_cutoff_timestamp = ?,\n        message_count = ?,\n        estimated_tokens = ?,\n        compacted_count = ?,\n        thinking_level = ?,\n        verbose_level = ?\n      WHERE session_key = ?`,\n    ).run(\n      merged.status,\n      merged.name ?? null,\n      JSON.stringify(merged.tags ?? []),\n      Date.parse(merged.updatedAt) || now,\n      Date.parse(merged.lastAccessedAt) || now,\n      merged.sessionStartedAt ? Date.parse(merged.sessionStartedAt) : existing.session_started_at,\n      merged.lastInteractionAt ? Date.parse(merged.lastInteractionAt) : existing.last_interaction_at,\n      merged.sourceChannel,\n      merged.sourceChatId,\n      merged.sessionType ?? null,\n      merged.routing ? JSON.stringify(merged.routing) : null,\n      merged.customData ? JSON.stringify(merged.customData) : null,\n      merged.abortCutoffTimestamp ?? null,\n      merged.messageCount,\n      merged.estimatedTokens,\n      merged.compactedCount,\n      existing.thinking_level,\n      existing.verbose_level,\n      sessionKey,\n    );\n\n    const row = readSessionRow(db, sessionKey);\n    if (!row) {\n      throw new Error(`Session not found after patch: ${sessionKey}`);\n    }\n    return sessionRowToMetadata(sessionKey, row);\n  });\n}\n\nexport function updateSessionStats(\n  sessionKey: string,\n  stats: { messageCount: number; estimatedTokens: number; lastInteractionAt?: number },\n): void {\n  runSqliteWriteTransaction((db) => {\n    const now = stats.lastInteractionAt ?? Date.now();\n    db.prepare(\n      `UPDATE sessions SET\n        message_count = ?,\n        estimated_tokens = ?,\n        updated_at = ?,\n        last_accessed_at = ?,\n        last_interaction_at = ?\n      WHERE session_key = ?`,\n    ).run(stats.messageCount, stats.estimatedTokens, now, now, now, sessionKey);\n  });\n}\n\nexport function incrementSessionStatsOnAppend(sessionKey: string, tokenDelta = 0): void {\n  runSqliteWriteTransaction((db) => {\n    const now = Date.now();\n    db.prepare(\n      `UPDATE sessions SET\n        message_count = message_count + 1,\n        estimated_tokens = estimated_tokens + ?,\n        updated_at = ?,\n        last_accessed_at = ?,\n        last_interaction_at = ?\n      WHERE session_key = ?`,\n    ).run(tokenDelta, now, now, now, sessionKey);\n  });\n}\n\nexport function resetSessionRecord(\n  sessionKey: string,\n  cwd: string,\n): { sessionId: string; previousSessionId: string } | null {\n  return runSqliteWriteTransaction((db) => {\n    const existing = readSessionRow(db, sessionKey);\n    if (!existing) {\n      return null;\n    }\n\n    const previousSessionId = existing.current_transcript_id;\n    const now = Date.now();\n    db.prepare(\n      `UPDATE transcripts SET status = 'archived', archive_reason = 'reset', archived_at = ?\n       WHERE transcript_id = ?`,\n    ).run(now, previousSessionId);\n\n    const newTranscriptId = validateSessionId(randomUUID());\n    db.prepare(\n      `INSERT INTO transcripts (transcript_id, session_key, status, created_at, cwd)\n       VALUES (?, ?, 'active', ?, ?)`,\n    ).run(newTranscriptId, sessionKey, now, cwd);\n\n    db.prepare(\n      `UPDATE sessions SET\n        current_transcript_id = ?,\n        updated_at = ?,\n        session_started_at = ?,\n        last_interaction_at = NULL,\n        message_count = 0,\n        estimated_tokens = 0\n      WHERE session_key = ?`,\n    ).run(newTranscriptId, now, now, sessionKey);\n\n    return { sessionId: newTranscriptId, previousSessionId };\n  });\n}\n\nexport function deleteSessionRecord(sessionKey: string): boolean {\n  return runSqliteWriteTransaction((db) => {\n    const existing = readSessionRow(db, sessionKey);\n    if (!existing) {\n      return false;\n    }\n\n    const now = Date.now();\n    db.prepare(\n      `UPDATE transcripts SET status = 'archived', archive_reason = 'delete', archived_at = ?\n       WHERE transcript_id = ?`,\n    ).run(now, existing.current_transcript_id);\n\n    db.prepare(`DELETE FROM sessions WHERE session_key = ?`).run(sessionKey);\n    return true;\n  });\n}\n\nexport function listSessionsByAgent(agentId: string): SessionMetadata[] {\n  const db = getSqliteDatabase();\n  const rows = db\n    .prepare(\n      `SELECT ${SESSION_COLUMNS} FROM sessions WHERE agent_id = ? ORDER BY updated_at DESC`,\n    )\n    .all(agentId.toLowerCase()) as SessionRow[];\n  return rows.map((row) => sessionRowToMetadata(row.session_key, row));\n}\n\nexport function getSessionPersistedLevels(sessionKey: string): {\n  thinkingLevel: string | null;\n  verboseLevel: string | null;\n} | null {\n  const db = getSqliteDatabase();\n  const row = db\n    .prepare(`SELECT thinking_level, verbose_level FROM sessions WHERE session_key = ?`)\n    .get(sessionKey) as { thinking_level: string | null; verbose_level: string | null } | undefined;\n  if (!row) {\n    return null;\n  }\n  return { thinkingLevel: row.thinking_level, verboseLevel: row.verbose_level };\n}\n\nexport function findSessionKeyByTranscriptId(transcriptId: string): string | null {\n  const db = getSqliteDatabase();\n  const row = db\n    .prepare(`SELECT session_key FROM sessions WHERE current_transcript_id = ?`)\n    .get(transcriptId) as { session_key?: string } | undefined;\n  return row?.session_key ?? null;\n}\n\nexport function getGlobalSessionStats(): ReturnType<typeof buildGlobalSessionStats> {\n  const all = listSessionMetadata({ limit: 100_000, offset: 0 });\n  return buildGlobalSessionStats(all.items);\n}\n\nexport function resolveSessionAgentId(sessionKey: string): string {\n  return resolveAgentIdFromSessionKey(sessionKey);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * Run an operation inside a `BEGIN IMMEDIATE` transaction with nested SAVEPOINT
+ * support and COMMIT retry on SQLITE_BUSY / SQLITE_LOCKED.
+ *
+ * When called inside an already-active transaction, automatically uses SAVEPOINT
+ * so the outer transaction controls final COMMIT/ROLLBACK. When called at the
+ * top level, owns the full transaction lifecycle with retry on contention.
+ */
+export declare function runSqliteWriteTransaction<T>(fn: (db: DatabaseSync) => T): T;
+export declare function getSqliteDatabase(): DatabaseSync;

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

@@ -0,0 +1,115 @@
+import { getXopcDatabase } from "./connection.js";
+//#region src/storage/sqlite/transaction.ts
+const RETRYABLE_COMMIT_CODES = new Set(["SQLITE_BUSY", "SQLITE_LOCKED"]);
+const MAX_COMMIT_ATTEMPTS = 8;
+let nextSavepointId = 0;
+function nextSavepointName() {
+	nextSavepointId += 1;
+	return `xopc_tx_${nextSavepointId}`;
+}
+const transactionDepthByDatabase = /* @__PURE__ */ new WeakMap();
+function getTransactionDepth(db) {
+	return transactionDepthByDatabase.get(db) ?? 0;
+}
+function setTransactionDepth(db, depth) {
+	if (depth <= 0) {
+		transactionDepthByDatabase.delete(db);
+		return;
+	}
+	transactionDepthByDatabase.set(db, depth);
+}
+function isRetryableCommitError(error) {
+	const code = error && typeof error === "object" ? error.code : void 0;
+	return typeof code === "string" && RETRYABLE_COMMIT_CODES.has(code);
+}
+function commitImmediateTransaction(db) {
+	for (const attempt of Array.from({ length: MAX_COMMIT_ATTEMPTS }, (_, i) => i + 1)) try {
+		db.exec("COMMIT");
+		return;
+	} catch (error) {
+		if (!isRetryableCommitError(error) || attempt >= MAX_COMMIT_ATTEMPTS) throw error;
+	}
+}
+function abortImmediateTransaction(db) {
+	try {
+		db.exec("ROLLBACK");
+	} catch {
+		try {
+			db.close();
+		} catch {}
+	}
+}
+function isPromiseLike(value) {
+	return Boolean(value && typeof value.then === "function");
+}
+function assertSyncTransactionResult(value) {
+	if (isPromiseLike(value)) throw new Error("SQLite write transactions must be synchronous; Promise returns are not supported.");
+}
+/**
+* Run an operation inside a `BEGIN IMMEDIATE` transaction with nested SAVEPOINT
+* support and COMMIT retry on SQLITE_BUSY / SQLITE_LOCKED.
+*
+* When called inside an already-active transaction, automatically uses SAVEPOINT
+* so the outer transaction controls final COMMIT/ROLLBACK. When called at the
+* top level, owns the full transaction lifecycle with retry on contention.
+*/
+function runSqliteWriteTransaction(fn) {
+	const { db } = getXopcDatabase();
+	const depth = getTransactionDepth(db);
+	if (depth > 0) {
+		const savepoint = nextSavepointName();
+		db.exec(`SAVEPOINT ${savepoint}`);
+		setTransactionDepth(db, depth + 1);
+		try {
+			const result = fn(db);
+			assertSyncTransactionResult(result);
+			db.exec(`RELEASE SAVEPOINT ${savepoint}`);
+			return result;
+		} catch (error) {
+			try {
+				db.exec(`ROLLBACK TO SAVEPOINT ${savepoint}`);
+			} finally {
+				db.exec(`RELEASE SAVEPOINT ${savepoint}`);
+			}
+			throw error;
+		} finally {
+			setTransactionDepth(db, depth);
+		}
+	}
+	db.exec("BEGIN IMMEDIATE");
+	setTransactionDepth(db, 1);
+	let transactionActive = true;
+	let result;
+	try {
+		result = fn(db);
+		assertSyncTransactionResult(result);
+	} catch (error) {
+		try {
+			abortImmediateTransaction(db);
+			transactionActive = false;
+		} catch {}
+		throw error;
+	} finally {
+		if (!transactionActive) setTransactionDepth(db, 0);
+	}
+	try {
+		commitImmediateTransaction(db);
+		transactionActive = false;
+		return result;
+	} catch (error) {
+		try {
+			abortImmediateTransaction(db);
+			transactionActive = false;
+		} catch {}
+		throw error;
+	} finally {
+		if (!transactionActive) setTransactionDepth(db, 0);
+	}
+}
+function getSqliteDatabase() {
+	return getXopcDatabase().db;
+}
+//#endregion
+export { getSqliteDatabase, runSqliteWriteTransaction };
+
+//# sourceMappingURL=transaction.js.map

package/dist/src/storage/sqlite/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","names":[],"sources":["../../../../src/storage/sqlite/transaction.ts"],"sourcesContent":["import type { DatabaseSync } from 'node:sqlite';\n\nimport { getXopcDatabase } from './connection.js';\n\nconst RETRYABLE_COMMIT_CODES = new Set(['SQLITE_BUSY', 'SQLITE_LOCKED']);\nconst MAX_COMMIT_ATTEMPTS = 8;\n\nlet nextSavepointId = 0;\n\nfunction nextSavepointName(): string {\n  nextSavepointId += 1;\n  return `xopc_tx_${nextSavepointId}`;\n}\n\nconst transactionDepthByDatabase = new WeakMap<DatabaseSync, number>();\n\nfunction getTransactionDepth(db: DatabaseSync): number {\n  return transactionDepthByDatabase.get(db) ?? 0;\n}\n\nfunction setTransactionDepth(db: DatabaseSync, depth: number): void {\n  if (depth <= 0) {\n    transactionDepthByDatabase.delete(db);\n    return;\n  }\n  transactionDepthByDatabase.set(db, depth);\n}\n\nfunction isRetryableCommitError(error: unknown): boolean {\n  const code =\n    error && typeof error === 'object'\n      ? (error as { code?: unknown }).code\n      : undefined;\n  return typeof code === 'string' && RETRYABLE_COMMIT_CODES.has(code);\n}\n\nfunction commitImmediateTransaction(db: DatabaseSync): void {\n  for (const attempt of Array.from({ length: MAX_COMMIT_ATTEMPTS }, (_, i) => i + 1)) {\n    try {\n      db.exec('COMMIT');\n      return;\n    } catch (error) {\n      if (!isRetryableCommitError(error) || attempt >= MAX_COMMIT_ATTEMPTS) {\n        throw error;\n      }\n    }\n  }\n}\n\nfunction abortImmediateTransaction(db: DatabaseSync): void {\n  try {\n    db.exec('ROLLBACK');\n  } catch {\n    try {\n      db.close();\n    } catch {\n      // Preserve the original error; close failure is secondary.\n    }\n  }\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return Boolean(value && typeof (value as { then?: unknown }).then === 'function');\n}\n\nfunction assertSyncTransactionResult(value: unknown): void {\n  if (isPromiseLike(value)) {\n    throw new Error(\n      'SQLite write transactions must be synchronous; Promise returns are not supported.',\n    );\n  }\n}\n\n/**\n * Run an operation inside a `BEGIN IMMEDIATE` transaction with nested SAVEPOINT\n * support and COMMIT retry on SQLITE_BUSY / SQLITE_LOCKED.\n *\n * When called inside an already-active transaction, automatically uses SAVEPOINT\n * so the outer transaction controls final COMMIT/ROLLBACK. When called at the\n * top level, owns the full transaction lifecycle with retry on contention.\n */\nexport function runSqliteWriteTransaction<T>(fn: (db: DatabaseSync) => T): T {\n  const { db } = getXopcDatabase();\n  const depth = getTransactionDepth(db);\n\n  // Nested call: use SAVEPOINT so outer transaction stays in control.\n  if (depth > 0) {\n    const savepoint = nextSavepointName();\n    db.exec(`SAVEPOINT ${savepoint}`);\n    setTransactionDepth(db, depth + 1);\n    try {\n      const result = fn(db);\n      assertSyncTransactionResult(result);\n      db.exec(`RELEASE SAVEPOINT ${savepoint}`);\n      return result;\n    } catch (error) {\n      try {\n        db.exec(`ROLLBACK TO SAVEPOINT ${savepoint}`);\n      } finally {\n        db.exec(`RELEASE SAVEPOINT ${savepoint}`);\n      }\n      throw error;\n    } finally {\n      setTransactionDepth(db, depth);\n    }\n  }\n\n  // Top-level: own the full BEGIN IMMEDIATE / COMMIT / ROLLBACK lifecycle.\n  db.exec('BEGIN IMMEDIATE');\n  setTransactionDepth(db, 1);\n  let transactionActive = true;\n  let result: T;\n  try {\n    result = fn(db);\n    assertSyncTransactionResult(result);\n  } catch (error) {\n    try {\n      abortImmediateTransaction(db);\n      transactionActive = false;\n    } catch {\n      // Preserve original error; rollback failure is secondary.\n    }\n    throw error;\n  } finally {\n    if (!transactionActive) {\n      setTransactionDepth(db, 0);\n    }\n  }\n\n  try {\n    commitImmediateTransaction(db);\n    transactionActive = false;\n    return result;\n  } catch (error) {\n    try {\n      abortImmediateTransaction(db);\n      transactionActive = false;\n    } catch {\n      // Preserve original error; rollback failure is secondary.\n    }\n    throw error;\n  } finally {\n    if (!transactionActive) {\n      setTransactionDepth(db, 0);\n    }\n  }\n}\n\nexport function getSqliteDatabase(): DatabaseSync {\n  return getXopcDatabase().db;\n}\n"],"mappings":";;AAIA,MAAM,yBAAyB,IAAI,IAAI,CAAC,eAAe,gBAAgB,CAAC;AACxE,MAAM,sBAAsB;AAE5B,IAAI,kBAAkB;AAEtB,SAAS,oBAA4B;AACnC,oBAAmB;AACnB,QAAO,WAAW;;AAGpB,MAAM,6CAA6B,IAAI,SAA+B;AAEtE,SAAS,oBAAoB,IAA0B;AACrD,QAAO,2BAA2B,IAAI,GAAG,IAAI;;AAG/C,SAAS,oBAAoB,IAAkB,OAAqB;AAClE,KAAI,SAAS,GAAG;AACd,6BAA2B,OAAO,GAAG;AACrC;;AAEF,4BAA2B,IAAI,IAAI,MAAM;;AAG3C,SAAS,uBAAuB,OAAyB;CACvD,MAAM,OACJ,SAAS,OAAO,UAAU,WACrB,MAA6B,OAC9B,KAAA;AACN,QAAO,OAAO,SAAS,YAAY,uBAAuB,IAAI,KAAK;;AAGrE,SAAS,2BAA2B,IAAwB;AAC1D,MAAK,MAAM,WAAW,MAAM,KAAK,EAAE,QAAQ,qBAAqB,GAAG,GAAG,MAAM,IAAI,EAAE,CAChF,KAAI;AACF,KAAG,KAAK,SAAS;AACjB;UACO,OAAO;AACd,MAAI,CAAC,uBAAuB,MAAM,IAAI,WAAW,oBAC/C,OAAM;;;AAMd,SAAS,0BAA0B,IAAwB;AACzD,KAAI;AACF,KAAG,KAAK,WAAW;SACb;AACN,MAAI;AACF,MAAG,OAAO;UACJ;;;AAMZ,SAAS,cAAc,OAA+C;AACpE,QAAO,QAAQ,SAAS,OAAQ,MAA6B,SAAS,WAAW;;AAGnF,SAAS,4BAA4B,OAAsB;AACzD,KAAI,cAAc,MAAM,CACtB,OAAM,IAAI,MACR,oFACD;;;;;;;;;;AAYL,SAAgB,0BAA6B,IAAgC;CAC3E,MAAM,EAAE,OAAO,iBAAiB;CAChC,MAAM,QAAQ,oBAAoB,GAAG;AAGrC,KAAI,QAAQ,GAAG;EACb,MAAM,YAAY,mBAAmB;AACrC,KAAG,KAAK,aAAa,YAAY;AACjC,sBAAoB,IAAI,QAAQ,EAAE;AAClC,MAAI;GACF,MAAM,SAAS,GAAG,GAAG;AACrB,+BAA4B,OAAO;AACnC,MAAG,KAAK,qBAAqB,YAAY;AACzC,UAAO;WACA,OAAO;AACd,OAAI;AACF,OAAG,KAAK,yBAAyB,YAAY;aACrC;AACR,OAAG,KAAK,qBAAqB,YAAY;;AAE3C,SAAM;YACE;AACR,uBAAoB,IAAI,MAAM;;;AAKlC,IAAG,KAAK,kBAAkB;AAC1B,qBAAoB,IAAI,EAAE;CAC1B,IAAI,oBAAoB;CACxB,IAAI;AACJ,KAAI;AACF,WAAS,GAAG,GAAG;AACf,8BAA4B,OAAO;UAC5B,OAAO;AACd,MAAI;AACF,6BAA0B,GAAG;AAC7B,uBAAoB;UACd;AAGR,QAAM;WACE;AACR,MAAI,CAAC,kBACH,qBAAoB,IAAI,EAAE;;AAI9B,KAAI;AACF,6BAA2B,GAAG;AAC9B,sBAAoB;AACpB,SAAO;UACA,OAAO;AACd,MAAI;AACF,6BAA0B,GAAG;AAC7B,uBAAoB;UACd;AAGR,QAAM;WACE;AACR,MAAI,CAAC,kBACH,qBAAoB,IAAI,EAAE;;;AAKhC,SAAgB,oBAAkC;AAChD,QAAO,iBAAiB,CAAC"}

package/dist/src/storage/sqlite/transcript-repository.d.ts

@@ -0,0 +1,34 @@
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+import type { CompactionCheckpointDetail, CompactionCheckpointSummary } from '../../session/types.js';
+import type { TranscriptCompactionRecord } from '../../session/transcript-format.js';
+import { type TranscriptStoredRow } from '../../session/session-context-for-llm.js';
+import { type TranscriptEntryRow } from './row-mappers.js';
+export declare function appendTranscriptEntry(sessionKey: string, row: TranscriptStoredRow, opts?: {
+    transcriptId?: string;
+    tokenDelta?: number;
+}): TranscriptEntryRow;
+export declare function loadTranscriptRowsForSession(sessionKey: string): TranscriptStoredRow[];
+export declare function loadTranscriptRows(transcriptId: string): TranscriptStoredRow[];
+export declare function loadLlmMessagesForSession(sessionKey: string): AgentMessage[];
+export declare function replaceTranscriptRows(sessionKey: string, rows: TranscriptStoredRow[], opts?: {
+    appendCompaction?: TranscriptCompactionRecord;
+}): void;
+export declare function loadCheckpointRows(sessionKey: string, checkpointId: string): TranscriptStoredRow[];
+export declare function paginateTranscriptMessages(sessionKey: string, options?: {
+    offset?: number;
+    limit?: number;
+    beforeSeq?: number;
+    /** 0-based exclusive end index (legacy cursor from gateway UI). */
+    beforeEndIndex?: number;
+    includeContext?: boolean;
+}): {
+    rows: TranscriptStoredRow[];
+    messages: AgentMessage[];
+    total: number;
+    startSeq: number;
+    endSeq: number;
+};
+export declare function captureCompactionCheckpoint(sessionKey: string): string | null;
+export declare function listCompactionCheckpoints(sessionKey: string): CompactionCheckpointSummary[];
+export declare function getCompactionCheckpointDetail(sessionKey: string, checkpointId: string): CompactionCheckpointDetail | null;
+export declare function restoreCompactionCheckpoint(sessionKey: string, checkpointId: string): void;