@xopcai/xopc 0.0.307 → 0.0.309

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

@@ -33,6 +33,7 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 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 { 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 +57,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/184_memory_suppressions.sql

@@ -0,0 +1,12 @@
+CREATE TABLE memory_suppressions (
+  fingerprint TEXT PRIMARY KEY,
+  created_at INTEGER NOT NULL
+);
+
+UPDATE notification_events SET
+  event_type = 'work_discovery.completed',
+  dedupe_key = replace(dedupe_key, 'work_discovery.review_ready:', 'work_discovery.completed:'),
+  title_en = 'Understanding updated', title_zh = '用户理解已更新',
+  body_en = 'See what xopc learned. You can edit or delete it anytime.',
+  body_zh = '理解已自动整理，可随时查看、修改或删除。'
+WHERE event_type = 'work_discovery.review_ready';

package/dist/src/storage/sqlite/migrations/185_understanding_refresh_batches.sql

@@ -0,0 +1,6 @@
+CREATE TABLE understanding_refresh_batches (
+  batch_id TEXT PRIMARY KEY,
+  source_run_ids_json TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+);
+CREATE INDEX idx_understanding_refresh_batches_created ON understanding_refresh_batches(created_at DESC);

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/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 = 183;
+export declare const XOPC_DB_SCHEMA_VERSION = 186;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

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

@@ -63,7 +63,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 183;
+	const targetVersion = options.targetVersion ?? 186;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
@@ -118,7 +118,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 183;
+	const appVersion = options.targetVersion ?? 186;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -157,7 +157,7 @@ var init_runner = __esmMin((() => {
 	init_errors();
 	log = createLogger("Sqlite:Migrations");
 	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
-	XOPC_DB_SCHEMA_VERSION = 183;
+	XOPC_DB_SCHEMA_VERSION = 186;
 	MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 }));
 //#endregion

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

@@ -33,7 +33,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 183,
+		targetVersion: 186,
 		databasePath: fresh ? void 0 : options.databasePath
 	});
 }

package/dist/src/storage/sqlite/sidebar-layout-repository.d.ts

@@ -0,0 +1,12 @@
+export type SidebarLayout = {
+    containerId: string;
+    itemIds: string[];
+    revision: number;
+};
+export declare class SidebarLayoutConflictError extends Error {
+    readonly current: SidebarLayout;
+    constructor(current: SidebarLayout);
+}
+export declare function getSidebarLayout(containerId: string): SidebarLayout;
+export declare function replaceSidebarLayout(containerId: string, itemIds: string[], expectedRevision: number): SidebarLayout;
+export declare function sortBySidebarLayout<T>(items: T[], layout: SidebarLayout, idOf: (item: T) => string): T[];

package/dist/src/storage/sqlite/sidebar-layout-repository.js

@@ -0,0 +1,53 @@
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+//#region src/storage/sqlite/sidebar-layout-repository.ts
+init_transaction();
+var SidebarLayoutConflictError = class extends Error {
+	constructor(current) {
+		super("Sidebar layout changed in another window");
+		this.current = current;
+		this.name = "SidebarLayoutConflictError";
+	}
+};
+function getSidebarLayout(containerId) {
+	const db = getSqliteDatabase();
+	const row = db.prepare("SELECT revision FROM sidebar_layouts WHERE container_id = ?").get(containerId);
+	return {
+		containerId,
+		itemIds: db.prepare("SELECT item_id FROM sidebar_positions WHERE container_id = ? ORDER BY position ASC").all(containerId).map((position) => position.item_id),
+		revision: row?.revision ?? 0
+	};
+}
+function replaceSidebarLayout(containerId, itemIds, expectedRevision) {
+	return runSqliteWriteTransaction((db) => {
+		const current = getSidebarLayout(containerId);
+		if (current.revision !== expectedRevision) throw new SidebarLayoutConflictError(current);
+		const uniqueItemIds = [...new Set(itemIds)];
+		const nextRevision = current.revision + 1;
+		db.prepare(`INSERT INTO sidebar_layouts (container_id, revision, updated_at) VALUES (?, ?, ?)
+       ON CONFLICT(container_id) DO UPDATE SET revision = excluded.revision, updated_at = excluded.updated_at`).run(containerId, nextRevision, Date.now());
+		db.prepare("DELETE FROM sidebar_positions WHERE container_id = ?").run(containerId);
+		const insert = db.prepare("INSERT INTO sidebar_positions (container_id, item_id, position) VALUES (?, ?, ?)");
+		uniqueItemIds.forEach((itemId, position) => insert.run(containerId, itemId, position));
+		return {
+			containerId,
+			itemIds: uniqueItemIds,
+			revision: nextRevision
+		};
+	});
+}
+function sortBySidebarLayout(items, layout, idOf) {
+	if (layout.itemIds.length === 0) return items;
+	const ranks = new Map(layout.itemIds.map((id, index) => [id, index]));
+	return items.map((item, index) => ({
+		item,
+		index,
+		rank: ranks.get(idOf(item))
+	})).sort((a, b) => {
+		if (a.rank !== void 0 && b.rank !== void 0) return a.rank - b.rank;
+		if (a.rank !== void 0) return 1;
+		if (b.rank !== void 0) return -1;
+		return a.index - b.index;
+	}).map(({ item }) => item);
+}
+//#endregion
+export { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout };

