@xopcai/xopc 0.0.247 → 0.0.249

package/dist/src/user-context/relationships/service.js

@@ -1,50 +0,0 @@
-import { listUnderstandings } from "../../storage/sqlite/user-context-repository.js";
-import { getUserPerson, listUserPeople, mergeUserPeople, summarizeUserPeople, updateUserPerson } from "../../storage/sqlite/user-people-repository.js";
-import "../../storage/sqlite/index.js";
-import { ensureUserPeopleIndex } from "./indexer.js";
-//#region src/user-context/relationships/service.ts
-function withUnderstanding(person) {
-	const understanding = listUnderstandings().find((item) => item.kind === "relationship" && item.payload.personId === person.id && !["archived", "rejected"].includes(item.status));
-	return understanding ? {
-		...person,
-		relationshipUnderstanding: {
-			id: understanding.id,
-			statement: understanding.statement,
-			status: understanding.status
-		}
-	} : person;
-}
-function listUserRelationships(options = {}) {
-	ensureUserPeopleIndex();
-	const offset = options.cursor && /^\d+$/.test(options.cursor) ? Number(options.cursor) : 0;
-	const result = listUserPeople({
-		query: options.query,
-		kind: options.kind,
-		sourceInstanceId: options.sourceInstanceId,
-		includeHidden: options.includeHidden,
-		hiddenOnly: options.hiddenOnly,
-		offset,
-		limit: options.limit
-	});
-	return {
-		items: result.items.map(withUnderstanding),
-		summary: summarizeUserPeople(),
-		total: result.total,
-		...result.nextOffset === void 0 ? {} : { nextCursor: String(result.nextOffset) }
-	};
-}
-function getUserRelationship(personId) {
-	ensureUserPeopleIndex();
-	const person = getUserPerson(personId);
-	return person ? withUnderstanding(person) : null;
-}
-function patchUserRelationship(personId, patch) {
-	const person = updateUserPerson(personId, patch);
-	return person ? withUnderstanding(person) : null;
-}
-function mergeUserRelationships(sourcePersonId, targetPersonId) {
-	const person = mergeUserPeople(sourcePersonId, targetPersonId);
-	return person ? withUnderstanding(person) : null;
-}
-//#endregion
-export { getUserRelationship, listUserRelationships, mergeUserRelationships, patchUserRelationship };

package/dist/src/user-context/retriever.d.ts

@@ -1,15 +0,0 @@
-import type { UserUnderstanding } from './domain.js';
-export interface UnderstandingRetrievalResult {
-    understanding: UserUnderstanding;
-    score: number;
-    reasons: string[];
-}
-export declare class UserUnderstandingRetriever {
-    retrieve(params: {
-        query: string;
-        sessionKey: string;
-        workspaceId: string;
-        projectId?: string;
-        maxCandidates: number;
-    }): UnderstandingRetrievalResult[];
-}

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

