@xopcai/xopc 0.0.215 → 0.0.218

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 { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
+import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.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 { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../config/paths.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 { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
+import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.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 { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.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/user-context/sources/catalog.js

@@ -18,7 +18,7 @@ const COMMON = [
 		category: "recent_documents",
 		platform: "all",
 		displayName: "Recent files",
-		description: "Read-only metadata for recent documents on Desktop, Documents, and Downloads.",
+		description: "Bounded text from recent readable documents on Desktop, Documents, and Downloads.",
 		availability: "available",
 		permission: "not_requested",
 		defaultAccessMode: "once",
@@ -114,6 +114,13 @@ const PLATFORM = {
 			"Recent unlocked notes selected through macOS Automation",
 			true
 		],
+		[
+			"apple-mail",
+			"mail",
+			"Apple Mail",
+			"Recent inbox and sent-message content selected through macOS Automation",
+			true
+		],
 		[
 			"apple-calendar",
 			"calendar",
@@ -138,7 +145,7 @@ const PLATFORM = {
 		permission: "not_requested",
 		defaultAccessMode: "once",
 		supportedAccessModes: ["once"],
-		recommended: category !== "notes",
+		recommended: category !== "notes" && category !== "mail",
 		sensitive: Boolean(sensitive)
 	})),
 	win32: [{

package/dist/src/user-context/sources/local-source-contract.d.ts

@@ -1,3 +1,3 @@
-export declare const LOCAL_UNDERSTANDING_SOURCE_IDS: readonly ["local-recent-files", "chromium-bookmarks", "apple-notes", "apple-calendar", "apple-reminders", "windows-recent-documents", "linux-recent-documents"];
+export declare const LOCAL_UNDERSTANDING_SOURCE_IDS: readonly ["local-recent-files", "chromium-bookmarks", "apple-notes", "apple-mail", "apple-calendar", "apple-reminders", "windows-recent-documents", "linux-recent-documents"];
 export type LocalUnderstandingSourceId = typeof LOCAL_UNDERSTANDING_SOURCE_IDS[number];
 export declare function isLocalUnderstandingSourceId(value: string): value is LocalUnderstandingSourceId;

package/dist/src/user-context/sources/local-source-contract.js

@@ -3,6 +3,7 @@ const LOCAL_UNDERSTANDING_SOURCE_IDS = [
 	"local-recent-files",
 	"chromium-bookmarks",
 	"apple-notes",
+	"apple-mail",
 	"apple-calendar",
 	"apple-reminders",
 	"windows-recent-documents",

package/dist/src/user-context/understanding-writing.d.ts

@@ -0,0 +1 @@
+export declare const USER_FACING_UNDERSTANDING_WRITING_GUIDANCE = "Write each understanding as concise, neutral profile copy that can be shown directly to the person described, not as an internal note about \"the user\". Prefer a subject-omitted predicate or noun phrase. For example, write \u201C\u503E\u5411\u4F7F\u7528 pnpm \u4F5C\u4E3A\u5305\u7BA1\u7406\u5668\u201D or \u201Cxopc \u9879\u76EE\u7684\u6838\u5FC3\u5F00\u53D1\u8005\u201D, not \u201C\u7528\u6237\u503E\u5411\u4E8E\u4F7F\u7528 pnpm\u201D or \u201C\u7528\u6237\u662F xopc \u9879\u76EE\u7684\u5F00\u53D1\u8005\u201D; write \u201CPrefers pnpm as the package manager\u201D or \u201CCore maintainer of xopc\u201D, not \u201CThe user prefers pnpm\u201D or \u201CThe user is a maintainer of xopc\u201D. Do not begin with generic subject labels or pronouns such as \u201C\u7528\u6237\u201D, \u201C\u8BE5\u7528\u6237\u201D, \u201C\u6B64\u7528\u6237\u201D, \u201C\u4F60\u201D, \u201C\u6211\u201D, \u201Cthe user\u201D, \u201Cuser\u201D, \u201Cyou\u201D, or \u201CI\u201D.";

package/dist/src/user-context/understanding-writing.js

@@ -0,0 +1,4 @@
+//#region src/user-context/understanding-writing.ts
+const USER_FACING_UNDERSTANDING_WRITING_GUIDANCE = `Write each understanding as concise, neutral profile copy that can be shown directly to the person described, not as an internal note about "the user". Prefer a subject-omitted predicate or noun phrase. For example, write “倾向使用 pnpm 作为包管理器” or “xopc 项目的核心开发者”, not “用户倾向于使用 pnpm” or “用户是 xopc 项目的开发者”; write “Prefers pnpm as the package manager” or “Core maintainer of xopc”, not “The user prefers pnpm” or “The user is a maintainer of xopc”. Do not begin with generic subject labels or pronouns such as “用户”, “该用户”, “此用户”, “你”, “我”, “the user”, “user”, “you”, or “I”.`;
+//#endregion
+export { USER_FACING_UNDERSTANDING_WRITING_GUIDANCE };

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/work-discovery/analyzer.d.ts

@@ -10,6 +10,11 @@ export declare function analyzeWorkContext(input: {
     modelRef: string;
     result: WorkDiscoveryResult;
 }>;
+export type UnderstandingSourceAnalysisStatus = {
+    sourceId: string;
+    status: 'completed' | 'partial' | 'failed';
+    error?: string;
+};
 export declare function analyzeUnderstandingSources(input: {
     config: Config;
     items: UnderstandingSourceItem[];
@@ -19,5 +24,6 @@ export declare function analyzeUnderstandingSources(input: {
     modelRef: string;
     profileCandidates: WorkDiscoveryProfileCandidate[];
     workThreadCandidates: WorkUnderstandingThreadCandidate[];
+    sourceStatuses: UnderstandingSourceAnalysisStatus[];
 }>;
 export declare function workDiscoveryResultMarkdown(result: WorkDiscoveryResult): string;