@xopcai/xopc 0.0.117 → 0.0.119

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

@@ -0,0 +1,127 @@
+//#region src/automations/draft/automation-draft-prompt.ts
+function buildAutomationDraftPrompt(params) {
+	return `You generate xopc automation drafts. Return ONLY a JSON object, no markdown.
+
+JSON shape:
+{
+  "automation": {
+    "name": "Short human name",
+    "description": "What this automation does",
+    "trigger": { "kind": "manual" },
+    "action": { "kind": "agent", "instruction": "clear instruction for the agent" },
+    "safety": { "mode": "suggest_only" },
+    "afterRun": { "kind": "none" },
+    "reliability": { "timeoutSeconds": 300, "disableAfterConsecutiveFailures": 3 }
+  },
+  "explanation": "Short explanation",
+  "assumptions": ["..."],
+  "risks": ["..."]
+}
+
+Allowed triggers:
+- Manual: { "kind": "manual" }
+- Schedule interval: { "kind": "schedule", "schedule": { "kind": "interval", "everyMs": 3600000 } }
+- Schedule cron: { "kind": "schedule", "schedule": { "kind": "cron", "expr": "0 9 * * *" } }
+- Webhook: { "kind": "webhook", "secretId": "optional-short-id" }
+- Product event: { "kind": "event", "eventType": "goal.status_changed", "source": "goals", "payloadMatch": { "status": "blocked" } }
+
+Useful product events:
+- session.message.created
+- session.transcript.updated
+- note.created
+- note.updated
+- goal.created
+- goal.status_changed
+- workflow.run.completed
+- channel.message.received
+
+Allowed actions:
+- Agent: { "kind": "agent", "agentId": "optional", "instruction": "what to do", "timeoutSeconds": 300 }
+- Workflow: { "kind": "workflow", "workflowId": "known_workflow_id", "input": {}, "goal": "optional", "timeoutSeconds": 300 }
+
+Safety modes:
+- { "mode": "suggest_only" }: safest default, generate recommendations only.
+- { "mode": "ask_before_apply" }: draft actions and require user confirmation before applying.
+- { "mode": "auto_apply" }: trusted automation may act automatically.
+
+Rules:
+- Prefer agent actions unless the user names a specific existing workflow id.
+- Default to safety { "mode": "suggest_only" } unless the user explicitly asks for fully automatic execution.
+- Do not invent destructive actions. For deletion, external sending, or irreversible changes, include a risk and make the instruction ask for confirmation.
+- Use cron for daily/weekly schedules. Use standard 5-field cron.
+- Keep timeoutSeconds between 60 and 1800.
+- afterRun should usually be { "kind": "none" }.
+- Language for user-facing copy: ${params.language ?? "en"}.
+
+User request:
+${params.prompt.slice(0, 8e3)}
+`;
+}
+function buildAutomationDraftRepairPrompt(params) {
+	return `Repair the xopc automation draft. Return ONLY a JSON object with the same shape.
+
+Original user request:
+${params.prompt.slice(0, 8e3)}
+
+Language for user-facing copy: ${params.language ?? "en"}
+
+Previous output:
+${params.previousOutput.slice(0, 12e3)}
+
+Issues:
+${params.issues.map((issue) => `- ${issue.source}: ${issue.message}`).join("\n")}
+`;
+}
+function buildAutomationRunRepairPrompt(params) {
+	return `You suggest safe repair patches for xopc automations. Return ONLY a JSON object, no markdown.
+
+JSON shape:
+{
+  "patch": {
+    "description": "optional improved description",
+    "trigger": "optional complete trigger object",
+    "action": "optional complete action object",
+    "safety": "optional complete safety object",
+    "afterRun": "optional complete afterRun object",
+    "reliability": "optional complete reliability object",
+    "enabled": true
+  },
+  "explanation": "Why this patch should fix the failed run",
+  "expectedEffect": "What changes after applying it",
+  "risks": ["..."],
+  "requiresApproval": true
+}
+
+Rules:
+- Return a PATCH only. Do not include id, state, createdAtMs, or updatedAtMs.
+- Keep the patch minimal. Prefer reliability/action/input fixes over broad rewrites.
+- If the failure is unclear, propose only a safer timeout/retry/description patch and explain uncertainty.
+- Never add destructive or external behavior. If the existing automation has risky external behavior, keep requiresApproval true.
+- Language for user-facing copy: ${params.language ?? "en"}.
+
+Current automation:
+${JSON.stringify(params.automation, null, 2).slice(0, 12e3)}
+
+Failed run:
+${JSON.stringify(params.run, null, 2).slice(0, 8e3)}
+
+Timeline events:
+${JSON.stringify(params.events, null, 2).slice(0, 12e3)}
+`;
+}
+function buildAutomationRunRepairRetryPrompt(params) {
+	return `Repair the automation repair patch. Return ONLY a JSON object with the same shape.
+
+Language for user-facing copy: ${params.language ?? "en"}
+
+Previous output:
+${params.previousOutput.slice(0, 12e3)}
+
+Issues:
+${params.issues.map((issue) => `- ${issue.source}: ${issue.message}`).join("\n")}
+`;
+}
+//#endregion
+export { buildAutomationDraftPrompt, buildAutomationDraftRepairPrompt, buildAutomationRunRepairPrompt, buildAutomationRunRepairRetryPrompt };
+
+//# sourceMappingURL=automation-draft-prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"automation-draft-prompt.js","names":[],"sources":["../../../../src/automations/draft/automation-draft-prompt.ts"],"sourcesContent":["export interface AutomationDraftRepairIssue {\n  source: 'parse' | 'validation';\n  severity: 'error';\n  message: string;\n}\n\nexport function buildAutomationDraftPrompt(params: {\n  prompt: string;\n  language?: 'en' | 'zh';\n}): string {\n  return `You generate xopc automation drafts. Return ONLY a JSON object, no markdown.\n\nJSON shape:\n{\n  \"automation\": {\n    \"name\": \"Short human name\",\n    \"description\": \"What this automation does\",\n    \"trigger\": { \"kind\": \"manual\" },\n    \"action\": { \"kind\": \"agent\", \"instruction\": \"clear instruction for the agent\" },\n    \"safety\": { \"mode\": \"suggest_only\" },\n    \"afterRun\": { \"kind\": \"none\" },\n    \"reliability\": { \"timeoutSeconds\": 300, \"disableAfterConsecutiveFailures\": 3 }\n  },\n  \"explanation\": \"Short explanation\",\n  \"assumptions\": [\"...\"],\n  \"risks\": [\"...\"]\n}\n\nAllowed triggers:\n- Manual: { \"kind\": \"manual\" }\n- Schedule interval: { \"kind\": \"schedule\", \"schedule\": { \"kind\": \"interval\", \"everyMs\": 3600000 } }\n- Schedule cron: { \"kind\": \"schedule\", \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 9 * * *\" } }\n- Webhook: { \"kind\": \"webhook\", \"secretId\": \"optional-short-id\" }\n- Product event: { \"kind\": \"event\", \"eventType\": \"goal.status_changed\", \"source\": \"goals\", \"payloadMatch\": { \"status\": \"blocked\" } }\n\nUseful product events:\n- session.message.created\n- session.transcript.updated\n- note.created\n- note.updated\n- goal.created\n- goal.status_changed\n- workflow.run.completed\n- channel.message.received\n\nAllowed actions:\n- Agent: { \"kind\": \"agent\", \"agentId\": \"optional\", \"instruction\": \"what to do\", \"timeoutSeconds\": 300 }\n- Workflow: { \"kind\": \"workflow\", \"workflowId\": \"known_workflow_id\", \"input\": {}, \"goal\": \"optional\", \"timeoutSeconds\": 300 }\n\nSafety modes:\n- { \"mode\": \"suggest_only\" }: safest default, generate recommendations only.\n- { \"mode\": \"ask_before_apply\" }: draft actions and require user confirmation before applying.\n- { \"mode\": \"auto_apply\" }: trusted automation may act automatically.\n\nRules:\n- Prefer agent actions unless the user names a specific existing workflow id.\n- Default to safety { \"mode\": \"suggest_only\" } unless the user explicitly asks for fully automatic execution.\n- Do not invent destructive actions. For deletion, external sending, or irreversible changes, include a risk and make the instruction ask for confirmation.\n- Use cron for daily/weekly schedules. Use standard 5-field cron.\n- Keep timeoutSeconds between 60 and 1800.\n- afterRun should usually be { \"kind\": \"none\" }.\n- Language for user-facing copy: ${params.language ?? 'en'}.\n\nUser request:\n${params.prompt.slice(0, 8000)}\n`;\n}\n\nexport function buildAutomationDraftRepairPrompt(params: {\n  prompt: string;\n  language?: 'en' | 'zh';\n  previousOutput: string;\n  issues: AutomationDraftRepairIssue[];\n}): string {\n  return `Repair the xopc automation draft. Return ONLY a JSON object with the same shape.\n\nOriginal user request:\n${params.prompt.slice(0, 8000)}\n\nLanguage for user-facing copy: ${params.language ?? 'en'}\n\nPrevious output:\n${params.previousOutput.slice(0, 12000)}\n\nIssues:\n${params.issues.map((issue) => `- ${issue.source}: ${issue.message}`).join('\\n')}\n`;\n}\n\nexport function buildAutomationRunRepairPrompt(params: {\n  language?: 'en' | 'zh';\n  automation: unknown;\n  run: unknown;\n  events: unknown[];\n}): string {\n  return `You suggest safe repair patches for xopc automations. Return ONLY a JSON object, no markdown.\n\nJSON shape:\n{\n  \"patch\": {\n    \"description\": \"optional improved description\",\n    \"trigger\": \"optional complete trigger object\",\n    \"action\": \"optional complete action object\",\n    \"safety\": \"optional complete safety object\",\n    \"afterRun\": \"optional complete afterRun object\",\n    \"reliability\": \"optional complete reliability object\",\n    \"enabled\": true\n  },\n  \"explanation\": \"Why this patch should fix the failed run\",\n  \"expectedEffect\": \"What changes after applying it\",\n  \"risks\": [\"...\"],\n  \"requiresApproval\": true\n}\n\nRules:\n- Return a PATCH only. Do not include id, state, createdAtMs, or updatedAtMs.\n- Keep the patch minimal. Prefer reliability/action/input fixes over broad rewrites.\n- If the failure is unclear, propose only a safer timeout/retry/description patch and explain uncertainty.\n- Never add destructive or external behavior. If the existing automation has risky external behavior, keep requiresApproval true.\n- Language for user-facing copy: ${params.language ?? 'en'}.\n\nCurrent automation:\n${JSON.stringify(params.automation, null, 2).slice(0, 12000)}\n\nFailed run:\n${JSON.stringify(params.run, null, 2).slice(0, 8000)}\n\nTimeline events:\n${JSON.stringify(params.events, null, 2).slice(0, 12000)}\n`;\n}\n\nexport function buildAutomationRunRepairRetryPrompt(params: {\n  language?: 'en' | 'zh';\n  previousOutput: string;\n  issues: AutomationDraftRepairIssue[];\n}): string {\n  return `Repair the automation repair patch. Return ONLY a JSON object with the same shape.\n\nLanguage for user-facing copy: ${params.language ?? 'en'}\n\nPrevious output:\n${params.previousOutput.slice(0, 12000)}\n\nIssues:\n${params.issues.map((issue) => `- ${issue.source}: ${issue.message}`).join('\\n')}\n`;\n}\n"],"mappings":";AAMA,SAAgB,2BAA2B,QAGhC;AACT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmD0B,OAAO,YAAY,KAAK;;;EAGzD,OAAO,OAAO,MAAM,GAAG,IAAK,CAAC;;;AAI/B,SAAgB,iCAAiC,QAKtC;AACT,QAAO;;;EAGP,OAAO,OAAO,MAAM,GAAG,IAAK,CAAC;;iCAEE,OAAO,YAAY,KAAK;;;EAGvD,OAAO,eAAe,MAAM,GAAG,KAAM,CAAC;;;EAGtC,OAAO,OAAO,KAAK,UAAU,KAAK,MAAM,OAAO,IAAI,MAAM,UAAU,CAAC,KAAK,KAAK,CAAC;;;AAIjF,SAAgB,+BAA+B,QAKpC;AACT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;mCAwB0B,OAAO,YAAY,KAAK;;;EAGzD,KAAK,UAAU,OAAO,YAAY,MAAM,EAAE,CAAC,MAAM,GAAG,KAAM,CAAC;;;EAG3D,KAAK,UAAU,OAAO,KAAK,MAAM,EAAE,CAAC,MAAM,GAAG,IAAK,CAAC;;;EAGnD,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG,KAAM,CAAC;;;AAIzD,SAAgB,oCAAoC,QAIzC;AACT,QAAO;;iCAEwB,OAAO,YAAY,KAAK;;;EAGvD,OAAO,eAAe,MAAM,GAAG,KAAM,CAAC;;;EAGtC,OAAO,OAAO,KAAK,UAAU,KAAK,MAAM,OAAO,IAAI,MAAM,UAAU,CAAC,KAAK,KAAK,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { Config } from '../../config/schema.js';
+import type { AutomationDraftResponse, AutomationRepairDraftResponse, CreateAutomationDraftRequest, CreateAutomationRepairDraftRequest } from './automation-draft.types.js';
+export interface AutomationDraftServiceOptions {
+    config: Config;
+    maxRepairAttempts?: number;
+}
+export declare class AutomationDraftService {
+    private readonly options;
+    constructor(options: AutomationDraftServiceOptions);
+    createDraft(request: CreateAutomationDraftRequest, signal?: AbortSignal): Promise<AutomationDraftResponse>;
+    createRepairDraft(request: CreateAutomationRepairDraftRequest, signal?: AbortSignal): Promise<AutomationRepairDraftResponse>;
+}

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