package/dist/src/user-context/config.d.ts

@@ -39,7 +39,6 @@ export declare const UserModelConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     writePolicy: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
-        confirm: "confirm";
         deny: "deny";
     }>>;
     sensitiveWritePolicy: z.ZodDefault<z.ZodEnum<{
@@ -76,12 +75,10 @@ export declare const UserModelConfigSchema: z.ZodDefault<z.ZodObject<{
         staleRetentionDays: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>>;
-export declare function normalizeKnowledgeMemoryConfigInput(input: unknown): unknown;
-export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodPreprocess<z.ZodObject<{
+export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     writePolicy: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
-        confirm: "confirm";
         deny: "deny";
     }>>;
     readScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
@@ -114,7 +111,7 @@ export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodPreprocess<z
     allowExternalWrites: z.ZodDefault<z.ZodBoolean>;
     allowedProviderIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     autoWriteKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strict>>>;
+}, z.core.$strict>>;
 export declare const ContextPlanningConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     maxAssertions: z.ZodDefault<z.ZodNumber>;
@@ -152,7 +149,6 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         writePolicy: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
-            confirm: "confirm";
             deny: "deny";
         }>>;
         sensitiveWritePolicy: z.ZodDefault<z.ZodEnum<{
@@ -189,11 +185,10 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
             staleRetentionDays: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    knowledgeMemory: z.ZodDefault<z.ZodPreprocess<z.ZodObject<{
+    knowledgeMemory: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         writePolicy: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
-            confirm: "confirm";
             deny: "deny";
         }>>;
         readScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
@@ -226,7 +221,7 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
         allowExternalWrites: z.ZodDefault<z.ZodBoolean>;
         allowedProviderIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         autoWriteKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     contextPlanning: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxAssertions: z.ZodDefault<z.ZodNumber>;

package/dist/src/user-context/config.js

@@ -10,26 +10,6 @@ function isValidTimeZone(value) {
 		return false;
 	}
 }
