@xopcai/xopc 0.0.228 → 0.0.230

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

@@ -83,7 +83,9 @@ function validateProfileCandidate(value, allowedRefs) {
 	if (!value || typeof value !== "object") return null;
 	const item = value;
 	const category = item.category === "role" || item.category === "responsibility" || item.category === "preference" || item.category === "routine" ? item.category : void 0;
-	if (!category || typeof item.statement !== "string") return null;
+	if (!category || typeof item.statement !== "string" || typeof item.factKey !== "string") return null;
+	const factKey = item.factKey.trim().toLocaleLowerCase();
+	if (!/^[a-z0-9][a-z0-9:-]{2,119}$/.test(factKey)) return null;
 	const statement = item.statement.trim().slice(0, 500);
 	if (statement.length < 4) return null;
 	const confidence = item.confidence === "high" || item.confidence === "low" ? item.confidence : "medium";
@@ -92,6 +94,7 @@ function validateProfileCandidate(value, allowedRefs) {
 	return {
 		id: randomUUID(),
 		category,
+		factKey,
 		statement,
 		confidence,
 		evidence: strings(item.evidence, 4).map((entry) => entry.slice(0, 300)),
@@ -183,7 +186,8 @@ async function analyzeWorkContext(input) {
 			"Return only one JSON object with projectSummary, currentState, uncertainties, suggestions, profileCandidates, workThreads, conversationStarter, lowConfidence, and contextQuestion.",
 			"profileCandidates contains only user-specific role, responsibility, preference, or routine facts that are directly supported and would remain useful outside this repository snapshot.",
 			"Do not put the project stack, packages, architecture, deployment setup, repository conventions, or current task in profileCandidates. Put project facts in projectSummary/currentState and current work in workThreads.",
-			"Each profile candidate has category (role, responsibility, preference, or routine), statement, confidence, and evidence.",
+			"Each profile candidate has category (role, responsibility, preference, or routine), factKey, statement, confidence, and evidence.",
+			"factKey is a stable language-neutral lowercase identifier such as workflow:code-review:github; equivalent facts in different languages must use the same factKey.",
 			USER_FACING_UNDERSTANDING_WRITING_GUIDANCE,
 			"Do not infer sensitive traits, identity, health, finances, political views, or anything not directly supported by the work evidence.",
 			"workThreads contains every distinct evidence-backed work stream with topicKey, title, summary, horizon, status, confidence, and evidenceRefs. Do not merge unrelated streams to force a fixed count.",
@@ -288,7 +292,8 @@ async function analyzeUnderstandingBatch(input) {
 		"Return only one JSON object with profileCandidates and workThreads.",
 		"Return at most 8 profileCandidates and at most 8 workThreads. Prefer the strongest distinct findings.",
 		"profileCandidates contains only user-specific role, responsibility, preference, or routine facts with direct support. Current tasks belong in workThreads; project technologies, packages, architecture, and repository conventions are not user facts.",
-		"Each profile candidate has category (role, responsibility, preference, or routine), statement, confidence, evidence, and evidenceRefs.",
+		"Each profile candidate has category (role, responsibility, preference, or routine), factKey, statement, confidence, evidence, and evidenceRefs.",
+		"factKey is a stable language-neutral lowercase identifier such as workflow:code-review:github; equivalent facts in different languages must use the same factKey.",
 		USER_FACING_UNDERSTANDING_WRITING_GUIDANCE,
 		"Each work thread has topicKey, title, summary, status, horizon, confidence, and evidenceRefs.",
 		"Every evidenceRefs value must be one of the supplied refs. Omit anything without direct support.",
@@ -359,7 +364,7 @@ function mergeProfileCandidates(candidates) {
 		high: 3
 	};
 	for (const candidate of candidates) {
-		const key = `${candidate.category}:${candidate.statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim()}`;
+		const key = `${candidate.category}:${candidate.factKey}`;
 		const existing = merged.get(key);
 		if (!existing) {
 			merged.set(key, candidate);

package/dist/src/work-discovery/service.d.ts

@@ -68,6 +68,7 @@ export declare class WorkDiscoveryService {
             understandingId: string;
             id: string;
             category: "role" | "responsibility" | "preference" | "routine";
+            factKey: string;
             statement: string;
             confidence: "high" | "medium" | "low";
             evidence: string[];

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

@@ -164,8 +164,7 @@ function understandingKind(category) {
 	return "project_context";
 }
 function understandingKey(candidate) {
-	const normalized = candidate.statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-	return `work-discovery:${candidate.category}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`;
+	return `understanding:${understandingKind(candidate.category)}:${candidate.factKey}`;
 }
 function sameScope(left, right) {
 	return left.type === right.type && left.id === right.id;
@@ -202,7 +201,7 @@ function decideUnderstanding(input, expectedSourcePrefix) {
 	const current = getUnderstanding(input.understandingId);
 	const owned = current && listUnderstandingEvidence(current.id).some((evidence) => evidence.sourceRef.startsWith(expectedSourcePrefix));
 	if (!current || !owned || current.status === "archived") return void 0;
-	if (input.status === "rejected") return rejectUnderstanding(current.id, "Rejected from work discovery review");
+	if (input.status === "rejected") return rejectUnderstanding(current.id, "Rejected from work discovery review", "user");
 	const statement = input.status === "edited" ? input.statement?.trim().slice(0, 500) : void 0;
 	if (input.status === "edited" && !statement) return void 0;
 	return setUnderstandingStatus((statement ? reviseUnderstanding(current.id, statement, {
@@ -211,7 +210,9 @@ function decideUnderstanding(input, expectedSourcePrefix) {
 		changeReason: "Edited during work discovery review"
 	}) : current).id, "active", {
 		explicitness: "explicit",
-		confidence: 1
+		confidence: 1,
+		actorType: "user",
+		source: "work-discovery-review"
 	});
 }
 function sessionMetadata(agentId, peerId) {

package/dist/src/work-discovery/types.d.ts

@@ -167,6 +167,7 @@ export interface WorkDiscoveryProfileCandidate {
     id: string;
     understandingId?: string;
     category: 'role' | 'responsibility' | 'preference' | 'routine';
+    factKey: string;
     statement: string;
     confidence: 'high' | 'medium' | 'low';
     evidence: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.228",
+  "version": "0.0.230",
   "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",
@@ -108,22 +108,27 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
+    "@huggingface/transformers": "3.8.1",
     "@larksuiteoapi/node-sdk": "^1.66.0",
-    "playwright-core": "^1.60.0"
+    "playwright-core": "^1.60.0",
+    "sherpa-onnx-node": "1.13.4"
   },
   "peerDependenciesMeta": {
+    "@huggingface/transformers": {
+      "optional": true
+    },
     "@larksuiteoapi/node-sdk": {
       "optional": true
     },
     "playwright-core": {
       "optional": true
+    },
+    "sherpa-onnx-node": {
+      "optional": true
     }
   },
-  "optionalDependencies": {
-    "@huggingface/transformers": "3.8.1",
-    "sherpa-onnx-node": "1.13.4"
-  },
   "devDependencies": {
+    "@huggingface/transformers": "3.8.1",
     "@larksuiteoapi/node-sdk": "^1.66.0",
     "@resvg/resvg-js": "^2.6.2",
     "@tailwindcss/vite": "^4.3.0",
@@ -147,6 +152,7 @@
     "onnxruntime-common": "1.21.0",
     "node-pty": "1.1.0",
     "playwright-core": "^1.60.0",
+    "sherpa-onnx-node": "1.13.4",
     "svgo": "4.0.2",
     "tailwindcss": "^4.3.0",
     "tsdown": "0.21.10",
@@ -158,9 +164,9 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0"
+    "@xopcai/realtime-client": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",

package/dist/gateway/static/root/assets/settings-advanced-gate-Cco_W41x.js

@@ -1 +0,0 @@
-import{Or as e}from"./index-BX0dz1JK.js";function t(t){let{children:n,fallback:r}=t,i=r===void 0?null:r;return e()?n:i}export{t};

package/dist/src/agent/memory/understanding/correction.d.ts

@@ -1,3 +0,0 @@
-export declare function isExplicitUnderstandingCorrection(text: string): boolean;
-/** Returns only a concrete replacement statement; pure denials intentionally return null. */
-export declare function extractExplicitUnderstandingCorrectionContent(text: string): string | null;

package/dist/src/agent/memory/understanding/correction.js

@@ -1,39 +0,0 @@
-//#region src/agent/memory/understanding/correction.ts
-const UNDERSTANDING_CORRECTION_PATTERNS = [
-	/(?:你|您)(?:记错|理解错|搞错)(?:了)?(?:我|我的)/,
-	/(?:这|那)(?:不是|并非)我的(?:偏好|习惯|情况|信息|边界)/,
-	/我(?:没有|从没|从未)(?:说过|表示过|要求过)(?:这|那|这个|那个)/,
-	/(?:不要|别再)(?:认为|假设|记成)(?:我|我的)/,
-	/you (?:remembered|understood|got) (?:me|my .+?) wrong\b/i,
-	/that(?:'s| is) not my (?:preference|habit|situation|information|boundary)\b/i,
-	/i (?:never|did not|didn't) (?:say|said|tell you|told you|ask for|asked for) that\b/i,
-	/do not assume that about me\b/i
-];
-const UNDERSTANDING_CORRECTION_CONTENT_PATTERNS = [
-	/(?:你|您)(?:记错|理解错|搞错)(?:了)?(?:我|我的)(?:偏好|习惯|情况|信息|边界|工作方式)?[，,:：；;。]\s*(?:其实|实际上|正确的是)?\s*(.+)$/,
-	/(?:这|那)(?:不是|并非)我的(?:偏好|习惯|情况|信息|边界)[，,:：；;。]\s*(.+)$/,
-	/you (?:remembered|understood|got) (?:me|my .+?) wrong\b[,:;.]?\s*(?:actually[,:]?\s*)?(.+)$/i,
-	/that(?:'s| is) not my (?:preference|habit|situation|information|boundary)\b[,:;.]?\s*(.+)$/i
-];
-function normalizeCorrectionContent(content) {
-	const normalized = content.replace(/^[“”‘’"'\s]+|[“”‘’"'\s]+$/g, "").replace(/\s+/g, " ").trim();
-	return normalized.length >= 4 ? normalized.slice(0, 600) : null;
-}
-function isExplicitUnderstandingCorrection(text) {
-	const normalized = text.replace(/\s+/g, " ").trim();
-	return normalized.length > 0 && UNDERSTANDING_CORRECTION_PATTERNS.some((pattern) => pattern.test(normalized));
-}
-/** Returns only a concrete replacement statement; pure denials intentionally return null. */
-function extractExplicitUnderstandingCorrectionContent(text) {
-	const normalized = text.replace(/\s+/g, " ").trim();
-	if (!isExplicitUnderstandingCorrection(normalized)) return null;
-	for (const pattern of UNDERSTANDING_CORRECTION_CONTENT_PATTERNS) {
-		const match = pattern.exec(normalized);
-		if (!match?.[1]) continue;
-		const content = normalizeCorrectionContent(match[1]);
-		if (content) return content;
-	}
-	return null;
-}
-//#endregion
-export { extractExplicitUnderstandingCorrectionContent, isExplicitUnderstandingCorrection };

package/dist/src/knowledge/connected-understanding-pipeline.d.ts

@@ -1,17 +0,0 @@
-import type { UnderstandingCandidate, UnderstandingReviewResult } from '../agent/memory/understanding/types.js';
-import type { MemoryManager } from '../agent/memory/manager.js';
-import type { KnowledgeSourceItem } from './types.js';
-export type ClaimObservation = {
-    class: 'relationship' | 'project' | 'routine';
-    key: string;
-    value: Record<string, unknown>;
-    items: KnowledgeSourceItem[];
-    windowDays: number;
-};
-export declare function deriveConnectedClaimObservations(items: KnowledgeSourceItem[]): ClaimObservation[];
-export declare function renderConnectedObservation(observation: ClaimObservation): UnderstandingCandidate;
-export declare class ConnectedUnderstandingPipeline {
-    private readonly memoryManager;
-    constructor(memoryManager: MemoryManager);
-    process(agentId: string, extractionRunId: string): Promise<UnderstandingReviewResult>;
-}

package/dist/src/knowledge/connected-understanding-pipeline.js

@@ -1,278 +0,0 @@
-import { listKnowledgeSourceItems } from "../storage/sqlite/knowledge-repository.js";
-import "../storage/sqlite/index.js";
-import { clusterUnderstandingSignals } from "../user-context/sources/signal-clustering.js";
-import { personIdForIdentity, personIdentityKey, rebuildUserPeopleIndex } from "../user-context/relationships/indexer.js";
-//#region src/knowledge/connected-understanding-pipeline.ts
-function logicalEventKey(item) {
-	const value = item.metadata.logicalEventKey;
-	return typeof value === "string" && value.trim() ? value.trim() : void 0;
-}
-function eventTime(item) {
-	if (!item.occurredAt) return void 0;
-	const value = Date.parse(item.occurredAt);
-	return Number.isFinite(value) ? value : void 0;
-}
-function normalizedRecord(item) {
-	if (!item.normalizedText) return {};
-	try {
-		const value = JSON.parse(item.normalizedText);
-		return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-	} catch {
-		return {};
-	}
-}
-function textField(record, ...fields) {
-	for (const field of fields) {
-		const value = record[field];
-		if (typeof value === "string" && value.trim()) return value.trim();
-		if (value && typeof value === "object" && !Array.isArray(value)) {
-			const nested = value;
-			for (const nestedField of [
-				"name",
-				"full_name",
-				"fullName",
-				"title"
-			]) {
-				const nestedValue = nested[nestedField];
-				if (typeof nestedValue === "string" && nestedValue.trim()) return nestedValue.trim();
-			}
-		}
-	}
-}
-function normalizeConversationTitle(value) {
-	return value.replace(/^(?:(?:re|fwd?|回复|转发)\s*[:：]\s*)+/i, "").trim();
-}
-function projectSignal(item) {
-	if (item.metadata.actorAttributed !== true) return void 0;
-	const observationKind = item.metadata.observationKind;
-	if (![
-		"activity",
-		"message",
-		"calendar_event",
-		"external_task",
-		"document_metadata"
-	].includes(String(observationKind))) return;
-	const title = textField(normalizedRecord(item), "subject", "title", "repository", "project", "fullName", "full_name", "name");
-	const subjectKey = typeof item.metadata.subjectKey === "string" && item.metadata.subjectKey.trim() ? item.metadata.subjectKey.trim() : void 0;
-	const displayTitle = title ? normalizeConversationTitle(title) : subjectKey;
-	if (!displayTitle) return void 0;
-	return {
-		evidenceRef: item.id,
-		sourceId: item.sourceInstanceId,
-		title: displayTitle,
-		group: typeof item.metadata.toolkit === "string" ? item.metadata.toolkit : void 0,
-		subjectKey,
-		occurredAt: eventTime(item)
-	};
-}
-function recent(items, days) {
-	const now = Date.now();
-	const cutoff = now - days * 864e5;
-	return items.filter((item) => {
-		const time = eventTime(item);
-		return time !== void 0 && time >= cutoff && time <= now + 3e5 && logicalEventKey(item);
-	});
-}
-function person(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-	const row = value;
-	const read = (field) => typeof row[field] === "string" && row[field].trim() ? row[field].trim().slice(0, 160) : void 0;
-	const result = {
-		name: read("name"),
-		email: read("email"),
-		username: read("username")
-	};
-	return result.name || result.email || result.username ? result : void 0;
-}
-function relationshipObservations(items) {
-	const grouped = /* @__PURE__ */ new Map();
-	for (const item of recent(items, 90)) {
-		if (item.metadata.actorAttributed !== true) continue;
-		const owners = new Set(Array.isArray(item.metadata.ownerIdentities) ? item.metadata.ownerIdentities.filter((value) => typeof value === "string").map((value) => value.toLowerCase()) : []);
-		const values = item.metadata.personEntities;
-		if (!Array.isArray(values)) continue;
-		for (const value of values) {
-			const signal = person(value);
-			if (!signal) continue;
-			const strongIdentity = (signal.email ?? signal.username)?.toLowerCase();
-			if (strongIdentity && owners.has(strongIdentity)) continue;
-			const label = signal.name ?? signal.email ?? signal.username;
-			const identityKey = personIdentityKey(signal, item.sourceInstanceId);
-			const personId = personIdForIdentity(signal, item.sourceInstanceId);
-			if (!identityKey || !personId) continue;
-			const entry = grouped.get(identityKey) ?? {
-				label,
-				personId,
-				events: /* @__PURE__ */ new Map()
-			};
-			const eventKey = logicalEventKey(item);
-			if (!entry.events.has(eventKey)) entry.events.set(eventKey, item);
-			grouped.set(identityKey, entry);
-		}
-	}
-	return [...grouped.values()].sort((left, right) => right.events.size - left.events.size).slice(0, 8).map((entry) => ({
-		class: "relationship",
-		key: `person:${entry.personId}`,
-		value: {
-			label: entry.label,
-			personId: entry.personId
-		},
-		items: [...entry.events.values()],
-		windowDays: 90
-	}));
-}
-function routineObservations(items) {
-	const slots = /* @__PURE__ */ new Map();
-	for (const item of recent(items, 120).filter((candidate) => candidate.itemType === "calendar_event")) {
-		const date = new Date(item.occurredAt);
-		const slot = `${date.getUTCDay()}:${date.getUTCHours()}`;
-		const events = slots.get(slot) ?? /* @__PURE__ */ new Map();
-		const eventKey = logicalEventKey(item);
-		if (!events.has(eventKey)) events.set(eventKey, item);
-		slots.set(slot, events);
-	}
-	return [...slots.entries()].sort((left, right) => right[1].size - left[1].size).slice(0, 4).map(([slot, events]) => {
-		const [weekday, hour] = slot.split(":").map(Number);
-		return {
-			class: "routine",
-			key: `calendar-slot:${slot}`,
-			value: {
-				weekday,
-				hour,
-				timezone: "UTC"
-			},
-			items: [...events.values()],
-			windowDays: 120
-		};
-	});
-}
-function projectObservations(items) {
-	const recentItems = recent(items, 60);
-	const byId = new Map(recentItems.map((item) => [item.id, item]));
-	return clusterUnderstandingSignals(recentItems.map(projectSignal).filter((signal) => Boolean(signal))).flatMap((cluster) => {
-		const events = /* @__PURE__ */ new Map();
-		for (const signal of cluster.signals) {
-			const item = byId.get(signal.evidenceRef);
-			const eventKey = item && logicalEventKey(item);
-			if (item && eventKey && !events.has(eventKey)) events.set(eventKey, item);
-		}
-		if (![...events.values()].some((item) => item.itemType !== "calendar_event")) return [];
-		return [{
-			class: "project",
-			key: `project:${cluster.key}`,
-			value: { label: cluster.title },
-			items: [...events.values()],
-			windowDays: 60
-		}];
-	}).sort((left, right) => right.items.length - left.items.length).slice(0, 8);
-}
-function deriveConnectedClaimObservations(items) {
-	const active = items.filter((item) => !item.deletedAt && item.synthesisPipeline === "connected_knowledge" && item.sensitivity !== "secret" && item.sensitivity !== "regulated" && item.metadata.observationKind !== "inventory");
-	return [
-		...relationshipObservations(active),
-		...routineObservations(active),
-		...projectObservations(active)
-	];
-}
-function confidenceFor(observation) {
-	const days = new Set(observation.items.map((item) => item.occurredAt?.slice(0, 10)).filter(Boolean)).size;
-	return Math.min(.92, .48 + Math.min(observation.items.length, 8) * .035 + Math.min(days, 5) * .045);
-}
-function isDurableObservation(observation) {
-	const days = new Set(observation.items.map((item) => item.occurredAt?.slice(0, 10)).filter(Boolean)).size;
-	return observation.items.length >= 3 && days >= (observation.class === "routine" ? 3 : 2);
-}
-function renderConnectedObservation(observation) {
-	const label = typeof observation.value.label === "string" ? observation.value.label : "";
-	const confidence = confidenceFor(observation);
-	if (observation.class === "relationship") return {
-		kind: "relationship",
-		content: `Frequently collaborates with ${label}.`,
-		canonicalKey: `connected:${observation.key}`,
-		payload: typeof observation.value.personId === "string" ? { personId: observation.value.personId } : void 0,
-		confidence,
-		importance: .65,
-		explicitness: "inferred",
-		durability: "recurring",
-		sensitivity: "personal",
-		disclosurePolicy: "ask_before_reference"
-	};
-	if (observation.class === "project") return {
-		kind: "project_context",
-		content: `Recently contributed repeatedly to ${label}.`,
-		canonicalKey: `connected:${observation.key}`,
-		confidence,
-		importance: .72,
-		explicitness: "inferred",
-		durability: "recurring",
-		sensitivity: "personal",
-		disclosurePolicy: "referenceable"
-	};
-	const weekday = Number(observation.value.weekday);
-	const hour = Number(observation.value.hour);
-	return {
-		kind: "routine",
-		content: `Often has calendar activity on ${[
-			"Sunday",
-			"Monday",
-			"Tuesday",
-			"Wednesday",
-			"Thursday",
-			"Friday",
-			"Saturday"
-		][weekday] ?? "Unknown"} around ${String(hour).padStart(2, "0")}:00 UTC.`,
-		canonicalKey: `connected:${observation.key}`,
-		confidence,
-		importance: .58,
-		explicitness: "inferred",
-		durability: "recurring",
-		sensitivity: "personal",
-		disclosurePolicy: "referenceable"
-	};
-}
-var ConnectedUnderstandingPipeline = class {
-	constructor(memoryManager) {
-		this.memoryManager = memoryManager;
-	}
-	async process(agentId, extractionRunId) {
-		rebuildUserPeopleIndex();
-		const observations = deriveConnectedClaimObservations(listKnowledgeSourceItems({
-			agentId,
-			includeDeleted: false,
-			limit: 500
-		}));
-		const totals = {
-			proposed: observations.length,
-			created: 0,
-			deduplicated: 0,
-			rejected: 0,
-			createdRecords: []
-		};
-		for (const observation of observations) {
-			if (!isDurableObservation(observation)) continue;
-			const sourceInstanceIds = [...new Set(observation.items.map((item) => item.sourceInstanceId))];
-			const result = await this.memoryManager.applyUnderstandingCandidates([renderConnectedObservation(observation)], {
-				sourceItemIds: observation.items.map((item) => item.id).slice(0, 20),
-				sourceText: JSON.stringify({
-					independentEvidenceCount: observation.items.length,
-					activeDays: new Set(observation.items.map((item) => item.occurredAt?.slice(0, 10))).size,
-					windowDays: observation.windowDays
-				}),
-				source: {
-					provider: "connected-sources",
-					...sourceInstanceIds.length === 1 ? { sourceInstanceId: sourceInstanceIds[0] } : {}
-				},
-				reviewSource: "background",
-				extractionRunId
-			});
-			totals.created += result.created;
-			totals.deduplicated += result.deduplicated;
-			totals.rejected += result.rejected;
-			totals.createdRecords.push(...result.createdRecords);
-			totals.writeOutputs = [...totals.writeOutputs ?? [], ...result.writeOutputs ?? []];
-		}
-		return totals;
-	}
-};
-//#endregion
-export { ConnectedUnderstandingPipeline, deriveConnectedClaimObservations, renderConnectedObservation };