@xopcai/xopc 0.0.142 → 0.0.144

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

@@ -0,0 +1,37 @@
+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

@@ -0,0 +1,165 @@
+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 };
+
+//# sourceMappingURL=profile.js.map

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

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

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

@@ -0,0 +1,54 @@
+import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';
+import type { ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';
+export type UserContextFacet = 'basics' | 'collaboration' | 'boundaries' | 'priorities' | 'people' | 'current';
+export type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';
+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;
+    updatedAt: string;
+    sensitivity: import("../agent/memory/types.js").MemorySensitivity;
+    explicitness: import("../agent/memory/types.js").MemoryExplicitness;
+    durability: import("../agent/memory/types.js").MemoryDurability;
+    canReference: boolean;
+    stability: import("../agent/memory/lifecycle.js").MemoryStabilityBand;
+    stabilityScore: number;
+    reviewAt: string;
+    reviewDue: boolean;
+    evidenceCount: number;
+    sourcePath: string;
+    latestEvidenceAt: string;
+};
+export declare function isPersonalContextConnector(definition: ConnectorDefinition): boolean;
+export declare function recordsDerivedFromPersonalContextSource(records: MemoryRecord[], agentId: string, connectorId: string): MemoryRecord[];
+export declare function projectPersonalContextSources(definitions: ConnectorDefinition[], instances: ConnectorInstance[], records?: MemoryRecord[]): {
+    id: string;
+    displayName: string;
+    description: string;
+    category: import("../connectors/types.js").ConnectorCategory;
+    capabilities: ("context" | "tools" | "events" | "memory_source")[];
+    access: {
+        context: boolean;
+        memory: boolean;
+        read: boolean;
+        write: boolean;
+    };
+    permissionDetails: string[];
+    installed: boolean;
+    enabled: boolean;
+    status: string;
+    instanceId: string;
+    lastConnectedAt: string;
+    lastHealthCheckAt: string;
+    lastHealthStatus: import("../connectors/types.js").ConnectorHealthStatus;
+    lastActivityAt: string;
+    derivedUnderstandingCount: number;
+}[];

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

