@xopcai/xopc 0.0.426 → 0.0.427

package/dist/src/agent/tools/xopc-use-tool.js

@@ -20,19 +20,20 @@ import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { getAutomationSetup } from "../../automations/configuration-conversation.js";
 import { getEmbeddedExecutionRunId } from "../embedded/execution-context.js";
 import "../../capabilities/runtime/dispatcher.js";
+import { AutomationMcpSourceInput, prepareAutomationMcpSource } from "../../automations/mcp-source.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
-import "../../projects/index.js";
-import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
-import { defineTaskContract } from "../../tasks/task-contract-definition.js";
-import { resolveResponseLanguageForSession } from "../prompt/response-language.js";
 import { TaskDeletionService } from "../../tasks/task-deletion-service.js";
 import { TaskDeleteOutputSchema } from "../../tasks/capabilities/management.js";
+import "../../projects/index.js";
 import { parseTaskHandoffReferences } from "../../tasks/task-handoff.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { AutomationCreateCapabilityInputSchema, AutomationUpdatePatchSchema } from "../../automations/capabilities/write.js";
+import { resolveResponseLanguageForSession } from "../prompt/response-language.js";
 import { TaskMutationOutputSchema } from "../../tasks/capabilities/write.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { localAppCapabilities } from "../../local-apps/capabilities/runtime.js";
+import { defineTaskContract } from "../../tasks/task-contract-definition.js";
 import "../../tasks/index.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
@@ -53,9 +54,10 @@ const XopcUseToolSchema = Type.Object({
 		Type.Literal("agent"),
 		Type.Literal("settings"),
 		Type.Literal("browser_setup"),
-		Type.Literal("phone_setup")
+		Type.Literal("phone_setup"),
+		Type.Literal("mcp_setup")
 	]),
