@xopcai/xopc 0.0.143 → 0.0.145

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 36;
+export const XOPC_DB_SCHEMA_VERSION = 37;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 36 });
+	applyPendingMigrations(db, { targetVersion: 37 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

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

@@ -1,5 +1,6 @@
 import type { MemoryKind, MemoryRecord } from '../agent/memory/types.js';
 import type { ConnectorDefinition, ConnectorInstance } from '../connectors/types.js';
+import type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/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;
@@ -29,10 +30,10 @@ export declare function projectUserContextRecord(record: MemoryRecord): {
 };
 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;
+export declare function projectPersonalContextSources(definitions: ConnectorDefinition[], instances: ConnectorInstance[], records?: MemoryRecord[], knowledge?: {
+    sourceItems?: KnowledgeSourceItem[];
+    syncRuns?: KnowledgeSyncRun[];
+}): {
     category: import("../connectors/types.js").ConnectorCategory;
     capabilities: ("context" | "tools" | "events" | "memory_source")[];
     access: {
@@ -51,4 +52,12 @@ export declare function projectPersonalContextSources(definitions: ConnectorDefi
     lastHealthStatus: import("../connectors/types.js").ConnectorHealthStatus;
     lastActivityAt: string;
     derivedUnderstandingCount: number;
+    knowledgeItemCount: number;
+    lastSyncAt: string;
+    lastSyncStatus: import("../knowledge/types.js").KnowledgeSyncRunStatus;
+    lastSyncError: string;
+    branding?: import("../connectors/types.js").ConnectorBranding;
+    id: string;
+    displayName: string;
+    description: string;
 }[];

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

@@ -70,7 +70,7 @@ function isPersonalContextConnector(definition) {
 function recordsDerivedFromPersonalContextSource(records, agentId, connectorId) {
 	return records.filter((record) => record.scope.agentId === agentId && record.source.provider === connectorId && isUserContextRecord(record));
 }
-function projectPersonalContextSources(definitions, instances, records = []) {
+function projectPersonalContextSources(definitions, instances, records = [], knowledge = {}) {
 	const instanceByConnector = /* @__PURE__ */ new Map();
 	for (const instance of instances) {
 		const current = instanceByConnector.get(instance.connectorId) ?? [];
@@ -80,6 +80,9 @@ function projectPersonalContextSources(definitions, instances, records = []) {
 	return definitions.filter(isPersonalContextConnector).map((definition) => {
 		const connected = instanceByConnector.get(definition.id) ?? [];
 		const relatedRecords = records.filter((record) => record.source.provider === definition.id);
+		const sourceItems = (knowledge.sourceItems ?? []).filter((item) => item.metadata.connectorId === definition.id);
+		const sourceInstanceIds = new Set(sourceItems.map((item) => item.sourceInstanceId));
+		const latestSync = (knowledge.syncRuns ?? []).filter((run) => sourceInstanceIds.has(run.sourceInstanceId) || run.sourceInstanceId.startsWith(`composio:${definition.id}:`) || run.sourceInstanceId.startsWith(`${definition.id}:`)).sort((left, right) => Date.parse(right.startedAt) - Date.parse(left.startedAt))[0];
 		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));
@@ -87,6 +90,7 @@ function projectPersonalContextSources(definitions, instances, records = []) {
 			id: definition.id,
 			displayName: definition.displayName,
 			description: definition.description,
+			...definition.branding ? { branding: definition.branding } : {},
 			category: definition.category,
 			capabilities: definition.capabilities.filter((capability) => capability === "context" || capability === "memory_source" || capability === "tools" || capability === "events"),
 			access: {
@@ -103,12 +107,20 @@ function projectPersonalContextSources(definitions, instances, records = []) {
 			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
+			lastActivityAt: [
+				...connected.flatMap((instance) => [
+					instance.lastConnectedAt,
+					instance.usage.lastHealthCheckAt,
+					...instance.audit.map((entry) => entry.at)
+				]),
+				latestSync?.finishedAt,
+				latestSync?.startedAt
+			].filter((value) => Boolean(value)).sort().at(-1),
+			derivedUnderstandingCount: relatedRecords.length,
+			knowledgeItemCount: sourceItems.filter((item) => !item.deletedAt).length,
+			lastSyncAt: latestSync?.finishedAt ?? latestSync?.startedAt,
+			lastSyncStatus: latestSync?.status,
+			lastSyncError: latestSync?.error
 		};
 	}).sort((left, right) => {
 		if (left.installed !== right.installed) return left.installed ? -1 : 1;

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

@@ -1 +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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"}
+{"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';\nimport type { KnowledgeSourceItem, KnowledgeSyncRun } from '../knowledge/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  knowledge: { sourceItems?: KnowledgeSourceItem[]; syncRuns?: KnowledgeSyncRun[] } = {},\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 sourceItems = (knowledge.sourceItems ?? []).filter((item) => item.metadata.connectorId === definition.id);\n      const sourceInstanceIds = new Set(sourceItems.map((item) => item.sourceInstanceId));\n      const latestSync = (knowledge.syncRuns ?? [])\n        .filter((run) => (\n          sourceInstanceIds.has(run.sourceInstanceId)\n          || run.sourceInstanceId.startsWith(`composio:${definition.id}:`)\n          || run.sourceInstanceId.startsWith(`${definition.id}:`)\n        ))\n        .sort((left, right) => Date.parse(right.startedAt) - Date.parse(left.startedAt))[0];\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        ...(definition.branding ? { branding: definition.branding } : {}),\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: [\n          ...connected.flatMap((instance) => [\n            instance.lastConnectedAt,\n            instance.usage.lastHealthCheckAt,\n            ...instance.audit.map((entry) => entry.at),\n          ]),\n          latestSync?.finishedAt,\n          latestSync?.startedAt,\n        ]\n          .filter((value): value is string => Boolean(value))\n          .sort()\n          .at(-1),\n        derivedUnderstandingCount: relatedRecords.length,\n        knowledgeItemCount: sourceItems.filter((item) => !item.deletedAt).length,\n        lastSyncAt: latestSync?.finishedAt ?? latestSync?.startedAt,\n        lastSyncStatus: latestSync?.status,\n        lastSyncError: latestSync?.error,\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/voice/language-profile.d.ts

@@ -0,0 +1,20 @@
+import type { Config } from '../config/schema.js';
+export type ProductLanguage = 'en' | 'zh';
+export type VoiceLanguageMode = 'auto' | 'manual';
+export interface VoiceLanguageProfile {
+    language: ProductLanguage;
+    sttLanguage: 'auto' | 'en';
+    edgeLanguage: 'en-US' | 'zh-CN';
+    edgeVoice: 'en-US-MichelleNeural' | 'zh-CN-XiaoxiaoNeural';
+}
+export declare function resolveVoiceLanguageProfile(language: ProductLanguage): VoiceLanguageProfile;
+export declare function inferProductLanguageFromEnvironment(): ProductLanguage;
+/**
+ * Install safe product defaults while preserving every explicit on/off choice.
+ * Older configs with a persisted language or Edge voice are treated as manual.
+ */
+export declare function initializeVoiceDefaults(config: Config, language?: ProductLanguage): boolean;
+/** Apply product language only to providers whose language mapping is known. */
+export declare function applyAutomaticVoiceLanguage(config: Config, language: ProductLanguage): boolean;
+/** Start the model download without delaying gateway readiness. */
+export declare function prepareConfiguredLocalVoiceModel(config: Config): void;

package/dist/src/voice/language-profile.js

@@ -0,0 +1,156 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { DEFAULT_LOCAL_VOICE_MODEL_ID, isLocalVoiceModelInstalled } from "./local/models.js";
+import { startLocalVoiceModelInstall } from "./local/model-manager.js";
+//#region src/voice/language-profile.ts
+init_logger();
+const log = createLogger("Voice:Language");
+function resolveVoiceLanguageProfile(language) {
+	return language === "zh" ? {
+		language,
+		sttLanguage: "auto",
+		edgeLanguage: "zh-CN",
+		edgeVoice: "zh-CN-XiaoxiaoNeural"
+	} : {
+		language,
+		sttLanguage: "en",
+		edgeLanguage: "en-US",
+		edgeVoice: "en-US-MichelleNeural"
+	};
+}
+function inferProductLanguageFromEnvironment() {
+	return [
+		process.env.LC_ALL,
+		process.env.LC_MESSAGES,
+		process.env.LANG,
+		Intl.DateTimeFormat().resolvedOptions().locale
+	].find((value) => typeof value === "string" && value.trim())?.trim().toLowerCase().startsWith("zh") ? "zh" : "en";
+}
+function hasLegacyManualLanguageSelection(config) {
+	const local = config.tools?.media?.audio?.providers?.["xopc-local"];
+	const edge = config.messages?.tts?.providers?.edge;
+	return typeof local?.language === "string" && local.language.trim().length > 0 || typeof edge?.voice === "string" && edge.voice.trim().length > 0 || typeof edge?.lang === "string" && edge.lang.trim().length > 0;
+}
+/**
+* Install safe product defaults while preserving every explicit on/off choice.
+* Older configs with a persisted language or Edge voice are treated as manual.
+*/
+function initializeVoiceDefaults(config, language = inferProductLanguageFromEnvironment()) {
+	const before = JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+	const languageMode = config.voice?.languageMode ?? (hasLegacyManualLanguageSelection(config) ? "manual" : "auto");
+	config.voice = {
+		...config.voice,
+		languageMode,
+		language: config.voice?.language ?? language
+	};
+	config.tools = config.tools ?? {};
+	config.tools.media = config.tools.media ?? {};
+	const audio = config.tools.media.audio;
+	config.tools.media.audio = {
+		...audio,
+		enabled: audio?.enabled ?? true,
+		provider: audio?.provider ?? "xopc-local",
+		fallback: audio?.fallback ?? {
+			enabled: false,
+			order: ["xopc-local"]
+		},
+		providers: {
+			...audio?.providers ?? {},
+			"xopc-local": {
+				model: DEFAULT_LOCAL_VOICE_MODEL_ID,
+				...audio?.providers?.["xopc-local"] ?? {}
+			}
+		}
+	};
+	config.messages = config.messages ?? {};
+	const tts = config.messages.tts;
+	config.messages.tts = {
+		...tts,
+		enabled: tts?.enabled ?? true,
+		provider: tts?.provider ?? "edge",
+		trigger: tts?.trigger ?? "inbound",
+		providers: {
+			...tts?.providers ?? {},
+			edge: {
+				enabled: true,
+				...tts?.providers?.edge ?? {}
+			}
+		}
+	};
+	if (languageMode === "auto") applyAutomaticVoiceLanguage(config, language);
+	return before !== JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+}
+/** Apply product language only to providers whose language mapping is known. */
+function applyAutomaticVoiceLanguage(config, language) {
+	if ((config.voice?.languageMode ?? "auto") !== "auto") return false;
+	const before = JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+	const profile = resolveVoiceLanguageProfile(language);
+	config.voice = {
+		...config.voice,
+		languageMode: "auto",
+		language
+	};
+	const audio = config.tools?.media?.audio;
+	if (audio?.provider === "xopc-local") audio.providers = {
+		...audio.providers ?? {},
+		"xopc-local": {
+			...audio.providers?.["xopc-local"] ?? {},
+			model: DEFAULT_LOCAL_VOICE_MODEL_ID,
+			language: profile.sttLanguage
+		}
+	};
+	const tts = config.messages?.tts;
+	if (tts?.provider === "edge") tts.providers = {
+		...tts.providers ?? {},
+		edge: {
+			enabled: true,
+			...tts.providers?.edge ?? {},
+			voice: profile.edgeVoice,
+			lang: profile.edgeLanguage
+		}
+	};
+	return before !== JSON.stringify({
+		voice: config.voice,
+		tools: config.tools?.media?.audio,
+		tts: config.messages?.tts
+	});
+}
+/** Start the model download without delaying gateway readiness. */
+function prepareConfiguredLocalVoiceModel(config) {
+	const audio = config.tools?.media?.audio;
+	if (audio?.enabled === false || (audio?.provider ?? "xopc-local") !== "xopc-local") return;
+	const configuredModel = audio?.providers?.["xopc-local"]?.model;
+	const modelId = typeof configuredModel === "string" && configuredModel.trim() ? configuredModel.trim() : DEFAULT_LOCAL_VOICE_MODEL_ID;
+	if (isLocalVoiceModelInstalled(modelId)) return;
+	try {
+		startLocalVoiceModelInstall(modelId);
+		log.info({
+			modelId,
+			phase: "startup_prepare"
+		}, "Local voice model preparation started");
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		log.warn({
+			err,
+			modelId,
+			errorMessage,
+			phase: "startup_prepare"
+		}, `Local voice model preparation failed: ${errorMessage}`);
+	}
+}
+//#endregion
+export { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults, prepareConfiguredLocalVoiceModel, resolveVoiceLanguageProfile };
+
+//# sourceMappingURL=language-profile.js.map

package/dist/src/voice/language-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-profile.js","names":[],"sources":["../../../src/voice/language-profile.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { createLogger } from '../utils/logger.js';\nimport { startLocalVoiceModelInstall } from './local/model-manager.js';\nimport {\n  DEFAULT_LOCAL_VOICE_MODEL_ID,\n  isLocalVoiceModelInstalled,\n} from './local/models.js';\n\nconst log = createLogger('Voice:Language');\n\nexport type ProductLanguage = 'en' | 'zh';\nexport type VoiceLanguageMode = 'auto' | 'manual';\n\nexport interface VoiceLanguageProfile {\n  language: ProductLanguage;\n  sttLanguage: 'auto' | 'en';\n  edgeLanguage: 'en-US' | 'zh-CN';\n  edgeVoice: 'en-US-MichelleNeural' | 'zh-CN-XiaoxiaoNeural';\n}\n\nexport function resolveVoiceLanguageProfile(language: ProductLanguage): VoiceLanguageProfile {\n  return language === 'zh'\n    ? {\n        language,\n        sttLanguage: 'auto',\n        edgeLanguage: 'zh-CN',\n        edgeVoice: 'zh-CN-XiaoxiaoNeural',\n      }\n    : {\n        language,\n        sttLanguage: 'en',\n        edgeLanguage: 'en-US',\n        edgeVoice: 'en-US-MichelleNeural',\n      };\n}\n\nexport function inferProductLanguageFromEnvironment(): ProductLanguage {\n  const locale = [\n    process.env.LC_ALL,\n    process.env.LC_MESSAGES,\n    process.env.LANG,\n    Intl.DateTimeFormat().resolvedOptions().locale,\n  ].find((value) => typeof value === 'string' && value.trim());\n  return locale?.trim().toLowerCase().startsWith('zh') ? 'zh' : 'en';\n}\n\nfunction hasLegacyManualLanguageSelection(config: Config): boolean {\n  const local = config.tools?.media?.audio?.providers?.['xopc-local'];\n  const edge = config.messages?.tts?.providers?.edge;\n  return (\n    (typeof local?.language === 'string' && local.language.trim().length > 0) ||\n    (typeof edge?.voice === 'string' && edge.voice.trim().length > 0) ||\n    (typeof edge?.lang === 'string' && edge.lang.trim().length > 0)\n  );\n}\n\n/**\n * Install safe product defaults while preserving every explicit on/off choice.\n * Older configs with a persisted language or Edge voice are treated as manual.\n */\nexport function initializeVoiceDefaults(\n  config: Config,\n  language: ProductLanguage = inferProductLanguageFromEnvironment(),\n): boolean {\n  const before = JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n  const existingMode = config.voice?.languageMode;\n  const languageMode: VoiceLanguageMode =\n    existingMode ?? (hasLegacyManualLanguageSelection(config) ? 'manual' : 'auto');\n\n  config.voice = {\n    ...config.voice,\n    languageMode,\n    language: config.voice?.language ?? language,\n  };\n\n  config.tools = config.tools ?? {};\n  config.tools.media = config.tools.media ?? {};\n  const audio = config.tools.media.audio;\n  config.tools.media.audio = {\n    ...audio,\n    enabled: audio?.enabled ?? true,\n    provider: audio?.provider ?? 'xopc-local',\n    fallback: audio?.fallback ?? { enabled: false, order: ['xopc-local'] },\n    providers: {\n      ...(audio?.providers ?? {}),\n      'xopc-local': {\n        model: DEFAULT_LOCAL_VOICE_MODEL_ID,\n        ...(audio?.providers?.['xopc-local'] ?? {}),\n      },\n    },\n  };\n\n  config.messages = config.messages ?? {};\n  const tts = config.messages.tts;\n  config.messages.tts = {\n    ...tts,\n    enabled: tts?.enabled ?? true,\n    provider: tts?.provider ?? 'edge',\n    trigger: tts?.trigger ?? 'inbound',\n    providers: {\n      ...(tts?.providers ?? {}),\n      edge: {\n        enabled: true,\n        ...(tts?.providers?.edge ?? {}),\n      },\n    },\n  };\n\n  if (languageMode === 'auto') {\n    applyAutomaticVoiceLanguage(config, language);\n  }\n  return before !== JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n}\n\n/** Apply product language only to providers whose language mapping is known. */\nexport function applyAutomaticVoiceLanguage(config: Config, language: ProductLanguage): boolean {\n  if ((config.voice?.languageMode ?? 'auto') !== 'auto') return false;\n  const before = JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n  const profile = resolveVoiceLanguageProfile(language);\n\n  config.voice = { ...config.voice, languageMode: 'auto', language };\n  const audio = config.tools?.media?.audio;\n  if (audio?.provider === 'xopc-local') {\n    audio.providers = {\n      ...(audio.providers ?? {}),\n      'xopc-local': {\n        ...(audio.providers?.['xopc-local'] ?? {}),\n        model: DEFAULT_LOCAL_VOICE_MODEL_ID,\n        language: profile.sttLanguage,\n      },\n    };\n  }\n  const tts = config.messages?.tts;\n  if (tts?.provider === 'edge') {\n    tts.providers = {\n      ...(tts.providers ?? {}),\n      edge: {\n        enabled: true,\n        ...(tts.providers?.edge ?? {}),\n        voice: profile.edgeVoice,\n        lang: profile.edgeLanguage,\n      },\n    };\n  }\n  return before !== JSON.stringify({ voice: config.voice, tools: config.tools?.media?.audio, tts: config.messages?.tts });\n}\n\n/** Start the model download without delaying gateway readiness. */\nexport function prepareConfiguredLocalVoiceModel(config: Config): void {\n  const audio = config.tools?.media?.audio;\n  if (audio?.enabled === false || (audio?.provider ?? 'xopc-local') !== 'xopc-local') return;\n  const configuredModel = audio?.providers?.['xopc-local']?.model;\n  const modelId = typeof configuredModel === 'string' && configuredModel.trim()\n    ? configuredModel.trim()\n    : DEFAULT_LOCAL_VOICE_MODEL_ID;\n  if (isLocalVoiceModelInstalled(modelId)) return;\n  try {\n    startLocalVoiceModelInstall(modelId);\n    log.info({ modelId, phase: 'startup_prepare' }, 'Local voice model preparation started');\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, modelId, errorMessage, phase: 'startup_prepare' }, `Local voice model preparation failed: ${errorMessage}`);\n  }\n}\n"],"mappings":"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"}

package/dist/src/voice/local/model-files.d.ts

@@ -0,0 +1,14 @@
+import type { LocalVoiceModelDefinition } from './models.js';
+export interface LocalVoiceFileProgress {
+    status: 'download';
+    file: string;
+    loaded: number;
+    total: number;
+    progress: number;
+}
+export declare function downloadLocalVoiceModelFiles(options: {
+    model: LocalVoiceModelDefinition;
+    destinationDir: string;
+    remoteHosts: readonly string[];
+    onProgress?: (progress: LocalVoiceFileProgress) => void;
+}): Promise<void>;

package/dist/src/voice/local/model-files.js

@@ -0,0 +1,94 @@
+import { dirname, join } from "node:path";
+import { createReadStream, createWriteStream } from "node:fs";
+import { createHash } from "node:crypto";
+import { mkdir, rm, stat } from "node:fs/promises";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+//#region src/voice/local/model-files.ts
+function resolveModelFileUrl(remoteHost, model, file) {
+	const base = remoteHost.endsWith("/") ? remoteHost : `${remoteHost}/`;
+	const path = file.path.split("/").map(encodeURIComponent).join("/");
+	return new URL(`${model.repository}/resolve/${model.revision}/${path}`, base).toString();
+}
+async function sha256File(path) {
+	const hash = createHash("sha256");
+	for await (const chunk of createReadStream(path)) hash.update(chunk);
+	return hash.digest("hex");
+}
+async function downloadFile(url, destination, expectedBytes, onBytes) {
+	const existing = await stat(destination).catch(() => null);
+	let offset = existing?.isFile() ? existing.size : 0;
+	if (offset > expectedBytes) {
+		await rm(destination, { force: true });
+		offset = 0;
+	}
+	if (offset === expectedBytes) {
+		onBytes(offset);
+		return;
+	}
+	const response = await fetch(url, {
+		redirect: "follow",
+		headers: offset > 0 ? { Range: `bytes=${offset}-` } : void 0
+	});
+	if (!response.ok || !response.body) throw new Error(`Model download failed with HTTP ${response.status}`);
+	const isResume = offset > 0 && response.status === 206;
+	if (offset > 0 && !isResume) offset = 0;
+	const declaredBytes = Number(response.headers.get("content-length"));
+	const expectedResponseBytes = expectedBytes - offset;
+	if (Number.isFinite(declaredBytes) && declaredBytes > 0 && declaredBytes !== expectedResponseBytes) throw new Error(`Model download size mismatch: expected ${expectedResponseBytes}, received ${declaredBytes}`);
+	await mkdir(dirname(destination), { recursive: true });
+	let loaded = offset;
+	let lastReportedBytes = offset;
+	let lastReportedAt = 0;
+	const source = Readable.fromWeb(response.body);
+	source.on("data", (chunk) => {
+		loaded += chunk.length;
+		const now = Date.now();
+		if (loaded === expectedBytes || loaded - lastReportedBytes >= 256 * 1024 || now - lastReportedAt >= 250) {
+			lastReportedBytes = loaded;
+			lastReportedAt = now;
+			onBytes(loaded);
+		}
+	});
+	await pipeline(source, createWriteStream(destination, {
+		flags: isResume ? "a" : "w",
+		mode: 384
+	}));
+	if (loaded !== expectedBytes) throw new Error(`Model download was incomplete: expected ${expectedBytes}, received ${loaded}`);
+}
+async function verifyModelFile(path, file) {
+	if ((await stat(path)).size !== file.bytes) throw new Error(`Model file size mismatch for ${file.path}`);
+	if (await sha256File(path) !== file.sha256) throw new Error(`Model file checksum mismatch for ${file.path}`);
+}
+async function downloadLocalVoiceModelFiles(options) {
+	const files = options.model.files;
+	if (!files?.length) throw new Error(`No downloadable files declared for ${options.model.id}`);
+	const total = files.reduce((sum, file) => sum + file.bytes, 0);
+	let completedBytes = 0;
+	for (const file of files) {
+		const destination = join(options.destinationDir, file.path);
+		let lastError;
+		for (const host of options.remoteHosts) try {
+			await downloadFile(resolveModelFileUrl(host, options.model, file), destination, file.bytes, (fileBytes) => options.onProgress?.({
+				status: "download",
+				file: file.path,
+				loaded: completedBytes + fileBytes,
+				total,
+				progress: (completedBytes + fileBytes) / total
+			}));
+			await verifyModelFile(destination, file);
+			lastError = void 0;
+			break;
+		} catch (error) {
+			lastError = error;
+			const message = error instanceof Error ? error.message : String(error);
+			if (message.includes("checksum mismatch") || message.includes("size mismatch")) await rm(destination, { force: true });
+		}
+		if (lastError) throw lastError;
+		completedBytes += file.bytes;
+	}
+}
+//#endregion
+export { downloadLocalVoiceModelFiles };
+
+//# sourceMappingURL=model-files.js.map

package/dist/src/voice/local/model-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-files.js","names":[],"sources":["../../../../src/voice/local/model-files.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { createReadStream, createWriteStream } from 'node:fs';\nimport { mkdir, rm, stat } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\n\nimport type { LocalVoiceModelDefinition, LocalVoiceModelFile } from './models.js';\n\nexport interface LocalVoiceFileProgress {\n  status: 'download';\n  file: string;\n  loaded: number;\n  total: number;\n  progress: number;\n}\n\nfunction resolveModelFileUrl(\n  remoteHost: string,\n  model: LocalVoiceModelDefinition,\n  file: LocalVoiceModelFile,\n): string {\n  const base = remoteHost.endsWith('/') ? remoteHost : `${remoteHost}/`;\n  const path = file.path.split('/').map(encodeURIComponent).join('/');\n  return new URL(`${model.repository}/resolve/${model.revision}/${path}`, base).toString();\n}\n\nasync function sha256File(path: string): Promise<string> {\n  const hash = createHash('sha256');\n  for await (const chunk of createReadStream(path)) hash.update(chunk as Buffer);\n  return hash.digest('hex');\n}\n\nasync function downloadFile(\n  url: string,\n  destination: string,\n  expectedBytes: number,\n  onBytes: (bytes: number) => void,\n): Promise<void> {\n  const existing = await stat(destination).catch(() => null);\n  let offset = existing?.isFile() ? existing.size : 0;\n  if (offset > expectedBytes) {\n    await rm(destination, { force: true });\n    offset = 0;\n  }\n  if (offset === expectedBytes) {\n    onBytes(offset);\n    return;\n  }\n  const response = await fetch(url, {\n    redirect: 'follow',\n    headers: offset > 0 ? { Range: `bytes=${offset}-` } : undefined,\n  });\n  if (!response.ok || !response.body) {\n    throw new Error(`Model download failed with HTTP ${response.status}`);\n  }\n  const isResume = offset > 0 && response.status === 206;\n  if (offset > 0 && !isResume) offset = 0;\n  const declaredBytes = Number(response.headers.get('content-length'));\n  const expectedResponseBytes = expectedBytes - offset;\n  if (Number.isFinite(declaredBytes) && declaredBytes > 0 && declaredBytes !== expectedResponseBytes) {\n    throw new Error(`Model download size mismatch: expected ${expectedResponseBytes}, received ${declaredBytes}`);\n  }\n\n  await mkdir(dirname(destination), { recursive: true });\n  let loaded = offset;\n  let lastReportedBytes = offset;\n  let lastReportedAt = 0;\n  const source = Readable.fromWeb(response.body as never);\n  source.on('data', (chunk: Buffer) => {\n    loaded += chunk.length;\n    const now = Date.now();\n    if (loaded === expectedBytes || loaded - lastReportedBytes >= 256 * 1024 || now - lastReportedAt >= 250) {\n      lastReportedBytes = loaded;\n      lastReportedAt = now;\n      onBytes(loaded);\n    }\n  });\n  await pipeline(source, createWriteStream(destination, { flags: isResume ? 'a' : 'w', mode: 0o600 }));\n  if (loaded !== expectedBytes) {\n    throw new Error(`Model download was incomplete: expected ${expectedBytes}, received ${loaded}`);\n  }\n}\n\nasync function verifyModelFile(path: string, file: LocalVoiceModelFile): Promise<void> {\n  const info = await stat(path);\n  if (info.size !== file.bytes) {\n    throw new Error(`Model file size mismatch for ${file.path}`);\n  }\n  const actual = await sha256File(path);\n  if (actual !== file.sha256) {\n    throw new Error(`Model file checksum mismatch for ${file.path}`);\n  }\n}\n\nexport async function downloadLocalVoiceModelFiles(options: {\n  model: LocalVoiceModelDefinition;\n  destinationDir: string;\n  remoteHosts: readonly string[];\n  onProgress?: (progress: LocalVoiceFileProgress) => void;\n}): Promise<void> {\n  const files = options.model.files;\n  if (!files?.length) throw new Error(`No downloadable files declared for ${options.model.id}`);\n  const total = files.reduce((sum, file) => sum + file.bytes, 0);\n  let completedBytes = 0;\n\n  for (const file of files) {\n    const destination = join(options.destinationDir, file.path);\n    let lastError: unknown;\n    for (const host of options.remoteHosts) {\n      try {\n        await downloadFile(\n          resolveModelFileUrl(host, options.model, file),\n          destination,\n          file.bytes,\n          (fileBytes) => options.onProgress?.({\n            status: 'download',\n            file: file.path,\n            loaded: completedBytes + fileBytes,\n            total,\n            progress: (completedBytes + fileBytes) / total,\n          }),\n        );\n        await verifyModelFile(destination, file);\n        lastError = undefined;\n        break;\n      } catch (error) {\n        lastError = error;\n        const message = error instanceof Error ? error.message : String(error);\n        if (message.includes('checksum mismatch') || message.includes('size mismatch')) {\n          await rm(destination, { force: true });\n        }\n      }\n    }\n    if (lastError) {\n      throw lastError;\n    }\n    completedBytes += file.bytes;\n  }\n}\n"],"mappings":";;;;;;;AAiBA,SAAS,oBACP,YACA,OACA,MACQ;CACR,MAAM,OAAO,WAAW,SAAS,IAAI,GAAG,aAAa,GAAG,WAAW;CACnE,MAAM,OAAO,KAAK,KAAK,MAAM,IAAI,CAAC,IAAI,mBAAmB,CAAC,KAAK,IAAI;AACnE,QAAO,IAAI,IAAI,GAAG,MAAM,WAAW,WAAW,MAAM,SAAS,GAAG,QAAQ,KAAK,CAAC,UAAU;;AAG1F,eAAe,WAAW,MAA+B;CACvD,MAAM,OAAO,WAAW,SAAS;AACjC,YAAW,MAAM,SAAS,iBAAiB,KAAK,CAAE,MAAK,OAAO,MAAgB;AAC9E,QAAO,KAAK,OAAO,MAAM;;AAG3B,eAAe,aACb,KACA,aACA,eACA,SACe;CACf,MAAM,WAAW,MAAM,KAAK,YAAY,CAAC,YAAY,KAAK;CAC1D,IAAI,SAAS,UAAU,QAAQ,GAAG,SAAS,OAAO;AAClD,KAAI,SAAS,eAAe;AAC1B,QAAM,GAAG,aAAa,EAAE,OAAO,MAAM,CAAC;AACtC,WAAS;;AAEX,KAAI,WAAW,eAAe;AAC5B,UAAQ,OAAO;AACf;;CAEF,MAAM,WAAW,MAAM,MAAM,KAAK;EAChC,UAAU;EACV,SAAS,SAAS,IAAI,EAAE,OAAO,SAAS,OAAO,IAAI,GAAG,KAAA;EACvD,CAAC;AACF,KAAI,CAAC,SAAS,MAAM,CAAC,SAAS,KAC5B,OAAM,IAAI,MAAM,mCAAmC,SAAS,SAAS;CAEvE,MAAM,WAAW,SAAS,KAAK,SAAS,WAAW;AACnD,KAAI,SAAS,KAAK,CAAC,SAAU,UAAS;CACtC,MAAM,gBAAgB,OAAO,SAAS,QAAQ,IAAI,iBAAiB,CAAC;CACpE,MAAM,wBAAwB,gBAAgB;AAC9C,KAAI,OAAO,SAAS,cAAc,IAAI,gBAAgB,KAAK,kBAAkB,sBAC3E,OAAM,IAAI,MAAM,0CAA0C,sBAAsB,aAAa,gBAAgB;AAG/G,OAAM,MAAM,QAAQ,YAAY,EAAE,EAAE,WAAW,MAAM,CAAC;CACtD,IAAI,SAAS;CACb,IAAI,oBAAoB;CACxB,IAAI,iBAAiB;CACrB,MAAM,SAAS,SAAS,QAAQ,SAAS,KAAc;AACvD,QAAO,GAAG,SAAS,UAAkB;AACnC,YAAU,MAAM;EAChB,MAAM,MAAM,KAAK,KAAK;AACtB,MAAI,WAAW,iBAAiB,SAAS,qBAAqB,MAAM,QAAQ,MAAM,kBAAkB,KAAK;AACvG,uBAAoB;AACpB,oBAAiB;AACjB,WAAQ,OAAO;;GAEjB;AACF,OAAM,SAAS,QAAQ,kBAAkB,aAAa;EAAE,OAAO,WAAW,MAAM;EAAK,MAAM;EAAO,CAAC,CAAC;AACpG,KAAI,WAAW,cACb,OAAM,IAAI,MAAM,2CAA2C,cAAc,aAAa,SAAS;;AAInG,eAAe,gBAAgB,MAAc,MAA0C;AAErF,MAAI,MADe,KAAK,KAAK,EACpB,SAAS,KAAK,MACrB,OAAM,IAAI,MAAM,gCAAgC,KAAK,OAAO;AAG9D,KAAI,MADiB,WAAW,KAAK,KACtB,KAAK,OAClB,OAAM,IAAI,MAAM,oCAAoC,KAAK,OAAO;;AAIpE,eAAsB,6BAA6B,SAKjC;CAChB,MAAM,QAAQ,QAAQ,MAAM;AAC5B,KAAI,CAAC,OAAO,OAAQ,OAAM,IAAI,MAAM,sCAAsC,QAAQ,MAAM,KAAK;CAC7F,MAAM,QAAQ,MAAM,QAAQ,KAAK,SAAS,MAAM,KAAK,OAAO,EAAE;CAC9D,IAAI,iBAAiB;AAErB,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,cAAc,KAAK,QAAQ,gBAAgB,KAAK,KAAK;EAC3D,IAAI;AACJ,OAAK,MAAM,QAAQ,QAAQ,YACzB,KAAI;AACF,SAAM,aACJ,oBAAoB,MAAM,QAAQ,OAAO,KAAK,EAC9C,aACA,KAAK,QACJ,cAAc,QAAQ,aAAa;IAClC,QAAQ;IACR,MAAM,KAAK;IACX,QAAQ,iBAAiB;IACzB;IACA,WAAW,iBAAiB,aAAa;IAC1C,CAAC,CACH;AACD,SAAM,gBAAgB,aAAa,KAAK;AACxC,eAAY,KAAA;AACZ;WACO,OAAO;AACd,eAAY;GACZ,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACtE,OAAI,QAAQ,SAAS,oBAAoB,IAAI,QAAQ,SAAS,gBAAgB,CAC5E,OAAM,GAAG,aAAa,EAAE,OAAO,MAAM,CAAC;;AAI5C,MAAI,UACF,OAAM;AAER,oBAAkB,KAAK"}

package/dist/src/voice/local/model-manager.d.ts

@@ -0,0 +1,18 @@
+export type LocalVoiceModelState = 'not_installed' | 'downloading' | 'ready' | 'error';
+export interface LocalVoiceModelStatus {
+    id: string;
+    name: string;
+    description: string;
+    approximateBytes: number;
+    engine: string;
+    languages: readonly string[];
+    recommended?: boolean;
+    state: LocalVoiceModelState;
+    progress?: number;
+    downloadedBytes?: number;
+    totalBytes?: number;
+    error?: string;
+}
+export declare function listLocalVoiceModelStatuses(): Promise<LocalVoiceModelStatus[]>;
+export declare function startLocalVoiceModelInstall(modelId: string): LocalVoiceModelStatus;
+export declare function removeLocalVoiceModel(modelId: string): Promise<void>;

package/dist/src/voice/local/model-manager.js

@@ -0,0 +1,135 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { LOCAL_VOICE_MODELS, getLocalVoiceModel, isLocalVoiceModelInstalled, resolveLocalVoiceModelDir, resolveLocalVoiceModelMarkerPath } from "./models.js";
+import { getLocalVoiceRuntimeClient } from "./runtime-client.js";
+import { join } from "node:path";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+//#region src/voice/local/model-manager.ts
+init_logger();
+const log = createLogger("LocalVoice:Models");
+const jobs = /* @__PURE__ */ new Map();
+function progressFraction(progress) {
+	if (typeof progress.progress === "number" && Number.isFinite(progress.progress)) return progress.progress > 1 ? progress.progress / 100 : progress.progress;
+	if (typeof progress.loaded === "number" && typeof progress.total === "number" && progress.total > 0) return progress.loaded / progress.total;
+}
+async function listLocalVoiceModelStatuses() {
+	return Promise.all(LOCAL_VOICE_MODELS.map(async (model) => {
+		const active = jobs.get(model.id);
+		if (active) return { ...active };
+		if (!isLocalVoiceModelInstalled(model.id)) return {
+			id: model.id,
+			name: model.name,
+			description: model.description,
+			approximateBytes: model.approximateBytes,
+			engine: model.engine,
+			languages: model.languages,
+			recommended: model.recommended,
+			state: "not_installed"
+		};
+		let installedAt;
+		try {
+			installedAt = JSON.parse(await readFile(resolveLocalVoiceModelMarkerPath(model.id), "utf8")).installedAt;
+		} catch {}
+		return {
+			id: model.id,
+			name: model.name,
+			description: installedAt ? `${model.description} Installed ${installedAt}.` : model.description,
+			approximateBytes: model.approximateBytes,
+			engine: model.engine,
+			languages: model.languages,
+			recommended: model.recommended,
+			state: "ready"
+		};
+	}));
+}
+function startLocalVoiceModelInstall(modelId) {
+	const model = getLocalVoiceModel(modelId);
+	const existing = jobs.get(model.id);
+	if (existing?.state === "downloading") return { ...existing };
+	const status = {
+		id: model.id,
+		name: model.name,
+		description: model.description,
+		approximateBytes: model.approximateBytes,
+		engine: model.engine,
+		languages: model.languages,
+		recommended: model.recommended,
+		state: "downloading",
+		progress: 0
+	};
+	jobs.set(model.id, status);
+	(async () => {
+		const modelDir = resolveLocalVoiceModelDir(model.id);
+		const stagingDir = `${modelDir}.download`;
+		try {
+			if (model.engine === "transformers.js") await rm(stagingDir, {
+				recursive: true,
+				force: true
+			});
+			await mkdir(stagingDir, { recursive: true });
+			await getLocalVoiceRuntimeClient().request("model.install", {
+				modelId: model.id,
+				cacheDir: stagingDir
+			}, { onProgress: (progress) => {
+				const current = jobs.get(model.id);
+				if (!current) return;
+				current.progress = progressFraction(progress) ?? current.progress;
+				current.downloadedBytes = progress.loaded;
+				current.totalBytes = progress.total;
+			} });
+			await writeFile(join(stagingDir, "installed.json"), `${JSON.stringify({
+				modelId: model.id,
+				repository: model.repository,
+				revision: model.revision,
+				engine: model.engine,
+				...model.dtype ? { dtype: model.dtype } : {},
+				installedAt: (/* @__PURE__ */ new Date()).toISOString()
+			}, null, 2)}\n`, { mode: 384 });
+			await rm(modelDir, {
+				recursive: true,
+				force: true
+			});
+			await rename(stagingDir, modelDir);
+			jobs.delete(model.id);
+			log.info({ modelId: model.id }, "Local voice model installed");
+		} catch (error) {
+			if (model.engine === "transformers.js") await rm(stagingDir, {
+				recursive: true,
+				force: true
+			}).catch(() => {});
+			const message = error instanceof Error ? error.message : String(error);
+			jobs.set(model.id, {
+				...status,
+				state: "error",
+				error: message
+			});
+			log.error({
+				err: error,
+				modelId: model.id
+			}, `Local voice model installation failed: ${message}`);
+		}
+	})();
+	return { ...status };
+}
+async function removeLocalVoiceModel(modelId) {
+	const model = getLocalVoiceModel(modelId);
+	if (jobs.get(model.id)?.state === "downloading") throw new Error("Cannot remove a model while it is downloading");
+	try {
+		await getLocalVoiceRuntimeClient().request("model.unload", { modelId: model.id }, { timeoutMs: 1e4 });
+	} catch (error) {
+		log.warn({
+			err: error,
+			modelId: model.id
+		}, "Local voice runtime unload failed; removing model files");
+	}
+	await rm(resolveLocalVoiceModelDir(model.id), {
+		recursive: true,
+		force: true
+	});
+	jobs.delete(model.id);
+	log.info({ modelId: model.id }, "Local voice model removed");
+}
+//#endregion
+export { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall };
+
+//# sourceMappingURL=model-manager.js.map