@xopcai/xopc 0.0.308 → 0.0.311

package/dist/src/scenes/templates.js

@@ -0,0 +1,76 @@
+import { sceneTemplateSchema } from "./contracts.js";
+//#region src/scenes/templates.ts
+const mailFollowUpTemplate = sceneTemplateSchema.parse({
+	schemaVersion: 1,
+	key: "mail-follow-up",
+	version: "1.0.0",
+	title: "跟进重要邮件",
+	description: "在约定时间检查指定邮件，准备需要你判断的下一步；不自动发送。",
+	goalMode: "ongoing",
+	contextProviders: ["mail"],
+	triggers: [
+		{
+			id: "check",
+			type: "manual"
+		},
+		{
+			id: "due",
+			type: "schedule"
+		},
+		{
+			id: "changed",
+			type: "event",
+			eventType: "mail.thread.changed"
+		}
+	],
+	execution: {
+		kind: "agent",
+		instruction: "Review the authorized mail thread against the user goal. If a reply resolves the request or no useful next step exists, return no_change. Otherwise prepare a concise follow-up draft or a decision with evidence. Do not infer that a draft was sent. Do not infer missing messages or recipients.",
+		limits: {
+			timeoutSeconds: 90,
+			maxIterations: 1,
+			maxToolCalls: 0,
+			maxOutputTokens: 2e3
+		}
+	},
+	allowedOutcomeKinds: [
+		"no_change",
+		"artifact",
+		"decision"
+	],
+	allowedEffectHandlers: []
+});
+const familyPlanTemplate = sceneTemplateSchema.parse({
+	schemaVersion: 1,
+	key: "weekly-family-plan",
+	version: "1.0.0",
+	title: "提前准备下周家庭安排",
+	description: "根据你提供的安排整理冲突、准备事项和可选计划，不替你决定家庭活动。",
+	goalMode: "ongoing",
+	contextProviders: ["user_notes"],
+	triggers: [{
+		id: "check",
+		type: "manual"
+	}, {
+		id: "weekly-review",
+		type: "schedule"
+	}],
+	execution: {
+		kind: "agent",
+		instruction: "Use only the supplied family arrangements to prepare next week. Surface concrete conflicts and useful preparations. Preserve room for rest and changing plans. Do not infer access to other family members, medical advice, or obligations not provided by the user. No useful change means no_change.",
+		limits: {
+			timeoutSeconds: 90,
+			maxIterations: 1,
+			maxToolCalls: 0,
+			maxOutputTokens: 2e3
+		}
+	},
+	allowedOutcomeKinds: [
+		"no_change",
+		"artifact",
+		"decision"
+	],
+	allowedEffectHandlers: []
+});
+//#endregion
+export { familyPlanTemplate, mailFollowUpTemplate };

package/dist/src/scenes/userNotes.d.ts

@@ -0,0 +1,10 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { SceneContextProvider, SceneEvidence } from './execution.js';
+/** Explicit notes belong to one delegation, not an implicit family-wide data grant. */
+export declare class SceneUserNotesProvider implements SceneContextProvider {
+    private readonly db;
+    private readonly clock;
+    readonly id = "user_notes";
+    constructor(db: DatabaseSync, clock?: () => number);
+    read(input: Parameters<SceneContextProvider['read']>[0]): Promise<SceneEvidence[]>;
+}

package/dist/src/scenes/userNotes.js