@@ -0,0 +1,121 @@
+import { effectiveMemoryStatus, resolveMemoryStability } from "../agent/memory/lifecycle.js";
+import { classifyMemoryContextOrigin } from "../agent/memory/source-origin.js";
+//#region src/user-context/projection.ts
+const ALWAYS_PERSONAL_KINDS = new Set([
+	"user_profile",
+	"preference",
+	"boundary",
+	"relationship",
+	"commitment",
+	"routine",
+	"personal_logistics",
+	"current_state",
+	"tool_preference",
+	"long_term_goal"
+]);
+const CONTEXTUAL_USER_KINDS = new Set([
+	"project_context",
+	"open_question",
+	"milestone",
+	"derived_insight",
+	"task_lesson"
+]);
+function isUserContextRecord(record) {
+	if (ALWAYS_PERSONAL_KINDS.has(record.kind)) return true;
+	return CONTEXTUAL_USER_KINDS.has(record.kind) && record.tags?.includes("user-understanding") === true;
+}
+function isUserContextMemoryKind(value) {
+	return typeof value === "string" && (ALWAYS_PERSONAL_KINDS.has(value) || CONTEXTUAL_USER_KINDS.has(value));
+}
+function facetForMemoryKind(kind) {
+	if (kind === "user_profile" || kind === "personal_logistics") return "basics";
+	if (kind === "preference" || kind === "routine" || kind === "tool_preference" || kind === "task_lesson") return "collaboration";
+	if (kind === "boundary") return "boundaries";
+	if (kind === "relationship") return "people";
+	if (kind === "current_state" || kind === "open_question") return "current";
+	return "priorities";
+}
+function originForMemoryRecord(record) {
+	const origin = classifyMemoryContextOrigin(record);
+	return origin === "told_by_user" ? "told_by_you" : origin;
+}
+function projectUserContextRecord(record) {
+	const lifecycle = resolveMemoryStability(record);
+	const latestEvidenceAt = record.evidence?.map((evidence) => evidence.observedAt).filter((value) => Boolean(value)).sort().at(-1);
+	return {
+		id: record.id,
+		statement: record.content,
+		facet: facetForMemoryKind(record.kind),
+		kind: record.kind,
+		status: effectiveMemoryStatus(record),
+		origin: originForMemoryRecord(record),
+		sourceName: record.source.provider ?? "local",
+		updatedAt: record.updatedAt,
+		sensitivity: record.sensitivity ?? "normal",
+		explicitness: record.explicitness,
+		durability: record.durability,
+		canReference: record.disclosurePolicy !== "silent",
+		stability: lifecycle.band,
+		stabilityScore: lifecycle.score,
+		reviewAt: lifecycle.reviewAt,
+		reviewDue: lifecycle.reviewDue,
+		evidenceCount: record.evidence?.length ?? 0,
+		sourcePath: record.source.path,
+		latestEvidenceAt
+	};
+}
+function isPersonalContextConnector(definition) {
+	return definition.capabilities.includes("context") || definition.capabilities.includes("memory_source");
+}
+function recordsDerivedFromPersonalContextSource(records, agentId, connectorId) {
+	return records.filter((record) => record.scope.agentId === agentId && record.source.provider === connectorId && isUserContextRecord(record));
+}
+function projectPersonalContextSources(definitions, instances, records = []) {
+	const instanceByConnector = /* @__PURE__ */ new Map();
+	for (const instance of instances) {
+		const current = instanceByConnector.get(instance.connectorId) ?? [];
+		current.push(instance);
+		instanceByConnector.set(instance.connectorId, current);
+	}
+	return definitions.filter(isPersonalContextConnector).map((definition) => {
+		const connected = instanceByConnector.get(definition.id) ?? [];
+		const relatedRecords = records.filter((record) => record.source.provider === definition.id);
+		const latestHealth = connected.filter((instance) => instance.usage.lastHealthCheckAt && instance.usage.lastHealthStatus).sort((left, right) => Date.parse(right.usage.lastHealthCheckAt) - Date.parse(left.usage.lastHealthCheckAt))[0]?.usage;
+		const permissionDetails = definition.permissions?.data ?? [];
+		const canWrite = permissionDetails.some((permission) => /(?:^|[.:/_-])(write|create|update|delete|manage|send|admin)(?:$|[.:/_-])/i.test(permission));
+		return {
+			id: definition.id,
+			displayName: definition.displayName,
+			description: definition.description,
+			category: definition.category,
+			capabilities: definition.capabilities.filter((capability) => capability === "context" || capability === "memory_source" || capability === "tools" || capability === "events"),
+			access: {
+				context: definition.capabilities.includes("context"),
+				memory: definition.capabilities.includes("memory_source"),
+				read: definition.capabilities.includes("context") || definition.capabilities.includes("resources") || definition.capabilities.includes("tools"),
+				write: canWrite
+			},
+			permissionDetails,
+			installed: connected.length > 0,
+			enabled: connected.some((instance) => instance.enabled),
+			status: connected[0]?.status ?? "not_installed",
+			instanceId: connected[0]?.instanceId,
+			lastConnectedAt: connected.map((instance) => instance.lastConnectedAt).filter((value) => Boolean(value)).sort().at(-1),
+			lastHealthCheckAt: latestHealth?.lastHealthCheckAt,
+			lastHealthStatus: latestHealth?.lastHealthStatus,
+			lastActivityAt: connected.flatMap((instance) => [
+				instance.lastConnectedAt,
+				instance.usage.lastHealthCheckAt,
+				...instance.audit.map((entry) => entry.at)
+			]).filter((value) => Boolean(value)).sort().at(-1),
+			derivedUnderstandingCount: relatedRecords.length
+		};
+	}).sort((left, right) => {
+		if (left.installed !== right.installed) return left.installed ? -1 : 1;
+		return left.displayName.localeCompare(right.displayName);
+	});
+}
+//#endregion
+export { facetForMemoryKind, isPersonalContextConnector, isUserContextMemoryKind, isUserContextRecord, originForMemoryRecord, projectPersonalContextSources, projectUserContextRecord, recordsDerivedFromPersonalContextSource };
+
+//# sourceMappingURL=projection.js.map

package/dist/src/user-context/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","names":[],"sources":["../../../src/user-context/projection.ts"],"sourcesContent":["import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';\nimport { effectiveMemoryStatus, resolveMemoryStability } from '../agent/memory/lifecycle.js';\nimport { classifyMemoryContextOrigin } from '../agent/memory/source-origin.js';\nimport type { ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';\n\nexport type UserContextFacet =\n  | 'basics'\n  | 'collaboration'\n  | 'boundaries'\n  | 'priorities'\n  | 'people'\n  | 'current';\n\nexport type UserContextOrigin = 'told_by_you' | 'observed' | 'inferred' | 'connected_source';\n\nconst ALWAYS_PERSONAL_KINDS = new Set<MemoryKind>([\n  'user_profile',\n  'preference',\n  'boundary',\n  'relationship',\n  'commitment',\n  'routine',\n  'personal_logistics',\n  'current_state',\n  'tool_preference',\n  'long_term_goal',\n]);\n\nconst CONTEXTUAL_USER_KINDS = new Set<MemoryKind>([\n  'project_context',\n  'open_question',\n  'milestone',\n  'derived_insight',\n  'task_lesson',\n]);\n\nexport function isUserContextRecord(record: MemoryRecord): boolean {\n  if (ALWAYS_PERSONAL_KINDS.has(record.kind)) return true;\n  return CONTEXTUAL_USER_KINDS.has(record.kind) && record.tags?.includes('user-understanding') === true;\n}\n\nexport function isUserContextMemoryKind(value: unknown): value is MemoryKind {\n  return typeof value === 'string'\n    && (ALWAYS_PERSONAL_KINDS.has(value as MemoryKind) || CONTEXTUAL_USER_KINDS.has(value as MemoryKind));\n}\n\nexport function facetForMemoryKind(kind: MemoryKind): UserContextFacet {\n  if (kind === 'user_profile' || kind === 'personal_logistics') return 'basics';\n  if (kind === 'preference' || kind === 'routine' || kind === 'tool_preference' || kind === 'task_lesson') {\n    return 'collaboration';\n  }\n  if (kind === 'boundary') return 'boundaries';\n  if (kind === 'relationship') return 'people';\n  if (kind === 'current_state' || kind === 'open_question') return 'current';\n  return 'priorities';\n}\n\nexport function originForMemoryRecord(record: MemoryRecord): UserContextOrigin {\n  const origin = classifyMemoryContextOrigin(record);\n  return origin === 'told_by_user' ? 'told_by_you' : origin;\n}\n\nexport function projectUserContextRecord(record: MemoryRecord) {\n  const lifecycle = resolveMemoryStability(record);\n  const latestEvidenceAt = record.evidence\n    ?.map((evidence) => evidence.observedAt)\n    .filter((value): value is string => Boolean(value))\n    .sort()\n    .at(-1);\n  return {\n    id: record.id,\n    statement: record.content,\n    facet: facetForMemoryKind(record.kind),\n    kind: record.kind,\n    status: effectiveMemoryStatus(record),\n    origin: originForMemoryRecord(record),\n    sourceName: record.source.provider ?? 'local',\n    updatedAt: record.updatedAt,\n    sensitivity: record.sensitivity ?? 'normal',\n    explicitness: record.explicitness,\n    durability: record.durability,\n    canReference: record.disclosurePolicy !== 'silent',\n    stability: lifecycle.band,\n    stabilityScore: lifecycle.score,\n    reviewAt: lifecycle.reviewAt,\n    reviewDue: lifecycle.reviewDue,\n    evidenceCount: record.evidence?.length ?? 0,\n    sourcePath: record.source.path,\n    latestEvidenceAt,\n  };\n}\n\nexport function isPersonalContextConnector(definition: ConnectorDefinition): boolean {\n  return definition.capabilities.includes('context') || definition.capabilities.includes('memory_source');\n}\n\nexport function recordsDerivedFromPersonalContextSource(\n  records: MemoryRecord[],\n  agentId: string,\n  connectorId: string,\n): MemoryRecord[] {\n  return records.filter((record) => (\n    record.scope.agentId === agentId\n    && record.source.provider === connectorId\n    && isUserContextRecord(record)\n  ));\n}\n\nexport function projectPersonalContextSources(\n  definitions: ConnectorDefinition[],\n  instances: ConnectorInstance[],\n  records: MemoryRecord[] = [],\n) {\n  const instanceByConnector = new Map<string, ConnectorInstance[]>();\n  for (const instance of instances) {\n    const current = instanceByConnector.get(instance.connectorId) ?? [];\n    current.push(instance);\n    instanceByConnector.set(instance.connectorId, current);\n  }\n  return definitions\n    .filter(isPersonalContextConnector)\n    .map((definition) => {\n      const connected = instanceByConnector.get(definition.id) ?? [];\n      const relatedRecords = records.filter((record) => record.source.provider === definition.id);\n      const latestHealth = connected\n        .filter((instance) => instance.usage.lastHealthCheckAt && instance.usage.lastHealthStatus)\n        .sort((left, right) => (\n          Date.parse(right.usage.lastHealthCheckAt!) - Date.parse(left.usage.lastHealthCheckAt!)\n        ))[0]?.usage;\n      const permissionDetails = definition.permissions?.data ?? [];\n      const canWrite = permissionDetails.some((permission) => (\n        /(?:^|[.:/_-])(write|create|update|delete|manage|send|admin)(?:$|[.:/_-])/i.test(permission)\n      ));\n      return {\n        id: definition.id,\n        displayName: definition.displayName,\n        description: definition.description,\n        category: definition.category,\n        capabilities: definition.capabilities.filter((capability) => (\n          capability === 'context' || capability === 'memory_source' || capability === 'tools' || capability === 'events'\n        )),\n        access: {\n          context: definition.capabilities.includes('context'),\n          memory: definition.capabilities.includes('memory_source'),\n          read: definition.capabilities.includes('context')\n            || definition.capabilities.includes('resources')\n            || definition.capabilities.includes('tools'),\n          write: canWrite,\n        },\n        permissionDetails,\n        installed: connected.length > 0,\n        enabled: connected.some((instance) => instance.enabled),\n        status: connected[0]?.status ?? 'not_installed',\n        instanceId: connected[0]?.instanceId,\n        lastConnectedAt: connected\n          .map((instance) => instance.lastConnectedAt)\n          .filter((value): value is string => Boolean(value))\n          .sort()\n          .at(-1),\n        lastHealthCheckAt: latestHealth?.lastHealthCheckAt,\n        lastHealthStatus: latestHealth?.lastHealthStatus,\n        lastActivityAt: connected\n          .flatMap((instance) => [\n            instance.lastConnectedAt,\n            instance.usage.lastHealthCheckAt,\n            ...instance.audit.map((entry) => entry.at),\n          ])\n          .filter((value): value is string => Boolean(value))\n          .sort()\n          .at(-1),\n        derivedUnderstandingCount: relatedRecords.length,\n      };\n    })\n    .sort((left, right) => {\n      if (left.installed !== right.installed) return left.installed ? -1 : 1;\n      return left.displayName.localeCompare(right.displayName);\n    });\n}\n"],"mappings":"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"}

