@xopcai/xopc 0.0.118 → 0.0.119

package/dist/src/automations/draft/automation-draft-validator.js

@@ -0,0 +1,105 @@
+import { CreateAutomationSchema, UpdateAutomationSchema } from "../domain/validation.js";
+import { randomUUID } from "node:crypto";
+//#region src/automations/draft/automation-draft-validator.ts
+function extractJsonObject(raw) {
+	const trimmed = raw.trim();
+	if (trimmed.startsWith("{") && trimmed.endsWith("}")) return trimmed;
+	const start = trimmed.indexOf("{");
+	const end = trimmed.lastIndexOf("}");
+	if (start >= 0 && end > start) return trimmed.slice(start, end + 1);
+	throw new Error("Model output did not contain a JSON object");
+}
+function stringArray(value) {
+	return Array.isArray(value) ? value.map((item) => String(item)).filter(Boolean) : [];
+}
+function parseGeneratedAutomationDraft(raw) {
+	const json = extractJsonObject(raw);
+	const parsed = JSON.parse(json);
+	return {
+		automation: CreateAutomationSchema.parse(parsed.automation),
+		explanation: String(parsed.explanation ?? ""),
+		assumptions: stringArray(parsed.assumptions),
+		risks: stringArray(parsed.risks)
+	};
+}
+function buildAutomationDraftResponse(draft, repairAttempts) {
+	return {
+		draftId: randomUUID(),
+		automation: draft.automation,
+		explanation: draft.explanation,
+		assumptions: draft.assumptions,
+		risks: draft.risks,
+		simulation: simulateAutomation(draft.automation),
+		repairAttempts
+	};
+}
+function parseGeneratedAutomationRepairDraft(raw, repairAttempts) {
+	const json = extractJsonObject(raw);
+	const parsed = JSON.parse(json);
+	const patch = UpdateAutomationSchema.parse(parsed.patch);
+	return {
+		draftId: randomUUID(),
+		patch,
+		explanation: String(parsed.explanation ?? ""),
+		expectedEffect: String(parsed.expectedEffect ?? ""),
+		risks: stringArray(parsed.risks),
+		requiresApproval: parsed.requiresApproval !== false || repairPatchNeedsApproval(patch),
+		repairAttempts
+	};
+}
+function simulateAutomation(input) {
+	const automation = CreateAutomationSchema.parse(input);
+	const safetyNotes = [];
+	const requiredConfirmations = [];
+	const triggerSummary = summarizeTrigger(automation.trigger);
+	const actionSummary = summarizeAction(automation.action);
+	if (automation.action.kind === "agent" && /delete|remove|send|post|publish|付款|删除|发送|发布/i.test(automation.action.instruction)) requiredConfirmations.push("Agent instruction may perform an external or destructive action.");
+	if (automation.afterRun?.kind === "webhook") {
+		safetyNotes.push("After-run webhook will call an external URL after each run.");
+		requiredConfirmations.push("External webhook call should be reviewed before publishing.");
+	}
+	const safetyMode = automation.safety?.mode ?? "auto_apply";
+	if (safetyMode === "suggest_only") safetyNotes.push("Suggest-only safety mode will generate recommendations without applying changes.");
+	else if (safetyMode === "ask_before_apply") safetyNotes.push("Ask-before-applying safety mode requires confirmation before applying changes.");
+	else {
+		safetyNotes.push("Auto-apply safety mode may act automatically when the trigger matches.");
+		requiredConfirmations.push("Auto-apply mode should only be used for trusted automations.");
+	}
+	if (automation.trigger.kind === "webhook") safetyNotes.push("Webhook trigger can be invoked externally; keep its secret id private.");
+	if (automation.trigger.kind === "event") safetyNotes.push("Product-event trigger runs automatically when matching xopc events are published.");
+	return {
+		triggerSummary,
+		actionSummary,
+		safetyNotes,
+		requiredConfirmations,
+		canRunNow: automation.trigger.kind === "manual",
+		runNowBlockedReason: automation.trigger.kind === "manual" ? void 0 : "Only manual automations can be run immediately from the draft."
+	};
+}
+function summarizeTrigger(trigger) {
+	if (trigger.kind === "manual") return "Runs only when started manually.";
+	if (trigger.kind === "webhook") return "Runs when the automation webhook is called.";
+	if (trigger.kind === "event") {
+		const source = trigger.source ? ` from ${trigger.source}` : "";
+		return `Runs on product event ${trigger.eventType}${source}.`;
+	}
+	const schedule = trigger.schedule;
+	if (schedule.kind === "interval") return `Runs every ${Math.round(schedule.everyMs / 6e4)} minutes.`;
+	if (schedule.kind === "once") return `Runs once at ${schedule.at}.`;
+	return `Runs on cron schedule ${schedule.expr}.`;
+}
+function summarizeAction(action) {
+	if (action.kind === "workflow") return `Starts workflow ${action.workflowId}.`;
+	return action.agentId ? `Runs agent ${action.agentId}.` : "Runs the default agent.";
+}
+function repairPatchNeedsApproval(patch) {
+	if (patch.safety?.mode === "auto_apply") return true;
+	if (patch.afterRun?.kind === "webhook") return true;
+	if (patch.trigger?.kind === "webhook") return true;
+	if (patch.action?.kind === "agent") return /delete|remove|send|post|publish|付款|删除|发送|发布/i.test(patch.action.instruction);
+	return false;
+}
+//#endregion
+export { buildAutomationDraftResponse, parseGeneratedAutomationDraft, parseGeneratedAutomationRepairDraft, simulateAutomation };
+
+//# sourceMappingURL=automation-draft-validator.js.map

package/dist/src/automations/draft/automation-draft-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation-draft-validator.js","names":[],"sources":["../../../../src/automations/draft/automation-draft-validator.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { CreateAutomationInput, UpdateAutomationInput } from '../domain/validation.js';\nimport { CreateAutomationSchema, UpdateAutomationSchema } from '../domain/validation.js';\nimport type { AutomationRepairDraftResponse, AutomationSimulation } from './automation-draft.types.js';\n\ninterface GeneratedAutomationDraft {\n  automation: CreateAutomationInput;\n  explanation: string;\n  assumptions: string[];\n  risks: string[];\n}\n\nfunction extractJsonObject(raw: string): string {\n  const trimmed = raw.trim();\n  if (trimmed.startsWith('{') && trimmed.endsWith('}')) return trimmed;\n  const start = trimmed.indexOf('{');\n  const end = trimmed.lastIndexOf('}');\n  if (start >= 0 && end > start) return trimmed.slice(start, end + 1);\n  throw new Error('Model output did not contain a JSON object');\n}\n\nfunction stringArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.map((item) => String(item)).filter(Boolean) : [];\n}\n\nexport function parseGeneratedAutomationDraft(raw: string): GeneratedAutomationDraft {\n  const json = extractJsonObject(raw);\n  const parsed = JSON.parse(json) as { automation?: unknown; explanation?: unknown; assumptions?: unknown; risks?: unknown };\n  const automation = CreateAutomationSchema.parse(parsed.automation) as CreateAutomationInput;\n  return {\n    automation,\n    explanation: String(parsed.explanation ?? ''),\n    assumptions: stringArray(parsed.assumptions),\n    risks: stringArray(parsed.risks),\n  };\n}\n\nexport function buildAutomationDraftResponse(\n  draft: GeneratedAutomationDraft,\n  repairAttempts: number,\n) {\n  return {\n    draftId: randomUUID(),\n    automation: draft.automation,\n    explanation: draft.explanation,\n    assumptions: draft.assumptions,\n    risks: draft.risks,\n    simulation: simulateAutomation(draft.automation),\n    repairAttempts,\n  };\n}\n\nexport function parseGeneratedAutomationRepairDraft(\n  raw: string,\n  repairAttempts: number,\n): AutomationRepairDraftResponse {\n  const json = extractJsonObject(raw);\n  const parsed = JSON.parse(json) as {\n    patch?: unknown;\n    explanation?: unknown;\n    expectedEffect?: unknown;\n    risks?: unknown;\n    requiresApproval?: unknown;\n  };\n  const patch = UpdateAutomationSchema.parse(parsed.patch) as UpdateAutomationInput;\n  return {\n    draftId: randomUUID(),\n    patch,\n    explanation: String(parsed.explanation ?? ''),\n    expectedEffect: String(parsed.expectedEffect ?? ''),\n    risks: stringArray(parsed.risks),\n    requiresApproval: parsed.requiresApproval !== false || repairPatchNeedsApproval(patch),\n    repairAttempts,\n  };\n}\n\nexport function simulateAutomation(input: CreateAutomationInput): AutomationSimulation {\n  const automation = CreateAutomationSchema.parse(input) as CreateAutomationInput;\n  const safetyNotes: string[] = [];\n  const requiredConfirmations: string[] = [];\n\n  const triggerSummary = summarizeTrigger(automation.trigger);\n  const actionSummary = summarizeAction(automation.action);\n\n  if (automation.action.kind === 'agent' && /delete|remove|send|post|publish|付款|删除|发送|发布/i.test(automation.action.instruction)) {\n    requiredConfirmations.push('Agent instruction may perform an external or destructive action.');\n  }\n  if (automation.afterRun?.kind === 'webhook') {\n    safetyNotes.push('After-run webhook will call an external URL after each run.');\n    requiredConfirmations.push('External webhook call should be reviewed before publishing.');\n  }\n  const safetyMode = automation.safety?.mode ?? 'auto_apply';\n  if (safetyMode === 'suggest_only') {\n    safetyNotes.push('Suggest-only safety mode will generate recommendations without applying changes.');\n  } else if (safetyMode === 'ask_before_apply') {\n    safetyNotes.push('Ask-before-applying safety mode requires confirmation before applying changes.');\n  } else {\n    safetyNotes.push('Auto-apply safety mode may act automatically when the trigger matches.');\n    requiredConfirmations.push('Auto-apply mode should only be used for trusted automations.');\n  }\n  if (automation.trigger.kind === 'webhook') {\n    safetyNotes.push('Webhook trigger can be invoked externally; keep its secret id private.');\n  }\n  if (automation.trigger.kind === 'event') {\n    safetyNotes.push('Product-event trigger runs automatically when matching xopc events are published.');\n  }\n\n  return {\n    triggerSummary,\n    actionSummary,\n    safetyNotes,\n    requiredConfirmations,\n    canRunNow: automation.trigger.kind === 'manual',\n    runNowBlockedReason: automation.trigger.kind === 'manual' ? undefined : 'Only manual automations can be run immediately from the draft.',\n  };\n}\n\nfunction summarizeTrigger(trigger: CreateAutomationInput['trigger']): string {\n  if (trigger.kind === 'manual') return 'Runs only when started manually.';\n  if (trigger.kind === 'webhook') return 'Runs when the automation webhook is called.';\n  if (trigger.kind === 'event') {\n    const source = trigger.source ? ` from ${trigger.source}` : '';\n    return `Runs on product event ${trigger.eventType}${source}.`;\n  }\n  const schedule = trigger.schedule;\n  if (schedule.kind === 'interval') return `Runs every ${Math.round(schedule.everyMs / 60000)} minutes.`;\n  if (schedule.kind === 'once') return `Runs once at ${schedule.at}.`;\n  return `Runs on cron schedule ${schedule.expr}.`;\n}\n\nfunction summarizeAction(action: CreateAutomationInput['action']): string {\n  if (action.kind === 'workflow') return `Starts workflow ${action.workflowId}.`;\n  return action.agentId ? `Runs agent ${action.agentId}.` : 'Runs the default agent.';\n}\n\nfunction repairPatchNeedsApproval(patch: UpdateAutomationInput): boolean {\n  if (patch.safety?.mode === 'auto_apply') return true;\n  if (patch.afterRun?.kind === 'webhook') return true;\n  if (patch.trigger?.kind === 'webhook') return true;\n  if (patch.action?.kind === 'agent') {\n    return /delete|remove|send|post|publish|付款|删除|发送|发布/i.test(patch.action.instruction);\n  }\n  return false;\n}\n"],"mappings":"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"}

