@xopcai/xopc 0.0.388 → 0.0.390

package/dist/src/gateway/service/config-coordinator.js

@@ -3,13 +3,14 @@ import { init_logger } from "../../utils/logger.js";
 import { getModelRegistry } from "../../providers/model-registry.js";
 import { init_providers } from "../../providers/index.js";
 import { configureTracing } from "../../observability/runtime.js";
+import { evictAllEmbeddedSessionRunners } from "../../agent/embedded/session-runner.js";
+import { reloadImageGenerationProviders } from "../../agent/image/generation/provider-registry.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { ConfigHotReloader } from "../../config/reload.js";
 import "../../config/index.js";
 import { computeExtensionActivationPatch } from "../../extensions/bundled-extension-activation.js";
-import { reloadImageGenerationProviders } from "../../agent/image/generation/provider-registry.js";
-import { evictAllEmbeddedSessionRunners } from "../../agent/embedded/session-runner.js";
 import { sanitizeTunnelConfig } from "../../tunnel/tunnel-config.js";
+import { isDeepStrictEqual } from "node:util";
 //#region src/gateway/service/config-coordinator.ts
 /**
 * GatewayConfigCoordinator — owns config persistence, hot-reload, and the
@@ -44,6 +45,7 @@ var GatewayConfigCoordinator = class {
 	configReloader = null;
 	channelReloadFlushPromise = null;
 	channelReloadPending = false;
+	configWrite = Promise.resolve();
 	constructor(opts) {
 		this.opts = opts;
 	}
@@ -97,9 +99,28 @@ var GatewayConfigCoordinator = class {
 			error: result.error
 		};
 	}
-	async saveConfig(config) {
+	async saveConfig(config, expectedConfig = this.opts.getConfig()) {
+		const candidate = structuredClone(config), expected = structuredClone(expectedConfig);
+		return this.queueConfigWrite(async () => {
+			if (!isDeepStrictEqual(this.opts.getConfig(), expected)) return {
+				saved: false,
+				conflict: true,
+				error: "Configuration changed before saving. Please retry."
+			};
+			return this.persistConfig(candidate);
+		});
+	}
+	async queueConfigWrite(operation) {
+		const next = this.configWrite.catch(() => {}).then(operation);
+		this.configWrite = next;
+		return next;
+	}
+	async persistConfig(config) {
+		let persisted = false;
 		try {
-			await this.writeConfigAndReloadFromDisk(config);
+			await this.writeConfigAndReloadFromDisk(config, () => {
+				persisted = true;
+			});
 			this.scheduleChannelPluginsAfterPersist();
 			return { saved: true };
 		} catch (err) {
@@ -111,35 +132,24 @@ var GatewayConfigCoordinator = class {
 			}, `Failed to save config: ${em}`);
 			return {
 				saved: false,
-				error: em
+				error: em,
+				persisted
 			};
 		}
 	}
 	/** Merge partial updates into `currentConfig` and persist. */
 	async updateConfig(updates) {
-		try {
-			log.debug("Updating configuration...");
-			const merged = {
+		const patch = structuredClone(updates);
+		return this.queueConfigWrite(async () => {
+			const result = await this.persistConfig({
 				...this.opts.getConfig(),
-				...updates
-			};
-			this.opts.setConfig(merged);
-			await this.writeConfigAndReloadFromDisk(merged);
-			this.scheduleChannelPluginsAfterPersist();
-			log.debug("Configuration updated successfully");
-			return { updated: true };
-		} catch (err) {
-			const em = err instanceof Error ? err.message : String(err);
-			log.error({
-				err,
-				errorMessage: em,
-				phase: "infra.config"
-			}, `Failed to update config: ${em}`);
+				...patch
+			});
 			return {
-				updated: false,
-				error: em
+				updated: result.saved,
+				...result.error ? { error: result.error } : {}
 			};
-		}
+		});
 	}
 	/**
 	* Persist `extensions.enabled` / `extensions.disabled` for a discovered extension.
@@ -339,8 +349,10 @@ var GatewayConfigCoordinator = class {
 	* runtime matches disk (PATCH merge objects can drift from Zod-normalized
 	* output).
 	*/
