@xopcai/xopc 0.0.214 → 0.0.217

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/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

package/dist/src/providers/auth-runtime/resolve-auth.js

@@ -1,5 +1,5 @@
-import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
 import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
+import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
 import { getDefaultAuthProfileStore } from "./auth-profile-store.js";
 //#region src/providers/auth-runtime/resolve-auth.ts
 init_env_keys();

package/dist/src/providers/index.js

@@ -1,11 +1,11 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { getOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { init_model_ref, splitProviderModelRef } from "./model-ref.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
-import { getOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
 import { CredentialResolver, hasCredentials, init_credentials } from "../auth/credentials.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { EXTENSION_PROVIDER_BASE_URL, init_constants } from "./constants.js";
 import { applyOfficialModelMetadataCorrections, getSupplementalModels, init_model_supplements } from "./model-supplements.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";

package/dist/src/providers/model-registry.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { resolveModelsJsonPath } from "../config/paths.js";
+import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";

package/dist/src/providers/register-runtime-providers.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
 import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
+import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/tui/tui-startup-resources.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
 import { loadSkills } from "../agent/skills/index.js";

package/dist/src/tui/tui.js

@@ -2,10 +2,10 @@ import { version } from "../../package.js";
 import { resolveStateDir, resolveXopcDatabasePath } from "../config/paths-state.js";
 import { parseAgentSessionKey } from "../routing/session-key-utils.js";
 import { init_agent_session_key, normalizeAgentId } from "../routing/agent-session-key.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
 import { getAllModels, getAllProviders, getApiKey, init_providers, isProviderConfiguredSync } from "../providers/index.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { renderWorkflowFinalSummary, renderWorkflowPanel } from "../agent/workflow/snapshot.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";

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/dist/src/workflows/service/workflow-run-service.js

@@ -1,6 +1,6 @@
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { init_providers, resolveModel } from "../../providers/index.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.214",
+  "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",
@@ -165,8 +165,8 @@
     "vue": "^3.5.35",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0"
+    "@xopcai/realtime-client": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",