@oomol-lab/open-flow 0.1.0-beta.50 → 0.1.0-beta.51

package/dist/common/flow-semantics.js

@@ -9817,6 +9817,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -9874,6 +9875,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -9945,7 +9951,11 @@ var document = object({
 	tasks: record(text, managed)
 });
 object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record(text, module)
 }).extend({
@@ -9953,6 +9963,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -10537,6 +10552,67 @@ function hasRetiredRef(value) {
 }
 //#endregion
 //#region src/trigger/common/contract.ts
+var errorOutputs = [
+	{
+		handle: "workflow",
+		nullable: false,
+		jsonSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: [
+				"flowId",
+				"name",
+				"revisionId",
+				"publicationId"
+			],
+			properties: {
+				flowId: { type: "string" },
+				name: { type: "string" },
+				revisionId: { type: "string" },
+				publicationId: { type: ["string", "null"] }
+			}
+		}
+	},
+	{
+		handle: "execution",
+		nullable: false,
+		jsonSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: [
+				"runId",
+				"status",
+				"startedAt",
+				"finishedAt"
+			],
+			properties: {
+				runId: { type: "string" },
+				status: { enum: ["failed", "indeterminate"] },
+				startedAt: { type: ["string", "null"] },
+				finishedAt: { type: "string" }
+			}
+		}
+	},
+	{
+		handle: "error",
+		nullable: false,
+		jsonSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: ["code", "message"],
+			properties: {
+				code: { type: "string" },
+				message: { type: "string" },
+				nodeId: { type: "string" },
+				jobId: { type: "string" },
+				path: {
+					type: "array",
+					items: { type: "string" }
+				}
+			}
+		}
+	}
+];
 var webhookOutputs = [
 	{
 		handle: "headers",
@@ -10581,6 +10657,7 @@ var cronOutputs = [{
 }];
 function triggerOutputDefinitions(trigger) {
 	switch (trigger.kind) {
+		case "error": return errorOutputs;
 		case "manual": return [];
 		case "cron": return cronOutputs;
 		case "poll":
@@ -11179,6 +11256,10 @@ function canonicalTriggerNode(trigger) {
 		name: trigger.name
 	});
 	switch (trigger.kind) {
+		case "error": return {
+			...common(trigger.kind),
+			...trigger.sourceFlowIds == null ? {} : { sourceFlowIds: [...trigger.sourceFlowIds] }
+		};
 		case "manual": return common(trigger.kind);
 		case "webhook": return {
 			...common(trigger.kind),
@@ -11296,7 +11377,7 @@ function validateTrigger(triggerId, trigger, path, diagnostics) {
 		}
 		return;
 	}
-	if (trigger.kind == "cron" || trigger.kind == "manual") return;
+	if (trigger.kind == "error" || trigger.kind == "cron" || trigger.kind == "manual") return;
 	if (trigger.connectionId == null) diagnostics.push(graphDiagnostic("trigger.connection-missing", "Select a connection account for this Trigger.", `${path}/connectionId`));
 	const missingConfig = missingTriggerConfig(trigger.definition.configInputs, trigger.config);
 	if (missingConfig.length > 0) diagnostics.push({
@@ -11320,6 +11401,7 @@ function nodeInputPorts(document, node) {
 		case "cron":
 		case "integration":
 		case "poll":
+		case "error":
 		case "manual":
 		case "webhook": return {};
 	}
@@ -11370,6 +11452,7 @@ function nodeOutputPorts(document, node) {
 		case "cron":
 		case "integration":
 		case "poll":
+		case "error":
 		case "manual":
 		case "webhook": return triggerOutputPorts(node);
 	}
@@ -11587,6 +11670,8 @@ function validateResolution(nodeId, node, allowed, path, diagnostics) {
 }
 function validateGraph(graph, document, flowInputs, allowTriggers, path, diagnostics) {
 	const analysis = graphPaths(graph);
+	const errorTriggers = Object.entries(graph.nodes).filter(([, node]) => node.kind == "error");
+	if (errorTriggers.length > 1) for (const [nodeId] of errorTriggers) diagnostics.push(graphDiagnostic("graph.error-trigger-duplicate", "A graph can contain only one Error Trigger.", `${path}/nodes/${nodeId}`));
 	const manualTriggers = Object.entries(graph.nodes).filter(([, node]) => node.kind == "manual");
 	if (manualTriggers.length > 1) for (const [nodeId] of manualTriggers) diagnostics.push(graphDiagnostic("graph.manual-trigger-duplicate", "A graph can contain only one manual Trigger.", `${path}/nodes/${nodeId}`));
 	const seen = /* @__PURE__ */ new Set();

package/dist/common/integration-trigger.js

@@ -9485,6 +9485,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -9542,6 +9543,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -9613,7 +9619,11 @@ var document = object({
 	tasks: record$1(text, managed)
 });
 object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record$1(text, module)
 }).extend({
@@ -9621,6 +9631,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding

package/dist/common/mcp.js

@@ -6123,6 +6123,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -6180,6 +6181,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -6251,7 +6257,11 @@ var document = object({
 	tasks: record$1(text, managed)
 });
 var revision = object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record$1(text, module)
 });
@@ -6261,9 +6271,16 @@ revision.extend({
 });
 function decodeRevisionContent(value) {
 	checkJsonDepth(value);
-	return revision.parse(value);
+	const content = revision.parse(value);
+	checkErrorModelVersion(content);
+	return content;
 }
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -6437,6 +6454,9 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
+function checkErrorModelVersion(content) {
+	if (content.modelVersion < 5 && [content.document.graph, ...Object.values(content.document.subflows).map((item) => item.graph)].some((item) => Object.values(item.nodes).some((itemNode) => itemNode.kind == "error"))) throw new TypeError("Error workflows require Flow model version 5.");
+}
 //#endregion
 //#region src/flow/common/change.ts
 var schemaKeywords = /* @__PURE__ */ new Set([
@@ -9840,6 +9860,7 @@ function triggerKey(value) {
 	};
 }
 var triggerKinds = /* @__PURE__ */ new Set([
+	"error",
 	"cron",
 	"integration",
 	"poll",
@@ -10216,6 +10237,17 @@ function variable(value) {
 		version: 1
 	};
 }
+function errorListener(value) {
+	const source = record(value);
+	if (typeof source.enabled != "boolean") return invalidResponse();
+	return {
+		flowId: string(source.flowId),
+		flowName: string(source.flowName),
+		nodeId: string(source.nodeId),
+		nodeName: string(source.nodeName),
+		enabled: source.enabled
+	};
+}
 //#endregion
 //#region src/control/common/publicationDecoders.ts
 function publication(value) {
@@ -10474,6 +10506,7 @@ function runDetails(value) {
 	};
 	const details = {
 		...summary,
+		...errorHandling(source),
 		closureDigest: string(source.closureDigest),
 		engineContract: string(source.engineContract),
 		engineDigest: string(source.engineDigest),
@@ -10573,10 +10606,7 @@ function runResult(value) {
 		const error = record(source.error);
 		return {
 			...base,
-			error: {
-				code: string(error.code),
-				message: string(error.message)
-			},
+			error: runFailure(error),
 			status: "failed"
 		};
 	}
@@ -10584,15 +10614,52 @@ function runResult(value) {
 		const error = record(source.error);
 		return {
 			...base,
-			error: {
-				code: string(error.code),
-				message: string(error.message)
-			},
+			error: runFailure(error),
 			status: "indeterminate"
 		};
 	}
 	return invalidResponse();
 }
+function errorHandling(source) {
+	const errorSource = source.errorSource == null ? void 0 : record(source.errorSource);
+	if (source.errorDispatches != null && !Array.isArray(source.errorDispatches)) return invalidResponse();
+	return {
+		...errorSource == null ? {} : { errorSource: {
+			flowId: string(errorSource.flowId),
+			runId: string(errorSource.runId)
+		} },
+		...source.errorDispatches == null ? {} : { errorDispatches: source.errorDispatches.map((value) => {
+			const dispatch = record(value);
+			const flowId = string(dispatch.flowId);
+			switch (dispatch.status) {
+				case "pending": return {
+					status: "pending",
+					flowId
+				};
+				case "dispatched": return {
+					status: "dispatched",
+					flowId,
+					runId: string(dispatch.runId)
+				};
+				case "failed": return {
+					status: "failed",
+					flowId,
+					message: string(dispatch.message)
+				};
+				default: return invalidResponse();
+			}
+		}) }
+	};
+}
+function runFailure(error) {
+	return {
+		code: string(error.code),
+		message: string(error.message),
+		...error.nodeId === void 0 ? {} : { nodeId: string(error.nodeId) },
+		...error.jobId === void 0 ? {} : { jobId: string(error.jobId) },
+		...error.path === void 0 ? {} : { path: (Array.isArray(error.path) ? error.path : invalidResponse()).map(string) }
+	};
+}
 //#endregion
 //#region src/control/common/random.ts
 function randomId() {
@@ -10891,6 +10958,11 @@ var ControlClient = class {
 	async getFlow(flowId) {
 		return flow$1(await this.request(`/v1/flows/${segment(flowId)}`));
 	}
+	async getErrorListeners(flowId, signal) {
+		const source = record(await this.request(`/v1/flows/${segment(flowId)}/error-listeners`, { signal }));
+		if (source.version != 1 || !Array.isArray(source.listeners)) return invalidResponse();
+		return source.listeners.map(errorListener);
+	}
 	async renameFlow(flowId, name) {
 		return flow$1(await this.request(`/v1/flows/${segment(flowId)}`, {
 			body: JSON.stringify({

package/dist/common/poll-trigger.js

@@ -9461,6 +9461,7 @@ var endpoint = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -9518,6 +9519,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -9589,7 +9595,11 @@ var document = object({
 	tasks: record(text, managed)
 });
 object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record(text, module)
 }).extend({
@@ -9597,6 +9607,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding

package/dist/common/provider-triggers.js

@@ -6935,6 +6935,7 @@ var endpoint$3 = object({
 	])),
 	successStatus: number()
 });
+var sourceFlowIds = array(text.min(1)).refine((ids) => new Set(ids).size === ids.length, "Duplicate source Flow ID.");
 var trigger = {
 	name: text,
 	description: text.optional(),
@@ -6992,6 +6993,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -7063,7 +7069,11 @@ var document = object({
 	tasks: record$12(text, managed)
 });
 object({
-	modelVersion: union([literal(2), literal(4)]),
+	modelVersion: union([
+		literal(2),
+		literal(4),
+		literal(5)
+	]),
 	document,
 	modules: record$12(text, module)
 }).extend({
@@ -7071,6 +7081,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding

package/dist/common/run-events.js

@@ -80,6 +80,8 @@ function artifact(value) {
 }
 function createEventProjector(platformRunId, nodeFailureCodes) {
 	const flows = /* @__PURE__ */ new Map();
+	const paths = /* @__PURE__ */ new Map();
+	const jobs = /* @__PURE__ */ new Map();
 	const nodeProgressBuckets = /* @__PURE__ */ new Map();
 	const runProgressBuckets = /* @__PURE__ */ new Map();
 	return async (value) => {
@@ -93,6 +95,9 @@ function createEventProjector(platformRunId, nodeFailureCodes) {
 			flows.set(rawRunId, flowId);
 			const parentRunId = event.parentRunId;
 			if (parentRunId !== void 0 && (typeof parentRunId != "string" || parentRunId.length == 0)) throw new TypeError("Runtime run.started parentRunId must be a non-empty string when present.");
+			const parentJobId = optionalString(event.parentJobId, "Runtime run.started parentJobId");
+			const parentNode = parentRunId == null || parentJobId == null ? void 0 : jobs.get(JSON.stringify([parentRunId, parentJobId]));
+			paths.set(rawRunId, parentRunId == null ? [] : [...paths.get(parentRunId) ?? [], parentNode ?? flowId]);
 			return {
 				kind: "run.started",
 				payload: {
@@ -120,7 +125,24 @@ function createEventProjector(platformRunId, nodeFailureCodes) {
 			};
 		}
 		if (type == "run.completed" || type == "run.failed") {
-			runId(event);
+			const rawRunId = runId(event);
+			if (type == "run.failed" && rawRunId == platformRunId && event.failure != null) {
+				const failure = object(event.failure, "Runtime terminal failure");
+				const context = nodeContext(failure, flows, platformRunId);
+				return {
+					kind: "node.failed",
+					payload: {
+						terminal: true,
+						nodeId: context.nodeId,
+						executionId: await context.executionId,
+						path: paths.get(context.rawRunId) ?? [],
+						error: {
+							code: nodeFailureCode(failure.code, nodeFailureCodes),
+							message: message(failure.message)
+						}
+					}
+				};
+			}
 			return;
 		}
 		if (type == "node.started" || type == "node.progress" || type == "node.artifact" || type == "node.log" || type == "node.completed" || type == "node.failed") {
@@ -139,6 +161,7 @@ function createEventProjector(platformRunId, nodeFailureCodes) {
 					value: object(event.outputs, "Runtime node.completed outputs")
 				};
 				case "node.started": {
+					jobs.set(JSON.stringify([context.rawRunId, event.jobId]), context.nodeId);
 					const kind = nodeKind(event.nodeKind);
 					const nodeTitle = optionalString(event.nodeTitle, "Runtime node.started nodeTitle");
 					const operation = optionalString(event.operation, "Runtime node.started operation");
@@ -190,6 +213,7 @@ function createEventProjector(platformRunId, nodeFailureCodes) {
 					kind: type,
 					payload: {
 						...payload,
+						...(paths.get(context.rawRunId)?.length ?? 0) == 0 ? {} : { path: paths.get(context.rawRunId) },
 						error: {
 							code: nodeFailureCode(event.code, nodeFailureCodes),
 							message: message(event.message)

package/dist/common/scheduler.d.ts

@@ -57,6 +57,9 @@ export type SchedulerEvent = {
     readonly message: string;
     readonly runId: string;
     readonly type: 'run.failed';
+    readonly failure?: Extract<SchedulerEvent, {
+        readonly type: 'node.failed';
+    }>;
 };
 export interface FlowRunResult {
     readonly kind: 'node-results';