@xopcai/xopc 0.0.247 → 0.0.249

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

@@ -1,465 +0,0 @@
-import { consumeContextConsent, ensureContextConsent, getUserProfile, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextRun } from "../storage/sqlite/user-context-repository.js";
-import { buildRetrievalQueryProfile } from "../retrieval/queryProfile.js";
-import "../storage/sqlite/index.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
-import { ProjectStore } from "../projects/project-store.js";
-import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
-import { buildUserContextBlock } from "../agent/memory/context-fence.js";
-import { getUnderstandingSourceGrant, getUnderstandingSourceRun, listUserFocuses } from "./sources/repository.js";
-import { matchesUserContextScope } from "./scope.js";
-import { UserUnderstandingRetriever } from "./retriever.js";
-import { focusRejectionReason, focusScore, rejectionReason } from "./selection-policy.js";
-import { randomUUID } from "node:crypto";
-//#region src/user-context/planner.ts
-init_session_key();
-const DEFAULT_MAX_CONTEXT_CHARS = 6e3;
-const DEFAULT_MAX_RESULTS = 12;
-const SELF_REVIEW_MAX_CONTEXT_CHARS = 16e3;
-const SELF_REVIEW_MAX_RESULTS = 50;
-const MAX_FOCUS_RESULTS = 3;
-const MIN_RELEVANCE_SCORE = .25;
-function selfReviewScore(item) {
-	const authority = item.explicitness === "explicit" ? .2 : item.explicitness === "observed" ? .1 : 0;
-	const durable = item.durability === "durable" ? .1 : item.durability === "recurring" ? .05 : 0;
-	return Math.min(1, item.confidence * .7 + authority + durable);
-}
-function scopeLabel(scope, projects) {
-	if (scope.type === "global") return "Global";
-	if (scope.type === "project") return `Project: ${scope.id ? projects.get(scope.id)?.name ?? scope.id : "unknown"}`;
-	if (scope.type === "workspace") return `Workspace: ${scope.id ?? "unknown"}`;
-	return "This conversation";
-}
-function prependAgentContext(message, block) {
-	if (!block) return message;
-	const prefix = `${block}\n\n`;
-	const content = readAgentMessageContent(message);
-	if (typeof content === "string") return {
-		...message,
-		content: prefix + content
-	};
-	if (Array.isArray(content)) {
-		const copy = [...content];
-		const first = copy[0];
-		if (first?.type === "text" && typeof first.text === "string") copy[0] = {
-			type: "text",
-			text: prefix + first.text
-		};
-		else copy.unshift({
-			type: "text",
-			text: prefix
-		});
-		return {
-			...message,
-			content: copy
-		};
-	}
-	return message;
-}
-function sectionFor(item) {
-	if (item.kind === "boundary") return "safety";
-	if ([
-		"preference",
-		"relationship",
-		"routine"
-	].includes(item.kind)) return "interaction";
-	return "task";
-}
-function sourceDescription(item) {
-	if (item.explicitness === "explicit") return {
-		origin: "told_by_user",
-		label: "You told xopc"
-	};
-	const connected = listUnderstandingEvidence(item.id).find((evidence) => evidence.sourceType === "connector");
-	if (connected) return {
-		origin: "connected_source",
-		label: connected.sourceInstanceId ?? "Connected source"
-	};
-	if (item.explicitness === "observed") return {
-		origin: "observed",
-		label: "Observed across prior work"
-	};
-	return {
-		origin: "inferred",
-		label: "An inference that may be wrong"
-	};
-}
-function focusSourceDescription(focus) {
-	if (focus.explicitness === "explicit") return {
-		origin: "told_by_user",
-		label: "You set this focus"
-	};
-	const sourceRun = focus.sourceRunId ? getUnderstandingSourceRun(focus.sourceRunId) : null;
-	const grant = sourceRun ? getUnderstandingSourceGrant(sourceRun.grantId) : null;
-	if (grant?.adapterId.startsWith("connector:")) return {
-		origin: "connected_source",
-		label: grant.displayName
-	};
-	if (focus.explicitness === "observed") return {
-		origin: "observed",
-		label: "Observed across prior work"
-	};
-	return {
-		origin: "inferred",
-		label: "Suggested from prior work"
-	};
-}
-function ruleMatches(rule, input) {
-	if (rule.status !== "active" || !matchesUserContextScope(rule.scope, input)) return false;
-	const channel = typeof rule.conditions.channel === "string" ? rule.conditions.channel : void 0;
-	const agentId = typeof rule.conditions.agentId === "string" ? rule.conditions.agentId : void 0;
-	return (!channel || channel === input.channel) && (!agentId || agentId === input.agentId);
-}
-function renderContextBlock(params) {
-	const understandingItems = params.items.filter((item) => item.objectType === "understanding");
-	return [
-		params.selfReview ? [
-			"<user-context-review>",
-			"The user explicitly asked what xopc understands about them. This is a review of active, non-sensitive structured understanding across scopes.",
-			"Scope labels describe where each item applies. Do not present project facts as global personality traits.",
-			"An empty memory_search result does not mean structured user understanding is empty.",
-			"</user-context-review>"
-		].join("\n") : "",
-		params.profileLines.length ? `<user-profile>\n${params.profileLines.join("\n")}\n</user-profile>` : "",
-		params.focuses.length ? `<active-focuses>\n${params.focuses.map((focus) => `- ${params.selfReview ? `[${scopeLabel(focus.scope, params.projects)}] ` : ""}${focus.title}: ${focus.summary} (${focus.horizon})`).join("\n")}\n</active-focuses>` : "",
-		params.rules.length ? `<collaboration-contract>\n${params.rules.map((rule) => `- ${rule.statement}`).join("\n")}\n</collaboration-contract>` : "",
-		understandingItems.length ? buildUserContextBlock(understandingItems.map((item) => `- ${item.content}\n  Evidence: ${params.understandingSources.get(item.recordId) ?? "Unknown source"}`).join("\n")) : ""
-	].filter(Boolean).join("\n\n");
-}
-var UserContextPlanner = class {
-	retriever = new UserUnderstandingRetriever();
-	plan(params) {
-		const traceId = randomUUID();
-		const query = params.query.trim();
-		if (!query) return {
-			traceId,
-			modelMessage: params.userMessage,
-			items: [],
-			rejected: [],
-			consentRequests: [],
-			estimatedTokens: 0,
-			contextChars: 0,
-			contextItemCount: 0,
-			allocation: params.allocation
-		};
-		const started = Date.now();
-		const now = Date.now();
-		const requestedMaxResults = params.allocation?.maxResults;
-		const requestedMaxChars = params.allocation?.maxChars;
-		const scopeInput = {
-			sessionKey: params.sessionKey,
-			workspaceId: params.workspaceId,
-			...params.projectId ? { projectId: params.projectId } : {}
-		};
-		const queryProfile = buildRetrievalQueryProfile(query, scopeInput);
-		const selfReview = queryProfile.selfReview;
-		const maxResults = requestedMaxResults ?? (selfReview ? SELF_REVIEW_MAX_RESULTS : DEFAULT_MAX_RESULTS);
-		const budgetChars = requestedMaxChars ?? (selfReview ? SELF_REVIEW_MAX_CONTEXT_CHARS : DEFAULT_MAX_CONTEXT_CHARS);
-		const maxChars = Math.max(0, budgetChars - 2);
-		const projects = new ProjectStore();
-		const excluded = new Set(params.excludedRecordIds ?? []);
-		const rejected = [];
-		const consentRequests = [];
-		const traceItems = [];
-		const items = [];
-		const selectedFocuses = [];
-		const selectedRules = [];
-		const understandingSources = /* @__PURE__ */ new Map();
-		let usedChars = 0;
-		const render = (overrides = {}) => renderContextBlock({
-			profileLines,
-			focuses: selectedFocuses,
-			rules: selectedRules,
-			items,
-			understandingSources,
-			selfReview,
-			projects,
-			...overrides
-		});
-		const profile = getUserProfile();
-		const profileLines = [
-			profile.callName ? `Preferred name: ${profile.callName}` : "",
-			profile.role ? `Primary role: ${profile.role}` : "",
-			profile.primaryGoal ? `Primary goal for xopc: ${profile.primaryGoal}` : "",
-			profile.pronouns ? `Pronouns: ${profile.pronouns}` : "",
-			profile.timezone ? `Timezone: ${profile.timezone}` : "",
-			profile.locale ? `Language/locale: ${profile.locale}` : ""
-		].filter(Boolean);
-		if (profileLines.length) {
-			const content = profileLines.join("\n");
-			const nextChars = render().length;
-			if (nextChars <= maxChars) {
-				traceItems.push({
-					objectType: "profile",
-					objectId: "profile",
-					decision: "selected",
-					reason: "User-provided profile",
-					content,
-					sourceLabel: "You provided this directly",
-					origin: "told_by_user",
-					rank: 0,
-					score: 1,
-					injectedChars: nextChars
-				});
-				usedChars = nextChars;
-			} else {
-				profileLines.length = 0;
-				traceItems.push({
-					objectType: "profile",
-					objectId: "profile",
-					decision: "budget_exceeded",
-					reason: "Context budget reached",
-					content,
-					sourceLabel: "You provided this directly",
-					origin: "told_by_user",
-					injectedChars: 0
-				});
-			}
-		}
-		const rankedFocuses = listUserFocuses(["active"]).map((focus) => ({
-			focus,
-			score: focusScore(focus, query, scopeInput)
-		})).sort((left, right) => selfReview ? right.focus.confidence - left.focus.confidence || right.focus.updatedAt - left.focus.updatedAt : right.score - left.score || right.focus.updatedAt - left.focus.updatedAt);
-		for (const { focus, score } of rankedFocuses) {
-			const source = focusSourceDescription(focus);
-			let reason = focusRejectionReason(focus, scopeInput, now);
-			if (selfReview && reason === "scope_mismatch") reason = void 0;
-			if (!reason && !selfReview && score <= MIN_RELEVANCE_SCORE) reason = "low_score";
-			if (!reason && selectedFocuses.length >= (selfReview ? maxResults : MAX_FOCUS_RESULTS)) reason = "budget";
-			if (!reason && items.length >= maxResults) reason = "budget";
-			const focusScope = scopeLabel(focus.scope, projects);
-			const content = `${selfReview ? `[${focusScope}] ` : ""}${focus.title}: ${focus.summary} (${focus.horizon})`;
-			const nextChars = render({ focuses: [...selectedFocuses, focus] }).length;
-			if (!reason && nextChars > maxChars) reason = "budget";
-			if (reason) {
-				rejected.push({
-					recordId: focus.id,
-					reason
-				});
-				traceItems.push({
-					objectType: "focus",
-					objectId: focus.id,
-					versionId: focus.versionId,
-					decision: reason === "budget" ? "budget_exceeded" : reason === "requires_consent" ? "needs_consent" : reason === "scope_mismatch" ? "scope_mismatch" : reason === "expired" ? "expired" : reason === "sensitive" ? "sensitive" : reason === "disabled" ? "disabled" : "irrelevant",
-					reason,
-					content,
-					sourceLabel: source.label,
-					origin: source.origin,
-					score,
-					injectedChars: 0
-				});
-				continue;
-			}
-			const addedChars = nextChars - usedChars;
-			usedChars = nextChars;
-			selectedFocuses.push(focus);
-			items.push({
-				recordId: focus.id,
-				objectType: "focus",
-				versionId: focus.versionId,
-				content,
-				score,
-				section: "task",
-				citation: `user-focus://${focus.id}`,
-				origin: source.origin,
-				stability: focus.confidence
-			});
-			traceItems.push({
-				objectType: "focus",
-				objectId: focus.id,
-				versionId: focus.versionId,
-				decision: "selected",
-				reason: "Relevant active focus",
-				content,
-				sourceLabel: source.label,
-				origin: source.origin,
-				rank: items.length,
-				score,
-				injectedChars: addedChars
-			});
-		}
-		const rules = listCollaborationRules().filter((rule) => ruleMatches(rule, {
-			...scopeInput,
-			channel: params.channel,
-			agentId: parseSessionKey(params.sessionKey)?.agentId
-		}));
-		for (const [index, rule] of rules.entries()) {
-			const nextChars = render({ rules: [...selectedRules, rule] }).length;
-			if (nextChars > maxChars) {
-				traceItems.push({
-					objectType: "rule",
-					objectId: rule.id,
-					versionId: rule.revisionId,
-					decision: "budget_exceeded",
-					reason: "Context budget reached",
-					content: rule.statement,
-					sourceLabel: "Your collaboration rule",
-					origin: "told_by_user",
-					injectedChars: 0
-				});
-				continue;
-			}
-			const addedChars = nextChars - usedChars;
-			usedChars = nextChars;
-			selectedRules.push(rule);
-			traceItems.push({
-				objectType: "rule",
-				objectId: rule.id,
-				versionId: rule.revisionId,
-				decision: "selected",
-				reason: "Active collaboration rule",
-				content: rule.statement,
-				sourceLabel: "Your collaboration rule",
-				origin: "told_by_user",
-				rank: index + 1,
-				score: 1,
-				injectedChars: addedChars
-			});
-		}
-		const ranked = (selfReview ? listUnderstandings(["active"]).map((item) => ({
-			item,
-			score: selfReviewScore(item)
-		})).sort((left, right) => right.score - left.score || right.item.updatedAt - left.item.updatedAt) : this.retriever.retrieve({
-			query,
-			sessionKey: params.sessionKey,
-			workspaceId: params.workspaceId,
-			...params.projectId ? { projectId: params.projectId } : {},
-			maxCandidates: Math.max(maxResults * 5, 50)
-		}).map((result) => ({
-			item: result.understanding,
-			score: result.score
-		}))).filter(({ item }) => !excluded.has(item.id));
-		for (const { item, score } of ranked) {
-			const source = sourceDescription(item);
-			if (items.length >= maxResults) {
-				rejected.push({
-					recordId: item.id,
-					reason: "budget"
-				});
-				traceItems.push({
-					objectType: "understanding",
-					objectId: item.id,
-					versionId: item.versionId,
-					decision: "budget_exceeded",
-					reason: "Maximum result count reached",
-					content: item.statement,
-					sourceLabel: source.label,
-					origin: source.origin,
-					score,
-					injectedChars: 0
-				});
-				continue;
-			}
-			let reason = rejectionReason(item, scopeInput, now, queryProfile.timeHints);
-			if (selfReview && reason === "scope_mismatch") reason = void 0;
-			if (!reason && !selfReview && score <= MIN_RELEVANCE_SCORE) reason = "low_score";
-			if (!reason && item.disclosurePolicy === "ask_before_reference") {
-				const consentStatus = consumeContextConsent(item.id, params.sessionKey);
-				if (consentStatus !== "granted") {
-					reason = consentStatus === "denied" ? "disabled" : "requires_consent";
-					if (consentStatus === "missing") {
-						const consent = ensureContextConsent(item.id, params.sessionKey, query);
-						consentRequests.push({
-							id: consent.id,
-							recordId: item.id,
-							statement: item.statement,
-							purpose: consent.purpose
-						});
-					}
-				}
-			}
-			if (reason) {
-				rejected.push({
-					recordId: item.id,
-					reason
-				});
-				traceItems.push({
-					objectType: "understanding",
-					objectId: item.id,
-					versionId: item.versionId,
-					decision: reason === "budget" ? "budget_exceeded" : reason === "requires_consent" ? "needs_consent" : reason === "conflict" ? "conflicted" : reason === "expired" ? "expired" : reason === "sensitive" ? "sensitive" : reason === "scope_mismatch" ? "scope_mismatch" : reason === "disabled" ? "disabled" : "irrelevant",
-					reason,
-					content: item.statement,
-					sourceLabel: source.label,
-					origin: source.origin,
-					score,
-					injectedChars: 0
-				});
-				continue;
-			}
-			const plannedItem = {
-				recordId: item.id,
-				objectType: "understanding",
-				versionId: item.versionId,
-				content: selfReview ? `[${scopeLabel(item.scope, projects)}] ${item.statement}` : item.statement,
-				score,
-				section: sectionFor(item),
-				citation: `user-context://${item.id}`,
-				origin: source.origin,
-				stability: item.confidence
-			};
-			const nextSources = new Map(understandingSources).set(item.id, source.label);
-			const nextChars = render({
-				items: [...items, plannedItem],
-				understandingSources: nextSources
-			}).length;
-			if (nextChars > maxChars) {
-				rejected.push({
-					recordId: item.id,
-					reason: "budget"
-				});
-				traceItems.push({
-					objectType: "understanding",
-					objectId: item.id,
-					versionId: item.versionId,
-					decision: "budget_exceeded",
-					reason: "Context budget reached",
-					content: item.statement,
-					sourceLabel: source.label,
-					origin: source.origin,
-					score,
-					injectedChars: 0
-				});
-				continue;
-			}
-			const addedChars = nextChars - usedChars;
-			usedChars = nextChars;
-			understandingSources.set(item.id, source.label);
-			items.push(plannedItem);
-			traceItems.push({
-				objectType: "understanding",
-				objectId: item.id,
-				versionId: item.versionId,
-				decision: "selected",
-				reason: "Relevant to this request",
-				content: item.statement,
-				sourceLabel: source.label,
-				origin: source.origin,
-				rank: items.length,
-				score,
-				injectedChars: addedChars
-			});
-		}
-		const block = render();
-		recordContextRun({
-			turnId: params.turnId,
-			sessionKey: params.sessionKey,
-			query,
-			budget: budgetChars,
-			durationMs: Date.now() - started,
-			items: traceItems
-		});
-		return {
-			traceId,
-			modelMessage: prependAgentContext(params.userMessage, block),
-			items,
-			rejected,
-			consentRequests,
-			estimatedTokens: Math.ceil((block.length + (block ? 2 : 0)) / 4),
-			contextChars: block.length + (block ? 2 : 0),
-			contextItemCount: traceItems.filter((item) => item.decision === "selected").length,
-			allocation: params.allocation
-		};
-	}
-};
-//#endregion
-export { UserContextPlanner, prependAgentContext };

