@xopcai/xopc 0.0.215 → 0.0.217

package/dist/src/gateway/hono/routes/config.js

@@ -1,4 +1,5 @@
 import { enumerateLanGatewayCandidates } from "../../host.js";
+import { prepareLocalVoiceModelAfterProviderSwitch } from "../../../voice/local/provider-switch.js";
 import { buildSafeWebConfigPayload } from "../lib/config-payload.js";
 import { applyAgentsPatch } from "./config-patch/agents.js";
 import { applyChannelsPatch } from "./config-patch/channels.js";
@@ -51,6 +52,7 @@ function registerConfigRoutes(authenticated, deps) {
 	authenticated.patch("/api/config", strictRateLimitMiddleware, async (c) => {
 		const body = await c.req.json();
 		const config = service.currentConfig;
+		const previousSttProvider = config.tools?.media?.audio?.provider;
 		applyAgentsPatch(config, body);
 		applyChannelsPatch(config, body);
 		const gatewayResult = applyGatewayPatch(config, body);
@@ -73,6 +75,7 @@ function registerConfigRoutes(authenticated, deps) {
 			ok: false,
 			error: result.error
 		}, 500);
+		prepareLocalVoiceModelAfterProviderSwitch(previousSttProvider, service.currentConfig);
 		if (body.gateway?.heartbeat !== void 0 && typeof body.gateway.heartbeat === "object") service.reloadHeartbeatFromCurrentConfig();
 		const safeConfig = await buildSafeWebConfigPayload(service, { locale: localeFromRequest(c) });
 		return c.json({

package/dist/src/gateway/hono/routes/public-gateway.js

@@ -7,6 +7,17 @@ import { serveStaticFile } from "../lib/static-ui.js";
 import { createHash } from "node:crypto";
 //#region src/gateway/hono/routes/public-gateway.ts
 init_package_version();
+const PUBLIC_UI_ROOT_ASSETS = [
+	"apple-touch-icon.png",
+	"favicon-16x16.png",
+	"favicon-32x32.png",
+	"favicon.png",
+	"favicon.svg",
+	"notification-sw.js",
+	"pwa-192x192.png",
+	"pwa-512x512.png",
+	"site.webmanifest"
+];
 function registerPublicGatewayRoutes(app, service) {
 	app.get("/health", (c) => {
 		return c.json(service.getHealth());
@@ -171,6 +182,11 @@ function registerPublicGatewayRoutes(app, service) {
 		if (fallback) return fallback;
 		return c.text("Not found", 404);
 	});
+	for (const assetPath of PUBLIC_UI_ROOT_ASSETS) app.get(`/${assetPath}`, (c) => {
+		const response = serveStaticFile(assetPath, c.req.raw);
+		if (response) return response;
+		return c.text("Not found", 404);
+	});
 	app.get("/logo.svg", (c) => {
 		const response = serveStaticFile("logo.svg", c.req.raw);
 		if (response) return response;

package/dist/src/gateway/hono/routes/voice.js

@@ -12,8 +12,8 @@ import { mergeSttConfigFromAppConfig } from "../../../voice/stt/config.js";
 import "../../../voice/stt/index.js";
 import { listSttProvidersForApi } from "../../../voice/stt/list-providers.js";
 import "../../../voice/tts/index.js";
-import { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall } from "../../../voice/local/model-manager.js";
 import { createGatewayRouteLogger } from "../lib/route-logger.js";
+import { listLocalVoiceModelStatuses, removeLocalVoiceModel, startLocalVoiceModelInstall } from "../../../voice/local/model-manager.js";
 import { listTtsProvidersForApi } from "../../../voice/tts/list-providers.js";
 //#region src/gateway/hono/routes/voice.ts
 init_providers();

package/dist/src/gateway/service.js

@@ -116,7 +116,7 @@ import { GatewayAgentRunner } from "./service/agent-runner.js";
 import { RealtimeRuntime } from "../realtime/runtime.js";
 import { GatewayReadiness } from "./startup-readiness.js";
 import { createGatewayStartupTrace } from "./startup-trace.js";
-import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults, prepareConfiguredLocalVoiceModel } from "../voice/language-profile.js";
+import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
 import crypto from "crypto";
 //#region src/gateway/service.ts
 init_agent_scope();
@@ -793,7 +793,6 @@ var GatewayService = class {
 		this.proactiveWorker.start();
 		this.proactiveTemporalWorker.start();
 		this.proactiveInboxWorker.start();
-		prepareConfiguredLocalVoiceModel(this.config);
 		this.startupTrace = createGatewayStartupTrace();
 		this.readiness.markStarting(this.startTime);
 		const trace = this.startupTrace;
@@ -1268,7 +1267,6 @@ var GatewayService = class {
 				error: saved.error ?? "Failed to save voice language"
 			};
 		}
-		prepareConfiguredLocalVoiceModel(this.config);
 		return {
 			applied: changed,
 			language,

package/dist/src/gateway/xopc-cloud-capability-setup.d.ts

@@ -0,0 +1,41 @@
+import type { Config } from '../config/schema.js';
+import type { CatalogSource } from '../providers/model-catalog-store.js';
+type CloudCapability = 'vision' | 'image-generation' | 'stt' | 'tts';
+export interface XopcCloudCapabilitySelection {
+    vision: string;
+    imageGeneration: string;
+    stt: string;
+    tts: string;
+    ttsVoice: string;
+}
+export type PrepareXopcCloudCapabilitySetupResult = {
+    ok: true;
+    config: Config;
+    selection: XopcCloudCapabilitySelection;
+} | {
+    ok: false;
+    error: string;
+    missing: CloudCapability[];
+};
+export type ApplyXopcCloudCapabilitySetupResult = {
+    configured: true;
+    selection: XopcCloudCapabilitySelection;
+} | {
+    configured: false;
+    error: string;
+    missing?: CloudCapability[];
+};
+export declare function selectXopcCloudCapabilities(source: CatalogSource): {
+    selection?: XopcCloudCapabilitySelection;
+    missing: CloudCapability[];
+};
+/** Build one atomic config update for every managed XOPC Cloud media capability. */
+export declare function prepareXopcCloudCapabilitySetup(config: Config, source: CatalogSource): PrepareXopcCloudCapabilitySetupResult;
+export declare function applyXopcCloudCapabilitySetup(service: {
+    currentConfig: Config;
+    saveConfig(config: Config): Promise<{
+        saved: boolean;
+        error?: string;
+    }>;
+}): Promise<ApplyXopcCloudCapabilitySetupResult>;
+export {};

package/dist/src/gateway/xopc-cloud-capability-setup.js

@@ -0,0 +1,142 @@
+import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
+import { compareCatalogModels } from "../providers/model-catalog-ranking.js";
+import { ensureGlobalDefaultsConfig, prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
+//#region src/gateway/xopc-cloud-capability-setup.ts
+init_model_catalog_store();
+function supportsCapability(model, capability) {
+	if (model.availability !== "available") return false;
+	if (capability === "vision") return model.kind === "language" && model.input.includes("image");
+	if (capability === "image-generation") return model.kind === "image" && model.operations.includes("images.generate");
+	if (capability === "stt") return model.kind === "stt" && model.operations.includes("audio.transcription");
+	return model.kind === "tts" && model.operations.includes("audio.speech") && Boolean(model.tts?.defaultVoice);
+}
+function recommendedModel(source, capability) {
+	const recommendation = source.recommended?.[capability];
+	return source.models.filter((model) => supportsCapability(model, capability)).sort((left, right) => compareCatalogModels(left, right, recommendation))[0];
+}
+function selectXopcCloudCapabilities(source) {
+	const vision = recommendedModel(source, "vision");
+	const imageGeneration = recommendedModel(source, "image-generation");
+	const stt = recommendedModel(source, "stt");
+	const tts = recommendedModel(source, "tts");
+	const missing = [];
+	if (!vision) missing.push("vision");
+	if (!imageGeneration) missing.push("image-generation");
+	if (!stt) missing.push("stt");
+	if (!tts) missing.push("tts");
+	if (!vision || !imageGeneration || !stt || !tts || !tts.tts?.defaultVoice) return { missing };
+	return {
+		missing,
+		selection: {
+			vision: vision.id,
+			imageGeneration: imageGeneration.id,
+			stt: stt.id,
+			tts: tts.id,
+			ttsVoice: tts.tts.defaultVoice
+		}
+	};
+}
+/** Build one atomic config update for every managed XOPC Cloud media capability. */
+function prepareXopcCloudCapabilitySetup(config, source) {
+	const selected = selectXopcCloudCapabilities(source);
+	if (!selected.selection) return {
+		ok: false,
+		error: `XOPC Cloud is missing required capabilities: ${selected.missing.join(", ")}`,
+		missing: selected.missing
+	};
+	const selection = selected.selection;
+	const normalized = ensureGlobalDefaultsConfig(config);
+	const presetId = normalized.agents.defaultPreset;
+	const currentModels = normalized.agents.capabilityPresets[presetId]?.models;
+	const defaultsUpdate = prepareUpdateGlobalDefaults(normalized, { models: {
+		...currentModels,
+		imageModel: {
+			...currentModels?.imageModel,
+			primary: `xopc-cloud/${selection.vision}`
+		},
+		imageGenerationModel: {
+			...currentModels?.imageGenerationModel,
+			primary: `xopc-cloud/${selection.imageGeneration}`
+		}
+	} });
+	if (defaultsUpdate.ok === false) return {
+		ok: false,
+		error: defaultsUpdate.error,
+		missing: []
+	};
+	const withDefaults = defaultsUpdate.data.nextConfig;
+	const currentStt = withDefaults.tools?.media?.audio;
+	const currentTts = withDefaults.messages?.tts;
+	return {
+		ok: true,
+		selection,
+		config: {
+			...withDefaults,
+			tools: {
+				...withDefaults.tools,
+				media: {
+					...withDefaults.tools?.media,
+					audio: {
+						...currentStt,
+						enabled: true,
+						provider: "xopc-cloud",
+						fallback: {
+							enabled: false,
+							order: ["xopc-cloud"]
+						},
+						providers: {
+							...currentStt?.providers ?? {},
+							"xopc-cloud": {
+								...currentStt?.providers?.["xopc-cloud"] ?? {},
+								model: selection.stt
+							}
+						}
+					}
+				}
+			},
+			messages: {
+				...withDefaults.messages,
+				tts: {
+					...currentTts,
+					enabled: true,
+					provider: "xopc-cloud",
+					trigger: currentTts?.trigger ?? "off",
+					maxTextLength: currentTts?.maxTextLength ?? 512,
+					timeoutMs: currentTts?.timeoutMs ?? 6e4,
+					providers: {
+						...currentTts?.providers ?? {},
+						"xopc-cloud": {
+							...currentTts?.providers?.["xopc-cloud"] ?? {},
+							model: selection.tts,
+							voice: selection.ttsVoice
+						}
+					}
+				}
+			}
+		}
+	};
+}
+async function applyXopcCloudCapabilitySetup(service) {
+	const source = getModelCatalogStore().getSource("xopc-cloud");
+	if (!source) return {
+		configured: false,
+		error: "XOPC Cloud model catalog is unavailable"
+	};
+	const prepared = prepareXopcCloudCapabilitySetup(service.currentConfig, source);
+	if (prepared.ok === false) return {
+		configured: false,
+		error: prepared.error,
+		missing: prepared.missing
+	};
+	const saved = await service.saveConfig(prepared.config);
+	if (!saved.saved) return {
+		configured: false,
+		error: saved.error ?? "Failed to save XOPC Cloud capability configuration"
+	};
+	return {
+		configured: true,
+		selection: prepared.selection
+	};
+}
+//#endregion
+export { applyXopcCloudCapabilitySetup, prepareXopcCloudCapabilitySetup, selectXopcCloudCapabilities };

package/dist/src/voice/language-profile.d.ts

@@ -13,5 +13,3 @@ export declare function inferProductLanguageFromEnvironment(): ProductLanguage;
 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

@@ -1,10 +1,5 @@
-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";
+import { DEFAULT_LOCAL_VOICE_MODEL_ID } from "./local/models.js";
 //#region src/voice/language-profile.ts
-init_logger();
-const log = createLogger("Voice:Language");
 function resolveVoiceLanguageProfile(language) {
 	return language === "zh" ? {
 		language,
@@ -104,28 +99,5 @@ function applyAutomaticVoiceLanguage(config, language) {
 		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 };
+export { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults, resolveVoiceLanguageProfile };

package/dist/src/voice/local/provider-switch.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '../../config/schema.js';
+export declare function localVoiceModelForProviderSwitch(previousProvider: string | undefined, config: Config): string | null;
+/** Start a missing local STT model only after the provider changes to xopc-local. */
+export declare function prepareLocalVoiceModelAfterProviderSwitch(previousProvider: string | undefined, config: Config): void;

package/dist/src/voice/local/provider-switch.js

@@ -0,0 +1,36 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { DEFAULT_LOCAL_VOICE_MODEL_ID, isLocalVoiceModelInstalled } from "./models.js";
+import { startLocalVoiceModelInstall } from "./model-manager.js";
+//#region src/voice/local/provider-switch.ts
+init_logger();
+const log = createLogger("Voice:Local");
+function localVoiceModelForProviderSwitch(previousProvider, config) {
+	const audio = config.tools?.media?.audio;
+	const previous = previousProvider?.trim() || "xopc-local";
+	if (audio?.enabled === false || previous === "xopc-local" || audio?.provider !== "xopc-local") return null;
+	const configuredModel = audio.providers?.["xopc-local"]?.model;
+	return typeof configuredModel === "string" && configuredModel.trim() ? configuredModel.trim() : DEFAULT_LOCAL_VOICE_MODEL_ID;
+}
+/** Start a missing local STT model only after the provider changes to xopc-local. */
+function prepareLocalVoiceModelAfterProviderSwitch(previousProvider, config) {
+	const modelId = localVoiceModelForProviderSwitch(previousProvider, config);
+	if (!modelId || isLocalVoiceModelInstalled(modelId)) return;
+	try {
+		startLocalVoiceModelInstall(modelId);
+		log.info({
+			modelId,
+			phase: "provider_switch"
+		}, "Local voice model preparation started");
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		log.warn({
+			err,
+			modelId,
+			errorMessage,
+			phase: "provider_switch"
+		}, `Local voice model preparation failed: ${errorMessage}`);
+	}
+}
+//#endregion
+export { localVoiceModelForProviderSwitch, prepareLocalVoiceModelAfterProviderSwitch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.215",
+  "version": "0.0.217",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -163,10 +163,10 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
-    "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0"
+    "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/realtime-client": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",