package/dist/src/user-context/source-recommendations.d.ts

@@ -0,0 +1,13 @@
+import type { ConnectorDefinition } from '../connectors/types.js';
+type GoalSummary = {
+    id: string;
+    title: string;
+    description?: string;
+};
+export declare function buildGoalSourceRecommendations(definitions: ConnectorDefinition[], installedConnectorIds: Set<string>, goals: GoalSummary[]): {
+    sourceId: string;
+    sourceName: string;
+    goalId: string;
+    goalTitle: string;
+}[];
+export {};

package/dist/src/user-context/source-recommendations.js

@@ -0,0 +1,86 @@
+//#region src/user-context/source-recommendations.ts
+const DOMAINS = [
+	[
+		"calendar",
+		"schedule",
+		"meeting",
+		"deadline",
+		"event",
+		"日历",
+		"日程",
+		"会议",
+		"截止",
+		"预约"
+	],
+	[
+		"email",
+		"gmail",
+		"outlook",
+		"mail",
+		"inbox",
+		"邮件",
+		"邮箱",
+		"收件箱"
+	],
+	[
+		"docs",
+		"document",
+		"notion",
+		"drive",
+		"knowledge",
+		"wiki",
+		"文档",
+		"知识库",
+		"资料"
+	],
+	[
+		"github",
+		"gitlab",
+		"code",
+		"repository",
+		"issue",
+		"代码",
+		"仓库",
+		"开发"
+	],
+	[
+		"slack",
+		"teams",
+		"chat",
+		"message",
+		"消息",
+		"群聊",
+		"沟通"
+	]
+];
+function buildGoalSourceRecommendations(definitions, installedConnectorIds, goals) {
+	const recommendations = [];
+	for (const definition of definitions) {
+		if (installedConnectorIds.has(definition.id)) continue;
+		const sourceText = [
+			definition.id,
+			definition.displayName,
+			definition.description,
+			...definition.tags ?? []
+		].join(" ").toLowerCase();
+		for (const goal of goals) {
+			const goalText = `${goal.title} ${goal.description ?? ""}`.toLowerCase();
+			let score = 0;
+			for (const keywords of DOMAINS) if (keywords.some((keyword) => sourceText.includes(keyword)) && keywords.some((keyword) => goalText.includes(keyword))) score += 3;
+			const genericTerms = goalText.match(/[a-z][a-z0-9_-]{3,}/g) ?? [];
+			score += new Set(genericTerms.filter((term) => sourceText.includes(term))).size;
+			if (score > 0) recommendations.push({
+				sourceId: definition.id,
+				sourceName: definition.displayName,
+				goalId: goal.id,
+				goalTitle: goal.title,
+				score
+			});
+		}
+	}
+	return recommendations.sort((left, right) => right.score - left.score || left.sourceName.localeCompare(right.sourceName)).filter((item, index, all) => all.findIndex((candidate) => candidate.sourceId === item.sourceId) === index).slice(0, 3).map(({ score: _score, ...item }) => item);
+}
+//#endregion
+export { buildGoalSourceRecommendations };
+
+//# sourceMappingURL=source-recommendations.js.map