package/dist/src/user-context/relationships/indexer.d.ts

@@ -1,13 +0,0 @@
-import type { KnowledgeSourceItem } from '../../knowledge/types.js';
-import type { UserPersonIndexEntry } from './types.js';
-type PersonSignal = {
-    name?: string;
-    email?: string;
-    username?: string;
-};
-export declare function personIdentityKey(signal: PersonSignal, sourceInstanceId: string): string | undefined;
-export declare function personIdForIdentity(signal: PersonSignal, sourceInstanceId: string): string | undefined;
-export declare function buildUserPeopleIndex(items: KnowledgeSourceItem[]): UserPersonIndexEntry[];
-export declare function rebuildUserPeopleIndex(): UserPersonIndexEntry[];
-export declare function ensureUserPeopleIndex(): void;
-export {};

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

@@ -1,185 +0,0 @@
-import { getSqliteDatabase } from "../../storage/sqlite/transaction.js";
-import { getUserPeopleIndexState, replaceUserPeopleIndex } from "../../storage/sqlite/user-people-repository.js";
-import { listKnowledgeSourceItems } from "../../storage/sqlite/knowledge-repository.js";
-import "../../storage/sqlite/index.js";
-import { listUnderstandingSourceGrants } from "../sources/repository.js";
-import { createHash } from "node:crypto";
-//#region src/user-context/relationships/indexer.ts
-function hash(value) {
-	return createHash("sha256").update(value).digest("hex").slice(0, 20);
-}
-function normalized(value) {
-	return value?.trim().toLocaleLowerCase() || void 0;
-}
-function readSignal(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
-	const row = value;
-	const read = (key) => typeof row[key] === "string" && row[key].trim() ? row[key].trim().slice(0, 160) : void 0;
-	const signal = {
-		name: read("name"),
-		email: read("email"),
-		username: read("username")
-	};
-	return signal.name || signal.email || signal.username ? signal : void 0;
-}
-function providerScope(sourceInstanceId) {
-	if (!sourceInstanceId.startsWith("composio:")) return sourceInstanceId.toLocaleLowerCase();
-	return sourceInstanceId.split(":")[1]?.toLocaleLowerCase() ?? sourceInstanceId.toLocaleLowerCase();
-}
-function personIdentityKey(signal, sourceInstanceId) {
-	const email = normalized(signal.email);
-	if (email) return `email:${email}`;
-	const username = normalized(signal.username);
-	if (username) return `provider:${providerScope(sourceInstanceId)}:${username}`;
-	const name = normalized(signal.name);
-	return name ? `name:${sourceInstanceId.toLocaleLowerCase()}:${name}` : void 0;
-}
-function personIdForIdentity(signal, sourceInstanceId) {
-	const key = personIdentityKey(signal, sourceInstanceId);
-	return key ? `person_${hash(key)}` : void 0;
-}
-function inferredKind(signal) {
-	const name = normalized(signal.name) ?? "";
-	const username = normalized(signal.username) ?? "";
-	const emailLocal = (normalized(signal.email) ?? "").split("@")[0] ?? "";
-	if (/\[bot\]|(?:^|[-_.])bot(?:$|[-_.])|bot$/.test(`${name} ${username}`)) return "bot";
-	if (/^(?:no[-_.]?reply|do[-_.]?not[-_.]?reply|notifications?|alerts?|mailer[-_.]?daemon)(?:$|[-+_.])/.test(emailLocal)) return "service";
-	if (/^(?:team|group|all|everyone|support|help|sales|contact)(?:$|[-+_.])/.test(emailLocal)) return "group";
-	if (!signal.name && !signal.email && signal.username) return "unknown";
-	return "person";
-}
-function confidence(signal) {
-	if (signal.email) return signal.name ? .95 : .88;
-	if (signal.username) return signal.name ? .86 : .72;
-	return .55;
-}
-function observedAt(item) {
-	const value = Date.parse(item.occurredAt ?? item.sourceUpdatedAt ?? item.updatedAt);
-	return Number.isFinite(value) ? value : Date.now();
-}
-function handle(personId, type, value, sourceInstanceId, time) {
-	return {
-		id: `handle_${hash(`${type}:${normalized(value)}:${sourceInstanceId}`)}`,
-		type,
-		value,
-		sourceInstanceId,
-		verification: type === "display_name" ? "inferred" : "observed",
-		firstObservedAt: time,
-		lastObservedAt: time
-	};
-}
-function activeConnectorSources() {
-	return new Set(listUnderstandingSourceGrants().flatMap((grant) => {
-		const sourceInstanceId = typeof grant.config.sourceInstanceId === "string" ? grant.config.sourceInstanceId.trim() : "";
-		if (sourceInstanceId) return [sourceInstanceId];
-		const connectorId = typeof grant.config.connectorId === "string" ? grant.config.connectorId.trim() : "";
-		const accountId = typeof grant.config.accountId === "string" ? grant.config.accountId.trim() : "";
-		return connectorId && accountId ? [`composio:${connectorId}:${accountId}`] : [];
-	}));
-}
-function loadActiveSourceItems() {
-	const activeSources = activeConnectorSources();
-	const items = [];
-	let offset = 0;
-	while (true) {
-		const page = listKnowledgeSourceItems({
-			includeDeleted: false,
-			limit: 500,
-			offset
-		});
-		items.push(...page.filter((item) => item.synthesisPipeline === "connected_knowledge" && item.sensitivity !== "secret" && item.sensitivity !== "regulated" && item.metadata.observationKind !== "inventory" && (!item.sourceInstanceId.startsWith("composio:") || activeSources.has(item.sourceInstanceId))));
-		if (page.length < 500) break;
-		offset += page.length;
-	}
-	return items;
-}
-function currentIndexRevision() {
-	const db = getSqliteDatabase();
-	return {
-		sourceChangeSequence: Number(db.prepare("SELECT COALESCE(MAX(sequence), 0) AS value FROM knowledge_source_changes").get().value),
-		sourceGrantsUpdatedAt: Number(db.prepare("SELECT COALESCE(MAX(updated_at), 0) AS value FROM understanding_source_grants").get().value)
-	};
-}
-function buildUserPeopleIndex(items) {
-	const owners = new Set(items.flatMap((item) => Array.isArray(item.metadata.ownerIdentities) ? item.metadata.ownerIdentities.filter((value) => typeof value === "string").map((value) => value.trim().toLocaleLowerCase()).filter(Boolean) : []));
-	const people = /* @__PURE__ */ new Map();
-	for (const item of items) {
-		const values = Array.isArray(item.metadata.personEntities) ? item.metadata.personEntities : [];
-		const seenInItem = /* @__PURE__ */ new Set();
-		for (const value of values) {
-			const signal = readSignal(value);
-			if (!signal) continue;
-			const strongIdentity = normalized(signal.email) ?? normalized(signal.username);
-			if (strongIdentity && owners.has(strongIdentity)) continue;
-			const identityKey = personIdentityKey(signal, item.sourceInstanceId);
-			const id = personIdForIdentity(signal, item.sourceInstanceId);
-			if (!identityKey || !id || seenInItem.has(identityKey)) continue;
-			seenInItem.add(identityKey);
-			const time = observedAt(item);
-			const name = signal.name ?? signal.email ?? signal.username;
-			const current = people.get(identityKey) ?? {
-				id,
-				displayName: name,
-				inferredKind: inferredKind(signal),
-				confidence: confidence(signal),
-				firstObservedAt: time,
-				lastObservedAt: time,
-				handles: /* @__PURE__ */ new Map(),
-				sources: /* @__PURE__ */ new Map()
-			};
-			if (signal.name && (!current.displayName || current.displayName.includes("@"))) current.displayName = signal.name;
-			current.inferredKind = current.inferredKind === "unknown" ? inferredKind(signal) : current.inferredKind;
-			current.confidence = Math.max(current.confidence, confidence(signal));
-			current.firstObservedAt = Math.min(current.firstObservedAt, time);
-			current.lastObservedAt = Math.max(current.lastObservedAt, time);
-			for (const [type, displayValue] of [
-				["email", signal.email],
-				["username", signal.username],
-				["display_name", signal.name]
-			]) {
-				if (!displayValue) continue;
-				const next = handle(id, type, displayValue, item.sourceInstanceId, time);
-				const key = `${type}:${normalized(displayValue)}:${item.sourceInstanceId}`;
-				const previous = current.handles.get(key);
-				if (previous) {
-					previous.firstObservedAt = Math.min(previous.firstObservedAt, time);
-					previous.lastObservedAt = Math.max(previous.lastObservedAt, time);
-				} else current.handles.set(key, next);
-			}
-			const source = current.sources.get(item.sourceInstanceId) ?? {
-				sourceInstanceId: item.sourceInstanceId,
-				interactionCount: 0,
-				firstObservedAt: time,
-				lastObservedAt: time
-			};
-			source.interactionCount += 1;
-			source.firstObservedAt = Math.min(source.firstObservedAt, time);
-			source.lastObservedAt = Math.max(source.lastObservedAt, time);
-			current.sources.set(item.sourceInstanceId, source);
-			people.set(identityKey, current);
-		}
-	}
-	return [...people.values()].map((person) => ({
-		id: person.id,
-		displayName: person.displayName,
-		inferredKind: person.inferredKind,
-		confidence: person.confidence,
-		firstObservedAt: person.firstObservedAt,
-		lastObservedAt: person.lastObservedAt,
-		handles: [...person.handles.values()],
-		sources: [...person.sources.values()]
-	}));
-}
-function rebuildUserPeopleIndex() {
-	const revision = currentIndexRevision();
-	const entries = buildUserPeopleIndex(loadActiveSourceItems());
-	replaceUserPeopleIndex(entries, revision);
-	return entries;
-}
-function ensureUserPeopleIndex() {
-	const revision = currentIndexRevision();
-	const state = getUserPeopleIndexState();
-	if (!state || state.sourceChangeSequence !== revision.sourceChangeSequence || state.sourceGrantsUpdatedAt !== revision.sourceGrantsUpdatedAt) rebuildUserPeopleIndex();
-}
-//#endregion
-export { buildUserPeopleIndex, ensureUserPeopleIndex, personIdForIdentity, personIdentityKey, rebuildUserPeopleIndex };

package/dist/src/user-context/relationships/service.d.ts

@@ -1,22 +0,0 @@
-import type { UserPerson, UserPersonKind } from './types.js';
-export declare function listUserRelationships(options?: {
-    query?: string;
-    kind?: UserPersonKind;
-    sourceInstanceId?: string;
-    includeHidden?: boolean;
-    hiddenOnly?: boolean;
-    cursor?: string;
-    limit?: number;
-}): {
-    nextCursor?: string;
-    items: UserPerson[];
-    summary: import("./types.js").UserRelationshipSummary;
-    total: number;
-};
-export declare function getUserRelationship(personId: string): UserPerson | null;
-export declare function patchUserRelationship(personId: string, patch: {
-    displayName?: string | null;
-    kind?: UserPersonKind | null;
-    hidden?: boolean;
-}): UserPerson | null;
-export declare function mergeUserRelationships(sourcePersonId: string, targetPersonId: string): UserPerson | null;