package/dist/src/automations/draft/automation-draft.types.d.ts

@@ -0,0 +1,40 @@
+import type { AutomationRun, AutomationRunEvent } from '../domain/types.js';
+import type { CreateAutomationInput, UpdateAutomationInput } from '../domain/validation.js';
+export interface CreateAutomationDraftRequest {
+    prompt: string;
+    agentId: string;
+    language?: 'en' | 'zh';
+}
+export interface AutomationDraftResponse {
+    draftId: string;
+    automation: CreateAutomationInput;
+    explanation: string;
+    assumptions: string[];
+    risks: string[];
+    simulation: AutomationSimulation;
+    repairAttempts: number;
+}
+export interface AutomationSimulation {
+    triggerSummary: string;
+    actionSummary: string;
+    safetyNotes: string[];
+    requiredConfirmations: string[];
+    canRunNow: boolean;
+    runNowBlockedReason?: string;
+}
+export interface CreateAutomationRepairDraftRequest {
+    agentId: string;
+    automation: CreateAutomationInput;
+    run: AutomationRun;
+    events: AutomationRunEvent[];
+    language?: 'en' | 'zh';
+}
+export interface AutomationRepairDraftResponse {
+    draftId: string;
+    patch: UpdateAutomationInput;
+    explanation: string;
+    expectedEffect: string;
+    risks: string[];
+    requiresApproval: boolean;
+    repairAttempts: number;
+}

