@xopcai/xopc 0.0.218 → 0.0.219

package/dist/src/retrieval/queryProfile.d.ts

@@ -6,6 +6,7 @@ export interface RetrievalScope {
 }
 export interface RetrievalQueryProfile {
     normalized: string;
+    expanded: string;
     terms: string[];
     cjkBigrams: string[];
     identifiers: string[];

package/dist/src/retrieval/queryProfile.js

@@ -48,17 +48,25 @@ const TIME_RULES = [
 		pattern: /\b(?:future|next|later|upcoming)\b|未来|下次|之后|即将/i
 	}
 ];
+const TIME_EXPANSIONS = {
+	current: "now current active today 现在 当前 今天",
+	recent: "recent recently latest 近期 最近 最新",
+	historical: "previous before history past 之前 以前 历史 上次",
+	future: "future next later upcoming 未来 下次 之后 即将"
+};
 function buildRetrievalQueryProfile(query, scope = {}) {
 	const normalized = normalizeRetrievalText(query);
 	const intentKinds = INTENT_RULES.filter((rule) => rule.pattern.test(normalized)).flatMap((rule) => rule.kinds);
 	const timeHints = TIME_RULES.filter((rule) => rule.pattern.test(normalized)).map((rule) => rule.hint);
+	const uniqueTimeHints = [...new Set(timeHints)];
 	return {
 		normalized,
+		expanded: [normalized, ...uniqueTimeHints.map((hint) => TIME_EXPANSIONS[hint])].join(" ").trim(),
 		terms: extractLexicalTerms(normalized),
 		cjkBigrams: extractCjkBigrams(normalized),
 		identifiers: extractRetrievalIdentifiers(normalized),
 		intentKinds: [...new Set(intentKinds)],
-		timeHints: [...new Set(timeHints)],
+		timeHints: uniqueTimeHints,
 		scope: { ...scope }
 	};
 }

package/dist/src/session/client-history.d.ts

