@xopcai/xopc 0.0.106 → 0.0.107

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

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

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

@@ -0,0 +1,3 @@
+import { buildWorkflowDraftResponse, lintWorkflowDraft, parseGeneratedWorkflowDraft } from "./workflow-draft-validator.js";
+import { WorkflowDraftService, resolveDraftModelRef } from "./workflow-draft-service.js";
+export { WorkflowDraftService, buildWorkflowDraftResponse, lintWorkflowDraft, parseGeneratedWorkflowDraft, resolveDraftModelRef };

package/dist/src/workflows/draft/workflow-draft-prompt.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowDraftConstraints, WorkflowDraftMode } from './workflow-draft.types.js';
+export interface WorkflowDraftRepairIssue {
+    source: 'parse' | 'validation' | 'lint';
+    severity: 'error' | 'warning';
+    code: string;
+    message: string;
+    line?: number;
+    column?: number;
+}
+export declare function buildWorkflowDraftPrompt(params: {
+    prompt: string;
+    language?: 'en' | 'zh';
+    mode: WorkflowDraftMode;
+    existingScript?: string;
+    constraints?: WorkflowDraftConstraints;
+}): string;
+export declare function buildWorkflowDraftRepairPrompt(params: {
+    prompt: string;
+    language?: 'en' | 'zh';
+    constraints?: WorkflowDraftConstraints;
+    previousOutput: string;
+    issues: WorkflowDraftRepairIssue[];
+}): string;

package/dist/src/workflows/draft/workflow-draft-prompt.js

@@ -0,0 +1,98 @@
+//#region src/workflows/draft/workflow-draft-prompt.ts
+function buildWorkflowDraftPrompt(params) {
+	return `You generate xopc workflow drafts. Return ONLY a JSON object, no markdown.
+
+JSON shape:
+{
+  "name": "lowercase_snake_case",
+  "script": "workflow JavaScript DSL",
+  "manifest": {
+    "title": "Human title",
+    "description": "What it does",
+    "version": "1.0.0",
+    "inputSchema": { "type": "object", "properties": {}, "required": [] },
+    "outputSchema": { "type": "object", "properties": { "summary": { "type": "string" } }, "required": ["summary"] },
+    "defaults": { "concurrency": 2, "timeoutSec": 1800, "maxSubagents": 8 },
+    "permissions": { "network": false, "fileSystem": "read", "approvalRequired": false },
+    "tags": ["custom"],
+    "whenToUse": "When to use this workflow"
+  },
+  "explanation": "Short explanation",
+  "assumptions": ["..."],
+  "risks": ["..."]
+}
+
+DSL rules:
+- script MUST start with: export const meta = { name, description, phases, tags, estimatedAgents }
+- The top-level JSON "name" MUST exactly equal script meta.name.
+- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.
+- Read user inputs from args, e.g. args.goal, args.branch, args.audience.
+- Each agent needs a clear label.
+- Keep concurrency conservative; prefer 2-4.
+- Return a WorkflowResultEnvelope-like object: { summary, sections, followUps?, structuredOutput? }.
+- Do not use import, require, eval, Function, process.env, fs, http, fetch.
+- If network/write/destructive behavior is requested, mark manifest.permissions.approvalRequired = true.
+- Keep script self-contained and valid JavaScript.
+
+Mode: ${params.mode}
+Language for user-facing copy: ${params.language ?? "en"}
+Constraints:
+${JSON.stringify(params.constraints ?? {}, null, 2)}
+
+${params.existingScript ? `Existing script to improve:\n${params.existingScript.slice(0, 12e3)}\n` : ""}
+
+User request:
+${params.prompt.slice(0, 8e3)}
+`;
+}
+function buildWorkflowDraftRepairPrompt(params) {
+	return `You must repair an xopc workflow draft so it passes validation. Return ONLY a corrected JSON object, no markdown.
+
+Required JSON shape is unchanged:
+{
+  "name": "lowercase_snake_case",
+  "script": "workflow JavaScript DSL",
+  "manifest": {
+    "title": "Human title",
+    "description": "What it does",
+    "version": "1.0.0",
+    "inputSchema": { "type": "object", "properties": {}, "required": [] },
+    "outputSchema": { "type": "object", "properties": { "summary": { "type": "string" } }, "required": ["summary"] },
+    "defaults": { "concurrency": 2, "timeoutSec": 1800, "maxSubagents": 8 },
+    "permissions": { "network": false, "fileSystem": "read", "approvalRequired": false },
+    "tags": ["custom"],
+    "whenToUse": "When to use this workflow"
+  },
+  "explanation": "Short explanation",
+  "assumptions": ["..."],
+  "risks": ["..."]
+}
+
+Hard requirements:
+- The output MUST be valid JSON.
+- JSON name MUST be lowercase snake_case and MUST exactly equal script meta.name.
+- script MUST be valid JavaScript for the xopc workflow DSL.
+- script MUST start with export const meta = { ... } and include phases, tags, estimatedAgents.
+- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.
+- Do not use import, require, eval, Function, process.env, fs, http, fetch.
+- Respect the constraints exactly. If network is disabled, manifest.permissions.network must be false.
+- Preserve the user's intent while making the smallest change needed to pass validation.
+
+Language for user-facing copy: ${params.language ?? "en"}
+Constraints:
+${JSON.stringify(params.constraints ?? {}, null, 2)}
+
+Validation and lint issues to fix:
+${JSON.stringify(params.issues, null, 2)}
+
+Original user request:
+${params.prompt.slice(0, 8e3)}
+
+Previous model output:
+${params.previousOutput.slice(0, 12e3)}
+`;
+}
+//#endregion
+export { buildWorkflowDraftPrompt, buildWorkflowDraftRepairPrompt };
+
+//# sourceMappingURL=workflow-draft-prompt.js.map