package/dist/src/automations/draft/index.d.ts

@@ -0,0 +1,3 @@
+export * from './automation-draft-service.js';
+export * from './automation-draft.types.js';
+export * from './automation-draft-validator.js';

package/dist/src/automations/draft/index.js

@@ -0,0 +1,3 @@
+import { buildAutomationDraftResponse, parseGeneratedAutomationDraft, parseGeneratedAutomationRepairDraft, simulateAutomation } from "./automation-draft-validator.js";
+import { AutomationDraftService } from "./automation-draft-service.js";
+export { AutomationDraftService, buildAutomationDraftResponse, parseGeneratedAutomationDraft, parseGeneratedAutomationRepairDraft, simulateAutomation };

package/dist/src/automations/index.d.ts

@@ -0,0 +1,3 @@
+export * from './domain/index.js';
+export * from './service/index.js';
+export * from './product-events.js';

package/dist/src/automations/index.js

@@ -0,0 +1,8 @@
+import { onAutomationProductEvent, publishAutomationProductEvent } from "./product-events.js";
+import { computeNextAutomationRunAtMs, computeNextScheduleRunAtMs, timerDelayUntil } from "./domain/schedule.js";
+import { AutomationActionSchema, AutomationAfterRunSchema, AutomationReliabilitySchema, AutomationSafetyPolicySchema, AutomationScheduleSchema, AutomationSchema, AutomationStateSchema, AutomationTriggerSchema, CreateAutomationSchema, UpdateAutomationSchema } from "./domain/validation.js";
+import "./domain/index.js";
+import { AutomationActionExecutor } from "./service/action-executor.js";
+import { AutomationAlreadyRunningError, AutomationService } from "./service/automation-service.js";
+import "./service/index.js";
+export { AutomationActionExecutor, AutomationActionSchema, AutomationAfterRunSchema, AutomationAlreadyRunningError, AutomationReliabilitySchema, AutomationSafetyPolicySchema, AutomationScheduleSchema, AutomationSchema, AutomationService, AutomationStateSchema, AutomationTriggerSchema, CreateAutomationSchema, UpdateAutomationSchema, computeNextAutomationRunAtMs, computeNextScheduleRunAtMs, onAutomationProductEvent, publishAutomationProductEvent, timerDelayUntil };

package/dist/src/automations/product-events.d.ts

@@ -0,0 +1,5 @@
+import type { AutomationEvent } from './domain/types.js';
+type AutomationProductEventListener = (event: AutomationEvent) => void | Promise<void>;
+export declare function onAutomationProductEvent(listener: AutomationProductEventListener): () => void;
+export declare function publishAutomationProductEvent(event: AutomationEvent): void;
+export {};

package/dist/src/automations/product-events.js

@@ -0,0 +1,21 @@
+//#region src/automations/product-events.ts
+const AUTOMATION_PRODUCT_EVENT_LISTENERS = /* @__PURE__ */ new Set();
+function onAutomationProductEvent(listener) {
+	AUTOMATION_PRODUCT_EVENT_LISTENERS.add(listener);
+	return () => {
+		AUTOMATION_PRODUCT_EVENT_LISTENERS.delete(listener);
+	};
+}
+function publishAutomationProductEvent(event) {
+	const normalized = {
+		...event,
+		occurredAtMs: event.occurredAtMs ?? Date.now()
+	};
+	for (const listener of AUTOMATION_PRODUCT_EVENT_LISTENERS) try {
+		listener(normalized);
+	} catch {}
+}
+//#endregion
+export { onAutomationProductEvent, publishAutomationProductEvent };
+
+//# sourceMappingURL=product-events.js.map

package/dist/src/automations/product-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-events.js","names":[],"sources":["../../../src/automations/product-events.ts"],"sourcesContent":["import type { AutomationEvent } from './domain/types.js';\n\ntype AutomationProductEventListener = (event: AutomationEvent) => void | Promise<void>;\n\nconst AUTOMATION_PRODUCT_EVENT_LISTENERS = new Set<AutomationProductEventListener>();\n\nexport function onAutomationProductEvent(listener: AutomationProductEventListener): () => void {\n  AUTOMATION_PRODUCT_EVENT_LISTENERS.add(listener);\n  return () => {\n    AUTOMATION_PRODUCT_EVENT_LISTENERS.delete(listener);\n  };\n}\n\nexport function publishAutomationProductEvent(event: AutomationEvent): void {\n  const normalized: AutomationEvent = {\n    ...event,\n    occurredAtMs: event.occurredAtMs ?? Date.now(),\n  };\n  for (const listener of AUTOMATION_PRODUCT_EVENT_LISTENERS) {\n    try {\n      void listener(normalized);\n    } catch {\n      /* listeners isolate publisher paths */\n    }\n  }\n}\n"],"mappings":";AAIA,MAAM,qDAAqC,IAAI,KAAqC;AAEpF,SAAgB,yBAAyB,UAAsD;AAC7F,oCAAmC,IAAI,SAAS;AAChD,cAAa;AACX,qCAAmC,OAAO,SAAS;;;AAIvD,SAAgB,8BAA8B,OAA8B;CAC1E,MAAM,aAA8B;EAClC,GAAG;EACH,cAAc,MAAM,gBAAgB,KAAK,KAAK;EAC/C;AACD,MAAK,MAAM,YAAY,mCACrB,KAAI;AACG,WAAS,WAAW;SACnB"}

package/dist/src/automations/service/action-executor.d.ts

@@ -0,0 +1,9 @@
+import type { Automation, AutomationActionOutcome, AutomationDeps, AutomationRun } from '../domain/types.js';
+export declare class AutomationActionExecutor {
+    private deps;
+    setDeps(deps: AutomationDeps): void;
+    execute(automation: Automation, run: AutomationRun, signal: AbortSignal): Promise<AutomationActionOutcome>;
+    private executeWithoutTimeout;
+    private executeAgent;
+    private executeWorkflow;
+}

package/dist/src/automations/service/action-executor.js

