@xopcai/xopc 0.0.285 → 0.0.291

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

@@ -1,6 +1,8 @@
-import { requireXopcDatabase } from "./connection.js";
-import { runSqliteWriteTransaction } from "./transaction.js";
+import { init_connection, requireXopcDatabase } from "./connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 //#region src/storage/sqlite/durable-state.ts
+init_connection();
+init_transaction();
 /** Small namespaced extension/runtime documents. Domain histories use dedicated tables. */
 var DurableState = class {
 	constructor(namespace, scope = "") {

package/dist/src/storage/sqlite/endpoint-principal-repository.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 //#region src/storage/sqlite/endpoint-principal-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
 		id: row.id,

package/dist/src/storage/sqlite/endpoint-session-binding-repository.d.ts

@@ -1,9 +1,9 @@
 export interface StoredEndpointSessionBinding {
-    sessionKey: string;
+    conversationId: string;
     endpointId: string;
     boundAt: number;
 }
-export declare function getEndpointSessionBinding(sessionKey: string): StoredEndpointSessionBinding | undefined;
+export declare function getEndpointSessionBinding(conversationId: string): StoredEndpointSessionBinding | undefined;
 export declare function setEndpointSessionBinding(binding: StoredEndpointSessionBinding): StoredEndpointSessionBinding;
-export declare function deleteEndpointSessionBinding(sessionKey: string): boolean;
+export declare function deleteEndpointSessionBinding(conversationId: string): boolean;
 export declare function deleteEndpointSessionBindingsByPrincipal(principalId: string): number;

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

@@ -1,32 +1,33 @@
-import { getSqliteDatabase } from "./transaction.js";
+import { getSqliteDatabase, init_transaction } from "./transaction.js";
 //#region src/storage/sqlite/endpoint-session-binding-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
-		sessionKey: row.session_key,
+		conversationId: row.conversation_id,
 		endpointId: row.endpoint_id,
 		boundAt: row.bound_at
 	};
 }
-function getEndpointSessionBinding(sessionKey) {
+function getEndpointSessionBinding(conversationId) {
 	const row = getSqliteDatabase().prepare(`
-    SELECT session_key, endpoint_id, bound_at
+    SELECT conversation_id, endpoint_id, bound_at
     FROM endpoint_session_bindings
-    WHERE session_key = ?
-  `).get(sessionKey);
+    WHERE conversation_id = ?
+  `).get(conversationId);
 	return row ? fromRow(row) : void 0;
 }
 function setEndpointSessionBinding(binding) {
 	getSqliteDatabase().prepare(`
-    INSERT INTO endpoint_session_bindings (session_key, endpoint_id, bound_at)
+    INSERT INTO endpoint_session_bindings (conversation_id, endpoint_id, bound_at)
     VALUES (?, ?, ?)
-    ON CONFLICT(session_key) DO UPDATE SET
+    ON CONFLICT(conversation_id) DO UPDATE SET
       endpoint_id = excluded.endpoint_id,
       bound_at = excluded.bound_at
-  `).run(binding.sessionKey, binding.endpointId, binding.boundAt);
+  `).run(binding.conversationId, binding.endpointId, binding.boundAt);
 	return binding;
 }