-	command: Type.String({ description: "Context resolve takes an explicit AppContextEnvelope; never guess a current page. Automation draft/repair_draft accept prompt/id, agentId?, language?, idempotencyKey?; simulate explains an automation without running it. Local_app record_acceptance records supplied checks and sourceHash, not proof that checks were executed. Agent profile-only changes: patch_profile {id, expectedRevision, patch:{name?,description?,style?,language?,...}, idempotencyKey?} preserves omitted fields. Agent commands: list, get {id}, create {id, profile, workspace?, models?, skills?, tools?, runtime?, idempotencyKey?}, update {id, expectedRevision, patch, idempotencyKey?}, set_default {id, expectedRevision, idempotencyKey?}, disable/delete/purge {id, expectedRevision, idempotencyKey?}. Purge also removes on-disk data. Project create accepts idempotencyKey; update/pin/unpin/delete accepts {projectId, expectedVersion?, idempotencyKey?}; stable retries require the original expectedVersion. Delete preserves workspace files and does not confirm external execution stopped. Project milestone writes support idempotencyKey; update_milestone/delete_milestone require original expectedRevision for stable retries, and create_update requires original expectedVersion. TaskRun cancel accepts idempotencyKey and expectedVersion, and does not confirm external execution stopped. Automation diagnostics: get_run/run_events {runId}, metrics {}, events {eventType?, source?, limit?}, deliveries {runId?, limit?}, product_events {eventType, source?, payloadKey?, payloadValue?, limit?}; payload filters require both key and value. Recovery commands: replay_event {eventId, reason, idempotencyKey}, retry_delivery {runId, destinationKey, reason, idempotencyKey}. Automation also supports cancel/read {runId, idempotencyKey?} and read_all {projectId?, idempotencyKey?}; omitted projectId means all projects. Cancel acceptance is not confirmation of stopping. Object command. Supports project list/get/create/update/resolve_workspace/list_milestones/create_milestone/update_milestone/list_updates/create_update, automation list/get/create/update/delete/run/rerun/pause/resume/history (rerun takes runId; run/rerun accept idempotencyKey), note list/get/project_summaries/history {noteId}/snapshot {noteId, timestamp}/create/append/update/preview_edit/delete, task list/get/create/update_dependencies/add_context/remove_context/command/delete, task_run list/get/cancel, chat_preview create/revise/get, local_app list/get/create/validate, and settings open." }),
+	command: Type.String({ description: "HTTP MCP configuration: mode mcp_setup inspect/start/get/advance/cancel/set_enabled/remove; load tool_manual topic mcp. Never pass credentials or OAuth callbacks as tool arguments. Context resolve takes an explicit AppContextEnvelope; never guess a current page. Automation draft/repair_draft accept prompt/id, agentId?, language?, idempotencyKey?; simulate explains an automation without running it. Local_app record_acceptance records supplied checks and sourceHash, not proof that checks were executed. Agent profile-only changes: patch_profile {id, expectedRevision, patch:{name?,description?,style?,language?,...}, idempotencyKey?} preserves omitted fields. Agent commands: list, get {id}, create {id, profile, workspace?, models?, skills?, tools?, runtime?, idempotencyKey?}, update {id, expectedRevision, patch, idempotencyKey?}, set_default {id, expectedRevision, idempotencyKey?}, disable/delete/purge {id, expectedRevision, idempotencyKey?}. Purge also removes on-disk data. Project create accepts idempotencyKey; update/pin/unpin/delete accepts {projectId, expectedVersion?, idempotencyKey?}; stable retries require the original expectedVersion. Delete preserves workspace files and does not confirm external execution stopped. Project milestone writes support idempotencyKey; update_milestone/delete_milestone require original expectedRevision for stable retries, and create_update requires original expectedVersion. TaskRun cancel accepts idempotencyKey and expectedVersion, and does not confirm external execution stopped. Automation diagnostics: get_run/run_events {runId}, metrics {}, events {eventType?, source?, limit?}, deliveries {runId?, limit?}, product_events {eventType, source?, payloadKey?, payloadValue?, limit?}; payload filters require both key and value. Recovery commands: replay_event {eventId, reason, idempotencyKey}, retry_delivery {runId, destinationKey, reason, idempotencyKey}. Automation also supports cancel/read {runId, idempotencyKey?} and read_all {projectId?, idempotencyKey?}; omitted projectId means all projects. Cancel acceptance is not confirmation of stopping. Object command. Supports project list/get/create/update/resolve_workspace/list_milestones/create_milestone/update_milestone/list_updates/create_update, automation list/get/create/update/delete/run/rerun/pause/resume/history (rerun takes runId; run/rerun accept idempotencyKey), note list/get/project_summaries/history {noteId}/snapshot {noteId, timestamp}/create/append/update/preview_edit/delete, task list/get/create/update_dependencies/add_context/remove_context/command/delete, task_run list/get/cancel, chat_preview create/revise/get, local_app list/get/create/validate, and settings open." }),
 	args: Type.Optional(Type.Record(Type.String(), Type.Any())),
 	dryRun: Type.Optional(Type.Boolean({ description: "Validate and preview the action without mutating xopc state." }))
 });
@@ -743,7 +745,7 @@ async function handleProject(command, args, deps, dryRun, capabilities) {
 		error: `Unsupported project command: ${command}`
 	};
 }