@@ -0,0 +1,157 @@
+import { init_agent_scope, normalizeAgentId } from "../../agent/agent-scope.js";
+import { buildSessionKey, init_session_key } from "../../routing/session-key.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import crypto from "node:crypto";
+//#region src/automations/service/action-executor.ts
+init_agent_scope();
+init_session_key();
+init_logger();
+const log = createLogger("Automation:ActionExecutor");
+const DEFAULT_TIMEOUT_MS = 18e4;
+function withTimeout(promise, timeoutMs, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(/* @__PURE__ */ new Error("Automation run was cancelled"));
+			return;
+		}
+		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`Automation timed out after ${timeoutMs}ms`)), timeoutMs);
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(/* @__PURE__ */ new Error("Automation run was cancelled"));
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		promise.then((value) => {
+			clearTimeout(timer);
+			signal.removeEventListener("abort", onAbort);
+			resolve(value);
+		}, (err) => {
+			clearTimeout(timer);
+			signal.removeEventListener("abort", onAbort);
+			reject(err);
+		});
+	});
+}
+var AutomationActionExecutor = class {
+	deps = {};
+	setDeps(deps) {
+		this.deps = {
+			...this.deps,
+			...deps
+		};
+	}
+	async execute(automation, run, signal) {
+		const timeoutMs = (automation.action.timeoutSeconds ?? automation.reliability?.timeoutSeconds ?? 0) > 0 ? (automation.action.timeoutSeconds ?? automation.reliability?.timeoutSeconds) * 1e3 : DEFAULT_TIMEOUT_MS;
+		return withTimeout(this.executeWithoutTimeout(automation, run, signal), timeoutMs, signal).catch((err) => {
+			const message = err instanceof Error ? err.message : String(err);
+			return {
+				status: message.toLowerCase().includes("cancelled") ? "cancelled" : message.toLowerCase().includes("timed out") ? "timeout" : "failed",
+				error: message
+			};
+		});
+	}
+	async executeWithoutTimeout(automation, run, signal) {
+		if (signal.aborted) return {
+			status: "cancelled",
+			error: "Automation run was cancelled"
+		};
+		if (automation.action.kind === "workflow") return this.executeWorkflow(automation, automation.action, run);
+		return this.executeAgent(automation, automation.action);
+	}
+	async executeAgent(automation, action) {
+		const agentService = this.deps.agentService;
+		if (!agentService?.turnDispatcher?.processDirect) return {
+			status: "failed",
+			error: "Agent service is not available"
+		};
+		const sessionKey = buildSessionKey({
+			agentId: normalizeAgentId(action.agentId || this.deps.getDefaultAgentId?.() || "main"),
+			source: "automation",
+			accountId: "default",
+			peerKind: "dm",
+			peerId: `${automation.id}-${crypto.randomUUID().slice(0, 8)}`
+		});
+		await agentService.sessionConfig?.applyAutomationWorkingDirectory?.(sessionKey, action.workingDirectory);
+		if (agentService.sessionConfig?.applyAutomationModelOverride) {
+			if (!await agentService.sessionConfig.applyAutomationModelOverride(sessionKey, action.model) && action.model) log.warn({
+				automationId: automation.id,
+				sessionKey,
+				model: action.model
+			}, "Automation model override invalid; using agent default");
+		}
+		const response = await agentService.turnDispatcher.processDirect(buildSafetyInstruction(automation, action.instruction), sessionKey);
+		const model = agentService.getModelForSession?.(sessionKey);
+		return {
+			status: "succeeded",
+			summary: response.slice(0, 500),
+			sessionKey,
+			model
+		};
+	}
+	async executeWorkflow(automation, action, run) {
+		const safetyMode = automation.safety?.mode ?? "auto_apply";
+		if (safetyMode === "suggest_only") return {
+			status: "succeeded",
+			summary: `Suggest only: workflow ${action.workflowId} was not started. Review the automation and upgrade safety mode to run it automatically.`
+		};
+		if (safetyMode === "ask_before_apply") return {
+			status: "succeeded",
+			summary: `Ask before applying: workflow ${action.workflowId} is ready, but was not started automatically. Upgrade to Auto apply when you trust this automation.`
+		};
+		const workflowRunService = this.deps.workflowRunService;
+		if (!workflowRunService) return {
+			status: "failed",
+			error: "Workflow service is not available"
+		};
+		const agentId = normalizeAgentId(action.agentId || this.deps.getDefaultAgentId?.() || "main");
+		const idempotencyKey = `automation:${automation.id}:${run.id}`;
+		const result = await workflowRunService.startWorkflowRun({
+			agentId,
+			definitionId: action.workflowId,
+			input: action.input,
+			inputEnvelope: action.inputEnvelope,
+			goal: action.goal,
+			concurrency: action.concurrency,
+			maxSubagents: action.maxSubagents,
+			source: {
+				kind: "automation",
+				automationId: automation.id,
+				runId: run.id
+			},
+			idempotencyKey
+		});
+		if (result.ok === false) return {
+			status: "failed",
+			error: result.message
+		};
+		return {
+			status: "succeeded",
+			summary: `Started workflow run ${result.runId}`,
+			sessionKey: result.sessionKey,
+			workflowRunId: result.runId
+		};
+	}
+};
+function buildSafetyInstruction(automation, instruction) {
+	const mode = automation.safety?.mode ?? "auto_apply";
+	if (mode === "suggest_only") return [
+		"Automation safety mode: Suggest only.",
+		"Only analyze the situation and produce a concise recommendation.",
+		"Do not modify files, notes, goals, workflows, external systems, or persistent state.",
+		"If a change seems useful, describe the exact change for the user to review.",
+		"",
+		instruction
+	].join("\n");
+	if (mode === "ask_before_apply") return [
+		"Automation safety mode: Ask before applying.",
+		"Draft the proposed change or action and clearly ask for user confirmation before applying anything.",
+		"Do not perform irreversible or external side effects unless the user has explicitly approved them in this run.",
+		"",
+		instruction
+	].join("\n");
+	return instruction;
+}
+//#endregion
+export { AutomationActionExecutor };
+
+//# sourceMappingURL=action-executor.js.map

