@xopcai/xopc 0.0.142 → 0.0.144

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

@@ -2,11 +2,10 @@ 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);
+	const parsed = JSON.parse(extractJsonObject(raw));
 	return {
 		name: normalizeWorkflowName(String(parsed.name ?? "custom_workflow")),
-		script: String(parsed.script ?? "").trim(),
+		graph: normalizeGraph(parsed.graph),
 		manifest: normalizeManifest(parsed.manifest),
 		explanation: String(parsed.explanation ?? ""),
 		assumptions: stringArray(parsed.assumptions),
@@ -16,22 +15,21 @@ function parseGeneratedWorkflowDraft(raw) {
 function buildWorkflowDraftResponse(draft, constraints) {
 	const validation = validateWorkflowDefinitionInput({
 		name: draft.name,
-		script: draft.script
+		graph: draft.graph
 	});
-	const lint = lintWorkflowDraft(draft, constraints);
 	return {
 		draftId: randomUUID(),
 		repairAttempts: 0,
 		...draft,
 		permissionsSummary: summarizePermissions(draft.manifest),
 		validation,
-		lint,
+		lint: lintWorkflowDraft(draft, constraints),
 		suggestedInputs: suggestedInputsFromManifest(draft.manifest)
 	};
 }
 function lintWorkflowDraft(draft, constraints) {
 	const issues = [];
-	const { manifest, script } = draft;
+	const { manifest, graph } = draft;
 	if (!manifest.inputSchema) issues.push({
 		severity: "warning",
 		code: "missing_input_schema",
@@ -45,32 +43,27 @@ function lintWorkflowDraft(draft, constraints) {
 	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."
+		message: "Draft requests network access, but network is disabled."
 	});
 	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({
+	const phases = new Set(graph.nodes.map((node) => node.phaseId).filter(Boolean));
+	if (constraints?.maxPhases && phases.size > constraints.maxPhases) issues.push({
 		severity: "warning",
 		code: "too_many_agents",
-		message: `Draft has ${phaseCount} phases, above requested ${constraints.maxPhases}.`
+		message: `Draft has ${phases.size} phases, above the requested maximum.`
 	});
-	const agentCount = (script.match(/\bagent\s*\(/g) ?? []).length;
-	if (constraints?.maxSubagents && agentCount > constraints.maxSubagents) issues.push({
+	const agents = graph.nodes.filter((node) => node.kind === "agent");
+	if (constraints?.maxSubagents && agents.length > 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."
+		message: `Draft has ${agents.length} agents, above the requested maximum.`
 	});
 	if (constraints?.allowedTools?.length) {
-		const unknown = collectToolsetNames(script).filter((tool) => !constraints.allowedTools.includes(tool));
+		const unknown = agents.flatMap((node) => node.config.toolset ?? []).filter((tool) => !constraints.allowedTools.includes(tool));
 		for (const tool of [...new Set(unknown)]) issues.push({
 			severity: "warning",
 			code: "unknown_tool",
@@ -89,12 +82,19 @@ function extractJsonObject(raw) {
 	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 {};
+function normalizeGraph(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return {
+		schemaVersion: 1,
+		nodes: [],
+		edges: []
+	};
 	return value;
 }
+function normalizeManifest(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
 function stringArray(value) {
-	return Array.isArray(value) ? value.map((item) => String(item)).filter(Boolean) : [];
+	return Array.isArray(value) ? value.map(String).filter(Boolean) : [];
 }
 function normalizeWorkflowName(value) {
 	const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
@@ -103,12 +103,12 @@ function normalizeWorkflowName(value) {
 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."];
+	const values = [];
+	if (permissions.tools?.length) values.push(`Tools: ${permissions.tools.join(", ")}`);
+	if (permissions.network != null) values.push(`Network: ${permissions.network ? "enabled" : "disabled"}`);
+	if (permissions.fileSystem) values.push(`Filesystem: ${permissions.fileSystem}`);
+	if (permissions.approvalRequired) values.push("Approval required");
+	return values.length ? values : ["No explicit permissions requested."];
 }
 function suggestedInputsFromManifest(manifest) {
 	const properties = manifest.inputSchema?.properties;
@@ -119,14 +119,6 @@ function suggestedInputsFromManifest(manifest) {
 		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 };
 

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

@@ -1 +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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"}
+{"version":3,"file":"workflow-draft-validator.js","names":[],"sources":["../../../../src/workflows/draft/workflow-draft-validator.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { WorkflowDefinitionManifest, WorkflowGraph } from '../domain/definition.js';\nimport { validateWorkflowDefinitionInput } from '../domain/validation.js';\n\nimport type { GeneratedWorkflowDraft, WorkflowDraftConstraints, WorkflowDraftLintIssue, WorkflowDraftResponse } from './workflow-draft.types.js';\n\nexport function parseGeneratedWorkflowDraft(raw: string): GeneratedWorkflowDraft {\n  const parsed = JSON.parse(extractJsonObject(raw)) as Partial<GeneratedWorkflowDraft>;\n  return {\n    name: normalizeWorkflowName(String(parsed.name ?? 'custom_workflow')),\n    graph: normalizeGraph(parsed.graph),\n    manifest: normalizeManifest(parsed.manifest),\n    explanation: String(parsed.explanation ?? ''),\n    assumptions: stringArray(parsed.assumptions),\n    risks: stringArray(parsed.risks),\n  };\n}\n\nexport function buildWorkflowDraftResponse(draft: GeneratedWorkflowDraft, constraints?: WorkflowDraftConstraints): WorkflowDraftResponse {\n  const validation = validateWorkflowDefinitionInput({ name: draft.name, graph: draft.graph });\n  return {\n    draftId: randomUUID(),\n    repairAttempts: 0,\n    ...draft,\n    permissionsSummary: summarizePermissions(draft.manifest),\n    validation,\n    lint: lintWorkflowDraft(draft, constraints),\n    suggestedInputs: suggestedInputsFromManifest(draft.manifest),\n  };\n}\n\nexport function lintWorkflowDraft(draft: GeneratedWorkflowDraft, constraints?: WorkflowDraftConstraints): WorkflowDraftLintIssue[] {\n  const issues: WorkflowDraftLintIssue[] = [];\n  const { manifest, graph } = draft;\n  if (!manifest.inputSchema) issues.push({ severity: 'warning', code: 'missing_input_schema', message: 'Draft does not define an input schema.' });\n  if (!manifest.outputSchema) issues.push({ severity: 'warning', code: 'missing_output_schema', message: 'Draft does not define an output schema.' });\n  if (manifest.permissions?.network && constraints?.allowNetwork === false) issues.push({ severity: 'error', code: 'unsafe_permission', message: 'Draft requests network access, but network is disabled.' });\n  if (manifest.permissions?.fileSystem === 'write' && constraints?.fileSystem !== 'write') issues.push({ severity: 'warning', code: 'unsafe_permission', message: 'Draft requests filesystem write access.' });\n  const phases = new Set(graph.nodes.map((node) => node.phaseId).filter(Boolean));\n  if (constraints?.maxPhases && phases.size > constraints.maxPhases) issues.push({ severity: 'warning', code: 'too_many_agents', message: `Draft has ${phases.size} phases, above the requested maximum.` });\n  const agents = graph.nodes.filter((node) => node.kind === 'agent');\n  if (constraints?.maxSubagents && agents.length > constraints.maxSubagents) issues.push({ severity: 'warning', code: 'too_many_agents', message: `Draft has ${agents.length} agents, above the requested maximum.` });\n  if (constraints?.allowedTools?.length) {\n    const unknown = agents.flatMap((node) => node.config.toolset ?? []).filter((tool) => !constraints.allowedTools!.includes(tool));\n    for (const tool of [...new Set(unknown)]) issues.push({ severity: 'warning', code: 'unknown_tool', message: `Tool '${tool}' is outside the requested allowlist.` });\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 normalizeGraph(value: unknown): WorkflowGraph {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return { schemaVersion: 1, nodes: [], edges: [] };\n  return value as WorkflowGraph;\n}\n\nfunction normalizeManifest(value: unknown): WorkflowDefinitionManifest {\n  return value && typeof value === 'object' && !Array.isArray(value) ? value as WorkflowDefinitionManifest : {};\n}\n\nfunction stringArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.map(String).filter(Boolean) : [];\n}\n\nfunction normalizeWorkflowName(value: string): string {\n  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, '_').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 values: string[] = [];\n  if (permissions.tools?.length) values.push(`Tools: ${permissions.tools.join(', ')}`);\n  if (permissions.network != null) values.push(`Network: ${permissions.network ? 'enabled' : 'disabled'}`);\n  if (permissions.fileSystem) values.push(`Filesystem: ${permissions.fileSystem}`);\n  if (permissions.approvalRequired) values.push('Approval required');\n  return values.length ? values : ['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]) => ({ key, label: typeof schema.title === 'string' ? schema.title : key, example: typeof schema.default === 'string' ? schema.default : schema.description ?? '' }));\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import type { WorkflowDefinitionManifest } from '../domain/definition.js';
+import type { WorkflowDefinitionManifest, WorkflowGraph } from '../domain/definition.js';
 import type { WorkflowDefinitionValidationResult } from '../domain/validation.js';
 export type WorkflowDraftMode = 'create' | 'improve';
 export interface WorkflowDraftConstraints {
@@ -14,17 +14,17 @@ export interface CreateWorkflowDraftRequest {
     agentId: string;
     language?: 'en' | 'zh';
     mode?: WorkflowDraftMode;
-    existingScript?: string;
+    existingGraph?: WorkflowGraph;
     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';
+    code: 'missing_input_schema' | 'missing_output_schema' | 'unsafe_permission' | 'too_many_agents' | 'unknown_tool' | 'weak_phase_names';
     message: string;
 }
 export interface GeneratedWorkflowDraft {
     name: string;
-    script: string;
+    graph: WorkflowGraph;
     manifest: WorkflowDefinitionManifest;
     explanation: string;
     assumptions: string[];

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

@@ -18,7 +18,18 @@ function buildTimelineItem(event) {
 	};
 }
 function isAgentMutationEvent(type) {
-	return type === "agent_queued" || type === "agent_started" || type === "agent_step_started" || type === "agent_step_completed" || type === "agent_completed";
+	return type === "node_started" || type === "node_completed" || type === "agent_queued" || type === "agent_started" || type === "agent_step_started" || type === "agent_step_completed" || type === "agent_completed";
+}
+function markOpenNodesTerminal(nodes, status, completedAtMs, error) {
+	for (const [nodeId, node] of nodes) {
+		if (node.status !== "running") continue;
+		nodes.set(nodeId, {
+			...node,
+			status,
+			completedAtMs,
+			error: status === "error" ? error : node.error
+		});
+	}
 }
 function markOpenAgentsTerminal(agentIdToAgent, status, completedAtMs, error) {
 	for (const [agentId, agent] of agentIdToAgent) {
@@ -50,6 +61,7 @@ function projectWorkflowRunView(events) {
 	};
 	const phaseIdToPhase = /* @__PURE__ */ new Map();
 	const agentIdToAgent = /* @__PURE__ */ new Map();
+	const nodeIdToNode = /* @__PURE__ */ new Map();
 	const logs = [];
 	const artifacts = [];
 	const timeline = [];
@@ -84,10 +96,37 @@ function projectWorkflowRunView(events) {
 				});
 				break;
 			}
+			case "node_started": {
+				const payload = event.payload;
+				nodeIdToNode.set(payload.nodeId, {
+					id: payload.nodeId,
+					kind: payload.kind,
+					title: payload.title,
+					status: "running",
+					startedAtMs: event.createdAtMs
+				});
+				break;
+			}
+			case "node_completed": {
+				const payload = event.payload;
+				const existing = nodeIdToNode.get(payload.nodeId);
+				nodeIdToNode.set(payload.nodeId, {
+					id: payload.nodeId,
+					kind: payload.kind,
+					title: payload.title,
+					status: payload.status,
+					startedAtMs: existing?.startedAtMs,
+					completedAtMs: event.createdAtMs,
+					resultPreview: payload.resultPreview,
+					error: payload.error
+				});
+				break;
+			}
 			case "agent_queued": {
 				const payload = event.payload;
 				agentIdToAgent.set(payload.agentId, {
 					id: payload.agentId,
+					nodeId: payload.nodeId,
 					label: payload.label,
 					phaseId: payload.phaseId,
 					status: "queued",
@@ -192,12 +231,14 @@ function projectWorkflowRunView(events) {
 				run.error = payload.error;
 				run.completedAtMs = event.createdAtMs;
 				markOpenAgentsTerminal(agentIdToAgent, payload.error?.code === "timeout" ? "skipped" : "error", event.createdAtMs, payload.error?.message);
+				markOpenNodesTerminal(nodeIdToNode, payload.error?.code === "timeout" ? "skipped" : "error", event.createdAtMs, payload.error?.message);
 				break;
 			}
 			case "run_cancelled":
 				run.status = "cancelled";
 				run.completedAtMs = event.createdAtMs;
 				markOpenAgentsTerminal(agentIdToAgent, "skipped", event.createdAtMs);
+				markOpenNodesTerminal(nodeIdToNode, "skipped", event.createdAtMs);
 				break;
 			default: break;
 		}
@@ -220,6 +261,7 @@ function projectWorkflowRunView(events) {
 			};
 		}),
 		agents,
+		nodes: [...nodeIdToNode.values()],
 		logs,
 		artifacts,
 		timeline,

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\nfunction isAgentMutationEvent(type: WorkflowEventEnvelope['type']): boolean {\n  return type === 'agent_queued'\n    || type === 'agent_started'\n    || type === 'agent_step_started'\n    || type === 'agent_step_completed'\n    || type === 'agent_completed';\n}\n\nfunction markOpenAgentsTerminal(\n  agentIdToAgent: Map<string, WorkflowAgentView>,\n  status: Extract<WorkflowAgentStatus, 'error' | 'skipped'>,\n  completedAtMs: number,\n  error?: string,\n): void {\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,\n      currentStep: undefined,\n      error: status === 'error' ? error : agent.error,\n      completedAtMs,\n      steps: agent.steps.map((step) =>\n        step.status === 'running'\n          ? { ...step, status: 'error', completedAtMs }\n          : step,\n      ),\n    });\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    if (terminalRunStatus(run.status) && isAgentMutationEvent(event.type)) {\n      continue;\n    }\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        markOpenAgentsTerminal(\n          agentIdToAgent,\n          payload.error?.code === 'timeout' ? 'skipped' : 'error',\n          event.createdAtMs,\n          payload.error?.message,\n        );\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        markOpenAgentsTerminal(agentIdToAgent, 'skipped', event.createdAtMs);\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  WorkflowNodeView,\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\nfunction isAgentMutationEvent(type: WorkflowEventEnvelope['type']): boolean {\n  return type === 'node_started'\n    || type === 'node_completed'\n    || type === 'agent_queued'\n    || type === 'agent_started'\n    || type === 'agent_step_started'\n    || type === 'agent_step_completed'\n    || type === 'agent_completed';\n}\n\nfunction markOpenNodesTerminal(nodes: Map<string, WorkflowNodeView>, status: 'error' | 'skipped', completedAtMs: number, error?: string): void {\n  for (const [nodeId, node] of nodes) {\n    if (node.status !== 'running') continue;\n    nodes.set(nodeId, { ...node, status, completedAtMs, error: status === 'error' ? error : node.error });\n  }\n}\n\nfunction markOpenAgentsTerminal(\n  agentIdToAgent: Map<string, WorkflowAgentView>,\n  status: Extract<WorkflowAgentStatus, 'error' | 'skipped'>,\n  completedAtMs: number,\n  error?: string,\n): void {\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,\n      currentStep: undefined,\n      error: status === 'error' ? error : agent.error,\n      completedAtMs,\n      steps: agent.steps.map((step) =>\n        step.status === 'running'\n          ? { ...step, status: 'error', completedAtMs }\n          : step,\n      ),\n    });\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 nodeIdToNode = new Map<string, WorkflowNodeView>();\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    if (terminalRunStatus(run.status) && isAgentMutationEvent(event.type)) {\n      continue;\n    }\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 'node_started': {\n        const payload = event.payload as { nodeId: string; kind: string; title: string };\n        nodeIdToNode.set(payload.nodeId, { id: payload.nodeId, kind: payload.kind, title: payload.title, status: 'running', startedAtMs: event.createdAtMs });\n        break;\n      }\n      case 'node_completed': {\n        const payload = event.payload as { nodeId: string; kind: string; title: string; status: 'done' | 'error' | 'skipped'; resultPreview?: string; error?: string };\n        const existing = nodeIdToNode.get(payload.nodeId);\n        nodeIdToNode.set(payload.nodeId, {\n          id: payload.nodeId,\n          kind: payload.kind,\n          title: payload.title,\n          status: payload.status,\n          startedAtMs: existing?.startedAtMs,\n          completedAtMs: event.createdAtMs,\n          resultPreview: payload.resultPreview,\n          error: payload.error,\n        });\n        break;\n      }\n      case 'agent_queued': {\n        const payload = event.payload as {\n          agentId: string;\n          nodeId: 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          nodeId: payload.nodeId,\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        markOpenAgentsTerminal(\n          agentIdToAgent,\n          payload.error?.code === 'timeout' ? 'skipped' : 'error',\n          event.createdAtMs,\n          payload.error?.message,\n        );\n        markOpenNodesTerminal(nodeIdToNode, payload.error?.code === 'timeout' ? 'skipped' : 'error', event.createdAtMs, payload.error?.message);\n        break;\n      }\n      case 'run_cancelled': {\n        run.status = 'cancelled';\n        run.completedAtMs = event.createdAtMs;\n        markOpenAgentsTerminal(agentIdToAgent, 'skipped', event.createdAtMs);\n        markOpenNodesTerminal(nodeIdToNode, 'skipped', event.createdAtMs);\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    nodes: [...nodeIdToNode.values()],\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

@@ -3,15 +3,14 @@ import type { WorkflowEventEnvelope } from '../domain/event.js';
 import type { WorkflowRun, WorkflowRunMetadata, WorkflowRunSource, WorkflowRunView } from '../domain/run.js';
 import { WorkflowEventStore } from '../store/event-store.js';
 import { WorkflowRunStore } from '../store/run-store.js';
-import type { WorkflowRuntime } from '../runtime/workflow-runtime-port.js';
+import type { WorkflowRuntime, WorkflowRuntimeSubagentRunner } 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;
     runStore: WorkflowRunStore;
-    runner: WorkflowScriptSubagentRunner;
+    runner: WorkflowRuntimeSubagentRunner;
     runtime?: WorkflowRuntime;
     hooks?: WorkflowEngineHook[];
     subagentSessionKeyFactory?: (ctx: {

package/dist/src/workflows/engine/workflow-engine.js

@@ -1,6 +1,6 @@
 import { workflowStepLabel } from "../../agent/workflow/step-labels.js";
 import { validateWorkflowJsonSchema } from "../domain/schema-validation.js";
-import { createScriptWorkflowRuntime } from "../runtime/script-workflow-runtime.js";
+import { createGraphWorkflowRuntime } from "../runtime/graph-workflow-runtime.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/engine/workflow-engine.ts
 var WorkflowEngine = class {
@@ -55,12 +55,13 @@ var WorkflowEngine = class {
 		}));
 		await appendEvent("run_started", { startedAtMs: Date.now() });
 		try {
-			const runtimeResult = await withWorkflowTimeout((this.options.runtime ?? createScriptWorkflowRuntime()).run(definition.runtime.source, {
+			const runtimeResult = await withWorkflowTimeout((this.options.runtime ?? createGraphWorkflowRuntime()).run(definition.graph, {
 				runner: this.options.runner,
 				resolveModelId: this.options.resolveModelId
 			}, {
 				cwd: this.options.cwd,
 				args: options.input,
+				goal: options.goal ?? definition.description,
 				signal: options.signal,
 				concurrency: options.concurrency ?? definition.defaults.concurrency,
 				maxSubagents: options.maxSubagents ?? definition.defaults.maxSubagents,
@@ -77,6 +78,19 @@ var WorkflowEngine = class {
 				onLog: (message) => {
 					appendEvent("log_appended", { message });
 				},
+				onNodeStart: (event) => {
+					appendEvent("node_started", event);
+				},
+				onNodeEnd: (event) => {
+					appendEvent("node_completed", {
+						nodeId: event.nodeId,
+						kind: event.kind,
+						title: event.title,
+						status: event.status,
+						resultPreview: previewWorkflowValue(event.result),
+						error: event.error
+					});
+				},
 				onAgentQueued: (event) => {
 					const agentId = formatRuntimeAgentId(event.id);
 					const subagentSessionKey = this.options.subagentSessionKeyFactory?.({
@@ -95,6 +109,7 @@ var WorkflowEngine = class {
 					}));
 					appendEvent("agent_queued", {
 						agentId,
+						nodeId: event.nodeId,
 						label: event.label,
 						phaseId,
 						prompt: event.prompt,
@@ -106,7 +121,10 @@ var WorkflowEngine = class {
 					const currentStatus = runtimeAgentStatuses.get(event.id);
 					if (currentStatus && currentStatus !== "queued" && currentStatus !== "running") return;
 					runtimeAgentStatuses.set(event.id, "running");
-					appendEvent("agent_started", { agentId: formatRuntimeAgentId(event.id) });
+					appendEvent("agent_started", {
+						agentId: formatRuntimeAgentId(event.id),
+						nodeId: event.nodeId
+					});
 				},
 				onAgentEnd: (event) => {
 					const currentStatus = runtimeAgentStatuses.get(event.id);
@@ -119,6 +137,7 @@ var WorkflowEngine = class {
 					progressRecorders.delete(event.id);
 					appendEvent("agent_completed", {
 						agentId,
+						nodeId: event.nodeId,
 						status: completedStatus,
 						resultPreview,
 						error: completedStatus === "error" ? "Subagent failed" : void 0
@@ -148,6 +167,7 @@ var WorkflowEngine = class {
 							workflowRunId: runId,
 							workflowDefinitionId: definition.id,
 							workflowAgentId: agentId,
+							workflowNodeId: ctx.nodeId,
 							workflowAgentLabel: ctx.label
 						},
 						onProgress: (event) => recorder.onProgress(event)
@@ -672,7 +692,7 @@ function isWorkflowResultEnvelope(value) {
 }
 function requireWorkflowResultEnvelope(value) {
 	if (isWorkflowResultEnvelope(value)) return value;
-	throw new WorkflowEngineRunError("result_validation_failed", "Workflow scripts must return a WorkflowResultEnvelope with summary and sections.", false);
+	throw new WorkflowEngineRunError("result_validation_failed", "Workflow output node must return a result envelope with summary and sections.", false);
 }
 function toWorkflowRunError(err, wasAborted, abortReason) {
 	if (err instanceof WorkflowEngineRunError) return {