@@ -11,6 +11,17 @@ export interface ClientHistoryMessage {
     /** Persisted inbound attachment metadata used by chat clients to reload media. */
     media?: Message['media'];
     timestamp?: number;
+    /** Whitelisted display metadata; never includes source snapshot text. */
+    metadata?: {
+        sourceContexts: Array<{
+            kind: 'note';
+            sourceId: string;
+            version: string;
+            title: string;
+            tokenEstimate?: number;
+            truncated?: boolean;
+        }>;
+    };
     kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';
     tokensBefore?: number;
     tokensAfter?: number;

package/dist/src/session/client-history.js

@@ -1,5 +1,25 @@
+import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
 //#region src/session/client-history.ts
+function sourceContextDisplayMetadata(metadata) {
+	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return void 0;
+	const rows = metadata.sourceContexts;
+	if (!Array.isArray(rows)) return void 0;
+	const sourceContexts = rows.flatMap((value) => {
+		if (!value || typeof value !== "object" || Array.isArray(value)) return [];
+		const row = value;
+		if (row.kind !== "note" || typeof row.sourceId !== "string" || typeof row.version !== "string" || typeof row.title !== "string") return [];
+		return [{
+			kind: "note",
+			sourceId: row.sourceId,
+			version: row.version,
+			title: row.title,
+			...typeof row.tokenEstimate === "number" ? { tokenEstimate: row.tokenEstimate } : {},
+			...row.truncated === true ? { truncated: true } : {}
+		}];
+	});
+	return sourceContexts.length ? { sourceContexts } : void 0;
+}
 function flattenMessageContent(content) {
 	if (typeof content === "string") return content;
 	if (!Array.isArray(content)) return "";
@@ -111,8 +131,9 @@ function messagesToClientHistory(messages, opts) {
 			out.push({
 				role: m.role,
 				...typeof m.turnId === "string" ? { turnId: m.turnId } : {},
-				content: text,
+				content: m.role === "user" ? stripRuntimeContextFromUserMessage(text) : text,
 				...m.media?.length ? { media: m.media } : {},
+				...sourceContextDisplayMetadata(m.metadata) ? { metadata: sourceContextDisplayMetadata(m.metadata) } : {},
 				timestamp: parseTimestamp(m.timestamp)
 			});
 			continue;
@@ -413,8 +434,9 @@ function transcriptRowsToClientHistory(rows, opts) {
 				...messageRow.turnId ? { turnId: messageRow.turnId } : {},
 				role: messageRow.role,
 				kind: "message",
-				content: flattenMessageContent(messageRow.content ?? ""),
+				content: messageRow.role === "user" ? stripRuntimeContextFromUserMessage(flattenMessageContent(messageRow.content ?? "")) : flattenMessageContent(messageRow.content ?? ""),
 				...messageRow.media?.length ? { media: messageRow.media } : {},
+				...sourceContextDisplayMetadata(messageRow.metadata) ? { metadata: sourceContextDisplayMetadata(messageRow.metadata) } : {},
 				...displayIndex !== void 0 ? { displayIndex } : {},
 				timestamp: parseTimestampValue(messageRow.timestamp)
 			});

package/dist/src/session/config-types.d.ts

@@ -13,6 +13,6 @@ export interface SessionAgentConfig {
     providerOverride?: string;
     workingDirectoryOverride?: string;
     responseLanguage?: ResponseLanguage;
-    userContextMode?: 'enabled' | 'off';
+    userContextMode?: 'enabled' | 'off' | 'temporary';
     updatedAt?: number;
 }

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

@@ -5,8 +5,7 @@ import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
-import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
-import { stripEnvelopeTimestampPrefix } from "../channels/envelope-timestamp.js";
+import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 //#region src/session/session-title.ts
 init_session_key();
 init_providers();
@@ -56,7 +55,7 @@ function stripSkillCommandForTitle(text) {
 	return match[2]?.trim() || match[1]?.trim() || text;
 }
 function normalizeUserTextForTitle(raw) {
-	return stripSkillCommandForTitle(stripExpandedSkillBlockForTitle(stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw))))).trim();
+	return stripSkillCommandForTitle(stripExpandedSkillBlockForTitle(stripMediaClaimChecks(stripRuntimeContextFromUserMessage(raw)))).trim();
 }
 /** First assistant message that has visible text (skips tool-only assistant rows). */
 function firstAssistantText(messages) {

package/dist/src/session/store.js

@@ -725,6 +725,7 @@ var SessionStore = class {
 				name: m.name
 			};
 			if (Array.isArray(m.media) && m.media.length > 0) row.media = m.media;
+			if (m.metadata && typeof m.metadata === "object") row.metadata = m.metadata;
 			const rawUsage = m.usage;
 			if (rawUsage && typeof rawUsage === "object") {
 				const inputTokens = typeof rawUsage.input === "number" ? rawUsage.input : void 0;

package/dist/src/session/transcript-outline.js

@@ -1,4 +1,5 @@
 import { isTranscriptBashExecutionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry } from "./session-context-for-llm.js";
+import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 //#region src/session/transcript-outline.ts
 function asRecord(value) {
 	return value && typeof value === "object" ? value : null;
@@ -170,7 +171,8 @@ function rowPreview(row) {
 	}
 	const record = asRecord(row);
 	if (record?.type === "compaction") return truncateText(stringValue(record.summary) ?? "compaction checkpoint");
-	const preview = contentPreview(record?.content);
+	const content = contentText(record?.content);
+	const preview = truncateText(record?.role === "user" ? stripRuntimeContextFromUserMessage(content) : content);
 	if (record?.role === "assistant" && !preview) {
 		if (record.stopReason === "aborted") return "(aborted)";
 		const errorMessage = stringValue(record.errorMessage);
@@ -194,7 +196,8 @@ function rowContentText(row) {
 	if (isTranscriptSummaryMessageEntry(row)) return row.summary;
 	const record = asRecord(row);
 	if (record?.type === "compaction") return stringValue(record.summary);
-	const text = contentText(record?.content).trim();
+	const rawText = contentText(record?.content);
+	const text = (record?.role === "user" ? stripRuntimeContextFromUserMessage(rawText) : rawText).trim();
 	return text ? text : void 0;
 }
 function roleForTimeline(role) {

package/dist/src/session/types.d.ts

@@ -38,6 +38,7 @@ export interface Message {
         uri: string;
         path: string;
     }>;
+    metadata?: unknown;
 }
 /** Session status enum */
 export declare enum SessionStatus {

package/dist/src/session/user-message-display.d.ts

@@ -0,0 +1,4 @@
+/** Client-facing form of a persisted model-facing user message. */
+export declare function stripRuntimeContextFromUserMessage(text: string): string;
+/** Preserve structured content while cleaning every user text block. */
+export declare function stripRuntimeContextFromUserContent(content: string | unknown[]): string | unknown[];

package/dist/src/session/user-message-display.js

@@ -0,0 +1,22 @@
+import { stripRuntimeUserMessageEnvelope } from "../../packages/gateway-contract/src/user-message-display.js";
+import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";
+//#region src/session/user-message-display.ts
+/** Client-facing form of a persisted model-facing user message. */
+function stripRuntimeContextFromUserMessage(text) {
+	return stripRuntimeUserMessageEnvelope(stripSessionStartupContextFromUserText(text));
+}
+/** Preserve structured content while cleaning every user text block. */
+function stripRuntimeContextFromUserContent(content) {
+	if (typeof content === "string") return stripRuntimeContextFromUserMessage(content);
+	return content.map((block) => {
+		if (!block || typeof block !== "object") return block;
+		const row = block;
+		if (row.type !== "text" || typeof row.text !== "string") return block;
+		return {
+			...row,
+			text: stripRuntimeContextFromUserMessage(row.text)
+		};
+	});
+}
+//#endregion
+export { stripRuntimeContextFromUserContent, stripRuntimeContextFromUserMessage };

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

@@ -0,0 +1,57 @@
+export type ContextExtractionStatus = 'running' | 'completed' | 'skipped' | 'failed';
+export type ContextObjectType = 'profile' | 'rule' | 'focus' | 'understanding';
+export type ContextExtractionRun = {
+    id: string;
+    principalId: string;
+    sourceRef: string;
+    extractorId: string;
+    extractorVersion: string;
+    processingPolicy: 'local_only' | 'remote_allowed';
+    destination: 'deterministic' | 'local_model' | 'remote_model';
+    inputHash: string;
+    status: ContextExtractionStatus;
+    errorCode?: string;
+    startedAt: number;
+    completedAt?: number;
+};
+export type ContextExtractionOutput = {
+    id: string;
+    runId: string;
+    ordinal: number;
+    candidateKey: string;
+    objectType?: ContextObjectType;
+    objectId?: string;
+    versionId?: string;
+    outcome: 'created' | 'deduplicated' | 'rejected';
+    createdAt: number;
+};
+export declare function claimContextExtractionRun(input: {
+    sourceRef: string;
+    extractorId: string;
+    extractorVersion: string;
+    processingPolicy: ContextExtractionRun['processingPolicy'];
+    destination: ContextExtractionRun['destination'];
+    inputHash: string;
+    principalId?: string;
+    nowMs?: number;
+}): {
+    run: ContextExtractionRun;
+    shouldExecute: boolean;
+};
+export declare function finishContextExtractionRun(input: {
+    runId: string;
+    status: Exclude<ContextExtractionStatus, 'running'>;
+    errorCode?: string;
+    outputs?: Array<Omit<ContextExtractionOutput, 'id' | 'runId' | 'ordinal' | 'createdAt'>>;
+    nowMs?: number;
+}): ContextExtractionRun | null;
+export declare function listContextExtractionRuns(filter?: {
+    sourceRef?: string;
+    extractorId?: string;
+    extractorVersion?: string;
+    status?: ContextExtractionStatus;
+    limit?: number;
+}): ContextExtractionRun[];
+export declare function getContextExtractionRun(id: string): ContextExtractionRun | null;
+export declare function listContextExtractionOutputs(runId: string): ContextExtractionOutput[];
+export declare function hasIndependentExtractionOutput(runIds: string[], objectType: ContextObjectType, objectId: string): boolean;

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

@@ -0,0 +1,119 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
+import "../../user-context/domain.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/context-extraction-repository.ts
+function runFromRow(row) {
+	return {
+		id: row.extraction_run_id,
+		principalId: row.principal_id,
+		sourceRef: row.source_ref,
+		extractorId: row.extractor_id,
+		extractorVersion: row.extractor_version,
+		processingPolicy: row.processing_policy,
+		destination: row.destination,
+		inputHash: row.input_hash,
+		status: row.status,
+		...row.error_code ? { errorCode: row.error_code } : {},
+		startedAt: row.started_at,
+		...row.completed_at == null ? {} : { completedAt: row.completed_at }
+	};
+}
+function outputFromRow(row) {
+	return {
+		id: row.output_id,
+		runId: row.extraction_run_id,
+		ordinal: row.ordinal,
+		candidateKey: row.candidate_key,
+		...row.object_type ? { objectType: row.object_type } : {},
+		...row.object_id ? { objectId: row.object_id } : {},
+		...row.version_id ? { versionId: row.version_id } : {},
+		outcome: row.outcome,
+		createdAt: row.created_at
+	};
+}
+function claimContextExtractionRun(input) {
+	const principalId = input.principalId ?? "local-owner";
+	const now = input.nowMs ?? Date.now();
+	return runSqliteWriteTransaction((db) => {
+		const existing = db.prepare(`SELECT * FROM context_extraction_runs
+      WHERE principal_id = ? AND source_ref = ? AND extractor_id = ? AND extractor_version = ?`).get(principalId, input.sourceRef, input.extractorId, input.extractorVersion);
+		if (existing) {
+			if (existing.input_hash !== input.inputHash) throw new Error("Extraction source changed without a new source reference");
+			if (existing.status !== "failed") return {
+				run: runFromRow(existing),
+				shouldExecute: false
+			};
+			db.prepare(`UPDATE context_extraction_runs
+        SET status = 'running', error_code = NULL, started_at = ?, completed_at = NULL
+        WHERE extraction_run_id = ?`).run(now, existing.extraction_run_id);
+			return {
+				run: runFromRow(db.prepare("SELECT * FROM context_extraction_runs WHERE extraction_run_id = ?").get(existing.extraction_run_id)),
+				shouldExecute: true
+			};
+		}
+		const id = randomUUID();
+		db.prepare(`INSERT INTO context_extraction_runs (
+      extraction_run_id, principal_id, source_ref, extractor_id, extractor_version,
+      processing_policy, destination, input_hash, status, started_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running', ?)`).run(id, principalId, input.sourceRef, input.extractorId, input.extractorVersion, input.processingPolicy, input.destination, input.inputHash, now);
+		return {
+			run: runFromRow(db.prepare("SELECT * FROM context_extraction_runs WHERE extraction_run_id = ?").get(id)),
+			shouldExecute: true
+		};
+	});
+}
+function finishContextExtractionRun(input) {
+	const now = input.nowMs ?? Date.now();
+	return runSqliteWriteTransaction((db) => {
+		if (!db.prepare(`UPDATE context_extraction_runs SET status = ?, error_code = ?, completed_at = ?
+      WHERE extraction_run_id = ?`).run(input.status, input.errorCode ?? null, now, input.runId).changes) return null;
+		db.prepare("DELETE FROM context_extraction_outputs WHERE extraction_run_id = ?").run(input.runId);
+		const insert = db.prepare(`INSERT INTO context_extraction_outputs (
+      output_id, extraction_run_id, ordinal, candidate_key, object_type, object_id,
+      version_id, outcome, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+		for (const [ordinal, output] of (input.outputs ?? []).entries()) insert.run(randomUUID(), input.runId, ordinal, output.candidateKey, output.objectType ?? null, output.objectId ?? null, output.versionId ?? null, output.outcome, now);
+		return runFromRow(db.prepare("SELECT * FROM context_extraction_runs WHERE extraction_run_id = ?").get(input.runId));
+	});
+}
+function listContextExtractionRuns(filter = {}) {
+	const clauses = [];
+	const values = [];
+	if (filter.sourceRef) {
+		clauses.push("source_ref = ?");
+		values.push(filter.sourceRef);
+	}
+	if (filter.extractorId) {
+		clauses.push("extractor_id = ?");
+		values.push(filter.extractorId);
+	}
+	if (filter.extractorVersion) {
+		clauses.push("extractor_version = ?");
+		values.push(filter.extractorVersion);
+	}
+	if (filter.status) {
+		clauses.push("status = ?");
+		values.push(filter.status);
+	}
+	values.push(Math.max(1, Math.min(500, filter.limit ?? 100)));
+	return getSqliteDatabase().prepare(`SELECT * FROM context_extraction_runs
+    ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""} ORDER BY started_at DESC LIMIT ?`).all(...values).map(runFromRow);
+}
+function getContextExtractionRun(id) {
+	const row = getSqliteDatabase().prepare("SELECT * FROM context_extraction_runs WHERE extraction_run_id = ?").get(id);
+	return row ? runFromRow(row) : null;
+}
+function listContextExtractionOutputs(runId) {
+	return getSqliteDatabase().prepare(`SELECT * FROM context_extraction_outputs
+    WHERE extraction_run_id = ? ORDER BY ordinal`).all(runId).map(outputFromRow);
+}
+function hasIndependentExtractionOutput(runIds, objectType, objectId) {
+	if (!runIds.length) return false;
+	const placeholders = runIds.map(() => "?").join(", ");
+	return Boolean(getSqliteDatabase().prepare(`SELECT 1 FROM context_extraction_outputs o
+    JOIN context_extraction_runs r ON r.extraction_run_id = o.extraction_run_id
+    WHERE o.extraction_run_id NOT IN (${placeholders}) AND o.object_type = ? AND o.object_id = ?
+      AND r.status = 'completed' LIMIT 1`).get(...runIds, objectType, objectId));
+}
+//#endregion
+export { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, hasIndependentExtractionOutput, listContextExtractionOutputs, listContextExtractionRuns };

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

@@ -0,0 +1,50 @@
+import type { ContextObjectType } from './context-extraction-repository.js';
+export type ContextObjectRelation = {
+    id: string;
+    subjectType: ContextObjectType;
+    subjectId: string;
+    subjectVersionId?: string;
+    predicate: 'supersedes' | 'supports' | 'contradicts' | 'related_to';
+    objectType: ContextObjectType;
+    objectId: string;
+    objectVersionId?: string;
+    factual: boolean;
+    extractionRunId?: string;
+    createdAt: number;
+};
+export type ContextTemporalAssertion = {
+    id: string;
+    objectType: 'focus' | 'understanding';
+    objectId: string;
+    objectVersionId?: string;
+    assertionType: 'current_state' | 'routine' | 'relationship' | 'project_status';
+    value: Record<string, unknown>;
+    confidence: number;
+    validFrom?: number;
+    validTo?: number;
+    status: 'candidate' | 'active' | 'closed' | 'rejected';
+    extractionRunId?: string;
+    createdAt: number;
+    updatedAt: number;
+};
+export declare function linkContextObjects(input: Omit<ContextObjectRelation, 'id' | 'createdAt'> & {
+    nowMs?: number;
+}): ContextObjectRelation;
+export declare function listContextObjectRelations(input?: {
+    objectType?: ContextObjectType;
+    objectId?: string;
+    extractionRunId?: string;
+}): ContextObjectRelation[];
+export declare function createTemporalAssertion(input: Omit<ContextTemporalAssertion, 'id' | 'createdAt' | 'updatedAt'> & {
+    nowMs?: number;
+}): ContextTemporalAssertion;
+export declare function closeTemporalAssertions(input: {
+    objectType: ContextTemporalAssertion['objectType'];
+    objectId: string;
+    validTo?: number;
+}): number;
+export declare function listTemporalAssertions(input?: {
+    objectType?: ContextTemporalAssertion['objectType'];
+    objectId?: string;
+    status?: ContextTemporalAssertion['status'];
+}): ContextTemporalAssertion[];

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

@@ -0,0 +1,97 @@
+import { getSqliteDatabase } from "./transaction.js";
+import { randomUUID } from "node:crypto";
+//#region src/storage/sqlite/context-relation-repository.ts
+function relationFromRow(row) {
+	return {
+		id: row.relation_id,
+		subjectType: row.subject_type,
+		subjectId: row.subject_id,
+		...row.subject_version_id ? { subjectVersionId: row.subject_version_id } : {},
+		predicate: row.predicate,
+		objectType: row.object_type,
+		objectId: row.object_id,
+		...row.object_version_id ? { objectVersionId: row.object_version_id } : {},
+		factual: row.factual === 1,
+		...row.extraction_run_id ? { extractionRunId: row.extraction_run_id } : {},
+		createdAt: row.created_at
+	};
+}
+function assertionFromRow(row) {
+	return {
+		id: row.assertion_id,
+		objectType: row.object_type,
+		objectId: row.object_id,
+		...row.object_version_id ? { objectVersionId: row.object_version_id } : {},
+		assertionType: row.assertion_type,
+		value: JSON.parse(row.value_json),
+		confidence: row.confidence,
+		...row.valid_from == null ? {} : { validFrom: row.valid_from },
+		...row.valid_to == null ? {} : { validTo: row.valid_to },
+		status: row.status,
+		...row.extraction_run_id ? { extractionRunId: row.extraction_run_id } : {},
+		createdAt: row.created_at,
+		updatedAt: row.updated_at
+	};
+}
+function linkContextObjects(input) {
+	const now = input.nowMs ?? Date.now();
+	const factual = input.predicate !== "related_to";
+	getSqliteDatabase().prepare(`INSERT INTO context_object_relations (
+    relation_id, subject_type, subject_id, subject_version_id, predicate,
+    object_type, object_id, object_version_id, factual, extraction_run_id, created_at
+  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  ON CONFLICT DO UPDATE SET factual = excluded.factual, extraction_run_id = excluded.extraction_run_id`).run(randomUUID(), input.subjectType, input.subjectId, input.subjectVersionId ?? null, input.predicate, input.objectType, input.objectId, input.objectVersionId ?? null, factual ? 1 : 0, input.extractionRunId ?? null, now);
+	return relationFromRow(getSqliteDatabase().prepare(`SELECT * FROM context_object_relations
+    WHERE subject_type = ? AND subject_id = ? AND COALESCE(subject_version_id, '') = COALESCE(?, '')
+      AND predicate = ? AND object_type = ? AND object_id = ?
+      AND COALESCE(object_version_id, '') = COALESCE(?, '')`).get(input.subjectType, input.subjectId, input.subjectVersionId ?? null, input.predicate, input.objectType, input.objectId, input.objectVersionId ?? null));
+}
+function listContextObjectRelations(input = {}) {
+	const clauses = [];
+	const values = [];
+	if (input.objectType && input.objectId) {
+		clauses.push("((subject_type = ? AND subject_id = ?) OR (object_type = ? AND object_id = ?))");
+		values.push(input.objectType, input.objectId, input.objectType, input.objectId);
+	}
+	if (input.extractionRunId) {
+		clauses.push("extraction_run_id = ?");
+		values.push(input.extractionRunId);
+	}
+	return getSqliteDatabase().prepare(`SELECT * FROM context_object_relations
+    ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""} ORDER BY created_at DESC`).all(...values).map(relationFromRow);
+}
+function createTemporalAssertion(input) {
+	const now = input.nowMs ?? Date.now();
+	const id = randomUUID();
+	getSqliteDatabase().prepare(`INSERT INTO context_temporal_assertions (
+    assertion_id, object_type, object_id, object_version_id, assertion_type, value_json,
+    confidence, valid_from, valid_to, status, extraction_run_id, created_at, updated_at
+  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, input.objectType, input.objectId, input.objectVersionId ?? null, input.assertionType, JSON.stringify(input.value), input.confidence, input.validFrom ?? null, input.validTo ?? null, input.status, input.extractionRunId ?? null, now, now);
+	return assertionFromRow(getSqliteDatabase().prepare("SELECT * FROM context_temporal_assertions WHERE assertion_id = ?").get(id));
+}
+function closeTemporalAssertions(input) {
+	const now = input.validTo ?? Date.now();
+	return Number(getSqliteDatabase().prepare(`UPDATE context_temporal_assertions
+    SET status = 'closed', valid_to = COALESCE(valid_to, ?), updated_at = ?
+    WHERE object_type = ? AND object_id = ? AND status = 'active'`).run(now, now, input.objectType, input.objectId).changes);
+}
+function listTemporalAssertions(input = {}) {
+	const clauses = [];
+	const values = [];
+	if (input.objectType) {
+		clauses.push("object_type = ?");
+		values.push(input.objectType);
+	}
+	if (input.objectId) {
+		clauses.push("object_id = ?");
+		values.push(input.objectId);
+	}
+	if (input.status) {
+		clauses.push("status = ?");
+		values.push(input.status);
+	}
+	return getSqliteDatabase().prepare(`SELECT * FROM context_temporal_assertions
+    ${clauses.length ? `WHERE ${clauses.join(" AND ")}` : ""} ORDER BY created_at DESC`).all(...values).map(assertionFromRow);
+}
+//#endregion
+export { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions };

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

@@ -5,10 +5,12 @@ 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 { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, hasIndependentExtractionOutput, listContextExtractionOutputs, listContextExtractionRuns, type ContextExtractionOutput, type ContextExtractionRun, type ContextExtractionStatus, type ContextObjectType, } from './context-extraction-repository.js';
+export { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions, type ContextObjectRelation, type ContextTemporalAssertion, } from './context-relation-repository.js';
 export { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun, type ContextConsolidationDecision, type ContextConsolidationRun, } from './context-consolidation-repository.js';
 export { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, type UnderstandingFeedbackSummary, 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, searchActiveUnderstandings, 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 { createCollaborationRule, createContextEvidence, createUnderstanding, closeUnderstandingValidity, consumeContextConsent, deleteCollaborationRule, deleteUnderstanding, decideContextConsent, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, linkUnderstandingEvidence, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile, type CreateUnderstandingInput, } from './user-context-repository.js';
+export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
 export { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget, type ReplaceLatestSessionTurnInput, type ReplaceLatestSessionTurnResult, } from './session-turn-replace-repository.js';
 export { acknowledgeHomeAttention, isHomeAttentionAcknowledged, type HomeAttentionSubjectKind, } from './home-attention-repository.js';
 export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob, type ConnectorLearningJob, type ConnectorLearningMode, type ConnectorLearningPhase, type ConnectorLearningStatus, } from './connector-learning-repository.js';

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

@@ -6,10 +6,12 @@ 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 { claimContextExtractionRun, finishContextExtractionRun, getContextExtractionRun, hasIndependentExtractionOutput, listContextExtractionOutputs, listContextExtractionRuns } from "./context-extraction-repository.js";
+import { closeTemporalAssertions, createTemporalAssertion, linkContextObjects, listContextObjectRelations, listTemporalAssertions } from "./context-relation-repository.js";
 import { finishContextConsolidationRun, getContextConsolidationRun, listContextConsolidationDecisions, listContextConsolidationRuns, recordContextConsolidationDecision, startContextConsolidationRun } from "./context-consolidation-repository.js";
 import { summarizeUnderstandingFeedback, 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, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
+import { closeUnderstandingValidity, consumeContextConsent, createCollaborationRule, createContextEvidence, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, linkUnderstandingEvidence, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "./session-turn-replace-repository.js";
@@ -33,4 +35,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getConnectorAccount, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy } from "./connector-sync-policy-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, 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, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandings, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };