@xopcai/xopc 0.0.284 → 0.0.286

package/dist/src/storage/sqlite/connection-wait-repository.js

@@ -1,63 +1,61 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { isXopcDatabaseOpen } from "./connection.js";
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { readCurrentSessionId } from "./session-instance-repository.js";
-import { bumpSessionInputRevision, getSessionInputById, getSessionInputState, insertSessionInput, setSessionInputStatus } from "./session-input-repository.js";
-import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { init_connection, isXopcDatabaseOpen } from "./connection.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+import { init_session_instance_repository, readCurrentTranscriptId } from "./session-instance-repository.js";
+import { bumpSessionInputRevision, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput, setSessionInputStatus } from "./session-input-repository.js";
+import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { randomUUID } from "node:crypto";
 import { EventEmitter } from "node:events";
 //#region src/storage/sqlite/connection-wait-repository.ts
-init_logger();
-const log = createLogger("Connectors:Wait");
-const events = new EventEmitter();
 function onConnectionWaitChanged(listener) {
 	events.on("changed", listener);
 	return () => {
 		events.off("changed", listener);
 	};
 }
-function publishConnectionWait(sessionKey) {
-	events.emit("changed", sessionKey);
+function publishConnectionWait(conversationId) {
+	events.emit("changed", conversationId);
 }
 function getConnectionWait(id) {
 	if (!isXopcDatabaseOpen()) return void 0;
 	const row = getSqliteDatabase().prepare("SELECT data_json FROM session_connection_waits WHERE id = ?").get(id);
 	return row ? JSON.parse(row.data_json) : void 0;
 }
-function getActiveConnectionWait(sessionKey) {
+function getActiveConnectionWait(conversationId) {
 	if (!isXopcDatabaseOpen()) return void 0;
 	const db = getSqliteDatabase();
-	const row = db.prepare(`SELECT data_json FROM session_connection_waits WHERE session_key = ? AND session_id = ?
-    AND status IN ('open','queued')`).get(sessionKey, readCurrentSessionId(db, sessionKey) ?? "");
+	const row = db.prepare(`SELECT data_json FROM session_connection_waits WHERE conversation_id = ? AND transcript_id = ?
+    AND status IN ('open','queued')`).get(conversationId, readCurrentTranscriptId(db, conversationId) ?? "");
 	return row ? JSON.parse(row.data_json) : void 0;
 }
-function isConnectionSuspended(sessionKey, runId) {
-	const wait = getActiveConnectionWait(sessionKey);
+function isConnectionSuspended(conversationId, runId) {
+	const wait = getActiveConnectionWait(conversationId);
 	return Boolean(wait && wait.originRunId === runId);
 }
 function updateConnectionWait(wait, expectedVersion) {
 	return runSqliteWriteTransaction((db) => {
-		if (readCurrentSessionId(db, wait.sessionKey) !== wait.sessionId) throw new Error("SESSION_CHANGED");
+		if (readCurrentTranscriptId(db, wait.conversationId) !== wait.transcriptId) throw new Error("SESSION_CHANGED");
 		const next = {
 			...wait,
 			version: expectedVersion + 1,
 			updatedAt: Date.now()
 		};
 		if (!db.prepare(`UPDATE session_connection_waits SET status = ?, version = ?, data_json = ? WHERE id = ? AND version = ?`).run(next.status, next.version, JSON.stringify(next), next.id, expectedVersion).changes) throw new Error("WAIT_CHANGED");
-		bumpSessionInputRevision(db, wait.sessionKey);
+		bumpSessionInputRevision(db, wait.conversationId);
 		return next;
 	});
 }
 function requireSessionConnection(input) {
 	return runSqliteWriteTransaction((db) => {
-		const sessionId = readCurrentSessionId(db, input.sessionKey);
-		const runtime = getSessionInputState(input.sessionKey);
-		const origin = runtime.activeInputId ? getSessionInputById(input.sessionKey, runtime.activeInputId) : void 0;
-		if (!sessionId || !origin || !runtime.activeRunId) throw new Error("Connection recovery requires a queued chat execution.");
+		const transcriptId = readCurrentTranscriptId(db, input.conversationId);
+		const runtime = getSessionInputState(input.conversationId);
+		const origin = runtime.activeInputId ? getSessionInputById(input.conversationId, runtime.activeInputId) : void 0;
+		if (!transcriptId || !origin || !runtime.activeRunId) throw new Error("Connection recovery requires a queued chat execution.");
 		const resumed = origin.payload ? getConnectionWait(origin.payload.waitId) : void 0;
 		if (resumed?.resolution === "skipped") return { status: "skipped" };
-		const active = getActiveConnectionWait(input.sessionKey);
+		const active = getActiveConnectionWait(input.conversationId);
 		if (active) {
 			if (active.originInputId !== origin.id && active.objectiveId !== resumed?.objectiveId) return {
 				status: "objective_conflict",
@@ -80,12 +78,12 @@ function requireSessionConnection(input) {
 				waitId: active.id
 			};
 		}
-		const lastEntry = db.prepare("SELECT entry_id FROM transcript_entries WHERE session_id = ? ORDER BY seq DESC LIMIT 1").get(sessionId);
+		const lastEntry = db.prepare("SELECT entry_id FROM transcript_entries WHERE transcript_id = ? ORDER BY seq DESC LIMIT 1").get(transcriptId);
 		const wait = {
 			...input,
 			needs: [...new Map(input.needs.map((need) => [need.key, need])).values()],
 			id: randomUUID(),
-			sessionId,
+			transcriptId,
 			objectiveId: resumed?.objectiveId ?? origin.id,
 			objectiveRevision: (resumed?.objectiveRevision ?? 0) + 1,
 			objectiveUpdatedAt: resumed?.objectiveUpdatedAt ?? origin.createdAtMs,
@@ -104,7 +102,7 @@ function requireSessionConnection(input) {
 			createdAt: Date.now(),
 			updatedAt: Date.now()
 		};
-		db.prepare(`INSERT INTO session_connection_waits(id,principal_id,session_key,session_id,status,version,data_json) VALUES (?,?,?,?,?,?,?)`).run(wait.id, wait.principalId, wait.sessionKey, wait.sessionId, wait.status, wait.version, JSON.stringify(wait));
+		db.prepare(`INSERT INTO session_connection_waits(id,principal_id,conversation_id,transcript_id,status,version,data_json) VALUES (?,?,?,?,?,?,?)`).run(wait.id, wait.principalId, wait.conversationId, wait.transcriptId, wait.status, wait.version, JSON.stringify(wait));
 		if (wait.taskRunId) {
 			const runs = new TaskRunRepository();
 			const run = runs.get(wait.taskRunId);
@@ -128,9 +126,9 @@ function requireSessionConnection(input) {
 				});
 			}
 		}
-		bumpSessionInputRevision(db, wait.sessionKey);
+		bumpSessionInputRevision(db, wait.conversationId);
 		log.info({
-			sessionKey: wait.sessionKey,
+			conversationId: wait.conversationId,
 			waitId: wait.id,
 			objectiveRevision: wait.objectiveRevision,
 			runId: wait.originRunId,
@@ -147,12 +145,12 @@ function queueConnectionResolution(wait, resolution) {
 	return runSqliteWriteTransaction(() => {
 		const current = getConnectionWait(wait.id);
 		if (!current || current.version !== wait.version || current.status !== "open") throw new Error("WAIT_CHANGED");
-		const origin = getSessionInputById(wait.sessionKey, wait.originInputId);
+		const origin = getSessionInputById(wait.conversationId, wait.originInputId);
 		if (!origin) throw new Error("Original input is unavailable.");
 		const input = insertSessionInput({
 			id: randomUUID(),
-			sessionKey: wait.sessionKey,
-			expectedSessionId: wait.sessionId,
+			conversationId: wait.conversationId,
+			expectedTranscriptId: wait.transcriptId,
 			clientMessageId: `connection:${wait.id}:${wait.objectiveRevision}:${resolution}`,
 			requestedDelivery: "next",
 			effectiveDelivery: "next",
@@ -186,7 +184,7 @@ function consumeConnectionResume(input) {
 	return runSqliteWriteTransaction(() => {
 		const wait = input.payload ? getConnectionWait(input.payload.waitId) : void 0;
 		if (!wait || wait.status !== "queued" || wait.queuedInputId !== input.id || wait.objectiveRevision !== input.payload?.objectiveRevision) return false;
-		if (readCurrentSessionId(getSqliteDatabase(), input.sessionKey) !== wait.sessionId) return false;
+		if (readCurrentTranscriptId(getSqliteDatabase(), input.conversationId) !== wait.transcriptId) return false;
 		if (wait.taskRunId) {
 			const runs = new TaskRunRepository();
 			const run = runs.get(wait.taskRunId);
@@ -222,19 +220,19 @@ function consumeConnectionResume(input) {
 		return true;
 	});
 }
-function connectionBindings(sessionKey) {
+function connectionBindings(conversationId) {
 	if (!isXopcDatabaseOpen()) return [];
-	const state = getSessionInputState(sessionKey);
-	const input = state.activeInputId ? getSessionInputById(sessionKey, state.activeInputId) : void 0;
+	const state = getSessionInputState(conversationId);
+	const input = state.activeInputId ? getSessionInputById(conversationId, state.activeInputId) : void 0;
 	return input?.payload ? getConnectionWait(input.payload.waitId)?.needs ?? [] : [];
 }
-function connectionBinding(sessionKey, connectorId) {
-	const matches = connectionBindings(sessionKey).filter((need) => need.connectorId === connectorId);
+function connectionBinding(conversationId, connectorId) {
+	const matches = connectionBindings(conversationId).filter((need) => need.connectorId === connectorId);
 	return matches.length === 1 ? matches[0].connectionId : void 0;
 }
 /** New input wins over an outstanding auto-resume intent, including an already queued resume. */
-function invalidateConnectionResumeIntent(sessionKey) {
-	const wait = getActiveConnectionWait(sessionKey);
+function invalidateConnectionResumeIntent(conversationId) {
+	const wait = getActiveConnectionWait(conversationId);
 	if (!wait) return;
 	runSqliteWriteTransaction(() => {
 		if (wait.queuedInputId) setSessionInputStatus(wait.queuedInputId, "cancelled");
@@ -248,13 +246,13 @@ function invalidateConnectionResumeIntent(sessionKey) {
 			reviewRequired: true
 		}, wait.version);
 	});
-	publishConnectionWait(sessionKey);
+	publishConnectionWait(conversationId);
 }
-function reviseCurrentConnectionObjective(sessionKey, summary) {
-	const wait = getActiveConnectionWait(sessionKey);
+function reviseCurrentConnectionObjective(conversationId, summary) {
+	const wait = getActiveConnectionWait(conversationId);
 	if (!wait) throw new Error("No connection objective is waiting.");
 	if (!summary) {
-		cancelConnectionObjective(sessionKey);
+		cancelConnectionObjective(conversationId);
 		return;
 	}
 	runSqliteWriteTransaction(() => {
@@ -277,10 +275,10 @@ function reviseCurrentConnectionObjective(sessionKey, summary) {
 			objectiveRevision: wait.objectiveRevision + 1
 		}, wait.version);
 	});
-	publishConnectionWait(sessionKey);
+	publishConnectionWait(conversationId);
 }
-function cancelConnectionObjective(sessionKey) {
-	const wait = getActiveConnectionWait(sessionKey);
+function cancelConnectionObjective(conversationId) {
+	const wait = getActiveConnectionWait(conversationId);
 	if (!wait) return;
 	runSqliteWriteTransaction(() => {
 		if (wait.queuedInputId) setSessionInputStatus(wait.queuedInputId, "cancelled");
@@ -319,20 +317,32 @@ function cancelConnectionObjective(sessionKey) {
 			intent: void 0
 		}, wait.version);
 	});
-	publishConnectionWait(sessionKey);
+	publishConnectionWait(conversationId);
 }
-function getConnectionResumeInput(sessionKey, runId) {
+function getConnectionResumeInput(conversationId, runId) {
 	if (!isXopcDatabaseOpen()) return void 0;
-	const state = getSessionInputState(sessionKey);
+	const state = getSessionInputState(conversationId);
 	if (state.activeRunId !== runId || !state.activeInputId) return void 0;
-	const input = getSessionInputById(sessionKey, state.activeInputId);
+	const input = getSessionInputById(conversationId, state.activeInputId);
 	return input?.kind === "connection_resume" ? input : void 0;
 }
 function listConnectionWaitsToCheck() {
 	if (!isXopcDatabaseOpen()) return [];
 	return getSqliteDatabase().prepare(`SELECT wait.data_json FROM session_connection_waits wait
-    JOIN sessions session ON session.session_id = wait.session_id
+    JOIN sessions session ON session.active_transcript_id = wait.transcript_id
     WHERE wait.status = 'open'`).all().map((row) => JSON.parse(row.data_json)).filter((wait) => wait.principalId === "local-owner" && wait.intent && wait.intent.validUntil > Date.now());
 }
+var log, events;
+var init_connection_wait_repository = __esmMin((() => {
+	init_logger();
+	init_task_run_repository();
+	init_connection();
+	init_transaction();
+	init_session_instance_repository();
+	init_session_input_repository();
+	log = createLogger("Connectors:Wait");
+	events = new EventEmitter();
+}));
 //#endregion
-export { cancelConnectionObjective, connectionBinding, connectionBindings, consumeConnectionResume, getActiveConnectionWait, getConnectionResumeInput, getConnectionWait, invalidateConnectionResumeIntent, isConnectionSuspended, listConnectionWaitsToCheck, onConnectionWaitChanged, publishConnectionWait, queueConnectionResolution, requireSessionConnection, reviseCurrentConnectionObjective, updateConnectionWait };
+init_connection_wait_repository();
+export { cancelConnectionObjective, connectionBinding, connectionBindings, consumeConnectionResume, getActiveConnectionWait, getConnectionResumeInput, getConnectionWait, init_connection_wait_repository, invalidateConnectionResumeIntent, isConnectionSuspended, listConnectionWaitsToCheck, onConnectionWaitChanged, publishConnectionWait, queueConnectionResolution, requireSessionConnection, reviseCurrentConnectionObjective, updateConnectionWait };

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

@@ -1,26 +1,15 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { resolveXopcDatabasePath } from "../../config/paths-state.js";
+import { init_paths } from "./paths.js";
+import { init_node_sqlite, requireNodeSqlite } from "../../infra/node-sqlite.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, init_schema } from "./schema.js";
+import { init_unhandled_rejections, installSqliteTransientRejectionHandler } from "../../infra/unhandled-rejections.js";
 import path from "node:path";
 import fs from "node:fs";
 import childProcess from "node:child_process";
 //#region src/storage/sqlite/connection.ts
-init_logger();
-const log = createLogger("Sqlite:Connection");
-const XOPC_SQLITE_BUSY_TIMEOUT_MS = 3e4;
-const DB_DIR_MODE = 448;
-const DB_FILE_MODE = 384;
-const DB_SIDECAR_SUFFIXES = [
-	"",
-	"-shm",
-	"-wal"
-];
-const LINUX_NFS_SUPER_MAGIC = 26985;
-const PROC_MOUNTINFO_PATH = "/proc/self/mountinfo";
-const MAX_TIMER_TIMEOUT_MS = 2 ** 31 - 1;
 function normalizeNonNegativeInteger(value, label) {
 	if (!Number.isInteger(value) || value < 0) throw new Error(`${label} must be a non-negative integer`);
 	return value;
@@ -152,7 +141,6 @@ function configureSqliteConnectionPragmas(db, options = {}) {
 		}
 	};
 }
-let cachedDatabase = null;
 function ensureDatabasePermissions(pathname) {
 	const dir = pathname.slice(0, Math.max(pathname.lastIndexOf("/"), pathname.lastIndexOf("\\")));
 	if (dir) {
@@ -255,5 +243,27 @@ function closeXopcDatabase() {
 function resetXopcDatabaseSingletonForTest() {
 	cachedDatabase = null;
 }
+var log, XOPC_SQLITE_BUSY_TIMEOUT_MS, DB_DIR_MODE, DB_FILE_MODE, DB_SIDECAR_SUFFIXES, LINUX_NFS_SUPER_MAGIC, PROC_MOUNTINFO_PATH, MAX_TIMER_TIMEOUT_MS, cachedDatabase;
+var init_connection = __esmMin((() => {
+	init_node_sqlite();
+	init_unhandled_rejections();
+	init_logger();
+	init_paths();
+	init_schema();
+	log = createLogger("Sqlite:Connection");
+	XOPC_SQLITE_BUSY_TIMEOUT_MS = 3e4;
+	DB_DIR_MODE = 448;
+	DB_FILE_MODE = 384;
+	DB_SIDECAR_SUFFIXES = [
+		"",
+		"-shm",
+		"-wal"
+	];
+	LINUX_NFS_SUPER_MAGIC = 26985;
+	PROC_MOUNTINFO_PATH = "/proc/self/mountinfo";
+	MAX_TIMER_TIMEOUT_MS = 2 ** 31 - 1;
+	cachedDatabase = null;
+}));
 //#endregion
-export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest };
+init_connection();
+export { closeXopcDatabase, getXopcDatabase, init_connection, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest };

package/dist/src/storage/sqlite/connector-account-repository.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 //#region src/storage/sqlite/connector-account-repository.ts
+init_transaction();
 function parseIdentity(value) {
 	try {
 		const parsed = JSON.parse(value);

package/dist/src/storage/sqlite/connector-learning-repository.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/connector-learning-repository.ts
+init_transaction();
 function iso(value) {
 	return value == null ? void 0 : new Date(value).toISOString();
 }

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

@@ -10,7 +10,7 @@ export declare function createConnectorApproval(input: Omit<ConnectorApprovalRec
 export declare function getConnectorApproval(id: string): ConnectorApprovalRecord | undefined;
 export declare function listConnectorApprovals(options?: {
     principalId?: string;
-    sessionKey?: string;
+    conversationId?: string;
     status?: ConnectorApprovalRecord['status'];
     limit?: number;
 }): ConnectorApprovalRecord[];

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

@@ -1,6 +1,7 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/connector-repository.ts
+init_transaction();
 function parseStringArray(value) {
 	try {
 		const parsed = JSON.parse(value);
@@ -72,7 +73,7 @@ function auditFromRow(row) {
 		connectorId: row.connector_id,
 		principalId: row.principal_id,
 		agentId: row.agent_id ?? void 0,
-		sessionKey: row.session_key ?? void 0,
+		conversationId: row.conversation_id ?? void 0,
 		actionId: row.action_id,
 		scope: row.scope,
 		decision: row.decision,
@@ -104,7 +105,7 @@ function approvalFromRow(row) {
 		connectorId: row.connector_id,
 		connectionId: row.connection_id ?? void 0,
 		agentId: row.agent_id ?? void 0,
-		sessionKey: row.session_key ?? void 0,
+		conversationId: row.conversation_id ?? void 0,
 		actionId: row.action_id,
 		scope: row.scope,
 		argumentsHash: row.arguments_hash,
@@ -126,11 +127,11 @@ function createConnectorApproval(input) {
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`
       INSERT INTO connector_approvals (
-        id, principal_id, connector_id, connection_id, agent_id, session_key, action_id,
+        id, principal_id, connector_id, connection_id, agent_id, conversation_id, action_id,
         scope, arguments_hash, arguments_preview_json, status, expires_at, created_at,
         decided_at, consumed_at
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(record.id, record.principalId, record.connectorId, record.connectionId ?? null, record.agentId ?? null, record.sessionKey ?? null, record.actionId, record.scope, record.argumentsHash, JSON.stringify(record.argumentsPreview), record.status, record.expiresAt, record.createdAt, record.decidedAt ?? null, record.consumedAt ?? null);
+    `).run(record.id, record.principalId, record.connectorId, record.connectionId ?? null, record.agentId ?? null, record.conversationId ?? null, record.actionId, record.scope, record.argumentsHash, JSON.stringify(record.argumentsPreview), record.status, record.expiresAt, record.createdAt, record.decidedAt ?? null, record.consumedAt ?? null);
 	});
 	return record;
 }
@@ -145,9 +146,9 @@ function listConnectorApprovals(options = {}) {
 		clauses.push("principal_id = ?");
 		values.push(options.principalId);
 	}
-	if (options.sessionKey) {
-		clauses.push("session_key = ?");
-		values.push(options.sessionKey);
+	if (options.conversationId) {
+		clauses.push("conversation_id = ?");
+		values.push(options.conversationId);
 	}
 	if (options.status) {
 		clauses.push("status = ?");
@@ -335,9 +336,9 @@ function appendConnectorExecutionAudit(input) {
 		db.prepare(`
       INSERT INTO connector_execution_audit (
         id, installation_id, connection_id, connector_id, principal_id, agent_id,
-        session_key, action_id, scope, decision, result_status, duration_ms, error_code, created_at
+        conversation_id, action_id, scope, decision, result_status, duration_ms, error_code, created_at
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(record.id, record.installationId ?? null, record.connectionId ?? null, record.connectorId, record.principalId, record.agentId ?? null, record.sessionKey ?? null, record.actionId, record.scope, record.decision, record.resultStatus, record.durationMs ?? null, record.errorCode ?? null, record.createdAt);
+    `).run(record.id, record.installationId ?? null, record.connectionId ?? null, record.connectorId, record.principalId, record.agentId ?? null, record.conversationId ?? null, record.actionId, record.scope, record.decision, record.resultStatus, record.durationMs ?? null, record.errorCode ?? null, record.createdAt);
 	});
 	return record;
 }

package/dist/src/storage/sqlite/connector-sync-policy-repository.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 //#region src/storage/sqlite/connector-sync-policy-repository.ts
+init_transaction();
 function stringArray(value) {
 	try {
 		const parsed = JSON.parse(value);

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

@@ -5,7 +5,7 @@ export interface ContextEvidence {
     sourceRef: string;
     sourceRunId?: string;
     sourceItemId?: string;
-    sessionId?: string;
+    conversationId?: string;
     turnId?: string;
     messageId?: string;
     contentHash?: string;

package/dist/src/storage/sqlite/context-evidence-repository.js

@@ -1,7 +1,8 @@
-import { getSqliteDatabase } from "./transaction.js";
+import { getSqliteDatabase, init_transaction } from "./transaction.js";
 import { USER_MODEL_PRINCIPAL_ID } from "../../user-model/domain.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/storage/sqlite/context-evidence-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
 		id: row.evidence_id,
@@ -10,7 +11,7 @@ function fromRow(row) {
 		sourceRef: row.source_ref,
 		...row.source_run_id ? { sourceRunId: row.source_run_id } : {},
 		...row.source_item_id ? { sourceItemId: row.source_item_id } : {},
-		...row.session_id ? { sessionId: row.session_id } : {},
+		...row.conversation_id ? { conversationId: row.conversation_id } : {},
 		...row.turn_id ? { turnId: row.turn_id } : {},
 		...row.message_id ? { messageId: row.message_id } : {},
 		...row.content_hash ? { contentHash: row.content_hash } : {},
@@ -32,20 +33,20 @@ function createContextEvidence(input, principalId = USER_MODEL_PRINCIPAL_ID) {
 	const contentHash = input.contentHash ?? (input.redactedExcerpt ? createHash("sha256").update(input.redactedExcerpt).digest("hex") : void 0);
 	if (existing) {
 		db.prepare(`UPDATE context_evidence SET
-      source_run_id = ?, source_item_id = ?, session_id = ?, turn_id = ?, message_id = ?,
+      source_run_id = ?, source_item_id = ?, conversation_id = ?, turn_id = ?, message_id = ?,
       content_hash = ?, retention_policy = ?, processing_policy = ?, extractor_id = ?,
       extractor_version = ?, redacted_excerpt = ?, trust_level = ?, observed_at = ?, ingested_at = ?
-      WHERE evidence_id = ?`).run(input.sourceRunId ?? null, input.sourceItemId ?? null, input.sessionId ?? null, input.turnId ?? null, input.messageId ?? null, contentHash ?? null, input.retentionPolicy ?? null, input.processingPolicy ?? null, input.extractorId ?? null, input.extractorVersion ?? null, input.redactedExcerpt ?? null, input.trustLevel, input.observedAt, input.ingestedAt ?? Date.now(), existing.evidence_id);
+      WHERE evidence_id = ?`).run(input.sourceRunId ?? null, input.sourceItemId ?? null, input.conversationId ?? null, input.turnId ?? null, input.messageId ?? null, contentHash ?? null, input.retentionPolicy ?? null, input.processingPolicy ?? null, input.extractorId ?? null, input.extractorVersion ?? null, input.redactedExcerpt ?? null, input.trustLevel, input.observedAt, input.ingestedAt ?? Date.now(), existing.evidence_id);
 		return fromRow(db.prepare("SELECT * FROM context_evidence WHERE evidence_id = ?").get(existing.evidence_id));
 	}
 	const createdAt = Date.now();
 	const id = randomUUID();
 	db.prepare(`INSERT INTO context_evidence (
     evidence_id, principal_id, source_type, source_instance_id, source_ref, source_run_id,
-    source_item_id, session_id, turn_id, message_id, content_hash, retention_policy,
+    source_item_id, conversation_id, turn_id, message_id, content_hash, retention_policy,
     processing_policy, extractor_id, extractor_version, redacted_excerpt, trust_level,
     observed_at, ingested_at, created_at
-  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, principalId, input.sourceType, input.sourceInstanceId ?? null, input.sourceRef, input.sourceRunId ?? null, input.sourceItemId ?? null, input.sessionId ?? null, input.turnId ?? null, input.messageId ?? null, contentHash ?? null, input.retentionPolicy ?? null, input.processingPolicy ?? null, input.extractorId ?? null, input.extractorVersion ?? null, input.redactedExcerpt ?? null, input.trustLevel, input.observedAt, input.ingestedAt ?? createdAt, createdAt);
+  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, principalId, input.sourceType, input.sourceInstanceId ?? null, input.sourceRef, input.sourceRunId ?? null, input.sourceItemId ?? null, input.conversationId ?? null, input.turnId ?? null, input.messageId ?? null, contentHash ?? null, input.retentionPolicy ?? null, input.processingPolicy ?? null, input.extractorId ?? null, input.extractorVersion ?? null, input.redactedExcerpt ?? null, input.trustLevel, input.observedAt, input.ingestedAt ?? createdAt, createdAt);
 	return fromRow(db.prepare("SELECT * FROM context_evidence WHERE evidence_id = ?").get(id));
 }
 //#endregion

package/dist/src/storage/sqlite/context-extraction-repository.js

@@ -1,7 +1,8 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import "../../user-context/domain.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/context-extraction-repository.ts
+init_transaction();
 function runFromRow(row) {
 	return {
 		id: row.extraction_run_id,

package/dist/src/storage/sqlite/context-relation-repository.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase } from "./transaction.js";
+import { getSqliteDatabase, init_transaction } from "./transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/context-relation-repository.ts
+init_transaction();
 function relationFromRow(row) {
 	return {
 		id: row.relation_id,

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

@@ -0,0 +1,12 @@
+import { type ConversationRouteInput } from '../../routing/conversation-route.js';
+import type { SessionMetadata, SessionRoutingMeta } from '../../session/types.js';
+import type { SessionMetadataSeed } from './session-metadata.js';
+export declare class ConversationAlreadyExistsError extends Error {
+}
+export declare function createConversation(input: SessionMetadataSeed & {
+    agentId: string;
+}, cwd?: string, conversationId?: string): SessionMetadata;
+export declare function requireConversation(conversationId: string): SessionMetadata;
+export declare function getConversationRouting(conversationId: string | null | undefined): SessionRoutingMeta | null;
+/** Resolves an external route and creates its conversation atomically when absent. */
+export declare function resolveRoutedConversation(input: ConversationRouteInput, seed?: SessionMetadataSeed): string;

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

@@ -0,0 +1,76 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { conversationRouteKey, init_conversation_route, resolveConversationRoute } from "../../routing/conversation-route.js";
+import { init_connection, requireXopcDatabase } from "./connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+import { validateConversationId } from "../../../packages/gateway-contract/src/conversation-identity.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { ensureSessionInTransaction, getSessionMetadata, init_session_repository } from "./session-repository.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/conversation-repository.ts
+function createConversation(input, cwd = "", conversationId = randomUUID()) {
+	requireXopcDatabase();
+	return runSqliteWriteTransaction((db) => {
+		const id = validateConversationId(conversationId);
+		if (getSessionMetadata(id)) throw new ConversationAlreadyExistsError(`Conversation already exists: ${id}`);
+		return ensureSessionInTransaction(db, id, cwd, input);
+	});
+}
+function requireConversation(conversationId) {
+	const id = validateConversationId(conversationId);
+	requireXopcDatabase();
+	const metadata = getSessionMetadata(id);
+	if (!metadata) throw new Error(`Conversation not found: ${id}`);
+	return metadata;
+}
+function getConversationRouting(conversationId) {
+	if (!conversationId) return null;
+	const conversation = requireConversation(conversationId);
+	return {
+		source: conversation.sourceChannel,
+		accountId: "default",
+		peerKind: "direct",
+		peerId: conversation.sourceChatId,
+		...conversation.routing,
+		agentId: conversation.agentId
+	};
+}
+/** Resolves an external route and creates its conversation atomically when absent. */
+function resolveRoutedConversation(input, seed = {}) {
+	const route = resolveConversationRoute(input);
+	const lookup = conversationRouteKey(route);
+	requireXopcDatabase();
+	return runSqliteWriteTransaction((db) => {
+		const existing = db.prepare("SELECT conversation_id FROM conversation_routes WHERE route_key=?").get(lookup);
+		if (existing) return existing.conversation_id;
+		const id = randomUUID();
+		ensureSessionInTransaction(db, id, "", {
+			...seed,
+			agentId: route.agentId,
+			sourceChannel: input.source,
+			sourceChatId: input.peerId,
+			routing: {
+				agentId: route.agentId,
+				source: input.source,
+				accountId: input.accountId ?? "default",
+				peerKind: input.peerKind === "dm" ? "direct" : input.peerKind,
+				peerId: input.peerId,
+				threadId: input.threadId ?? void 0,
+				scopeId: input.scopeId ?? void 0
+			}
+		});
+		db.prepare("INSERT INTO conversation_routes(route_key,conversation_id) VALUES (?,?)").run(lookup, id);
+		return id;
+	});
+}
+var ConversationAlreadyExistsError;
+var init_conversation_repository = __esmMin((() => {
+	init_src();
+	init_conversation_route();
+	init_connection();
+	init_session_repository();
+	init_transaction();
+	ConversationAlreadyExistsError = class extends Error {};
+}));
+//#endregion
+init_conversation_repository();
+export { ConversationAlreadyExistsError, createConversation, getConversationRouting, init_conversation_repository, requireConversation, resolveRoutedConversation };

package/dist/src/storage/sqlite/device-access-repository.js

@@ -1,8 +1,11 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { initialDeviceRefreshTokenSchema } from "../../../packages/gateway-contract/src/device-pairing.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { parseGatewayScopes } from "../../gateway/security/gateway-scopes.js";
 import crypto from "node:crypto";
 //#region src/storage/sqlite/device-access-repository.ts
+init_src();
+init_transaction();
 const ACCESS_TOKEN_TTL_MS = 900 * 1e3;
 const REFRESH_TOKEN_TTL_MS = 2160 * 60 * 60 * 1e3;
 const REFRESH_PROOF_MAX_AGE_MS = 300 * 1e3;

package/dist/src/storage/sqlite/device-pairing-approval.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { buildDevicePairingProof, devicePairingCompleteSchema, devicePairingDeviceSchema } from "../../../packages/gateway-contract/src/device-pairing.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { DEFAULT_BROWSER_EXTENSION_SCOPES, DEFAULT_MOBILE_SCOPES } from "../../gateway/security/gateway-scopes.js";
 import { createDevice, getDevice, registerInitialDeviceRefreshToken, revokeDevice } from "./device-access-repository.js";
 import { getOrCreateGatewayIdentity } from "./gateway-identity-repository.js";
@@ -7,6 +8,8 @@ import { browserEnrollmentPublicKeyThumbprint } from "../../browser/enrollment.j
 import "../../browser/extension-identity.js";
 import crypto from "node:crypto";
 //#region src/storage/sqlite/device-pairing-approval.ts
+init_src();
+init_transaction();
 const PROOF_WINDOW_MS = 5 * 6e4;
 const RECOVERY_WINDOW_MS = 1440 * 6e4;
 var DevicePairingError = class extends Error {

package/dist/src/storage/sqlite/device-pairing-repository.js

@@ -1,6 +1,7 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import crypto from "node:crypto";
 //#region src/storage/sqlite/device-pairing-repository.ts
+init_transaction();
 const PAIRING_TOKEN_PREFIX = "xopc_pair_";
 const PAIRING_TTL_MS = 600 * 1e3;
 const PAIRING_ATTEMPTS = 5;

package/dist/src/storage/sqlite/durable-queue.js

@@ -1,7 +1,9 @@
-import { requireXopcDatabase } from "./connection.js";
-import { runSqliteWriteTransaction } from "./transaction.js";
+import { init_connection, requireXopcDatabase } from "./connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/storage/sqlite/durable-queue.ts
+init_connection();
+init_transaction();
 var DurableQueue = class {
 	constructor(queue, scope) {
 		this.queue = queue;