@xopcai/xopc 0.0.330 → 0.0.332

package/dist/src/gateway/service.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";
@@ -72,28 +74,25 @@ import { ChatPreviewService } from "../chat-previews/service.js";
 import "../chat-previews/index.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
-import { DiscussionService } from "../discussions/service.js";
-import { DiscussionOrganizer } from "../discussions/organizer.js";
-import { DiscussionLiveWorker } from "../discussions/live-worker.js";
-import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
-import { DiscussionSealer } from "../discussions/sealer.js";
-import "../discussions/index.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
 import "../knowledge/index.js";
 import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
 import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { startConnectorSupervisor } from "../connectors/supervisor.js";
+import { DiscussionService } from "../discussions/service.js";
+import { DiscussionOrganizer } from "../discussions/organizer.js";
+import { DiscussionLiveWorker } from "../discussions/live-worker.js";
+import { DiscussionOrganizerWorker } from "../discussions/organizer-worker.js";
+import { DiscussionSealer } from "../discussions/sealer.js";
+import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
-import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
-import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 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";
@@ -144,6 +143,10 @@ 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();
@@ -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/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

@@ -1,16 +1,15 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.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 { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts
 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 {};

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

@@ -3,6 +3,7 @@ import { channelToNpmTag } from "./update-channels.js";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { access, readFile } from "node:fs/promises";
+import { Agent, fetch } from "undici";
 //#region src/infra/update-check.ts
 init_package_version();
 const REGISTRY_BASE = "https://registry.npmjs.org";
@@ -17,32 +18,42 @@ const INITIAL_REGISTRY_RETRY_DELAY_MS = 500;
 async function fetchNpmTagVersion(params) {
 	const timeoutMs = params.timeoutMs ?? REGISTRY_TIMEOUT_MS;
 	const url = `${REGISTRY_BASE}/${encodeURIComponent(PACKAGE_NAME).replace("%40", "@")}/${encodeURIComponent(params.tag)}`;
+	const dispatcher = params.fetchImpl ? null : new Agent();
+	const fetchImpl = params.fetchImpl ?? ((input, init) => fetch(input, {
+		...init,
+		dispatcher
+	}));
 	let lastError;
-	for (let attempt = 0; attempt <= MAX_REGISTRY_RETRIES; attempt++) {
-		if (attempt > 0) {
-			const delayMs = INITIAL_REGISTRY_RETRY_DELAY_MS * Math.pow(2, attempt - 1);
-			await new Promise((r) => setTimeout(r, delayMs));
-		}
-		try {
-			const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
-			if (!response.ok) {
-				lastError = `HTTP ${response.status}`;
-				if (response.status >= 400 && response.status < 500) return {
+	try {
+		for (let attempt = 0; attempt <= MAX_REGISTRY_RETRIES; attempt++) {
+			if (attempt > 0) {
+				const delayMs = INITIAL_REGISTRY_RETRY_DELAY_MS * Math.pow(2, attempt - 1);
+				await new Promise((r) => setTimeout(r, delayMs));
+			}
+			try {
+				const response = await fetchImpl(url, { signal: AbortSignal.timeout(timeoutMs) });
+				if (!response.ok) {
+					lastError = `HTTP ${response.status}`;
+					if (response.status >= 400 && response.status < 500) return {
+						tag: params.tag,
+						version: null,
+						error: lastError
+					};
+					continue;
+				}
+				const json = await response.json();
+				const version = typeof json?.version === "string" ? json.version : null;
+				return {
 					tag: params.tag,
-					version: null,
-					error: lastError
+					version,
+					...version ? {} : { error: "Registry response did not include a version" }
 				};
-				continue;
+			} catch (err) {
+				lastError = err instanceof Error ? err.message : String(err);
 			}
-			const json = await response.json();
-			const version = typeof json?.version === "string" ? json.version : null;
-			return {
-				tag: params.tag,
-				version
-			};
-		} catch (err) {
-			lastError = String(err);
 		}
+	} finally {
+		await dispatcher?.close().catch(() => void 0);
 	}
 	return {
 		tag: params.tag,
@@ -58,33 +69,24 @@ async function resolveNpmChannelTag(params) {
 	const channelTag = channelToNpmTag(params.channel);
 	const channelResult = await fetchNpmTagVersion({
 		tag: channelTag,
-		timeoutMs: params.timeoutMs
+		timeoutMs: params.timeoutMs,
+		fetchImpl: params.fetchImpl
 	});
-	if (params.channel !== "beta") return {
-		tag: channelTag,
-		version: channelResult.version
-	};
+	if (params.channel !== "beta") return channelResult;
 	const latestResult = await fetchNpmTagVersion({
 		tag: "latest",
-		timeoutMs: params.timeoutMs
+		timeoutMs: params.timeoutMs,
+		fetchImpl: params.fetchImpl
 	});
-	if (!latestResult.version) return {
+	if (!latestResult.version) return channelResult.version ? channelResult : {
 		tag: channelTag,
-		version: channelResult.version
-	};
-	if (!channelResult.version) return {
-		tag: "latest",
-		version: latestResult.version
+		version: null,
+		error: [channelResult.error, latestResult.error].filter(Boolean).join("; ") || void 0
 	};
+	if (!channelResult.version) return latestResult;
 	const comparison = compareSemver(channelResult.version, latestResult.version);
-	if (comparison !== null && comparison < 0) return {
-		tag: "latest",
-		version: latestResult.version
-	};
-	return {
-		tag: channelTag,
-		version: channelResult.version
-	};
+	if (comparison !== null && comparison < 0) return latestResult;
+	return channelResult;
 }
 /**
 * Parse a version string into comparable numeric parts.

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

@@ -3,6 +3,12 @@ import { type UpdateAvailable } from './update-check.js';
 import type { InProcessRestartTrigger } from './update-restart.js';
 /** Get the cached update-available state (populated after startup check). */
 export declare function getUpdateAvailable(): UpdateAvailable | null;
+export type GatewayUpdateCheckResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
 /**
  * Main startup update check. Called once when the gateway starts (or on demand).
  */
@@ -12,7 +18,7 @@ export declare function runGatewayUpdateCheck(params: {
     triggerInProcessRestart?: InProcessRestartTrigger;
     /** When true, bypass checkOnStart/auto-disabled early exit and throttle (for POST /api/update/check). */
     force?: boolean;
-}): Promise<void>;
+}): Promise<GatewayUpdateCheckResult>;
 /**
  * Schedule periodic update checks. Returns a cleanup function to stop the timer.
  */

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

@@ -65,7 +65,7 @@ async function runGatewayUpdateCheck(params) {
 	const { config, force } = params;
 	const autoEnabled = config.update?.auto?.enabled ?? false;
 	const shouldCheckHints = config.update?.checkOnStart !== false;
-	if (!force && !shouldCheckHints && !autoEnabled) return;
+	if (!force && !shouldCheckHints && !autoEnabled) return { ok: true };
 	const statePath = resolveUpdateCheckStatePath();
 	const state = await readState(statePath);
 	const now = Date.now();
@@ -83,8 +83,10 @@ async function runGatewayUpdateCheck(params) {
 		}
 	}
 	const checkIntervalMs = resolveCheckIntervalMs(config);
-	const shouldBypassThrottleForVersion = state.lastCheckPackageVersion === void 0 || state.lastCheckPackageVersion !== PACKAGE_VERSION;
-	if (!force && !shouldBypassThrottleForVersion && lastCheckedAt && Number.isFinite(lastCheckedAt) && now - lastCheckedAt < checkIntervalMs) return;
+	const staleAvailableComparison = compareSemver(PACKAGE_VERSION, state.lastAvailableVersion ?? null);
+	const hasStaleAvailableVersion = staleAvailableComparison !== null && staleAvailableComparison >= 0;
+	const shouldBypassThrottleForVersion = state.lastCheckPackageVersion === void 0 || state.lastCheckPackageVersion !== PACKAGE_VERSION || hasStaleAvailableVersion;
+	if (!force && !shouldBypassThrottleForVersion && lastCheckedAt && Number.isFinite(lastCheckedAt) && now - lastCheckedAt < checkIntervalMs) return { ok: true };
 	const root = await resolvePackageRoot();
 	let installKind = "unknown";
 	if (root) {
@@ -101,9 +103,15 @@ async function runGatewayUpdateCheck(params) {
 		lastCheckedAt: new Date(now).toISOString()
 	};
 	if (!resolved.version) {
-		nextState.lastCheckPackageVersion = PACKAGE_VERSION;
-		await writeState(statePath, nextState);
-		return;
+		const error = resolved.error ?? `npm tag ${resolved.tag} did not return a version`;
+		log.warn({
+			tag: resolved.tag,
+			errorMessage: error
+		}, `Update check failed: ${error}`);
+		return {
+			ok: false,
+			error
+		};
 	}
 	const comparison = compareSemver(PACKAGE_VERSION, resolved.version);
 	if (comparison !== null && comparison < 0) {
@@ -147,6 +155,7 @@ async function runGatewayUpdateCheck(params) {
 	}
 	nextState.lastCheckPackageVersion = PACKAGE_VERSION;
 	await writeState(statePath, nextState);
+	return { ok: true };
 }
 async function handleAutoUpdate(params) {
 	const { channel, version, tag, state, nextState, now, root, config } = params;

package/dist/src/memory-maintenance/index.js

@@ -1,3 +1,3 @@
-import { MEMORY_MAINTENANCE_TOKEN, maintenanceInstruction, parseMaintenanceInstruction, resolveMemoryMaintenanceSchedules } from "./schedule.js";
+import { resolveMemoryMaintenanceSchedules } from "./schedule.js";
 import { listMemoryMaintenanceRuns, runMemoryMaintenance } from "./service.js";
-export { MEMORY_MAINTENANCE_TOKEN, listMemoryMaintenanceRuns, maintenanceInstruction, parseMaintenanceInstruction, resolveMemoryMaintenanceSchedules, runMemoryMaintenance };
+export { listMemoryMaintenanceRuns, resolveMemoryMaintenanceSchedules, runMemoryMaintenance };

package/dist/src/memory-maintenance/schedule.d.ts

@@ -1,6 +1,5 @@
 import type { Config } from '../config/schema.js';
 import type { MemoryMaintenanceJob } from './service.js';
-export declare const MEMORY_MAINTENANCE_TOKEN = "__xopc_memory_maintenance__";
 export interface MemoryMaintenanceSchedule {
     jobType: Exclude<MemoryMaintenanceJob, 'manual_repair'>;
     automationId: string;
@@ -9,5 +8,3 @@ export interface MemoryMaintenanceSchedule {
     timezone: string;
 }
 export declare function resolveMemoryMaintenanceSchedules(config: Config): MemoryMaintenanceSchedule[];
-export declare function maintenanceInstruction(jobType: MemoryMaintenanceSchedule['jobType']): string;
-export declare function parseMaintenanceInstruction(value: string): MemoryMaintenanceSchedule['jobType'] | undefined;

package/dist/src/memory-maintenance/schedule.js

@@ -1,5 +1,4 @@
 //#region src/memory-maintenance/schedule.ts
-const MEMORY_MAINTENANCE_TOKEN = "__xopc_memory_maintenance__";
 const WEEKDAY = {
 	sun: 0,
 	mon: 1,
@@ -41,11 +40,5 @@ function resolveMemoryMaintenanceSchedules(config) {
 		}
 	];
 }
-function maintenanceInstruction(jobType) {
-	return `${MEMORY_MAINTENANCE_TOKEN}:${jobType}`;
-}
-function parseMaintenanceInstruction(value) {
-	return new RegExp(`${MEMORY_MAINTENANCE_TOKEN}:(temporal_sweep|daily_reconciliation|weekly_knowledge)`).exec(value)?.[1];
-}
 //#endregion
-export { MEMORY_MAINTENANCE_TOKEN, maintenanceInstruction, parseMaintenanceInstruction, resolveMemoryMaintenanceSchedules };
+export { resolveMemoryMaintenanceSchedules };

package/dist/src/storage/sqlite/migrations/208_automation_management.sql

@@ -0,0 +1,2 @@
+ALTER TABLE automations ADD COLUMN management_json TEXT
+  CHECK(management_json IS NULL OR json_valid(management_json));

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 207;
+export declare const XOPC_DB_SCHEMA_VERSION = 208;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -57,7 +57,7 @@ function applySingleMigration(db, migration, discardOldScenes = false) {
 */
 function applyPendingMigrations(db, options = {}) {
 	db.function("xopc_operation_id", () => currentOperationId() ?? null);
-	const targetVersion = options.targetVersion ?? 207;
+	const targetVersion = options.targetVersion ?? 208;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
@@ -95,7 +95,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 207;
+	const appVersion = options.targetVersion ?? 208;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -137,7 +137,7 @@ var init_runner = __esmMin((() => {
 	init_errors();
 	log = createLogger("Sqlite:Migrations");
 	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
-	XOPC_DB_SCHEMA_VERSION = 207;
+	XOPC_DB_SCHEMA_VERSION = 208;
 }));
 //#endregion
 init_runner();

package/dist/src/storage/sqlite/schema.js

@@ -28,7 +28,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 207,
+		targetVersion: 208,
 		databasePath: fresh ? void 0 : options.databasePath
 	});
 }

package/dist/src/tasks/home-query-service.js

@@ -37,6 +37,7 @@ function actionLabel(automation) {
 	if (automation.action.kind === "workflow") return `workflow:${automation.action.workflowId}`;
 	if (automation.action.kind === "browser_automation") return `browser-automation:${automation.action.automationId}`;
 	if (automation.action.kind === "task_command") return `task:${automation.action.command.type}`;
+	if (automation.action.kind === "system") return `system:${automation.action.capability}`;
 	return automation.action.agentId ? `agent:${automation.action.agentId}` : "agent";
 }
 function toHomeAutomation(automation) {

package/dist/src/user-context/config.d.ts

@@ -145,6 +145,10 @@ export declare const ContextPlanningConfigSchema: z.ZodDefault<z.ZodObject<{
         postCompactionSections: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
 }, z.core.$strict>>;
+export declare const HomeIntelligenceConfigSchema: z.ZodDefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    refreshOnContextChange: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>>;
 export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     preferences: z.ZodDefault<z.ZodObject<{
@@ -259,9 +263,14 @@ export declare const UserContextConfigSchema: 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>>;
 export type UserContextConfig = z.infer<typeof UserContextConfigSchema>;
 export type UserModelConfig = z.infer<typeof UserModelConfigSchema>;
 export type KnowledgeMemoryConfig = z.infer<typeof KnowledgeMemoryConfigSchema>;
 export type ContextPlanningConfig = z.infer<typeof ContextPlanningConfigSchema>;
+export type HomeIntelligenceConfig = z.infer<typeof HomeIntelligenceConfigSchema>;
 export declare function resolveKnowledgeReadPolicy(config: KnowledgeMemoryConfig): KnowledgeReadPolicy;

package/dist/src/user-context/config.js

@@ -16,7 +16,7 @@ function resolveKnowledgeReadPolicy(config) {
 		contentSources: config.contentSources
 	};
 }
-var DEFAULT_CONTEXT_COMPACTION_POLICY, ContextCompactionPolicySchema, WritePolicySchema, MaintenanceTimeSchema, UserModelConfigSchema, KnowledgeMemoryConfigSchema, ContextPlanningConfigSchema, UserContextConfigSchema;
+var DEFAULT_CONTEXT_COMPACTION_POLICY, ContextCompactionPolicySchema, WritePolicySchema, MaintenanceTimeSchema, UserModelConfigSchema, KnowledgeMemoryConfigSchema, ContextPlanningConfigSchema, HomeIntelligenceConfigSchema, UserContextConfigSchema;
 var init_config = __esmMin((() => {
 	init_response_language();
 	DEFAULT_CONTEXT_COMPACTION_POLICY = {
@@ -193,20 +193,29 @@ var init_config = __esmMin((() => {
 		maxChars: 6e3,
 		compaction: DEFAULT_CONTEXT_COMPACTION_POLICY
 	});
+	HomeIntelligenceConfigSchema = z.object({
+		enabled: z.boolean().default(true),
+		refreshOnContextChange: z.boolean().default(true)
+	}).strict().default({
+		enabled: true,
+		refreshOnContextChange: true
+	});
 	UserContextConfigSchema = z.object({
 		enabled: z.boolean().default(true),
 		preferences: z.object({ responseLanguage: ResponseLanguageSchema.default("auto") }).strict().default({ responseLanguage: "auto" }),
 		userModel: UserModelConfigSchema,
 		knowledgeMemory: KnowledgeMemoryConfigSchema,
-		contextPlanning: ContextPlanningConfigSchema
+		contextPlanning: ContextPlanningConfigSchema,
+		homeIntelligence: HomeIntelligenceConfigSchema
 	}).strict().default({
 		enabled: true,
 		preferences: { responseLanguage: "auto" },
 		userModel: UserModelConfigSchema.parse({}),
 		knowledgeMemory: KnowledgeMemoryConfigSchema.parse({}),
-		contextPlanning: ContextPlanningConfigSchema.parse({})
+		contextPlanning: ContextPlanningConfigSchema.parse({}),
+		homeIntelligence: HomeIntelligenceConfigSchema.parse({})
 	});
 }));
 //#endregion
 init_config();
-export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config, resolveKnowledgeReadPolicy };
+export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, HomeIntelligenceConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config, resolveKnowledgeReadPolicy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.330",
+  "version": "0.0.332",
   "description": "Local-first personal AI for the one-person company, with durable context, tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -158,9 +158,9 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
+    "@xopcai/browser-control-contract": "0.1.0",
     "@xopcai/computer-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-client": "0.0.0",
-    "@xopcai/browser-control-contract": "0.1.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-client": "0.0.0",