@xopcai/xopc 0.0.218 → 0.0.219

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

@@ -1,4 +1,5 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import "../domain.js";
 import { randomUUID } from "node:crypto";
 //#region src/user-context/sources/repository.ts
 function record(value) {
@@ -53,19 +54,82 @@ function runFromRow(row) {
 function focusFromRow(row) {
 	return {
 		id: row.focus_id,
+		versionId: row.current_version_id,
+		principalId: row.principal_id,
 		canonicalKey: row.canonical_key,
 		title: row.title,
 		summary: row.summary,
 		horizon: row.horizon,
 		status: row.status,
 		confidence: row.confidence,
-		...row.project_id ? { projectId: row.project_id } : {},
+		scope: {
+			type: row.scope_type,
+			...row.scope_id ? { id: row.scope_id } : {}
+		},
+		explicitness: row.explicitness,
+		sensitivity: row.sensitivity,
+		disclosurePolicy: row.disclosure_policy,
+		...row.valid_from == null ? {} : { validFrom: row.valid_from },
+		...row.valid_to == null ? {} : { validTo: row.valid_to },
+		...row.review_at == null ? {} : { reviewAt: row.review_at },
 		evidenceRefs: strings(row.evidence_refs_json),
 		...row.source_run_id ? { sourceRunId: row.source_run_id } : {},
 		createdAt: row.created_at,
 		updatedAt: row.updated_at
 	};
 }
+function focusSnapshot(row) {
+	return {
+		horizon: row.horizon,
+		status: row.status,
+		confidence: row.confidence,
+		scopeType: row.scope_type,
+		scopeId: row.scope_id,
+		explicitness: row.explicitness,
+		sensitivity: row.sensitivity,
+		disclosurePolicy: row.disclosure_policy,
+		validFrom: row.valid_from,
+		validTo: row.valid_to,
+		reviewAt: row.review_at,
+		evidenceRefs: strings(row.evidence_refs_json)
+	};
+}
+function sameFocusVersion(left, right) {
+	return Boolean(left && left.title === right.title && left.summary === right.summary && JSON.stringify(focusSnapshot(left)) === JSON.stringify(focusSnapshot(right)));
+}
+function linkFocusEvidence(versionId, evidenceRefs, confidence) {
+	if (!evidenceRefs.length) return;
+	const placeholders = evidenceRefs.map(() => "?").join(", ");
+	getSqliteDatabase().prepare(`INSERT OR IGNORE INTO user_focus_evidence_links (
+    version_id, evidence_id, relation, confidence
+  ) SELECT ?, evidence_id, 'supports', ? FROM context_evidence WHERE source_ref IN (${placeholders})`).run(versionId, confidence, ...evidenceRefs);
+}
+function listUserFocusEvidence(focusId) {
+	return getSqliteDatabase().prepare(`SELECT DISTINCT e.* FROM context_evidence e
+    JOIN user_focus_evidence_links l ON l.evidence_id = e.evidence_id
+    JOIN user_focus_versions v ON v.version_id = l.version_id
+    WHERE v.focus_id = ? ORDER BY e.observed_at DESC`).all(focusId).map((row) => ({
+		id: row.evidence_id,
+		sourceType: row.source_type,
+		...row.source_instance_id ? { sourceInstanceId: row.source_instance_id } : {},
+		sourceRef: row.source_ref,
+		...row.source_run_id ? { sourceRunId: row.source_run_id } : {},
+		...row.source_item_id ? { sourceItemId: row.source_item_id } : {},
+		...row.session_id ? { sessionId: row.session_id } : {},
+		...row.turn_id ? { turnId: row.turn_id } : {},
+		...row.message_id ? { messageId: row.message_id } : {},
+		...row.content_hash ? { contentHash: row.content_hash } : {},
+		...row.retention_policy ? { retentionPolicy: row.retention_policy } : {},
+		...row.processing_policy ? { processingPolicy: row.processing_policy } : {},
+		...row.extractor_id ? { extractorId: row.extractor_id } : {},
+		...row.extractor_version ? { extractorVersion: row.extractor_version } : {},
+		...row.redacted_excerpt ? { redactedExcerpt: row.redacted_excerpt } : {},
+		trustLevel: row.trust_level,
+		observedAt: row.observed_at,
+		ingestedAt: row.ingested_at ?? row.created_at,
+		createdAt: row.created_at
+	}));
+}
 function listUnderstandingSourceGrants(options = {}) {
 	return getSqliteDatabase().prepare(`SELECT * FROM understanding_source_grants ${options.includeRevoked ? "" : "WHERE status = 'active'"} ORDER BY updated_at DESC`).all().map(grantFromRow);
 }
@@ -85,8 +149,7 @@ function upsertUnderstandingSourceGrant(input) {
     ) VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(source_key) DO UPDATE SET
       adapter_id = excluded.adapter_id, category = excluded.category, platform = excluded.platform,
-      display_name = excluded.display_name, status = 'active', access_mode = excluded.access_mode,
-      retention_policy = excluded.retention_policy, processing_policy = excluded.processing_policy,
+      display_name = excluded.display_name, status = 'active',
       config_json = excluded.config_json, checkpoint_json = excluded.checkpoint_json,
       last_collected_at = COALESCE(excluded.last_collected_at, understanding_source_grants.last_collected_at),
       updated_at = excluded.updated_at
@@ -104,6 +167,16 @@ function updateUnderstandingSourceGrantCheckpoint(id, input) {
   `).run(JSON.stringify(input.checkpoint ?? current.checkpoint), input.lastCollectedAt ?? current.lastCollectedAt ?? null, now, id));
 	return getUnderstandingSourceGrant(id);
 }
+function updateUnderstandingSourceGrantPolicies(id, patch) {
+	const current = getUnderstandingSourceGrant(id);
+	if (!current) return null;
+	runSqliteWriteTransaction((db) => db.prepare(`
+    UPDATE understanding_source_grants
+    SET access_mode = ?, retention_policy = ?, processing_policy = ?, updated_at = ?
+    WHERE grant_id = ?
+  `).run(patch.accessMode ?? current.accessMode, patch.retentionPolicy ?? current.retentionPolicy, patch.processingPolicy ?? current.processingPolicy, patch.nowMs ?? Date.now(), id));
+	return getUnderstandingSourceGrant(id);
+}
 function revokeUnderstandingSourceGrant(id, nowMs = Date.now()) {
 	runSqliteWriteTransaction((db) => db.prepare("UPDATE understanding_source_grants SET status = 'revoked', updated_at = ? WHERE grant_id = ?").run(nowMs, id));
 	return getUnderstandingSourceGrant(id);
@@ -138,11 +211,20 @@ function updateUnderstandingSourceRun(id, patch) {
 function upsertUserFocus(input) {
 	const id = randomUUID();
 	const now = input.nowMs ?? Date.now();
-	runSqliteWriteTransaction((db) => db.prepare(`
+	const scope = input.scope ?? { type: "global" };
+	const explicitness = input.explicitness ?? "inferred";
+	const sensitivity = input.sensitivity ?? "normal";
+	const disclosurePolicy = input.disclosurePolicy ?? "referenceable";
+	const existingRow = getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE canonical_key = ?").get(input.canonicalKey);
+	if (existingRow?.explicitness === "explicit" && explicitness !== "explicit") return focusFromRow(existingRow);
+	let currentVersionId = existingRow?.current_version_id;
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`
     INSERT INTO user_focuses (
-      focus_id, canonical_key, title, summary, horizon, status, confidence, project_id,
-      evidence_refs_json, source_run_id, created_at, updated_at
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      focus_id, principal_id, canonical_key, title, summary, horizon, status, confidence,
+      scope_type, scope_id, explicitness, sensitivity, disclosure_policy,
+      valid_from, valid_to, review_at, evidence_refs_json, source_run_id, created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(canonical_key) DO UPDATE SET title = excluded.title, summary = excluded.summary,
       horizon = excluded.horizon,
       status = CASE
@@ -151,9 +233,23 @@ function upsertUserFocus(input) {
         ELSE excluded.status
       END,
       confidence = excluded.confidence,
-      project_id = excluded.project_id, evidence_refs_json = excluded.evidence_refs_json,
+      scope_type = excluded.scope_type, scope_id = excluded.scope_id,
+      explicitness = excluded.explicitness, sensitivity = excluded.sensitivity,
+      disclosure_policy = excluded.disclosure_policy, valid_from = excluded.valid_from,
+      valid_to = excluded.valid_to, review_at = excluded.review_at,
+      evidence_refs_json = excluded.evidence_refs_json,
       source_run_id = excluded.source_run_id, updated_at = excluded.updated_at
-  `).run(id, input.canonicalKey, input.title, input.summary, input.horizon, input.status, input.confidence, input.projectId ?? null, JSON.stringify(input.evidenceRefs), input.sourceRunId ?? null, now, now));
+  `).run(id, input.principalId ?? "local-owner", input.canonicalKey, input.title, input.summary, input.horizon, input.status, input.confidence, scope.type, scope.id ?? null, explicitness, sensitivity, disclosurePolicy, input.validFrom ?? null, input.validTo ?? null, input.reviewAt ?? null, JSON.stringify(input.evidenceRefs), input.sourceRunId ?? null, now, now);
+		const nextRow = db.prepare("SELECT * FROM user_focuses WHERE canonical_key = ?").get(input.canonicalKey);
+		if (!sameFocusVersion(existingRow, nextRow)) {
+			currentVersionId = randomUUID();
+			db.prepare(`INSERT INTO user_focus_versions (
+        version_id, focus_id, title, summary, snapshot_json, created_by, change_reason, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(currentVersionId, nextRow.focus_id, nextRow.title, nextRow.summary, JSON.stringify(focusSnapshot(nextRow)), explicitness === "explicit" ? "user" : input.sourceRunId ? "connector" : "runtime", input.changeReason ?? (existingRow ? "Focus updated" : "Focus created"), now);
+			db.prepare("UPDATE user_focuses SET current_version_id = ? WHERE focus_id = ?").run(currentVersionId, nextRow.focus_id);
+		}
+	});
+	if (currentVersionId) linkFocusEvidence(currentVersionId, input.evidenceRefs, input.confidence);
 	return focusFromRow(getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE canonical_key = ?").get(input.canonicalKey));
 }
 function listUserFocuses(statuses) {
@@ -161,8 +257,22 @@ function listUserFocuses(statuses) {
 	const placeholders = statuses.map(() => "?").join(", ");
 	return getSqliteDatabase().prepare(`SELECT * FROM user_focuses WHERE status IN (${placeholders}) ORDER BY updated_at DESC`).all(...statuses).map(focusFromRow);
 }
-function setUserFocusStatus(id, status, nowMs = Date.now()) {
-	runSqliteWriteTransaction((db) => db.prepare("UPDATE user_focuses SET status = ?, updated_at = ? WHERE focus_id = ?").run(status, nowMs, id));
+function updateUserFocus(id, patch, nowMs = Date.now()) {
+	const currentRow = getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE focus_id = ?").get(id);
+	if (!currentRow) return null;
+	const current = focusFromRow(currentRow);
+	if ((patch.title ?? current.title) === current.title && (patch.summary ?? current.summary) === current.summary && (patch.status ?? current.status) === current.status) return current;
+	const versionId = randomUUID();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE user_focuses
+      SET title = ?, summary = ?, status = ?, updated_at = ? WHERE focus_id = ?`).run(patch.title ?? current.title, patch.summary ?? current.summary, patch.status ?? current.status, nowMs, id);
+		const nextRow = db.prepare("SELECT * FROM user_focuses WHERE focus_id = ?").get(id);
+		db.prepare(`INSERT INTO user_focus_versions (
+      version_id, focus_id, title, summary, snapshot_json, created_by, change_reason, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, 'Focus updated', ?)`).run(versionId, id, nextRow.title, nextRow.summary, JSON.stringify(focusSnapshot(nextRow)), current.explicitness === "explicit" ? "user" : "runtime", nowMs);
+		db.prepare("UPDATE user_focuses SET current_version_id = ? WHERE focus_id = ?").run(versionId, id);
+	});
+	linkFocusEvidence(versionId, current.evidenceRefs, current.confidence);
 	const row = getSqliteDatabase().prepare("SELECT * FROM user_focuses WHERE focus_id = ?").get(id);
 	return row ? focusFromRow(row) : null;
 }
@@ -170,4 +280,4 @@ function deleteUserFocus(id) {
 	return Number(getSqliteDatabase().prepare("DELETE FROM user_focuses WHERE focus_id = ?").run(id).changes) > 0;
 }
 //#endregion
-export { createUnderstandingSourceRun, deleteUserFocus, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocuses, revokeUnderstandingSourceGrant, setUserFocusStatus, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant, upsertUserFocus };
+export { createUnderstandingSourceRun, deleteUserFocus, getUnderstandingSourceGrant, getUnderstandingSourceRun, listUnderstandingSourceGrants, listUnderstandingSourceRuns, listUserFocusEvidence, listUserFocuses, revokeUnderstandingSourceGrant, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceGrantPolicies, updateUnderstandingSourceRun, updateUserFocus, upsertUnderstandingSourceGrant, upsertUserFocus };

package/dist/src/user-context/sources/types.d.ts

@@ -1,3 +1,4 @@
+import type { UserContextScope, UserUnderstanding } from '../domain.js';
 export type UnderstandingSourcePlatform = 'darwin' | 'win32' | 'linux' | 'all';
 export type UnderstandingSourceCategory = 'files' | 'recent_documents' | 'calendar' | 'tasks' | 'notes' | 'mail' | 'messages' | 'code_activity';
 export type UnderstandingSourceAccessMode = 'once' | 'continuous';
@@ -75,13 +76,21 @@ export interface UnderstandingSourceRun {
 }
 export interface UserFocus {
     id: string;
+    versionId: string;
+    principalId: string;
     canonicalKey: string;
     title: string;
     summary: string;
     horizon: 'current' | 'ongoing' | 'long_term';
     status: 'candidate' | 'active' | 'paused' | 'completed' | 'rejected';
     confidence: number;
-    projectId?: string;
+    scope: UserContextScope;
+    explicitness: UserUnderstanding['explicitness'];
+    sensitivity: UserUnderstanding['sensitivity'];
+    disclosurePolicy: UserUnderstanding['disclosurePolicy'];
+    validFrom?: number;
+    validTo?: number;
+    reviewAt?: number;
     evidenceRefs: string[];
     sourceRunId?: string;
     createdAt: number;

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

@@ -8,7 +8,7 @@ function canonicalUnderstandingKey(kind, statement) {
 function isSameUserContextScope(left, right) {
 	return left.type === right.type && left.id === right.id;
 }
-const NEGATION = /\b(?:do not|don't|never|avoid|without)\b|(?:不要|不用|无需|从不|避免|禁止)/i;
+const NEGATION = /\b(?:do not|don't|not|never|avoid|without)\b|(?:不要|不用|无需|从不|避免|禁止)/i;
 function withoutNegation(statement) {
 	return statement.replace(NEGATION, "").replace(/\s+/g, " ").trim();
 }

package/dist/src/work-discovery/service.js

@@ -7,6 +7,7 @@ import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { createUnderstandingSourceRun, getUnderstandingSourceRun, updateUnderstandingSourceGrantCheckpoint, updateUnderstandingSourceRun, upsertUnderstandingSourceGrant, upsertUserFocus } from "../user-context/sources/repository.js";
+import { allowsRemoteSourceProcessing } from "../user-context/sources/processing-policy.js";
 import { analyzeUnderstandingSources, analyzeWorkContext, workDiscoveryResultMarkdown } from "./analyzer.js";
 import { previewWorkDiscoveryRoot, probeWorkDiscoveryRoot, summarizeWorkContextSnapshot } from "./probe.js";
 import { clusterActivityTopics } from "../user-context/sources/activity-clustering.js";
@@ -337,7 +338,7 @@ var WorkDiscoveryService = class {
 				displayName: sourceId,
 				accessMode: "once",
 				retentionPolicy: "derived_only",
-				processingPolicy: "remote_allowed",
+				processingPolicy: "local_only",
 				config: { readOnly: true }
 			});
 			sourceGrants.set(sourceId, grant);
@@ -393,7 +394,7 @@ var WorkDiscoveryService = class {
 		const linkedRun = runId ? getWorkDiscoveryRun(runId) : null;
 		let analysis;
 		try {
-			analysis = await analyzeUnderstandingSources({
+			analysis = allowsRemoteSourceProcessing([...changedSourceIds].map((sourceId) => sourceGrants.get(sourceId)?.processingPolicy ?? "local_only")) ? await analyzeUnderstandingSources({
 				config: this.options.getConfig(),
 				items: analysisItems,
 				...linkedRun?.result ? { workContext: {
@@ -403,7 +404,15 @@ var WorkDiscoveryService = class {
 					workThreads: linkedRun.result.workThreads
 				} } : {},
 				signal
-			});
+			}) : {
+				modelRef: "local-only",
+				profileCandidates: [],
+				workThreadCandidates: [],
+				sourceStatuses: [...changedSourceIds].map((sourceId) => ({
+					sourceId,
+					status: "completed"
+				}))
+			};
 			const statusBySource = new Map(analysis.sourceStatuses.map((item) => [item.sourceId, item]));
 			for (const [sourceId, sourceRunId] of sourceRuns) {
 				if (!changedSourceIds.has(sourceId)) continue;
@@ -785,7 +794,10 @@ var WorkDiscoveryService = class {
 				horizon: thread.horizon,
 				status: "candidate",
 				confidence: thread.confidence,
-				projectId: run.projectId,
+				scope: {
+					type: "project",
+					id: run.projectId
+				},
 				evidenceRefs: thread.evidenceIds
 			}));
 			const result = this.persistProfileCandidates(run, {
@@ -1020,7 +1032,11 @@ var WorkDiscoveryService = class {
 			horizon: "current",
 			status: "active",
 			confidence: 1,
-			projectId: run.projectId,
+			scope: {
+				type: "project",
+				id: run.projectId
+			},
+			explicitness: "explicit",
 			evidenceRefs: [`session://${createHash("sha256").update(run.sessionKey).digest("hex").slice(0, 16)}/recognition`]
 		});
 		const investigation = getWorkUnderstandingInvestigationForRun(run.id);

package/dist/src/work-discovery/source-repository.js

@@ -40,7 +40,7 @@ function upsertWorkDiscoveryDirectorySource(input) {
 		displayName: input.displayName,
 		accessMode: "continuous",
 		retentionPolicy: "derived_only",
-		processingPolicy: "remote_allowed",
+		processingPolicy: "local_only",
 		config: {
 			rootPath: input.rootPath,
 			readOnly: true

package/dist/src/workflows/service/workflow-run-service.js

@@ -1,6 +1,6 @@
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.218",
+  "version": "0.0.219",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -163,10 +163,10 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0"
+    "@xopcai/realtime-client": "0.0.0",
+    "@xopcai/endpoint-tools-protocol": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",