package/dist/src/user-context/source-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-recommendations.js","names":[],"sources":["../../../src/user-context/source-recommendations.ts"],"sourcesContent":["import type { ConnectorDefinition } from '../connectors/types.js';\n\ntype GoalSummary = { id: string; title: string; description?: string };\n\nconst DOMAINS = [\n  ['calendar', 'schedule', 'meeting', 'deadline', 'event', '日历', '日程', '会议', '截止', '预约'],\n  ['email', 'gmail', 'outlook', 'mail', 'inbox', '邮件', '邮箱', '收件箱'],\n  ['docs', 'document', 'notion', 'drive', 'knowledge', 'wiki', '文档', '知识库', '资料'],\n  ['github', 'gitlab', 'code', 'repository', 'issue', '代码', '仓库', '开发'],\n  ['slack', 'teams', 'chat', 'message', '消息', '群聊', '沟通'],\n] as const;\n\nexport function buildGoalSourceRecommendations(\n  definitions: ConnectorDefinition[],\n  installedConnectorIds: Set<string>,\n  goals: GoalSummary[],\n) {\n  const recommendations: Array<{\n    sourceId: string;\n    sourceName: string;\n    goalId: string;\n    goalTitle: string;\n    score: number;\n  }> = [];\n\n  for (const definition of definitions) {\n    if (installedConnectorIds.has(definition.id)) continue;\n    const sourceText = [definition.id, definition.displayName, definition.description, ...(definition.tags ?? [])]\n      .join(' ')\n      .toLowerCase();\n    for (const goal of goals) {\n      const goalText = `${goal.title} ${goal.description ?? ''}`.toLowerCase();\n      let score = 0;\n      for (const keywords of DOMAINS) {\n        if (keywords.some((keyword) => sourceText.includes(keyword)) && keywords.some((keyword) => goalText.includes(keyword))) {\n          score += 3;\n        }\n      }\n      const genericTerms = goalText.match(/[a-z][a-z0-9_-]{3,}/g) ?? [];\n      score += new Set(genericTerms.filter((term) => sourceText.includes(term))).size;\n      if (score > 0) {\n        recommendations.push({\n          sourceId: definition.id,\n          sourceName: definition.displayName,\n          goalId: goal.id,\n          goalTitle: goal.title,\n          score,\n        });\n      }\n    }\n  }\n\n  return recommendations\n    .sort((left, right) => right.score - left.score || left.sourceName.localeCompare(right.sourceName))\n    .filter((item, index, all) => all.findIndex((candidate) => candidate.sourceId === item.sourceId) === index)\n    .slice(0, 3)\n    .map(({ score: _score, ...item }) => item);\n}\n"],"mappings":";AAIA,MAAM,UAAU;CACd;EAAC;EAAY;EAAY;EAAW;EAAY;EAAS;EAAM;EAAM;EAAM;EAAM;EAAK;CACtF;EAAC;EAAS;EAAS;EAAW;EAAQ;EAAS;EAAM;EAAM;EAAM;CACjE;EAAC;EAAQ;EAAY;EAAU;EAAS;EAAa;EAAQ;EAAM;EAAO;EAAK;CAC/E;EAAC;EAAU;EAAU;EAAQ;EAAc;EAAS;EAAM;EAAM;EAAK;CACrE;EAAC;EAAS;EAAS;EAAQ;EAAW;EAAM;EAAM;EAAK;CACxD;AAED,SAAgB,+BACd,aACA,uBACA,OACA;CACA,MAAM,kBAMD,EAAE;AAEP,MAAK,MAAM,cAAc,aAAa;AACpC,MAAI,sBAAsB,IAAI,WAAW,GAAG,CAAE;EAC9C,MAAM,aAAa;GAAC,WAAW;GAAI,WAAW;GAAa,WAAW;GAAa,GAAI,WAAW,QAAQ,EAAE;GAAE,CAC3G,KAAK,IAAI,CACT,aAAa;AAChB,OAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,WAAW,GAAG,KAAK,MAAM,GAAG,KAAK,eAAe,KAAK,aAAa;GACxE,IAAI,QAAQ;AACZ,QAAK,MAAM,YAAY,QACrB,KAAI,SAAS,MAAM,YAAY,WAAW,SAAS,QAAQ,CAAC,IAAI,SAAS,MAAM,YAAY,SAAS,SAAS,QAAQ,CAAC,CACpH,UAAS;GAGb,MAAM,eAAe,SAAS,MAAM,uBAAuB,IAAI,EAAE;AACjE,YAAS,IAAI,IAAI,aAAa,QAAQ,SAAS,WAAW,SAAS,KAAK,CAAC,CAAC,CAAC;AAC3E,OAAI,QAAQ,EACV,iBAAgB,KAAK;IACnB,UAAU,WAAW;IACrB,YAAY,WAAW;IACvB,QAAQ,KAAK;IACb,WAAW,KAAK;IAChB;IACD,CAAC;;;AAKR,QAAO,gBACJ,MAAM,MAAM,UAAU,MAAM,QAAQ,KAAK,SAAS,KAAK,WAAW,cAAc,MAAM,WAAW,CAAC,CAClG,QAAQ,MAAM,OAAO,QAAQ,IAAI,WAAW,cAAc,UAAU,aAAa,KAAK,SAAS,KAAK,MAAM,CAC1G,MAAM,GAAG,EAAE,CACX,KAAK,EAAE,OAAO,QAAQ,GAAG,WAAW,KAAK"}

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

