@xopcai/xopc 0.0.323 → 0.0.324

package/dist/src/gateway/service.js

@@ -5,31 +5,31 @@ import { init_log_stream, subscribeToLogs } from "../utils/logger/log-stream.js"
 import { getRuntimeLogStats } from "../utils/logger/stats.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { closeXopcDatabase, openXopcDatabase } from "../storage/sqlite/connection.js";
+import { closeXopcDatabase } from "../storage/sqlite/connection.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
-import { getBrowserTabBindingById } from "../storage/sqlite/browser-tab-binding-repository.js";
+import { getBrowserTabBindingById, init_browser_tab_binding_repository } from "../storage/sqlite/browser-tab-binding-repository.js";
 import { findSessionInput, init_session_input_repository, insertSessionInput } from "../storage/sqlite/session-input-repository.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../tasks/task-run-repository.js";
 import { init_changes, notifyUserContextChange } from "../user-context/changes.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
-import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
-import { getSessionConfig } from "../storage/sqlite/config-repository.js";
-import "../storage/sqlite/index.js";
+import { init_session_repository, listSessionMetadata, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
+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_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { init_agent_scope, listAgentEntries, normalizeAgentId, 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";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
-import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
-import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
-import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, init_channel_catalog_service } from "../channels/catalog/channel-catalog-service.js";
-import { loadConfig, saveConfig } from "../config/loader.js";
 import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.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";
@@ -52,15 +52,19 @@ import "../automations/index.js";
 import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
 import "../tasks/index.js";
 import "../agent/mcp/bundle-mcp-tools.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 { ensureStarterAgentsInitialized } from "../agent/starter-agents.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";
@@ -115,7 +119,6 @@ import { assertGatewayRuntimeConfig } from "./runtime-config.js";
 import { auditGatewayConfig } from "./security/audit.js";
 import { getXopcCloudCatalogCoordinator } from "../providers/xopc-cloud-catalog-coordinator.js";
 import { ModelCatalogSyncService } from "../providers/model-catalog-sync-service.js";
-import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { NotificationService } from "../notifications/service.js";
 import "../local-apps/index.js";
 import { createRuntimeBrowserAutomationService } from "../browser/automations/runtime-service.js";
@@ -137,14 +140,19 @@ import { createGatewayStartupTrace } from "./startup-trace.js";
 import { GatewaySceneHost } from "./scenes/host.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
+import { HomeAdviceGenerator } from "../home-intelligence/generator.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();
 init_agent_session_key();
+init_browser_tab_binding_repository();
 init_session_input_repository();
+init_config_repository();
 init_changes();
 init_agent_scope();
-init_channel_catalog_service();
 init_schema();
 init_providers();
 init_logger();
@@ -153,8 +161,10 @@ init_paths();
 init_package_version();
 init_resolve_route();
 init_session_key();
+init_sqlite();
 init_task_run_repository();
 init_transaction();
+init_config();
 const log = createLogger("Gateway:Service");
 var GatewayService = class {
 	bus;
@@ -168,6 +178,7 @@ var GatewayService = class {
 	extensionLoader = null;
 	extensionMetadataSnapshot = null;
 	sceneHost = null;
+	homeIntelligenceHost = null;
 	sessionIndex;
 	running = false;
 	startTime = Date.now();
@@ -195,7 +206,7 @@ var GatewayService = class {
 			const messages = await this.sessionIndex.loadMessages(conversationId);
 			const after = await this.sessionIndex.getSessionMetadata(conversationId);
 			if (after?.transcriptId !== expectedTranscriptId) throw new Error("Conversation changed while loading voice context");
-			const profile = resolveEffectiveAgentProfileForSession(this.config, conversationId);
+			const profile = resolveEffectiveAgentProfileForSession(conversationId);
 			const persona = buildVoicePersonaContext({
 				getConfig: () => this.config,
 				conversationId,
@@ -348,14 +359,9 @@ var GatewayService = class {
 		this.serviceConfig = serviceConfig;
 		this.bus = new MessageBus();
 		this.configPath = serviceConfig.configPath || resolveConfigPath();
-		runBootstrapMigrationsSync(this.configPath);
+		bootstrapApplicationStateSync(this.configPath);
 		this.config = loadConfig(this.configPath);
 		let bootstrapConfigChanged = initializeVoiceDefaults(this.config, inferProductLanguageFromEnvironment());
-		const starterResult = ensureStarterAgentsInitialized(this.config);
-		if (starterResult.changed) {
-			this.config = starterResult.config;
-			bootstrapConfigChanged = true;
-		}
 		if (sanitizeTunnelConfig(this.config)) bootstrapConfigChanged = true;
 		if (bootstrapConfigChanged) saveConfig(this.config, this.configPath).catch((err) => {
 			const em = err instanceof Error ? err.message : String(err);
@@ -604,11 +610,23 @@ var GatewayService = class {
 	refreshUserProfileContext() {
 		this._agentService?.refreshUserProfileContext();
 	}
+	/** Refresh long-lived runtime caches after an Agent catalog mutation. */
+	refreshAgentCatalog() {
+		this._agentService?.applyRuntimeConfiguration(this.config);
+		this.reconcileMemoryMaintenanceAutomations().catch((error) => {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			log.warn({
+				err: error,
+				errorMessage
+			}, `Agent catalog refresh failed: ${errorMessage}`);
+		});
+		this.emit("agent.catalog", {});
+	}
 	ensureAgentService() {
 		if (this._agentService) return this._agentService;
 		this._agentService = new AgentService(this.bus, {
 			workspace: this.workspacePath,
-			model: getAgentDefaultModelRef(this.config),
+			model: getAgentDefaultModelRef(),
 			config: this.config,
 			sessionStore: this.sessionIndex.getStore(),
 			onSessionMetadataUpdated: (conversationId, patch) => {
@@ -643,6 +661,7 @@ var GatewayService = class {
 			getChatPreviewService: () => this.chatPreviews,
 			dispatchTaskEvents: () => this.dispatchTaskEvents(),
 			dispatchTaskRuns: () => this.dispatchTaskRuns(),
+			onAgentCatalogMutate: () => this.refreshAgentCatalog(),
 			getWorkflowRunService: () => this.createWorkflowRunService(),
 			sourceContextResolver: async (binding) => {
 				if (binding.kind === "note") {
@@ -676,7 +695,7 @@ var GatewayService = class {
 		});
 		this.automationService.setDeps({
 			agentService: this._agentService,
-			getDefaultAgentId: () => getDefaultAgentId(this.config),
+			getDefaultAgentId: () => getDefaultAgentId(),
 			prepareAgentSession: (input) => prepareAutomationAgentSession(this.sessionIndex.getStore(), this.projects, input),
 			workflowRunService: this.createWorkflowRunService(),
 			browserAutomationService: this.browserAutomations,
@@ -1019,6 +1038,8 @@ var GatewayService = class {
 			await this.stop().catch((cleanupError) => log.error({ err: cleanupError }, "Gateway startup cleanup failed"));
 			await this.sceneHost?.stop();
 			this.sceneHost = null;
+			this.homeIntelligenceHost?.stop();
+			this.homeIntelligenceHost = null;
 			this.stopRealtimeLogBridge?.();
 			this.stopRealtimeLogBridge = null;
 			setPairingBroadcastSink(null);
@@ -1034,7 +1055,42 @@ var GatewayService = class {
 			this.emit(type, payload);
 		});
 		log.debug("Starting gateway service...");
-		openXopcDatabase();
+		const homeCapabilities = new HomeCapabilityPreflightService({
+			config: () => this.config,
+			agentId: () => resolveDefaultAgentId(),
+			skills: (agentId) => this.agentService.getAgentSkillAvailability(agentId).skills,
+			principalId: "local-owner"
+		});
+		this.homeIntelligenceHost = new HomeIntelligenceHost(getSqliteDatabase(), {
+			principal: {
+				ownerId: "local-owner",
+				workspaceId: this.workspacePath
+			},
+			snapshot: new HomeSnapshotBuilder({
+				projects: () => this.projects.list({ limit: 500 }).items,
+				tasks: () => new TaskRepository().list({ limit: 200 }),
+				knowledge: () => listKnowledgeItems({
+					statuses: ["active"],
+					limit: 200
+				}),
+				knowledgePolicy: () => this.config.userContext.knowledgeMemory.enabled ? resolveKnowledgeReadPolicy(this.config.userContext.knowledgeMemory) : {
+					scopes: [],
+					contentSources: []
+				},
+				sessions: () => listSessionMetadata({
+					limit: 50,
+					excludeArchived: true
+				}).items
+			}),
+			generator: new HomeAdviceGenerator(() => this.config),
+			capabilities: () => homeCapabilities.inventory(),
+			resolveCapabilities: (requirements, options) => homeCapabilities.resolve(requirements, options),
+			publish: (type, payload) => this.realtime.broker.publish("gateway", type, payload),
+			notifyOpportunity: (payload) => this.emit("home.opportunity.ready", payload),
+			locale: () => "en",
+			enabled: () => this.config.userContext.enabled,
+			dispatchTaskRuns: () => this.dispatchTaskRuns()
+		});
 		await this.localApps.recoverPendingReleases();
 		const { recoverCapabilityImports } = await import("../imports/runtime.js");
 		await recoverCapabilityImports();
@@ -1056,7 +1112,7 @@ var GatewayService = class {
 		const trace = this.startupTrace;
 		const catalogCoordinator = getXopcCloudCatalogCoordinator();
 		const catalog = await trace.measure("model-catalog.hydrate", () => catalogCoordinator.hydrate());
-		if (getAgentDefaultModelRef(this.config)?.startsWith("xopc-cloud/") && catalog.source === "none") {
+		if (getAgentDefaultModelRef()?.startsWith("xopc-cloud/") && catalog.source === "none") {
 			const readiness = await trace.measure("model-catalog.initial-refresh", () => catalogCoordinator.ensure({
 				reason: "startup",
 				network: "if-empty",
@@ -1079,7 +1135,7 @@ var GatewayService = class {
 			runMessageSending: (to, content, channel) => this.agentService.outboundCoordinator.invokeOutboundMessageSending(to, content, channel),
 			runMessageSent: (to, content, success, error, channel) => this.agentService.outboundCoordinator.invokeOutboundMessageSent(to, content, success, error, channel)
 		});
-		this.channelManager.enableOutboundPersistence(getDefaultAgentId(this.config));
+		this.channelManager.enableOutboundPersistence(getDefaultAgentId());
 		if (this.extensionLoader) this.extensionLoader.setRuntimeContext({
 			bus: this.bus,
 			sessionManager: this.sessionIndex,
@@ -1146,7 +1202,7 @@ var GatewayService = class {
 		log.debug("Session manager initialized");
 		this.automationService.setDeps({
 			agentService: this.agentService,
-			getDefaultAgentId: () => getDefaultAgentId(this.config),
+			getDefaultAgentId: () => getDefaultAgentId(),
 			prepareAgentSession: (input) => prepareAutomationAgentSession(this.sessionIndex.getStore(), this.projects, input),
 			workflowRunService: this.createWorkflowRunService(),
 			browserAutomationService: this.browserAutomations,
@@ -1199,7 +1255,7 @@ var GatewayService = class {
 		});
 		this.connectorLearningCoordinator = startConnectorLearningCoordinator({
 			getConfig: () => this.config,
-			resolveAgentId: () => resolveDefaultAgentId(this.config),
+			resolveAgentId: () => resolveDefaultAgentId(),
 			emit: (type, payload) => this.emit(type, payload)
 		});
 		this.managedComposioEventPoller = new ManagedComposioEventPoller({
@@ -1214,7 +1270,7 @@ var GatewayService = class {
 		});
 		this.managedComposioEventPoller.start();
 		this.connectedKnowledgeCoordinator = startConnectedKnowledgeCoordinator({ resolvePipelineOptions: () => ({
-			agentId: resolveDefaultAgentId(this.config),
+			agentId: resolveDefaultAgentId(),
 			workspaceId: this.currentWorkspacePath
 		}) });
 		import("../browser/providers/browser-ext-install.js").then(({ ensureBrowserExtensionOnStartup }) => ensureBrowserExtensionOnStartup(this.config)).catch((err) => log.warn({ err }, "Browser extension artifact ensure failed"));
@@ -1233,10 +1289,11 @@ var GatewayService = class {
 			triggerInProcessRestart: () => this.triggerGatewayProcessRestart()
 		});
 		wireTunnelEventsToGateway(this);
-		import("../share/share-auto.js").then(({ runStagingSweep }) => runStagingSweep([...new Set([getDefaultAgentId(this.config), ...listAgentEntries(this.config).map((entry) => entry.id)])].map((agentId) => resolveAgentWorkspaceDir(this.config, agentId)))).catch((err) => log.warn({ err }, "Share staging sweep failed"));
+		import("../share/share-auto.js").then(({ runStagingSweep }) => runStagingSweep([...new Set([getDefaultAgentId(), ...listAgentEntries().map((entry) => entry.id)])].map((agentId) => resolveAgentWorkspaceDir(agentId)))).catch((err) => log.warn({ err }, "Share staging sweep failed"));
 		if (this.serviceConfig.deferChannelConnectUntilAfterHttp !== true) this.markGatewayReady();
 		else trace.mark("service.started-awaiting-http");
 		this.sceneHost?.start();
+		this.homeIntelligenceHost.start();
 		log.debug("Gateway service started");
 	}
 	/** Called when the HTTP listener is bound (before deferred channel work). */
@@ -1332,6 +1389,8 @@ var GatewayService = class {
 		await this.sideChats.disposeAll();
 		await this.sceneHost?.stop();
 		this.sceneHost = null;
+		this.homeIntelligenceHost?.stop();
+		this.homeIntelligenceHost = null;
 		this.realtime.close();
 		this.voiceRealtime.close();
 		await this.discussionWorker.stop();
@@ -1619,6 +1678,10 @@ var GatewayService = class {
 	get currentWorkspacePath() {
 		return this.workspacePath;
 	}
+	get homeIntelligence() {
+		if (!this.homeIntelligenceHost) throw new Error("Home intelligence is not running");
+		return this.homeIntelligenceHost;
+	}
 	get messageBusInstance() {
 		return this.bus;
 	}
@@ -1674,15 +1737,15 @@ var GatewayService = class {
 	}
 	collectWorkflowAgentIds() {
 		const ids = /* @__PURE__ */ new Set();
-		ids.add(resolveDefaultAgentId(this.config));
-		for (const entry of listAgentEntries(this.config)) {
+		ids.add(resolveDefaultAgentId());
+		for (const entry of listAgentEntries()) {
 			if (entry.enabled === false) continue;
 			ids.add(normalizeAgentId(entry.id));
 		}
 		return [...ids];
 	}
 	/** Process a message directly through the agent (for CLI mode). */
-	async processDirect(content, conversationId = resolveAgentMainConversationId({ agentId: getDefaultAgentId(this.config) })) {
+	async processDirect(content, conversationId = resolveAgentMainConversationId({ agentId: getDefaultAgentId() })) {
 		return this.agentService.turnDispatcher.processDirect(content, conversationId, {
 			type: "system",
 			source: "internal"
@@ -1690,6 +1753,13 @@ var GatewayService = class {
 	}
 	emit(type, payload) {
 		if (type === "config.reload") notifyUserContextChange({ kind: "policy" });
+		if (type === "connector.learning.updated" && payload && typeof payload === "object") {
+			const job = payload;
+			if (job.status === "completed" && typeof job.sourceInstanceId === "string" && typeof job.updatedAt === "string") this.homeIntelligenceHost?.sourceChanged({
+				sourceInstanceId: job.sourceInstanceId,
+				revision: job.updatedAt
+			});
+		}
 		this.realtime.broker.publish("gateway", type, payload);
 		this.createNotificationService().handleGatewayEvent(type, payload);
 	}
@@ -1734,6 +1804,12 @@ var GatewayService = class {
 				});
 			}
 			if (event.type.startsWith("task.")) this.emit(event.type, event.payload);
+			if (event.type.startsWith("task.") || event.type.startsWith("project.")) {
+				const payload = event.payload;
+				const objectId = event.type.startsWith("task.") ? payload.taskId : payload.projectId;
+				const revision = payload.version ?? payload.revision ?? "unknown";
+				this.homeIntelligenceHost?.requestRefresh(event.type.startsWith("task.") ? "task_changed" : "project_changed", `domain:${event.type}:${String(objectId)}:${String(revision)}`);
+			}
 			this.automationService.triggerEvent(event).catch((err) => {
 				const em = err instanceof Error ? err.message : String(err);
 				log.warn({

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

@@ -1,11 +1,11 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
-import { hasGatewayScope } from "./security/gateway-scopes.js";
+import { hasGatewayScope, init_gateway_scopes } from "./security/gateway-scopes.js";
 import { TaskRepository, init_task_repository } from "../tasks/task-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../storage/sqlite/session-repository.js";
-import { getSessionConfig } from "../storage/sqlite/config-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";
@@ -14,10 +14,12 @@ 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();
 init_session_repository();
 init_transaction();
 init_task_repository();
 init_logger();
+init_gateway_scopes();
 const log = createLogger("SessionContextSummary");
 const SOURCE_LIMIT = 20;
 async function readEnvironment(config, conversationId, projectId) {

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

@@ -1,4 +1,5 @@
 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 {
@@ -12,6 +13,7 @@ export interface XopcCloudCapabilitySelection {
 export type PrepareXopcCloudCapabilitySetupResult = {
     ok: true;
     config: Config;
+    defaults: AgentDefaults;
     selection: XopcCloudCapabilitySelection;
 } | {
     ok: false;

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

@@ -1,7 +1,10 @@
+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 { compareCatalogModels } from "../providers/model-catalog-ranking.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
+init_repository();
 init_model_catalog_store();
 function supportsCapability(model, capability) {
 	if (model.availability !== "available") return false;
@@ -49,9 +52,10 @@ function prepareXopcCloudCapabilitySetup(config, source) {
 		missing: selected.missing
 	};
 	const selection = selected.selection;
-	const currentModels = config.agents.defaults.models;
-	const defaultsUpdate = prepareUpdateGlobalDefaults(config, { defaults: {
-		...config.agents.defaults,
+	const currentDefaults = new AgentCatalogRepository().getSettings().defaults;
+	const currentModels = currentDefaults.models;
+	const defaultsUpdate = prepareUpdateGlobalDefaults({ defaults: {
+		...currentDefaults,
 		models: {
 			...currentModels,
 			chat: {
@@ -75,18 +79,18 @@ function prepareXopcCloudCapabilitySetup(config, source) {
 		error: defaultsUpdate.error,
 		missing: []
 	};
-	const withDefaults = defaultsUpdate.data.nextConfig;
-	const currentStt = withDefaults.tools?.media?.audio;
-	const currentTts = withDefaults.messages?.tts;
+	const currentStt = config.tools?.media?.audio;
+	const currentTts = config.messages?.tts;
 	return {
 		ok: true,
 		selection,
+		defaults: defaultsUpdate.data.defaults,
 		config: {
-			...withDefaults,
+			...config,
 			tools: {
-				...withDefaults.tools,
+				...config.tools,
 				media: {
-					...withDefaults.tools?.media,
+					...config.tools?.media,
 					audio: {
 						...currentStt,
 						enabled: true,
@@ -106,7 +110,7 @@ function prepareXopcCloudCapabilitySetup(config, source) {
 				}
 			},
 			messages: {
-				...withDefaults.messages,
+				...config.messages,
 				tts: {
 					...currentTts,
 					enabled: true,
@@ -144,6 +148,7 @@ async function applyXopcCloudCapabilitySetup(service) {
 		configured: false,
 		error: saved.error ?? "Failed to save XOPC Cloud capability configuration"
 	};
+	new AgentCatalogService().updateDefaults(prepared.defaults);
 	return {
 		configured: true,
 		selection: prepared.selection

package/dist/src/home-intelligence/application-service.d.ts

@@ -0,0 +1,31 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { HomeOpportunityActionResponse } from '@xopcai/gateway-contract';
+import { type HomeOpportunityFeedbackInput, type HomePrincipal } from './repository.js';
+export declare class HomeOpportunityNotFoundError extends Error {
+}
+export declare class HomeOpportunityActionError extends Error {
+}
+export declare class HomeOpportunityApplicationService {
+    private readonly db;
+    private readonly principal;
+    private readonly resolveAgentId;
+    private readonly repository;
+    private readonly tasks;
+    private readonly taskApplication;
+    constructor(db: DatabaseSync, principal: HomePrincipal, resolveAgentId?: () => string);
+    start(input: {
+        opportunityId: string;
+        expectedRevision: number;
+        idempotencyKey: string;
+        now: number;
+    }, options?: {
+        degraded?: boolean;
+    }): HomeOpportunityActionResponse;
+    discuss(input: {
+        opportunityId: string;
+        expectedRevision: number;
+        idempotencyKey: string;
+        now: number;
+    }): HomeOpportunityActionResponse;
+    feedback(opportunityId: string, input: HomeOpportunityFeedbackInput): void;
+}

package/dist/src/home-intelligence/application-service.js

@@ -0,0 +1,134 @@
+import { init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { TaskRepository, init_task_repository } from "../tasks/task-repository.js";
+import { TaskApplicationService } from "../tasks/task-application-service.js";
+import { HomeIntelligenceRepository } from "./repository.js";
+//#region src/home-intelligence/application-service.ts
+init_task_repository();
+init_transaction();
+var HomeOpportunityNotFoundError = class extends Error {};
+var HomeOpportunityActionError = class extends Error {};
+var HomeOpportunityApplicationService = class {
+	repository;
+	tasks = new TaskRepository();
+	taskApplication = new TaskApplicationService();
+	constructor(db, principal, resolveAgentId = () => "main") {
+		this.db = db;
+		this.principal = principal;
+		this.resolveAgentId = resolveAgentId;
+		this.repository = new HomeIntelligenceRepository(db);
+	}
+	start(input, options = {}) {
+		return runSqliteWriteTransaction((db) => {
+			if (db !== this.db) throw new Error("Home opportunity service database mismatch");
+			const taskKey = `home-opportunity:${input.opportunityId}:${input.idempotencyKey}`;
+			const existing = this.tasks.getByIdempotencyKey(taskKey);
+			if (existing) return {
+				outcome: "task",
+				taskId: existing.id,
+				href: `/tasks/${encodeURIComponent(existing.id)}`
+			};
+			const opportunity = this.repository.getOpportunity(this.principal, input.opportunityId, input.now);
+			if (!opportunity) throw new HomeOpportunityNotFoundError("Home opportunity is unavailable");
+			if (opportunity.revision !== input.expectedRevision) throw new HomeOpportunityActionError("Home opportunity changed; refresh before starting");
+			if (opportunity.evidence.some((item) => item.freshUntil <= input.now)) throw new HomeOpportunityActionError("Home opportunity evidence expired; refresh before starting");
+			const degraded = Boolean(options.degraded);
+			if (degraded && !opportunity.degradedActionPrompt) throw new HomeOpportunityActionError("This opportunity has no degraded start path");
+			if (!degraded && !opportunity.actions.canStart || opportunity.risk === "external_write") throw new HomeOpportunityActionError("This opportunity must be discussed before it can start");
+			const agentId = this.resolveAgentId();
+			const created = this.taskApplication.create({
+				idempotencyKey: taskKey,
+				title: opportunity.title,
+				projectId: opportunity.projectId,
+				priority: opportunity.urgency === "now" ? "high" : "normal",
+				delegateAgentId: agentId,
+				contract: {
+					objective: degraded ? opportunity.degradedActionPrompt : opportunity.actionPrompt,
+					expectedOutputs: [opportunity.outcome],
+					acceptanceCriteria: opportunity.verification,
+					constraints: degraded ? ["Use only currently available capabilities and the attached evidence."] : [],
+					approvalRequired: [],
+					assumptions: [],
+					risks: [opportunity.risk],
+					acceptancePolicy: "verified_then_review",
+					outputDestinations: []
+				},
+				dependencies: [],
+				context: opportunity.evidence.map((item) => ({
+					targetKind: item.sourceType === "file" ? "file" : "source",
+					targetId: item.sourceRef,
+					role: "evidence",
+					title: item.observation.slice(0, 200),
+					pinned: true,
+					retrievalPolicy: {},
+					metadata: {
+						evidenceId: item.id,
+						revision: item.revision
+					}
+				})),
+				authorityGrants: [],
+				activation: {
+					mode: "start",
+					executor: {
+						kind: "agent",
+						agentId
+					}
+				}
+			}, { kind: "user" });
+			if (created.ok === false) throw new HomeOpportunityActionError(`Could not start task: ${created.reason}`);
+			const task = created.model.task;
+			this.repository.recordFeedback(this.principal, input.opportunityId, {
+				idempotencyKey: input.idempotencyKey,
+				kind: "started",
+				expectedRevision: input.expectedRevision,
+				createdAt: input.now,
+				resolution: {
+					kind: "task",
+					ref: task.id
+				}
+			});
+			return {
+				outcome: "task",
+				taskId: task.id,
+				href: `/tasks/${encodeURIComponent(task.id)}`
+			};
+		});
+	}
+	discuss(input) {
+		const replay = this.repository.isFeedbackRecorded(input.opportunityId, input.idempotencyKey);
+		const opportunity = replay ? this.repository.getOpportunitySnapshot(this.principal, input.opportunityId) : this.repository.getOpportunity(this.principal, input.opportunityId, input.now);
+		if (!opportunity) throw new HomeOpportunityNotFoundError("Home opportunity is unavailable");
+		if (!replay) {
+			if (opportunity.revision !== input.expectedRevision) throw new HomeOpportunityActionError("Home opportunity changed; refresh before discussing");
+			this.repository.recordFeedback(this.principal, input.opportunityId, {
+				idempotencyKey: input.idempotencyKey,
+				kind: "discussed",
+				expectedRevision: input.expectedRevision,
+				createdAt: input.now,
+				resolution: {
+					kind: "session",
+					ref: "draft"
+				}
+			});
+		}
+		const query = new URLSearchParams({ draft: opportunity.actionPrompt });
+		if (opportunity.projectId) query.set("projectId", opportunity.projectId);
+		return {
+			outcome: "chat_draft",
+			href: `/chat/new?${query.toString()}`
+		};
+	}
+	feedback(opportunityId, input) {
+		if (this.repository.isFeedbackRecorded(opportunityId, input.idempotencyKey)) return;
+		const opportunity = this.repository.getOpportunity(this.principal, opportunityId, input.createdAt);
+		if (!opportunity) throw new HomeOpportunityNotFoundError("Home opportunity is unavailable");
+		this.repository.recordFeedback(this.principal, opportunityId, {
+			...input,
+			scope: input.scope ?? {
+				kind: opportunity.kind,
+				projectId: opportunity.projectId
+			}
+		});
+	}
+};
+//#endregion
+export { HomeOpportunityActionError, HomeOpportunityApplicationService, HomeOpportunityNotFoundError };

package/dist/src/home-intelligence/capability-preflight.d.ts

@@ -0,0 +1,32 @@
+import type { HomeCapabilityPreflight, HomeCapabilityReadiness } from '@xopcai/gateway-contract';
+import type { Config } from '../config/schema.js';
+import type { AgentSkillUnavailableReason } from '../agent/agent-manager.js';
+import type { HomeCapabilityInventory } from './types.js';
+export interface HomeCapabilityRequirement {
+    kind: 'connector' | 'skill' | 'agent';
+    capability: string;
+    required: boolean;
+}
+export interface HomeSkillAvailability {
+    name: string;
+    availableForCurrentAgent: boolean;
+    unavailableReason: AgentSkillUnavailableReason | null;
+}
+export interface HomeCapabilityResolution {
+    capabilities: HomeCapabilityReadiness[];
+    preflight: HomeCapabilityPreflight;
+}
+export interface HomeCapabilityPreflightDeps {
+    config(): Config;
+    agentId(): string;
+    skills(agentId: string): HomeSkillAvailability[];
+    principalId: string;
+}
+export declare class HomeCapabilityPreflightService {
+    private readonly deps;
+    constructor(deps: HomeCapabilityPreflightDeps);
+    inventory(): HomeCapabilityInventory;
+    resolve(requirements: readonly HomeCapabilityRequirement[], options?: {
+        degradedActionAvailable?: boolean;
+    }): HomeCapabilityResolution;
+}