@@ -0,0 +1,34 @@
+import { SceneSourceNotReady } from "./readiness.js";
+//#region src/scenes/userNotes.ts
+/** Explicit notes belong to one delegation, not an implicit family-wide data grant. */
+var SceneUserNotesProvider = class {
+	id = "user_notes";
+	constructor(db, clock = Date.now) {
+		this.db = db;
+		this.clock = clock;
+	}
+	async read(input) {
+		input.signal.throwIfAborted();
+		if (!input.permissions.contextProviders.includes(this.id) || input.activation.scope.kind !== "personal") throw new Error("Personal notes permission is required");
+		const row = this.db.prepare(`SELECT n.content, n.revision, n.valid_until, n.updated_at
+      FROM scene_activations a LEFT JOIN scene_notes n ON n.activation_id = a.id
+      WHERE a.id = ? AND a.owner_id = ? AND a.workspace_id = ? AND a.status = 'active'
+        AND json_extract(a.scope_json, '$.kind') = 'personal'`).get(input.activation.id, input.activation.ownerId, input.activation.workspaceId);
+		if (!row) throw new Error("Personal notes are unavailable");
+		if (row.content === null || row.content === "") return [];
+		const now = this.clock();
+		if (row.valid_until !== null && Number(row.valid_until) <= now) throw new SceneSourceNotReady();
+		return [{
+			id: `scene-notes:${input.activation.id}`,
+			subjectId: input.activation.id,
+			ownerId: input.activation.ownerId,
+			workspaceId: input.activation.workspaceId,
+			revision: String(row.revision),
+			occurredAt: Number(row.updated_at),
+			content: String(row.content),
+			freshUntil: Math.min(now + 6e4, row.valid_until === null ? Infinity : Number(row.valid_until))
+		}];
+	}
+};
+//#endregion
+export { SceneUserNotesProvider };

package/dist/src/session/resolve-session.js

