@xopcai/xopc 0.0.141 → 0.0.143

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/voice/tts/summarize.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { truncateAtSentenceBoundary } from "./sentence-boundary.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 //#region src/voice/tts/summarize.ts
 init_providers();
 init_logger();
@@ -67,7 +67,7 @@ async function summarizeForTts(options) {
 		};
 		const timeoutSignal = typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function" ? AbortSignal.timeout(SUMMARIZE_TIMEOUT_MS) : void 0;
 		const mergedSignal = signal && timeoutSignal && typeof AbortSignal.any === "function" ? AbortSignal.any([signal, timeoutSignal]) : signal ?? timeoutSignal;
-		const result = await complete(model, { messages: [userMsg] }, {
+		const result = await completeWithResolvedCredentials(model, { messages: [userMsg] }, {
 			maxTokens: Math.min(Math.ceil(targetLength / 2), 4096),
 			temperature: .3,
 			signal: mergedSignal

package/dist/src/voice/tts/summarize.js.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","names":[],"sources":["../../../../src/voice/tts/summarize.ts"],"sourcesContent":["import { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { truncateAtSentenceBoundary } from './sentence-boundary.js';\n\nconst log = createLogger('TTS:Summarize');\n\nconst SUMMARIZE_TIMEOUT_MS = 45_000;\n\nconst SUMMARIZE_SYSTEM_PROMPT = `You are a text summarizer for a text-to-speech system.\nYour task is to condense the given text while preserving the key information and meaning.\n\nRules:\n1. Output ONLY the summarized text, no explanations or meta-commentary\n2. Keep the summary in the same language as the input\n3. Preserve key facts, numbers, names, and conclusions\n4. Use natural, spoken language suitable for audio playback\n5. Remove code blocks, URLs, markdown formatting, and technical syntax where possible\n6. Keep the summary under the specified character limit\n7. End with a complete sentence, never mid-sentence`;\n\nexport interface SummarizeForTtsOptions {\n  text: string;\n  targetLength: number;\n  config?: Config;\n  modelRef?: string;\n  signal?: AbortSignal;\n}\n\nexport interface SummarizeResult {\n  summary: string;\n  originalLength: number;\n  summaryLength: number;\n  wasSummarized: boolean;\n}\n\nfunction resolveSummarizeModel(config: Config | undefined, modelRef?: string): Model<Api> {\n  const envRef = process.env.XOPC_TTS_SUMMARIZE_MODEL?.trim();\n  const ref = modelRef?.trim() || envRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch {\n      /* fall through */\n    }\n  }\n  for (const candidate of ['openai/gpt-5.6-luna', 'google/gemini-3.5-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch {\n      /* next */\n    }\n  }\n  return resolveModel(getDefaultModelSync(config));\n}\n\nfunction fallbackTruncate(text: string, maxLength: number): SummarizeResult {\n  const truncated = truncateAtSentenceBoundary(text, maxLength);\n  return {\n    summary: truncated,\n    originalLength: text.length,\n    summaryLength: truncated.length,\n    wasSummarized: false,\n  };\n}\n\n/**\n * Condense text for TTS using a small LLM pass; falls back to sentence-boundary truncation.\n */\nexport async function summarizeForTts(options: SummarizeForTtsOptions): Promise<SummarizeResult> {\n  const { text, targetLength, config, modelRef, signal } = options;\n\n  if (text.length <= targetLength) {\n    return {\n      summary: text,\n      originalLength: text.length,\n      summaryLength: text.length,\n      wasSummarized: false,\n    };\n  }\n\n  const startTime = Date.now();\n\n  try {\n    const model = resolveSummarizeModel(config, modelRef);\n    const userPrompt = [\n      `Summarize the following text to fit within ${targetLength} characters.`,\n      `The summary will be read aloud by a text-to-speech system, so use natural spoken language.`,\n      '',\n      '---',\n      '',\n      text,\n    ].join('\\n');\n\n    const userMsg: UserMessage = {\n      role: 'user',\n      content: `${SUMMARIZE_SYSTEM_PROMPT}\\n\\n---\\n\\n${userPrompt}`,\n      timestamp: Date.now(),\n    };\n\n    const timeoutSignal =\n      typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n        ? AbortSignal.timeout(SUMMARIZE_TIMEOUT_MS)\n        : undefined;\n    const mergedSignal =\n      signal && timeoutSignal && typeof AbortSignal.any === 'function'\n        ? AbortSignal.any([signal, timeoutSignal])\n        : signal ?? timeoutSignal;\n\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: Math.min(Math.ceil(targetLength / 2), 4096),\n        temperature: 0.3,\n        signal: mergedSignal as AbortSignal,\n      },\n    );\n\n    let out = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          out += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const summary = out.trim();\n    if (!summary) {\n      log.warn('Empty summary returned, falling back to truncation');\n      return fallbackTruncate(text, targetLength);\n    }\n\n    const finalSummary =\n      summary.length > targetLength ? truncateAtSentenceBoundary(summary, targetLength) : summary;\n\n    log.info(\n      {\n        originalLength: text.length,\n        summaryLength: finalSummary.length,\n        durationMs: Date.now() - startTime,\n      },\n      'Text summarized for TTS',\n    );\n\n    return {\n      summary: finalSummary,\n      originalLength: text.length,\n      summaryLength: finalSummary.length,\n      wasSummarized: true,\n    };\n  } catch (error) {\n    const em = error instanceof Error ? error.message : String(error);\n    log.warn({ errorMessage: em }, 'Summarization failed, falling back to truncation');\n    return fallbackTruncate(text, targetLength);\n  }\n}\n"],"mappings":";;;;;;gBAI6E;aACxB;AAGrD,MAAM,MAAM,aAAa,gBAAgB;AAEzC,MAAM,uBAAuB;AAE7B,MAAM,0BAA0B;;;;;;;;;;;AA2BhC,SAAS,sBAAsB,QAA4B,UAA+B;CACxF,MAAM,SAAS,QAAQ,IAAI,0BAA0B,MAAM;CAC3D,MAAM,MAAM,UAAU,MAAM,IAAI;AAChC,KAAI,IACF,KAAI;AACF,SAAO,aAAa,IAAI;SAClB;AAIV,MAAK,MAAM,aAAa,CAAC,uBAAuB,0BAA0B,CACxE,KAAI;AACF,SAAO,aAAa,UAAU;SACxB;AAIV,QAAO,aAAa,oBAAoB,OAAO,CAAC;;AAGlD,SAAS,iBAAiB,MAAc,WAAoC;CAC1E,MAAM,YAAY,2BAA2B,MAAM,UAAU;AAC7D,QAAO;EACL,SAAS;EACT,gBAAgB,KAAK;EACrB,eAAe,UAAU;EACzB,eAAe;EAChB;;;;;AAMH,eAAsB,gBAAgB,SAA2D;CAC/F,MAAM,EAAE,MAAM,cAAc,QAAQ,UAAU,WAAW;AAEzD,KAAI,KAAK,UAAU,aACjB,QAAO;EACL,SAAS;EACT,gBAAgB,KAAK;EACrB,eAAe,KAAK;EACpB,eAAe;EAChB;CAGH,MAAM,YAAY,KAAK,KAAK;AAE5B,KAAI;EACF,MAAM,QAAQ,sBAAsB,QAAQ,SAAS;EAUrD,MAAM,UAAuB;GAC3B,MAAM;GACN,SAAS,GAAG,wBAAwB,aAXnB;IACjB,8CAA8C,aAAa;IAC3D;IACA;IACA;IACA;IACA;IACD,CAAC,KAAK,KAIsD;GAC3D,WAAW,KAAK,KAAK;GACtB;EAED,MAAM,gBACJ,OAAO,gBAAgB,eAAe,OAAO,YAAY,YAAY,aACjE,YAAY,QAAQ,qBAAqB,GACzC,KAAA;EACN,MAAM,eACJ,UAAU,iBAAiB,OAAO,YAAY,QAAQ,aAClD,YAAY,IAAI,CAAC,QAAQ,cAAc,CAAC,GACxC,UAAU;EAEhB,MAAM,SAAS,MAAM,SACnB,OACA,EAAE,UAAU,CAAC,QAAQ,EAAE,EACvB;GACE,WAAW,KAAK,IAAI,KAAK,KAAK,eAAe,EAAE,EAAE,KAAK;GACtD,aAAa;GACb,QAAQ;GACT,CACF;EAED,IAAI,MAAM;AACV,MAAI,MAAM,QAAQ,OAAO,QAAQ;QAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,QAAO,OAAQ,EAAwB,QAAQ,GAAG;;EAKxD,MAAM,UAAU,IAAI,MAAM;AAC1B,MAAI,CAAC,SAAS;AACZ,OAAI,KAAK,qDAAqD;AAC9D,UAAO,iBAAiB,MAAM,aAAa;;EAG7C,MAAM,eACJ,QAAQ,SAAS,eAAe,2BAA2B,SAAS,aAAa,GAAG;AAEtF,MAAI,KACF;GACE,gBAAgB,KAAK;GACrB,eAAe,aAAa;GAC5B,YAAY,KAAK,KAAK,GAAG;GAC1B,EACD,0BACD;AAED,SAAO;GACL,SAAS;GACT,gBAAgB,KAAK;GACrB,eAAe,aAAa;GAC5B,eAAe;GAChB;UACM,OAAO;EACd,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,MAAI,KAAK,EAAE,cAAc,IAAI,EAAE,mDAAmD;AAClF,SAAO,iBAAiB,MAAM,aAAa"}
+{"version":3,"file":"summarize.js","names":[],"sources":["../../../../src/voice/tts/summarize.ts"],"sourcesContent":["import { type UserMessage } from '@earendil-works/pi-ai/compat';\nimport type { Api, Model } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../providers/model-call.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { truncateAtSentenceBoundary } from './sentence-boundary.js';\n\nconst log = createLogger('TTS:Summarize');\n\nconst SUMMARIZE_TIMEOUT_MS = 45_000;\n\nconst SUMMARIZE_SYSTEM_PROMPT = `You are a text summarizer for a text-to-speech system.\nYour task is to condense the given text while preserving the key information and meaning.\n\nRules:\n1. Output ONLY the summarized text, no explanations or meta-commentary\n2. Keep the summary in the same language as the input\n3. Preserve key facts, numbers, names, and conclusions\n4. Use natural, spoken language suitable for audio playback\n5. Remove code blocks, URLs, markdown formatting, and technical syntax where possible\n6. Keep the summary under the specified character limit\n7. End with a complete sentence, never mid-sentence`;\n\nexport interface SummarizeForTtsOptions {\n  text: string;\n  targetLength: number;\n  config?: Config;\n  modelRef?: string;\n  signal?: AbortSignal;\n}\n\nexport interface SummarizeResult {\n  summary: string;\n  originalLength: number;\n  summaryLength: number;\n  wasSummarized: boolean;\n}\n\nfunction resolveSummarizeModel(config: Config | undefined, modelRef?: string): Model<Api> {\n  const envRef = process.env.XOPC_TTS_SUMMARIZE_MODEL?.trim();\n  const ref = modelRef?.trim() || envRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch {\n      /* fall through */\n    }\n  }\n  for (const candidate of ['openai/gpt-5.6-luna', 'google/gemini-3.5-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch {\n      /* next */\n    }\n  }\n  return resolveModel(getDefaultModelSync(config));\n}\n\nfunction fallbackTruncate(text: string, maxLength: number): SummarizeResult {\n  const truncated = truncateAtSentenceBoundary(text, maxLength);\n  return {\n    summary: truncated,\n    originalLength: text.length,\n    summaryLength: truncated.length,\n    wasSummarized: false,\n  };\n}\n\n/**\n * Condense text for TTS using a small LLM pass; falls back to sentence-boundary truncation.\n */\nexport async function summarizeForTts(options: SummarizeForTtsOptions): Promise<SummarizeResult> {\n  const { text, targetLength, config, modelRef, signal } = options;\n\n  if (text.length <= targetLength) {\n    return {\n      summary: text,\n      originalLength: text.length,\n      summaryLength: text.length,\n      wasSummarized: false,\n    };\n  }\n\n  const startTime = Date.now();\n\n  try {\n    const model = resolveSummarizeModel(config, modelRef);\n    const userPrompt = [\n      `Summarize the following text to fit within ${targetLength} characters.`,\n      `The summary will be read aloud by a text-to-speech system, so use natural spoken language.`,\n      '',\n      '---',\n      '',\n      text,\n    ].join('\\n');\n\n    const userMsg: UserMessage = {\n      role: 'user',\n      content: `${SUMMARIZE_SYSTEM_PROMPT}\\n\\n---\\n\\n${userPrompt}`,\n      timestamp: Date.now(),\n    };\n\n    const timeoutSignal =\n      typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n        ? AbortSignal.timeout(SUMMARIZE_TIMEOUT_MS)\n        : undefined;\n    const mergedSignal =\n      signal && timeoutSignal && typeof AbortSignal.any === 'function'\n        ? AbortSignal.any([signal, timeoutSignal])\n        : signal ?? timeoutSignal;\n\n    const result = await completeWithResolvedCredentials(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: Math.min(Math.ceil(targetLength / 2), 4096),\n        temperature: 0.3,\n        signal: mergedSignal as AbortSignal,\n      },\n    );\n\n    let out = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          out += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const summary = out.trim();\n    if (!summary) {\n      log.warn('Empty summary returned, falling back to truncation');\n      return fallbackTruncate(text, targetLength);\n    }\n\n    const finalSummary =\n      summary.length > targetLength ? truncateAtSentenceBoundary(summary, targetLength) : summary;\n\n    log.info(\n      {\n        originalLength: text.length,\n        summaryLength: finalSummary.length,\n        durationMs: Date.now() - startTime,\n      },\n      'Text summarized for TTS',\n    );\n\n    return {\n      summary: finalSummary,\n      originalLength: text.length,\n      summaryLength: finalSummary.length,\n      wasSummarized: true,\n    };\n  } catch (error) {\n    const em = error instanceof Error ? error.message : String(error);\n    log.warn({ errorMessage: em }, 'Summarization failed, falling back to truncation');\n    return fallbackTruncate(text, targetLength);\n  }\n}\n"],"mappings":";;;;;;gBAI6E;aAExB;AAGrD,MAAM,MAAM,aAAa,gBAAgB;AAEzC,MAAM,uBAAuB;AAE7B,MAAM,0BAA0B;;;;;;;;;;;AA2BhC,SAAS,sBAAsB,QAA4B,UAA+B;CACxF,MAAM,SAAS,QAAQ,IAAI,0BAA0B,MAAM;CAC3D,MAAM,MAAM,UAAU,MAAM,IAAI;AAChC,KAAI,IACF,KAAI;AACF,SAAO,aAAa,IAAI;SAClB;AAIV,MAAK,MAAM,aAAa,CAAC,uBAAuB,0BAA0B,CACxE,KAAI;AACF,SAAO,aAAa,UAAU;SACxB;AAIV,QAAO,aAAa,oBAAoB,OAAO,CAAC;;AAGlD,SAAS,iBAAiB,MAAc,WAAoC;CAC1E,MAAM,YAAY,2BAA2B,MAAM,UAAU;AAC7D,QAAO;EACL,SAAS;EACT,gBAAgB,KAAK;EACrB,eAAe,UAAU;EACzB,eAAe;EAChB;;;;;AAMH,eAAsB,gBAAgB,SAA2D;CAC/F,MAAM,EAAE,MAAM,cAAc,QAAQ,UAAU,WAAW;AAEzD,KAAI,KAAK,UAAU,aACjB,QAAO;EACL,SAAS;EACT,gBAAgB,KAAK;EACrB,eAAe,KAAK;EACpB,eAAe;EAChB;CAGH,MAAM,YAAY,KAAK,KAAK;AAE5B,KAAI;EACF,MAAM,QAAQ,sBAAsB,QAAQ,SAAS;EAUrD,MAAM,UAAuB;GAC3B,MAAM;GACN,SAAS,GAAG,wBAAwB,aAXnB;IACjB,8CAA8C,aAAa;IAC3D;IACA;IACA;IACA;IACA;IACD,CAAC,KAAK,KAIsD;GAC3D,WAAW,KAAK,KAAK;GACtB;EAED,MAAM,gBACJ,OAAO,gBAAgB,eAAe,OAAO,YAAY,YAAY,aACjE,YAAY,QAAQ,qBAAqB,GACzC,KAAA;EACN,MAAM,eACJ,UAAU,iBAAiB,OAAO,YAAY,QAAQ,aAClD,YAAY,IAAI,CAAC,QAAQ,cAAc,CAAC,GACxC,UAAU;EAEhB,MAAM,SAAS,MAAM,gCACnB,OACA,EAAE,UAAU,CAAC,QAAQ,EAAE,EACvB;GACE,WAAW,KAAK,IAAI,KAAK,KAAK,eAAe,EAAE,EAAE,KAAK;GACtD,aAAa;GACb,QAAQ;GACT,CACF;EAED,IAAI,MAAM;AACV,MAAI,MAAM,QAAQ,OAAO,QAAQ;QAC1B,MAAM,KAAK,OAAO,QACrB,KAAI,KAAK,OAAO,MAAM,YAAa,EAAwB,SAAS,OAClE,QAAO,OAAQ,EAAwB,QAAQ,GAAG;;EAKxD,MAAM,UAAU,IAAI,MAAM;AAC1B,MAAI,CAAC,SAAS;AACZ,OAAI,KAAK,qDAAqD;AAC9D,UAAO,iBAAiB,MAAM,aAAa;;EAG7C,MAAM,eACJ,QAAQ,SAAS,eAAe,2BAA2B,SAAS,aAAa,GAAG;AAEtF,MAAI,KACF;GACE,gBAAgB,KAAK;GACrB,eAAe,aAAa;GAC5B,YAAY,KAAK,KAAK,GAAG;GAC1B,EACD,0BACD;AAED,SAAO;GACL,SAAS;GACT,gBAAgB,KAAK;GACrB,eAAe,aAAa;GAC5B,eAAe;GAChB;UACM,OAAO;EACd,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,MAAI,KAAK,EAAE,cAAc,IAAI,EAAE,mDAAmD;AAClF,SAAO,iBAAiB,MAAM,aAAa"}

package/dist/src/workflows/authoring/index.d.ts

@@ -0,0 +1 @@
+export * from './workflow-draft-store.js';

package/dist/src/workflows/authoring/index.js

@@ -0,0 +1,2 @@
+import { WorkflowDraftConflictError, WorkflowDraftStore } from "./workflow-draft-store.js";
+export { WorkflowDraftConflictError, WorkflowDraftStore };