@@ -0,0 +1,11 @@
+export declare const USER_TRUST_LEVELS: readonly ["observe", "suggest", "confirm", "auto"];
+export type UserTrustLevel = typeof USER_TRUST_LEVELS[number];
+export declare const DEFAULT_USER_TRUST_LEVEL: UserTrustLevel;
+export type UserTrustPolicy = {
+    principalId: string;
+    defaultActionLevel: UserTrustLevel;
+    updatedAt?: string;
+};
+export declare function isUserTrustLevel(value: unknown): value is UserTrustLevel;
+export declare function resolveAutomationSafetyForTrust(level: UserTrustLevel, requested: 'suggest_only' | 'ask_before_apply' | 'auto_apply' | undefined): 'suggest_only' | 'ask_before_apply' | 'auto_apply';
+export declare function buildActionTrustPrompt(level: UserTrustLevel): string;

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

@@ -0,0 +1,31 @@
+//#region src/user-context/trust-policy.ts
+const USER_TRUST_LEVELS = [
+	"observe",
+	"suggest",
+	"confirm",
+	"auto"
+];
+const DEFAULT_USER_TRUST_LEVEL = "confirm";
+function isUserTrustLevel(value) {
+	return typeof value === "string" && USER_TRUST_LEVELS.includes(value);
+}
+function resolveAutomationSafetyForTrust(level, requested) {
+	if (level === "observe" || level === "suggest") return "suggest_only";
+	if (level === "confirm") return requested === "suggest_only" ? "suggest_only" : "ask_before_apply";
+	return requested ?? "suggest_only";
+}
+function buildActionTrustPrompt(level) {
+	const shared = [
+		"## Action Trust Boundary",
+		`Current default: ${level}.`,
+		"- This controls agent-initiated or proactive actions. A direct user request in the current turn is explicit approval to carry out that request within existing safety and permission boundaries.",
+		"- Never expand connector permissions, workflow scope, credentials, or access because of this setting.",
+		"- Irreversible, destructive, financial, permission-expanding, or public external actions still require explicit confirmation."
+	];
+	const instruction = level === "observe" ? "- For proactive work, observe and build context only; do not prepare or initiate actions." : level === "suggest" ? "- For proactive work, explain the recommendation and rationale, then let the user decide whether to proceed." : level === "confirm" ? "- For proactive work, prepare the action, but request approval before executing any mutating or external step." : "- For proactive work, you may execute within already-authorized, recoverable boundaries without asking each time.";
+	return [...shared, instruction].join("\n");
+}
+//#endregion
+export { DEFAULT_USER_TRUST_LEVEL, USER_TRUST_LEVELS, buildActionTrustPrompt, isUserTrustLevel, resolveAutomationSafetyForTrust };
+
+//# sourceMappingURL=trust-policy.js.map