@@ -1,124 +0,0 @@
-import { summarizeUnderstandingFeedback } from "../storage/sqlite/user-context-quality-repository.js";
-import { listUnderstandings, searchActiveUnderstandings, understandingSourceBuckets } from "../storage/sqlite/user-context-repository.js";
-import { normalizeRetrievalText, retrievalLexicalSimilarity } from "../retrieval/textFeatures.js";
-import { buildRetrievalQueryProfile } from "../retrieval/queryProfile.js";
-import "../storage/sqlite/index.js";
-import { matchesUserContextScope } from "./scope.js";
-//#region src/user-context/retriever.ts
-function authorityBonus(item) {
-	if (item.explicitness === "explicit") return .1;
-	if (item.explicitness === "observed") return .05;
-	return 0;
-}
-function baseline(item) {
-	if (item.kind === "boundary" && item.explicitness === "explicit") return .8;
-	if (item.kind === "preference" && item.explicitness === "explicit") return .12;
-	return 0;
-}
-function temporalAdjustment(item, hints, now) {
-	if (!hints.length) return 0;
-	let score = 0;
-	if (hints.includes("historical")) score += item.validTo !== void 0 || item.status === "archived" || item.status === "stale" ? .14 : -.6;
-	if (hints.includes("current")) {
-		if (item.kind === "current_state" || item.validFrom !== void 0 || item.validTo !== void 0) {
-			const validNow = (item.validFrom === void 0 || item.validFrom <= now) && (item.validTo === void 0 || item.validTo > now);
-			score += validNow ? .08 : -.15;
-			if (item.kind === "current_state") score += .06;
-		}
-	}
-	if (hints.includes("recent")) score += now - item.updatedAt <= 2160 * 60 * 6e4 ? .08 : -.04;
-	if (hints.includes("future")) {
-		if ((item.validFrom ?? 0) > now || item.kind === "long_term_goal") score += .1;
-	}
-	return score;
-}
-function diversify(results, limit) {
-	const remaining = [...results];
-	const selected = [];
-	const sourceCounts = /* @__PURE__ */ new Map();
-	const redundancies = /* @__PURE__ */ new Map();
-	const evidenceBuckets = understandingSourceBuckets(results.filter((result) => result.understanding.explicitness !== "explicit").map((result) => result.understanding.id));
-	const sourceBuckets = new Map(results.map(({ understanding: item }) => [item.id, item.explicitness === "explicit" ? "user" : evidenceBuckets.get(item.id) ?? `unknown:${item.id}`]));
-	while (remaining.length && selected.length < limit) {
-		let bestIndex = 0;
-		let bestScore = Number.NEGATIVE_INFINITY;
-		for (const [index, candidate] of remaining.entries()) {
-			const redundancy = redundancies.get(candidate.understanding.id) ?? 0;
-			const bucket = sourceBuckets.get(candidate.understanding.id);
-			const sourcePenalty = candidate.understanding.explicitness === "explicit" ? 0 : (sourceCounts.get(bucket) ?? 0) * .04;
-			const adjusted = candidate.score - redundancy * .18 - sourcePenalty;
-			if (adjusted > bestScore) {
-				bestScore = adjusted;
-				bestIndex = index;
-			}
-		}
-		const candidate = remaining.splice(bestIndex, 1)[0];
-		const bucket = sourceBuckets.get(candidate.understanding.id);
-		sourceCounts.set(bucket, (sourceCounts.get(bucket) ?? 0) + 1);
-		selected.push({
-			...candidate,
-			score: Math.max(0, bestScore),
-			reasons: bestScore < candidate.score ? [...candidate.reasons, "diversified"] : candidate.reasons
-		});
-		if (selected.length < limit) for (const remainingItem of remaining) {
-			const id = remainingItem.understanding.id;
-			redundancies.set(id, Math.max(redundancies.get(id) ?? 0, retrievalLexicalSimilarity(remainingItem.understanding.statement, candidate.understanding.statement)));
-		}
-	}
-	return selected;
-}
-function feedbackAdjustment(summary) {
-	if (!summary || summary.total < 3) return 0;
-	const helpfulRate = (summary.helpful + 1) / (summary.total + 2);
-	const relevancePenalty = summary.irrelevant >= 3 ? .05 : 0;
-	return Math.max(-.1, Math.min(.05, (helpfulRate - .5) * .1 - relevancePenalty));
-}
-var UserUnderstandingRetriever = class {
-	retrieve(params) {
-		const profile = buildRetrievalQueryProfile(params.query, {
-			sessionKey: params.sessionKey,
-			workspaceId: params.workspaceId,
-			...params.projectId ? { projectId: params.projectId } : {}
-		});
-		if (!profile.normalized) return [];
-		const maxCandidates = Math.max(1, Math.min(200, Math.floor(params.maxCandidates)));
-		const fts = searchActiveUnderstandings(profile.expanded, Math.max(50, maxCandidates));
-		const ftsScores = new Map(fts.map((result) => [result.understanding.id, result.score]));
-		const recentLimit = Math.max(200, Math.min(500, maxCandidates * 5));
-		const recent = listUnderstandings([...profile.timeHints.includes("historical") ? [
-			"active",
-			"archived",
-			"stale"
-		] : ["active"]], void 0, recentLimit);
-		const candidates = /* @__PURE__ */ new Map();
-		for (const result of fts) candidates.set(result.understanding.id, result.understanding);
-		for (const item of recent) candidates.set(item.id, item);
-		const feedback = new Map(summarizeUnderstandingFeedback([...candidates.keys()]).map((summary) => [summary.understandingId, summary]));
-		const now = Date.now();
-		return diversify([...candidates.values()].map((item) => {
-			const lexical = Math.max(retrievalLexicalSimilarity(profile.normalized, item.statement), retrievalLexicalSimilarity(profile.expanded, item.statement));
-			const ftsScore = ftsScores.get(item.id) ?? 0;
-			const textScore = Math.max(lexical, ftsScore);
-			const kindMatched = profile.intentKinds.includes(item.kind);
-			const normalizedStatement = normalizeRetrievalText(item.statement);
-			const identifierMatched = profile.identifiers.some((identifier) => normalizedStatement.includes(identifier));
-			const feedbackScore = feedbackAdjustment(feedback.get(item.id));
-			const kindAdjustment = profile.intentKinds.length > 0 && !kindMatched && profile.timeHints.length === 0 ? -.35 : 0;
-			return {
-				understanding: item,
-				score: Math.min(1, Math.max(0, Math.max(baseline(item), textScore * .7 + lexical * .1 + item.confidence * .1 + authorityBonus(item) + (kindMatched ? .08 : 0) + kindAdjustment + (identifierMatched ? .12 : 0) + temporalAdjustment(item, profile.timeHints, now) + (matchesUserContextScope(item.scope, params) && item.scope.type !== "global" ? .05 : 0)) + feedbackScore)),
-				reasons: [
-					ftsScore > 0 ? "fts" : "",
-					lexical > 0 ? "lexical" : "",
-					identifierMatched ? "identifier" : "",
-					kindMatched ? "kind" : "",
-					item.explicitness === "explicit" ? "explicit" : "",
-					feedbackScore !== 0 ? "feedback" : "",
-					temporalAdjustment(item, profile.timeHints, now) !== 0 ? "temporal" : ""
-				].filter(Boolean)
-			};
-		}).sort((left, right) => Number(matchesUserContextScope(right.understanding.scope, params)) - Number(matchesUserContextScope(left.understanding.scope, params)) || right.score - left.score || right.understanding.updatedAt - left.understanding.updatedAt), maxCandidates);
-	}
-};
-//#endregion
-export { UserUnderstandingRetriever };

