@xopcai/xopc 0.0.420 → 0.0.422

package/dist/src/agent/tools/automation-tool.d.ts

@@ -2,7 +2,7 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { AutomationService } from '../../automations/index.js';
 import type { ProjectService } from '../../projects/project-service.js';
 declare const AutomationToolSchema: import("@sinclair/typebox").TObject<{
-    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"rerun">, import("@sinclair/typebox").TLiteral<"cancel">, import("@sinclair/typebox").TLiteral<"read">, import("@sinclair/typebox").TLiteral<"read_all">, import("@sinclair/typebox").TLiteral<"pause">, import("@sinclair/typebox").TLiteral<"resume">, import("@sinclair/typebox").TLiteral<"history">, import("@sinclair/typebox").TLiteral<"get_run">, import("@sinclair/typebox").TLiteral<"run_events">, import("@sinclair/typebox").TLiteral<"metrics">, import("@sinclair/typebox").TLiteral<"events">, import("@sinclair/typebox").TLiteral<"deliveries">, import("@sinclair/typebox").TLiteral<"product_events">, import("@sinclair/typebox").TLiteral<"replay_event">, import("@sinclair/typebox").TLiteral<"retry_delivery">]>;
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"run">, import("@sinclair/typebox").TLiteral<"rerun">, import("@sinclair/typebox").TLiteral<"cancel">, import("@sinclair/typebox").TLiteral<"read">, import("@sinclair/typebox").TLiteral<"read_all">, import("@sinclair/typebox").TLiteral<"pause">, import("@sinclair/typebox").TLiteral<"resume">, import("@sinclair/typebox").TLiteral<"history">, import("@sinclair/typebox").TLiteral<"get_run">, import("@sinclair/typebox").TLiteral<"run_events">, import("@sinclair/typebox").TLiteral<"metrics">, import("@sinclair/typebox").TLiteral<"events">, import("@sinclair/typebox").TLiteral<"deliveries">, import("@sinclair/typebox").TLiteral<"product_events">, import("@sinclair/typebox").TLiteral<"replay_event">, import("@sinclair/typebox").TLiteral<"retry_delivery">]>;
     automationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     runId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     projectId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -21,6 +21,7 @@ declare const AutomationToolSchema: import("@sinclair/typebox").TObject<{
 }>;
 export interface AutomationToolDeps {
     getAutomationService: () => AutomationService | undefined;
+    getCurrentConversationId?: () => string | undefined;
     getCurrentAgentId?: () => string | undefined;
     getProjectService?: () => ProjectService | undefined;
 }

package/dist/src/agent/tools/automation-tool.js