-async function handleAutomation(command, args, deps, dryRun, capabilities) {
+async function handleAutomation(command, args, deps, dryRun, capabilities, toolCallId) {
 	const automations = deps.getAutomationService?.();
 	if (!automations) return {
 		ok: false,
@@ -760,7 +762,7 @@ async function handleAutomation(command, args, deps, dryRun, capabilities) {
 		try {
 			return (operation === "xopc.automations.delete" ? AutomationDeleteOutputSchema : operation === "xopc.automations.cancel" ? AutomationCancelOutputSchema : operation === "xopc.automations.read" ? AutomationReadOutputSchema : operation === "xopc.automations.read_all" ? AutomationReadAllOutputSchema : operation === "xopc.automations.replay_event" || operation === "xopc.automations.retry_delivery" ? AutomationRecoveryOutputSchema : operation === "xopc.automations.run" || operation === "xopc.automations.rerun" ? AutomationRunMutationOutputSchema : AutomationMutationOutputSchema).parse(await capabilities.call(operation, input, caller, {
 				...capabilities.describe(operation, caller),
-				idempotencyKey: trimString(args.idempotencyKey) ?? randomUUID()
+				idempotencyKey: trimString(args.idempotencyKey) ?? toolCallId
 			}));
 		} catch (error) {
 			if (error instanceof CapabilityError) return {
@@ -1937,6 +1939,50 @@ function createXopcUseTool(deps) {
 				dryRun
 			};
 			if (!command) return errorText("command is required", details);
+			if (mode === "mcp_setup") {
+				const service = deps.getMcpSetupService?.();
+				const conversationId = deps.getCurrentConversationId?.();
+				const agentId = deps.getCurrentAgentId?.();
+				if (!service || !conversationId || !agentId) return errorText("MCP setup requires a Gateway conversation.", details);
+				if (deps.authorizeCapability && !await deps.authorizeCapability(`xopc.mcp_setup.${command}`, args)) return errorText("MCP setup access denied", details);
+				try {
+					return okText({
+						...details,
+						result: await service.command(command, args, {
+							conversationId,
+							agentId,
+							canConfigure: deps.canConfigureFromConversation?.() === true,
+							canRequestWeixinSetup: deps.canRequestWeixinMcpSetup?.() === true
+						}, dryRun)
+					});
+				} catch (error) {
+					return errorText(error instanceof Error ? error.message : String(error), details);
+				}
+			}
+			if (mode === "automation" && command === "prepare_source") {
+				const config = deps.getConfig?.();
+				if (!config || !deps.getWorkspace) return errorText("MCP source preparation is unavailable in this runtime.", details);
+				if (deps.authorizeCapability && !await deps.authorizeCapability("xopc.automations.prepare_source", args)) return errorText("Source preparation denied", details);
+				const input = AutomationMcpSourceInput.parse(args);
+				if (dryRun) return okText({
+					...details,
+					result: {
+						dryRun: true,
+						...input
+					}
+				});
+				return okText({
+					...details,
+					result: await prepareAutomationMcpSource(input, {
+						conversationId: deps.getCurrentConversationId?.(),
+						agentId: deps.getCurrentAgentId?.(),
+						canConfigure: deps.canConfigureFromConversation?.() === true,
+						workspaceDir: deps.getWorkspace(),
+						readConfig: () => deps.getConfig?.() ?? config,
+						signal
+					})
+				});
+			}
 			if (mode === "phone_setup") {
 				const service = deps.getPhoneSetupService?.();
 				const conversationId = deps.getCurrentConversationId?.();
@@ -1950,6 +1996,7 @@ function createXopcUseTool(deps) {
 							conversationId,
 							agentId,
 							canConfigure: deps.canConfigureFromConversation?.() === true,
+							isAuthorized: deps.canConfigureFromConversation,
 							runId: getEmbeddedExecutionRunId()
 						}, dryRun)
 					});
@@ -2155,7 +2202,10 @@ function createXopcUseTool(deps) {
 					payloadKey: args.payloadKey,
 					payloadValue: args.payloadValue,
 					limit: args.limit
-				} : { id: args.runId ?? args.id };
+				} : {
+					id: args.runId ?? args.id,
+					...command === "get_run" && args.waitMs !== void 0 ? { waitMs: args.waitMs } : {}
+				};
 				const caller = {
 					principalId: `agent:${deps.getCurrentAgentId?.() ?? "main"}`,
 					surface: "agent",
@@ -2315,7 +2365,7 @@ function createXopcUseTool(deps) {
 						kind: "xopc_use",
 						toolCallId
 					}
-				}, async () => mode === "agent" ? await handleAgent(command, args, dryRun, capabilities, deps, toolCallId, signal) : mode === "project" ? await handleProject(command, args, deps, dryRun, capabilities) : mode === "automation" ? await handleAutomation(command, args, deps, dryRun, capabilities) : mode === "note" ? await handleNote(command, args, deps, dryRun, capabilities) : mode === "task" ? await handleTask(command, args, deps, dryRun, capabilities) : mode === "task_run" ? await handleTaskRun(command, args, dryRun, deps, capabilities) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "chat_preview" ? await handleChatPreview(command, args, deps, dryRun) : {
+				}, async () => mode === "agent" ? await handleAgent(command, args, dryRun, capabilities, deps, toolCallId, signal) : mode === "project" ? await handleProject(command, args, deps, dryRun, capabilities) : mode === "automation" ? await handleAutomation(command, args, deps, dryRun, capabilities, toolCallId) : mode === "note" ? await handleNote(command, args, deps, dryRun, capabilities) : mode === "task" ? await handleTask(command, args, deps, dryRun, capabilities) : mode === "task_run" ? await handleTaskRun(command, args, dryRun, deps, capabilities) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "chat_preview" ? await handleChatPreview(command, args, deps, dryRun) : {
 					ok: false,
 					error: `Unsupported mode: ${String(mode)}`
 				});

package/dist/src/agent-catalog/service.d.ts

@@ -9,7 +9,7 @@ export declare class AgentCatalogService {
     resumePendingProvisioning(): Promise<void>;
     /** Startup recovery for catalog rows committed before their directories were provisioned. */
     resumePendingProvisioningSync(): void;
-    update(agentIdRaw: string, patch: Partial<Omit<AgentEntry, 'id'>>, expectedRevision?: number): Promise<StoredAgent>;
+    update(agentIdRaw: string, patch: Partial<Omit<AgentEntry, 'id'>>, expectedRevision?: number, beforeCommit?: () => void): Promise<StoredAgent>;
     /** Remove data for an Agent that has already been deleted from the catalog. */
     purgeEntryData(entry: AgentEntry, defaultAgentId: string): Promise<void>;
     validatePurgeEntry(entry: AgentEntry, defaultAgentId: string): void;

package/dist/src/agent-catalog/service.js

@@ -59,7 +59,7 @@ var AgentCatalogService = class {
 		}
 		this.resumePendingPurgeSync();
 	}
-	async update(agentIdRaw, patch, expectedRevision) {
+	async update(agentIdRaw, patch, expectedRevision, beforeCommit) {
 		const agentId = normalizeAgentId(agentIdRaw);
 		const current = this.repository.get(agentId);
 		if (!current) throw new Error(`Agent "${agentId}" not found`);
@@ -71,6 +71,7 @@ var AgentCatalogService = class {
 			id: agentId
 		};
 		await this.provision(next);
+		beforeCommit?.();
 		return this.repository.update(agentId, revision, next);
 	}
 	/** Remove data for an Agent that has already been deleted from the catalog. */

package/dist/src/automations/capabilities/drafts.js

@@ -7,7 +7,7 @@ import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError } from "../../capabilities/runtime/external-operations.js";
 import { defineExternalCapability, defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
-import { AutomationCreateCapabilityInputSchema } from "./write.js";
+import { AutomationCreateCapabilityInputSchema, materializeAutomationTrigger } from "./write.js";
 import { simulateAutomation } from "../draft/automation-draft-validator.js";
 import { AutomationDraftService } from "../draft/automation-draft-service.js";
 import "../draft/index.js";
@@ -39,7 +39,10 @@ function registerAutomationDraftCapabilities(dispatcher, service, getConfig) {
 		output: z.object({ simulation: AutomationSimulationSchema }),
 		execute(input) {
 			try {
-				return { simulation: simulateAutomation(input) };
+				return { simulation: simulateAutomation({
+					...input,
+					trigger: materializeAutomationTrigger(input.trigger)
+				}) };
 			} catch (error) {
 				throw new CapabilityError("INVALID_INPUT", error instanceof Error ? error.message : "Invalid automation");
 			}

package/dist/src/automations/capabilities/read.js

@@ -2,6 +2,7 @@ import { ProductReadContracts } from "../../../packages/gateway-contract/src/cap
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
+import { setTimeout } from "node:timers/promises";
 //#region src/automations/capabilities/read.ts
 init_src();
 function registerAutomationReadCapabilities(dispatcher, service, projects) {
@@ -23,13 +24,23 @@ function registerAutomationReadCapabilities(dispatcher, service, projects) {
 		id: "xopc.automations.get_run",
 		description: "Read current run state rather than the historical submission receipt.",
 		...ProductReadContracts["xopc.automations.get_run"],
-		async execute({ id }) {
-			const run = await service.getRun(id);
-			if (!run) throw new CapabilityError("NOT_FOUND", "Run not found");
-			return {
-				ok: true,
-				run: { ...run }
-			};
+		async execute({ id, waitMs }, context) {
+			const deadline = Date.now() + (waitMs ?? 0);
+			for (;;) {
+				context.signal?.throwIfAborted();
+				const run = await service.getRun(id);
+				if (!run) throw new CapabilityError("NOT_FOUND", "Run not found");
+				const remaining = deadline - Date.now();
+				if (![
+					"queued",
+					"running",
+					"cancelling"
+				].includes(run.status) || remaining <= 0) return {
+					ok: true,
+					run: { ...run }
+				};
+				await setTimeout(Math.min(250, remaining), void 0, { signal: context.signal });
+			}
 		}
 	}));
 	dispatcher.register(defineReadCapability({

package/dist/src/automations/capabilities/write.d.ts

@@ -1,7 +1,41 @@
 import { z } from 'zod';
 import { type CapabilityDispatcher } from '../../capabilities/runtime/dispatcher.js';
 import { type AutomationService } from '../service/automation-service.js';
+import type { AutomationTrigger } from '../domain/types.js';
 import type { ProjectService } from '../../projects/project-service.js';
+declare const triggerRequest: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"manual">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"schedule">;
+    schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"once">;
+        at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"interval">;
+        everyMs: z.ZodNumber;
+        anchorMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"cron">;
+        expr: z.ZodString;
+        tz: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"webhook">;
+    secretId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"event">;
+    eventType: z.ZodString;
+    source: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+    payloadMatch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+}, z.core.$strict>], "kind">, z.ZodObject<{
+    kind: z.ZodLiteral<"schedule">;
+    schedule: z.ZodObject<{
+        kind: z.ZodLiteral<"once">;
+        afterMs: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+/** Anchor a relative one-time intent inside the receipt's single atomic execution. */
+export declare function materializeAutomationTrigger(trigger: z.infer<typeof triggerRequest>): AutomationTrigger;
 export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
     projectId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
     name: z.ZodString;
@@ -10,6 +44,7 @@ export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
         kind: z.ZodLiteral<"agent">;
         agentId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
         instruction: z.ZodString;
+        mcpSourceId: z.ZodOptional<z.ZodString>;
         workingDirectory: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
         model: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
@@ -123,31 +158,6 @@ export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
     }, z.core.$strict>], "kind">;
     id: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
     description: z.ZodOptional<z.ZodString>;
-    trigger: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"manual">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"schedule">;
-        schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"once">;
-            at: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"interval">;
-            everyMs: z.ZodNumber;
-            anchorMs: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"cron">;
-            expr: z.ZodString;
-            tz: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
-        }, z.core.$strict>], "kind">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"webhook">;
-        secretId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"event">;
-        eventType: z.ZodString;
-        source: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
-        payloadMatch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
-    }, z.core.$strict>], "kind">;
     delivery: z.ZodDefault<z.ZodObject<{
         notificationPolicy: z.ZodDefault<z.ZodEnum<{
             attention: "attention";
@@ -157,6 +167,11 @@ export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
         destinations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             key: z.ZodString;
             kind: z.ZodLiteral<"gateway_event">;
+        }, z.core.$strict>, z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodLiteral<"weixin">;
+            conversationId: z.ZodString;
+            principalId: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
             key: z.ZodString;
             kind: z.ZodLiteral<"webhook">;
@@ -191,8 +206,72 @@ export declare const AutomationCreateCapabilityInputSchema: z.ZodObject<{
         maxConcurrentRuns: z.ZodOptional<z.ZodNumber>;
         disableAfterConsecutiveFailures: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
+    trigger: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"manual">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"once">;
+            at: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"interval">;
+            everyMs: z.ZodNumber;
+            anchorMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"cron">;
+            expr: z.ZodString;
+            tz: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"webhook">;
+        secretId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        eventType: z.ZodString;
+        source: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+        payloadMatch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, z.core.$strict>], "kind">, z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        schedule: z.ZodObject<{
+            kind: z.ZodLiteral<"once">;
+            afterMs: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>;
 }, z.core.$strict>;
 export declare const AutomationUpdatePatchSchema: z.ZodObject<{
+    trigger: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"manual">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"once">;
+            at: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"interval">;
+            everyMs: z.ZodNumber;
+            anchorMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"cron">;
+            expr: z.ZodString;
+            tz: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"webhook">;
+        secretId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"event">;
+        eventType: z.ZodString;
+        source: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
+        payloadMatch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, z.core.$strict>], "kind">, z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        schedule: z.ZodObject<{
+            kind: z.ZodLiteral<"once">;
+            afterMs: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>>;
+    state: z.ZodOptional<z.ZodNever>;
+    management: z.ZodOptional<z.ZodNever>;
     projectId: z.ZodOptional<z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>>;
     name: z.ZodOptional<z.ZodString>;
     enabled: z.ZodOptional<z.ZodBoolean>;
@@ -200,6 +279,7 @@ export declare const AutomationUpdatePatchSchema: z.ZodObject<{
         kind: z.ZodLiteral<"agent">;
         agentId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
         instruction: z.ZodString;
+        mcpSourceId: z.ZodOptional<z.ZodString>;
         workingDirectory: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
         model: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
@@ -312,31 +392,6 @@ export declare const AutomationUpdatePatchSchema: z.ZodObject<{
         }>;
     }, z.core.$strict>], "kind">>;
     description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-    trigger: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"manual">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"schedule">;
-        schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"once">;
-            at: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"interval">;
-            everyMs: z.ZodNumber;
-            anchorMs: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"cron">;
-            expr: z.ZodString;
-            tz: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
-        }, z.core.$strict>], "kind">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"webhook">;
-        secretId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"event">;
-        eventType: z.ZodString;
-        source: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string>>;
-        payloadMatch: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
-    }, z.core.$strict>], "kind">>;
     safety: z.ZodOptional<z.ZodOptional<z.ZodObject<{
         mode: z.ZodEnum<{
             suggest_only: "suggest_only";
@@ -363,6 +418,11 @@ export declare const AutomationUpdatePatchSchema: z.ZodObject<{
         destinations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             key: z.ZodString;
             kind: z.ZodLiteral<"gateway_event">;
+        }, z.core.$strict>, z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodLiteral<"weixin">;
+            conversationId: z.ZodString;
+            principalId: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
             key: z.ZodString;
             kind: z.ZodLiteral<"webhook">;
@@ -380,7 +440,6 @@ export declare const AutomationUpdatePatchSchema: z.ZodObject<{
             templateId: z.ZodString;
         }, z.core.$strict>], "kind">>>;
     }, z.core.$strict>>>;