@@ -1,7 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
-import { findConversationIdByTranscriptId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
+import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
+import { findConversationIdByTranscriptId, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";

package/dist/src/session/store.js

@@ -6,7 +6,8 @@ import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, init_session_context_for_llm, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import "./types.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
-import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
+import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
+import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getGlobalSessionStats, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "../storage/sqlite/transcript-repository.js";
 import { getSessionConfig, setSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";

package/dist/src/share/share-config.js

@@ -105,11 +105,6 @@ function mergeShareConfigPatch(config, patch) {
 		bind: "loopback",
 		port: 18790,
 		auth: { mode: "token" },
-		heartbeat: {
-			enabled: true,
-			intervalMs: 18e5,
-			includeSystemPromptSection: false
-		},
 		corsOrigins: []
 	};
 	const current = resolveShareConfig(config.gateway.share);

package/dist/src/share/site-share-config.js

@@ -68,11 +68,6 @@ function mergeSiteShareConfigPatch(config, patch) {
 		bind: "loopback",
 		port: 18790,
 		auth: { mode: "token" },
-		heartbeat: {
-			enabled: true,
-			intervalMs: 18e5,
-			includeSystemPromptSection: false
-		},
 		corsOrigins: []
 	};
 	const cfg = config.gateway;

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

@@ -8,10 +8,24 @@ import { bumpSessionInputRevision, getSessionInputById, getSessionInputState, in
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { getConnectorAccount, init_connector_account_repository } from "./connector-account-repository.js";
 import { getConnectorConnection, init_connector_repository } from "./connector-repository.js";
-import { getSessionMetadata, init_session_repository } from "./session-repository.js";
 import { randomUUID } from "node:crypto";
 import { EventEmitter } from "node:events";
 //#region src/storage/sqlite/connection-wait-repository.ts
+function getConnectionSessionContext(conversationId) {
+	const row = getSqliteDatabase().prepare(`SELECT session_type, parent_conversation_id, custom_data_json
+    FROM sessions WHERE conversation_id = ?`).get(conversationId);
+	if (!row) return void 0;
+	let customData = {};
+	if (row.custom_data_json) try {
+		const parsed = JSON.parse(row.custom_data_json);
+		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) customData = parsed;
+	} catch {}
+	return {
+		sessionType: row.session_type,
+		parentConversationId: row.parent_conversation_id,
+		customData
+	};
+}
 function onConnectionWaitChanged(listener) {
 	events.on("changed", listener);
 	return () => {
@@ -225,9 +239,9 @@ function consumeConnectionResume(input) {
 }
 function connectionBindings(conversationId) {
 	if (!isXopcDatabaseOpen()) return [];
-	let metadata = getSessionMetadata(conversationId);
-	if (metadata?.sessionType === "workflow-subagent" && metadata.parentConversationId) metadata = getSessionMetadata(metadata.parentConversationId);
-	const workflowAccounts = metadata?.sessionType === "workflow-run" ? metadata.customData?.connectorAccounts : void 0;
+	let sessionContext = getConnectionSessionContext(conversationId);
+	if (sessionContext?.sessionType === "workflow-subagent" && sessionContext.parentConversationId) sessionContext = getConnectionSessionContext(sessionContext.parentConversationId);
+	const workflowAccounts = sessionContext?.sessionType === "workflow-run" ? sessionContext.customData.connectorAccounts : void 0;
 	if (workflowAccounts && typeof workflowAccounts === "object" && !Array.isArray(workflowAccounts)) return Object.entries(workflowAccounts).flatMap(([connectorId, ids]) => Array.isArray(ids) ? ids.flatMap((id) => {
 		if (typeof id !== "string") return [];
 		const account = getConnectorAccount(id);
@@ -392,14 +406,13 @@ function listConnectionWaitsToCheck() {
 }
 var log, events;
 var init_connection_wait_repository = __esmMin((() => {
-	init_connector_account_repository();
-	init_connector_repository();
 	init_logger();
 	init_task_run_repository();
 	init_connection();
+	init_connector_account_repository();
+	init_connector_repository();
 	init_transaction();
 	init_session_instance_repository();
-	init_session_repository();
 	init_session_input_repository();
 	log = createLogger("Connectors:Wait");
 	events = new EventEmitter();

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

@@ -1,9 +1,9 @@
 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 { init_node_sqlite, requireNodeSqlite } from "../../infra/node-sqlite.js";
 import { ensureXopcDatabaseSchema, init_schema } from "./schema.js";
 import { init_unhandled_rejections, installSqliteTransientRejectionHandler } from "../../infra/unhandled-rejections.js";
 import path from "node:path";

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

@@ -16,6 +16,7 @@ function fromRow(row) {
 		principalId: row.principal_id,
 		identityKey: row.identity_key ?? void 0,
 		backendId: row.backend_id ?? void 0,
+		runtimeInstanceId: row.runtime_instance_id ?? void 0,
 		identity: parseIdentity(row.identity_json),
 		currentConnectionId: row.current_connection_id ?? void 0,
 		label: row.label ?? void 0,

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

@@ -1,9 +1,7 @@
 export type ConnectorSyncPolicy = {
     accountId: string;
     scanEnabled: boolean;
-    proactiveEnabled: boolean;
     intervalMinutes?: number;
-    allowedScenarioKeys: string[];
     revision: number;
     updatedAt: string;
 };
@@ -13,9 +11,7 @@ export declare function listConnectorSyncPolicies(): ConnectorSyncPolicy[];
 export declare function upsertConnectorSyncPolicy(input: {
     accountId: string;
     scanEnabled?: boolean;
-    proactiveEnabled?: boolean;
     intervalMinutes?: number | null;
     defaultIntervalMinutes?: number;
-    allowedScenarioKeys?: string[];
     nowMs?: number;
 }): ConnectorSyncPolicy;

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

@@ -1,21 +1,11 @@
 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);
-		return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
-	} catch {
-		return [];
-	}
-}
 function fromRow(row) {
 	return {
 		accountId: row.account_id,
 		scanEnabled: row.scan_enabled === 1,
-		proactiveEnabled: row.proactive_enabled === 1,
 		...row.interval_minutes == null ? {} : { intervalMinutes: row.interval_minutes },
-		allowedScenarioKeys: stringArray(row.allowed_scenario_keys_json),
 		revision: row.revision,
 		updatedAt: new Date(row.updated_at).toISOString()
 	};
@@ -41,19 +31,15 @@ function upsertConnectorSyncPolicy(input) {
 	const current = getConnectorSyncPolicy(input.accountId);
 	const now = input.nowMs ?? Date.now();
 	const intervalMinutes = input.intervalMinutes === null ? null : Math.max(5, Math.min(1440, input.intervalMinutes ?? current?.intervalMinutes ?? input.defaultIntervalMinutes ?? 30));
-	const allowedScenarioKeys = [...new Set((input.allowedScenarioKeys ?? current?.allowedScenarioKeys ?? []).map((key) => key.trim()).filter(Boolean))].sort();
 	runSqliteWriteTransaction((db) => {
 		db.prepare(`INSERT INTO connector_sync_policies (
-        account_id, scan_enabled, proactive_enabled, interval_minutes,
-        allowed_scenario_keys_json, revision, updated_at
-      ) VALUES (?, ?, ?, ?, ?, 1, ?)
+        account_id, scan_enabled, interval_minutes, revision, updated_at
+      ) VALUES (?, ?, ?, 1, ?)
       ON CONFLICT(account_id) DO UPDATE SET
         scan_enabled = excluded.scan_enabled,
-        proactive_enabled = excluded.proactive_enabled,
         interval_minutes = excluded.interval_minutes,
-        allowed_scenario_keys_json = excluded.allowed_scenario_keys_json,
         revision = connector_sync_policies.revision + 1,
-        updated_at = excluded.updated_at`).run(input.accountId, input.scanEnabled ?? current?.scanEnabled ?? false ? 1 : 0, input.proactiveEnabled ?? current?.proactiveEnabled ?? false ? 1 : 0, intervalMinutes, JSON.stringify(allowedScenarioKeys), now);
+        updated_at = excluded.updated_at`).run(input.accountId, input.scanEnabled ?? current?.scanEnabled ?? false ? 1 : 0, intervalMinutes, now);
 	});
 	return getConnectorSyncPolicy(input.accountId);
 }

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

@@ -4,7 +4,8 @@ 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 { getSessionMetadata } from "./session-read-repository.js";
+import { ensureSessionInTransaction, 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()) {

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

@@ -29,6 +29,7 @@ export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAll
 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, getCurrentTranscriptId, getGlobalSessionStats, findConversationIdByTranscriptId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';
+export { getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout, SidebarLayoutConflictError, type SidebarLayout, } from './sidebar-layout-repository.js';
 export { appendCompactionBoundaryIfUnchanged, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, findLatestAssistantTranscriptEntryId, 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

@@ -30,9 +30,11 @@ import { finishEndpointToolInvocationAudit, listEndpointToolInvocationAudits, st
 import { getInteractionState, setInteractionState, updateInteractionStateFromMessage } from "./interaction-state-repository.js";
 import { getConnectorAccount, init_connector_account_repository, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, init_connector_repository, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-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 { getSessionMetadata } from "./session-read-repository.js";
+import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getCurrentTranscriptId, getGlobalSessionStats, 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 { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout } from "./sidebar-layout-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, findLatestAssistantTranscriptEntryId, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
@@ -56,4 +58,4 @@ init_session_repository();
 init_connector_repository();
 init_connector_account_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, appendMediaToAssistantTranscriptEntry, 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, findLatestAssistantTranscriptEntryId, 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 };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, SidebarLayoutConflictError, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, 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, findLatestAssistantTranscriptEntryId, 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, getSidebarLayout, 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, replaceSidebarLayout, 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, sortBySidebarLayout, 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/migrations/186_sidebar_layout.sql

@@ -0,0 +1,16 @@
+CREATE TABLE sidebar_layouts (
+  container_id TEXT PRIMARY KEY,
+  revision INTEGER NOT NULL DEFAULT 0,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE sidebar_positions (
+  container_id TEXT NOT NULL REFERENCES sidebar_layouts(container_id) ON DELETE CASCADE,
+  item_id TEXT NOT NULL,
+  position INTEGER NOT NULL,
+  PRIMARY KEY (container_id, item_id),
+  UNIQUE (container_id, position)
+);
+
+CREATE INDEX idx_sidebar_positions_order
+  ON sidebar_positions(container_id, position);

package/dist/src/storage/sqlite/migrations/187_cli_connectors.sql

@@ -0,0 +1,34 @@
+ALTER TABLE connector_accounts ADD COLUMN runtime_instance_id TEXT;
+CREATE UNIQUE INDEX idx_cli_account_identity ON connector_accounts(principal_id, runtime_instance_id, identity_key)
+  WHERE runtime_instance_id IS NOT NULL AND identity_key IS NOT NULL;
+CREATE TABLE connector_cli_authorizations (
+  id TEXT PRIMARY KEY,
+  instance_id TEXT NOT NULL,
+  connector_id TEXT NOT NULL,
+  principal_id TEXT NOT NULL,
+  expected_account_id TEXT,
+  context_id TEXT NOT NULL,
+  phase TEXT NOT NULL CHECK(phase IN ('preparing','awaiting_user','verifying','succeeded','failed','expired','cancelled')),
+  challenge_json TEXT,
+  error TEXT,
+  account_id TEXT,
+  owner_id TEXT NOT NULL,
+  expires_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+CREATE UNIQUE INDEX idx_cli_active_authorization ON connector_cli_authorizations(instance_id, principal_id)
+  WHERE phase IN ('preparing','awaiting_user','verifying');
+CREATE TABLE connector_cli_executions (
+  id TEXT PRIMARY KEY,
+  instance_id TEXT NOT NULL,
+  account_id TEXT NOT NULL,
+  connection_id TEXT NOT NULL,
+  action_id TEXT NOT NULL,
+  revision TEXT NOT NULL,
+  arguments_hash TEXT NOT NULL,
+  status TEXT NOT NULL CHECK(status IN ('running','success','failed','unknown')),
+  owner_id TEXT NOT NULL,
+  error_kind TEXT,
+  started_at INTEGER NOT NULL,
+  finished_at INTEGER
+);

package/dist/src/storage/sqlite/migrations/188_scene_storage.sql

@@ -0,0 +1,2 @@
+-- The runner initializes current scene storage and discards experimental history
+-- in this version's transaction. No data import, file journal or backup is needed.

package/dist/src/storage/sqlite/migrations/189_scene_source_health.sql

@@ -0,0 +1,8 @@
+CREATE TABLE IF NOT EXISTS scene_source_health (
+  activation_id TEXT PRIMARY KEY REFERENCES scene_activations(id) ON DELETE CASCADE,
+  last_attempt_at INTEGER NOT NULL,
+  last_success_at INTEGER,
+  reason TEXT,
+  consecutive_failures INTEGER NOT NULL DEFAULT 0,
+  retry_at INTEGER
+);

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

@@ -6,6 +6,8 @@ type BackupFileSyncOperations = {
 };
 /** Windows requires write access on a file handle before FlushFileBuffers/fsync. */
 export declare function flushBackupFile(backupPath: string, operations?: BackupFileSyncOperations): void;
+/** Offline migrations must reject processes that still hold the database open. */
+export declare function assertDatabaseOffline(databasePath: string): 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

@@ -65,10 +65,14 @@ function databaseOwners(databasePath) {
 	}
 	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) {
+/** Offline migrations must reject processes that still hold the database open. */
+function assertDatabaseOffline(databasePath) {
 	const otherOwners = databaseOwners(databasePath);
 	if (otherOwners.length) throw new Error(`Stop other xopc database processes before upgrading: ${otherOwners.join(", ")}`);
+}
+/** The old release does not participate in an application lock, so check open handles. */
+function backupBeforeConversationCutover(db, databasePath) {
+	assertDatabaseOffline(databasePath);
 	const backupPath = `${databasePath}.pre-v178-${Date.now()}.bak`;
 	db.exec(`VACUUM INTO '${backupPath.replaceAll("'", "''")}'`);
 	chmodSync(backupPath, 384);
@@ -95,4 +99,4 @@ var init_conversation_backup = __esmMin((() => {
 }));
 //#endregion
 init_conversation_backup();
-export { backupBeforeConversationCutover, flushBackupFile, init_conversation_backup };
+export { assertDatabaseOffline, backupBeforeConversationCutover, flushBackupFile, init_conversation_backup };

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

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 185;
+export declare const XOPC_DB_SCHEMA_VERSION = 189;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.