@xopcai/xopc 0.0.285 → 0.0.291

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

@@ -1,19 +1,15 @@
+import { __esmMin } from "../../../../_virtual/_rolldown/runtime.js";
+import { backupBeforeConversationCutover, init_conversation_backup } from "./conversation-backup.js";
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
-import { readSchemaVersion, setSchemaVersion } from "../schema-version.js";
-import { discoverSqlMigrations } from "./discover.js";
-import { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError } from "./errors.js";
+import { init_schema_version, readSchemaVersion, setSchemaVersion } from "../schema-version.js";
+import { init_conversation_uuid, migrateConversationUuids } from "./conversation-uuid.js";
+import { discoverSqlMigrations, init_discover } from "./discover.js";
+import { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, init_errors } from "./errors.js";
 import { dirname, join } from "node:path";
 import { chmodSync, existsSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/storage/sqlite/migrations/runner.ts
-init_logger();
-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 = 177;
-const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function backupBeforeTaskCutover(db, databasePath) {
 	db.exec("PRAGMA wal_checkpoint(FULL)");
 	const backupPath = `${databasePath}.pre-v100-${Date.now()}.bak`;
@@ -42,8 +38,10 @@ function applySingleMigration(db, migration) {
 	db.exec("BEGIN IMMEDIATE");
 	try {
 		db.exec(migration.sql);
+		const summary = migration.targetVersion === 178 ? migrateConversationUuids(db) : void 0;
 		setSchemaVersion(db, migration.targetVersion);
 		db.exec("COMMIT");
+		return summary;
 	} catch (error) {
 		try {
 			db.exec("ROLLBACK");
@@ -57,19 +55,23 @@ 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 ?? 177;
+	const targetVersion = options.targetVersion ?? 178;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
+	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
 	if (currentVersion >= targetVersion) return currentVersion;
 	const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));
 	let cutoverBackupPath;
+	let conversationSummary;
+	const fromVersion = currentVersion;
+	const conversationBackup = currentVersion < 178 && targetVersion >= 178 && options.databasePath && options.databasePath !== ":memory:" ? backupBeforeConversationCutover(db, options.databasePath) : void 0;
 	while (currentVersion < targetVersion) {
 		const nextVersion = currentVersion + 1;
 		const migration = migrationByTarget(migrations, nextVersion);
 		if (!migration) throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);
 		if (nextVersion === 100 && options.databasePath && options.databasePath !== ":memory:") cutoverBackupPath = backupBeforeTaskCutover(db, options.databasePath);
 		try {
-			applySingleMigration(db, migration);
+			conversationSummary = applySingleMigration(db, migration) ?? conversationSummary;
 		} catch (error) {
 			if (cutoverBackupPath && nextVersion === 100) writeMigrationReport(cutoverBackupPath, {
 				fromVersion: currentVersion,
@@ -79,6 +81,13 @@ function applyPendingMigrations(db, options = {}) {
 				error: error instanceof Error ? error.message : String(error),
 				occurredAt: (/* @__PURE__ */ new Date()).toISOString()
 			});
+			if (conversationBackup) writeMigrationReport(conversationBackup, {
+				fromVersion,
+				targetVersion,
+				failedVersion: nextVersion,
+				status: "failed",
+				error: error instanceof Error ? error.message : String(error)
+			});
 			throw error;
 		}
 		currentVersion = nextVersion;
@@ -90,11 +99,18 @@ function applyPendingMigrations(db, options = {}) {
 			occurredAt: (/* @__PURE__ */ new Date()).toISOString()
 		});
 	}
+	if (conversationBackup) writeMigrationReport(conversationBackup, {
+		fromVersion,
+		targetVersion,
+		status: "succeeded",
+		backupPath: conversationBackup,
+		summary: conversationSummary
+	});
 	return currentVersion;
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 177;
+	const appVersion = options.targetVersion ?? 178;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -123,5 +139,19 @@ function inspectSchemaMigrationStatus(db, options = {}) {
 		missingVersion
 	};
 }
+var log, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, MODULE_DIR;
+var init_runner = __esmMin((() => {
+	init_conversation_backup();
+	init_logger();
+	init_schema_version();
+	init_conversation_uuid();
+	init_discover();
+	init_errors();
+	log = createLogger("Sqlite:Migrations");
+	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
+	XOPC_DB_SCHEMA_VERSION = 178;
+	MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+}));
 //#endregion
-export { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations, inspectSchemaMigrationStatus, resolveMigrationsDir };
+init_runner();
+export { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations, init_runner, inspectSchemaMigrationStatus, resolveMigrationsDir };

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

@@ -9,6 +9,6 @@ export type ApplyMigrationsOptions = {
     migrationsDir?: string;
     /** Target schema version. Defaults to {@link XOPC_DB_SCHEMA_VERSION}. */
     targetVersion?: number;
-    /** Database file path used to create the mandatory pre-v100 backup. */
+    /** Database file path used for mandatory cutover backups. */
     databasePath?: string;
 };

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

@@ -1,5 +1,6 @@
-import { requireXopcDatabase } from "./connection.js";
+import { init_connection, requireXopcDatabase } from "./connection.js";
 //#region src/storage/sqlite/note-agent-context-repository.ts
+init_connection();
 function getNoteAgentContextRecord(noteId) {
 	const row = requireXopcDatabase().db.prepare(`
     SELECT note_id, note_updated_at, context_version, generated_at, payload_json

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

@@ -1,7 +1,9 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { escapeFts5Query } from "./fts.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+import { escapeFts5Query, init_fts } from "./fts.js";
 import { buildNoteIndexMeta, extractAttachmentFileNames, notePlainText } from "../../notes/note-index-meta.js";
 //#region src/storage/sqlite/notes-repository.ts
+init_fts();
+init_transaction();
 function parseTags(json) {
 	try {
 		const parsed = JSON.parse(json);

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

@@ -1,5 +1,9 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { XOPC_DB_FILENAME, init_paths_state, resolveXopcDatabasePath } from "../../config/paths-state.js";
 //#region src/storage/sqlite/paths.ts
-init_paths_state();
+var init_paths = __esmMin((() => {
+	init_paths_state();
+}));
 //#endregion
-export { XOPC_DB_FILENAME, resolveXopcDatabasePath };
+init_paths();
+export { XOPC_DB_FILENAME, init_paths, resolveXopcDatabasePath };

package/dist/src/storage/sqlite/relationship-settings-repository.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { LOCAL_USER_ID } from "../../user-context/owner.js";
 //#region src/storage/sqlite/relationship-settings-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
 		supportMode: row.support_mode,

package/dist/src/storage/sqlite/row-mappers.d.ts

@@ -3,9 +3,9 @@ import type { SessionAgentConfig } from '../../session/config-types.js';
 import { type TranscriptStoredRow } from '../../session/session-context-for-llm.js';
 import { type GlobalSessionStats, type SessionMetadata } from '../../session/types.js';
 export type SessionRow = {
-    session_key: string;
+    conversation_id: string;
     agent_id: string;
-    session_id: string;
+    active_transcript_id: string;
     status: string;
     name: string | null;
     tags_json: string;
@@ -18,7 +18,7 @@ export type SessionRow = {
     source_chat_id: string;
     session_type: string | null;
     hidden_from_session_list: number | null;
-    parent_session_key: string | null;
+    parent_conversation_id: string | null;
     workflow_run_id: string | null;
     workflow_definition_id: string | null;
     workflow_agent_id: string | null;
@@ -37,7 +37,7 @@ export type SessionRow = {
 };
 export type TranscriptEntryRow = {
     entry_id: string;
-    session_id: string;
+    transcript_id: string;
     seq: number;
     entry_kind: string;
     role: string | null;
@@ -45,7 +45,7 @@ export type TranscriptEntryRow = {
     created_at: number;
 };
 export type SessionConfigRow = {
-    session_key: string;
+    conversation_id: string;
     thinking_level: string | null;
     reasoning_level: string | null;
     verbose_level: string | null;
@@ -58,11 +58,11 @@ export type SessionConfigRow = {
     user_context_mode: string | null;
     updated_at: number;
 };
-export declare function sessionRowToMetadata(sessionKey: string, row: SessionRow): SessionMetadata;
-export declare function metadataToSessionInsert(sessionKey: string, sessionId: string, metadata: SessionMetadata, thinkingLevel?: string | null, verboseLevel?: string | null): {
-    sessionKey: string;
+export declare function sessionRowToMetadata(conversationId: string, row: SessionRow): SessionMetadata;
+export declare function metadataToSessionInsert(conversationId: string, transcriptId: string, metadata: SessionMetadata, thinkingLevel?: string | null, verboseLevel?: string | null): {
+    conversationId: string;
     agentId: string;
-    sessionId: string;
+    transcriptId: string;
     status: string;
     name: string | null;
     tagsJson: string;
@@ -75,7 +75,7 @@ export declare function metadataToSessionInsert(sessionKey: string, sessionId: s
     sourceChatId: string;
     sessionType: string;
     hiddenFromSessionList: number;
-    parentSessionKey: string | null;
+    parentConversationId: string | null;
     workflowRunId: string | null;
     workflowDefinitionId: string | null;
     workflowAgentId: string | null;

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

@@ -1,9 +1,8 @@
-import { isTranscriptContextEntry } from "../../session/session-context-for-llm.js";
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { init_session_context_for_llm, isTranscriptContextEntry } from "../../session/session-context-for-llm.js";
 import "../../session/types.js";
-import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
-import { buildDefaultSessionMetadata } from "./session-metadata.js";
+import { buildDefaultSessionMetadata, init_session_metadata } from "./session-metadata.js";
 //#region src/storage/sqlite/row-mappers.ts
-init_agent_session_key();
 function parseJson(raw) {
 	if (!raw?.trim()) return;
 	try {
@@ -16,8 +15,8 @@ function isoFromMs(ms) {
 	if (ms == null || !Number.isFinite(ms)) return;
 	return new Date(ms).toISOString();
 }
-function sessionRowToMetadata(sessionKey, row) {
-	const defaults = buildDefaultSessionMetadata(sessionKey);
+function sessionRowToMetadata(conversationId, row) {
+	const defaults = buildDefaultSessionMetadata(conversationId);
 	const routing = parseJson(row.routing_json);
 	const customData = parseJson(row.custom_data_json);
 	const tags = parseJson(row.tags_json) ?? [];
@@ -26,7 +25,8 @@ function sessionRowToMetadata(sessionKey, row) {
 	const lastAccessedAt = isoFromMs(row.last_accessed_at) ?? defaults.lastAccessedAt;
 	return {
 		...defaults,
-		key: sessionKey,
+		key: conversationId,
+		agentId: row.agent_id,
 		status: row.status,
 		name: row.name ?? void 0,
 		tags,
@@ -39,7 +39,7 @@ function sessionRowToMetadata(sessionKey, row) {
 		sourceChatId: row.source_chat_id,
 		sessionType: row.session_type ?? defaults.sessionType,
 		hiddenFromSessionList: Boolean(row.hidden_from_session_list),
-		parentSessionKey: row.parent_session_key ?? void 0,
+		parentConversationId: row.parent_conversation_id ?? void 0,
 		workflowRunId: row.workflow_run_id ?? void 0,
 		workflowDefinitionId: row.workflow_definition_id ?? void 0,
 		workflowAgentId: row.workflow_agent_id ?? void 0,
@@ -52,7 +52,7 @@ function sessionRowToMetadata(sessionKey, row) {
 		compactedCount: row.compacted_count,
 		lastFlushedAt: row.last_flushed_at ?? void 0,
 		flushCount: row.flush_count,
-		sessionId: row.session_id,
+		transcriptId: row.active_transcript_id,
 		cwd: row.cwd ?? void 0,
 		stats: {
 			messageCount: row.message_count,
@@ -61,12 +61,14 @@ function sessionRowToMetadata(sessionKey, row) {
 		}
 	};
 }
-function metadataToSessionInsert(sessionKey, sessionId, metadata, thinkingLevel, verboseLevel) {
+function metadataToSessionInsert(conversationId, transcriptId, metadata, thinkingLevel, verboseLevel) {
 	const now = Date.now();
+	const agentId = (metadata.agentId || metadata.routing?.agentId)?.trim().toLowerCase();
+	if (!agentId) throw new Error("Creating a conversation requires an explicit agent ID");
 	return {
-		sessionKey,
-		agentId: metadata.routing?.agentId?.trim().toLowerCase() || resolveAgentIdFromSessionKey(sessionKey),
-		sessionId,
+		conversationId,
+		agentId,
+		transcriptId,
 		status: metadata.status,
 		name: metadata.name ?? null,
 		tagsJson: JSON.stringify(metadata.tags ?? []),
@@ -79,7 +81,7 @@ function metadataToSessionInsert(sessionKey, sessionId, metadata, thinkingLevel,
 		sourceChatId: metadata.sourceChatId,
 		sessionType: metadata.sessionType,
 		hiddenFromSessionList: metadata.hiddenFromSessionList ? 1 : 0,
-		parentSessionKey: metadata.parentSessionKey ?? null,
+		parentConversationId: metadata.parentConversationId ?? null,
 		workflowRunId: metadata.workflowRunId ?? null,
 		workflowDefinitionId: metadata.workflowDefinitionId ?? null,
 		workflowAgentId: metadata.workflowAgentId ?? null,
@@ -177,5 +179,10 @@ function buildGlobalSessionStats(sessions) {
 		byChannel
 	};
 }
+var init_row_mappers = __esmMin((() => {
+	init_session_context_for_llm();
+	init_session_metadata();
+}));
 //#endregion
-export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow };
+init_row_mappers();
+export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, init_row_mappers, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow };

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

@@ -1,5 +1,5 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 //#region src/storage/sqlite/schema-version.ts
-const SCHEMA_META_SCHEMA_VERSION_KEY = "schema_version";
 function ensureSchemaMetaTable(db) {
 	db.exec(`
     CREATE TABLE IF NOT EXISTS schema_meta (
@@ -23,5 +23,10 @@ function readSchemaVersionForTest(db) {
 	if (db.prepare(`PRAGMA table_info(schema_meta)`).all().length === 0) return 0;
 	return readSchemaVersion(db);
 }
+var SCHEMA_META_SCHEMA_VERSION_KEY;
+var init_schema_version = __esmMin((() => {
+	SCHEMA_META_SCHEMA_VERSION_KEY = "schema_version";
+}));
 //#endregion
-export { SCHEMA_META_SCHEMA_VERSION_KEY, ensureSchemaMetaTable, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };
+init_schema_version();
+export { SCHEMA_META_SCHEMA_VERSION_KEY, ensureSchemaMetaTable, init_schema_version, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

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

@@ -1,10 +1,10 @@
-import { SCHEMA_META_SCHEMA_VERSION_KEY, ensureSchemaMetaTable, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion } from "./schema-version.js";
-import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations } from "./migrations/runner.js";
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { SCHEMA_META_SCHEMA_VERSION_KEY, ensureSchemaMetaTable, init_schema_version, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion } from "./schema-version.js";
+import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations, init_runner } from "./migrations/runner.js";
 import { dirname, join } from "node:path";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/storage/sqlite/schema.ts
-const SCHEMA_DIR = dirname(fileURLToPath(import.meta.url));
 function readSchemaSql() {
 	return readFileSync(join(SCHEMA_DIR, "schema.sql"), "utf8");
 }
@@ -12,7 +12,7 @@ function bootstrapFreshDatabase(db) {
 	db.exec("BEGIN IMMEDIATE");
 	try {
 		db.exec(readSchemaSql());
-		setSchemaVersion(db, 11);
+		setSchemaVersion(db, 165);
 		db.exec("COMMIT");
 	} catch (error) {
 		try {
@@ -27,14 +27,22 @@ function bootstrapFreshDatabase(db) {
 function ensureXopcDatabaseSchema(db, options = {}) {
 	ensureSchemaMetaTable(db);
 	let currentVersion = readSchemaVersion(db);
+	const fresh = currentVersion === 0;
 	if (currentVersion === 0) {
 		bootstrapFreshDatabase(db);
-		currentVersion = 11;
+		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 177,
-		databasePath: options.databasePath
+		targetVersion: 178,
+		databasePath: fresh ? void 0 : options.databasePath
 	});
 }
+var SCHEMA_DIR;
+var init_schema = __esmMin((() => {
+	init_runner();
+	init_schema_version();
+	SCHEMA_DIR = dirname(fileURLToPath(import.meta.url));
+}));
 //#endregion
-export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };
+init_schema();
+export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, init_schema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };