@xopcai/xopc 0.0.189 → 0.0.191

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

@@ -1,51 +0,0 @@
-import { isUserContextMemoryKind } from "./projection.js";
-//#region src/user-context/import.ts
-function prepareUserContextImport(candidates, existingStatements) {
-	const known = new Set(Array.from(existingStatements, (statement) => statement.trim().toLocaleLowerCase()));
-	const imports = [];
-	let skippedCount = 0;
-	for (const candidate of candidates) {
-		if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
-			skippedCount += 1;
-			continue;
-		}
-		const item = candidate;
-		const statement = typeof item.statement === "string" ? item.statement.trim() : "";
-		const normalized = statement.toLocaleLowerCase();
-		if (!statement || statement.length > 5e3 || known.has(normalized) || item.status === "archived" || item.status === "rejected") {
-			skippedCount += 1;
-			continue;
-		}
-		const kind = isUserContextMemoryKind(item.kind) ? item.kind : "preference";
-		const sensitivity = typeof item.sensitivity === "string" && [
-			"normal",
-			"personal",
-			"secret",
-			"regulated"
-		].includes(item.sensitivity) ? item.sensitivity : "normal";
-		const durability = typeof item.durability === "string" && [
-			"ephemeral",
-			"durable",
-			"recurring"
-		].includes(item.durability) ? item.durability : "durable";
-		known.add(normalized);
-		const disclosurePolicy = typeof item.disclosurePolicy === "string" && [
-			"silent",
-			"referenceable",
-			"ask_before_reference"
-		].includes(item.disclosurePolicy) ? item.disclosurePolicy : "referenceable";
-		imports.push({
-			statement,
-			kind,
-			sensitivity,
-			durability,
-			disclosurePolicy
-		});
-	}
-	return {
-		imports,
-		skippedCount
-	};
-}
-//#endregion
-export { prepareUserContextImport };

package/dist/src/user-context/memory-episode-evaluator.d.ts

@@ -1,32 +0,0 @@
-export interface MemoryEpisode {
-    id: string;
-    expectedRecall: string[];
-    forbiddenRecall: string[];
-    expectedLifecycle: string[];
-    expectedDreaming: string[];
-}
-export interface MemoryEpisodeObservation {
-    recalledRecordIds: string[];
-    lifecycleActions: string[];
-    dreamingActions: string[];
-    scopeViolations: number;
-    sensitivityViolations: number;
-}
-export interface MemoryEpisodeResult {
-    id: string;
-    recall: number;
-    forbiddenRecall: string[];
-    missingLifecycle: string[];
-    missingDreaming: string[];
-    safe: boolean;
-    passed: boolean;
-}
-export declare function evaluateMemoryEpisode(episode: MemoryEpisode, observation: MemoryEpisodeObservation): MemoryEpisodeResult;
-export declare function evaluateMemoryEpisodeSuite(cases: Array<{
-    episode: MemoryEpisode;
-    observation: MemoryEpisodeObservation;
-}>): {
-    releaseReady: boolean;
-    averageRecall: number;
-    results: MemoryEpisodeResult[];
-};

package/dist/src/user-context/memory-episode-evaluator.js

@@ -1,35 +0,0 @@
-//#region src/user-context/memory-episode-evaluator.ts
-function coverage(expected, actual) {
-	if (expected.length === 0) return 1;
-	return expected.filter((item) => actual.has(item)).length / expected.length;
-}
-function evaluateMemoryEpisode(episode, observation) {
-	const recalled = new Set(observation.recalledRecordIds);
-	const lifecycle = new Set(observation.lifecycleActions);
-	const dreaming = new Set(observation.dreamingActions);
-	const forbiddenRecall = episode.forbiddenRecall.filter((recordId) => recalled.has(recordId));
-	const missingLifecycle = episode.expectedLifecycle.filter((action) => !lifecycle.has(action));
-	const missingDreaming = episode.expectedDreaming.filter((action) => !dreaming.has(action));
-	const recall = coverage(episode.expectedRecall, recalled);
-	const safe = forbiddenRecall.length === 0 && observation.scopeViolations === 0 && observation.sensitivityViolations === 0;
-	return {
-		id: episode.id,
-		recall,
-		forbiddenRecall,
-		missingLifecycle,
-		missingDreaming,
-		safe,
-		passed: safe && recall === 1 && missingLifecycle.length === 0 && missingDreaming.length === 0
-	};
-}
-function evaluateMemoryEpisodeSuite(cases) {
-	const results = cases.map(({ episode, observation }) => evaluateMemoryEpisode(episode, observation));
-	const averageRecall = results.length > 0 ? results.reduce((total, result) => total + result.recall, 0) / results.length : 0;
-	return {
-		releaseReady: results.length > 0 && results.every((result) => result.passed),
-		averageRecall,
-		results
-	};
-}
-//#endregion
-export { evaluateMemoryEpisode, evaluateMemoryEpisodeSuite };

package/dist/src/user-context/memory-readiness.d.ts

@@ -1,33 +0,0 @@
-export type MemoryReadinessReason = 'insufficient_feedback' | 'low_helpful_rate' | 'high_record_error_rate' | 'sensitive_feedback_detected' | 'insufficient_dreaming_runs' | 'high_dreaming_failure_rate';
-export interface MemoryReadinessMetrics {
-    evaluatedTurns: number;
-    helpfulTurns: number;
-    recordFeedback: number;
-    recordErrors: number;
-    sensitiveFeedback: number;
-    dreamingRuns: number;
-    dreamingFailures: number;
-}
-export interface MemoryReadinessThresholds {
-    minEvaluatedTurns: number;
-    minHelpfulRate: number;
-    maxRecordErrorRate: number;
-    minDreamingRuns: number;
-    maxDreamingFailureRate: number;
-}
-export interface MemoryReadiness {
-    ready: boolean;
-    reasons: MemoryReadinessReason[];
-    metrics: MemoryReadinessMetrics & {
-        helpfulRate: number | null;
-        recordErrorRate: number | null;
-        dreamingFailureRate: number | null;
-    };
-    thresholds: MemoryReadinessThresholds;
-    evaluatedAt: string;
-}
-export declare const MEMORY_READINESS_THRESHOLDS: MemoryReadinessThresholds;
-export declare function evaluateMemoryReadiness(metrics: MemoryReadinessMetrics, options?: {
-    thresholds?: Partial<MemoryReadinessThresholds>;
-    nowMs?: number;
-}): MemoryReadiness;

package/dist/src/user-context/memory-readiness.js

@@ -1,41 +0,0 @@
-//#region src/user-context/memory-readiness.ts
-const MEMORY_READINESS_THRESHOLDS = {
-	minEvaluatedTurns: 20,
-	minHelpfulRate: .75,
-	maxRecordErrorRate: .1,
-	minDreamingRuns: 10,
-	maxDreamingFailureRate: .1
-};
-function rate(numerator, denominator) {
-	return denominator > 0 ? Math.round(numerator / denominator * 1e4) / 1e4 : null;
-}
-function evaluateMemoryReadiness(metrics, options = {}) {
-	const thresholds = {
-		...MEMORY_READINESS_THRESHOLDS,
-		...options.thresholds
-	};
-	const helpfulRate = rate(metrics.helpfulTurns, metrics.evaluatedTurns);
-	const recordErrorRate = rate(metrics.recordErrors, metrics.recordFeedback);
-	const dreamingFailureRate = rate(metrics.dreamingFailures, metrics.dreamingRuns);
-	const reasons = [];
-	if (metrics.evaluatedTurns < thresholds.minEvaluatedTurns) reasons.push("insufficient_feedback");
-	else if (helpfulRate === null || helpfulRate < thresholds.minHelpfulRate) reasons.push("low_helpful_rate");
-	if (recordErrorRate !== null && recordErrorRate > thresholds.maxRecordErrorRate) reasons.push("high_record_error_rate");
-	if (metrics.sensitiveFeedback > 0) reasons.push("sensitive_feedback_detected");
-	if (metrics.dreamingRuns < thresholds.minDreamingRuns) reasons.push("insufficient_dreaming_runs");
-	else if (dreamingFailureRate === null || dreamingFailureRate > thresholds.maxDreamingFailureRate) reasons.push("high_dreaming_failure_rate");
-	return {
-		ready: reasons.length === 0,
-		reasons,
-		metrics: {
-			...metrics,
-			helpfulRate,
-			recordErrorRate,
-			dreamingFailureRate
-		},
-		thresholds,
-		evaluatedAt: new Date(options.nowMs ?? Date.now()).toISOString()
-	};
-}
-//#endregion
-export { MEMORY_READINESS_THRESHOLDS, evaluateMemoryReadiness };

package/dist/src/user-context/memory-use-audit.d.ts

@@ -1,10 +0,0 @@
-import type { MemoryTraceEventPayload } from '../storage/sqlite/memory-records-repository.js';
-export declare function summarizeMemoryUseAudit(traces: MemoryTraceEventPayload[]): {
-    total: number;
-    injectTurns: number;
-    turnsUsingMemory: number;
-    selectedRecords: number;
-    helpful: number;
-    notHelpful: number;
-    skippedReasons: Record<string, number>;
-};

package/dist/src/user-context/memory-use-audit.js

@@ -1,26 +0,0 @@
-//#region src/user-context/memory-use-audit.ts
-function summarizeMemoryUseAudit(traces) {
-	const injects = traces.filter((trace) => trace.phase === "inject");
-	const skippedReasons = {};
-	let selectedRecords = 0;
-	let helpful = 0;
-	let notHelpful = 0;
-	for (const trace of injects) {
-		selectedRecords += trace.selectedRecordIds.length;
-		if (trace.skippedReason) skippedReasons[trace.skippedReason] = (skippedReasons[trace.skippedReason] ?? 0) + 1;
-		const responseFeedback = trace.feedback.find((item) => item.level === "response");
-		if (responseFeedback?.rating === "helpful") helpful += 1;
-		if (responseFeedback?.rating === "not_helpful" || responseFeedback?.rating === "irrelevant") notHelpful += 1;
-	}
-	return {
-		total: traces.length,
-		injectTurns: injects.length,
-		turnsUsingMemory: injects.filter((trace) => trace.selectedRecordIds.length > 0).length,
-		selectedRecords,
-		helpful,
-		notHelpful,
-		skippedReasons
-	};
-}
-//#endregion
-export { summarizeMemoryUseAudit };

package/dist/src/user-context/personal-playbook.d.ts

@@ -1,11 +0,0 @@
-import type { MemoryRecord } from '../agent/memory/types.js';
-export declare const PERSONAL_PLAYBOOK_RULE_TAG = "playbook:rule";
-export declare const PERSONAL_PLAYBOOK_DISABLED_TAG = "playbook:disabled";
-export declare const PERSONAL_PLAYBOOK_ORDER_PREFIX = "playbook:order:";
-export interface PersonalPlaybookContext {
-    channel?: string;
-    supportNeed?: 'listen' | 'clarify' | 'advise' | 'act' | 'unknown';
-}
-export declare function personalPlaybookContext(record: MemoryRecord): PersonalPlaybookContext;
-export declare function patchPersonalPlaybookContextTags(tags: string[], patch: PersonalPlaybookContext): string[];
-export declare function buildPersonalPlaybookPrompt(records: MemoryRecord[], context?: PersonalPlaybookContext): string;

package/dist/src/user-context/personal-playbook.js

@@ -1,41 +0,0 @@
-//#region src/user-context/personal-playbook.ts
-const PERSONAL_PLAYBOOK_RULE_TAG = "playbook:rule";
-const PERSONAL_PLAYBOOK_DISABLED_TAG = "playbook:disabled";
-const PERSONAL_PLAYBOOK_ORDER_PREFIX = "playbook:order:";
-const PLAYBOOK_CHANNEL_PREFIX = "playbook:when:channel:";
-const PLAYBOOK_SUPPORT_PREFIX = "playbook:when:support:";
-function personalPlaybookContext(record) {
-	const channel = record.tags?.find((tag) => tag.startsWith(PLAYBOOK_CHANNEL_PREFIX))?.slice(22);
-	const supportNeed = record.tags?.find((tag) => tag.startsWith(PLAYBOOK_SUPPORT_PREFIX))?.slice(22);
-	return {
-		...channel ? { channel: decodeURIComponent(channel) } : {},
-		...supportNeed ? { supportNeed } : {}
-	};
-}
-function patchPersonalPlaybookContextTags(tags, patch) {
-	let next = tags;
-	if ("channel" in patch) {
-		next = next.filter((tag) => !tag.startsWith(PLAYBOOK_CHANNEL_PREFIX));
-		if (patch.channel) next.push(`${PLAYBOOK_CHANNEL_PREFIX}${encodeURIComponent(patch.channel)}`);
-	}
-	if ("supportNeed" in patch) {
-		next = next.filter((tag) => !tag.startsWith(PLAYBOOK_SUPPORT_PREFIX));
-		if (patch.supportNeed) next.push(`${PLAYBOOK_SUPPORT_PREFIX}${patch.supportNeed}`);
-	}
-	return [...new Set(next)];
-}
-function order(record) {
-	const tag = record.tags?.find((value) => value.startsWith(PERSONAL_PLAYBOOK_ORDER_PREFIX));
-	const parsed = tag ? Number.parseInt(tag.slice(15), 10) : NaN;
-	return Number.isFinite(parsed) ? parsed : 1e3;
-}
-function buildPersonalPlaybookPrompt(records, context = {}) {
-	const rules = records.filter((record) => record.status === "active").filter((record) => record.tags?.includes(PERSONAL_PLAYBOOK_RULE_TAG)).filter((record) => !record.tags?.includes(PERSONAL_PLAYBOOK_DISABLED_TAG)).filter((record) => {
-		const condition = personalPlaybookContext(record);
-		return (!condition.channel || condition.channel === context.channel) && (!condition.supportNeed || condition.supportNeed === context.supportNeed);
-	}).sort((left, right) => order(left) - order(right) || left.updatedAt.localeCompare(right.updatedAt));
-	if (!rules.length) return "";
-	return ["## Personal playbook", ...rules.map((record) => `- ${record.content}`)].join("\n");
-}
-//#endregion
-export { PERSONAL_PLAYBOOK_DISABLED_TAG, PERSONAL_PLAYBOOK_ORDER_PREFIX, PERSONAL_PLAYBOOK_RULE_TAG, buildPersonalPlaybookPrompt, patchPersonalPlaybookContextTags, personalPlaybookContext };

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

@@ -1,37 +0,0 @@
-import type { Config } from '../config/schema.js';
-export type UserProfileFields = {
-    callName: string;
-    pronouns: string;
-    timezone: string;
-    notes: string;
-};
-export type UserProfileSuggestion = {
-    id: string;
-    value: string;
-    source: 'gateway_os';
-    confidence: 'medium';
-};
-export type UserProfilePromptState = {
-    state: 'active' | 'snoozed';
-    suggestionHash?: string;
-    snoozedUntil?: string;
-    updatedAt?: string;
-};
-export type UserProfileSetup = {
-    missing: Array<keyof UserProfileFields>;
-    shouldPrompt: boolean;
-    state: 'complete' | 'active' | 'snoozed';
-    callNameSuggestion?: UserProfileSuggestion;
-    snoozedUntil?: string;
-};
-export declare function parseUserProfileMarkdown(content: string): UserProfileFields;
-export declare function serializeUserProfileMarkdown(profile: UserProfileFields): string;
-export declare function patchUserProfileMarkdown(content: string, patch: Partial<UserProfileFields>): string;
-export declare function normalizeGatewayUserName(raw: string): string | undefined;
-export declare function detectGatewayCallNameSuggestion(config: Config): UserProfileSuggestion | undefined;
-export declare function buildUserProfileSetup(input: {
-    profile: UserProfileFields;
-    promptState: UserProfilePromptState;
-    config: Config;
-    now?: Date;
-}): UserProfileSetup;

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

