@xopcai/xopc 0.0.354 → 0.0.356

package/dist/src/gateway/service/session-command-service.js

@@ -1,11 +1,11 @@
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../../storage/sqlite/session-repository.js";
-import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
-import { getModelThinking } from "../../providers/model-thinking.js";
 import { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
+import { getModelThinking } from "../../providers/model-thinking.js";
 import { withModelConfigLock } from "../../session/model-config-lock.js";
 import { SessionCommandError, acceptSessionCommand, getSessionPreparation, matchSessionInputReceipt, sessionCommandHash } from "../../storage/sqlite/session-creation-repository.js";
 //#region src/gateway/service/session-command-service.ts

package/dist/src/gateway/service/sessions-api.js

@@ -3,8 +3,8 @@ import { retireSessionMcpRuntimeForConversationId } from "../../agent/mcp/bundle
 import { buildSessionTimeline } from "../../session/transcript-outline.js";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
-import "../../agent/mcp/bundle-mcp-tools.js";
 import { collectMediaUrisFromValues, deleteMediaUris } from "../../media/session-references.js";
+import "../../agent/mcp/bundle-mcp-tools.js";
 import { withModelConfigLock } from "../../session/model-config-lock.js";
 import { publicExecutionDetail } from "../../session/execution-detail.js";
 import { getDistinctSessionChatIds } from "./session-chat-ids.js";

package/dist/src/gateway/service.js

@@ -17,81 +17,60 @@ 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_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import { prewarmModelRegistry } from "../providers/model-registry.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";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
-import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { AI_USAGE_RETENTION_MS, markStaleAiUsageEventsUnknown, pruneAiUsageEvents } from "../storage/sqlite/ai-usage-repository.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
-import { listKnowledgeItems } from "../knowledge-memory/repository.js";
-import "../knowledge-memory/index.js";
-import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
-import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
-import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
-import { ProjectService } from "../projects/project-service.js";
-import { resolveProjectAgentId } from "../projects/project-agent.js";
-import "../projects/index.js";
-import { resolveEffectiveGatewayPort } from "./host.js";
-import { runMemoryMaintenance } from "../memory-maintenance/service.js";
-import "../memory-maintenance/index.js";
-import { RealtimeExtensionBrowserProvider } from "../browser/providers/realtime-extension.js";
-import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
-import { buildNoteAgentContext } from "../notes/agent-context.js";
-import { NotesStore } from "../notes/store.js";
-import { NotesService } from "../notes/service.js";
-import { LocalAppService } from "../local-apps/service.js";
-import { TaskApplicationService } from "../tasks/task-application-service.js";
 import { AutomationService } from "../automations/service/automation-service.js";
-import { TaskSignalService } from "../tasks/task-signal-service.js";
-import { createProductDispatcher } from "../capabilities/runtime/product.js";
 import "../automations/index.js";
-import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
-import "../tasks/index.js";
-import "../agent/mcp/bundle-mcp-tools.js";
+import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
+import { RealtimeExtensionBrowserProvider } from "../browser/providers/realtime-extension.js";
 import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
-import { SessionIndex } from "../session/manager.js";
-import "../session/index.js";
-import { ExtensionLoader } from "../extensions/loader.js";
 import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
-import "../extensions/index.js";
 import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot } from "../channels/catalog/channel-catalog-service.js";
 import { loadConfig, saveConfig } from "../config/loader.js";
-import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
-import "../infra/bus/index.js";
-import { collectMediaUrisFromMessages, deleteMediaUris } from "../media/session-references.js";
-import { AgentService } from "../agent/service.js";
-import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
 import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
-import { getWorkspacePath } from "../config/workspace-path-helpers.js";
-import "../config/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { ChatPreviewService } from "../chat-previews/service.js";
 import "../chat-previews/index.js";
-import { DiscussionService } from "../discussions/service.js";
-import { DiscussionOrganizer } from "../discussions/organizer.js";
-import { DiscussionLiveWorker } from "../discussions/live-worker.js";
-import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
-import { DiscussionSealer } from "../discussions/sealer.js";
-import "../discussions/index.js";
+import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
+import "../infra/bus/index.js";
+import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import "../config/index.js";
+import { ExtensionLoader } from "../extensions/loader.js";
+import "../extensions/index.js";
+import { resolveEffectiveGatewayPort } from "./host.js";
+import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
+import { listKnowledgeItems } from "../knowledge-memory/repository.js";
+import "../knowledge-memory/index.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
 import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