-function normalizeKnowledgeMemoryConfigInput(input) {
-	if (!input || typeof input !== "object" || Array.isArray(input)) return input;
-	const memory = input;
-	if (!Array.isArray(memory.sources)) return input;
-	const oldSources = memory.sources.filter((source) => typeof source === "string");
-	const visibilityScopes = new Set([
-		"session",
-		"workspace",
-		"project"
-	]);
-	const normalized = { ...memory };
-	if (!Array.isArray(normalized.readScopes)) normalized.readScopes = oldSources.filter((source) => visibilityScopes.has(source));
-	if (!Array.isArray(normalized.contentSources)) normalized.contentSources = [
-		...oldSources.some((source) => visibilityScopes.has(source)) ? ["memory"] : [],
-		...oldSources.includes("workspace") ? ["local_import"] : [],
-		...oldSources.includes("connector") ? ["connector"] : []
-	];
-	delete normalized.sources;
-	return normalized;
-}
 function resolveKnowledgeReadPolicy(config) {
 	return {
 		scopes: config.readScopes,
@@ -82,7 +62,7 @@ var init_config = __esmMin((() => {
 	MaintenanceTimeSchema = z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "Expected time in HH:mm format");
 	UserModelConfigSchema = z.object({
 		enabled: z.boolean().default(true),
-		writePolicy: WritePolicySchema.default("confirm"),
+		writePolicy: z.enum(["deny", "allow"]).default("allow"),
 		sensitiveWritePolicy: WritePolicySchema.default("confirm"),
 		processingPolicy: z.enum(["local_only", "remote_allowed"]).default("remote_allowed"),
 		extraction: z.object({
@@ -124,7 +104,7 @@ var init_config = __esmMin((() => {
 		})
 	}).strict().default({
 		enabled: true,
-		writePolicy: "confirm",
+		writePolicy: "allow",
 		sensitiveWritePolicy: "confirm",
 		processingPolicy: "remote_allowed",
 		extraction: {
@@ -143,9 +123,9 @@ var init_config = __esmMin((() => {
 			staleRetentionDays: 30
 		}
 	});
-	KnowledgeMemoryConfigSchema = z.preprocess(normalizeKnowledgeMemoryConfigInput, z.object({
+	KnowledgeMemoryConfigSchema = z.object({
 		enabled: z.boolean().default(true),
-		writePolicy: WritePolicySchema.default("confirm"),
+		writePolicy: z.enum(["deny", "allow"]).default("allow"),
 		readScopes: z.array(z.enum([
 			"global",
 			"agent",
@@ -182,9 +162,9 @@ var init_config = __esmMin((() => {
 		allowExternalWrites: z.boolean().default(false),
 		allowedProviderIds: z.array(z.string().min(1)).optional(),
 		autoWriteKinds: z.array(z.string().min(1)).optional()
-	}).strict()).default({
+	}).strict().default({
 		enabled: true,
-		writePolicy: "confirm",
+		writePolicy: "allow",
 		readScopes: [
 			"global",
 			"agent",
@@ -227,4 +207,4 @@ var init_config = __esmMin((() => {
 }));
 //#endregion
 init_config();
-export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config, normalizeKnowledgeMemoryConfigInput, resolveKnowledgeReadPolicy };
+export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config, resolveKnowledgeReadPolicy };

package/dist/src/user-context/memory-suppression.d.ts

@@ -0,0 +1,7 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function memoryFingerprint(parts: unknown[]): string;
+export declare function isMemorySuppressed(db: DatabaseSync, fingerprints: string[]): boolean;
+export declare function suppressMemory(db: DatabaseSync, fingerprints: string[], now: number): void;
+export declare function restoreMemory(db: DatabaseSync, fingerprints: string[]): void;
+/** Remove cached decisions containing deleted content; retain only unrelated audit rows. */
+export declare function clearMemoryAudit(db: DatabaseSync, type: 'assertion' | 'knowledge', id: string): void;

package/dist/src/user-context/memory-suppression.js

@@ -0,0 +1,23 @@
+import { createHash } from "node:crypto";
+//#region src/user-context/memory-suppression.ts
+function memoryFingerprint(parts) {
+	const normalized = parts.map((part) => typeof part === "string" ? part.normalize("NFKC").toLowerCase().replace(/\s+/g, " ").trim() : part);
+	return createHash("sha256").update(JSON.stringify(normalized)).digest("hex");
+}
+function isMemorySuppressed(db, fingerprints) {
+	return fingerprints.some((key) => db.prepare("SELECT 1 FROM memory_suppressions WHERE fingerprint = ?").get(key));
+}
+function suppressMemory(db, fingerprints, now) {
+	const insert = db.prepare("INSERT OR IGNORE INTO memory_suppressions (fingerprint, created_at) VALUES (?, ?)");
+	for (const key of fingerprints) insert.run(key, now);
+}
+function restoreMemory(db, fingerprints) {
+	for (const key of fingerprints) db.prepare("DELETE FROM memory_suppressions WHERE fingerprint = ?").run(key);
+}
+/** Remove cached decisions containing deleted content; retain only unrelated audit rows. */
+function clearMemoryAudit(db, type, id) {
+	db.prepare("DELETE FROM memory_maintenance_decisions WHERE object_type = ? AND object_id = ?").run(type, id);
+	db.prepare("DELETE FROM execution_context_items WHERE object_type = ? AND object_id = ?").run(type, id);
+}
+//#endregion
+export { clearMemoryAudit, isMemorySuppressed, memoryFingerprint, restoreMemory, suppressMemory };

package/dist/src/user-context/relationship-continuity.js

@@ -62,7 +62,7 @@ function recordExplicitRelationshipFollowUp(input) {
 		createdBy: "user",
 		evidenceId: evidence.id,
 		evidenceConfidence: 1
-	}, now).assertion;
+	}, now, { restoreDeleted: true }).assertion ?? null;
 }
 //#endregion
 export { extractExplicitRelationshipFollowUp, recordExplicitRelationshipFollowUp };

package/dist/src/user-context/sources/refresh-service.d.ts

@@ -0,0 +1,48 @@
+import type { UnderstandingSourceGrant, UnderstandingSourceItem, UnderstandingSourceRun } from './types.js';
+export type RefreshProgress = {
+    status: UnderstandingSourceRun['status'];
+    phase: 'queued' | 'waiting_desktop' | 'reading' | 'analyzing' | 'completed';
+    added?: number;
+    updated?: number;
+    itemsSeen?: number;
+    error?: string;
+};
+export type RefreshSourceRun = UnderstandingSourceRun & {
+    adapterId: string;
+    displayName: string;
+};
+export type RefreshBatch = {
+    id: string;
+    status: 'running' | 'completed' | 'partial' | 'failed';
+    sources: RefreshSourceRun[];
+    createdAt: number;
+};
+export interface UnderstandingRefreshDeps {
+    enabled(): boolean;
+    start(grant: UnderstandingSourceGrant, runId: string): Promise<Record<string, unknown>>;
+    progress(run: UnderstandingSourceRun): RefreshProgress | undefined;
+    analyzeDesktop(grant: UnderstandingSourceGrant, items: UnderstandingSourceItem[], signal: AbortSignal): Promise<{
+        added?: number;
+        updated?: number;
+    }>;
+    emit?(type: string, payload: unknown): void;
+}
+/** Coordinates existing source executors; the source run remains the authority for progress. */
+export declare class UnderstandingRefreshService {
+    private readonly deps;
+    private readonly owner;
+    private readonly starting;
+    private readonly analyzing;
+    constructor(deps: UnderstandingRefreshDeps);
+    start(sourceIds?: string[]): RefreshBatch;
+    sources(): RefreshSourceRun[];
+    latest(): RefreshBatch | null;
+    get(id: string): RefreshBatch | null;
+    private update;
+    private reconcile;
+    private dispatch;
+    submitDesktop(runId: string, input: {
+        items: UnderstandingSourceItem[];
+        error?: string;
+    }): void;
+}

package/dist/src/user-context/sources/refresh-service.js

@@ -0,0 +1,221 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { createUnderstandingSourceRun, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, updateUnderstandingSourceRun } from "./repository.js";
+import { randomUUID } from "node:crypto";
+//#region src/user-context/sources/refresh-service.ts
+init_transaction();
+init_logger();
+const log = createLogger("UnderstandingRefresh");
+const ACTIVE = new Set(["queued", "running"]);
+const DESKTOP_WAIT_MS = 12e4;
+const ANALYSIS_TIMEOUT_MS = 18e4;
+/** Coordinates existing source executors; the source run remains the authority for progress. */
+var UnderstandingRefreshService = class {
+	owner = randomUUID();
+	starting = /* @__PURE__ */ new Set();
+	analyzing = /* @__PURE__ */ new Set();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	start(sourceIds) {
+		if (!this.deps.enabled()) throw new Error("User understanding is disabled.");
+		const grants = listUnderstandingSourceGrants();
+		const selected = sourceIds === void 0 ? grants : [...new Set(sourceIds)].map((id) => {
+			const grant = grants.find((item) => item.id === id);
+			if (!grant) throw new Error("An authorized source was not found.");
+			return grant;
+		});
+		if (!selected.length || selected.length > 100) throw new Error("Select between 1 and 100 authorized sources.");
+		const id = randomUUID();
+		const createdAt = Date.now();
+		const runs = runSqliteWriteTransaction((db) => {
+			const runs = selected.map((grant) => {
+				return listUnderstandingSourceRuns(grant.id, 100).find((run) => run.metadata.refresh === true && ACTIVE.has(this.reconcile(run).status)) ?? createUnderstandingSourceRun({
+					grantId: grant.id,
+					kind: "incremental",
+					status: "queued",
+					metadata: {
+						refresh: true,
+						owner: this.owner,
+						phase: "queued",
+						adapterId: grant.adapterId,
+						displayName: grant.displayName,
+						processingPolicy: grant.processingPolicy
+					}
+				});
+			});
+			db.prepare("INSERT INTO understanding_refresh_batches (batch_id, source_run_ids_json, created_at) VALUES (?, ?, ?)").run(id, JSON.stringify(runs.map((run) => run.id)), createdAt);
+			return runs;
+		});
+		for (const run of runs) if (run.status === "queued" && !this.starting.has(run.id)) this.dispatch(run);
+		return this.get(id);
+	}
+	sources() {
+		return listUnderstandingSourceGrants().flatMap((grant) => {
+			const saved = listUnderstandingSourceRuns(grant.id, 100).find((run) => run.metadata.refresh === true);
+			if (!saved) return [];
+			return [{
+				...this.reconcile(saved),
+				adapterId: grant.adapterId,
+				displayName: grant.displayName
+			}];
+		});
+	}
+	latest() {
+		const row = getSqliteDatabase().prepare("SELECT batch_id FROM understanding_refresh_batches ORDER BY created_at DESC, rowid DESC LIMIT 1").get();
+		return row ? this.get(row.batch_id) : null;
+	}
+	get(id) {
+		const row = getSqliteDatabase().prepare("SELECT * FROM understanding_refresh_batches WHERE batch_id = ?").get(id);
+		if (!row) return null;
+		const sources = JSON.parse(row.source_run_ids_json).flatMap((runId) => {
+			const saved = getUnderstandingSourceRun(runId);
+			if (!saved) return [];
+			const run = this.reconcile(saved);
+			return [{
+				...run,
+				adapterId: String(run.metadata.adapterId),
+				displayName: String(run.metadata.displayName)
+			}];
+		});
+		const completed = sources.filter((run) => run.status === "completed").length;
+		return {
+			id,
+			status: sources.some((run) => ACTIVE.has(run.status)) ? "running" : completed === sources.length && completed > 0 ? "completed" : completed || sources.some((run) => run.status === "partial") ? "partial" : "failed",
+			sources,
+			createdAt: row.created_at
+		};
+	}
+	update(run, progress) {
+		const next = updateUnderstandingSourceRun(run.id, {
+			status: progress.status,
+			itemsSeen: progress.itemsSeen,
+			...progress.error ? { errorMessage: progress.error } : {},
+			completed: !ACTIVE.has(progress.status),
+			metadata: {
+				...run.metadata,
+				phase: progress.phase,
+				...progress.added === void 0 ? {} : { added: progress.added },
+				...progress.updated === void 0 ? {} : { updated: progress.updated }
+			}
+		});
+		this.deps.emit?.("understanding.refresh.updated", {
+			runId: run.id,
+			grantId: run.grantId
+		});
+		return next;
+	}
+	reconcile(run) {
+		if (!ACTIVE.has(run.status)) return run;
+		const grant = getUnderstandingSourceGrant(run.grantId);
+		if (!grant || grant.status !== "active" || grant.processingPolicy !== run.metadata.processingPolicy || !this.deps.enabled()) return this.update(run, {
+			status: "canceled",
+			phase: "completed",
+			error: "Source authorization changed. Retry after reviewing its settings."
+		});
+		const progress = this.deps.progress(run);
+		if (progress) {
+			if (progress.status !== run.status || progress.phase !== run.metadata.phase || progress.added !== run.metadata.added || progress.updated !== run.metadata.updated || progress.itemsSeen !== void 0 && progress.itemsSeen !== run.itemsSeen) return this.update(run, progress);
+			return run;
+		}
+		if (run.metadata.owner !== this.owner) return this.update(run, {
+			status: "failed",
+			phase: "completed",
+			error: "Update was interrupted. Please retry."
+		});
+		if (run.metadata.phase === "waiting_desktop" && Date.now() - run.startedAt > DESKTOP_WAIT_MS) return this.update(run, {
+			status: "failed",
+			phase: "completed",
+			error: "Desktop collection did not finish. Open the desktop app and retry."
+		});
+		return run;
+	}
+	async dispatch(run) {
+		this.starting.add(run.id);
+		try {
+			const grant = getUnderstandingSourceGrant(run.grantId);
+			this.update(run, {
+				status: "running",
+				phase: "reading"
+			});
+			const metadata = await this.deps.start(grant, run.id);
+			const latest = getUnderstandingSourceRun(run.id);
+			updateUnderstandingSourceRun(run.id, { metadata: {
+				...latest.metadata,
+				...metadata
+			} });
+			this.reconcile(getUnderstandingSourceRun(run.id));
+		} catch (err) {
+			log.warn({
+				err,
+				runId: run.id,
+				grantId: run.grantId
+			}, "Understanding refresh could not start");
+			this.update(getUnderstandingSourceRun(run.id), {
+				status: "failed",
+				phase: "completed",
+				error: err instanceof Error ? err.message : String(err)
+			});
+		} finally {
+			this.starting.delete(run.id);
+		}
+	}
+	submitDesktop(runId, input) {
+		const saved = getUnderstandingSourceRun(runId);
+		const run = saved ? this.reconcile(saved) : null;
+		if (!run || run.metadata.refresh !== true) throw new Error("Refresh run not found.");
+		if (this.analyzing.has(runId) || !ACTIVE.has(run.status)) return;
+		if (run.metadata.phase !== "waiting_desktop") throw new Error("This run is not waiting for desktop collection.");
+		const grant = getUnderstandingSourceGrant(run.grantId);
+		if (input.items.length > 1200 || input.items.some((item) => item.sourceId !== grant.adapterId)) throw new Error("Collected items must belong to the requested source.");
+		if (input.error) {
+			this.update(run, {
+				status: "failed",
+				phase: "completed",
+				error: input.error.slice(0, 500)
+			});
+			return;
+		}
+		if (!input.items.length) {
+			this.update(run, {
+				status: "completed",
+				phase: "completed",
+				added: 0,
+				updated: 0,
+				itemsSeen: 0
+			});
+			return;
+		}
+		this.analyzing.add(runId);
+		this.update(run, {
+			status: "running",
+			phase: "analyzing",
+			itemsSeen: input.items.length
+		});
+		const signal = AbortSignal.timeout(ANALYSIS_TIMEOUT_MS);
+		this.deps.analyzeDesktop(grant, input.items, signal).then((result) => {
+			signal.throwIfAborted();
+			const current = this.reconcile(getUnderstandingSourceRun(runId));
+			if (ACTIVE.has(current.status)) this.update(current, {
+				status: "completed",
+				phase: "completed",
+				...result
+			});
+		}).catch((err) => {
+			log.warn({
+				err,
+				runId,
+				grantId: grant.id
+			}, "Understanding refresh analysis failed");
+			const current = getUnderstandingSourceRun(runId);
+			if (ACTIVE.has(current.status)) this.update(current, {
+				status: "failed",
+				phase: "completed",
+				error: "Analysis failed. Please retry."
+			});
+		}).finally(() => this.analyzing.delete(runId));
+	}
+};
+//#endregion
+export { UnderstandingRefreshService };

package/dist/src/user-context/sources/repository.js

@@ -114,7 +114,7 @@ function getUnderstandingSourceRun(id) {
 	return row ? runFromRow(row) : null;
 }
 function listUnderstandingSourceRuns(grantId, limit = 20) {
-	return getSqliteDatabase().prepare("SELECT * FROM understanding_source_runs WHERE grant_id = ? ORDER BY started_at DESC LIMIT ?").all(grantId, Math.max(1, Math.min(100, limit))).map(runFromRow);
+	return getSqliteDatabase().prepare("SELECT * FROM understanding_source_runs WHERE grant_id = ? ORDER BY started_at DESC, rowid DESC LIMIT ?").all(grantId, Math.max(1, Math.min(100, limit))).map(runFromRow);
 }
 function updateUnderstandingSourceRun(id, patch) {
 	const current = getUnderstandingSourceRun(id);