@@ -0,0 +1,135 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
+import { resolveDraftModelRef } from "../../workflows/draft/workflow-draft-service.js";
+import { buildAutomationDraftPrompt, buildAutomationDraftRepairPrompt, buildAutomationRunRepairPrompt, buildAutomationRunRepairRetryPrompt } from "./automation-draft-prompt.js";
+import { buildAutomationDraftResponse, parseGeneratedAutomationDraft, parseGeneratedAutomationRepairDraft } from "./automation-draft-validator.js";
+import { complete } from "@earendil-works/pi-ai";
+//#region src/automations/draft/automation-draft-service.ts
+init_providers();
+init_logger();
+const log = createLogger("AutomationDraft");
+const DEFAULT_MAX_REPAIR_ATTEMPTS = 2;
+var AutomationDraftService = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async createDraft(request, signal) {
+		const prompt = request.prompt.trim();
+		if (!prompt) throw new Error("prompt is required");
+		const modelRef = resolveDraftModelRef(this.options.config, request.agentId);
+		const model = resolveModel(modelRef);
+		const maxRepairAttempts = this.options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;
+		let messageContent = buildAutomationDraftPrompt({
+			prompt,
+			language: request.language
+		});
+		let lastText = "";
+		let lastIssues = [];
+		for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {
+			lastText = extractText(await complete(model, { messages: [{
+				role: "user",
+				content: messageContent,
+				timestamp: Date.now()
+			}] }, {
+				maxTokens: 2048,
+				temperature: attempt === 0 ? .2 : .1,
+				signal
+			}));
+			try {
+				return buildAutomationDraftResponse(parseGeneratedAutomationDraft(lastText), attempt);
+			} catch (err) {
+				lastIssues = [{
+					source: "validation",
+					severity: "error",
+					message: err instanceof Error ? err.message : String(err)
+				}];
+			}
+			if (attempt >= maxRepairAttempts) break;
+			log.warn({
+				modelRef,
+				attempt: attempt + 1,
+				issueCount: lastIssues.length,
+				preview: lastText.slice(0, 500)
+			}, "Automation draft validation failed; asking model to repair");
+			messageContent = buildAutomationDraftRepairPrompt({
+				prompt,
+				language: request.language,
+				previousOutput: lastText,
+				issues: lastIssues
+			});
+		}
+		const message = `Unable to generate a valid automation draft after ${maxRepairAttempts + 1} attempts`;
+		log.warn({
+			modelRef,
+			issues: lastIssues,
+			preview: lastText.slice(0, 500)
+		}, message);
+		throw new Error(message);
+	}
+	async createRepairDraft(request, signal) {
+		const modelRef = resolveDraftModelRef(this.options.config, request.agentId);
+		const model = resolveModel(modelRef);
+		const maxRepairAttempts = this.options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;
+		let messageContent = buildAutomationRunRepairPrompt({
+			language: request.language,
+			automation: request.automation,
+			run: request.run,
+			events: request.events
+		});
+		let lastText = "";
+		let lastIssues = [];
+		for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {
+			lastText = extractText(await complete(model, { messages: [{
+				role: "user",
+				content: messageContent,
+				timestamp: Date.now()
+			}] }, {
+				maxTokens: 2048,
+				temperature: attempt === 0 ? .15 : .05,
+				signal
+			}));
+			try {
+				return parseGeneratedAutomationRepairDraft(lastText, attempt);
+			} catch (err) {
+				lastIssues = [{
+					source: "validation",
+					severity: "error",
+					message: err instanceof Error ? err.message : String(err)
+				}];
+			}
+			if (attempt >= maxRepairAttempts) break;
+			log.warn({
+				modelRef,
+				attempt: attempt + 1,
+				issueCount: lastIssues.length,
+				preview: lastText.slice(0, 500)
+			}, "Automation repair draft validation failed; asking model to repair");
+			messageContent = buildAutomationRunRepairRetryPrompt({
+				language: request.language,
+				previousOutput: lastText,
+				issues: lastIssues
+			});
+		}
+		const message = `Unable to generate a valid automation repair draft after ${maxRepairAttempts + 1} attempts`;
+		log.warn({
+			modelRef,
+			issues: lastIssues,
+			preview: lastText.slice(0, 500)
+		}, message);
+		throw new Error(message);
+	}
+};
+function extractText(result) {
+	const content = result.content;
+	if (typeof content === "string") return content;
+	if (Array.isArray(content)) return content.map((item) => {
+		if (item && typeof item === "object" && item.type === "text") return String(item.text ?? "");
+		return "";
+	}).join("");
+	return "";
+}
+//#endregion
+export { AutomationDraftService };
+
+//# sourceMappingURL=automation-draft-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"automation-draft-service.js","names":[],"sources":["../../../../src/automations/draft/automation-draft-service.ts"],"sourcesContent":["import { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveDraftModelRef } from '../../workflows/draft/workflow-draft-service.js';\nimport {\n  buildAutomationDraftPrompt,\n  buildAutomationDraftRepairPrompt,\n  buildAutomationRunRepairPrompt,\n  buildAutomationRunRepairRetryPrompt,\n  type AutomationDraftRepairIssue,\n} from './automation-draft-prompt.js';\nimport type {\n  AutomationDraftResponse,\n  AutomationRepairDraftResponse,\n  CreateAutomationDraftRequest,\n  CreateAutomationRepairDraftRequest,\n} from './automation-draft.types.js';\nimport {\n  buildAutomationDraftResponse,\n  parseGeneratedAutomationDraft,\n  parseGeneratedAutomationRepairDraft,\n} from './automation-draft-validator.js';\n\nconst log = createLogger('AutomationDraft');\nconst DEFAULT_MAX_REPAIR_ATTEMPTS = 2;\n\nexport interface AutomationDraftServiceOptions {\n  config: Config;\n  maxRepairAttempts?: number;\n}\n\nexport class AutomationDraftService {\n  constructor(private readonly options: AutomationDraftServiceOptions) {}\n\n  async createDraft(request: CreateAutomationDraftRequest, signal?: AbortSignal): Promise<AutomationDraftResponse> {\n    const prompt = request.prompt.trim();\n    if (!prompt) throw new Error('prompt is required');\n\n    const modelRef = resolveDraftModelRef(this.options.config, request.agentId);\n    const model = resolveModel(modelRef);\n    const maxRepairAttempts = this.options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;\n    let messageContent = buildAutomationDraftPrompt({ prompt, language: request.language });\n    let lastText = '';\n    let lastIssues: AutomationDraftRepairIssue[] = [];\n\n    for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {\n      const userMsg: UserMessage = {\n        role: 'user',\n        content: messageContent,\n        timestamp: Date.now(),\n      };\n      const result = await complete(\n        model,\n        { messages: [userMsg] },\n        { maxTokens: 2048, temperature: attempt === 0 ? 0.2 : 0.1, signal },\n      );\n      lastText = extractText(result);\n      try {\n        const draft = parseGeneratedAutomationDraft(lastText);\n        return buildAutomationDraftResponse(draft, attempt);\n      } catch (err) {\n        lastIssues = [{\n          source: 'validation',\n          severity: 'error',\n          message: err instanceof Error ? err.message : String(err),\n        }];\n      }\n\n      if (attempt >= maxRepairAttempts) break;\n      log.warn(\n        { modelRef, attempt: attempt + 1, issueCount: lastIssues.length, preview: lastText.slice(0, 500) },\n        'Automation draft validation failed; asking model to repair',\n      );\n      messageContent = buildAutomationDraftRepairPrompt({\n        prompt,\n        language: request.language,\n        previousOutput: lastText,\n        issues: lastIssues,\n      });\n    }\n\n    const message = `Unable to generate a valid automation draft after ${maxRepairAttempts + 1} attempts`;\n    log.warn({ modelRef, issues: lastIssues, preview: lastText.slice(0, 500) }, message);\n    throw new Error(message);\n  }\n\n  async createRepairDraft(\n    request: CreateAutomationRepairDraftRequest,\n    signal?: AbortSignal,\n  ): Promise<AutomationRepairDraftResponse> {\n    const modelRef = resolveDraftModelRef(this.options.config, request.agentId);\n    const model = resolveModel(modelRef);\n    const maxRepairAttempts = this.options.maxRepairAttempts ?? DEFAULT_MAX_REPAIR_ATTEMPTS;\n    let messageContent = buildAutomationRunRepairPrompt({\n      language: request.language,\n      automation: request.automation,\n      run: request.run,\n      events: request.events,\n    });\n    let lastText = '';\n    let lastIssues: AutomationDraftRepairIssue[] = [];\n\n    for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {\n      const userMsg: UserMessage = {\n        role: 'user',\n        content: messageContent,\n        timestamp: Date.now(),\n      };\n      const result = await complete(\n        model,\n        { messages: [userMsg] },\n        { maxTokens: 2048, temperature: attempt === 0 ? 0.15 : 0.05, signal },\n      );\n      lastText = extractText(result);\n      try {\n        return parseGeneratedAutomationRepairDraft(lastText, attempt);\n      } catch (err) {\n        lastIssues = [{\n          source: 'validation',\n          severity: 'error',\n          message: err instanceof Error ? err.message : String(err),\n        }];\n      }\n\n      if (attempt >= maxRepairAttempts) break;\n      log.warn(\n        { modelRef, attempt: attempt + 1, issueCount: lastIssues.length, preview: lastText.slice(0, 500) },\n        'Automation repair draft validation failed; asking model to repair',\n      );\n      messageContent = buildAutomationRunRepairRetryPrompt({\n        language: request.language,\n        previousOutput: lastText,\n        issues: lastIssues,\n      });\n    }\n\n    const message = `Unable to generate a valid automation repair draft after ${maxRepairAttempts + 1} attempts`;\n    log.warn({ modelRef, issues: lastIssues, preview: lastText.slice(0, 500) }, message);\n    throw new Error(message);\n  }\n}\n\nfunction extractText(result: unknown): string {\n  const content = (result as { content?: unknown }).content;\n  if (typeof content === 'string') return content;\n  if (Array.isArray(content)) {\n    return content.map((item) => {\n      if (item && typeof item === 'object' && (item as { type?: string }).type === 'text') {\n        return String((item as { text?: string }).text ?? '');\n      }\n      return '';\n    }).join('');\n  }\n  return '';\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,99 @@
+import type { CreateAutomationInput } from '../domain/validation.js';
+import type { AutomationRepairDraftResponse, AutomationSimulation } from './automation-draft.types.js';
+interface GeneratedAutomationDraft {
+    automation: CreateAutomationInput;
+    explanation: string;
+    assumptions: string[];
+    risks: string[];
+}
+export declare function parseGeneratedAutomationDraft(raw: string): GeneratedAutomationDraft;
+export declare function buildAutomationDraftResponse(draft: GeneratedAutomationDraft, repairAttempts: number): {
+    draftId: `${string}-${string}-${string}-${string}-${string}`;
+    automation: {
+        name: string;
+        description?: string;
+        trigger?: {
+            kind: "manual";
+        } | {
+            kind: "schedule";
+            schedule?: {
+                kind: "once";
+                at: string;
+            } | {
+                kind: "interval";
+                everyMs: number;
+                anchorMs?: number;
+            } | {
+                kind: "cron";
+                expr: string;
+                tz?: string;
+            };
+        } | {
+            kind: "webhook";
+            secretId?: string;
+        } | {
+            kind: "event";
+            eventType: string;
+            source?: string;
+            payloadMatch?: Record<string, string | number | boolean>;
+        };
+        action?: {
+            kind: "agent";
+            instruction: string;
+            agentId?: string;
+            workingDirectory?: string;
+            model?: string;
+            timeoutSeconds?: number;
+        } | {
+            kind: "workflow";
+            workflowId: string;
+            agentId?: string;
+            input?: unknown;
+            inputEnvelope?: {
+                payload: unknown;
+                goal?: string;
+                variables?: Record<string, unknown>;
+                context?: Record<string, unknown>;
+            };
+            goal?: string;
+            concurrency?: number;
+            maxSubagents?: number;
+            timeoutSeconds?: number;
+        };
+        safety?: {
+            mode: "suggest_only" | "ask_before_apply" | "auto_apply";
+        };
+        afterRun?: {
+            kind: "none";
+        } | {
+            kind: "saveToSession";
+        } | {
+            kind: "webhook";
+            url: string;
+        };
+        reliability?: {
+            timeoutSeconds?: number;
+            retryCount?: number;
+            maxConcurrentRuns?: number;
+            disableAfterConsecutiveFailures?: number;
+        };
+        id?: string;
+        enabled?: boolean;
+        state?: {
+            nextRunAtMs?: number;
+            runningRunId?: string;
+            lastRunAtMs?: number;
+            lastRunStatus?: "timeout" | "failed" | "queued" | "running" | "succeeded" | "cancelled";
+            lastError?: string;
+            consecutiveFailures?: number;
+        };
+    };
+    explanation: string;
+    assumptions: string[];
+    risks: string[];
+    simulation: AutomationSimulation;
+    repairAttempts: number;
+};
+export declare function parseGeneratedAutomationRepairDraft(raw: string, repairAttempts: number): AutomationRepairDraftResponse;
+export declare function simulateAutomation(input: CreateAutomationInput): AutomationSimulation;
+export {};

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;
+}