package/dist/src/workflows/draft/workflow-draft-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft-prompt.js","names":[],"sources":["../../../../src/workflows/draft/workflow-draft-prompt.ts"],"sourcesContent":["import type { WorkflowDraftConstraints, WorkflowDraftMode } from './workflow-draft.types.js';\n\nexport interface WorkflowDraftRepairIssue {\n  source: 'parse' | 'validation' | 'lint';\n  severity: 'error' | 'warning';\n  code: string;\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport function buildWorkflowDraftPrompt(params: {\n  prompt: string;\n  language?: 'en' | 'zh';\n  mode: WorkflowDraftMode;\n  existingScript?: string;\n  constraints?: WorkflowDraftConstraints;\n}): string {\n  return `You generate xopc workflow drafts. Return ONLY a JSON object, no markdown.\n\nJSON shape:\n{\n  \"name\": \"lowercase_snake_case\",\n  \"script\": \"workflow JavaScript DSL\",\n  \"manifest\": {\n    \"title\": \"Human title\",\n    \"description\": \"What it does\",\n    \"version\": \"1.0.0\",\n    \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] },\n    \"outputSchema\": { \"type\": \"object\", \"properties\": { \"summary\": { \"type\": \"string\" } }, \"required\": [\"summary\"] },\n    \"defaults\": { \"concurrency\": 2, \"timeoutSec\": 1800, \"maxSubagents\": 8 },\n    \"permissions\": { \"network\": false, \"fileSystem\": \"read\", \"approvalRequired\": false },\n    \"tags\": [\"custom\"],\n    \"whenToUse\": \"When to use this workflow\"\n  },\n  \"explanation\": \"Short explanation\",\n  \"assumptions\": [\"...\"],\n  \"risks\": [\"...\"]\n}\n\nDSL rules:\n- script MUST start with: export const meta = { name, description, phases, tags, estimatedAgents }\n- The top-level JSON \"name\" MUST exactly equal script meta.name.\n- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.\n- Read user inputs from args, e.g. args.goal, args.branch, args.audience.\n- Each agent needs a clear label.\n- Keep concurrency conservative; prefer 2-4.\n- Return a WorkflowResultEnvelope-like object: { summary, sections, followUps?, structuredOutput? }.\n- Do not use import, require, eval, Function, process.env, fs, http, fetch.\n- If network/write/destructive behavior is requested, mark manifest.permissions.approvalRequired = true.\n- Keep script self-contained and valid JavaScript.\n\nMode: ${params.mode}\nLanguage for user-facing copy: ${params.language ?? 'en'}\nConstraints:\n${JSON.stringify(params.constraints ?? {}, null, 2)}\n\n${params.existingScript ? `Existing script to improve:\\n${params.existingScript.slice(0, 12000)}\\n` : ''}\n\nUser request:\n${params.prompt.slice(0, 8000)}\n`;\n}\n\nexport function buildWorkflowDraftRepairPrompt(params: {\n  prompt: string;\n  language?: 'en' | 'zh';\n  constraints?: WorkflowDraftConstraints;\n  previousOutput: string;\n  issues: WorkflowDraftRepairIssue[];\n}): string {\n  return `You must repair an xopc workflow draft so it passes validation. Return ONLY a corrected JSON object, no markdown.\n\nRequired JSON shape is unchanged:\n{\n  \"name\": \"lowercase_snake_case\",\n  \"script\": \"workflow JavaScript DSL\",\n  \"manifest\": {\n    \"title\": \"Human title\",\n    \"description\": \"What it does\",\n    \"version\": \"1.0.0\",\n    \"inputSchema\": { \"type\": \"object\", \"properties\": {}, \"required\": [] },\n    \"outputSchema\": { \"type\": \"object\", \"properties\": { \"summary\": { \"type\": \"string\" } }, \"required\": [\"summary\"] },\n    \"defaults\": { \"concurrency\": 2, \"timeoutSec\": 1800, \"maxSubagents\": 8 },\n    \"permissions\": { \"network\": false, \"fileSystem\": \"read\", \"approvalRequired\": false },\n    \"tags\": [\"custom\"],\n    \"whenToUse\": \"When to use this workflow\"\n  },\n  \"explanation\": \"Short explanation\",\n  \"assumptions\": [\"...\"],\n  \"risks\": [\"...\"]\n}\n\nHard requirements:\n- The output MUST be valid JSON.\n- JSON name MUST be lowercase snake_case and MUST exactly equal script meta.name.\n- script MUST be valid JavaScript for the xopc workflow DSL.\n- script MUST start with export const meta = { ... } and include phases, tags, estimatedAgents.\n- Use only these globals: phase(title), agent(prompt, opts), parallel([() => agent(...)]), pipeline(items, ...stages), log(message), budget, args.\n- Do not use import, require, eval, Function, process.env, fs, http, fetch.\n- Respect the constraints exactly. If network is disabled, manifest.permissions.network must be false.\n- Preserve the user's intent while making the smallest change needed to pass validation.\n\nLanguage for user-facing copy: ${params.language ?? 'en'}\nConstraints:\n${JSON.stringify(params.constraints ?? {}, null, 2)}\n\nValidation and lint issues to fix:\n${JSON.stringify(params.issues, null, 2)}\n\nOriginal user request:\n${params.prompt.slice(0, 8000)}\n\nPrevious model output:\n${params.previousOutput.slice(0, 12000)}\n`;\n}\n"],"mappings":";AAWA,SAAgB,yBAAyB,QAM9B;AACT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAkCD,OAAO,KAAK;iCACa,OAAO,YAAY,KAAK;;EAEvD,KAAK,UAAU,OAAO,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC;;EAElD,OAAO,iBAAiB,gCAAgC,OAAO,eAAe,MAAM,GAAG,KAAM,CAAC,MAAM,GAAG;;;EAGvG,OAAO,OAAO,MAAM,GAAG,IAAK,CAAC;;;AAI/B,SAAgB,+BAA+B,QAMpC;AACT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAgCwB,OAAO,YAAY,KAAK;;EAEvD,KAAK,UAAU,OAAO,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC;;;EAGlD,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE,CAAC;;;EAGvC,OAAO,OAAO,MAAM,GAAG,IAAK,CAAC;;;EAG7B,OAAO,eAAe,MAAM,GAAG,KAAM,CAAC"}

package/dist/src/workflows/draft/workflow-draft-service.d.ts

@@ -0,0 +1,12 @@
+import type { Config } from '../../config/schema.js';
+import type { CreateWorkflowDraftRequest, WorkflowDraftResponse } from './workflow-draft.types.js';
+export interface WorkflowDraftServiceOptions {
+    config: Config;
+    maxRepairAttempts?: number;
+}
+export declare class WorkflowDraftService {
+    private readonly options;
+    constructor(options: WorkflowDraftServiceOptions);
+    createDraft(request: CreateWorkflowDraftRequest, signal?: AbortSignal): Promise<WorkflowDraftResponse>;
+}
+export declare function resolveDraftModelRef(config: Config, agentId: string): string;

package/dist/src/workflows/draft/workflow-draft-service.js

@@ -0,0 +1,131 @@
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
+import { resolveModelRef } from "../../config/agent-typed-models.js";
+import { buildWorkflowDraftPrompt, buildWorkflowDraftRepairPrompt } from "./workflow-draft-prompt.js";
+import { buildWorkflowDraftResponse, parseGeneratedWorkflowDraft } from "./workflow-draft-validator.js";
+import { complete } from "@earendil-works/pi-ai";
+//#region src/workflows/draft/workflow-draft-service.ts
+init_schema();
+init_providers();
+init_logger();
+const log = createLogger("WorkflowDraft");
+const DEFAULT_MAX_REPAIR_ATTEMPTS = 2;
+var WorkflowDraftService = 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 = buildWorkflowDraftPrompt({
+			prompt,
+			language: request.language,
+			mode: request.mode ?? (request.existingScript ? "improve" : "create"),
+			existingScript: request.existingScript,
+			constraints: request.constraints
+		});
+		let lastIssues = [];
+		let lastText = "";
+		for (let attempt = 0; attempt <= maxRepairAttempts; attempt += 1) {
+			lastText = extractText(await complete(model, { messages: [{
+				role: "user",
+				content: messageContent,
+				timestamp: Date.now()
+			}] }, {
+				maxTokens: 4096,
+				temperature: attempt === 0 ? .25 : .1,
+				signal
+			}));
+			try {
+				const response = buildWorkflowDraftResponse(parseGeneratedWorkflowDraft(lastText), request.constraints);
+				const blockingIssues = getBlockingDraftIssues(response);
+				if (blockingIssues.length === 0) return {
+					...response,
+					repairAttempts: attempt
+				};
+				lastIssues = blockingIssues;
+			} catch (err) {
+				lastIssues = [{
+					source: "parse",
+					severity: "error",
+					code: "invalid_model_output",
+					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)
+			}, "Workflow draft validation failed; asking model to repair");
+			messageContent = buildWorkflowDraftRepairPrompt({
+				prompt,
+				language: request.language,
+				constraints: request.constraints,
+				previousOutput: lastText,
+				issues: lastIssues
+			});
+		}
+		const message = `Unable to generate a valid workflow draft after ${maxRepairAttempts + 1} attempts: ${formatRepairIssues(lastIssues)}`;
+		log.warn({
+			modelRef,
+			issues: lastIssues,
+			preview: lastText.slice(0, 500)
+		}, message);
+		throw new Error(message);
+	}
+};
+function resolveDraftModelRef(config, agentId) {
+	try {
+		return resolveModelRef(config, agentId, "large");
+	} catch {
+		return getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);
+	}
+}
+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 "";
+}
+function getBlockingDraftIssues(response) {
+	const validationIssues = [...response.validation.errors.map((issue) => ({
+		source: "validation",
+		severity: "error",
+		code: issue.code,
+		message: issue.message,
+		line: issue.line,
+		column: issue.column
+	})), ...response.validation.warnings.map((issue) => ({
+		source: "validation",
+		severity: "warning",
+		code: issue.code,
+		message: issue.message,
+		line: issue.line,
+		column: issue.column
+	}))];
+	const lintIssues = response.lint.filter((issue) => issue.severity === "error").map((issue) => ({
+		source: "lint",
+		severity: issue.severity,
+		code: issue.code,
+		message: issue.message
+	}));
+	return [...validationIssues, ...lintIssues];
+}
+function formatRepairIssues(issues) {
+	if (issues.length === 0) return "unknown validation failure";
+	return issues.slice(0, 5).map((issue) => `${issue.source}:${issue.code}: ${issue.message}`).join("; ");
+}
+//#endregion
+export { WorkflowDraftService, resolveDraftModelRef };
+
+//# sourceMappingURL=workflow-draft-service.js.map

