@xopcai/xopc 0.0.331 → 0.0.332

package/dist/src/config/models-json.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths, resolveModelsJsonPath } from "./paths.js";
-import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
+import { init_write_file_atomic, writeTextAtomicSync } from "../infra/write-file-atomic.js";
 import { init_model_policy, isComputerModel } from "../computer/model-policy.js";
 import { existsSync, readFileSync } from "fs";
 import { z } from "zod";

package/dist/src/config/schema.d.ts

@@ -1360,6 +1360,10 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                 postCompactionSections: z.ZodDefault<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        homeIntelligence: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            refreshOnContextChange: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     session: z.ZodDefault<z.ZodObject<{
         scope: z.ZodDefault<z.ZodEnum<{

package/dist/src/config/schema.js

@@ -1,9 +1,9 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { ComputerConfigSchema, init_config } from "../computer/config.js";
 import { AgentModelsOverrideSchema, ImageGenerationRouteSchema, ModelRouteSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { ComputerConfigSchema, init_config } from "../computer/config.js";
 import { DEFAULT_CONTEXT_COMPACTION_POLICY, UserContextConfigSchema, init_config as init_config$1 } from "../user-context/config.js";
 import { init_public_url, validatePublicUrl } from "./public-url.js";
 import { PlatformConfigSchema, init_contracts } from "../platform/contracts.js";
@@ -1052,6 +1052,10 @@ workDiscoveryOnboarding: z.boolean().default(true) }).strict().default({ workDis
 				maxKnowledge: 12,
 				maxChars: 6e3,
 				compaction: DEFAULT_CONTEXT_COMPACTION_POLICY
+			},
+			homeIntelligence: {
+				enabled: true,
+				refreshOnContextChange: true
 			}
 		},
 		session: {

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

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

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

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

package/dist/src/gateway/file-path-classifier.js

@@ -1,7 +1,7 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
 import { extractProfileAgentId } from "../config/agent-profile.js";
+import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
 import { isBareProfileMarkdownFileName, resolveProfileMarkdownPathIfBareName } from "../agent/tools/tool-paths.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { basename, isAbsolute, resolve } from "node:path";

package/dist/src/gateway/home-intelligence-automation-reconciler.d.ts

@@ -0,0 +1,3 @@
+import type { AutomationService } from '../automations/index.js';
+export declare const HOME_ADVISOR_REFRESH_AUTOMATION_ID = "system-home-advisor-refresh";
+export declare function reconcileHomeIntelligenceAutomation(automationService: AutomationService): Promise<'created' | 'updated' | 'unchanged'>;

package/dist/src/gateway/home-intelligence-automation-reconciler.js

@@ -0,0 +1,49 @@
+//#region src/gateway/home-intelligence-automation-reconciler.ts
+const HOME_ADVISOR_REFRESH_AUTOMATION_ID = "system-home-advisor-refresh";
+async function reconcileHomeIntelligenceAutomation(automationService) {
+	const current = await automationService.get(HOME_ADVISOR_REFRESH_AUTOMATION_ID);
+	const managed = {
+		name: "Refresh Home AI suggestions",
+		description: "Re-evaluate Home suggestions from current workspace context.",
+		action: {
+			kind: "system",
+			capability: "home.advisor.refresh"
+		},
+		safety: { mode: "auto_apply" },
+		conversationMode: "new_session",
+		notificationPolicy: "none",
+		reliability: { disableAfterConsecutiveFailures: 3 },
+		management: {
+			owner: "home-intelligence",
+			editable: ["enabled", "trigger"],
+			runnable: true,
+			deletable: false
+		}
+	};
+	if (!current) {
+		await automationService.create({
+			id: HOME_ADVISOR_REFRESH_AUTOMATION_ID,
+			enabled: false,
+			trigger: {
+				kind: "schedule",
+				schedule: {
+					kind: "interval",
+					everyMs: 30 * 6e4,
+					anchorMs: Date.now()
+				}
+			},
+			...managed
+		});
+		return "created";
+	}
+	const patch = {
+		...managed,
+		enabled: current.enabled,
+		trigger: current.trigger
+	};
+	if (!Object.entries(patch).some(([key, value]) => JSON.stringify(current[key]) !== JSON.stringify(value))) return "unchanged";
+	await automationService.update(HOME_ADVISOR_REFRESH_AUTOMATION_ID, patch);
+	return "updated";
+}
+//#endregion
+export { HOME_ADVISOR_REFRESH_AUTOMATION_ID, reconcileHomeIntelligenceAutomation };

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

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

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

@@ -1,10 +1,10 @@
-import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
-import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { ComputerConfigSchema, init_config } from "../../../../computer/config.js";
-import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config as init_config$1 } from "../../../../user-context/config.js";
+import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
+import { ContextPlanningConfigSchema, HomeIntelligenceConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config as init_config$1 } from "../../../../user-context/config.js";
 import { BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
 import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
+import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { mergeGatewaySkillsMarketplacePatch, mergeSessionConfigPatch, mergeUpdateConfigPatch } from "../../../../config/web-patch.js";
 import { assertGatewayAuthConfigured, resolveGatewayAuth } from "../../../auth.js";
 import { isMaskedSecretPatchValue } from "../../lib/mask-secret-length.js";
@@ -37,7 +37,8 @@ async function applyMiscPatch(config, body) {
 			"preferences",
 			"userModel",
 			"knowledgeMemory",
-			"contextPlanning"
+			"contextPlanning",
+			"homeIntelligence"
 		].includes(key));
 		if (unknownKeys.length) return patchError(`Unknown userContext settings: ${unknownKeys.join(", ")}`);
 		if (userContextPatch.enabled !== void 0) {
@@ -111,6 +112,19 @@ async function applyMiscPatch(config, body) {
 				contextPlanning: parsed.data
 			};
 		}
+		if (userContextPatch.homeIntelligence !== void 0) {
+			const patch = userContextPatch.homeIntelligence;
+			if (typeof patch !== "object" || patch === null || Array.isArray(patch)) return patchError("userContext.homeIntelligence must be an object");
+			const parsed = HomeIntelligenceConfigSchema.safeParse({
+				...config.userContext.homeIntelligence,
+				...patch
+			});
+			if (!parsed.success) return patchError(parsed.error.issues.map((issue) => issue.message).join("; "));
+			config.userContext = {
+				...config.userContext,
+				homeIntelligence: parsed.data
+			};
+		}
 		const parsedUserContext = UserContextConfigSchema.safeParse(config.userContext);
 		if (!parsedUserContext.success) return patchError(parsedUserContext.error.issues.map((issue) => issue.message).join("; "));
 		config.userContext = parsedUserContext.data;

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

@@ -16,7 +16,6 @@ function registerHomeRoutes(authenticated, deps) {
 	const home = new HomeQueryService(service, () => service.homeIntelligence.getAdvisor());
 	authenticated.get("/api/home", async (c) => {
 		const locale = c.req.query("locale");
-		service.homeIntelligence.requestRefresh("home_opened", void 0, locale);
 		return c.json(await home.getSnapshot(locale));
 	});
 	authenticated.get("/api/home/advisor/metrics", (c) => {

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

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

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

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

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

@@ -4,9 +4,9 @@ import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packa
 import { browserPageContextsInputSchema } from "../../../../packages/gateway-contract/src/browser-page-context.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { init_providers, resolveModel } from "../../../providers/index.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";
 import { isTaskDestructiveCommand } from "../../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../../chat-commands/command-parse.js";

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

@@ -5,9 +5,9 @@ import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
+import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";
 import { TaskDeleteOutputSchema } from "../../../tasks/capabilities/management.js";
 import { TaskMutationOutputSchema } from "../../../tasks/capabilities/write.js";

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

@@ -32,13 +32,18 @@ function registerUpdateRoutes(authenticated, deps) {
 		});
 	});
 	authenticated.post("/api/update/check", strictRateLimitMiddleware, async (c) => {
-		await runGatewayUpdateCheck({
+		const checkResult = await runGatewayUpdateCheck({
 			config: loadConfig(service.getHealth().configPath),
 			force: true,
 			onUpdateAvailableChange: (update) => {
 				service.emit("update.available", update);
 			}
 		});
+		if (checkResult.ok === false) return c.json({
+			ok: false,
+			error: "update-check-failed",
+			message: `Could not check npm for updates: ${checkResult.error}`
+		}, 502);
 		const result = getUpdateAvailable();
 		return c.json({
 			ok: true,

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

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

package/dist/src/gateway/lock.js

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

package/dist/src/gateway/memory-maintenance-automation-reconciler.js

@@ -1,9 +1,6 @@
-import { normalizeAgentId } from "../agent-catalog/id.js";
-import { init_agent_scope, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { maintenanceInstruction, resolveMemoryMaintenanceSchedules } from "../memory-maintenance/schedule.js";
+import { resolveMemoryMaintenanceSchedules } from "../memory-maintenance/schedule.js";
 import "../memory-maintenance/index.js";
 //#region src/gateway/memory-maintenance-automation-reconciler.ts
-init_agent_scope();
 const AUTOMATION_IDS = [
 	"system-memory-temporal-sweep",
 	"system-memory-daily-reconciliation",
@@ -17,8 +14,6 @@ async function reconcileMemoryMaintenanceAutomations(input) {
 	};
 	const schedules = resolveMemoryMaintenanceSchedules(input.config);
 	const enabledIds = new Set(schedules.map((item) => item.automationId));
-	const agentId = normalizeAgentId(resolveDefaultAgentId());
-	const workingDirectory = resolveAgentWorkspaceDir(agentId);
 	for (const id of AUTOMATION_IDS) {
 		if (enabledIds.has(id)) continue;
 		if ((await input.automationService.get(id))?.enabled) {
@@ -36,11 +31,8 @@ async function reconcileMemoryMaintenanceAutomations(input) {
 			}
 		};
 		const action = {
-			kind: "agent",
-			agentId,
-			instruction: maintenanceInstruction(schedule.jobType),
-			workingDirectory,
-			timeoutSeconds: 300
+			kind: "system",
+			capability: `memory.${schedule.jobType}`
 		};
 		const next = {
 			name: schedule.name,
@@ -51,7 +43,13 @@ async function reconcileMemoryMaintenanceAutomations(input) {
 			safety: { mode: "auto_apply" },
 			conversationMode: "continuous",
 			notificationPolicy: "none",
-			reliability: { disableAfterConsecutiveFailures: 3 }
+			reliability: { disableAfterConsecutiveFailures: 3 },
+			management: {
+				owner: "memory-maintenance",
+				editable: ["enabled", "trigger"],
+				runnable: true,
+				deletable: false
+			}
 		};
 		const current = await input.automationService.get(schedule.automationId);
 		if (!current) {
@@ -62,8 +60,13 @@ async function reconcileMemoryMaintenanceAutomations(input) {
 			result.created += 1;
 			continue;
 		}
-		if (current.name !== next.name || current.description !== next.description || !current.enabled || JSON.stringify(current.trigger) !== JSON.stringify(trigger) || JSON.stringify(current.action) !== JSON.stringify(action) || current.safety?.mode !== "auto_apply" || current.notificationPolicy !== "none") {
-			await input.automationService.update(schedule.automationId, next);
+		const reconciled = current.management ? {
+			...next,
+			enabled: current.enabled,
+			trigger: current.trigger
+		} : next;
+		if (current.name !== reconciled.name || current.description !== next.description || current.enabled !== reconciled.enabled || JSON.stringify(current.trigger) !== JSON.stringify(reconciled.trigger) || JSON.stringify(current.action) !== JSON.stringify(action) || current.safety?.mode !== "auto_apply" || current.notificationPolicy !== "none" || JSON.stringify(current.management) !== JSON.stringify(next.management)) {
+			await input.automationService.update(schedule.automationId, reconciled);
 			result.updated += 1;
 		}
 	}

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

@@ -318,6 +318,7 @@ export declare class GatewayService {
     getEffectiveListenPort(): number;
     get automationServiceInstance(): AutomationService;
     private reconcileMemoryMaintenanceAutomations;
+    private executeSystemAutomationAction;
     get notesServiceInstance(): NotesService;
     get sessionIndexInstance(): SessionIndex;
     /** Shared workflow run orchestrator + session bridge (one instance per gateway). */

package/dist/src/gateway/service.js

@@ -17,14 +17,14 @@ 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_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, 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 { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
@@ -38,6 +38,8 @@ 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";
@@ -90,6 +92,7 @@ import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validate
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
 import { getGatewayFileSpaceService } from "./file-space-service.js";
+import { reconcileHomeIntelligenceAutomation } from "./home-intelligence-automation-reconciler.js";
 import { createBackgroundTask } from "../infra/background-task.js";
 import { buildTaskAgentContext } from "../agent/source-context/task-context.js";
 import { buildFileAgentContext } from "../agent/source-context/file-context.js";
@@ -726,6 +729,7 @@ var GatewayService = class {
 					...result.runId ? { runId: result.runId } : {}
 				};
 			},
+			executeSystemAction: (input) => this.executeSystemAutomationAction(input),
 			onRunCompleted: (run) => this.handleAutomationRunCompleted(run)
 		});
 		return this._agentService;
@@ -1089,7 +1093,7 @@ var GatewayService = class {
 			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,
+			enabled: () => this.config.userContext.enabled && this.config.userContext.homeIntelligence.enabled,
 			dispatchTaskRuns: () => this.dispatchTaskRuns()
 		});
 		await this.localApps.recoverPendingReleases();
@@ -1234,6 +1238,7 @@ var GatewayService = class {
 					...result.runId ? { runId: result.runId } : {}
 				};
 			},
+			executeSystemAction: (input) => this.executeSystemAutomationAction(input),
 			onRunCompleted: (run) => this.handleAutomationRunCompleted(run)
 		});
 		this.startAutomationProductEventBridge();
@@ -1246,6 +1251,7 @@ var GatewayService = class {
 			});
 		});
 		await trace.measure("automations.initialize", () => this.automationService.initialize());
+		await trace.measure("homeIntelligence.reconcileAutomation", () => reconcileHomeIntelligenceAutomation(this.automationService));
 		await trace.measure("memoryMaintenance.reconcile", () => this.reconcileMemoryMaintenanceAutomations());
 		await this.notesService.initialize();
 		this.discussionLiveWorker.start();
@@ -1700,6 +1706,21 @@ var GatewayService = class {
 			automationService: this.automationService
 		});
 	}
+	executeSystemAutomationAction(input) {
+		if (input.capability === "home.advisor.refresh") {
+			const generationId = this.homeIntelligence.requestRefresh("scheduled_refresh", `automation:${input.runId}`);
+			return { summary: generationId === "disabled" ? "Home AI suggestions are disabled" : `Home advice refresh queued: ${generationId}` };
+		}
+		const maintenance = this.config.userContext.userModel.maintenance;
+		if (!this.config.userContext.enabled || !this.config.userContext.userModel.enabled || !maintenance.enabled) return { summary: "Memory maintenance is disabled" };
+		const result = runMemoryMaintenance({
+			jobType: input.capability.slice(7),
+			limit: maintenance.limit,
+			staleRetentionDays: maintenance.staleRetentionDays,
+			evidenceThreshold: maintenance.evidenceThreshold
+		});
+		return { summary: `Memory maintenance completed: ${JSON.stringify(result.metrics)}` };
+	}
 	get notesServiceInstance() {
 		return this.notesService;
 	}
@@ -1759,7 +1780,8 @@ var GatewayService = class {
 			const job = payload;
 			if (job.status === "completed" && typeof job.sourceInstanceId === "string" && typeof job.updatedAt === "string") this.homeIntelligenceHost?.sourceChanged({
 				sourceInstanceId: job.sourceInstanceId,
-				revision: job.updatedAt
+				revision: job.updatedAt,
+				refresh: this.config.userContext.homeIntelligence.refreshOnContextChange
 			});
 		}
 		this.realtime.broker.publish("gateway", type, payload);
@@ -1806,7 +1828,7 @@ var GatewayService = class {
 				});
 			}
 			if (event.type.startsWith("task.")) this.emit(event.type, event.payload);