package/dist/src/user-context/scope.d.ts

@@ -1,7 +0,0 @@
-import type { UserContextScope } from './domain.js';
-export interface UserContextScopeTarget {
-    sessionKey: string;
-    workspaceId: string;
-    projectId?: string;
-}
-export declare function matchesUserContextScope(scope: UserContextScope, target: UserContextScopeTarget): boolean;

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

@@ -1,9 +0,0 @@
-//#region src/user-context/scope.ts
-function matchesUserContextScope(scope, target) {
-	if (scope.type === "global") return true;
-	if (scope.type === "session") return scope.id === target.sessionKey;
-	if (scope.type === "workspace") return scope.id === target.workspaceId;
-	return Boolean(target.projectId && scope.id === target.projectId);
-}
-//#endregion
-export { matchesUserContextScope };

package/dist/src/user-context/selection-policy.d.ts

@@ -1,20 +0,0 @@
-import type { UserContextRejectionReason } from '../agent/memory/context/types.js';
-import type { UserUnderstanding } from './domain.js';
-import type { UserFocus } from './sources/types.js';
-/** Automatic remote context never uses sensitive, consent-gated or weakly inferred facts. */
-export declare function allowsAutomaticDisclosure(item: Pick<UserUnderstanding, 'sensitivity' | 'disclosurePolicy' | 'explicitness' | 'confidence'>): boolean;
-export declare function rejectionReason(item: UserUnderstanding, input: {
-    sessionKey: string;
-    workspaceId: string;
-    projectId?: string;
-}, now: number, timeHints: string[]): UserContextRejectionReason | undefined;
-export declare function focusRejectionReason(focus: UserFocus, input: {
-    sessionKey: string;
-    workspaceId: string;
-    projectId?: string;
-}, now: number): UserContextRejectionReason | undefined;
-export declare function focusScore(focus: UserFocus, query: string, scopeInput: {
-    sessionKey: string;
-    workspaceId: string;
-    projectId?: string;
-}): number;

package/dist/src/user-context/selection-policy.js

