@xopcai/xopc 0.0.189 → 0.0.191

package/dist/src/providers/model-catalog-store.js

@@ -53,7 +53,20 @@ var init_model_catalog_store = __esmMin((() => {
 		cloneSource(source) {
 			return {
 				...source,
-				models: source.models.map((model) => ({ ...model }))
+				models: source.models.map((model) => ({
+					...model,
+					input: [...model.input],
+					output: [...model.output],
+					operations: [...model.operations],
+					...model.imageGeneration ? { imageGeneration: {
+						...model.imageGeneration,
+						sizes: [...model.imageGeneration.sizes],
+						aspectRatios: [...model.imageGeneration.aspectRatios ?? []],
+						qualities: [...model.imageGeneration.qualities],
+						formats: [...model.imageGeneration.formats],
+						backgrounds: [...model.imageGeneration.backgrounds]
+					} } : {}
+				}))
 			};
 		}
 	};

package/dist/src/providers/model-catalog-sync-service.js

@@ -110,6 +110,12 @@ var ModelCatalogSyncService = class {
 				}, models.map((model) => ({
 					id: model.id,
 					name: model.name ?? model.id,
+					kind: "language",
+					input: ["text"],
+					output: ["text"],
+					operations: provider.api === "openai-responses" ? ["responses"] : ["chat.completions"],
+					reasoning: false,
+					contextWindow: 128e3,
 					maxOutputTokens: null
 				})));
 				return providerId;

package/dist/src/providers/model-registry.js

@@ -236,21 +236,21 @@ var init_model_registry = __esmMin((() => {
 				log.warn({ err }, "Failed to load remote model catalog");
 				return [];
 			}
-			return Object.values(sources).flatMap((source) => source.models.filter((model) => model.availability === "available").map((model) => ({
+			return Object.values(sources).flatMap((source) => source.models.filter((model) => model.availability === "available" && model.kind === "language").map((model) => ({
 				id: model.id,
 				name: model.name,
 				api: source.api,
 				provider: source.providerId,
 				baseUrl: source.baseUrl,
-				reasoning: false,
-				input: ["text"],
+				reasoning: model.reasoning,
+				input: model.input,
 				cost: {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
 					cacheWrite: 0
 				},
-				contextWindow: 128e3,
+				contextWindow: model.contextWindow,
 				maxTokens: model.maxOutputTokens ?? 16384
 			})));
 		}

package/dist/src/providers/register-runtime-providers.js

@@ -16,18 +16,18 @@ function registerRuntimeProvider(modelRuntime, source) {
 		baseUrl: source.baseUrl,
 		api: source.api,
 		oauth,
-		models: source.models.filter((model) => model.availability === "available").map((model) => ({
+		models: source.models.filter((model) => model.availability === "available" && model.kind === "language").map((model) => ({
 			id: model.id,
 			name: model.name,
-			reasoning: false,
-			input: ["text"],
+			reasoning: model.reasoning,
+			input: model.input,
 			cost: {
 				input: 0,
 				output: 0,
 				cacheRead: 0,
 				cacheWrite: 0
 			},
-			contextWindow: 128e3,
+			contextWindow: model.contextWindow,
 			maxTokens: model.maxOutputTokens ?? 16384
 		}))
 	});

package/dist/src/providers/xopc-cloud-model-source.js

@@ -2,6 +2,7 @@ import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-
 import { getModelRegistry, init_model_registry } from "./model-registry.js";
 import { init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 import { getProviderAuthService, init_provider_auth_service } from "./provider-auth-service.js";
+import { reloadImageGenerationProviders } from "../agent/image/generation/provider-registry.js";
 //#region src/providers/xopc-cloud-model-source.ts
 init_model_catalog_store();
 init_model_registry();
@@ -44,26 +45,72 @@ var XopcCloudModelSource = class {
 		const body = await response.json().catch(() => null);
 		if (!response.ok) throw new XopcCloudModelError(typeof body?.error?.message === "string" ? body.error.message : `XOPC model discovery failed (${response.status})`, response.status, typeof body?.error?.code === "string" ? body.error.code : void 0);
 		if (!Array.isArray(body?.data)) throw new XopcCloudModelError("XOPC model discovery returned an invalid response", response.status, "invalid_response");
-		const models = [...new Set(body.data.map((model) => model.id).filter((id) => typeof id === "string" && id.length > 0))];
+		const models = [...new Map(body.data.filter((model) => typeof model.id === "string" && model.id.length > 0).map((model) => {
+			const declaredInput = model.xopc?.capabilities?.input;
+			const parsedInput = Array.isArray(declaredInput) ? declaredInput.filter((value) => value === "text" || value === "image") : [];
+			const input = parsedInput.includes("text") ? [...new Set(parsedInput)] : ["text", ...new Set(parsedInput)];
+			const maxOutputTokens = model.xopc?.maxOutputTokens;
+			const declaredOutput = model.xopc?.capabilities?.output;
+			const output = Array.isArray(declaredOutput) ? declaredOutput.filter((value) => value === "text" || value === "image") : ["text"];
+			const declaredOperations = model.xopc?.operations ?? model.xopc?.capabilities?.operations;
+			const operations = Array.isArray(declaredOperations) ? declaredOperations.filter((value) => value === "chat.completions" || value === "responses" || value === "images.generate" || value === "images.edit") : ["chat.completions", "responses"];
+			const generation = parseImageGenerationCapabilities(model.xopc?.capabilities?.imageGeneration);
+			return [model.id, {
+				id: model.id,
+				name: model.id,
+				kind: model.xopc?.kind === "image" ? "image" : "language",
+				input,
+				output,
+				operations,
+				reasoning: model.xopc?.capabilities?.reasoning === true,
+				contextWindow: 128e3,
+				maxOutputTokens: typeof maxOutputTokens === "number" && Number.isSafeInteger(maxOutputTokens) ? maxOutputTokens : null,
+				...generation ? { imageGeneration: generation } : {}
+			}];
+		})).values()];
 		this.catalogStore.replaceSourceModels("xopc-cloud", {
 			providerId: "xopc-cloud",
 			baseUrl: this.routerUrl,
 			api: "openai-completions",
 			etag: response.headers.get("x-xopc-model-catalog-version"),
-			recommendedModel: models[0] ?? null,
+			recommendedModel: models[0]?.id ?? null,
 			lastSuccessAt: Date.now()
-		}, models.map((id) => ({
-			id,
-			name: id,
-			maxOutputTokens: null
-		})));
+		}, models);
 		this.refreshModels();
+		reloadImageGenerationProviders();
 		return {
 			status: "updated",
 			modelCount: models.length,
-			models
+			models: models.map((model) => model.id)
 		};
 	}
 };
+function parseImageGenerationCapabilities(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	const raw = value;
+	const strings = (candidate, allowed) => Array.isArray(candidate) ? candidate.filter((item) => typeof item === "string" && (!allowed || allowed.includes(item))) : [];
+	return {
+		maxCount: Number.isSafeInteger(raw.maxCount) && Number(raw.maxCount) > 0 ? Number(raw.maxCount) : 1,
+		sizes: strings(raw.sizes),
+		aspectRatios: strings(raw.aspectRatios),
+		qualities: strings(raw.qualities, [
+			"low",
+			"medium",
+			"high",
+			"auto"
+		]),
+		formats: strings(raw.formats, [
+			"png",
+			"jpeg",
+			"webp"
+		]),
+		backgrounds: strings(raw.backgrounds, [
+			"transparent",
+			"opaque",
+			"auto"
+		]),
+		maxInputImages: Number.isSafeInteger(raw.maxInputImages) && Number(raw.maxInputImages) > 0 ? Number(raw.maxInputImages) : 0
+	};
+}
 //#endregion
 export { XopcCloudModelError, XopcCloudModelSource };

package/dist/src/realtime/broker.d.ts

@@ -12,6 +12,7 @@ export interface RealtimeTopicPolicy {
 export type RealtimeTopicPolicyResolver = (topic: string) => RealtimeTopicPolicy;
 export interface RealtimeSubscriptionHandle {
     initial: RealtimeDelivery[];
+    cursor: number;
     unsubscribe: () => void;
 }
 export declare function defaultRealtimeTopicPolicy(topic: string): RealtimeTopicPolicy;

package/dist/src/realtime/broker.js

@@ -47,8 +47,12 @@ var RealtimeBroker = class {
 		realtimeTopicSchema.parse(topic);
 		const state = this.ensureTopic(topic);
 		state.listeners.add(listener);
+		const initial = afterSeq === void 0 ? [] : this.replayFrom(topic, state, afterSeq);
+		const gap = initial[0]?.kind === "realtime.gap" ? initial[0] : void 0;
+		const currentSeq = state.nextSeq - 1;
 		return {
-			initial: afterSeq === void 0 ? [] : this.replayFrom(topic, state, afterSeq),
+			initial,
+			cursor: gap ? gap.payload.earliestSeq - 1 : afterSeq === void 0 ? currentSeq : Math.min(afterSeq, currentSeq),
 			unsubscribe: () => {
 				state.listeners.delete(listener);
 			}
@@ -65,6 +69,18 @@ var RealtimeBroker = class {
 	}
 	replayFrom(topic, state, afterSeq) {
 		const currentSeq = state.nextSeq - 1;
+		if (afterSeq > currentSeq) return [{
+			protocolVersion: 1,
+			messageId: crypto.randomUUID(),
+			kind: "realtime.gap",
+			sentAt: Date.now(),
+			payload: {
+				topic,
+				requestedSeq: afterSeq,
+				earliestSeq: state.events[0]?.payload.seq ?? 1,
+				recoverable: false
+			}
+		}];
 		if (currentSeq <= afterSeq) return [];
 		const earliestSeq = state.events[0]?.payload.seq;
 		if (earliestSeq === void 0 || afterSeq + 1 < earliestSeq) return [{
@@ -75,7 +91,8 @@ var RealtimeBroker = class {
 			payload: {
 				topic,
 				requestedSeq: afterSeq,
-				earliestSeq: earliestSeq ?? currentSeq + 1
+				earliestSeq: earliestSeq ?? currentSeq + 1,
+				recoverable: earliestSeq !== void 0
 			}
 		}, ...state.events];
 		return state.events.filter((event) => event.payload.seq > afterSeq);

package/dist/src/realtime/runtime.js

@@ -128,7 +128,8 @@ var RealtimeRuntime = class {
 					writer.enqueue(serverMessage("realtime.gap", {
 						topic: item.topic,
 						requestedSeq: item.afterSeq,
-						earliestSeq: 1
+						earliestSeq: 1,
+						recoverable: false
 					}));
 					continue;
 				}
@@ -137,6 +138,10 @@ var RealtimeRuntime = class {
 					writer.enqueue(event);
 				});
 				subscriptions.set(item.topic, handle);
+				writer.enqueue(serverMessage("realtime.subscribed", {
+					topic: item.topic,
+					cursor: handle.cursor
+				}), "critical");
 				for (const message of handle.initial) writer.enqueue(message);
 			}
 			return true;

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

@@ -36,7 +36,6 @@ function mergeAccountSourceData(db, connectorId, sourceAccountId, targetAccountI
 	db.prepare("UPDATE knowledge_source_items SET source_instance_id = ? WHERE source_instance_id = ?").run(targetId, sourceId);
 	db.prepare("UPDATE knowledge_sync_runs SET source_instance_id = ? WHERE source_instance_id = ?").run(targetId, sourceId);
 	db.prepare("UPDATE knowledge_source_changes SET source_instance_id = ? WHERE source_instance_id = ?").run(targetId, sourceId);
-	db.prepare("UPDATE user_claim_evidence SET source_instance_id = ? WHERE source_instance_id = ?").run(targetId, sourceId);
 	db.prepare(`
     DELETE FROM knowledge_collection_state AS source
     WHERE source.source_instance_id = ?

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

@@ -0,0 +1,37 @@
+export type ContextConsolidationRun = {
+    runId: string;
+    triggerKind: 'schedule' | 'manual';
+    status: 'running' | 'completed' | 'failed';
+    reason?: string;
+    metrics: Record<string, unknown>;
+    startedAt: number;
+    completedAt?: number;
+};
+export type ContextConsolidationDecision = {
+    id: string;
+    runId: string;
+    understandingId?: string;
+    action: 'needs_review' | 'stale';
+    reasonCode: string;
+    evidenceCount: number;
+    createdAt: number;
+};
+export declare function startContextConsolidationRun(triggerKind: ContextConsolidationRun['triggerKind'], now?: number): ContextConsolidationRun;
+export declare function finishContextConsolidationRun(input: {
+    runId: string;
+    ok: boolean;
+    reason: string;
+    metrics: Record<string, unknown>;
+    now?: number;
+}): ContextConsolidationRun | undefined;
+export declare function recordContextConsolidationDecision(input: {
+    runId: string;
+    understandingId: string;
+    action: ContextConsolidationDecision['action'];
+    reasonCode: string;
+    evidenceCount: number;
+    now?: number;
+}): ContextConsolidationDecision;
+export declare function getContextConsolidationRun(runId: string): ContextConsolidationRun | undefined;
+export declare function listContextConsolidationRuns(limit?: number): ContextConsolidationRun[];
+export declare function listContextConsolidationDecisions(runId: string): ContextConsolidationDecision[];

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 };