-    state: z.ZodOptional<z.ZodNever>;
-    management: z.ZodOptional<z.ZodNever>;
 }, z.core.$strict>;
 export declare function registerAutomationWriteCapabilities(dispatcher: CapabilityDispatcher, service: AutomationService, projects?: ProjectService): void;
+export {};

package/dist/src/automations/capabilities/write.js

@@ -1,7 +1,7 @@
 import { AutomationCancelOutputSchema, AutomationDeleteInputSchema, AutomationDeleteOutputSchema, AutomationMutationOutputSchema, AutomationReadAllInputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRecoveryOutputSchema, AutomationReplayEventInputSchema, AutomationRetryDeliveryInputSchema, AutomationRunMutationOutputSchema, AutomationSetEnabledInputSchema, CapabilityResourceInputSchema } 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 { CreateAutomationSchema, UpdateAutomationSchema } from "../domain/validation.js";
+import { AutomationTriggerSchema, CreateAutomationSchema, UpdateAutomationSchema } from "../domain/validation.js";
 import { getAutomation } from "../storage/automation-repository.js";
 import { getAutomationRun, markAllAutomationRunsRead, markAutomationRunRead } from "../storage/automation-run-repository.js";
 import "../storage/index.js";
@@ -9,18 +9,43 @@ import { getAutomationEventForRun } from "../events/event-repository.js";
 import "../events/index.js";
 import { assertAutomationSetupTarget, bindAutomationSetup } from "../configuration-conversation.js";
 import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