@@ -1,33 +0,0 @@
-import { retrievalLexicalSimilarity } from "../retrieval/textFeatures.js";
-import { buildRetrievalQueryProfile } from "../retrieval/queryProfile.js";
-import { matchesUserContextScope } from "./scope.js";
-//#region src/user-context/selection-policy.ts
-/** Automatic remote context never uses sensitive, consent-gated or weakly inferred facts. */
-function allowsAutomaticDisclosure(item) {
-	return item.sensitivity === "normal" && item.disclosurePolicy !== "ask_before_reference" && (item.explicitness !== "inferred" || item.confidence >= .8);
-}
-function rejectionReason(item, input, now, timeHints) {
-	const historical = timeHints.includes("historical") && item.validTo !== void 0;
-	if (item.status === "needs_review" || item.status === "candidate" || item.status === "stale" && !historical) return "needs_review";
-	if (item.status === "rejected" || item.status === "archived" && !historical) return "disabled";
-	if (!matchesUserContextScope(item.scope, input)) return "scope_mismatch";
-	if (item.validFrom && item.validFrom > now && !timeHints.includes("future")) return "not_yet_valid";
-	if ((item.validTo && item.validTo < now || item.expiresAt && item.expiresAt < now) && !historical) return "expired";
-	if (item.sensitivity === "secret" || item.sensitivity === "regulated") return "sensitive";
-	if (item.conflictGroupId) return "conflict";
-}
-function focusRejectionReason(focus, input, now) {
-	if (focus.status !== "active") return "disabled";
-	if (!matchesUserContextScope(focus.scope, input)) return "scope_mismatch";
-	if (focus.validFrom && focus.validFrom > now) return "not_yet_valid";
-	if (focus.validTo && focus.validTo < now) return "expired";
-	if (focus.sensitivity === "secret" || focus.sensitivity === "regulated") return "sensitive";
-	if (focus.disclosurePolicy === "ask_before_reference") return "requires_consent";
-}
-function focusScore(focus, query, scopeInput) {
-	const lexical = retrievalLexicalSimilarity(buildRetrievalQueryProfile(query, scopeInput).normalized, `${focus.title} ${focus.summary}`);
-	const scoped = focus.scope.type !== "global" && matchesUserContextScope(focus.scope, scopeInput);
-	return Math.min(1, lexical * .75 + focus.confidence * .15 + (scoped ? .25 : 0));
-}
-//#endregion
-export { allowsAutomaticDisclosure, focusRejectionReason, focusScore, rejectionReason };

package/dist/src/user-context/understanding.d.ts

@@ -1,15 +0,0 @@
-import type { UnderstandingKind, UserContextScope, UserUnderstanding } from './domain.js';
-export declare function canonicalUnderstandingKey(kind: UnderstandingKind, statement: string): string;
-export declare function isSameUserContextScope(left: UserContextScope, right: UserContextScope): boolean;
-export declare function findDuplicateUnderstanding(understandings: UserUnderstanding[], input: {
-    kind: UnderstandingKind;
-    statement: string;
-    canonicalKey: string;
-    scope: UserContextScope;
-    excludeId?: string;
-}): UserUnderstanding | undefined;
-export declare function findContradictoryUnderstanding(understandings: UserUnderstanding[], input: {
-    kind: UnderstandingKind;
-    statement: string;
-    scope: UserContextScope;
-}): UserUnderstanding | undefined;

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