+import { TaskApplicationService } from "../tasks/task-application-service.js";
+import { DiscussionService } from "../discussions/service.js";
+import { DiscussionOrganizer } from "../discussions/organizer.js";
+import { DiscussionLiveWorker } from "../discussions/live-worker.js";
+import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
+import { DiscussionSealer } from "../discussions/sealer.js";
+import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
-import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
-import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
+import { ProjectService } from "../projects/project-service.js";
+import { resolveProjectAgentId } from "../projects/project-agent.js";
+import "../projects/index.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
@@ -108,6 +87,23 @@ import { WorkDiscoveryService } from "../work-discovery/service.js";
 import { buildVoiceMemoryContext } from "../voice/realtime/memory-context.js";
 import { buildVoicePersonaContext } from "../voice/realtime/persona-context.js";
 import { voiceMemoryBudget, voicePersonaBudget } from "../voice/realtime/conversation-context.js";
+import { SessionIndex } from "../session/manager.js";
+import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import "../session/index.js";
+import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
+import { collectMediaUrisFromMessages, deleteMediaUris } from "../media/session-references.js";
+import { runMemoryMaintenance } from "../memory-maintenance/service.js";
+import "../memory-maintenance/index.js";
+import { buildNoteAgentContext } from "../notes/agent-context.js";
+import { NotesStore } from "../notes/store.js";
+import { NotesService } from "../notes/service.js";
+import { LocalAppService } from "../local-apps/service.js";
+import { TaskSignalService } from "../tasks/task-signal-service.js";
+import { createProductDispatcher } from "../capabilities/runtime/product.js";
+import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
+import "../tasks/index.js";
+import "../agent/mcp/bundle-mcp-tools.js";
+import { AgentService } from "../agent/service.js";
 import "../notes/index.js";
 import { buildWorkflowChildTools } from "../agent/workflow/workflow-child-tools.js";
 import { WorkflowRunService } from "../workflows/service/workflow-run-service.js";
@@ -153,6 +149,10 @@ import { TaskMainUpdateDecisionService } from "../tasks/task-main-update-decisio
 import { selectTaskMainUpdateAttempt, submitAndConfirmTaskMainUpdate } from "../tasks/task-main-update-input.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
+import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
+import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import crypto from "node:crypto";
 //#region src/gateway/service.ts
 init_session_repository();

package/dist/src/gateway/session-context-summary.js

@@ -6,14 +6,14 @@ import { TaskRepository, init_task_repository } from "../tasks/task-repository.j
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { getCurrentTranscriptId, init_session_repository } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig, init_config_repository } from "../storage/sqlite/config-repository.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { ProjectStore } from "../projects/project-store.js";
 import { runExec } from "../infra/exec.js";
 import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
-import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { isSessionSourceBinding } from "../agent/source-context/types.js";
+import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
 import { realpath, stat } from "node:fs/promises";
 //#region src/gateway/session-context-summary.ts
 init_config_repository();

package/dist/src/gateway/session-reset-service.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { retireSessionMcpRuntimeForConversationId } from "../agent/mcp/bundle-mcp-runtime.js";
-import { abortEmbeddedRun } from "../agent/embedded/runs.js";
 import { isPersonalConversation } from "../personal-agent/repository.js";
+import { abortEmbeddedRun } from "../agent/embedded/runs.js";
 import "../agent/mcp/bundle-mcp-tools.js";
 //#region src/gateway/session-reset-service.ts
 init_logger();

package/dist/src/gateway/workspace-editor-path.js

@@ -1,5 +1,5 @@
 import path, { relative, resolve } from "node:path";