-import { AutomationAlreadyExistsError, AutomationAlreadyRunningError, AutomationInvalidAgentError, AutomationInvalidScheduleError } from "../service/automation-service.js";
+import { AutomationAlreadyExistsError, AutomationAlreadyRunningError, AutomationInvalidAgentError, AutomationInvalidScheduleError, AutomationInvalidSourceError } from "../service/automation-service.js";
 import { z } from "zod";
 //#region src/automations/capabilities/write.ts
 init_src();
+const triggerRequest = z.union([AutomationTriggerSchema, z.object({
+	kind: z.literal("schedule"),
+	schedule: z.object({
+		kind: z.literal("once"),
+		afterMs: z.number().int().min(1).max(366 * 864e5)
+	}).strict()
+}).strict()]);
+/** Anchor a relative one-time intent inside the receipt's single atomic execution. */
+function materializeAutomationTrigger(trigger) {
+	if (trigger.kind !== "schedule") return trigger;
+	const schedule = trigger.schedule;
+	return "afterMs" in schedule ? {
+		kind: "schedule",
+		schedule: {
+			kind: "once",
+			at: new Date(Date.now() + schedule.afterMs).toISOString()
+		}
+	} : {
+		kind: "schedule",
+		schedule
+	};
+}
 const AutomationCreateCapabilityInputSchema = CreateAutomationSchema.omit({
 	state: true,
-	management: true
-}).refine((input) => input.action.kind !== "system", { message: "System actions can only be created by the runtime" });
-const AutomationUpdatePatchSchema = UpdateAutomationSchema.safeExtend({
+	management: true,
+	trigger: true
+}).extend({ trigger: triggerRequest }).refine((input) => input.action.kind !== "system", { message: "System actions can only be created by the runtime" });
+const AutomationUpdatePatchSchema = z.object({
+	...UpdateAutomationSchema.shape,
+	trigger: triggerRequest.optional(),
 	state: z.never().optional(),
 	management: z.never().optional()
-});
+}).strict().refine((data) => Object.keys(data).length > 0, { message: "At least one field must be provided" });
 function assertManagedOperation(automation, operation, patch) {
 	const management = automation.management;
 	if (!management) return;
@@ -39,7 +64,7 @@ function validateSchedule(operation) {
 	try {
 		return operation();
 	} catch (error) {
-		if (error instanceof AutomationInvalidScheduleError || error instanceof AutomationInvalidAgentError) throw new CapabilityError("INVALID_INPUT", error.message);
+		if (error instanceof AutomationInvalidScheduleError || error instanceof AutomationInvalidAgentError || error instanceof AutomationInvalidSourceError) throw new CapabilityError("INVALID_INPUT", error.message);
 		throw error;
 	}
 }
@@ -198,7 +223,11 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 			requireProject(input.projectId);
 			assertAutomationSetupTarget(context.conversationId);
 			try {
-				const automation = validateSchedule(() => service.createAtomically(input));
+				const automation = validateSchedule(() => service.createAtomically({
+					...input,
+					delivery: service.bindConversationDelivery(context.conversationId, input.delivery),
+					trigger: materializeAutomationTrigger(input.trigger)
+				}));
 				bindAutomationSetup(context.conversationId, automation.id);
 				return {
 					ok: true,
@@ -226,9 +255,14 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 			if (current.updatedAtMs !== expectedRevision) throw new CapabilityError("REVISION_CONFLICT", "Automation changed");
 			assertManagedOperation(current, "update", patch);
 			requireProject(patch.projectId);
+			const { trigger, ...fields } = patch;
 			return {
 				ok: true,
-				automation: { ...validateSchedule(() => service.updateAtomically(id, patch)) }
+				automation: { ...validateSchedule(() => service.updateAtomically(id, {
+					...fields,
+					...fields.delivery ? { delivery: service.bindConversationDelivery(context.conversationId, fields.delivery) } : {},
+					...trigger ? { trigger: materializeAutomationTrigger(trigger) } : {}
+				})) }
 			};
 		}
 	}));