@@ -1,24 +0,0 @@
-import { isNearDuplicateUnderstanding } from "./understandingQuality.js";
-import { createHash } from "node:crypto";
-//#region src/user-context/understanding.ts
-function canonicalUnderstandingKey(kind, statement) {
-	const normalized = statement.normalize("NFKC").toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-	return `${kind}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`;
-}
-function isSameUserContextScope(left, right) {
-	return left.type === right.type && left.id === right.id;
-}
-const NEGATION = /\b(?:do not|don't|not|never|avoid|without)\b|(?:不要|不用|无需|从不|避免|禁止)/i;
-function withoutNegation(statement) {
-	return statement.replace(NEGATION, "").replace(/\s+/g, " ").trim();
-}
-function findDuplicateUnderstanding(understandings, input) {
-	const inputIsNegative = NEGATION.test(input.statement);
-	return understandings.find((item) => item.id !== input.excludeId && item.kind === input.kind && item.status !== "archived" && item.status !== "rejected" && isSameUserContextScope(item.scope, input.scope) && (item.canonicalKey === input.canonicalKey || NEGATION.test(item.statement) === inputIsNegative && isNearDuplicateUnderstanding(item.statement, input.statement)));
-}
-function findContradictoryUnderstanding(understandings, input) {
-	const inputIsNegative = NEGATION.test(input.statement);
-	return understandings.find((item) => item.kind === input.kind && item.status === "active" && isSameUserContextScope(item.scope, input.scope) && NEGATION.test(item.statement) !== inputIsNegative && isNearDuplicateUnderstanding(withoutNegation(item.statement), withoutNegation(input.statement)));
-}
-//#endregion
-export { canonicalUnderstandingKey, findContradictoryUnderstanding, findDuplicateUnderstanding, isSameUserContextScope };

package/dist/src/user-context/understandingQuality.d.ts

@@ -1,5 +0,0 @@
-import type { MemoryKind } from '../agent/memory/types.js';
-export declare function isStandaloneUnderstandingContent(content: string): boolean;
-export declare function isActionableUnderstandingContent(content: string): boolean;
-export declare function isDurableUnderstandingCandidate(kind: MemoryKind, content: string): boolean;
-export declare function isNearDuplicateUnderstanding(left: string, right: string): boolean;

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

@@ -1,48 +0,0 @@
-//#region src/user-context/understandingQuality.ts
-const INCOMPLETE_PREFIX = /^(?:and\b|also\b|then\b|plus\b|as\s+well\s+as\b|which\b|that\b|并且|并将|以及|然后|同时|另外|还有|而且|或者|的事项|事项[，,、：:]?)/i;
-const DEFERRED_OR_NEGATED_ACTION = /(?:not\s+now|no\s+need\s+to|do\s+not\s+(?:start|proceed)|don't\s+(?:start|proceed)|later\s+maybe|暂时不用|暂时不(?:用|要|开始)?|先不用|无需|不用开始|不要推进|不需要推进)/i;
-const ONE_OFF_ACTION_PREFIX = /^(?:please\s+|update\b|investigate\b|summari[sz]e\b|fix\b|write\b|add\b|record\b|track\b)|^(?:请|帮我|更新|调查|汇总|整理|修复|写入|加入|记录|跟进)/i;
-const DURABLE_MARKER = /(?:从现在起|今后|以后|长期|每次|每回|始终|一直|默认|下次|教训|原则|习惯|from now on|going forward|long[- ]term|every time|always|by default|next time|lesson|principle|habit)/i;
-const TURN_EXECUTION_INSTRUCTION = /(?:不要再问|别再问|直接执行|立即执行|当前任务|这次|本次|现在就|do not ask|don't ask|just do it|execute directly|proceed now|this task|this time)/i;
-function meaningfulLength(content) {
-	return content.normalize("NFKC").replace(/[\p{P}\p{S}\s]/gu, "").length;
-}
-function isStandaloneUnderstandingContent(content) {
-	const normalized = content.normalize("NFKC").trim();
-	return meaningfulLength(normalized) >= 4 && !INCOMPLETE_PREFIX.test(normalized) && !DEFERRED_OR_NEGATED_ACTION.test(normalized);
-}
-function isActionableUnderstandingContent(content) {
-	return meaningfulLength(content) >= 8 && isStandaloneUnderstandingContent(content);
-}
-function isDurableUnderstandingCandidate(kind, content) {
-	if (!isStandaloneUnderstandingContent(content)) return false;
-	if ((kind === "commitment" || kind === "long_term_goal") && ONE_OFF_ACTION_PREFIX.test(content.trim())) return false;
-	if (kind === "task_lesson" && !DURABLE_MARKER.test(content)) return false;
-	if (kind === "boundary" && TURN_EXECUTION_INSTRUCTION.test(content) && !DURABLE_MARKER.test(content)) return false;
-	return true;
-}
-function comparableText(content) {
-	return content.normalize("NFKC").toLocaleLowerCase().replace(/[\p{P}\p{S}\s]/gu, "");
-}
-function bigrams(content) {
-	const result = /* @__PURE__ */ new Set();
-	for (let index = 0; index < content.length - 1; index += 1) result.add(content.slice(index, index + 2));
-	return result;
-}
-function isNearDuplicateUnderstanding(left, right) {
-	const a = comparableText(left);
-	const b = comparableText(right);
-	if (!a || !b) return false;
-	if (a === b) return true;
-	const shorter = a.length <= b.length ? a : b;
-	const longer = a.length > b.length ? a : b;
-	if (shorter.length >= 8 && longer.includes(shorter) && shorter.length / longer.length >= .55) return true;
-	if (shorter.length < 4) return false;
-	const aPairs = bigrams(a);
-	const bPairs = bigrams(b);
-	let overlap = 0;
-	for (const pair of aPairs) if (bPairs.has(pair)) overlap += 1;
-	return 2 * overlap / (aPairs.size + bPairs.size) >= .78;
-}
-//#endregion
-export { isActionableUnderstandingContent, isDurableUnderstandingCandidate, isNearDuplicateUnderstanding, isStandaloneUnderstandingContent };