-import fs from "node:fs";
+import fsSync from "node:fs";
 //#region src/gateway/workspace-editor-path.ts
 /** Resolve a workspace-relative POSIX path safely (no `..`, stays under root). */
 function resolveWorkspaceSafePath(workspaceRoot, rel) {
@@ -20,7 +20,7 @@ function isPathUnderWorkspace(workspaceRoot, absPath) {
 function normalizeComparablePath(input) {
 	let resolved = resolve(input);
 	try {
-		resolved = fs.realpathSync.native(resolved);
+		resolved = fsSync.realpathSync.native(resolved);
 	} catch {}
 	return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }

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

@@ -9,6 +9,15 @@ export interface XopcCloudCapabilitySelection {
     stt: string;
     tts: string;
     ttsVoice: string;
+    realtimeStt?: string;
+    realtimeTts?: {
+        model: string;
+        voice: string;
+    };
+    realtimeOmni?: {
+        model: string;
+        voice: string;
+    };
 }
 export type PrepareXopcCloudCapabilitySetupResult = {
     ok: true;
@@ -22,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"));
@@ -18,12 +20,23 @@ function recommendedModel(source, capability) {
 	const recommendation = capability === "chat" ? source.recommendedModel ?? void 0 : source.recommended?.[capability];
 	return source.models.filter((model) => supportsCapability(model, capability)).sort((left, right) => compareCatalogModels(left, right, recommendation))[0];
 }
+function recommendedVoiceModel(source, mode) {
+	const recommendation = mode === "transcription.stream" ? source.recommended?.stt : mode === "speech.stream" ? source.recommended?.tts : void 0;
+	return source.models.filter((model) => model.availability === "available" && model.voice?.modes.includes(mode) && (mode === "transcription.stream" || Boolean(model.voice.voices.length))).sort((left, right) => compareCatalogModels(left, right, recommendation))[0];
+}
+function selectedVoice(model) {
+	const voices = model.voice?.voices ?? [];
+	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");
 	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");
 	const missing = [];
 	if (!chat) missing.push("chat");
 	if (!vision) missing.push("vision");
@@ -39,7 +52,16 @@ function selectXopcCloudCapabilities(source) {
 			imageGeneration: imageGeneration.id,
 			stt: stt.id,
 			tts: tts.id,
-			ttsVoice: tts.tts.defaultVoice
+			ttsVoice: tts.tts.defaultVoice,
+			...realtimeStt ? { realtimeStt: realtimeStt.id } : {},
+			...realtimeTts ? { realtimeTts: {
+				model: realtimeTts.id,
+				voice: selectedVoice(realtimeTts)
+			} } : {},
+			...realtimeOmni ? { realtimeOmni: {
+				model: realtimeOmni.id,
+				voice: selectedVoice(realtimeOmni)
+			} } : {}
 		}
 	};
 }
@@ -127,7 +149,27 @@ function prepareXopcCloudCapabilitySetup(config, source) {
 						}
 					}
 				}
-			}
+			},
+			...selection.realtimeStt || selection.realtimeTts || selection.realtimeOmni ? { voice: {
+				...config.voice,
+				realtime: {
+					...config.voice?.realtime,
+					enabled: true,
+					...selection.realtimeStt ? { stt: {
+						provider: "xopc-cloud",
+						model: selection.realtimeStt
+					} } : {},
+					...selection.realtimeTts ? { tts: {
+						provider: "xopc-cloud",
+						...selection.realtimeTts
+					} } : {},
+					...selection.realtimeOmni ? { omni: {
+						provider: "xopc-cloud",
+						...selection.realtimeOmni,
+						instructions: config.voice?.realtime?.omni?.instructions ?? "Keep replies conversational and concise. You cannot execute tools."
+					} } : {}
+				}
+			} } : {}
 		}
 	};
 }
@@ -137,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: "XOPC Cloud published no usable models",
+		missing: selection.missing
+	};
+	const defaultsUpdate = prepareUpdateGlobalDefaults({ defaults: nextDefaults });
+	if (defaultsUpdate.ok === false) return {
 		configured: false,
-		error: prepared.error,
-		missing: prepared.missing
+		error: defaultsUpdate.error
 	};
-	const saved = await service.saveConfig(prepared.config);
+	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/home-intelligence/generator.js

@@ -1,7 +1,7 @@
 import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { extractAssistantText, getAssistantMessageErrorReason } from "../providers/model-response.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { completeWithResolvedCredentials, isLocalModelBaseUrl } from "../providers/model-call.js";
-import { extractAssistantText, getAssistantMessageErrorReason } from "../providers/model-response.js";
 import { resolveModelSelector } from "../config/agent-model-intents.js";
 import { z } from "zod";
 //#region src/home-intelligence/generator.ts

package/dist/src/home-intelligence/host.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { HomeAdviceBudgetExceededError } from "./generator.js";
 import { homePatternKey } from "./strategy.js";
+import { HomeAdvicePolicy } from "./policy.js";
 import { HomeIntelligenceRepository } from "./repository.js";
 import { HomeOpportunityApplicationService } from "./application-service.js";