package/dist/src/user-context/trust-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust-policy.js","names":[],"sources":["../../../src/user-context/trust-policy.ts"],"sourcesContent":["export const USER_TRUST_LEVELS = ['observe', 'suggest', 'confirm', 'auto'] as const;\n\nexport type UserTrustLevel = typeof USER_TRUST_LEVELS[number];\n\nexport const DEFAULT_USER_TRUST_LEVEL: UserTrustLevel = 'confirm';\n\nexport type UserTrustPolicy = {\n  principalId: string;\n  defaultActionLevel: UserTrustLevel;\n  updatedAt?: string;\n};\n\nexport function isUserTrustLevel(value: unknown): value is UserTrustLevel {\n  return typeof value === 'string' && USER_TRUST_LEVELS.includes(value as UserTrustLevel);\n}\n\nexport function resolveAutomationSafetyForTrust(\n  level: UserTrustLevel,\n  requested: 'suggest_only' | 'ask_before_apply' | 'auto_apply' | undefined,\n): 'suggest_only' | 'ask_before_apply' | 'auto_apply' {\n  if (level === 'observe' || level === 'suggest') return 'suggest_only';\n  if (level === 'confirm') {\n    return requested === 'suggest_only' ? 'suggest_only' : 'ask_before_apply';\n  }\n  return requested ?? 'suggest_only';\n}\n\nexport function buildActionTrustPrompt(level: UserTrustLevel): string {\n  const shared = [\n    '## Action Trust Boundary',\n    `Current default: ${level}.`,\n    '- This controls agent-initiated or proactive actions. A direct user request in the current turn is explicit approval to carry out that request within existing safety and permission boundaries.',\n    '- Never expand connector permissions, workflow scope, credentials, or access because of this setting.',\n    '- Irreversible, destructive, financial, permission-expanding, or public external actions still require explicit confirmation.',\n  ];\n  const instruction = level === 'observe'\n    ? '- For proactive work, observe and build context only; do not prepare or initiate actions.'\n    : level === 'suggest'\n      ? '- For proactive work, explain the recommendation and rationale, then let the user decide whether to proceed.'\n      : level === 'confirm'\n        ? '- For proactive work, prepare the action, but request approval before executing any mutating or external step.'\n        : '- For proactive work, you may execute within already-authorized, recoverable boundaries without asking each time.';\n  return [...shared, instruction].join('\\n');\n}\n"],"mappings":";AAAA,MAAa,oBAAoB;CAAC;CAAW;CAAW;CAAW;CAAO;AAI1E,MAAa,2BAA2C;AAQxD,SAAgB,iBAAiB,OAAyC;AACxE,QAAO,OAAO,UAAU,YAAY,kBAAkB,SAAS,MAAwB;;AAGzF,SAAgB,gCACd,OACA,WACoD;AACpD,KAAI,UAAU,aAAa,UAAU,UAAW,QAAO;AACvD,KAAI,UAAU,UACZ,QAAO,cAAc,iBAAiB,iBAAiB;AAEzD,QAAO,aAAa;;AAGtB,SAAgB,uBAAuB,OAA+B;CACpE,MAAM,SAAS;EACb;EACA,oBAAoB,MAAM;EAC1B;EACA;EACA;EACD;CACD,MAAM,cAAc,UAAU,YAC1B,8FACA,UAAU,YACR,iHACA,UAAU,YACR,mHACA;AACR,QAAO,CAAC,GAAG,QAAQ,YAAY,CAAC,KAAK,KAAK"}