@@ -1,163 +0,0 @@
-import * as os$1 from "node:os";
-import { createHash } from "node:crypto";
-//#region src/user-context/profile.ts
-const EMPTY_PROFILE = {
-	callName: "",
-	pronouns: "",
-	timezone: "",
-	notes: ""
-};
-const TECHNICAL_USER_NAMES = new Set([
-	"admin",
-	"administrator",
-	"app",
-	"daemon",
-	"defaultuser0",
-	"guest",
-	"nobody",
-	"node",
-	"owner",
-	"root",
-	"runner",
-	"service",
-	"system",
-	"ubuntu",
-	"user",
-	"wdagutilityaccount",
-	"www-data",
-	"xopc"
-]);
-function markdownField(line) {
-	const match = line.match(/^[-*]\s+\*\*(.+?):\*\*\s*(.*)$/i);
-	if (!match) return void 0;
-	return {
-		label: match[1].trim().toLowerCase(),
-		value: match[2].trim()
-	};
-}
-function contextSection(lines) {
-	const heading = lines.findIndex((line) => /^##\s+Context\s*$/i.test(line.trim()));
-	if (heading < 0) return void 0;
-	const nextHeadingOffset = lines.slice(heading + 1).findIndex((line) => /^##\s+/.test(line.trim()));
-	return {
-		start: heading,
-		end: nextHeadingOffset < 0 ? lines.length : heading + 1 + nextHeadingOffset
-	};
-}
-function parseUserProfileMarkdown(content) {
-	if (!content.trim()) return { ...EMPTY_PROFILE };
-	const profile = { ...EMPTY_PROFILE };
-	let nameFallback = "";
-	let preferredName = "";
-	const lines = content.replace(/\r\n/g, "\n").split("\n");
-	for (const line of lines) {
-		const field = markdownField(line);
-		if (!field) continue;
-		if (field.label === "name") nameFallback = field.value;
-		if (field.label === "what to call them") preferredName = field.value;
-		if (field.label === "pronouns") profile.pronouns = field.value;
-		if (field.label === "timezone") profile.timezone = field.value;
-		if (field.label === "notes") profile.notes = field.value;
-	}
-	profile.callName = preferredName || nameFallback;
-	const context = contextSection(lines);
-	if (context && !profile.notes) profile.notes = lines.slice(context.start + 1, context.end).join("\n").replace(/^_\(.*?\)_\s*$/gm, "").replace(/^---\s*$/gm, "").trim();
-	return profile;
-}
-function serializeUserProfileMarkdown(profile) {
-	const lines = [
-		"# PROFILE.md - About You",
-		"",
-		`- **Name:** ${profile.callName.trim()}`,
-		`- **Pronouns:** ${profile.pronouns.trim()}`,
-		`- **Timezone:** ${profile.timezone.trim()}`,
-		""
-	];
-	if (profile.notes.trim()) lines.push("## Context", "", profile.notes.trim(), "");
-	return lines.join("\n");
-}
-function patchSimpleField(lines, labels, insertLabel, value, updateEveryMatch = false) {
-	const matches = lines.flatMap((line, index) => {
-		const field = markdownField(line);
-		return field && labels.includes(field.label) ? [index] : [];
-	});
-	const targets = updateEveryMatch ? matches : matches.slice(-1);
-	if (targets.length > 0) {
-		for (const index of targets) lines[index] = `- **${lines[index].match(/^[-*]\s+\*\*(.+?):\*\*/i)?.[1] ?? insertLabel}:** ${value}`;
-		return;
-	}
-	const insertAt = contextSection(lines)?.start ?? lines.length;
-	lines.splice(insertAt, 0, `- **${insertLabel}:** ${value}`, "");
-}
-function patchUserProfileMarkdown(content, patch) {
-	if (!content.trim()) return serializeUserProfileMarkdown({
-		...EMPTY_PROFILE,
-		...patch
-	});
-	const lines = content.replace(/\r\n/g, "\n").split("\n");
-	if (patch.callName !== void 0) {
-		const hasPreferred = lines.some((line) => markdownField(line)?.label === "what to call them");
-		patchSimpleField(lines, hasPreferred ? ["what to call them"] : ["name"], hasPreferred ? "What to call them" : "Name", patch.callName.trim(), patch.callName.trim().length === 0);
-		if (patch.callName.trim().length === 0 && hasPreferred) patchSimpleField(lines, ["name"], "Name", "", true);
-	}
-	if (patch.pronouns !== void 0) patchSimpleField(lines, ["pronouns"], "Pronouns", patch.pronouns.trim());
-	if (patch.timezone !== void 0) patchSimpleField(lines, ["timezone"], "Timezone", patch.timezone.trim());
-	if (patch.notes !== void 0) {
-		const context = contextSection(lines);
-		const replacement = patch.notes.trim() ? [
-			"## Context",
-			"",
-			patch.notes.trim(),
-			""
-		] : [];
-		if (context) lines.splice(context.start, context.end - context.start, ...replacement);
-		else if (replacement.length > 0) lines.push("", ...replacement);
-	}
-	return lines.join("\n").replace(/\n{4,}/g, "\n\n\n").trimEnd() + "\n";
-}
-function normalizeGatewayUserName(raw) {
-	const account = raw.trim().split(/[\\/]/).at(-1)?.split("@")[0]?.trim() ?? "";
-	if (!account || account.length < 2 || account.length > 40) return void 0;
-	const normalizedKey = account.toLowerCase();
-	if (TECHNICAL_USER_NAMES.has(normalizedKey) || account.endsWith("$")) return void 0;
-	if (/^\d+$/.test(account) || /^[0-9a-f]{8,}$/i.test(account)) return void 0;
-	if ([...account].filter((character) => /\d/.test(character)).length / account.length > .35) return void 0;
-	const friendly = account.replace(/[._-]+/g, " ").replace(/\s+/g, " ").trim();
-	if (!friendly) return void 0;
-	return friendly.replace(/\b[a-z]/g, (character) => character.toUpperCase());
-}
-function detectGatewayCallNameSuggestion(config) {
-	if (config.gateway?.auth?.mode === "trusted-proxy") return void 0;
-	try {
-		const value = normalizeGatewayUserName(os$1.userInfo().username);
-		if (!value) return void 0;
-		return {
-			id: createHash("sha256").update(`gateway_os:${value}`).digest("hex").slice(0, 16),
-			value,
-			source: "gateway_os",
-			confidence: "medium"
-		};
-	} catch {
-		return;
-	}
-}
-function buildUserProfileSetup(input) {
-	const missing = Object.keys(input.profile).filter((field) => !input.profile[field].trim());
-	if (!missing.includes("callName")) return {
-		missing,
-		shouldPrompt: false,
-		state: "complete"
-	};
-	const now = input.now ?? /* @__PURE__ */ new Date();
-	const snoozed = input.promptState.state === "snoozed" && Boolean(input.promptState.snoozedUntil) && Date.parse(input.promptState.snoozedUntil) > now.getTime();
-	const suggestion = detectGatewayCallNameSuggestion(input.config);
-	return {
-		missing,
-		shouldPrompt: !snoozed,
-		state: snoozed ? "snoozed" : "active",
-		callNameSuggestion: suggestion,
-		snoozedUntil: snoozed ? input.promptState.snoozedUntil : void 0
-	};
-}
-//#endregion
-export { buildUserProfileSetup, detectGatewayCallNameSuggestion, normalizeGatewayUserName, parseUserProfileMarkdown, patchUserProfileMarkdown, serializeUserProfileMarkdown };

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

@@ -1,120 +0,0 @@
-import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';
-import type { ConnectorConnection, ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';
-import type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/types.js';
-import type { ConnectorLearningJob } from '../storage/sqlite/index.js';
-export type UserContextFacet = 'basics' | 'collaboration' | 'boundaries' | 'priorities' | 'people' | 'current';
-export type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';
-export declare const USER_CONTEXT_MEMORY_KINDS: readonly MemoryKind[];
-export declare function isUserContextRecord(record: MemoryRecord): boolean;
-export declare function isUserContextMemoryKind(value: unknown): value is MemoryKind;
-export declare function facetForMemoryKind(kind: MemoryKind): UserContextFacet;
-export declare function originForMemoryRecord(record: MemoryRecord): UserContextOrigin;
-export declare function projectUserContextRecord(record: MemoryRecord): {
-    id: string;
-    statement: string;
-    facet: UserContextFacet;
-    kind: MemoryKind;
-    status: import("../agent/memory/types.js").MemoryStatus;
-    origin: UserContextOrigin;
-    sourceName: string;
-    scope: {
-        type: "session";
-        id: string;
-    } | {
-        type: "project";
-        id: string;
-    } | {
-        type: "workspace";
-        id: string;
-    } | {
-        type: "global";
-        id?: undefined;
-    };
-    updatedAt: string;
-    sensitivity: import("../agent/memory/types.js").MemorySensitivity;
-    explicitness: import("../agent/memory/types.js").MemoryExplicitness;
-    durability: import("../agent/memory/types.js").MemoryDurability;
-    disclosurePolicy: import("../agent/memory/types.js").MemoryDisclosurePolicy;
-    stability: import("../agent/memory/lifecycle.js").MemoryStabilityBand;
-    stabilityScore: number;
-    confidence: number;
-    reviewAt: string;
-    reviewDue: boolean;
-    evidenceCount: number;
-    evidenceBasis: {
-        eventCount: number;
-        activeDays: number;
-        windowDays: number;
-    };
-    sourcePath: string;
-    latestEvidenceAt: string;
-    validFrom: string;
-    validTo: string;
-    expiresAt: string;
-};
-export declare function isPersonalContextConnector(definition: ConnectorDefinition): boolean;
-export declare function recordsDerivedFromPersonalContextSource(records: MemoryRecord[], sourceInstanceId: string): MemoryRecord[];
-export declare function projectPersonalContextSources(definitions: ConnectorDefinition[], instances: ConnectorInstance[], knowledge?: {
-    sourceItems?: KnowledgeSourceItem[];
-    syncRuns?: KnowledgeSyncRun[];
-    connections?: ConnectorConnection[];
-    learningJobs?: ConnectorLearningJob[];
-    claimStatsBySource?: Record<string, {
-        evidenceCount: number;
-        provisionalClaims: number;
-        activeClaims: number;
-        resolvedEntities: number;
-        lastEvidenceAt?: string;
-    }>;
-}): {
-    category: import("../connectors/types.js").ConnectorCategory;
-    capabilities: ("tools" | "context" | "events" | "memory_source")[];
-    access: {
-        context: boolean;
-        memory: boolean;
-        read: boolean;
-        write: boolean;
-    };
-    permissionDetails: string[];
-    installed: boolean;
-    enabled: any;
-    status: any;
-    instanceId: any;
-    lastConnectedAt: any;
-    lastHealthCheckAt: any;
-    lastHealthStatus: any;
-    lastActivityAt: string;
-    derivedUnderstandingCount: number;
-    learningFunnel: {
-        indexedItems: number;
-        attributedItems: number;
-        resolvedEntities: number;
-        provisionalClaims: number;
-        activeClaims: number;
-        evidenceCount: number;
-        lastEvidenceAt: string;
-    };
-    knowledgeItemCount: number;
-    lastSyncAt: string;
-    lastSyncStatus: import("../knowledge/types.js").KnowledgeSyncRunStatus;
-    lastSyncError: string;
-    learning: {
-        status: import("../storage/sqlite/connector-learning-repository.js").ConnectorLearningStatus;
-        phase: import("../storage/sqlite/connector-learning-repository.js").ConnectorLearningPhase;
-        itemsDiscovered: number;
-        itemsIndexed: number;
-        candidatesCreated: number;
-        mode: import("../storage/sqlite/connector-learning-repository.js").ConnectorLearningMode;
-        attemptCount: number;
-        nextRunAt: string;
-        error: string;
-        updatedAt: string;
-    };
-    branding?: import("../connectors/types.js").ConnectorBranding;
-    id: string;
-    accountLabel: any;
-    accountOrdinal: any;
-    accountCount: any;
-    displayName: string;
-    description: string;
-}[];