-function deleteEndpointSessionBinding(sessionKey) {
-	return getSqliteDatabase().prepare("DELETE FROM endpoint_session_bindings WHERE session_key = ?").run(sessionKey).changes > 0;
+function deleteEndpointSessionBinding(conversationId) {
+	return getSqliteDatabase().prepare("DELETE FROM endpoint_session_bindings WHERE conversation_id = ?").run(conversationId).changes > 0;
 }
 function deleteEndpointSessionBindingsByPrincipal(principalId) {
 	return Number(getSqliteDatabase().prepare(`

package/dist/src/storage/sqlite/endpoint-tool-invocation-repository.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase } from "./transaction.js";
+import { getSqliteDatabase, init_transaction } from "./transaction.js";
 //#region src/storage/sqlite/endpoint-tool-invocation-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
 		id: row.id,

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

@@ -1,3 +1,4 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 //#region src/storage/sqlite/fts.ts
 /** Quote a user query for FTS5 phrase/prefix-safe matching. */
 function escapeFts5Query(raw) {
@@ -5,39 +6,6 @@ function escapeFts5Query(raw) {
 	if (!trimmed) return "";
 	return `"${trimmed.replace(/"/g, "\"\"")}"`;
 }
-const FTS_SEARCH_STOP_WORDS = new Set([
-	"a",
-	"an",
-	"and",
-	"are",
-	"can",
-	"did",
-	"do",
-	"does",
-	"for",
-	"how",
-	"i",
-	"in",
-	"is",
-	"it",
-	"me",
-	"my",
-	"of",
-	"on",
-	"or",
-	"the",
-	"to",
-	"was",
-	"what",
-	"when",
-	"where",
-	"which",
-	"who",
-	"why",
-	"with",
-	"you",
-	"your"
-]);
 /** Build a syntax-safe, recall-oriented query for natural-language memory search. */
 function buildFts5SearchQuery(raw) {
 	const terms = raw.normalize("NFKC").match(/[\p{L}\p{N}_]+/gu)?.map((term) => term.toLowerCase()).filter((term) => term.length > 1 && !FTS_SEARCH_STOP_WORDS.has(term));
@@ -55,5 +23,42 @@ function fts5RankToScore(rank, bestRank, worstRank) {
 	const normalized = (worstRank - rank) / (worstRank - bestRank);
 	return .5 + .5 * Math.max(0, Math.min(1, normalized));
 }
+var FTS_SEARCH_STOP_WORDS;
+var init_fts = __esmMin((() => {
+	FTS_SEARCH_STOP_WORDS = new Set([
+		"a",
+		"an",
+		"and",
+		"are",
+		"can",
+		"did",
+		"do",
+		"does",
+		"for",
+		"how",
+		"i",
+		"in",
+		"is",
+		"it",
+		"me",
+		"my",
+		"of",
+		"on",
+		"or",
+		"the",
+		"to",
+		"was",
+		"what",
+		"when",
+		"where",
+		"which",
+		"who",
+		"why",
+		"with",
+		"you",
+		"your"
+	]);
+}));
 //#endregion
-export { buildFts5SearchQuery, escapeFts5Query, fts5RankToScore };
+init_fts();
+export { buildFts5SearchQuery, escapeFts5Query, fts5RankToScore, init_fts };

package/dist/src/storage/sqlite/gateway-identity-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/gateway-identity-repository.ts
+init_transaction();
 function fromRow(row) {
 	return {
 		id: row.gateway_id,

package/dist/src/storage/sqlite/home-attention-repository.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 //#region src/storage/sqlite/home-attention-repository.ts
+init_transaction();
 function acknowledgeHomeAttention(subjectKind, subjectId, acknowledgedAt = Date.now()) {
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`

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

@@ -1,6 +1,7 @@
-import { requireXopcDatabase } from "./connection.js";
+import { init_connection, requireXopcDatabase } from "./connection.js";
 import { ImportError } from "../../imports/types.js";
 //#region src/storage/sqlite/import-repository.ts
+init_connection();
 var ImportRepository = class {
 	constructor(owner) {
 		this.owner = owner;

package/dist/src/storage/sqlite/import-selection-repository.js

@@ -1,6 +1,7 @@
-import { requireXopcDatabase } from "./connection.js";
+import { init_connection, requireXopcDatabase } from "./connection.js";
 import { ImportError } from "../../imports/types.js";
 //#region src/storage/sqlite/import-selection-repository.ts
+init_connection();
 var ImportSelectionRepository = class {
 	constructor(owner) {
 		this.owner = owner;

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

@@ -1,7 +1,7 @@
 export { resolveXopcDatabasePath, XOPC_DB_FILENAME } from './paths.js';
 export { XOPC_DB_SCHEMA_VERSION, XOPC_DB_BASELINE_SCHEMA_VERSION, SCHEMA_META_SCHEMA_VERSION_KEY, ensureXopcDatabaseSchema, readSchemaVersionForTest, readSchemaVersion, } from './schema.js';
 export { applyPendingMigrations, inspectSchemaMigrationStatus, resolveMigrationsDir, type SchemaMigrationStatus, } from './migrations/runner.js';
-export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './migrations/errors.js';
+export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, } from './migrations/errors.js';
 export { discoverSqlMigrations, listRegisteredMigrationTargets } from './migrations/discover.js';
 export { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest, type OpenXopcDatabaseOptions, type XopcDatabase, } from './connection.js';
 export { getSqliteDatabase, runSqliteWriteTransaction } from './transaction.js';
@@ -28,7 +28,7 @@ export { getSessionTaskPlan, setSessionTaskPlan, type SessionTaskPlan, type Sess
 export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings, type RelationshipSettings, type SupportMode, } from './relationship-settings-repository.js';
 export { buildDefaultSessionMetadata, type SessionMetadataSeed, } from './session-metadata.js';
 export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow, type SessionConfigRow, type SessionRow, type TranscriptEntryRow, } from './row-mappers.js';
-export { deleteSessionRecord, ensureSessionRecord, getCurrentSessionId, getGlobalSessionStats, findSessionKeyBySessionId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';
+export { deleteSessionRecord, ensureSessionRecord, getCurrentTranscriptId, getGlobalSessionStats, findConversationIdByTranscriptId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';
 export { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, loadCompactionSourceSnapshot, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript, type CompactionSourceSnapshot, type SessionTranscriptRecallMatch, type TranscriptSourceEntry, } from './transcript-repository.js';
 export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } from './notes-repository.js';
 export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';

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

@@ -1,11 +1,12 @@
 import { XOPC_DB_FILENAME, resolveXopcDatabasePath } from "../../config/paths-state.js";
+import { init_paths } from "./paths.js";
 import { SCHEMA_META_SCHEMA_VERSION_KEY, readSchemaVersion, readSchemaVersionForTest } from "./schema-version.js";
-import { discoverSqlMigrations, listRegisteredMigrationTargets } from "./migrations/discover.js";
-import { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError } from "./migrations/errors.js";
-import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations, inspectSchemaMigrationStatus, resolveMigrationsDir } from "./migrations/runner.js";
-import { ensureXopcDatabaseSchema } from "./schema.js";
-import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { discoverSqlMigrations, init_discover, listRegisteredMigrationTargets } from "./migrations/discover.js";
+import { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, init_errors } from "./migrations/errors.js";
+import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations, init_runner, inspectSchemaMigrationStatus, resolveMigrationsDir } from "./migrations/runner.js";
+import { ensureXopcDatabaseSchema, init_schema } from "./schema.js";
+import { closeXopcDatabase, getXopcDatabase, init_connection, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, getEndpointSessionBinding, setEndpointSessionBinding } from "./endpoint-session-binding-repository.js";
 import { deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, getBrowserTabBinding, getBrowserTabBindingById, setBrowserTabBinding } from "./browser-tab-binding-repository.js";
 import { authenticateDeviceAccessToken, buildRefreshProofMessage, createDevice, getDevice, issueDeviceTokenPair, listDevices, revokeDevice, rotateDeviceRefreshToken } from "./device-access-repository.js";
@@ -16,10 +17,10 @@ import { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, l
 import { createCollaborationRule, getCollaborationRule, listCollaborationRules, setCollaborationRuleStatus } from "./collaboration-rule-repository.js";
 import { createContextEvidence } from "./context-evidence-repository.js";
 import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, init_session_input_repository, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { consumeClarificationApproval, consumeClarificationResume, createClarificationWait, getActiveClarification, getClarification, getClarificationResumeInput, getClarificationSnapshot, isClarificationSuspended, resolveClarification, supersedeActiveClarification } from "./clarification-wait-repository.js";
-import { buildDefaultSessionMetadata } from "./session-metadata.js";
-import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
+import { buildDefaultSessionMetadata, init_session_metadata } from "./session-metadata.js";
+import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, init_row_mappers, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "./session-turn-replace-repository.js";
 import { acknowledgeHomeAttention, isHomeAttentionAcknowledged } from "./home-attention-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "./connector-learning-repository.js";
@@ -27,7 +28,7 @@ import { COMPOSER_INPUT_HISTORY_LIMIT, appendComposerInputHistory, clearComposer
 import { bindEndpointPrincipal, createEndpointPrincipal, getEndpointPrincipal, listEndpointPrincipals, revokeEndpointPrincipal, touchEndpointPrincipal } from "./endpoint-principal-repository.js";
 import { finishEndpointToolInvocationAudit, listEndpointToolInvocationAudits, startEndpointToolInvocationAudit } from "./endpoint-tool-invocation-repository.js";
 import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
-import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getCurrentSessionId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
+import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getCurrentTranscriptId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, init_session_repository, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "./session-task-plan-repository.js";
 import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";
@@ -40,4 +41,17 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getConnectorAccount, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy } from "./connector-sync-policy-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentSessionId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasIndependentExtractionOutput, hasSessionConfig, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+//#region src/storage/sqlite/index.ts
+init_paths();
+init_schema();
+init_runner();
+init_errors();
+init_discover();
+init_connection();
+init_transaction();
+init_session_input_repository();
+init_session_metadata();
+init_row_mappers();
+init_session_repository();
+//#endregion
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasIndependentExtractionOutput, hasSessionConfig, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/interaction-state-repository.d.ts

@@ -1,17 +1,17 @@
 import { type InteractionStateSignal } from '../../user-context/interaction-state.js';
 export interface InteractionState extends InteractionStateSignal {
-    sessionKey: string;
+    conversationId: string;
     expiresAt: number;
     updatedAt: number;
 }
-export declare function getInteractionState(sessionKey: string, now?: number): InteractionState | undefined;
+export declare function getInteractionState(conversationId: string, now?: number): InteractionState | undefined;
 export declare function setInteractionState(input: {
-    sessionKey: string;
+    conversationId: string;
     signal: InteractionStateSignal;
     now?: number;
 }): InteractionState;
 export declare function updateInteractionStateFromMessage(input: {
-    sessionKey: string;
+    conversationId: string;
     message: string;
     now?: number;
 }): InteractionState;

package/dist/src/storage/sqlite/interaction-state-repository.js

@@ -1,10 +1,11 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
 import { inferInteractionState } from "../../user-context/interaction-state.js";
 //#region src/storage/sqlite/interaction-state-repository.ts
+init_transaction();
 const STATE_TTL_MS = 360 * 60 * 1e3;
 function fromRow(row) {
 	return {
-		sessionKey: row.session_key,
+		conversationId: row.conversation_id,
 		supportNeed: row.support_need,
 		...row.emotion_hypothesis ? { emotionHypothesis: row.emotion_hypothesis } : {},
 		confidence: row.confidence,
@@ -15,10 +16,10 @@ function fromRow(row) {
 		updatedAt: row.updated_at
 	};
 }
-function getInteractionState(sessionKey, now = Date.now()) {
-	const row = getSqliteDatabase().prepare(`SELECT session_key, support_need, emotion_hypothesis, confidence, source,
+function getInteractionState(conversationId, now = Date.now()) {
+	const row = getSqliteDatabase().prepare(`SELECT conversation_id, support_need, emotion_hypothesis, confidence, source,
             repair_status, repair_reason, expires_at, updated_at
-     FROM interaction_states WHERE session_key = ? AND expires_at > ?`).get(sessionKey, now);
+     FROM interaction_states WHERE conversation_id = ? AND expires_at > ?`).get(conversationId, now);
 	return row ? fromRow(row) : void 0;
 }
 function setInteractionState(input) {
@@ -26,10 +27,10 @@ function setInteractionState(input) {
 	const expiresAt = now + STATE_TTL_MS;
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO interaction_states (
-        session_key, support_need, emotion_hypothesis, confidence, source,
+        conversation_id, support_need, emotion_hypothesis, confidence, source,
         repair_status, repair_reason, expires_at, updated_at
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(session_key) DO UPDATE SET
+      ON CONFLICT(conversation_id) DO UPDATE SET
         support_need = excluded.support_need,
         emotion_hypothesis = excluded.emotion_hypothesis,
         confidence = excluded.confidence,
@@ -37,13 +38,13 @@ function setInteractionState(input) {
         repair_status = excluded.repair_status,
         repair_reason = excluded.repair_reason,
         expires_at = excluded.expires_at,
-        updated_at = excluded.updated_at`).run(input.sessionKey, input.signal.supportNeed, input.signal.emotionHypothesis ?? null, input.signal.confidence, input.signal.source, input.signal.repairStatus, input.signal.repairReason ?? null, expiresAt, now);
+        updated_at = excluded.updated_at`).run(input.conversationId, input.signal.supportNeed, input.signal.emotionHypothesis ?? null, input.signal.confidence, input.signal.source, input.signal.repairStatus, input.signal.repairReason ?? null, expiresAt, now);
 	});
-	return getInteractionState(input.sessionKey, now);
+	return getInteractionState(input.conversationId, now);
 }
 function updateInteractionStateFromMessage(input) {
 	const now = input.now ?? Date.now();
-	const previous = getInteractionState(input.sessionKey, now);
+	const previous = getInteractionState(input.conversationId, now);
 	const inferred = inferInteractionState(input.message);
 	const signal = previous?.repairStatus === "needed" && inferred.repairStatus === "none" ? {
 		...inferred,
@@ -51,7 +52,7 @@ function updateInteractionStateFromMessage(input) {
 		repairReason: previous.repairReason
 	} : inferred;
 	return setInteractionState({
-		sessionKey: input.sessionKey,
+		conversationId: input.conversationId,
 		signal,
 		now
 	});

package/dist/src/storage/sqlite/knowledge-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/knowledge-repository.ts
+init_transaction();
 function parseTimestamp(value) {
 	if (!value) return null;
 	const parsed = Date.parse(value);

package/dist/src/storage/sqlite/migrations/178_conversation_uuid.sql

@@ -0,0 +1,2 @@
+-- Conversation UUID cutover is executed by the transaction-scoped TypeScript migration.
+SELECT 1;

package/dist/src/storage/sqlite/migrations/conversation-backup.d.ts

@@ -0,0 +1,11 @@
+import type { DatabaseSync } from 'node:sqlite';
+type BackupFileSyncOperations = {
+    open(path: string, flags: string): number;
+    fsync(fd: number): void;
+    close(fd: number): void;
+};
+/** Windows requires write access on a file handle before FlushFileBuffers/fsync. */
+export declare function flushBackupFile(backupPath: string, operations?: BackupFileSyncOperations): void;
+/** The old release does not participate in an application lock, so check open handles. */
+export declare function backupBeforeConversationCutover(db: DatabaseSync, databasePath: string): string;
+export {};

package/dist/src/storage/sqlite/migrations/conversation-backup.js

@@ -0,0 +1,98 @@
+import { __esmMin } from "../../../../_virtual/_rolldown/runtime.js";
+import { init_node_sqlite, requireNodeSqlite } from "../../../infra/node-sqlite.js";
+import { init_conversation_windows_owners, windowsDatabaseOwners } from "./conversation-windows-owners.js";
+import { resolve } from "node:path";
+import { chmodSync, closeSync, fsyncSync, openSync, readdirSync, readlinkSync, statSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+//#region src/storage/sqlite/migrations/conversation-backup.ts
+/** Windows requires write access on a file handle before FlushFileBuffers/fsync. */
+function flushBackupFile(backupPath, operations = backupFileSyncOperations) {
+	const fd = operations.open(backupPath, "r+");
+	try {
+		operations.fsync(fd);
+	} finally {
+		operations.close(fd);
+	}
+}
+function isSkippableProcError(error) {
+	const code = error.code;
+	return code === "ENOENT" || code === "EACCES" || code === "EPERM";
+}
+function databaseOwners(databasePath) {
+	if (process.platform === "win32") return windowsDatabaseOwners(databasePath);
+	if (process.platform === "linux") {
+		const paths = new Set([
+			databasePath,
+			`${databasePath}-wal`,
+			`${databasePath}-shm`
+		].map((path) => resolve(path)));
+		const owners = [];
+		for (const pid of readdirSync("/proc").filter((name) => /^\d+$/.test(name) && name !== String(process.pid))) try {
+			if (statSync(`/proc/${pid}`).uid !== process.getuid?.()) continue;
+			for (const fd of readdirSync(`/proc/${pid}/fd`)) try {
+				if (paths.has(readlinkSync(`/proc/${pid}/fd/${fd}`))) {
+					owners.push(pid);
+					break;
+				}
+			} catch (error) {
+				if (!isSkippableProcError(error)) throw error;
+			}
+		} catch (error) {
+			if (!isSkippableProcError(error)) throw error;
+		}
+		return owners;
+	}
+	let owners;
+	try {
+		owners = execFileSync("lsof", [
+			"-t",
+			"--",
+			databasePath,
+			`${databasePath}-wal`,
+			`${databasePath}-shm`
+		], {
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (error) {
+		const result = error;
+		if (result.status !== 1) throw new Error("Cannot verify database owners before upgrade; lsof is required.", { cause: error });
+		owners = String(result.stdout ?? "");
+	}
+	return [...new Set(owners.trim().split(/\s+/).filter((pid) => pid && pid !== String(process.pid)))];
+}
+/** The old release does not participate in an application lock, so check open handles. */
+function backupBeforeConversationCutover(db, databasePath) {
+	const otherOwners = databaseOwners(databasePath);
+	if (otherOwners.length) throw new Error(`Stop other xopc database processes before upgrading: ${otherOwners.join(", ")}`);
+	const backupPath = `${databasePath}.pre-v178-${Date.now()}.bak`;
+	db.exec(`VACUUM INTO '${backupPath.replaceAll("'", "''")}'`);
+	chmodSync(backupPath, 384);
+	const { DatabaseSync: SqliteDatabase } = requireNodeSqlite();
+	const snapshot = new SqliteDatabase(backupPath, { readOnly: true });
+	try {
+		const rows = snapshot.prepare("PRAGMA integrity_check").all();
+		if (rows.length !== 1 || rows[0]?.integrity_check !== "ok") throw new Error("Pre-upgrade backup failed integrity verification");
+	} finally {
+		snapshot.close();
+	}
+	flushBackupFile(backupPath);
+	return backupPath;
+}
+var backupFileSyncOperations;
+var init_conversation_backup = __esmMin((() => {
+	init_node_sqlite();
+	init_conversation_windows_owners();
+	backupFileSyncOperations = {
+		open: openSync,
+		fsync: fsyncSync,
+		close: closeSync
+	};
+}));
+//#endregion
+init_conversation_backup();
+export { backupBeforeConversationCutover, flushBackupFile, init_conversation_backup };

package/dist/src/storage/sqlite/migrations/conversation-key-decoder.d.ts

@@ -0,0 +1,8 @@
+import type { ConversationRoute } from '../../../routing/conversation-route.js';
+export declare function decodeStoredWorkflowSubagent(key: string): {
+    agentId: string;
+    runId: string;
+    actorId: string;
+};
+/** Frozen decoder for the one-time UUID cutover. Never import from runtime code. */
+export declare function decodeStoredConversationKey(key: string, storedAgentId: string): ConversationRoute;

package/dist/src/storage/sqlite/migrations/conversation-key-decoder.js

@@ -0,0 +1,87 @@
+import { __esmMin } from "../../../../_virtual/_rolldown/runtime.js";
+//#region src/storage/sqlite/migrations/conversation-key-decoder.ts
+function decodeStoredWorkflowSubagent(key) {
+	const match = /^agent:([^:]+):workflow:([^:]+):subagent:([^:]+)$/.exec(key);
+	return match ? {
+		agentId: match[1],
+		runId: match[2],
+		actorId: match[3]
+	} : null;
+}
+/** Frozen decoder for the one-time UUID cutover. Never import from runtime code. */
+function decodeStoredConversationKey(key, storedAgentId) {
+	if (key === "heartbeat:main" || key.startsWith("heartbeat:isolated:")) return {
+		agentId: storedAgentId,
+		scope: "per-account-channel-peer",
+		channel: "heartbeat",
+		accountId: "default",
+		peerKind: "direct",
+		peerId: key.slice(10),
+		threadId: "",
+		scopeId: ""
+	};
+	const match = /^agent:([^:]+):(.+)$/.exec(key);
+	const workflow = decodeStoredWorkflowSubagent(key);
+	if (!match || match[1] !== storedAgentId && workflow?.actorId !== storedAgentId) throw new Error(`Unresolvable conversation owner: ${key}`);
+	let rest = match[2];
+	let scopeId = "";
+	let threadId = "";
+	const scopeAt = rest.lastIndexOf(":scope:");
+	if (scopeAt >= 0) {
+		scopeId = rest.slice(scopeAt + 7);
+		rest = rest.slice(0, scopeAt);
+	}
+	const threadAt = rest.lastIndexOf(":thread:");
+	if (threadAt >= 0) {
+		threadId = rest.slice(threadAt + 8);
+		rest = rest.slice(0, threadAt);
+	}
+	const route = {
+		agentId: workflow?.agentId ?? storedAgentId,
+		scope: "main",
+		channel: "",
+		accountId: "",
+		peerKind: "direct",
+		peerId: rest,
+		threadId,
+		scopeId
+	};
+	const parts = rest.split(":");
+	if (parts.length === 4 && parts[0] === "workflow" && parts[2] === "subagent") return {
+		...route,
+		scope: "per-account-channel-peer",
+		channel: "workflow",
+		accountId: "default",
+		peerId: `${parts[1]}/${parts[3]}`
+	};
+	if (parts.length >= 4 && parts[2] === "direct") return {
+		...route,
+		scope: "per-account-channel-peer",
+		channel: parts[0],
+		accountId: parts[1],
+		peerId: parts.slice(3).join(":")
+	};
+	if (parts.length >= 3 && parts[1] === "direct") return {
+		...route,
+		scope: "per-channel-peer",
+		channel: parts[0],
+		peerId: parts.slice(2).join(":")
+	};
+	if (parts.length >= 2 && parts[0] === "direct") return {
+		...route,
+		scope: "per-peer",
+		peerId: parts.slice(1).join(":")
+	};
+	if (parts.length >= 3 && (parts[1] === "group" || parts[1] === "channel")) return {
+		...route,
+		scope: "group",
+		channel: parts[0],
+		peerKind: parts[1],
+		peerId: parts.slice(2).join(":")
+	};
+	return route;
+}
+var init_conversation_key_decoder = __esmMin((() => {}));
+//#endregion
+init_conversation_key_decoder();
+export { decodeStoredConversationKey, decodeStoredWorkflowSubagent, init_conversation_key_decoder };