@xopcai/xopc 0.0.189 → 0.0.190

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

@@ -0,0 +1,64 @@
+import { getSqliteDatabase } from "./transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/context-consolidation-repository.ts
+function parseJson(value) {
+	try {
+		const parsed = JSON.parse(value);
+		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+function runFromRow(row) {
+	return {
+		runId: row.run_id,
+		triggerKind: row.trigger_kind,
+		status: row.status,
+		...row.reason ? { reason: row.reason } : {},
+		metrics: parseJson(row.metrics_json),
+		startedAt: row.started_at,
+		...row.completed_at == null ? {} : { completedAt: row.completed_at }
+	};
+}
+function startContextConsolidationRun(triggerKind, now = Date.now()) {
+	const runId = randomUUID();
+	getSqliteDatabase().prepare(`INSERT INTO context_consolidation_runs (
+    run_id, trigger_kind, status, started_at
+  ) VALUES (?, ?, 'running', ?)`).run(runId, triggerKind, now);
+	return getContextConsolidationRun(runId);
+}
+function finishContextConsolidationRun(input) {
+	getSqliteDatabase().prepare(`UPDATE context_consolidation_runs
+    SET status = ?, reason = ?, metrics_json = ?, completed_at = ? WHERE run_id = ?`).run(input.ok ? "completed" : "failed", input.reason, JSON.stringify(input.metrics), input.now ?? Date.now(), input.runId);
+	return getContextConsolidationRun(input.runId);
+}
+function recordContextConsolidationDecision(input) {
+	const id = randomUUID();
+	getSqliteDatabase().prepare(`INSERT INTO context_consolidation_decisions (
+    decision_id, run_id, understanding_id, action, reason_code, evidence_count, created_at
+  ) VALUES (?, ?, ?, ?, ?, ?, ?)`).run(id, input.runId, input.understandingId, input.action, input.reasonCode, input.evidenceCount, input.now ?? Date.now());
+	return listContextConsolidationDecisions(input.runId).find((item) => item.id === id);
+}
+function getContextConsolidationRun(runId) {
+	const row = getSqliteDatabase().prepare("SELECT * FROM context_consolidation_runs WHERE run_id = ?").get(runId);
+	return row ? runFromRow(row) : void 0;
+}
+function listContextConsolidationRuns(limit = 20) {
+	const safeLimit = Math.max(1, Math.min(200, limit));
+	return getSqliteDatabase().prepare(`SELECT * FROM context_consolidation_runs
+    ORDER BY started_at DESC LIMIT ?`).all(safeLimit).map(runFromRow);
+}
+function listContextConsolidationDecisions(runId) {
+	return getSqliteDatabase().prepare(`SELECT * FROM context_consolidation_decisions
+    WHERE run_id = ? ORDER BY created_at, decision_id`).all(runId).map((row) => ({
+		id: row.decision_id,
+		runId: row.run_id,
+		...row.understanding_id ? { understandingId: row.understanding_id } : {},
+		action: row.action,
+		reasonCode: row.reason_code,
+		evidenceCount: row.evidence_count,
+		createdAt: row.created_at
+	}));
+}
+//#endregion
+export { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun };

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

@@ -6,3 +6,5 @@ export declare function buildFts5SearchQuery(raw: string): string;
 export declare function fts5RankToScore(rank: number, bestRank: number, worstRank: number): number;
 /** Bounded lexical fallback for reformulations unsupported by unicode61 tokenization. */
 export declare function memoryLexicalSimilarity(query: string, content: string): number;
+/** Local deterministic embedding used to complement FTS without network or model coupling. */
+export declare function memoryVectorSimilarity(query: string, content: string): number;

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

@@ -74,5 +74,33 @@ function memoryLexicalSimilarity(query, content) {
 	for (const feature of queryFeatures) if (contentFeatures.has(feature)) shared += 1;
 	return 2 * shared / (queryFeatures.size + contentFeatures.size);
 }
+const VECTOR_SIZE = 128;
+function featureVector(raw) {
+	const vector = new Float64Array(VECTOR_SIZE);
+	const normalized = raw.normalize("NFKC").toLocaleLowerCase();
+	const features = [...(normalized.match(/[\p{L}\p{N}_]+/gu) ?? []).map((term) => `w:${term}`), ...[...normalized].map((char, index, chars) => chars.slice(index, index + 3).join("")).filter((value) => value.trim().length >= 2).map((value) => `c:${value}`)];
+	for (const feature of features) {
+		let hash = 2166136261;
+		for (const char of feature) hash = Math.imul(hash ^ char.codePointAt(0), 16777619);
+		const index = (hash >>> 0) % VECTOR_SIZE;
+		vector[index] += (hash & 1) === 0 ? 1 : -1;
+	}
+	return vector;
+}
+/** Local deterministic embedding used to complement FTS without network or model coupling. */
+function memoryVectorSimilarity(query, content) {
+	const left = featureVector(query);
+	const right = featureVector(content);
+	let dot = 0;
+	let leftNorm = 0;
+	let rightNorm = 0;
+	for (let index = 0; index < VECTOR_SIZE; index += 1) {
+		dot += left[index] * right[index];
+		leftNorm += left[index] ** 2;
+		rightNorm += right[index] ** 2;
+	}
+	if (leftNorm === 0 || rightNorm === 0) return 0;
+	return Math.max(0, dot / Math.sqrt(leftNorm * rightNorm));
+}
 //#endregion
-export { buildFts5SearchQuery, escapeFts5Query, fts5RankToScore, memoryLexicalSimilarity };
+export { buildFts5SearchQuery, escapeFts5Query, fts5RankToScore, memoryLexicalSimilarity, memoryVectorSimilarity };

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

@@ -5,11 +5,11 @@ export { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, } from './m
 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';
-export { getMemoryReadiness } from './memory-readiness-repository.js';
-export { finishDreamingRun, getDreamingRun, listDreamingDecisions, listDreamingRuns, recordDreamingDecision, startDreamingRun, type DreamingActiveMode, type DreamingDecision, type DreamingMode, type DreamingPhase, type DreamingRun, } from './dreaming-repository.js';
+export { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun, type ContextConsolidationDecision, type ContextConsolidationRun, } from './context-consolidation-repository.js';
+export { summarizeUserUnderstandingQuality, type UserUnderstandingQualityMetrics, } from './user-context-quality-repository.js';
+export { createCollaborationRule, createContextEvidence, createUnderstanding, consumeContextConsent, deleteCollaborationRule, deleteUnderstanding, decideContextConsent, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, linkUnderstandingEvidence, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile, type CreateUnderstandingInput, } from './user-context-repository.js';
 export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
 export { acknowledgeHomeAttention, isHomeAttentionAcknowledged, type HomeAttentionSubjectKind, } from './home-attention-repository.js';
-export { getUserClaim, linkUserClaimMemoryRecord, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, removeUserClaimEvidenceForSource, reinforceUserClaim, resolveUserEntity, setUserClaimDecision, type UserClaim, type UserClaimClass, type UserClaimState, type UserEntity, } from './user-claims-repository.js';
 export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob, type ConnectorLearningJob, type ConnectorLearningMode, type ConnectorLearningPhase, type ConnectorLearningStatus, } from './connector-learning-repository.js';
 export { appendComposerInputHistory, clearComposerInputHistory, listComposerInputHistory, COMPOSER_INPUT_HISTORY_LIMIT, type ComposerInputHistoryItem, } from './composer-input-history-repository.js';
 export { bindEndpointPrincipal, createEndpointPrincipal, getEndpointPrincipal, listEndpointPrincipals, revokeEndpointPrincipal, touchEndpointPrincipal, type EndpointPrincipal, } from './endpoint-principal-repository.js';
@@ -23,7 +23,7 @@ export { deleteSessionRecord, ensureSessionRecord, getCurrentSessionId, getGloba
 export { appendCompactionBoundary, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, } 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';
-export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryTurnFeedback, getMemoryRecord, hasUnresolvedMemoryConflict, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryRecordStatus, setMemoryProviderState, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, USER_UNDERSTANDING_REMEDIATION_POLICY, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemoryFeedbackRemediationResult, type MemorySignalRowPayload, type MemoryFeedback, type MemoryFeedbackRating, type MemoryTraceEventPayload, type UserUnderstandingQualityMetrics, type SearchMemoryRecordsOptions, type SetMemoryTurnFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';
+export { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryTurnFeedback, getMemoryRecord, hasUnresolvedMemoryConflict, listMemorySignals, listMemoryTraceEvents, listMemoryRecords, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryRecordStatus, setMemoryProviderState, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord, type AppendMemorySignalInput, type AppendMemoryTraceEventInput, type ListMemoryRecordsOptions, type MemoryRecallFeedbackSummary, type MemorySignalRowPayload, type MemoryFeedback, type MemoryFeedbackRating, type MemoryTraceEventPayload, type SearchMemoryRecordsOptions, type SetMemoryTurnFeedbackInput, type UpsertMemoryRecordInput, } from './memory-records-repository.js';
 export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceItems, listKnowledgeSourceChanges, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeSourceItemSynthesisStatus, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, startKnowledgeSyncRun, upsertKnowledgeSourceItems, } from './knowledge-repository.js';
 export { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig, } from './config-repository.js';
 export { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent, } from './activity-repository.js';
@@ -31,5 +31,3 @@ export { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 export { getConnectorAccount, listConnectorAccounts, refreshConnectorAccountCurrent, reconcileConnectorAccount, } from './connector-account-repository.js';
 export { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy, type ConnectorSyncPolicy, } from './connector-sync-policy-repository.js';
 export { getUserTrustPolicy, setUserTrustPolicy, } from './user-trust-repository.js';
-export { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent, type MemoryReferenceConsent, type MemoryReferenceGrantScope, } from './memory-reference-consent-repository.js';
-export { getUserProfilePromptState, setUserProfilePromptState, } from './user-profile-setup-repository.js';

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

@@ -6,11 +6,11 @@ import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMi
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { closeXopcDatabase, getXopcDatabase, isXopcDatabaseOpen, openXopcDatabase, requireXopcDatabase, resetXopcDatabaseSingletonForTest } from "./connection.js";
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
-import { getMemoryReadiness } from "./memory-readiness-repository.js";
-import { finishDreamingRun, getDreamingRun, listDreamingDecisions, listDreamingRuns, recordDreamingDecision, startDreamingRun } from "./dreaming-repository.js";
+import { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun } from "./context-consolidation-repository.js";
+import { summarizeUserUnderstandingQuality } from "./user-context-quality-repository.js";
+import { consumeContextConsent, createCollaborationRule, createContextEvidence, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, linkUnderstandingEvidence, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
 import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { acknowledgeHomeAttention, isHomeAttentionAcknowledged } from "./home-attention-repository.js";
-import { getUserClaim, linkUserClaimMemoryRecord, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, reinforceUserClaim, removeUserClaimEvidenceForSource, resolveUserEntity, setUserClaimDecision } from "./user-claims-repository.js";
 import { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob } from "./connector-learning-repository.js";
 import { COMPOSER_INPUT_HISTORY_LIMIT, appendComposerInputHistory, clearComposerInputHistory, listComposerInputHistory } from "./composer-input-history-repository.js";
 import { bindEndpointPrincipal, createEndpointPrincipal, getEndpointPrincipal, listEndpointPrincipals, revokeEndpointPrincipal, touchEndpointPrincipal } from "./endpoint-principal-repository.js";
@@ -24,14 +24,12 @@ import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAll
 import { appendCompactionBoundary, appendTranscriptEntry, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary } from "./transcript-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
-import { USER_UNDERSTANDING_REMEDIATION_POLICY, appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, hasUnresolvedMemoryConflict, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, upsertMemoryRecord } from "./memory-records-repository.js";
 import { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems } from "./knowledge-repository.js";
+import { appendMemorySignal, appendMemoryTraceEvent, deleteMemoryRecord, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, hasUnresolvedMemoryConflict, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, markMemoryRecordsConflicted, searchMemoryRecords, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, summarizeMemoryRecallFeedback, upsertMemoryRecord } from "./memory-records-repository.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "./config-repository.js";
 import { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "./activity-repository.js";
 import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, consumeConnectorApproval, createConnectorApproval, decideConnectorApproval, deleteConnectorConnection, deleteConnectorInstallation, getCachedConnectorCatalogEntry, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listCachedConnectorCatalogEntries, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation } from "./connector-repository.js";
 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";
-import { consumeMemoryReferenceConsent, decideMemoryReferenceConsent, ensureMemoryReferenceConsentRequest, hasMemoryReferenceConsent, listMemoryReferenceConsents, revokeMemoryReferenceConsent } from "./memory-reference-consent-repository.js";
-import { getUserProfilePromptState, setUserProfilePromptState } from "./user-profile-setup-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, USER_UNDERSTANDING_REMEDIATION_POLICY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeMemoryReferenceConsent, createConnectorApproval, createEndpointPrincipal, createObjectLinkRecord, decideConnectorApproval, decideMemoryReferenceConsent, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureMemoryReferenceConsentRequest, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishDreamingRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getCurrentSessionId, getDreamingRun, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryReadiness, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getUserClaim, getUserProfilePromptState, getUserTrustPolicy, getXopcDatabase, hasMemoryReferenceConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, linkUserClaimMemoryRecord, listActivityRecords, listCachedConnectorCatalogEntries, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listDreamingDecisions, listDreamingRuns, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemoryReferenceConsents, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listUserClaimEvidence, listUserClaimStatsBySource, listUserClaims, listUserPeopleGraphRows, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordDreamingDecision, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, reinforceUserClaim, releaseConnectorWebhookDelivery, removeUserClaimEvidenceForSource, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveUserEntity, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeEndpointPrincipal, revokeMemoryReferenceConsent, runSqliteWriteTransaction, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserClaimDecision, setUserProfilePromptState, setUserTrustPolicy, startDreamingRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };
+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, appendCompactionBoundary, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listUnderstandingEvidence, listUnderstandings, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchMemoryRecords, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord };

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

@@ -1,3 +1,4 @@
+import type { DatabaseSync } from 'node:sqlite';
 import type { KnowledgeSourceChange, KnowledgeSourceItem, KnowledgeSourceItemInput, KnowledgeSyncRun, KnowledgeSyncRunStatus, KnowledgeSynthesisPipeline, KnowledgeSynthesisStatus } from '../../knowledge/types.js';
 import type { MemoryEvidence, MemoryEvidenceRelation } from '../../agent/memory/types.js';
 export declare function startKnowledgeSyncRun(input: {
@@ -68,14 +69,20 @@ export declare function completeKnowledgeSourceItemSynthesis(input: {
     error?: string;
     nowMs?: number;
 }): boolean;
-export declare function attachMemoryEvidence(input: {
+export interface AttachMemoryEvidenceInput {
     recordId: string;
     sourceItemId?: string;
     relation?: MemoryEvidenceRelation;
     excerpt?: string;
     confidence?: number;
     observedAt?: string;
+    sessionKey?: string;
+    turnId?: string;
+    toolCallId?: string;
     nowMs?: number;
-}): MemoryEvidence;
+}
+export declare function attachMemoryEvidence(input: AttachMemoryEvidenceInput): MemoryEvidence;
+export declare function replaceMemoryEvidenceForRecord(db: DatabaseSync, recordId: string, evidence: MemoryEvidence[], nowMs?: number): void;
 export declare function deleteMemoryEvidenceForRecord(recordId: string, relation?: MemoryEvidenceRelation): number;
 export declare function listMemoryEvidence(recordId: string): MemoryEvidence[];
+export declare function listMemoryEvidenceForRecords(recordIds: string[]): Map<string, MemoryEvidence[]>;

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

@@ -327,31 +327,53 @@ function completeKnowledgeSourceItemSynthesis(input) {
 		return Number(result.changes) > 0;
 	});
 }
-function attachMemoryEvidence(input) {
+function upsertMemoryEvidenceRow(db, input) {
 	let evidenceId = randomUUID();
 	const now = input.nowMs ?? Date.now();
 	const observedAt = parseTimestamp(input.observedAt);
-	runSqliteWriteTransaction((db) => {
-		db.prepare(`INSERT INTO memory_evidence (
+	db.prepare(`INSERT INTO memory_evidence (
         evidence_id, record_id, source_item_id, relation, excerpt,
-        confidence, observed_at, created_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        confidence, observed_at, session_key, turn_id, tool_call_id, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT DO UPDATE SET
         excerpt = COALESCE(excluded.excerpt, memory_evidence.excerpt),
         confidence = MAX(COALESCE(memory_evidence.confidence, 0), COALESCE(excluded.confidence, 0)),
-        observed_at = MAX(COALESCE(memory_evidence.observed_at, 0), COALESCE(excluded.observed_at, 0))`).run(evidenceId, input.recordId, input.sourceItemId ?? null, input.relation ?? "supports", input.excerpt ?? null, input.confidence ?? null, observedAt, now);
-		if (input.sourceItemId) evidenceId = db.prepare(`SELECT evidence_id FROM memory_evidence
-         WHERE record_id = ? AND source_item_id = ? AND relation = ?`).get(input.recordId, input.sourceItemId, input.relation ?? "supports")?.evidence_id ?? evidenceId;
-	});
+        observed_at = MAX(COALESCE(memory_evidence.observed_at, 0), COALESCE(excluded.observed_at, 0)),
+        session_key = COALESCE(memory_evidence.session_key, excluded.session_key),
+        turn_id = COALESCE(memory_evidence.turn_id, excluded.turn_id),
+        tool_call_id = COALESCE(memory_evidence.tool_call_id, excluded.tool_call_id)`).run(evidenceId, input.recordId, input.sourceItemId ?? null, input.relation ?? "supports", input.excerpt ?? null, input.confidence ?? null, observedAt, input.sessionKey ?? null, input.turnId ?? null, input.toolCallId ?? null, now);
+	if (input.sourceItemId) evidenceId = db.prepare(`SELECT evidence_id FROM memory_evidence
+       WHERE record_id = ? AND source_item_id = ? AND relation = ?`).get(input.recordId, input.sourceItemId, input.relation ?? "supports")?.evidence_id ?? evidenceId;
 	return {
 		evidenceId,
 		...input.sourceItemId ? { sourceItemId: input.sourceItemId } : {},
 		relation: input.relation ?? "supports",
 		...input.excerpt ? { sourceText: input.excerpt } : {},
 		...input.confidence != null ? { confidence: input.confidence } : {},
+		...input.sessionKey ? { sessionKey: input.sessionKey } : {},
+		...input.turnId ? { turnId: input.turnId } : {},
+		...input.toolCallId ? { toolCallId: input.toolCallId } : {},
 		...observedAt != null ? { observedAt: new Date(observedAt).toISOString() } : {}
 	};
 }
+function attachMemoryEvidence(input) {
+	return runSqliteWriteTransaction((db) => upsertMemoryEvidenceRow(db, input));
+}
+function replaceMemoryEvidenceForRecord(db, recordId, evidence, nowMs = Date.now()) {
+	db.prepare(`DELETE FROM memory_evidence WHERE record_id = ?`).run(recordId);
+	for (const item of evidence) upsertMemoryEvidenceRow(db, {
+		recordId,
+		sourceItemId: item.sourceItemId,
+		relation: item.relation,
+		excerpt: item.sourceText,
+		confidence: item.confidence,
+		observedAt: item.observedAt,
+		sessionKey: item.sessionKey,
+		turnId: item.turnId,
+		toolCallId: item.toolCallId,
+		nowMs
+	});
+}
 function deleteMemoryEvidenceForRecord(recordId, relation) {
 	return runSqliteWriteTransaction((db) => {
 		const result = relation ? db.prepare(`DELETE FROM memory_evidence WHERE record_id = ? AND relation = ?`).run(recordId, relation) : db.prepare(`DELETE FROM memory_evidence WHERE record_id = ?`).run(recordId);
@@ -365,8 +387,34 @@ function listMemoryEvidence(recordId) {
 		relation: row.relation,
 		...row.excerpt ? { sourceText: row.excerpt } : {},
 		...row.confidence != null ? { confidence: row.confidence } : {},
+		...row.session_key ? { sessionKey: row.session_key } : {},
+		...row.turn_id ? { turnId: row.turn_id } : {},
+		...row.tool_call_id ? { toolCallId: row.tool_call_id } : {},
 		...timestampToIso(row.observed_at) ? { observedAt: timestampToIso(row.observed_at) } : {}
 	}));
 }
+function listMemoryEvidenceForRecords(recordIds) {
+	const uniqueIds = [...new Set(recordIds.filter(Boolean))];
+	const output = /* @__PURE__ */ new Map();
+	if (uniqueIds.length === 0) return output;
+	const placeholders = uniqueIds.map(() => "?").join(", ");
+	const rows = getSqliteDatabase().prepare(`SELECT * FROM memory_evidence WHERE record_id IN (${placeholders}) ORDER BY created_at ASC`).all(...uniqueIds);
+	for (const row of rows) {
+		const group = output.get(row.record_id) ?? [];
+		group.push({
+			evidenceId: row.evidence_id,
+			...row.source_item_id ? { sourceItemId: row.source_item_id } : {},
+			relation: row.relation,
+			...row.excerpt ? { sourceText: row.excerpt } : {},
+			...row.confidence != null ? { confidence: row.confidence } : {},
+			...row.session_key ? { sessionKey: row.session_key } : {},
+			...row.turn_id ? { turnId: row.turn_id } : {},
+			...row.tool_call_id ? { toolCallId: row.tool_call_id } : {},
+			...timestampToIso(row.observed_at) ? { observedAt: timestampToIso(row.observed_at) } : {}
+		});
+		output.set(row.record_id, group);
+	}
+	return output;
+}
 //#endregion
-export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, pruneBoundedKnowledgeSourceItems, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };
+export { attachMemoryEvidence, claimKnowledgeSourceItems, completeKnowledgeSourceItemSynthesis, deleteMemoryEvidenceForRecord, finishKnowledgeSyncRun, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryEvidenceForRecords, pruneBoundedKnowledgeSourceItems, replaceMemoryEvidenceForRecord, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, startKnowledgeSyncRun, upsertKnowledgeSourceItems };

package/dist/src/storage/sqlite/memory-records-repository.d.ts

@@ -42,6 +42,10 @@ export interface ListMemoryRecordsOptions {
     visibleToProjectId?: string;
     /** Return only records that are not scoped to a project. */
     unscopedProjectOnly?: boolean;
+    /** Include global records plus records visible to this workspace. */
+    visibleToWorkspaceId?: string;
+    /** Return only records that are not scoped to a workspace. */
+    unscopedWorkspaceOnly?: boolean;
     kind?: MemoryKind;
     status?: MemoryStatus;
     canonicalKey?: string;
@@ -62,6 +66,8 @@ export interface SearchMemoryRecordsOptions {
     visibleToProjectId?: string;
     /** Return only records that are not scoped to a project. */
     unscopedProjectOnly?: boolean;
+    visibleToWorkspaceId?: string;
+    unscopedWorkspaceOnly?: boolean;
     providerId?: string;
     kinds?: MemoryKind[];
     statuses?: MemoryStatus[];
@@ -110,7 +116,7 @@ export interface AppendMemoryTraceEventInput {
     traceId?: string;
     sessionKey?: string;
     turnId?: string;
-    phase: 'search' | 'read' | 'write' | 'update' | 'delete' | 'sync' | 'inject' | 'test' | 'understanding' | 'remediation' | 'dreaming_light' | 'dreaming_deep' | 'dreaming_rem';
+    phase: 'search' | 'read' | 'write' | 'update' | 'delete' | 'sync' | 'inject' | 'test' | 'understanding';
     providerId: string;
     sourceAgentId?: string;
     request?: unknown;
@@ -148,19 +154,9 @@ export interface MemoryTraceEventPayload {
     skippedReason?: string;
     error?: string;
     feedback: MemoryFeedback[];
-    remediation?: MemoryFeedbackRemediationResult;
     durationMs: number;
     createdAt: string;
 }
-export interface MemoryFeedbackRemediationResult {
-    triggerTraceId: string;
-    evaluatedRecordIds: string[];
-    needsReviewRecordIds: string[];
-}
-export declare const USER_UNDERSTANDING_REMEDIATION_POLICY: {
-    readonly minNotHelpful: 2;
-    readonly confidencePenalty: 0.2;
-};
 export interface MemoryRecallFeedbackSummary {
     recordId: string;
     helpful: number;
@@ -171,46 +167,6 @@ export interface MemoryRecallFeedbackSummary {
     averageScore: number | null;
     lastFeedbackAt?: string;
 }
-export interface UserUnderstandingQualityMetrics {
-    windowDays: number;
-    since: string;
-    attempts: {
-        total: number;
-        turn: number;
-        background: number;
-    };
-    candidates: {
-        proposed: number;
-        created: number;
-        deduplicated: number;
-        rejectedByPolicy: number;
-    };
-    records: {
-        total: number;
-        candidate: number;
-        active: number;
-        rejected: number;
-        needsReview: number;
-        stale: number;
-        archived: number;
-        agingCandidates: number;
-        explicit: number;
-        inferred: number;
-        averageConfidence: number | null;
-    };
-    decisions: {
-        total: number;
-        acceptanceRate: number | null;
-    };
-    recall: {
-        total: number;
-        helpful: number;
-        notHelpful: number;
-        mixed: number;
-        irrelevant: number;
-        helpfulRate: number | null;
-    };
-}
 export declare function upsertMemoryRecord(input: UpsertMemoryRecordInput): MemoryRecord;
 export declare function getMemoryRecord(recordId: string): MemoryRecord | null;
 export declare function hasUnresolvedMemoryConflict(conflictGroupId: string): boolean;
@@ -249,8 +205,3 @@ export declare function summarizeMemoryRecallFeedback(options?: {
     sessionKey?: string;
     limit?: number;
 }): MemoryRecallFeedbackSummary[];
-export declare function summarizeUserUnderstandingQuality(options?: {
-    windowDays?: number;
-    agingCandidateDays?: number;
-    nowMs?: number;
-}): UserUnderstandingQualityMetrics;