@@ -1,6 +1,7 @@
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { AutomationCancelOutputSchema, AutomationDeleteOutputSchema, AutomationMutationOutputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRecoveryOutputSchema, AutomationRunMutationOutputSchema, ProductReadContracts } from "../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { getAutomationSetup } from "../../automations/configuration-conversation.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
@@ -9,6 +10,7 @@ init_src();
 const AutomationToolSchema = Type.Object({
 	action: Type.Union([
 		Type.Literal("list"),
+		Type.Literal("get"),
 		Type.Literal("create"),
 		Type.Literal("update"),
 		Type.Literal("delete"),
@@ -64,13 +66,14 @@ function formatAutomation(item) {
 	const next = item.state.nextRunAtMs ? new Date(item.state.nextRunAtMs).toISOString() : "none";
 	return `- ${item.id} · ${item.name} · ${status} · trigger=${trigger} · next=${next}`;
 }
-function automationDelivery(automation, operation) {
+function automationDelivery(automation, operation, runId) {
 	return {
 		version: 2,
 		operation,
 		primary: {
 			kind: "automation",
 			id: automation.id,
+			...runId ? { runId } : {},
 			title: automation.name,
 			summary: automation.description?.trim() || void 0,
 			status: automation.enabled ? "enabled" : "paused",
@@ -103,6 +106,7 @@ function createAutomationTool(deps) {
 				const caller = {
 					principalId: `agent:${deps.getCurrentAgentId?.() ?? "main"}`,
 					surface: "agent",
+					conversationId: deps.getCurrentConversationId?.(),
 					scopes: [scope],
 					authorize: () => true,
 					signal
@@ -114,6 +118,10 @@ function createAutomationTool(deps) {
 			};
 			const invoke = async (operation, input) => AutomationMutationOutputSchema.parse(await call(operation, input));
 			switch (params.action) {
+				case "get": {
+					const result = ProductReadContracts["xopc.automations.get"].output.parse(await call("xopc.automations.get", { id: params.automationId }, "automations.read"));
+					return textResult(JSON.stringify(result.automation), result);
+				}
 				case "list": {
 					const { items: automations } = ProductReadContracts["xopc.automations.list"].output.parse(await call("xopc.automations.list", { projectId: params.projectId }, "automations.read"));
 					return textResult(automations.length > 0 ? automations.map(formatAutomation).join("\n") : "No automations.", { automations });
@@ -130,7 +138,7 @@ function createAutomationTool(deps) {
 					const id = params.automationId?.trim();
 					if (!id) return textResult("automationId is required for update.", { ok: false });
 					if (!params.patch || typeof params.patch !== "object") return textResult("patch payload is required for update.", { ok: false });
-					if (params.idempotencyKey !== void 0 && params.expectedRevision === void 0) return textResult("Idempotent automation changes require expectedRevision from the original read.", { ok: false });
+					if ((params.idempotencyKey !== void 0 || getAutomationSetup(deps.getCurrentConversationId?.())?.automationId) && params.expectedRevision === void 0) return textResult("Idempotent automation changes require expectedRevision from the original read.", { ok: false });
 					const expectedRevision = params.expectedRevision !== void 0 ? params.expectedRevision : (await service.get(id))?.updatedAtMs;
 					if (expectedRevision === void 0) return textResult(`Automation not found: ${id}`, { ok: false });
 					const { automation } = await invoke("xopc.automations.update", {
@@ -146,7 +154,7 @@ function createAutomationTool(deps) {
 				case "delete": {
 					const id = params.automationId?.trim();
 					if (!id) return textResult("automationId is required for delete.", { ok: false });
-					if (params.idempotencyKey !== void 0 && params.expectedRevision === void 0) return textResult("Idempotent deletion requires the original expectedRevision.", { ok: false });
+					if ((params.idempotencyKey !== void 0 || getAutomationSetup(deps.getCurrentConversationId?.())?.automationId) && params.expectedRevision === void 0) return textResult("Idempotent deletion requires the original expectedRevision.", { ok: false });
 					const expectedRevision = params.expectedRevision !== void 0 ? params.expectedRevision : (await service.get(id))?.updatedAtMs ?? null;
 					const { removed } = AutomationDeleteOutputSchema.parse(await call("xopc.automations.delete", {
 						id,
@@ -192,14 +200,14 @@ function createAutomationTool(deps) {
 					const { automation, run } = AutomationRunMutationOutputSchema.parse(await call(`xopc.automations.${params.action}`, { id }));
 					return textResult(`Queued automation run ${run.id}.`, {
 						run,
-						...automation ? { delivery: automationDelivery(automation, "started") } : {}
+						...automation ? { delivery: automationDelivery(automation, "started", run.id) } : {}
 					});
 				}
 				case "pause":
 				case "resume": {
 					const id = params.automationId?.trim();
 					if (!id) return textResult(`automationId is required for ${params.action}.`, { ok: false });
-					if (params.idempotencyKey !== void 0 && params.expectedRevision === void 0) return textResult("Idempotent automation changes require expectedRevision from the original read.", { ok: false });
+					if ((params.idempotencyKey !== void 0 || getAutomationSetup(deps.getCurrentConversationId?.())?.automationId) && params.expectedRevision === void 0) return textResult("Idempotent automation changes require expectedRevision from the original read.", { ok: false });
 					const expectedRevision = params.expectedRevision !== void 0 ? params.expectedRevision : (await service.get(id))?.updatedAtMs;
 					if (expectedRevision === void 0) return textResult(`Automation not found: ${id}`, { ok: false });
 					const { automation } = await invoke("xopc.automations.set_enabled", {

package/dist/src/agent/tools/factory.js

@@ -15,13 +15,13 @@ import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { PERSONAL_REQUEST_TOOL_IDS, TASK_EXECUTION_TOOL_IDS, filterExecutionTools, resolveExecutionToolPolicy } from "../embedded/execution-tool-policy.js";
 import { getPhoneRuntime, phoneExecutionContext } from "../../phone/runtime.js";
+import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { createPhoneUseTool } from "./phone-use-tool.js";
 import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
 import { createPersonalAttentionTool } from "./personal-attention-tool.js";
 import { withCoreToolExposure } from "./toolExposure.js";
 import { markCodemodeCoreRead } from "./codemode-permissions.js";
 import "../../../packages/browser-control-contract/src/index.js";
-import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
 import { createReadFileTool } from "./read.js";
@@ -560,6 +560,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 				canAccess: () => currentAccess().crossSessionHistory
 			})] : [],
 			...this.deps.getAutomationService ? [createAutomationTool({
+				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				getAutomationService: this.deps.getAutomationService,
 				getCurrentAgentId: () => options.agentId,
 				getProjectService: this.deps.getProjectService

package/dist/src/agent/tools/personal-read-tool.js

@@ -1,7 +1,7 @@
-import { CapabilityDispatcher } from "../../capabilities/runtime/dispatcher.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
-import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
 import { getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
+import { CapabilityDispatcher } from "../../capabilities/runtime/dispatcher.js";
 import { registerNoteReadCapabilities } from "../../notes/capabilities/read.js";
 import { registerProjectReadCapabilities } from "../../projects/capabilities/read.js";
 import { registerAutomationReadCapabilities } from "../../automations/capabilities/read.js";

package/dist/src/agent/tools/personal-task-tool.js

@@ -1,5 +1,6 @@
 import { normalizeSpecialistRequirements } from "../../../packages/gateway-contract/src/specialists.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../../packages/gateway-contract/src/task-display.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { getSessionInputById, getSessionInputState, init_session_input_repository } from "../../storage/sqlite/session-input-repository.js";
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
@@ -12,7 +13,7 @@ import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { boundedPersonalResult } from "./personal-result-budget.js";
 import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
-import { PERSONAL_WORKER_RESULT_GUIDANCE } from "../../personal-agent/communication.js";
+import "../../personal-agent/communication.js";
 import { parseTaskHandoffReferences } from "../../tasks/task-handoff.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
 import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../../personal-agent/specialist-capabilities.js";

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

@@ -1,4 +1,6 @@
 import { PhoneError, PhoneInputSchema, init_contracts } from "../../phone/contracts.js";
+import { cancelPhoneAssistance, phoneResumeForRun, requirePhoneAssistance } from "../../phone/assistance.js";
+import { getEmbeddedExecutionRunId } from "../embedded/execution-context.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/phone-use-tool.ts
 init_contracts();
@@ -12,10 +14,16 @@ const Schema = Type.Object({
 		"run",
 		"status",
 		"pause",
+		"request_user",
 		"resume",
 		"cancel",
 		"close"
 	].map((value) => Type.Literal(value))),
+	reason: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 1e3,
+		description: "For request_user: explain the operation the user must complete on the phone. Saves the current task and ends this turn until explicit handback."
+	})),
 	budget: Type.Optional(Type.Object({
 		maxActions: Type.Optional(Type.Integer({
 			minimum: 1,
@@ -93,20 +101,52 @@ const Schema = Type.Object({
 	}))
 }, { additionalProperties: false });
 function createPhoneUseTool(deps) {
+	let restoredRunId;
 	return {
 		name: "phone_use",
 		label: "Phone",
 		parameters: Schema,
-		description: "Use an authorized Android phone via local ADB or a configured cloud connection. Load tool_manual for phone_use before first use. Discover registered devices, appAccess and allowedApps first. Use the defaultDeviceId returned by discover unless the user explicitly names a different phone. A phone-control conversation may bind its own defaultDeviceId. Match an explicitly named phone to its unique registered name and deviceId; ask when ambiguous and never silently switch phones; open with mode observe/control and optional authorized appPackage, observe native UI text, then discover the effective executionMode. In collaborative mode, plan with the main Agent and run one small goal at a time. In direct mode, delegate the full authorized phone goal to run and let the phone model plan locally. Keep the same taskId across fragments. Do not silently change mode or retry budget exhaustion. Inspect feedback.outcome, outputs and nextAction. Use set_mode only for an explicit user mode change; applyCurrent pauses and requires inspection/handback. Device and model configuration live in Phone Use settings. Connections originate from the Gateway host; cloud credentials are configured in phone management. Mock mode only supports the explicitly requested settings-about emulator test. Never silently switch phones, execute shell commands, bypass app restrictions, or repeat a dispatch with unknown outcome. Request user assistance for login, CAPTCHA or an effect not already authorized. Pause before manual takeover; resume re-observes. Inspect readings for information source and verification; screenshot readings are unverified observations, never proof of completion. Inspect verified, verificationLevel and stopReason before claiming success. Close finishes this task and releases operation control while keeping the phone connected. Do not close or disconnect a phone to resolve PHONE_DEVICE_BUSY; report executionStarted=false and the occupying conversation to the user, and wait for user action. Raw screenshots never enter the chat transcript.",
-		async execute(_id, raw, signal) {
+		description: "Use an authorized Android phone via local ADB or a configured cloud connection. Load tool_manual for phone_use before first use. Discover registered devices, appAccess and allowedApps first. Use the defaultDeviceId returned by discover unless the user explicitly names a different phone. A phone-control conversation may bind its own defaultDeviceId. Match an explicitly named phone to its unique registered name and deviceId; ask when ambiguous and never silently switch phones; open with mode observe/control and optional authorized appPackage, observe native UI text, then discover the effective executionMode. In collaborative mode, plan with the main Agent and run one small goal at a time. In direct mode, delegate the full authorized phone goal to run and let the phone model plan locally. Keep the same taskId across fragments. Do not silently change mode or retry budget exhaustion. Inspect feedback.outcome, outputs and nextAction. Use set_mode only for an explicit user mode change; applyCurrent pauses and requires inspection/handback. Device and model configuration live in Phone Use settings. Connections originate from the Gateway host; cloud credentials are configured in phone management. Mock mode only supports the explicitly requested settings-about emulator test. Never silently switch phones, execute shell commands, bypass app restrictions, or repeat a dispatch with unknown outcome. Request user assistance for login, CAPTCHA or an effect not already authorized. Use request_user with reason when manual assistance is needed; it saves the current task and ends this turn until explicit handback. A plain pause does not request assistance; resume re-observes. Inspect readings for information source and verification; screenshot readings are unverified observations, never proof of completion. Inspect verified, verificationLevel and stopReason before claiming success. Close finishes this task and releases operation control while keeping the phone connected. Do not close or disconnect a phone to resolve PHONE_DEVICE_BUSY; report executionStarted=false and the occupying conversation to the user, and wait for user action. Raw screenshots never enter the chat transcript.",
+		async execute(_id, raw, signal, onUpdate) {
 			const { owner, ...context } = deps.context();
+			const runId = getEmbeddedExecutionRunId();
+			if (runId) context.onNeedsUser = (checkpoint) => requirePhoneAssistance(owner, runId, _id, checkpoint).id;
 			const input = PhoneInputSchema.parse(raw);
+			const resume = runId ? phoneResumeForRun(owner, runId) : void 0;
+			if (resume && restoredRunId !== runId && (input.op === "run" || input.op === "step")) {
+				if (input.taskId && input.taskId !== resume.checkpoint.task.taskId) throw new PhoneError("PHONE_ASSISTANCE_CHANGED", "Continue the original phone task before starting another", 409);
+				Object.assign(input, resume.checkpoint.task, {
+					op: input.op,
+					taskId: resume.checkpoint.task.taskId
+				});
+			}
 			const setup = deps.getSetupService?.();
 			const setupContext = {
 				conversationId: owner,
 				agentId: context.agentId
 			};
 			const setupOwner = setup?.beforeInput(setupContext, input);
+			if (setupOwner) context.onNeedsUser = void 0;
+			let notifiedEpoch;
+			const unsubscribe = onUpdate ? deps.runtime.subscribe(setupOwner?.owner ?? owner, (report) => {
+				if (report.status !== "needs_user" || report.controlEpoch === notifiedEpoch) return;
+				notifiedEpoch = report.controlEpoch;
+				const progress = {
+					status: "needs_user",
+					sessionId: report.sessionId,
+					deviceId: report.deviceId,
+					reason: report.message,
+					nextAction: "user_takeover",
+					message: "请接管手机，完成登录、验证码等操作后点击“已完成，继续任务”，原任务会从当前页面继续。"
+				};
+				onUpdate({
+					content: [{
+						type: "text",
+						text: JSON.stringify(progress)
+					}],
+					details: progress
+				});
+			}) : void 0;
 			let result;
 			try {
 				result = setupOwner && input.op === "close" ? await deps.runtime.stop(setupOwner.owner, "close") : await deps.runtime.execute(setupOwner?.owner ?? owner, setupOwner?.input ?? input, context, signal);
@@ -128,7 +168,11 @@ function createPhoneUseTool(deps) {
 					}],
 					details: result
 				};
+			} finally {
+				unsubscribe?.();
 			}
+			if (resume && (input.op === "run" || input.op === "step")) restoredRunId = runId;
+			if (input.op === "cancel" || input.op === "close" && !resume) cancelPhoneAssistance(owner);
 			if (setupOwner) setup.afterInput(setupContext, setupOwner.owner, input.op);
 			return {
 				content: [{

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

@@ -11,14 +11,15 @@ import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import "../../storage/sqlite/index.js";
 import "../../activity/index.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import "../../capabilities/runtime/dispatcher.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { hasUnlocalizedTaskText, resolveTaskLocale } from "../../tasks/task-language.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
+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 { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
@@ -260,6 +261,7 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 				kind: "automation",
 				id,
 				title: deliveryText(source?.name) ?? "Automation",
+				runId: deliveryText(record(resultRecord.run)?.id),
 				summary: deliverySummary(source?.description),
 				status: enabled ? "enabled" : "paused",
 				revision: deliveryRevision(source?.updatedAtMs),
@@ -751,6 +753,7 @@ async function handleAutomation(command, args, deps, dryRun, capabilities) {
 		const caller = {
 			principalId: `agent:${deps.getCurrentAgentId?.() ?? "main"}`,
 			surface: "agent",
+			conversationId: deps.getCurrentConversationId?.(),
 			scopes: ["automations.write"],
 			authorize: deps.authorizeCapability ?? (() => true)
 		};
@@ -885,7 +888,7 @@ async function handleAutomation(command, args, deps, dryRun, capabilities) {
 			automationId: id,
 			patch
 		};
-		if (args.idempotencyKey !== void 0 && args.expectedRevision === void 0) return {
+		if ((args.idempotencyKey !== void 0 || getAutomationSetup(deps.getCurrentConversationId?.())?.automationId) && args.expectedRevision === void 0) return {
 			ok: false,
 			error: "Idempotent automation changes require expectedRevision from the original read"
 		};
@@ -930,7 +933,7 @@ async function handleAutomation(command, args, deps, dryRun, capabilities) {
 	};
 	if (!dryRun && command === "run") return invoke("xopc.automations.run", { id });
 	if (!dryRun && command === "delete") {
-		if (args.idempotencyKey !== void 0 && args.expectedRevision === void 0) return {
+		if ((args.idempotencyKey !== void 0 || getAutomationSetup(deps.getCurrentConversationId?.())?.automationId) && args.expectedRevision === void 0) return {
 			ok: false,
 			error: "Idempotent deletion requires the original expectedRevision"
 		};
@@ -940,7 +943,7 @@ async function handleAutomation(command, args, deps, dryRun, capabilities) {
 		});
 	}
 	if (!dryRun && (command === "pause" || command === "resume")) {
-		if (args.idempotencyKey !== void 0 && args.expectedRevision === void 0) return {
+		if ((args.idempotencyKey !== void 0 || getAutomationSetup(deps.getCurrentConversationId?.())?.automationId) && args.expectedRevision === void 0) return {
 			ok: false,
 			error: "Idempotent automation changes require expectedRevision from the original read"
 		};

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

@@ -1,10 +1,10 @@
 import { AgentEntrySchema, AgentProfileSchema, EffectiveAgentConfigSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
-import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
 import { AgentCatalogRepository, init_repository } from "./repository.js";
 import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
+import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
 import { AgentCatalogService } from "./service.js";
 import { z } from "zod";
 //#region src/agent-catalog/capabilities.ts

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

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { DEFAULT_AGENT_ID, init_id, normalizeAgentId } from "./id.js";
 import { AgentDefaultsSchema, AgentEntrySchema, DEFAULT_AGENT_MODEL_REF, DEFAULT_SKILL_POLICY } from "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { DEFAULT_AGENT_ID, init_id, normalizeAgentId } from "./id.js";
 import { BindingsSchema, init_binding_schema } from "../routing/binding-schema.js";
 import { randomUUID } from "node:crypto";
 //#region src/agent-catalog/repository.ts

package/dist/src/automations/api/routes.js

@@ -1,12 +1,15 @@
 import { AutomationCancelOutputSchema, AutomationDeleteOutputSchema, AutomationMutationOutputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRunMutationOutputSchema, ProductReadContracts } from "../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
+import { getAutomationSetup, openAutomationConfiguration } from "../configuration-conversation.js";
 import "../../capabilities/runtime/dispatcher.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { capabilityHttpContext, capabilityHttpError } from "../../capabilities/adapters/http.js";
 import { randomUUID } from "node:crypto";
 //#region src/automations/api/routes.ts
 init_src();
+init_agent_scope();
 function parseProjectId(raw) {
 	return raw?.trim() || void 0;
 }
@@ -30,6 +33,41 @@ function registerAutomationRoutes(authenticated, deps) {
 			return capabilityHttpError(c, error);
 		}
 	};
+	authenticated.post("/api/automations/configuration-conversations", async (c) => {
+		try {
+			const body = await c.req.json().catch(() => {
+				throw new CapabilityError("INVALID_INPUT", "Invalid JSON body");
+			});
+			if (!body || typeof body !== "object" || Array.isArray(body) || Object.keys(body).some((key) => ![
+				"automationId",
+				"projectId",
+				"runId"
+			].includes(key)) || body.automationId !== void 0 && typeof body.automationId !== "string" || body.projectId !== void 0 && typeof body.projectId !== "string" || body.runId !== void 0 && typeof body.runId !== "string") throw new CapabilityError("INVALID_INPUT", "Expected automationId or projectId");
+			if (body.projectId && !service.projects?.get(body.projectId)) throw new CapabilityError("NOT_FOUND", "Project not found");
+			const conversationId = openAutomationConfiguration({
+				agentId: resolveDefaultAgentId(),
+				automationId: body.automationId?.trim() || void 0,
+				projectId: body.projectId?.trim() || void 0,
+				runId: body.runId?.trim() || void 0
+			});
+			return c.json({ conversationId }, 200);
+		} catch (error) {
+			return capabilityHttpError(c, error);
+		}
+	});
+	authenticated.get("/api/automations/configuration-conversations/:conversationId", async (c) => {
+		try {
+			const setup = getAutomationSetup(c.req.param("conversationId"));
+			if (!setup) throw new CapabilityError("NOT_FOUND", "Configuration conversation not found");
+			const automation = setup.automationId ? await service.automationServiceInstance.get(setup.automationId) : null;
+			return c.json({
+				automation,
+				deleted: Boolean(setup.automationId && !automation)
+			});
+		} catch (error) {
+			return capabilityHttpError(c, error);
+		}
+	});
 	authenticated.get("/api/automations", async (c) => {
 		try {
 			const { items } = ProductReadContracts["xopc.automations.list"].output.parse(await capabilities.call("xopc.automations.list", { projectId: parseProjectId(c.req.query("projectId")) }, capabilityHttpContext(c)));

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

@@ -3,10 +3,10 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { resolveAutomationSafetyForTrust } from "../../user-context/trust-policy.js";
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import "../../storage/sqlite/index.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError } from "../../capabilities/runtime/external-operations.js";
 import { defineExternalCapability, defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { AutomationCreateCapabilityInputSchema } from "./write.js";
 import { simulateAutomation } from "../draft/automation-draft-validator.js";
 import { AutomationDraftService } from "../draft/automation-draft-service.js";

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

@@ -1,14 +1,15 @@
 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 { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
 import { 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";
 import { getAutomationEventForRun } from "../events/event-repository.js";
 import "../events/index.js";
-import { AutomationAlreadyExistsError, AutomationAlreadyRunningError } from "../service/automation-service.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 { z } from "zod";
 //#region src/automations/capabilities/write.ts
 init_src();
@@ -34,6 +35,14 @@ function assertManagedOperation(automation, operation, patch) {
 	const forbidden = Object.entries(patch ?? {}).filter(([key, value]) => JSON.stringify(automation[key]) !== JSON.stringify(value)).map(([key]) => key).filter((field) => !management.editable.includes(field));
 	if (forbidden.length > 0) throw new CapabilityError("FORBIDDEN", `Managed fields cannot be changed: ${forbidden.join(", ")}`);
 }
+function validateSchedule(operation) {
+	try {
+		return operation();
+	} catch (error) {
+		if (error instanceof AutomationInvalidScheduleError || error instanceof AutomationInvalidAgentError) throw new CapabilityError("INVALID_INPUT", error.message);
+		throw error;
+	}
+}
 function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 	const policy = {
 		majorVersion: 1,
@@ -165,7 +174,8 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 		description: "Delete an automation at an exact revision and persist cancellation intent for its active run.",
 		input: AutomationDeleteInputSchema,
 		output: AutomationDeleteOutputSchema,
-		execute({ id, expectedRevision }) {
+		execute({ id, expectedRevision }, context) {
+			assertAutomationSetupTarget(context.conversationId, id);
 			const current = getAutomation(id);
 			if (current && current.updatedAtMs !== expectedRevision) throw new CapabilityError("REVISION_CONFLICT", "Automation changed");
 			if (current) assertManagedOperation(current, "delete");
@@ -183,12 +193,16 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 		id: "xopc.automations.create",
 		description: "Create an automation without replacing an existing identity.",
 		input: AutomationCreateCapabilityInputSchema,
-		execute(input) {
+		requestScope: (context) => context.conversationId ?? "",
+		execute(input, context) {
 			requireProject(input.projectId);
+			assertAutomationSetupTarget(context.conversationId);
 			try {
+				const automation = validateSchedule(() => service.createAtomically(input));
+				bindAutomationSetup(context.conversationId, automation.id);
 				return {
 					ok: true,
-					automation: { ...service.createAtomically(input) }
+					automation: { ...automation }
 				};
 			} catch (error) {
 				if (error instanceof AutomationAlreadyExistsError) throw new CapabilityError("REVISION_CONFLICT", error.message);
@@ -205,7 +219,8 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 			expectedRevision: z.number().int().nonnegative(),
 			patch: AutomationUpdatePatchSchema
 		}),
-		execute({ id, expectedRevision, patch }) {
+		execute({ id, expectedRevision, patch }, context) {
+			assertAutomationSetupTarget(context.conversationId, id);
 			const current = getAutomation(id);
 			if (!current) throw new CapabilityError("NOT_FOUND", "Automation not found");
 			if (current.updatedAtMs !== expectedRevision) throw new CapabilityError("REVISION_CONFLICT", "Automation changed");
@@ -213,7 +228,7 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 			requireProject(patch.projectId);
 			return {
 				ok: true,
-				automation: { ...service.updateAtomically(id, patch) }
+				automation: { ...validateSchedule(() => service.updateAtomically(id, patch)) }
 			};
 		}
 	}));
@@ -226,12 +241,13 @@ function registerAutomationWriteCapabilities(dispatcher, service, projects) {
 		scopes: ["automations.write"],
 		input: AutomationSetEnabledInputSchema,
 		output: AutomationMutationOutputSchema,
-		execute({ id, enabled, expectedRevision }) {
+		execute({ id, enabled, expectedRevision }, context) {
+			assertAutomationSetupTarget(context.conversationId, id);
 			const current = getAutomation(id);
 			if (!current) throw new CapabilityError("NOT_FOUND", "Automation not found");
 			if (current.updatedAtMs !== expectedRevision) throw new CapabilityError("REVISION_CONFLICT", "Automation changed");
 			assertManagedOperation(current, "update", { enabled });
-			const automation = service.updateAtomically(id, { enabled });
+			const automation = validateSchedule(() => service.updateAtomically(id, { enabled }));
 			if (!automation) throw new CapabilityError("NOT_FOUND", "Automation not found");
 			return {
 				ok: true,

package/dist/src/automations/configuration-conversation.d.ts

@@ -0,0 +1,16 @@
+export type AutomationSetup = {
+    automationId?: string;
+    focusedRunId?: string;
+};
+export declare function getAutomationSetup(conversationId?: string): AutomationSetup | null;
+/** Called inside the capability transaction so creation and association commit together. */
+export declare function bindAutomationSetup(conversationId: string | undefined, automationId: string): void;
+export declare function assertAutomationSetupTarget(conversationId: string | undefined, automationId?: string): void;
+/** Reuse the main configuration chat, including after a process restart. */
+export declare function openAutomationConfiguration(input: {
+    agentId: string;
+    automationId?: string;
+    projectId?: string;
+    runId?: string;
+}): string;
+export declare function buildAutomationSetupContext(conversationId?: string): string;