-import { HomeAdvicePolicy } from "./policy.js";
-import { HomeAdviceBudgetExceededError } from "./generator.js";
 import { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts

package/dist/src/infra/gateway-processes.js

@@ -1,11 +1,11 @@
 import { listPortListeners } from "../gateway/ports.js";
 import { isGatewayArgv, parseProcCmdline } from "./gateway-process-argv.js";
-import fs from "node:fs";
+import fsSync from "node:fs";
 import { spawnSync } from "node:child_process";
 //#region src/infra/gateway-processes.ts
 function readGatewayProcessArgsSync(pid) {
 	if (process.platform === "linux") try {
-		return parseProcCmdline(fs.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
+		return parseProcCmdline(fsSync.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
 	} catch {
 		return null;
 	}

package/dist/src/infra/path-env.js

@@ -1,7 +1,7 @@
 import { resolveBrewPathDirs } from "./brew.js";
 import os from "node:os";
 import path from "node:path";
-import fs from "node:fs";
+import fsSync from "node:fs";
 //#region src/infra/path-env.ts
 function isTruthyEnvValue(value) {
 	if (!value) return false;
@@ -10,7 +10,7 @@ function isTruthyEnvValue(value) {
 }
 function isExecutable(filePath) {
 	try {
-		fs.accessSync(filePath, fs.constants.X_OK);
+		fsSync.accessSync(filePath, fsSync.constants.X_OK);
 		return true;
 	} catch {
 		return false;
@@ -18,7 +18,7 @@ function isExecutable(filePath) {
 }
 function isDirectory(dirPath) {
 	try {
-		return fs.statSync(dirPath).isDirectory();
+		return fsSync.statSync(dirPath).isDirectory();
 	} catch {
 		return false;
 	}

package/dist/src/infra/update-global.js

@@ -1,10 +1,10 @@
-import { applyPathPrepend } from "./path-prepend.js";
 import { resolveExecPathBinPrepend } from "./path-env.js";
+import { applyPathPrepend } from "./path-prepend.js";
 import { readPackageVersion } from "./package-json.js";
 import { createDefaultCommandRunner } from "./run-command.js";
 import path from "node:path";
-import fs from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsSync from "node:fs";
+import fs from "node:fs/promises";
 //#region src/infra/update-global.ts
 const XOPC_PACKAGE_NAME = "@xopcai/xopc";
 const GLOBAL_RENAME_PREFIX = ".";
@@ -18,7 +18,7 @@ const NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS = ["--omit=optional", ...NPM_GLOBAL
 const GLOBAL_DETECT_TIMEOUT_MS = 15e3;
 async function pathExists(targetPath) {
 	try {
-		await fs$1.access(targetPath);
+		await fs.access(targetPath);
 		return true;
 	} catch {
 		return false;
@@ -26,7 +26,7 @@ async function pathExists(targetPath) {
 }
 async function tryRealpath(targetPath) {
 	try {
-		return await fs$1.realpath(targetPath);
+		return await fs.realpath(targetPath);
 	} catch {
 		return path.resolve(targetPath);
 	}
@@ -49,14 +49,14 @@ function resolvePreferredNpmCommand(pkgRoot) {
 	const prefix = inferNpmPrefixFromPackageRoot(pkgRoot);
 	if (!prefix) return null;
 	const candidate = process.platform === "win32" ? path.join(prefix, "npm.cmd") : path.join(prefix, "bin", "npm");
-	return fs.existsSync(candidate) ? candidate : null;
+	return fsSync.existsSync(candidate) ? candidate : null;
 }
 function resolveNpmFromExecPath() {
 	const execPath = process.execPath?.trim();
 	if (!execPath) return null;
 	const binDir = path.dirname(execPath);
 	const candidate = process.platform === "win32" ? path.join(binDir, "npm.cmd") : path.join(binDir, "npm");
-	return fs.existsSync(candidate) ? candidate : null;
+	return fsSync.existsSync(candidate) ? candidate : null;
 }
 function resolvePreferredGlobalManagerCommand(manager, pkgRoot) {
 	if (manager !== "npm") return manager;
@@ -204,7 +204,7 @@ async function cleanupGlobalRenameDirs(params) {
 	const prefix = `${GLOBAL_RENAME_PREFIX}${name}-`;
 	let entries = [];
 	try {
-		entries = await fs$1.readdir(root);
+		entries = await fs.readdir(root);
 	} catch {
 		return { removed };
 	}
@@ -212,8 +212,8 @@ async function cleanupGlobalRenameDirs(params) {
 		if (!entry.startsWith(prefix)) continue;
 		const target = path.join(root, entry);
 		try {
-			if (!(await fs$1.lstat(target)).isDirectory()) continue;
-			await fs$1.rm(target, {
+			if (!(await fs.lstat(target)).isDirectory()) continue;
+			await fs.rm(target, {
 				recursive: true,
 				force: true
 			});

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

@@ -5,11 +5,11 @@ 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 { LocalAppStore } from "./store.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";
 import { readLocalAppAcceptanceConfig } from "./acceptance.js";

package/dist/src/mcp/gateway-http-client.js

@@ -2,8 +2,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { CapabilityErrorCodeSchema } from "../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { resolveGatewayLocalClientHost } from "../config/gateway-bind.js";
 import { loadConfig } from "../config/loader.js";
+import { resolveGatewayLocalClientHost } from "../config/gateway-bind.js";
 import { createGatewayCredential, gatewayCredentialAuthorization } from "../gateway/credential.js";
 import { fetch } from "undici";
 //#region src/mcp/gateway-http-client.ts