-	async writeConfigAndReloadFromDisk(configToWrite) {
+	async writeConfigAndReloadFromDisk(configToWrite, onPersisted) {
 		await saveConfig(configToWrite, this.opts.configPath);
+		onPersisted?.();
+		this.opts.setConfig(structuredClone(configToWrite));
 		const reloaded = loadConfig(this.opts.configPath);
 		this.opts.setConfig(reloaded);
 		await configureTracing(reloaded.observability?.tracing);

package/dist/src/gateway/service/marketplace-service.js

@@ -3,12 +3,12 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
+import { removeSkillsLockEntry } from "../../agent/skills/hub-lock.js";
+import { deleteManagedSkill, installSkillFromZip, listManagedSkillDirs } from "../../agent/skills/managed-store.js";
 import { createSkillConfigManager } from "../../agent/skills/config.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../../agent/skills/workspace-skills-dir.js";
 import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
 import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
-import { removeSkillsLockEntry } from "../../agent/skills/hub-lock.js";
-import { deleteManagedSkill, installSkillFromZip, listManagedSkillDirs } from "../../agent/skills/managed-store.js";
 import { normalizeSkillInstallTarget } from "../../agent/skills/install-target.js";
 import { isAgentPluginArchive, withAgentPluginArchive } from "../../extensions/agent-plugins/sources.js";
 import { existsSync, rmSync } from "node:fs";

package/dist/src/gateway/service/run-gateway-agent.js

@@ -11,14 +11,14 @@ import { getConnectionResumeInput, init_connection_wait_repository, isConnection
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { getConversationRouting } from "../../storage/sqlite/conversation-repository.js";
 import { init_session_key } from "../../routing/session-key.js";
+import { resolveAgentTurnTimeoutMs } from "../../agent/orchestration/run-agent-turn-with-timeout.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
-import { prependEnvelopeTimestamp } from "../../channels/envelope-timestamp.js";
 import { recordPersonalPerformance } from "../../personal-agent/performance.js";
-import "../chat-limits.js";
-import { resolveAgentTurnTimeoutMs } from "../../agent/orchestration/run-agent-turn-with-timeout.js";
-import { formatAgentRunErrorForClient } from "../../agent/client-error-format.js";
 import { resolveExecutionContext } from "../../tasks/execution-context.js";
 import { TaskRunCoordinator } from "../../tasks/task-run-coordinator.js";
+import { formatAgentRunErrorForClient } from "../../agent/client-error-format.js";
+import "../chat-limits.js";
+import { prependEnvelopeTimestamp } from "../../channels/envelope-timestamp.js";
 import { ChatStreamMapper } from "../chat-stream/mapper.js";
 import { markdownNotificationPreview } from "../../notifications/plain-text.js";
 import { resolveWebchatConversationId } from "../resolve-webchat-session-key.js";

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

@@ -1,10 +1,10 @@
 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 { getPersonalAgentByConversation } from "../../personal-agent/repository.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
-import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import "../../projects/index.js";
-import { init_providers, resolveModel } from "../../providers/index.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";

package/dist/src/gateway/service.d.ts

@@ -1,3 +1,4 @@
+import type { ClarificationSubmission } from '@xopcai/gateway-contract';
 import { WorkDiscoveryService } from '../work-discovery/service.js';
 import { ConnectionRecoveryService } from '../connectors/connection-recovery-service.js';
 import { AgentService } from '../agent/service.js';
@@ -203,8 +204,8 @@ export declare class GatewayService {
         idle: boolean;
     }>;
     getActiveWebchatRunId(conversationId: string): string | undefined;
-    answerEphemeralClarification(requestId: string, answer: string): boolean;
-    getClarificationState(conversationId: string): import("@xopcai/gateway-contract/src/clarifications.js").ClarificationWaitSnapshot;
+    answerEphemeralClarification(requestId: string, answer: ClarificationSubmission): boolean;
+    getClarificationState(conversationId: string): import("@xopcai/gateway-contract").ClarificationWaitSnapshot;
     resolveClarificationResponse(input: Parameters<GatewayAgentRunner['resolveClarificationResponse']>[0]): import("../storage/sqlite/clarification-wait-repository.js").ResolveClarificationResult;
     private initializeExtensionLoader;
     private registerExtensionChannelPlugins;
@@ -243,9 +244,11 @@ export declare class GatewayService {
     }>;
     afterWeixinCredentialsPersisted(): Promise<void>;
     afterFeishuCredentialsPersisted(): Promise<void>;
-    saveConfig(config: Config): Promise<{
+    saveConfig(config: Config, expectedConfig?: Config): Promise<{
         saved: boolean;
         error?: string;
+        persisted?: boolean;
+        conflict?: boolean;
     }>;
     syncVoiceLanguage(language: ProductLanguage): Promise<{
         applied: boolean;

package/dist/src/gateway/service.js

@@ -22,56 +22,69 @@ import { getSessionConfig, init_config_repository } from "../storage/sqlite/conf
 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 { onSessionTranscriptUpdate } from "../session/transcript-events.js";
-import { TaskAllocationRepository } from "../tasks/task-allocation-repository.js";
+import { listKnowledgeItems } from "../knowledge-memory/repository.js";
+import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.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 { getPersonalAgentByConversation } from "../personal-agent/repository.js";
-import { stopPersonalResultPreparations } from "../personal-agent/result-reader.js";
-import { buildResultAgentContext } from "../agent/source-context/result-context.js";
-import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
-import { buildUserAssertionAgentContext } from "../agent/source-context/user-assertion-context.js";
-import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
-import { ProjectService } from "../projects/project-service.js";
-import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import "../knowledge-memory/index.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
-import { resolveProjectAgentId } from "../projects/project-agent.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import "../projects/index.js";
-import { NotesStore } from "../notes/store.js";
-import { assertTaskHandoffAccess, getTaskHandoff } from "../tasks/task-handoff.js";
-import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
-import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.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 { flushTracing } from "../observability/runtime.js";
 import { AI_USAGE_RETENTION_MS, markStaleAiUsageEventsUnknown, pruneAiUsageEvents } from "../storage/sqlite/ai-usage-repository.js";
+import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { getPersonalAgentByConversation } from "../personal-agent/repository.js";
+import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
+import { TaskAllocationRepository } from "../tasks/task-allocation-repository.js";
+import { stopPersonalResultPreparations } from "../personal-agent/result-reader.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
+import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.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 { onTaskResultQueued } from "../tasks/task-result-delivery-repository.js";
+import { runMemoryMaintenance } from "../memory-maintenance/service.js";
+import "../memory-maintenance/index.js";
+import { RealtimeExtensionBrowserProvider } from "../browser/providers/realtime-extension.js";
+import { drainEmbeddedSessionRunnerShutdowns, evictAllEmbeddedSessionRunners } from "../agent/embedded/session-runner.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 { buildResultAgentContext } from "../agent/source-context/result-context.js";
+import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
+import { buildUserAssertionAgentContext } from "../agent/source-context/user-assertion-context.js";
+import { assertTaskHandoffAccess, getTaskHandoff } from "../tasks/task-handoff.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 { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
-import { RealtimeExtensionBrowserProvider } from "../browser/providers/realtime-extension.js";
+import { assertTaskExecutorReady } from "../tasks/task-execution-capabilities.js";
+import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
+import "../tasks/index.js";
+import { drainPersonalResultReads } from "../personal-agent/result-read-continuations.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 { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
-import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
-import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
-import { ChannelManager } from "../channels/manager.js";
-import { ChatPreviewService } from "../chat-previews/service.js";
-import "../chat-previews/index.js";
 import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
-import { getWorkspacePath } from "../config/workspace-path-helpers.js";
+import { collectMediaUrisFromMessages, deleteMediaUris } from "../media/session-references.js";
+import { AgentService } from "../agent/service.js";
+import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
+import { ChatPreviewService } from "../chat-previews/service.js";
+import "../chat-previews/index.js";
 import "../config/index.js";
-import { ExtensionLoader } from "../extensions/loader.js";
-import "../extensions/index.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 { PersonalReplyComposer } from "../personal-agent/reply-composer.js";
@@ -86,12 +99,16 @@ 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 { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
+import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
 import { getGatewayFileSpaceService } from "./file-space-service.js";
 import { reconcileHomeIntelligenceAutomation } from "./home-intelligence-automation-reconciler.js";
-import { drainPersonalResultReads } from "../personal-agent/result-read-continuations.js";
 import { PersonalProactivityService } from "../personal-agent/proactivity/service.js";
 import { reconcilePersonalProactivityAutomation } from "../personal-agent/proactivity/automation.js";
 import { createBackgroundTask } from "../infra/background-task.js";
@@ -102,21 +119,8 @@ 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 { drainEmbeddedSessionRunnerShutdowns, evictAllEmbeddedSessionRunners } from "../agent/embedded/session-runner.js";
-import { SessionIndex } from "../session/manager.js";
-import "../session/index.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 { 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 { assertTaskExecutorReady } from "../tasks/task-execution-capabilities.js";
-import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
-import "../tasks/index.js";
-import { AgentService } from "../agent/service.js";
+import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
+import { ChannelManager } from "../channels/manager.js";
 import "../notes/index.js";
 import { buildWorkflowChildTools } from "../agent/workflow/workflow-child-tools.js";
 import { WorkflowRunService } from "../workflows/service/workflow-run-service.js";
@@ -162,10 +166,6 @@ 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();
@@ -1336,6 +1336,7 @@ var GatewayService = class {
 		}
 		registerClarificationChannelRuntime({
 			answerChoice: (requestId, choiceIndex, idempotencyKey) => this.agentRunner.answerClarificationChoice(requestId, choiceIndex, idempotencyKey),
+			answerDecision: (requestId, decision, idempotencyKey) => this.agentRunner.answerClarificationDecision(requestId, decision, idempotencyKey),
 			answerText: (conversationId, text, idempotencyKey) => this.agentRunner.answerClarificationText(conversationId, text, idempotencyKey)
 		});
 		this.ensureAgentService();
@@ -1695,8 +1696,8 @@ var GatewayService = class {
 	afterFeishuCredentialsPersisted() {
 		return this.configCoordinator.afterFeishuCredentialsPersisted();
 	}
-	saveConfig(config) {
-		return this.configCoordinator.saveConfig(config);
+	saveConfig(config, expectedConfig) {
+		return this.configCoordinator.saveConfig(config, expectedConfig);
 	}
 	async syncVoiceLanguage(language) {
 		const mode = this.config.voice?.languageMode ?? "auto";

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 { TaskOriginRepository } from "../tasks/task-origin-repository.js";
-import { isSessionSourceBinding } from "../agent/source-context/types.js";
-import { ProjectStore } from "../projects/project-store.js";
 import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
-import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
+import { ProjectStore } from "../projects/project-store.js";
+import { TaskOriginRepository } from "../tasks/task-origin-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
+import { TaskCollaborationRepository } from "../tasks/task-collaboration-repository.js";
 import { runExec } from "../infra/exec.js";
+import { isSessionSourceBinding } from "../agent/source-context/types.js";
 import { realpath, stat } from "node:fs/promises";
 //#region src/gateway/session-context-summary.ts
 init_config_repository();

package/dist/src/gateway/side-chat/run-service.d.ts

@@ -1,3 +1,4 @@
+import type { ClarificationSubmission } from '@xopcai/gateway-contract';
 import type { AgentService } from '../../agent/service.js';
 import type { GatewayAgentRunner } from '../service/agent-runner.js';
 import { type EphemeralSideChatManager } from './manager.js';
@@ -23,6 +24,6 @@ export declare class SideChatRunService {
     /** Disposal has already removed the transcript from the public manager. */
     cancelRun(sideChatId: string, clientInstanceId: string, runId?: string): Promise<boolean>;
     dispose(sideChatId: string, clientInstanceId: string): Promise<boolean>;
-    submitClarification(sideChatId: string, clientInstanceId: string, requestId: string, answer: string): boolean;
+    submitClarification(sideChatId: string, clientInstanceId: string, requestId: string, answer: ClarificationSubmission): boolean;
     private execute;
 }

package/dist/src/gateway/side-chat/run-service.js

@@ -1,10 +1,13 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { readClarificationPresentation } from "../../../packages/gateway-contract/src/clarifications.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { abortEmbeddedRun } from "../../agent/embedded/runs.js";
 import { SideChatError } from "./manager.js";
 import { ChatStreamMapper } from "../chat-stream/mapper.js";
 import { randomUUID } from "node:crypto";
 //#region src/gateway/side-chat/run-service.ts
+init_src();
 init_logger();
 const log = createLogger("Gateway:SideChatRun");
 var SideChatRunService = class {
@@ -76,11 +79,11 @@ var SideChatRunService = class {
 		const publishMapped = (event) => {
 			if (run.abortController.signal.aborted) return;
 			if (event.type === "clarify_request") this.options.manager.waitForInput(run.sideChatId, run.clientInstanceId, {
+				...readClarificationPresentation(event),
+				expiresAt: typeof event.expiresAt === "number" ? event.expiresAt : void 0,
 				requestId: String(event.requestId),
 				kind: event.kind === "approval" ? "approval" : "input",
-				question: String(event.question),
-				choices: Array.isArray(event.choices) ? event.choices.filter((choice) => typeof choice === "string") : void 0,
-				suggestedAnswer: typeof event.suggestedAnswer === "string" ? event.suggestedAnswer : void 0
+				question: String(event.question)
 			}, event.kind === "approval" ? "waiting-approval" : "waiting-input");
 			for (const mapped of mapper.map(event)) publish(mapped);
 		};

package/dist/src/gateway/side-chat/types.d.ts

@@ -1,3 +1,4 @@
+import type { ClarificationPresentation } from '@xopcai/gateway-contract';
 import type { ThinkingLevel } from '@earendil-works/pi-agent-core';
 export type SideChatStatus = 'idle' | 'running' | 'waiting-approval' | 'waiting-input' | 'promoting' | 'closing';
 export type SideChatSelection = {
@@ -52,12 +53,11 @@ export interface SideChatView {
     expiresAt: string | null;
     serverNow?: string;
     runId?: string;
-    clarification?: {
+    clarification?: ClarificationPresentation & {
         requestId: string;
         kind: 'input' | 'approval';
         question: string;
-        choices?: string[];
-        suggestedAnswer?: string;
+        expiresAt?: number;
     };
     messageCount: number;
     context: SideChatContextSnapshot;

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

@@ -1,5 +1,5 @@
 import path, { relative, resolve } from "node:path";
-import fsSync from "node:fs";
+import fs 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 = fsSync.realpathSync.native(resolved);
+		resolved = fs.realpathSync.native(resolved);
 	} catch {}
 	return process.platform === "win32" ? resolved.toLowerCase() : resolved;
 }

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

@@ -1,5 +1,5 @@
-import type { Config } from '../config/schema.js';
-import type { AgentDefaults } from '../agent-config/index.js';
+import { type Config } from '../config/schema.js';
+import { type AgentDefaults } from '../agent-config/index.js';
 import type { CatalogSource } from '../providers/model-catalog-store.js';
 type CloudCapability = 'chat' | 'vision' | 'image-generation' | 'stt' | 'tts';
 export interface XopcCloudCapabilitySelection {

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

@@ -1,13 +1,16 @@
+import "../agent-config/schema.js";
+import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { AgentCatalogService } from "../agent-catalog/service.js";
+import { ConfigSchema, init_schema } from "../config/schema.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 { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
+init_schema();
+init_agent_config();
 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"));
@@ -181,7 +184,6 @@ async function applyXopcCloudCapabilitySetup(service) {
 	};
 	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");
@@ -192,7 +194,7 @@ async function applyXopcCloudCapabilitySetup(service) {
 	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 = {
+	if (chat && currentDefaults.models.chat.primary === "xopc-cloud/auto" && currentDefaults.models.chat.fallbacks.length === 0) nextDefaults.models.chat = {
 		primary: `xopc-cloud/${chat.id}`,
 		fallbacks: []
 	};
@@ -232,6 +234,7 @@ async function applyXopcCloudCapabilitySetup(service) {
 			} }
 		};
 	}
+	if (!nextConfig.voice && (realtimeStt || realtimeTts || realtimeOmni)) nextConfig.voice = ConfigSchema.parse({ voice: { realtime: { enabled: true } } }).voice;
 	const realtime = nextConfig.voice?.realtime;
 	if (realtime?.enabled) {
 		if (realtimeStt && !realtime.stt) realtime.stt = {

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

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

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, isHomeProseLocalized } 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, isHomeProseLocalized } from "./generator.js";
 import { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts

package/dist/src/imports/compatibility.js

@@ -1,5 +1,5 @@
-import { isValidSkillId } from "../agent/skills/managed-store.js";
 import { McpServerSchema, init_schema } from "../config/schema.js";
+import { isValidSkillId } from "../agent/skills/managed-store.js";
 import { containsSecret, isCredentialPath } from "./secrets.js";
 import { digest, fileHash } from "./files.js";
 import yaml from "js-yaml";

package/dist/src/imports/inventory.js

@@ -1,8 +1,8 @@
-import { ProjectService } from "../projects/project-service.js";
-import { init_paths, resolveSkillsDir } from "../config/paths.js";
-import { resolveWorkspaceSkillsDir } from "../agent/skills/workspace-skills-dir.js";
 import { listKnowledgeItems } from "../knowledge-memory/repository.js";
 import "../knowledge-memory/index.js";
+import { init_paths, resolveSkillsDir } from "../config/paths.js";
+import { ProjectService } from "../projects/project-service.js";
+import { resolveWorkspaceSkillsDir } from "../agent/skills/workspace-skills-dir.js";
 import { ImportError } from "./types.js";
 import { digest } from "./files.js";
 import { canonicalTarget } from "./planner.js";

package/dist/src/imports/productImport.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../config/paths-state.js";
 import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { ProjectService } from "../projects/project-service.js";
 import { init_paths } from "../config/paths.js";
+import { ProjectService } from "../projects/project-service.js";
 import { ImportError } from "./types.js";
 import { digest, fileHash, readRegularFile, readTree } from "./files.js";
 import { importContextDocument } from "./contextImport.js";
@@ -11,8 +11,8 @@ import { ImportSelectionRepository } from "../storage/sqlite/import-selection-re
 import { existingContext, getLiveInventory } from "./inventory.js";
 import { join } from "node:path";
 import { mkdirSync, realpathSync, statSync } from "node:fs";
-import lockfile from "proper-lockfile";
 import { setImmediate } from "node:timers/promises";
+import lockfile from "proper-lockfile";
 //#region src/imports/productImport.ts
 init_paths();
 init_transaction();

package/dist/src/imports/runtime.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { ProjectService } from "../projects/project-service.js";
 import { init_paths, resolveBundledSkillsDir, resolveSkillsDir } from "../config/paths.js";
+import { ProjectService } from "../projects/project-service.js";
 import { resolveWorkspaceSkillsDir } from "../agent/skills/workspace-skills-dir.js";
 import { loadSkills } from "../agent/skills/index.js";
 import { ProjectTrustStore } from "../project-trust/trust-store.js";

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 fsSync from "node:fs";
+import fs 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(fsSync.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
+		return parseProcCmdline(fs.readFileSync(`/proc/${pid}/cmdline`, "utf8"));
 	} catch {
 		return null;
 	}