-			if (event.type.startsWith("task.") || event.type.startsWith("project.")) {
+			if (this.config.userContext.homeIntelligence.refreshOnContextChange && (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";

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

@@ -1,7 +1,7 @@
 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 { AgentCatalogService } from "../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
 init_repository();

package/dist/src/home-intelligence/host.d.ts

@@ -30,7 +30,6 @@ export declare class HomeIntelligenceHost {
     private timer?;
     private running;
     private stopped;
-    private nextScheduledRefresh;
     private abortController;
     private localeHint;
     constructor(db: DatabaseSync, deps: HomeIntelligenceHostDeps);
@@ -43,6 +42,7 @@ export declare class HomeIntelligenceHost {
     sourceChanged(input: {
         sourceInstanceId: string;
         revision: string;
+        refresh: boolean;
     }): void;
     act(opportunityId: string, input: HomeOpportunityActionRequest): HomeOpportunityActionResponse;
     feedback(opportunityId: string, input: HomeOpportunityFeedbackRequest): void;

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

@@ -10,7 +10,6 @@ import { createHash } from "node:crypto";
 init_logger();
 const log = createLogger("HomeIntelligence");
 const POLL_INTERVAL_MS = 5e3;
-const REFRESH_INTERVAL_MS = 30 * 6e4;
 const GENERATION_LEASE_MS = 5 * 6e4;
 const DAILY_MODEL_GENERATION_BUDGET = 12;
 function generationFingerprint(snapshotHash, capabilities) {
@@ -28,7 +27,6 @@ var HomeIntelligenceHost = class {
 	timer;
 	running = false;
 	stopped = false;
-	nextScheduledRefresh = 0;
 	abortController = new AbortController();
 	localeHint;
 	constructor(db, deps) {
@@ -41,7 +39,6 @@ var HomeIntelligenceHost = class {
 	start() {
 		if (this.timer) return;
 		this.stopped = false;
-		this.nextScheduledRefresh = this.now();
 		this.timer = setInterval(() => void this.tick(), POLL_INTERVAL_MS);
 		this.timer.unref?.();
 		this.tick();
@@ -78,14 +75,13 @@ var HomeIntelligenceHost = class {
 		return request.generationId;
 	}
 	sourceChanged(input) {
-		if (this.deps.enabled?.() === false) return;
 		const now = this.now();
 		const invalidated = this.repository.invalidateOpportunitiesByEvidenceSources(this.deps.principal, new Set([
 			"calendar",
 			"mail",
 			"communication"
 		]), now);
-		this.requestRefresh("connector_changed", `connector:${input.sourceInstanceId}:${input.revision}`);
+		if (input.refresh) this.requestRefresh("connector_changed", `connector:${input.sourceInstanceId}:${input.revision}`);
 		if (invalidated > 0) this.deps.publish("home.advisor.updated", {
 			state: "source_changed",
 			sourceInstanceId: input.sourceInstanceId,
@@ -155,10 +151,6 @@ var HomeIntelligenceHost = class {
 		try {
 			const now = this.now();
 			this.repository.maintain(now);
-			if (now >= this.nextScheduledRefresh) {
-				this.nextScheduledRefresh = now + REFRESH_INTERVAL_MS;
-				this.requestRefresh("scheduled_refresh", `scheduled_refresh:${Math.floor(now / REFRESH_INTERVAL_MS)}`);
-			}
 			const claim = this.repository.claimNext(this.deps.principal, `gateway:${process.pid}`, now, GENERATION_LEASE_MS);
 			if (!claim) return;
 			await this.process(claim);

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

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 //#region src/home-intelligence/notification.ts
 function buildHomeOpportunityNotification(opportunity, reasons, placement) {
 	const backgroundRefresh = reasons.includes("connector_changed") || reasons.includes("scheduled_refresh");
-	const foregroundRefresh = reasons.includes("home_opened") || reasons.includes("manual_refresh");
+	const foregroundRefresh = reasons.includes("manual_refresh");
 	const hasCrossSourceEvidence = opportunity.evidence.some((item) => item.sourceType === "calendar" || item.sourceType === "mail" || item.sourceType === "communication");
 	if (!backgroundRefresh || foregroundRefresh || placement !== "primary" || opportunity.confidence !== "high" || opportunity.urgency !== "now" || !opportunity.actions.canStart || !hasCrossSourceEvidence) return void 0;
 	const evidenceRevision = opportunity.evidence.map((item) => `${item.sourceType}:${item.sourceRef}:${item.revision}`).sort().join("\n");

package/dist/src/home-intelligence/repository.d.ts

@@ -6,7 +6,7 @@ export interface HomePrincipal {
     ownerId: string;
     workspaceId: string;
 }
-export type HomeGenerationReason = 'home_opened' | 'manual_refresh' | 'project_changed' | 'task_changed' | 'conversation_changed' | 'connector_changed' | 'scheduled_refresh';
+export type HomeGenerationReason = 'manual_refresh' | 'project_changed' | 'task_changed' | 'conversation_changed' | 'connector_changed' | 'scheduled_refresh';
 export interface HomeGenerationClaim extends HomePrincipal {
     generationId: string;
     leaseOwner: string;

package/dist/src/infra/update-check.d.ts

@@ -5,6 +5,10 @@ export type NpmTagResult = {
     version: string | null;
     error?: string;
 };
+type RegistryResponse = Pick<Response, 'ok' | 'status' | 'json'>;
+type RegistryFetch = (url: string, init: {
+    signal: AbortSignal;
+}) => Promise<RegistryResponse>;
 export type UpdateCheckResult = {
     installKind: InstallKind;
     root: string | null;
@@ -21,6 +25,7 @@ export type UpdateAvailable = {
 export declare function fetchNpmTagVersion(params: {
     tag: string;
     timeoutMs?: number;
+    fetchImpl?: RegistryFetch;
 }): Promise<NpmTagResult>;
 /**
  * Resolve the best version for the given update channel.
@@ -29,10 +34,8 @@ export declare function fetchNpmTagVersion(params: {
 export declare function resolveNpmChannelTag(params: {
     channel: UpdateChannel;
     timeoutMs?: number;
-}): Promise<{
-    tag: string;
-    version: string | null;
-}>;
+    fetchImpl?: RegistryFetch;
+}): Promise<NpmTagResult>;
 /**
  * Compare two semver strings. Returns:
  * -1 if a < b, 0 if equal, 1 if a > b, null if either is unparseable.
@@ -51,3 +54,4 @@ export declare function detectInstallKind(packageRoot: string): Promise<InstallK
 export declare function resolvePackageRoot(): Promise<string | null>;
 /** Get the current running version from package.json. */
 export declare function getCurrentVersion(): string;
+export {};