package/dist/src/utils/index.js

@@ -1,8 +1,8 @@
-import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { getLogDir, getLoggerConfig } from "./logger/config.js";
 import { getRuntimeLogStats } from "./logger/stats.js";
 import { flushAndClose, isLoggerShuttingDown, setShuttingDown } from "./logger/shutdown.js";
 import { cleanOldLogs, rotateLogs } from "./logger/rotation.js";
+import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { isLogRedactionEnabled, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./logger/redact.js";
 import { exportLog, flushExporters, getExporters, initializeExporters } from "./logger/exporters.js";
 import { configureAuditLog, getAuditConfig, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./logger/audit.js";

package/dist/src/utils/logger/index.js

@@ -1,11 +1,11 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
-import { getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, updateAsyncLogContext } from "./context.js";
 import { config, getLogDir, getLoggerConfig, init_config } from "./config.js";
 import { init_streams, initializeStreams } from "./streams.js";
 import { getRuntimeLogStats, incrementStats, init_stats } from "./stats.js";
 import { flushAndClose, init_shutdown, isLoggerShuttingDown, setShuttingDown } from "./shutdown.js";
 import { cleanOldLogs, init_rotation, rotateLogs } from "./rotation.js";
+import { getAsyncLogContext, getAsyncLogCorrelationKeys, inboundCorrelationMetadataFromAsyncLogContext, init_context, mergeContext, runWithLogContext, updateAsyncLogContext } from "./context.js";
 import { init_redact, isLogRedactionEnabled, redactLogRecord, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./redact.js";
 import { exportLog, flushExporters, getExporters, init_exporters, initializeExporters } from "./exporters.js";
 import { configureAuditLog, getAuditConfig, init_audit, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./audit.js";

package/dist/src/utils/logger.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { getLogDir, getLoggerConfig } from "./logger/config.js";
 import { getRuntimeLogStats } from "./logger/stats.js";
 import { flushAndClose, isLoggerShuttingDown, setShuttingDown } from "./logger/shutdown.js";
 import { cleanOldLogs, rotateLogs } from "./logger/rotation.js";
+import { getAsyncLogContext, inboundCorrelationMetadataFromAsyncLogContext, runWithLogContext, updateAsyncLogContext } from "./logger/context.js";
 import { isLogRedactionEnabled, redactObject, redactPemBlock, redactSecret, redactSensitiveInfo } from "./logger/redact.js";
 import { exportLog, flushExporters, getExporters, initializeExporters } from "./logger/exporters.js";
 import { configureAuditLog, getAuditConfig, logAuditEvent, logAuthEvent, logConfigChange, logDataAccess, logPermissionChange } from "./logger/audit.js";

package/dist/src/work-items/work-item-service.js

@@ -1,6 +1,6 @@
-import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { deleteMediaBuffer, mimeTypeFromMediaPath, saveMediaBuffer } from "../media/store.js";
 import { readMediaReference } from "../media/media-reference.js";
+import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { WorkItemStore } from "./work-item-store.js";
 //#region src/work-items/work-item-service.ts
 const WORK_ITEM_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;