package/dist/src/automations/service/action-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-executor.js","names":[],"sources":["../../../../src/automations/service/action-executor.ts"],"sourcesContent":["import crypto from 'node:crypto';\n\nimport { DEFAULT_AGENT_ID, normalizeAgentId } from '../../agent/agent-scope.js';\nimport { buildSessionKey } from '../../routing/session-key.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type {\n  Automation,\n  AutomationAction,\n  AutomationActionOutcome,\n  AutomationDeps,\n  AutomationRun,\n} from '../domain/types.js';\n\nconst log = createLogger('Automation:ActionExecutor');\n\nconst DEFAULT_TIMEOUT_MS = 180_000;\n\nfunction withTimeout<T>(promise: Promise<T>, timeoutMs: number, signal: AbortSignal): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    if (signal.aborted) {\n      reject(new Error('Automation run was cancelled'));\n      return;\n    }\n    const timer = setTimeout(() => reject(new Error(`Automation timed out after ${timeoutMs}ms`)), timeoutMs);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new Error('Automation run was cancelled'));\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    promise.then(\n      (value) => {\n        clearTimeout(timer);\n        signal.removeEventListener('abort', onAbort);\n        resolve(value);\n      },\n      (err) => {\n        clearTimeout(timer);\n        signal.removeEventListener('abort', onAbort);\n        reject(err);\n      },\n    );\n  });\n}\n\nexport class AutomationActionExecutor {\n  private deps: AutomationDeps = {};\n\n  setDeps(deps: AutomationDeps): void {\n    this.deps = { ...this.deps, ...deps };\n  }\n\n  async execute(\n    automation: Automation,\n    run: AutomationRun,\n    signal: AbortSignal,\n  ): Promise<AutomationActionOutcome> {\n    const timeoutMs =\n      (automation.action.timeoutSeconds ?? automation.reliability?.timeoutSeconds ?? 0) > 0\n        ? (automation.action.timeoutSeconds ?? automation.reliability?.timeoutSeconds)! * 1000\n        : DEFAULT_TIMEOUT_MS;\n\n    return withTimeout(this.executeWithoutTimeout(automation, run, signal), timeoutMs, signal).catch((err) => {\n      const message = err instanceof Error ? err.message : String(err);\n      return {\n        status: message.toLowerCase().includes('cancelled')\n          ? 'cancelled'\n          : message.toLowerCase().includes('timed out')\n            ? 'timeout'\n            : 'failed',\n        error: message,\n      };\n    });\n  }\n\n  private async executeWithoutTimeout(\n    automation: Automation,\n    run: AutomationRun,\n    signal: AbortSignal,\n  ): Promise<AutomationActionOutcome> {\n    if (signal.aborted) {\n      return { status: 'cancelled', error: 'Automation run was cancelled' };\n    }\n    if (automation.action.kind === 'workflow') {\n      return this.executeWorkflow(automation, automation.action, run);\n    }\n    return this.executeAgent(automation, automation.action);\n  }\n\n  private async executeAgent(\n    automation: Automation,\n    action: Extract<AutomationAction, { kind: 'agent' }>,\n  ): Promise<AutomationActionOutcome> {\n    const agentService = this.deps.agentService;\n    if (!agentService?.turnDispatcher?.processDirect) {\n      return { status: 'failed', error: 'Agent service is not available' };\n    }\n    const agentId = normalizeAgentId(\n      action.agentId || this.deps.getDefaultAgentId?.() || DEFAULT_AGENT_ID,\n    );\n    const sessionKey = buildSessionKey({\n      agentId,\n      source: 'automation',\n      accountId: 'default',\n      peerKind: 'dm',\n      peerId: `${automation.id}-${crypto.randomUUID().slice(0, 8)}`,\n    });\n\n    await agentService.sessionConfig?.applyAutomationWorkingDirectory?.(\n      sessionKey,\n      action.workingDirectory,\n    );\n    if (agentService.sessionConfig?.applyAutomationModelOverride) {\n      const ok = await agentService.sessionConfig.applyAutomationModelOverride(sessionKey, action.model);\n      if (!ok && action.model) {\n        log.warn(\n          { automationId: automation.id, sessionKey, model: action.model },\n          'Automation model override invalid; using agent default',\n        );\n      }\n    }\n\n    const response = await agentService.turnDispatcher.processDirect(\n      buildSafetyInstruction(automation, action.instruction),\n      sessionKey,\n    );\n    const model = agentService.getModelForSession?.(sessionKey);\n    return {\n      status: 'succeeded',\n      summary: response.slice(0, 500),\n      sessionKey,\n      model,\n    };\n  }\n\n  private async executeWorkflow(\n    automation: Automation,\n    action: Extract<AutomationAction, { kind: 'workflow' }>,\n    run: AutomationRun,\n  ): Promise<AutomationActionOutcome> {\n    const safetyMode = automation.safety?.mode ?? 'auto_apply';\n    if (safetyMode === 'suggest_only') {\n      return {\n        status: 'succeeded',\n        summary: `Suggest only: workflow ${action.workflowId} was not started. Review the automation and upgrade safety mode to run it automatically.`,\n      };\n    }\n    if (safetyMode === 'ask_before_apply') {\n      return {\n        status: 'succeeded',\n        summary: `Ask before applying: workflow ${action.workflowId} is ready, but was not started automatically. Upgrade to Auto apply when you trust this automation.`,\n      };\n    }\n    const workflowRunService = this.deps.workflowRunService;\n    if (!workflowRunService) {\n      return { status: 'failed', error: 'Workflow service is not available' };\n    }\n    const agentId = normalizeAgentId(\n      action.agentId || this.deps.getDefaultAgentId?.() || DEFAULT_AGENT_ID,\n    );\n    const idempotencyKey = `automation:${automation.id}:${run.id}`;\n    const result = await workflowRunService.startWorkflowRun({\n      agentId,\n      definitionId: action.workflowId,\n      input: action.input,\n      inputEnvelope: action.inputEnvelope,\n      goal: action.goal,\n      concurrency: action.concurrency,\n      maxSubagents: action.maxSubagents,\n      source: { kind: 'automation', automationId: automation.id, runId: run.id },\n      idempotencyKey,\n    });\n    if (result.ok === false) {\n      return { status: 'failed', error: result.message };\n    }\n    return {\n      status: 'succeeded',\n      summary: `Started workflow run ${result.runId}`,\n      sessionKey: result.sessionKey,\n      workflowRunId: result.runId,\n    };\n  }\n}\n\nfunction buildSafetyInstruction(automation: Automation, instruction: string): string {\n  const mode = automation.safety?.mode ?? 'auto_apply';\n  if (mode === 'suggest_only') {\n    return [\n      'Automation safety mode: Suggest only.',\n      'Only analyze the situation and produce a concise recommendation.',\n      'Do not modify files, notes, goals, workflows, external systems, or persistent state.',\n      'If a change seems useful, describe the exact change for the user to review.',\n      '',\n      instruction,\n    ].join('\\n');\n  }\n  if (mode === 'ask_before_apply') {\n    return [\n      'Automation safety mode: Ask before applying.',\n      'Draft the proposed change or action and clearly ask for user confirmation before applying anything.',\n      'Do not perform irreversible or external side effects unless the user has explicitly approved them in this run.',\n      '',\n      instruction,\n    ].join('\\n');\n  }\n  return instruction;\n}\n"],"mappings":"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"}

