@xopcai/xopc 0.0.355 → 0.0.357

package/dist/src/config/schema.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { ComputerConfigSchema, init_config } from "../computer/config.js";
 import { AgentModelsOverrideSchema, ImageGenerationRouteSchema, ModelRouteSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { ComputerConfigSchema, init_config } from "../computer/config.js";
 import { DEFAULT_CONTEXT_COMPACTION_POLICY, UserContextConfigSchema, init_config as init_config$1 } from "../user-context/config.js";
 import { init_public_url, validatePublicUrl } from "./public-url.js";
 import { PlatformConfigSchema, init_contracts } from "../platform/contracts.js";

package/dist/src/extensions/agent-plugins/validation.js

@@ -1,8 +1,8 @@
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { z } from "zod";
-import yaml from "js-yaml";
 import { validateHeaderName, validateHeaderValue } from "node:http";
+import yaml from "js-yaml";
 //#region src/extensions/agent-plugins/validation.ts
 const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
 const MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";

package/dist/src/extensions/lockfile.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { init_paths, resolveExtensionsDir, resolveExtensionsLockPath } from "../config/paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { dirname, join } from "path";
 import { existsSync, lstatSync, readFileSync, readdirSync, readlinkSync } from "fs";
 import { mkdir, readFile } from "fs/promises";

package/dist/src/gateway/agents-admin.js

@@ -1,10 +1,10 @@
 import { normalizeAgentId, validateAgentIdForNewAgent } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath } from "../agent/agent-scope.js";
-import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
+import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { resolve } from "node:path";
 import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,7 +1,7 @@
 import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
-import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserModelConfigSchema, init_config } from "../../../user-context/config.js";
+import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_models_json, loadModelsJson } from "../../../config/models-json.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";

package/dist/src/gateway/hono/routes/config-patch/misc.js

