@xopcai/xopc 0.0.331 → 0.0.333

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/generator.js

@@ -182,7 +182,7 @@ var HomeAdviceGenerator = class {
 			maxTokens: 3e3,
 			temperature: .1,
 			signal: requestSignal
-		});
+		}, void 0, { operation: "home.generate_advice" });
 		const raw = extractHomeResponseText(response);
 		let result;
 		try {
@@ -205,6 +205,9 @@ var HomeAdviceGenerator = class {
 				maxTokens: 3e3,
 				temperature: 0,
 				signal: requestSignal
+			}, void 0, {
+				operation: "home.generate_advice",
+				trigger: "retry"
 			});
 			try {
 				result = HomeModelResultSchema.parse(parseJson(extractHomeResponseText(corrected)));

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/domain-outbox-dispatcher.d.ts

@@ -1,6 +1,3 @@
-import type { AutomationEvent } from '../automations/domain/types.js';
 export declare class DomainOutboxDispatcher {
-    private readonly publish;
-    constructor(publish: (event: AutomationEvent) => void);
     drain(limit?: number, subjectKind?: string): number;
 }

package/dist/src/infra/domain-outbox-dispatcher.js

@@ -1,26 +1,34 @@
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { automationEventPublisher } from "../automations/events/event-repository.js";
 //#region src/infra/domain-outbox-dispatcher.ts
 init_transaction();
 var DomainOutboxDispatcher = class {
-	constructor(publish) {
-		this.publish = publish;
-	}
 	drain(limit = 100, subjectKind) {
-		const rows = getSqliteDatabase().prepare(`SELECT event_id, event_type, payload_json, created_at, subject_kind, operation_id
+		const rows = getSqliteDatabase().prepare(`SELECT event_id, event_type, payload_json, created_at, subject_kind, subject_id, operation_id
        FROM domain_outbox WHERE published_at IS NULL AND (? IS NULL OR subject_kind = ?)
-       ORDER BY created_at, event_id LIMIT ?`).all(subjectKind ?? null, subjectKind ?? null, Math.max(1, Math.min(500, Math.floor(limit))));
+       ORDER BY created_at, rowid LIMIT ?`).all(subjectKind ?? null, subjectKind ?? null, Math.max(1, Math.min(500, Math.floor(limit))));
 		let published = 0;
 		for (const row of rows) try {
 			const payload = JSON.parse(row.payload_json);
-			this.publish({
+			automationEventPublisher.publish({
+				id: row.event_id,
 				type: row.event_type,
 				source: row.subject_kind === "note" ? "notes" : row.subject_kind === "project" ? "projects" : row.subject_kind === "scene" ? "scenes" : row.subject_kind === "local_app" ? "local_apps" : "tasks",
+				schemaVersion: 1,
+				subject: {
+					kind: row.subject_kind,
+					id: row.subject_id
+				},
 				payload: {
 					...payload,
 					sourceEventId: row.event_id,
 					...row.operation_id ? { operationId: row.operation_id } : {}
 				},
-				occurredAtMs: row.created_at
+				occurredAtMs: row.created_at,
+				correlationId: typeof payload.correlationId === "string" ? payload.correlationId : row.event_id,
+				causationId: typeof payload.causationId === "string" ? payload.causationId : void 0,
+				dedupeKey: row.event_id,
+				trust: "system"
 			});
 			runSqliteWriteTransaction((db) => {
 				db.prepare(`UPDATE domain_outbox SET published_at = ?, attempts = attempts + 1

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/local-apps/service.js

@@ -5,10 +5,10 @@ import { currentOperationId, init_operation_context } from "../infra/operation-c
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { LocalAppStore } from "./store.js";
 import { slugifyProjectName } from "../projects/project-store.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";
@@ -511,7 +511,7 @@ var LocalAppService = class {
 		});
 	}
 	flushAcceptanceEvents() {
-		new DomainOutboxDispatcher((event) => this.options.emit(event.type, event.payload)).drain(100, "local_app");
+		new DomainOutboxDispatcher().drain(100, "local_app");
 	}
 	releaseRoot(appId) {
 		return join(resolveStateDir(), "local-apps", "releases", appId);

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/notes/service.js

@@ -8,7 +8,6 @@ import { init_notes_repository, listNoteProjectSummaries } from "../storage/sqli
 import { changedFieldsFromPatch, emitActivity, previewText, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
-import { publishAutomationProductEvent } from "../automations/product-events.js";
 import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
 import { buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
@@ -153,7 +152,7 @@ async function buildAiCatalysisReport(note, config) {
 		role: "user",
 		content: buildCatalysisPrompt(note),
 		timestamp: Date.now()
-	}] }, { temperature: .2 });
+	}] }, { temperature: .2 }, void 0, { operation: "note.generate" });
 	let responseText = "";
 	if (Array.isArray(response.content)) {
 		for (const part of response.content) if (part && typeof part === "object" && part.type === "text") responseText += String(part.text || "");
@@ -173,7 +172,7 @@ var NotesService = class {
 	flushCommittedEffects() {
 		this.store.drainAttachmentCleanup();
 		this.store.drainDeletionCleanup();
-		new DomainOutboxDispatcher(publishAutomationProductEvent).drain(100, "note");
+		new DomainOutboxDispatcher().drain(100, "note");
 	}
 	async quickCapture(markdown, source, idempotencyKey) {
 		const note = this.quickCaptureAtomically(markdown, source, idempotencyKey);

package/dist/src/projects/project-service.js

@@ -8,7 +8,6 @@ import { enqueueProjectChanged } from "./project-change-events.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
 import { drainProjectWorkspaceCreation, queueProjectWorkspaceCreation } from "./project-workspace-creation.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
-import { publishAutomationProductEvent } from "../automations/product-events.js";
 import { listPendingProjectUnderstandingRuns } from "../work-discovery/repository.js";
 import { inferProjectExecutionMode } from "./project-kind.js";
 import { bindSessionToProject, listProjectConversationIds, unbindSessionFromProject } from "./session-bind.js";
@@ -280,7 +279,7 @@ var ProjectService = class {
 	}
 	flushCommittedEffects(projectId) {
 		drainProjectWorkspaceCreation(projectId);
-		new DomainOutboxDispatcher(publishAutomationProductEvent).drain(100, "project");
+		new DomainOutboxDispatcher().drain(100, "project");
 	}
 	listUpdates(projectId, limit) {
 		return this.store.listUpdates(projectId, limit);

package/dist/src/projects/project-skill-service.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
-import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../agent/skills/workspace-skills-dir.js";
-import { loadSkills, loadWorkspaceSkillInventory } from "../agent/skills/index.js";
 import { removeSkillsLockEntry } from "../agent/skills/hub-lock.js";
 import { deleteManagedSkill, installSkillFromZip, isValidSkillId } from "../agent/skills/managed-store.js";
+import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../agent/skills/workspace-skills-dir.js";
+import { loadSkills, loadWorkspaceSkillInventory } from "../agent/skills/index.js";
 import { pullSkillFromSource } from "../agent/skills/hub-pull.js";
 import { downloadFromMarketplace } from "../agent/skills/skills-marketplace.js";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";

package/dist/src/providers/model-call.d.ts

@@ -1,5 +1,6 @@
 import { type Api, type AssistantMessage, type Context, type Model, type SimpleStreamOptions } from '@earendil-works/pi-ai/compat';
 import type { CredentialResolverOptions } from '../auth/credentials.js';
+import type { AiUsageContext } from '../usage/types.js';
 export declare function isLocalModelBaseUrl(baseUrl: string | undefined): boolean;
 /** Codex Responses rejects the temperature request parameter. */
 export declare function supportsModelTemperature(model: Model<Api>): boolean;
@@ -8,10 +9,10 @@ export declare function resolveModelCallOptions(model: Model<Api>, options?: Sim
 /**
  * Complete a one-shot request with xopc credential resolution and extension-provider routing.
  */
-export declare function completeWithResolvedCredentials(model: Model<Api>, context: Context, options?: SimpleStreamOptions, credentialOptions?: CredentialResolverOptions): Promise<AssistantMessage>;
+export declare function completeWithResolvedCredentials(model: Model<Api>, context: Context, options: SimpleStreamOptions, credentialOptions: CredentialResolverOptions | undefined, usageContext: AiUsageContext): Promise<AssistantMessage>;
 /**
  * Start a model stream with xopc credential resolution and extension-provider routing.
  * Callers that need live visible output should consume the returned stream before calling
  * its `result()` method.
  */
-export declare function createResolvedModelStream(model: Model<Api>, context: Context, options?: SimpleStreamOptions, credentialOptions?: CredentialResolverOptions): Promise<import("@earendil-works/pi-ai/compat").AssistantMessageEventStream>;
+export declare function createResolvedModelStream(model: Model<Api>, context: Context, options: SimpleStreamOptions, credentialOptions: CredentialResolverOptions | undefined, usageContext: AiUsageContext): Promise<import("@earendil-works/pi-ai/compat").AssistantMessageEventStream>;

package/dist/src/providers/model-call.js

@@ -1,6 +1,7 @@
 import { init_constants } from "./constants.js";
 import { getApiKey, init_providers } from "./index.js";
 import { createExtensionAwareStreamFn } from "./extension-stream-bridge.js";
+import { finishAiUsageFromMessage, observeAiUsageStream, startAiUsageCall } from "../usage/recorder.js";
 import { completeSimple, normalizeContext } from "@earendil-works/pi-ai/compat";
 //#region src/providers/model-call.ts
 init_constants();
@@ -40,19 +41,43 @@ async function resolveModelCallOptions(model, options = {}, credentialOptions) {
 /**
 * Complete a one-shot request with xopc credential resolution and extension-provider routing.
 */
-async function completeWithResolvedCredentials(model, context, options = {}, credentialOptions) {
+async function completeWithResolvedCredentials(model, context, options, credentialOptions, usageContext) {
 	const resolvedOptions = await resolveModelCallOptions(model, options, credentialOptions);
-	if (model.baseUrl === "extension://provider-plugin") return await (await createExtensionAwareStreamFn()(model, normalizeContext(context), resolvedOptions)).result();
-	return await completeSimple(model, context, resolvedOptions);
+	const usageCall = startAiUsageCall(model, usageContext);
+	try {
+		if (model.baseUrl === "extension://provider-plugin") {
+			const result = await (await createExtensionAwareStreamFn()(model, normalizeContext(context), resolvedOptions)).result();
+			finishAiUsageFromMessage(usageCall, result);
+			return result;
+		}
+		const result = await completeSimple(model, context, resolvedOptions);
+		finishAiUsageFromMessage(usageCall, result);
+		return result;
+	} catch (error) {
+		usageCall?.finish({
+			status: "failed",
+			errorSummary: error instanceof Error ? error.message : String(error)
+		});
+		throw error;
+	}
 }
 /**
 * Start a model stream with xopc credential resolution and extension-provider routing.
 * Callers that need live visible output should consume the returned stream before calling
 * its `result()` method.
 */
-async function createResolvedModelStream(model, context, options = {}, credentialOptions) {
+async function createResolvedModelStream(model, context, options, credentialOptions, usageContext) {
 	const resolvedOptions = await resolveModelCallOptions(model, options, credentialOptions);
-	return await createExtensionAwareStreamFn()(model, normalizeContext(context), resolvedOptions);
+	const usageCall = startAiUsageCall(model, usageContext);
+	try {
+		return observeAiUsageStream(await createExtensionAwareStreamFn()(model, normalizeContext(context), resolvedOptions), usageCall);
+	} catch (error) {
+		usageCall?.finish({
+			status: "failed",
+			errorSummary: error instanceof Error ? error.message : String(error)
+		});
+		throw error;
+	}
 }
 //#endregion
 export { completeWithResolvedCredentials, createResolvedModelStream, isLocalModelBaseUrl, resolveModelCallApiKey, resolveModelCallOptions, supportsModelTemperature };

package/dist/src/providers/model-catalog-persistence.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveXopcCloudCatalogCachePath } from "../config/paths-state.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { readFileSync, rmSync } from "node:fs";

package/dist/src/scenes/activationAdapter.d.ts

@@ -0,0 +1,19 @@
+import type { ScenePrincipal, SceneTemplate } from './contracts.js';
+/** Extension point for activation shapes that need more than the core read-only setup. */
+export interface SceneActivationAdapter {
+    id: string;
+    preflight(principal: ScenePrincipal, template: SceneTemplate, configuration: unknown): Promise<{
+        ready: boolean;
+        missing: string[];
+    }>;
+    create(principal: ScenePrincipal, template: SceneTemplate, configuration: unknown): Promise<unknown>;
+    get(principal: ScenePrincipal, activationId: string): unknown;
+    configure(principal: ScenePrincipal, activationId: string, expectedRevision: number, configuration: unknown): Promise<unknown>;
+    transition(principal: ScenePrincipal, activationId: string, expectedRevision: number, status: 'active' | 'paused' | 'archived'): Promise<unknown>;
+    tick(): Promise<void>;
+    stop(): Promise<void>;
+    executeTask?(runId: string, conversationId: string): Promise<boolean>;
+    allowsTaskNotification?(taskId: string): boolean;
+    listProjectBranches?(principal: ScenePrincipal, projectId: string): Promise<unknown>;
+    associateBranch?(principal: ScenePrincipal, input: unknown): Promise<unknown>;
+}

package/dist/src/scenes/activationAdapter.js

@@ -0,0 +1 @@
+export {};