package/dist/src/workflows/draft/workflow-draft-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft-service.js","names":[],"sources":["../../../../src/workflows/draft/workflow-draft-service.ts"],"sourcesContent":["import { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport { resolveModelRef } from '../../config/agent-typed-models.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport {\n  buildWorkflowDraftPrompt,\n  buildWorkflowDraftRepairPrompt,\n  type WorkflowDraftRepairIssue,\n} from './workflow-draft-prompt.js';\nimport type { CreateWorkflowDraftRequest, WorkflowDraftResponse } from './workflow-draft.types.js';\nimport { buildWorkflowDraftResponse, parseGeneratedWorkflowDraft } from './workflow-draft-validator.js';\n\nconst log = createLogger('WorkflowDraft');\nconst DEFAULT_MAX_REPAIR_ATTEMPTS = 2;\n\nexport interface WorkflowDraftServiceOptions {\n  config: Config;\n  maxRepairAttempts?: number;\n}\n\nexport class WorkflowDraftService {\n  constructor(private readonly options: WorkflowDraftServiceOptions) {}\n\n  async createDraft(request: CreateWorkflowDraftRequest, signal?: AbortSignal): Promise<WorkflowDraftResponse> {\n    const prompt = request.prompt.trim();\n    if (!prompt) throw new Error('prompt is required');\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 = buildWorkflowDraftPrompt({\n      prompt,\n      language: request.language,\n      mode: request.mode ?? (request.existingScript ? 'improve' : 'create'),\n      existingScript: request.existingScript,\n      constraints: request.constraints,\n    });\n    let lastIssues: WorkflowDraftRepairIssue[] = [];\n    let lastText = '';\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: 4096, temperature: attempt === 0 ? 0.25 : 0.1, signal: signal as AbortSignal },\n      );\n      lastText = extractText(result);\n      try {\n        const draft = parseGeneratedWorkflowDraft(lastText);\n        const response = buildWorkflowDraftResponse(draft, request.constraints);\n        const blockingIssues = getBlockingDraftIssues(response);\n        if (blockingIssues.length === 0) {\n          return { ...response, repairAttempts: attempt };\n        }\n        lastIssues = blockingIssues;\n      } catch (err) {\n        lastIssues = [{\n          source: 'parse',\n          severity: 'error',\n          code: 'invalid_model_output',\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        'Workflow draft validation failed; asking model to repair',\n      );\n      messageContent = buildWorkflowDraftRepairPrompt({\n        prompt,\n        language: request.language,\n        constraints: request.constraints,\n        previousOutput: lastText,\n        issues: lastIssues,\n      });\n    }\n\n    const message = `Unable to generate a valid workflow draft after ${maxRepairAttempts + 1} attempts: ${formatRepairIssues(lastIssues)}`;\n    log.warn({ modelRef, issues: lastIssues, preview: lastText.slice(0, 500) }, message);\n    throw new Error(message);\n  }\n}\n\nexport function resolveDraftModelRef(config: Config, agentId: string): string {\n  try {\n    return resolveModelRef(config, agentId, 'large');\n  } catch {\n    return getAgentDefaultModelRef(config) ?? getDefaultModelSync(config);\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\nfunction getBlockingDraftIssues(response: WorkflowDraftResponse): WorkflowDraftRepairIssue[] {\n  const validationIssues: WorkflowDraftRepairIssue[] = [\n    ...response.validation.errors.map((issue) => ({\n      source: 'validation' as const,\n      severity: 'error' as const,\n      code: issue.code,\n      message: issue.message,\n      line: issue.line,\n      column: issue.column,\n    })),\n    ...response.validation.warnings.map((issue) => ({\n      source: 'validation' as const,\n      severity: 'warning' as const,\n      code: issue.code,\n      message: issue.message,\n      line: issue.line,\n      column: issue.column,\n    })),\n  ];\n  const lintIssues = response.lint\n    .filter((issue) => issue.severity === 'error')\n    .map((issue) => ({\n      source: 'lint' as const,\n      severity: issue.severity,\n      code: issue.code,\n      message: issue.message,\n    }));\n  return [...validationIssues, ...lintIssues];\n}\n\nfunction formatRepairIssues(issues: WorkflowDraftRepairIssue[]): string {\n  if (issues.length === 0) return 'unknown validation failure';\n  return issues.slice(0, 5).map((issue) => `${issue.source}:${issue.code}: ${issue.message}`).join('; ');\n}\n"],"mappings":"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"}

package/dist/src/workflows/draft/workflow-draft-validator.d.ts

@@ -0,0 +1,4 @@
+import type { GeneratedWorkflowDraft, WorkflowDraftConstraints, WorkflowDraftLintIssue, WorkflowDraftResponse } from './workflow-draft.types.js';
+export declare function parseGeneratedWorkflowDraft(raw: string): GeneratedWorkflowDraft;
+export declare function buildWorkflowDraftResponse(draft: GeneratedWorkflowDraft, constraints?: WorkflowDraftConstraints): WorkflowDraftResponse;
+export declare function lintWorkflowDraft(draft: GeneratedWorkflowDraft, constraints?: WorkflowDraftConstraints): WorkflowDraftLintIssue[];

package/dist/src/workflows/draft/workflow-draft-validator.js

@@ -0,0 +1,133 @@
+import { validateWorkflowDefinitionInput } from "../domain/validation.js";
+import { randomUUID } from "node:crypto";
+//#region src/workflows/draft/workflow-draft-validator.ts
+function parseGeneratedWorkflowDraft(raw) {
+	const json = extractJsonObject(raw);
+	const parsed = JSON.parse(json);
+	return {
+		name: normalizeWorkflowName(String(parsed.name ?? "custom_workflow")),
+		script: String(parsed.script ?? "").trim(),
+		manifest: normalizeManifest(parsed.manifest),
+		explanation: String(parsed.explanation ?? ""),
+		assumptions: stringArray(parsed.assumptions),
+		risks: stringArray(parsed.risks)
+	};
+}
+function buildWorkflowDraftResponse(draft, constraints) {
+	const validation = validateWorkflowDefinitionInput({
+		name: draft.name,
+		script: draft.script
+	});
+	const lint = lintWorkflowDraft(draft, constraints);
+	return {
+		draftId: randomUUID(),
+		repairAttempts: 0,
+		...draft,
+		permissionsSummary: summarizePermissions(draft.manifest),
+		validation,
+		lint,
+		suggestedInputs: suggestedInputsFromManifest(draft.manifest)
+	};
+}
+function lintWorkflowDraft(draft, constraints) {
+	const issues = [];
+	const { manifest, script } = draft;
+	if (!manifest.inputSchema) issues.push({
+		severity: "warning",
+		code: "missing_input_schema",
+		message: "Draft does not define an input schema."
+	});
+	if (!manifest.outputSchema) issues.push({
+		severity: "warning",
+		code: "missing_output_schema",
+		message: "Draft does not define an output schema."
+	});
+	if (manifest.permissions?.network && constraints?.allowNetwork === false) issues.push({
+		severity: "error",
+		code: "unsafe_permission",
+		message: "Draft requests network access, but network is disabled by constraints."
+	});
+	if (manifest.permissions?.fileSystem === "write" && constraints?.fileSystem !== "write") issues.push({
+		severity: "warning",
+		code: "unsafe_permission",
+		message: "Draft requests filesystem write access."
+	});
+	const phaseCount = (script.match(/\bphase\s*\(/g) ?? []).length;
+	if (constraints?.maxPhases && phaseCount > constraints.maxPhases) issues.push({
+		severity: "warning",
+		code: "too_many_agents",
+		message: `Draft has ${phaseCount} phases, above requested ${constraints.maxPhases}.`
+	});
+	const agentCount = (script.match(/\bagent\s*\(/g) ?? []).length;
+	if (constraints?.maxSubagents && agentCount > constraints.maxSubagents) issues.push({
+		severity: "warning",
+		code: "too_many_agents",
+		message: `Draft starts ${agentCount} agents, above requested ${constraints.maxSubagents}.`
+	});
+	if (/parallel\s*\([^[]/.test(script)) issues.push({
+		severity: "warning",
+		code: "unbounded_parallelism",
+		message: "parallel() should receive a bounded array of thunks."
+	});
+	if (constraints?.allowedTools?.length) {
+		const unknown = collectToolsetNames(script).filter((tool) => !constraints.allowedTools.includes(tool));
+		for (const tool of [...new Set(unknown)]) issues.push({
+			severity: "warning",
+			code: "unknown_tool",
+			message: `Tool '${tool}' is outside the requested allowlist.`
+		});
+	}
+	return issues;
+}
+function extractJsonObject(raw) {
+	const trimmed = raw.trim();
+	if (trimmed.startsWith("{") && trimmed.endsWith("}")) return trimmed;
+	const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i)?.[1]?.trim();
+	if (fenced?.startsWith("{")) return fenced;
+	const start = trimmed.indexOf("{");
+	const end = trimmed.lastIndexOf("}");
+	if (start >= 0 && end > start) return trimmed.slice(start, end + 1);
+	throw new Error("Model did not return a JSON object.");
+}
+function normalizeManifest(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+	return value;
+}
+function stringArray(value) {
+	return Array.isArray(value) ? value.map((item) => String(item)).filter(Boolean) : [];
+}
+function normalizeWorkflowName(value) {
+	const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+	return /^[a-z]/.test(normalized) ? normalized : `workflow_${normalized || "draft"}`;
+}
+function summarizePermissions(manifest) {
+	const permissions = manifest.permissions;
+	if (!permissions) return ["No explicit permissions requested."];
+	const out = [];
+	if (permissions.tools?.length) out.push(`Tools: ${permissions.tools.join(", ")}`);
+	if (permissions.network != null) out.push(`Network: ${permissions.network ? "enabled" : "disabled"}`);
+	if (permissions.fileSystem) out.push(`Filesystem: ${permissions.fileSystem}`);
+	if (permissions.approvalRequired) out.push("Approval required");
+	return out.length > 0 ? out : ["No explicit permissions requested."];
+}
+function suggestedInputsFromManifest(manifest) {
+	const properties = manifest.inputSchema?.properties;
+	if (!properties) return void 0;
+	return Object.entries(properties).slice(0, 8).map(([key, schema]) => ({
+		key,
+		label: typeof schema.title === "string" ? schema.title : key,
+		example: typeof schema.default === "string" ? schema.default : schema.description ?? ""
+	}));
+}
+function collectToolsetNames(script) {
+	const out = [];
+	for (const match of script.matchAll(/toolset\s*:\s*\[([^\]]*)\]/g)) {
+		const body = match[1] ?? "";
+		for (const item of body.matchAll(/['"]([^'"]+)['"]/g)) out.push(item[1] ?? "");
+	}
+	return out.filter(Boolean);
+}
+//#endregion
+export { buildWorkflowDraftResponse, lintWorkflowDraft, parseGeneratedWorkflowDraft };
+
+//# sourceMappingURL=workflow-draft-validator.js.map

package/dist/src/workflows/draft/workflow-draft-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft-validator.js","names":[],"sources":["../../../../src/workflows/draft/workflow-draft-validator.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { validateWorkflowDefinitionInput } from '../domain/validation.js';\nimport type { WorkflowDefinitionManifest } from '../domain/definition.js';\n\nimport type {\n  GeneratedWorkflowDraft,\n  WorkflowDraftConstraints,\n  WorkflowDraftLintIssue,\n  WorkflowDraftResponse,\n} from './workflow-draft.types.js';\n\nexport function parseGeneratedWorkflowDraft(raw: string): GeneratedWorkflowDraft {\n  const json = extractJsonObject(raw);\n  const parsed = JSON.parse(json) as Partial<GeneratedWorkflowDraft>;\n  const name = normalizeWorkflowName(String(parsed.name ?? 'custom_workflow'));\n  const script = String(parsed.script ?? '').trim();\n  const manifest = normalizeManifest(parsed.manifest);\n  return {\n    name,\n    script,\n    manifest,\n    explanation: String(parsed.explanation ?? ''),\n    assumptions: stringArray(parsed.assumptions),\n    risks: stringArray(parsed.risks),\n  };\n}\n\nexport function buildWorkflowDraftResponse(\n  draft: GeneratedWorkflowDraft,\n  constraints?: WorkflowDraftConstraints,\n): WorkflowDraftResponse {\n  const validation = validateWorkflowDefinitionInput({ name: draft.name, script: draft.script });\n  const lint = lintWorkflowDraft(draft, constraints);\n  return {\n    draftId: randomUUID(),\n    repairAttempts: 0,\n    ...draft,\n    permissionsSummary: summarizePermissions(draft.manifest),\n    validation,\n    lint,\n    suggestedInputs: suggestedInputsFromManifest(draft.manifest),\n  };\n}\n\nexport function lintWorkflowDraft(\n  draft: GeneratedWorkflowDraft,\n  constraints?: WorkflowDraftConstraints,\n): WorkflowDraftLintIssue[] {\n  const issues: WorkflowDraftLintIssue[] = [];\n  const { manifest, script } = draft;\n  if (!manifest.inputSchema) {\n    issues.push({ severity: 'warning', code: 'missing_input_schema', message: 'Draft does not define an input schema.' });\n  }\n  if (!manifest.outputSchema) {\n    issues.push({ severity: 'warning', code: 'missing_output_schema', message: 'Draft does not define an output schema.' });\n  }\n  if (manifest.permissions?.network && constraints?.allowNetwork === false) {\n    issues.push({ severity: 'error', code: 'unsafe_permission', message: 'Draft requests network access, but network is disabled by constraints.' });\n  }\n  if (manifest.permissions?.fileSystem === 'write' && constraints?.fileSystem !== 'write') {\n    issues.push({ severity: 'warning', code: 'unsafe_permission', message: 'Draft requests filesystem write access.' });\n  }\n  const phaseCount = (script.match(/\\bphase\\s*\\(/g) ?? []).length;\n  if (constraints?.maxPhases && phaseCount > constraints.maxPhases) {\n    issues.push({ severity: 'warning', code: 'too_many_agents', message: `Draft has ${phaseCount} phases, above requested ${constraints.maxPhases}.` });\n  }\n  const agentCount = (script.match(/\\bagent\\s*\\(/g) ?? []).length;\n  if (constraints?.maxSubagents && agentCount > constraints.maxSubagents) {\n    issues.push({ severity: 'warning', code: 'too_many_agents', message: `Draft starts ${agentCount} agents, above requested ${constraints.maxSubagents}.` });\n  }\n  if (/parallel\\s*\\([^[]/.test(script)) {\n    issues.push({ severity: 'warning', code: 'unbounded_parallelism', message: 'parallel() should receive a bounded array of thunks.' });\n  }\n  if (constraints?.allowedTools?.length) {\n    const unknown = collectToolsetNames(script).filter((tool) => !constraints.allowedTools!.includes(tool));\n    for (const tool of [...new Set(unknown)]) {\n      issues.push({ severity: 'warning', code: 'unknown_tool', message: `Tool '${tool}' is outside the requested allowlist.` });\n    }\n  }\n  return issues;\n}\n\nfunction extractJsonObject(raw: string): string {\n  const trimmed = raw.trim();\n  if (trimmed.startsWith('{') && trimmed.endsWith('}')) return trimmed;\n  const fenced = trimmed.match(/```(?:json)?\\s*([\\s\\S]*?)```/i)?.[1]?.trim();\n  if (fenced?.startsWith('{')) return fenced;\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 did not return a JSON object.');\n}\n\nfunction normalizeManifest(value: unknown): WorkflowDefinitionManifest {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return value as WorkflowDefinitionManifest;\n}\n\nfunction stringArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.map((item) => String(item)).filter(Boolean) : [];\n}\n\nfunction normalizeWorkflowName(value: string): string {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '_')\n    .replace(/^_+|_+$/g, '');\n  return /^[a-z]/.test(normalized) ? normalized : `workflow_${normalized || 'draft'}`;\n}\n\nfunction summarizePermissions(manifest: WorkflowDefinitionManifest): string[] {\n  const permissions = manifest.permissions;\n  if (!permissions) return ['No explicit permissions requested.'];\n  const out: string[] = [];\n  if (permissions.tools?.length) out.push(`Tools: ${permissions.tools.join(', ')}`);\n  if (permissions.network != null) out.push(`Network: ${permissions.network ? 'enabled' : 'disabled'}`);\n  if (permissions.fileSystem) out.push(`Filesystem: ${permissions.fileSystem}`);\n  if (permissions.approvalRequired) out.push('Approval required');\n  return out.length > 0 ? out : ['No explicit permissions requested.'];\n}\n\nfunction suggestedInputsFromManifest(manifest: WorkflowDefinitionManifest): WorkflowDraftResponse['suggestedInputs'] {\n  const properties = manifest.inputSchema?.properties;\n  if (!properties) return undefined;\n  return Object.entries(properties).slice(0, 8).map(([key, schema]) => ({\n    key,\n    label: typeof schema.title === 'string' ? schema.title : key,\n    example: typeof schema.default === 'string' ? schema.default : schema.description ?? '',\n  }));\n}\n\nfunction collectToolsetNames(script: string): string[] {\n  const out: string[] = [];\n  const re = /toolset\\s*:\\s*\\[([^\\]]*)\\]/g;\n  for (const match of script.matchAll(re)) {\n    const body = match[1] ?? '';\n    for (const item of body.matchAll(/['\"]([^'\"]+)['\"]/g)) {\n      out.push(item[1] ?? '');\n    }\n  }\n  return out.filter(Boolean);\n}\n"],"mappings":"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"}

package/dist/src/workflows/draft/workflow-draft.types.d.ts

@@ -0,0 +1,44 @@
+import type { WorkflowDefinitionManifest } from '../domain/definition.js';
+import type { WorkflowDefinitionValidationResult } from '../domain/validation.js';
+export type WorkflowDraftMode = 'create' | 'improve';
+export interface WorkflowDraftConstraints {
+    allowedTools?: string[];
+    allowNetwork?: boolean;
+    fileSystem?: 'none' | 'read' | 'write';
+    maxPhases?: number;
+    maxSubagents?: number;
+    outputFormat?: 'report' | 'json' | 'actions';
+}
+export interface CreateWorkflowDraftRequest {
+    prompt: string;
+    agentId: string;
+    language?: 'en' | 'zh';
+    mode?: WorkflowDraftMode;
+    existingScript?: string;
+    constraints?: WorkflowDraftConstraints;
+}
+export interface WorkflowDraftLintIssue {
+    severity: 'error' | 'warning';
+    code: 'missing_input_schema' | 'missing_output_schema' | 'unsafe_permission' | 'too_many_agents' | 'unknown_tool' | 'weak_phase_names' | 'unbounded_parallelism';
+    message: string;
+}
+export interface GeneratedWorkflowDraft {
+    name: string;
+    script: string;
+    manifest: WorkflowDefinitionManifest;
+    explanation: string;
+    assumptions: string[];
+    risks: string[];
+}
+export interface WorkflowDraftResponse extends GeneratedWorkflowDraft {
+    draftId: string;
+    repairAttempts: number;
+    permissionsSummary: string[];
+    validation: WorkflowDefinitionValidationResult;
+    lint: WorkflowDraftLintIssue[];
+    suggestedInputs?: Array<{
+        key: string;
+        label: string;
+        example: string;
+    }>;
+}

package/dist/src/workflows/draft/workflow-draft.types.js

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

package/dist/src/workflows/engine/projector.js

@@ -71,6 +71,7 @@ function projectWorkflowRunView(events) {
 					phaseId: payload.phaseId,
 					status: "queued",
 					prompt: payload.prompt,
+					invocation: payload.invocation,
 					sessionKey: payload.sessionKey,
 					transcriptMessageCount: 0,
 					steps: []

package/dist/src/workflows/engine/projector.js.map

@@ -1 +1 @@
-{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as { agentId: string; label: string; phaseId?: string; prompt?: string; sessionKey: string };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          sessionKey: payload.sessionKey,\n          transcriptMessageCount: 0,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"projector.js","names":[],"sources":["../../../../src/workflows/engine/projector.ts"],"sourcesContent":["import type { WorkflowEventEnvelope } from '../domain/event.js';\nimport type {\n  WorkflowAgentStatus,\n  WorkflowAgentView,\n  WorkflowLogEntry,\n  WorkflowPhaseStatus,\n  WorkflowPhaseView,\n  WorkflowRun,\n  WorkflowRunView,\n  WorkflowTimelineItem,\n} from '../domain/run.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/run.js';\nimport type { WorkflowArtifactRef } from '../domain/result.js';\n\nfunction terminalRunStatus(status: WorkflowRun['status']): boolean {\n  return isTerminalWorkflowRunStatus(status);\n}\n\nfunction phaseStatusAfterAgentStatus(agentStatuses: WorkflowAgentStatus[]): WorkflowPhaseStatus {\n  if (agentStatuses.some((status) => status === 'running')) {\n    return 'running';\n  }\n  if (agentStatuses.some((status) => status === 'error')) {\n    return 'failed';\n  }\n  if (agentStatuses.length > 0 && agentStatuses.every((status) => status === 'done' || status === 'skipped')) {\n    return 'completed';\n  }\n  return 'pending';\n}\n\nfunction buildTimelineItem(event: WorkflowEventEnvelope): WorkflowTimelineItem {\n  return {\n    sequence: event.sequence,\n    type: event.type,\n    title: event.type.replaceAll('_', ' '),\n    createdAtMs: event.createdAtMs,\n  };\n}\n\nexport function projectWorkflowRunView(events: WorkflowEventEnvelope[]): WorkflowRunView | null {\n  if (events.length === 0) {\n    return null;\n  }\n\n  const orderedEvents = [...events].sort((left, right) => left.sequence - right.sequence);\n  const firstEvent = orderedEvents[0];\n  if (firstEvent.type !== 'run_queued') {\n    return null;\n  }\n\n  const firstPayload = firstEvent.payload as { run?: WorkflowRun };\n  if (!firstPayload.run) {\n    return null;\n  }\n\n  const run: WorkflowRun = {\n    ...firstPayload.run,\n    metrics: { ...firstPayload.run.metrics },\n  };\n  const phaseIdToPhase = new Map<string, WorkflowPhaseView>();\n  const agentIdToAgent = new Map<string, WorkflowAgentView>();\n  const logs: WorkflowLogEntry[] = [];\n  const artifacts: WorkflowArtifactRef[] = [];\n  const timeline: WorkflowTimelineItem[] = [];\n\n  for (const event of orderedEvents) {\n    timeline.push(buildTimelineItem(event));\n\n    switch (event.type) {\n      case 'run_started': {\n        const payload = event.payload as { startedAtMs: number };\n        run.status = 'running';\n        run.startedAtMs = payload.startedAtMs;\n        break;\n      }\n      case 'phase_started': {\n        const payload = event.payload as { phaseId: string; title: string };\n        phaseIdToPhase.set(payload.phaseId, {\n          id: payload.phaseId,\n          title: payload.title,\n          status: 'running',\n          startedAtMs: event.createdAtMs,\n          agentIds: phaseIdToPhase.get(payload.phaseId)?.agentIds ?? [],\n        });\n        break;\n      }\n      case 'phase_completed': {\n        const payload = event.payload as { phaseId: string };\n        const existing = phaseIdToPhase.get(payload.phaseId);\n        if (existing) {\n          phaseIdToPhase.set(payload.phaseId, {\n            ...existing,\n            status: 'completed',\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as {\n          agentId: string;\n          label: string;\n          phaseId?: string;\n          prompt?: string;\n          sessionKey: string;\n          invocation?: WorkflowAgentView['invocation'];\n        };\n        agentIdToAgent.set(payload.agentId, {\n          id: payload.agentId,\n          label: payload.label,\n          phaseId: payload.phaseId,\n          status: 'queued',\n          prompt: payload.prompt,\n          invocation: payload.invocation,\n          sessionKey: payload.sessionKey,\n          transcriptMessageCount: 0,\n          steps: [],\n        });\n        if (payload.phaseId) {\n          const existingPhase = phaseIdToPhase.get(payload.phaseId);\n          if (existingPhase && !existingPhase.agentIds.includes(payload.agentId)) {\n            phaseIdToPhase.set(payload.phaseId, {\n              ...existingPhase,\n              agentIds: [...existingPhase.agentIds, payload.agentId],\n            });\n          }\n        }\n        break;\n      }\n      case 'agent_started': {\n        const payload = event.payload as { agentId: string };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: 'running',\n            startedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'agent_step_started': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          label: string;\n          kind: 'tool' | 'llm' | 'thinking';\n          toolName?: string;\n          detail?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            currentStep: payload.label,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            steps: [\n              ...existing.steps,\n              {\n                id: payload.stepId,\n                label: payload.label,\n                kind: payload.kind,\n                toolName: payload.toolName,\n                detail: payload.detail,\n                status: 'running',\n                startedAtMs: event.createdAtMs,\n              },\n            ],\n          });\n        }\n        break;\n      }\n      case 'agent_step_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          stepId: string;\n          status: 'done' | 'error';\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            steps: existing.steps.map((step) =>\n              step.id === payload.stepId\n                ? {\n                    ...step,\n                    status: payload.status,\n                    resultPreview: payload.resultPreview,\n                    error: payload.error,\n                    completedAtMs: event.createdAtMs,\n                  }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'agent_completed': {\n        const payload = event.payload as {\n          agentId: string;\n          status: WorkflowAgentStatus;\n          resultPreview?: string;\n          error?: string;\n        };\n        const existing = agentIdToAgent.get(payload.agentId);\n        if (existing) {\n          agentIdToAgent.set(payload.agentId, {\n            ...existing,\n            status: payload.status,\n            currentStep: undefined,\n            resultPreview: payload.resultPreview,\n            error: payload.error,\n            transcriptMessageCount: existing.transcriptMessageCount + 1,\n            completedAtMs: event.createdAtMs,\n          });\n        }\n        break;\n      }\n      case 'log_appended': {\n        const payload = event.payload as { message: string };\n        logs.push({ sequence: event.sequence, message: payload.message, createdAtMs: event.createdAtMs });\n        break;\n      }\n      case 'artifact_created': {\n        const payload = event.payload as { artifact: WorkflowArtifactRef };\n        artifacts.push(payload.artifact);\n        run.metrics.artifactCount = artifacts.length;\n        break;\n      }\n      case 'run_completed': {\n        const payload = event.payload as { result: WorkflowRun['result'] };\n        run.status = 'succeeded';\n        run.result = payload.result;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_failed': {\n        const payload = event.payload as { error: WorkflowRun['error'] };\n        run.status = payload.error?.code === 'timeout' ? 'timeout' : 'failed';\n        run.error = payload.error;\n        run.completedAtMs = event.createdAtMs;\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        for (const [agentId, agent] of agentIdToAgent) {\n          if (agent.status !== 'queued' && agent.status !== 'running') {\n            continue;\n          }\n          agentIdToAgent.set(agentId, {\n            ...agent,\n            status: 'skipped',\n            currentStep: undefined,\n            completedAtMs: event.createdAtMs,\n            steps: agent.steps.map((step) =>\n              step.status === 'running'\n                ? { ...step, status: 'error', completedAtMs: event.createdAtMs }\n                : step,\n            ),\n          });\n        }\n        break;\n      }\n      case 'run_queued':\n      default:\n        break;\n    }\n  }\n\n  const agents = [...agentIdToAgent.values()];\n  run.metrics.agentCount = agents.length;\n  run.metrics.doneAgentCount = agents.filter((agent) => agent.status === 'done').length;\n  run.metrics.errorAgentCount = agents.filter((agent) => agent.status === 'error').length;\n  run.metrics.skippedAgentCount = agents.filter((agent) => agent.status === 'skipped').length;\n  run.metrics.artifactCount = artifacts.length;\n  if (run.startedAtMs && run.completedAtMs) {\n    run.metrics.durationMs = run.completedAtMs - run.startedAtMs;\n  }\n\n  const phases = [...phaseIdToPhase.values()].map((phase) => {\n    if (phase.status === 'completed' || phase.status === 'failed') {\n      return phase;\n    }\n    const phaseAgents = phase.agentIds\n      .map((agentId) => agentIdToAgent.get(agentId)?.status)\n      .filter((status): status is WorkflowAgentStatus => Boolean(status));\n    return { ...phase, status: phaseStatusAfterAgentStatus(phaseAgents) };\n  });\n\n  return {\n    run,\n    phases,\n    agents,\n    logs,\n    artifacts,\n    timeline,\n    controls: {\n      canCancel: !terminalRunStatus(run.status),\n      canRetry: terminalRunStatus(run.status),\n      canArchive: terminalRunStatus(run.status),\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/workflows/engine/workflow-engine.d.ts

@@ -6,6 +6,7 @@ import { WorkflowRunStore } from '../store/run-store.js';
 import type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';
 import type { Api, Model } from '@earendil-works/pi-ai';
 import type { WorkflowScriptSubagentRunner } from '../runtime/script-runtime.js';
+import type { WorkflowAgentInvocationSnapshot } from '../domain/index.js';
 export interface WorkflowEngineOptions {
     cwd: string;
     eventStore: WorkflowEventStore;
@@ -59,10 +60,27 @@ export interface StartWorkflowRunOptions {
     concurrency?: number;
     maxSubagents?: number;
     tokenBudget?: number | null;
+    timeoutSec?: number;
+}
+export interface WorkflowReplayAgentTarget {
+    agentId: string;
+    label: string;
+    phaseId?: string;
+    phaseTitle?: string;
+    prompt: string;
+    invocation?: WorkflowAgentInvocationSnapshot;
+}
+export interface StartWorkflowReplayRunOptions extends StartWorkflowRunOptions {
+    sourceRunId: string;
+    replayScope: 'failed_agents' | 'failed_phases';
+    targets: WorkflowReplayAgentTarget[];
 }
 export declare class WorkflowEngine {
     private readonly options;
     constructor(options: WorkflowEngineOptions);
     startRun(definition: WorkflowDefinition, options: StartWorkflowRunOptions): Promise<WorkflowRunView>;
+    startReplayRun(definition: WorkflowDefinition, options: StartWorkflowReplayRunOptions): Promise<WorkflowRunView>;
+    private runReplayTargets;
+    private runReplayTarget;
     private callHooks;
 }