@@ -1,10 +1,10 @@
-import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
-import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { ComputerConfigSchema, init_config } from "../../../../computer/config.js";
+import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
 import { ContextPlanningConfigSchema, HomeIntelligenceConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config as init_config$1 } from "../../../../user-context/config.js";
 import { BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
 import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
+import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { mergeGatewaySkillsMarketplacePatch, mergeSessionConfigPatch, mergeUpdateConfigPatch } from "../../../../config/web-patch.js";
 import { assertGatewayAuthConfigured, resolveGatewayAuth } from "../../../auth.js";
 import { isMaskedSecretPatchValue } from "../../lib/mask-secret-length.js";

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

@@ -19,6 +19,7 @@ import { applyImageGenerationCatalogUpdate, getAgentImageGenerationConfig, getDe
 import { discoverProviderModels, isProviderApiDiscoverable } from "../../../providers/model-discovery.js";
 import { getXopcCloudCatalogCoordinator } from "../../../providers/xopc-cloud-catalog-coordinator.js";
 import { respondStartupUnavailable } from "../lib/startup-unavailable.js";
+import { dismissXopcCloudOnboarding, getXopcCloudOnboardingStatus } from "../../xopc-cloud-onboarding.js";
 import { getDomesticProviderPreset, getDomesticProviderPresetIds } from "../../../providers/domestic-presets.js";
 import { auditModelReferences } from "../../../providers/model-reference-auditor.js";
 import { getOnboardingFeaturedProviders, getProviderHint, getRecommendedModelsForProvider, isRecommendedModel, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
@@ -85,6 +86,23 @@ function registerModelsRoutes(authenticated, deps) {
 	const { service, strictRateLimitMiddleware } = deps;
 	const catalogSync = service.getModelCatalogSync();
 	const xopcCloudAccount = new XopcCloudAccountService();
+	authenticated.get("/api/models/cloud-onboarding", async (c) => {
+		const [status, auth] = await Promise.all([getXopcCloudOnboardingStatus(), getProviderAuthState("xopc-cloud")]);
+		return c.json({
+			ok: true,
+			payload: {
+				status,
+				hasGrant: auth.authMode === "oauth"
+			}
+		});
+	});
+	authenticated.put("/api/models/cloud-onboarding", strictRateLimitMiddleware, async (c) => {
+		await dismissXopcCloudOnboarding();
+		return c.json({
+			ok: true,
+			payload: { status: "dismissed" }
+		});
+	});
 	authenticated.get("/api/models/catalog/status", (c) => {
 		const readiness = getXopcCloudCatalogCoordinator().snapshot();
 		return c.json({

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

@@ -1,9 +1,9 @@
 import { NoteDeleteOutputSchema, NoteGetOutputSchema, ProductReadContracts } from "../../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
 import { getShareStore } from "../../../share/share-store.js";
 import { resolveShareUrl } from "../../../share/share-url.js";

package/dist/src/gateway/hono/routes/personal-agent.js

@@ -1,15 +1,40 @@
+import { getDevice, init_device_access_repository } from "../../../storage/sqlite/device-access-repository.js";
 import { TaskOriginRepository } from "../../../tasks/task-origin-repository.js";
 import { getPersonalAgent } from "../../../personal-agent/repository.js";
+import { PersonalOnboardingDraftSchema, PersonalOnboardingStepSchema, finishPersonalWelcome, getPersonalOnboarding, savePersonalOnboarding } from "../../../personal-agent/onboarding.js";
 import { PersonalAppearanceSchema, PersonalPreferencesSchema, createOrResumePersonalAgent, ensurePersonalConversationVisibility, listPersonalModels, patchPersonalProfile, refreshPersonalDelegationGuidance } from "../../../personal-agent/service.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
 import { z } from "zod";
 //#region src/gateway/hono/routes/personal-agent.ts
-const CreateSchema = z.object({ model: z.string().trim().min(3).optional() }).strict();
+init_device_access_repository();
+const CreateSchema = z.object({
+	model: z.string().trim().min(3).optional(),
+	displayName: z.string().trim().min(1).max(60).optional(),
+	appearance: z.enum([
+		"loopi",
+		"loopi-curious",
+		"loopi-care"
+	]).optional(),
+	voicePreference: z.object({
+		provider: z.string().trim().min(1).max(100),
+		model: z.string().trim().min(1).max(200),
+		voice: z.string().trim().min(1).max(200)
+	}).strict().optional()
+}).strict();
+const OnboardingSchema = z.object({
+	step: PersonalOnboardingStepSchema,
+	draft: PersonalOnboardingDraftSchema
+}).strict();
 const ProfileSchema = z.object({
 	revision: z.number().int().positive(),
 	displayName: z.string().trim().min(1).max(60),
 	appearance: PersonalAppearanceSchema,
-	preferences: PersonalPreferencesSchema
+	preferences: PersonalPreferencesSchema,
+	voicePreference: z.object({
+		provider: z.string().trim().min(1).max(100),
+		model: z.string().trim().min(1).max(200),
+		voice: z.string().trim().min(1).max(200)
+	}).strict().nullable().optional()
 }).strict();
 const ActivityQuerySchema = z.object({
 	limit: z.coerce.number().int().min(1).max(20).default(5),
@@ -17,7 +42,11 @@ const ActivityQuerySchema = z.object({
 });
 function registerPersonalAgentRoutes(authenticated, deps) {
 	const owner = (c) => {
-		return getGatewayPrincipal(c).kind === "owner" ? "local-owner" : null;
+		const principal = getGatewayPrincipal(c);
+		if (principal.kind === "owner") return "local-owner";
+		if (principal.kind !== "device" || !principal.deviceId) return null;
+		const platform = getDevice(principal.deviceId)?.platform;
+		return platform === "harmonyos" || platform === "ios" || platform === "android" ? "local-owner" : null;
 	};
 	authenticated.get("/api/personal-agent", async (c) => {
 		const ownerId = owner(c);
@@ -42,6 +71,54 @@ function registerPersonalAgentRoutes(authenticated, deps) {
 			payload: await listPersonalModels()
 		});
 	});
+	authenticated.get("/api/personal-agent/onboarding", (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		return c.json({
+			ok: true,
+			payload: getPersonalOnboarding(ownerId)
+		});
+	});
+	authenticated.put("/api/personal-agent/onboarding", deps.strictRateLimitMiddleware, async (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		if (getPersonalAgent(ownerId)?.state === "ready") return c.json({
+			ok: false,
+			error: "Onboarding is complete"
+		}, 409);
+		const parsed = OnboardingSchema.safeParse(await c.req.json().catch(() => null));
+		if (!parsed.success) return c.json({
+			ok: false,
+			error: "Invalid onboarding draft"
+		}, 400);
+		savePersonalOnboarding(ownerId, parsed.data.step, parsed.data.draft);
+		return c.json({
+			ok: true,
+			payload: getPersonalOnboarding(ownerId)
+		});
+	});
+	authenticated.post("/api/personal-agent/onboarding/welcome", deps.strictRateLimitMiddleware, (c) => {
+		const ownerId = owner(c);
+		if (!ownerId) return c.json({
+			ok: false,
+			error: "Owner access is required"
+		}, 403);
+		if (getPersonalAgent(ownerId)?.state !== "ready") return c.json({
+			ok: false,
+			error: "Personal Agent is unavailable"
+		}, 409);
+		finishPersonalWelcome(ownerId);
+		return c.json({
+			ok: true,
+			payload: getPersonalOnboarding(ownerId)
+		});
+	});
 	authenticated.get("/api/personal-agent/activity", (c) => {
 		const ownerId = owner(c);
 		if (!ownerId) return c.json({
@@ -84,7 +161,27 @@ function registerPersonalAgentRoutes(authenticated, deps) {
 			error: "Invalid create request"
 		}, 400);
 		try {
-			const record = await createOrResumePersonalAgent(deps.service, ownerId, parsed.data.model);
+			const selected = parsed.data.voicePreference;
+			if (selected) {
+				const { resolveStreamingTts } = await import("../../../voice/realtime/runtime.js");
+				const route = resolveStreamingTts(deps.service.currentConfig);
+				if (!route?.provider.plugin.listVoices || route.route.provider !== selected.provider || route.route.model !== selected.model) return c.json({
+					ok: false,
+					error: "Selected voice is unavailable"
+				}, 400);
+				if (!(await route.provider.plugin.listVoices({
+					cfg: deps.service.currentConfig,
+					providerConfig: route.provider.providerConfig
+				})).some((voice) => voice.id === selected.voice)) return c.json({
+					ok: false,
+					error: "Selected voice is unavailable"
+				}, 400);
+			}
+			const record = await createOrResumePersonalAgent(deps.service, ownerId, parsed.data.model, listPersonalModels, parsed.data.displayName && parsed.data.appearance ? {
+				displayName: parsed.data.displayName,
+				appearance: parsed.data.appearance,
+				...selected ? { voicePreference: selected } : {}
+			} : void 0);
 			return c.json({
 				ok: true,
 				payload: record
@@ -107,8 +204,23 @@ function registerPersonalAgentRoutes(authenticated, deps) {
 			ok: false,
 			error: "Invalid profile"
 		}, 400);
-		const { revision, displayName, appearance, preferences } = parsed.data;
-		const updated = await patchPersonalProfile(deps.service, ownerId, revision, displayName, preferences, appearance);
+		const { revision, displayName, appearance, preferences, voicePreference } = parsed.data;
+		if (voicePreference) {
+			const { resolveStreamingTts } = await import("../../../voice/realtime/runtime.js");
+			const route = resolveStreamingTts(deps.service.currentConfig);
+			if (!route?.provider.plugin.listVoices || route.route.provider !== voicePreference.provider || route.route.model !== voicePreference.model) return c.json({
+				ok: false,
+				error: "Selected voice is unavailable"
+			}, 400);
+			if (!(await route.provider.plugin.listVoices({
+				cfg: deps.service.currentConfig,
+				providerConfig: route.provider.providerConfig
+			})).some((voice) => voice.id === voicePreference.voice)) return c.json({
+				ok: false,
+				error: "Selected voice is unavailable"
+			}, 400);
+		}
+		const updated = await patchPersonalProfile(deps.service, ownerId, revision, displayName, preferences, appearance, voicePreference);
 		return updated ? c.json({
 			ok: true,
 			payload: updated

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

@@ -7,12 +7,12 @@ import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript
 import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { ActivityService } from "../../../activity/service.js";
 import "../../../activity/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
 import { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.js";
 import { listKnowledgeItems, writeKnowledgeItem } from "../../../knowledge-memory/repository.js";
 import "../../../knowledge-memory/index.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError } from "../../../projects/workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "../../../projects/project-kind.js";
 import { ProjectDeletionBlockedError, ProjectWorkspaceInUseError } from "../../../projects/project-service.js";

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -4,9 +4,9 @@ import { browserPageContextsInputSchema } from "../../../../packages/gateway-con
 import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { init_providers, resolveModel } from "../../../providers/index.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { isTaskDestructiveCommand } from "../../../session/reset-triggers.js";

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

@@ -6,9 +6,9 @@ import { hasGatewayScope, init_gateway_scopes } from "../../security/gateway-sco
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
+import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskCriterionReviewRepository } from "../../../tasks/task-criterion-review-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";
 import { TaskDeleteOutputSchema } from "../../../tasks/capabilities/management.js";

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

@@ -209,6 +209,31 @@ function registerVoiceRoutes(authenticated, deps) {
 			ok: false,
 			error: { message: "Realtime voice output is not configured" }
 		}, 503);
+		const body = await c.req.json().catch(() => ({}));
+		const selectedVoice = typeof body.voice === "string" ? body.voice.trim() : "";
+		if (selectedVoice) {
+			if (selectedVoice.length > 200 || !route.provider.plugin.listVoices) return c.json({
+				ok: false,
+				error: { message: "Voice is unavailable" }
+			}, 400);
+			if (!(await route.provider.plugin.listVoices({
+				cfg: config,
+				providerConfig: route.provider.providerConfig
+			})).some((voice) => voice.id === selectedVoice)) return c.json({
+				ok: false,
+				error: { message: "Voice is unavailable" }
+			}, 400);
+		}
+		const previewConfig = selectedVoice ? {
+			...route.config,
+			providers: {
+				...route.config.providers,
+				[route.route.provider]: {
+					...route.config.providers?.[route.route.provider],
+					voice: selectedVoice
+				}
+			}
+		} : route.config;
 		const controller = new AbortController();
 		const signal = AbortSignal.any([
 			c.req.raw.signal,
@@ -218,7 +243,7 @@ function registerVoiceRoutes(authenticated, deps) {
 		let result;
 		let reader;
 		try {
-			result = await speakStream(config.voice?.language === "en" ? "Hello, I am your assistant. You can talk to me naturally." : "你好，我是你的助手。现在可以和我自然对话了。", route.config, {
+			result = await speakStream(config.voice?.language === "en" ? "Hello, I am your assistant. You can talk to me naturally." : "你好，我是你的助手。现在可以和我自然对话了。", previewConfig, {
 				signal,
 				appConfig: config,
 				allowFallback: false,

package/dist/src/gateway/image-generation-setup.js

@@ -1,11 +1,11 @@
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { init_agent_scope } from "../agent/agent-scope.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
+import { init_agent_scope } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentConfigForAgent } from "../config/agent-profile.js";
 import { fetchWithTimeoutGuarded } from "../media-shared/http/provider-http.js";
 import "../media-shared/http/index.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getImageGenerationProvider, listImageGenerationProvidersSummary } from "../agent/image/generation/provider-registry.js";
 //#region src/gateway/image-generation-setup.ts
 init_repository();

package/dist/src/gateway/lock.js

@@ -1,8 +1,8 @@
 import path from "node:path";
 import fs from "node:fs";
 import { createHash } from "node:crypto";
-import fs$1 from "node:fs/promises";
 import net from "node:net";
+import fs$1 from "node:fs/promises";
 import { homedir } from "os";
 //#region src/gateway/lock.ts
 /**

package/dist/src/gateway/security/gateway-scopes.js

@@ -18,6 +18,8 @@ function requiredGatewayScope(method, path) {
 	if (path === "/api/device-auth/refresh" || path === "/api/devices/me") return "device.self";
 	if (path.startsWith("/api/devices/me/push")) return "notifications.self";
 	if (path.startsWith("/api/endpoint-tools")) return "device.self";
+	if (path === "/api/personal-agent/activity") return "tasks.read";
+	if (path === "/api/personal-agent" || path.startsWith("/api/personal-agent/")) return methodScope(method, "sessions.read", "sessions.write");
 	if (path.startsWith("/api/browser/tab-bindings") || path.startsWith("/api/browser/approvals")) return methodScope(method, "sessions.read", "sessions.write");
 	if (method === "GET" && path === "/api/connectors/approvals") return "sessions.read";
 	if (method === "POST" && path === "/api/connectors/approvals/respond") return "sessions.write";

package/dist/src/gateway/service.js

@@ -17,9 +17,9 @@ import { init_session_repository, listSessionMetadata, patchSessionMetadata } fr
 import { getSessionConfig, init_config_repository } from "../storage/sqlite/config-repository.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
 import { normalizeAgentId } from "../agent-catalog/id.js";
-import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_agent_session_key, resolveAgentMainConversationId } from "../routing/agent-session-key.js";
 import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";

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

@@ -31,7 +31,8 @@ export type PrepareXopcCloudCapabilitySetupResult = {
 };
 export type ApplyXopcCloudCapabilitySetupResult = {
     configured: true;
-    selection: XopcCloudCapabilitySelection;
+    selection: Partial<XopcCloudCapabilitySelection>;
+    missing: CloudCapability[];
 } | {
     configured: false;
     error: string;

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

@@ -1,11 +1,13 @@
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
+import { getAvailableModels, init_providers } from "../providers/index.js";
 import { compareCatalogModels } from "../providers/model-catalog-ranking.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
 init_repository();
 init_model_catalog_store();
+init_providers();
 function supportsCapability(model, capability) {
 	if (model.availability !== "available") return false;
 	if (capability === "chat") return model.kind === "language" && (model.operations.includes("chat.completions") || model.operations.includes("responses"));
@@ -24,7 +26,7 @@ function recommendedVoiceModel(source, mode) {
 }
 function selectedVoice(model) {
 	const voices = model.voice?.voices ?? [];
-	return voices.find((voice) => voice.id === model.voice?.defaultVoice)?.id ?? voices[0].id;
+	return voices.find((voice) => voice.id === "Cherry")?.id ?? voices.find((voice) => voice.id === model.voice?.defaultVoice)?.id ?? voices[0].id;
 }
 function selectXopcCloudCapabilities(source) {
 	const chat = recommendedModel(source, "chat");
@@ -177,21 +179,115 @@ async function applyXopcCloudCapabilitySetup(service) {
 		configured: false,
 		error: "XOPC Cloud model catalog is unavailable"
 	};
-	const prepared = prepareXopcCloudCapabilitySetup(service.currentConfig, source);
-	if (prepared.ok === false) return {
+	const selection = selectXopcCloudCapabilities(source);
+	const currentDefaults = new AgentCatalogRepository().getSettings().defaults;
+	const availableModels = new Set((await getAvailableModels()).map((model) => `${model.provider}/${model.id}`));
+	const nextDefaults = structuredClone(currentDefaults);
+	const nextConfig = structuredClone(service.currentConfig);
+	const chat = recommendedModel(source, "chat");
+	const vision = recommendedModel(source, "vision");
+	const imageGeneration = recommendedModel(source, "image-generation");
+	const stt = recommendedModel(source, "stt");
+	const tts = recommendedModel(source, "tts");
+	const realtimeStt = recommendedVoiceModel(source, "transcription.stream");
+	const realtimeTts = recommendedVoiceModel(source, "speech.stream");
+	const realtimeOmni = recommendedVoiceModel(source, "conversation");
+	if (chat && !availableModels.has(currentDefaults.models.chat.primary)) nextDefaults.models.chat = {
+		primary: `xopc-cloud/${chat.id}`,
+		fallbacks: []
+	};
+	if (vision && !currentDefaults.models.imageUnderstanding) nextDefaults.models.imageUnderstanding = {
+		primary: `xopc-cloud/${vision.id}`,
+		fallbacks: []
+	};
+	if (imageGeneration && !currentDefaults.models.imageGeneration) nextDefaults.models.imageGeneration = {
+		primary: `xopc-cloud/${imageGeneration.id}`,
+		fallbacks: [],
+		autoProviderFallback: false
+	};
+	if (stt && !nextConfig.tools?.media?.audio) {
+		nextConfig.tools ??= {};
+		nextConfig.tools.media ??= {};
+		nextConfig.tools.media.audio = {
+			enabled: true,
+			provider: "xopc-cloud",
+			fallback: {
+				enabled: false,
+				order: ["xopc-cloud"]
+			},
+			providers: { "xopc-cloud": { model: stt.id } }
+		};
+	}
+	if (tts && tts.tts?.defaultVoice && !nextConfig.messages?.tts) {
+		nextConfig.messages ??= {};
+		nextConfig.messages.tts = {
+			enabled: true,
+			provider: "xopc-cloud",
+			trigger: "off",
+			maxTextLength: 512,
+			timeoutMs: 6e4,
+			providers: { "xopc-cloud": {
+				model: tts.id,
+				voice: tts.tts.defaultVoice
+			} }
+		};
+	}
+	const realtime = nextConfig.voice?.realtime;
+	if (realtime?.enabled) {
+		if (realtimeStt && !realtime.stt) realtime.stt = {
+			provider: "xopc-cloud",
+			model: realtimeStt.id
+		};
+		if (realtimeTts && !realtime.tts) realtime.tts = {
+			provider: "xopc-cloud",
+			model: realtimeTts.id,
+			voice: selectedVoice(realtimeTts)
+		};
+		if (realtimeOmni && !realtime.omni) realtime.omni = {
+			provider: "xopc-cloud",
+			model: realtimeOmni.id,
+			voice: selectedVoice(realtimeOmni),
+			instructions: "Keep replies conversational and concise. You cannot execute tools."
+		};
+	}
+	if (!chat && !vision && !imageGeneration && !stt && !tts && !realtimeStt && !realtimeTts && !realtimeOmni) return {
 		configured: false,
-		error: prepared.error,
-		missing: prepared.missing
+		error: "XOPC Cloud published no usable models",
+		missing: selection.missing
 	};
-	const saved = await service.saveConfig(prepared.config);
+	const defaultsUpdate = prepareUpdateGlobalDefaults({ defaults: nextDefaults });
+	if (defaultsUpdate.ok === false) return {
+		configured: false,
+		error: defaultsUpdate.error
+	};
+	const saved = await service.saveConfig(nextConfig);
 	if (!saved.saved) return {
 		configured: false,
 		error: saved.error ?? "Failed to save XOPC Cloud capability configuration"
 	};
-	new AgentCatalogService().updateDefaults(prepared.defaults);
+	new AgentCatalogService().updateDefaults(defaultsUpdate.data.defaults);
 	return {
 		configured: true,
-		selection: prepared.selection
+		missing: selection.missing,
+		selection: {
+			...chat ? { chat: chat.id } : {},
+			...vision ? { vision: vision.id } : {},
+			...imageGeneration ? { imageGeneration: imageGeneration.id } : {},
+			...stt ? { stt: stt.id } : {},
+			...tts ? {
+				tts: tts.id,
+				ttsVoice: tts.tts?.defaultVoice
+			} : {},
+			...realtimeStt ? { realtimeStt: realtimeStt.id } : {},
+			...realtimeTts ? { realtimeTts: {
+				model: realtimeTts.id,
+				voice: selectedVoice(realtimeTts)
+			} } : {},
+			...realtimeOmni ? { realtimeOmni: {
+				model: realtimeOmni.id,
+				voice: selectedVoice(realtimeOmni)
+			} } : {}
+		}
 	};
 }
 //#endregion

package/dist/src/gateway/xopc-cloud-onboarding.d.ts

@@ -0,0 +1,3 @@
+export type XopcCloudOnboardingStatus = 'unseen' | 'dismissed';
+export declare function getXopcCloudOnboardingStatus(): Promise<XopcCloudOnboardingStatus>;
+export declare function dismissXopcCloudOnboarding(): Promise<void>;

package/dist/src/gateway/xopc-cloud-onboarding.js

@@ -0,0 +1,27 @@
+import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+//#region src/gateway/xopc-cloud-onboarding.ts
+init_paths_state();
+init_write_file_atomic();
+function statePath() {
+	return join(resolveStateDir(), "xopc-cloud-onboarding.json");
+}
+async function getXopcCloudOnboardingStatus() {
+	try {
+		const parsed = JSON.parse(await readFile(statePath(), "utf8"));
+		return parsed && typeof parsed === "object" && "status" in parsed && parsed.status === "dismissed" ? "dismissed" : "unseen";
+	} catch (error) {
+		if (error.code === "ENOENT") return "unseen";
+		throw error;
+	}
+}
+async function dismissXopcCloudOnboarding() {
+	await writeTextAtomic(statePath(), JSON.stringify({
+		version: 1,
+		status: "dismissed"
+	}));
+}
+//#endregion
+export { dismissXopcCloudOnboarding, getXopcCloudOnboardingStatus };

package/dist/src/local-apps/service.js

@@ -5,10 +5,10 @@ import { currentOperationId, init_operation_context } from "../infra/operation-c
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { LocalAppStore } from "./store.js";
 import { slugifyProjectName } from "../projects/project-store.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";