@@ -258,4 +292,4 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 	}));
 }
 //#endregion
-export { AutomationCreateCapabilityInputSchema, AutomationUpdatePatchSchema, registerAutomationWriteCapabilities };
+export { AutomationCreateCapabilityInputSchema, AutomationUpdatePatchSchema, materializeAutomationTrigger, registerAutomationWriteCapabilities };

package/dist/src/automations/delivery/delivery-router.d.ts

@@ -27,6 +27,7 @@ export declare class AutomationDeliveryRouter {
     private readonly owner;
     private readonly abortController;
     constructor(options?: {
+        deliverWeixin?: (conversationId: string, principalId: string, run: AutomationRun) => Promise<void>;
         deliverGatewayEvent?: (run: AutomationRun, context: AutomationRunDeliveryContext) => void | Promise<void>;
         onDeadLetter?: (input: {
             phase: 'result_delivery';

package/dist/src/automations/delivery/delivery-router.js

@@ -123,6 +123,11 @@ var AutomationDeliveryRouter = class {
 				...typeof config.projectId === "string" ? { projectId: config.projectId } : {}
 			});
 		});
+		this.register("weixin", ({ run, config }) => {
+			if (config.notificationPolicy === "none" || config.notificationPolicy === "attention" && !config.requiresAttention) return;
+			if (!this.options.deliverWeixin) throw new Error("Weixin delivery is unavailable. Delivery will retry.");
+			return this.options.deliverWeixin(String(config.conversationId), String(config.principalId), run);
+		});
 		this.register("webhook", (input) => this.postWebhook(input));
 	}
 	register(kind, handler) {
@@ -157,7 +162,8 @@ var AutomationDeliveryRouter = class {
         next_attempt_at_ms, created_at_ms, updated_at_ms
       ) VALUES (?, ?, ?, ?, 'pending', ?, 0, ?, ?, ?)`);
 			for (const destination of destinations) {
-				const config = destination.kind === "gateway_event" ? {
+				if (destination.kind === "weixin" && (automation.delivery.notificationPolicy === "none" || automation.delivery.notificationPolicy === "attention" && run.status === "succeeded" && (automation.safety?.mode ?? "auto_apply") === "auto_apply")) continue;
+				const config = destination.kind === "gateway_event" || destination.kind === "weixin" ? {
 					...destination,
 					notificationPolicy: automation.delivery.notificationPolicy,
 					requiresAttention: run.status !== "succeeded" || (automation.safety?.mode ?? "auto_apply") !== "auto_apply",

package/dist/src/automations/domain/types.d.ts

@@ -30,6 +30,7 @@ export type AutomationAction = {
     kind: 'agent';
     agentId?: string;
     instruction: string;
+    mcpSourceId?: string;
     workingDirectory?: string;
     model?: string;
     timeoutSeconds?: number;
@@ -59,6 +60,11 @@ export type AutomationNotificationPolicy = 'attention' | 'all' | 'none';
 export type AutomationDeliveryDestination = {
     key: string;
     kind: 'gateway_event';
+} | {
+    key: string;
+    kind: 'weixin';
+    conversationId: string;
+    principalId: string;
 } | {
     key: string;
     kind: 'webhook';
@@ -312,6 +318,7 @@ export interface PrepareAutomationAgentSessionInput {
     runId: string;
 }
 export interface AutomationDeps {
+    getConfig?: () => unknown;
     agentService?: {
         sessionConfig?: {
             applyAutomationWorkingDirectory?: (conversationId: string, workingDirectory: string | undefined) => Promise<void>;
@@ -349,6 +356,7 @@ export interface AutomationDeps {
             error?: string;
         }>;
     };
+    onWeixinRunCompleted?: (conversationId: string, principalId: string, run: AutomationRun) => Promise<void>;
     onRunCompleted?: (run: AutomationRun, context: AutomationRunDeliveryContext) => void | Promise<void>;
     onEvent?: (event: AutomationEventEnvelope, signal?: AbortSignal) => void | Promise<void>;
     onReliabilityAttention?: (input: {