package/dist/src/automations/service/automation-service.d.ts

@@ -0,0 +1,54 @@
+import type { Automation, AutomationDeps, AutomationEvent, AutomationMetrics, AutomationProductEventRun, AutomationRun, AutomationRunEvent } from '../domain/types.js';
+import { type CreateAutomationInput, type UpdateAutomationInput } from '../domain/validation.js';
+export declare class AutomationAlreadyRunningError extends Error {
+    readonly automationId: string;
+    readonly runningRunId?: string;
+    constructor(automationId: string, runningRunId?: string);
+}
+export declare class AutomationService {
+    private readonly executor;
+    private timer;
+    private stopped;
+    private runningScheduler;
+    private deps;
+    private maxConcurrentRuns;
+    private readonly activeRuns;
+    setDeps(deps: AutomationDeps): void;
+    initialize(options?: {
+        maxConcurrentRuns?: number;
+    }): Promise<void>;
+    stop(): Promise<void>;
+    create(input: CreateAutomationInput): Promise<Automation>;
+    list(): Promise<Automation[]>;
+    get(id: string): Promise<Automation | null>;
+    update(id: string, patch: UpdateAutomationInput): Promise<Automation | null>;
+    remove(id: string): Promise<boolean>;
+    pause(id: string): Promise<Automation | null>;
+    resume(id: string): Promise<Automation | null>;
+    runNow(id: string): Promise<AutomationRun>;
+    rerunFromRun(runId: string): Promise<AutomationRun>;
+    triggerEvent(event: AutomationEvent): Promise<AutomationRun[]>;
+    listRuns(options?: {
+        automationId?: string;
+        limit?: number;
+    }): Promise<AutomationRun[]>;
+    listRunsForProductEvent(options: {
+        eventType: string;
+        source?: string;
+        payloadKey?: string;
+        payloadValue?: string;
+        limit?: number;
+    }): Promise<AutomationProductEventRun[]>;
+    getRun(runId: string): Promise<AutomationRun | null>;
+    listRunEvents(runId: string): Promise<AutomationRunEvent[]>;
+    cancelRun(runId: string): Promise<boolean>;
+    getMetrics(): Promise<AutomationMetrics>;
+    private recomputeNextRuns;
+    private armTimer;
+    private onTimer;
+    private startRun;
+    private executeRun;
+    private appendRunEvent;
+    private finishAutomationRun;
+    private postAfterRunWebhook;
+}