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

package/dist/common/poll-trigger.js

@@ -9345,6 +9345,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json,
+			auth: array(object({
+				id: text,
+				type: _enum([
+					"bearer",
+					"basic",
+					"apiKey"
+				]),
+				name: text.optional(),
+				in: _enum(["header", "query"]).optional()
+			}))
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -9461,6 +9479,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 +9537,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -9589,7 +9613,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 +9625,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -9750,6 +9783,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.openapi.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.agent.set": {
 		taskId: text,
 		before: managed,

package/dist/common/provider-triggers.js

@@ -6819,6 +6819,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json,
+			auth: array(object({
+				id: text,
+				type: _enum([
+					"bearer",
+					"basic",
+					"apiKey"
+				]),
+				name: text.optional(),
+				in: _enum(["header", "query"]).optional()
+			}))
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -6935,6 +6953,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 +7011,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -7063,7 +7087,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 +7099,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -7224,6 +7257,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.openapi.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.agent.set": {
 		taskId: text,
 		before: managed,

package/dist/common/run-events.js

@@ -6,6 +6,7 @@ var nodeKinds = /* @__PURE__ */ new Set([
 	"condition",
 	"connector",
 	"javascript",
+	"openapi",
 	"llm",
 	"subflow",
 	"value",
@@ -80,6 +81,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 +96,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 +126,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 +162,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 +214,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

@@ -25,7 +25,7 @@ export type SchedulerEvent = {
     readonly inputs: Readonly<Record<string, JsonValue>>;
     readonly jobId: string;
     readonly nodeId: string;
-    readonly nodeKind: 'agent' | 'approval' | 'condition' | 'connector' | 'javascript' | 'llm' | 'subflow' | 'value' | 'wait';
+    readonly nodeKind: 'agent' | 'approval' | 'condition' | 'connector' | 'javascript' | 'openapi' | 'llm' | 'subflow' | 'value' | 'wait';
     readonly nodeTitle?: string;
     readonly runId: string;
     readonly type: 'node.started';
@@ -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';

package/dist/common/scheduler.js

@@ -1,3 +1,4 @@
+import * as Cause from "effect/Cause";
 import * as Clock from "effect/Clock";
 import * as Effect from "effect/Effect";
 import * as FiberSet from "effect/FiberSet";
@@ -6631,6 +6632,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json,
+			auth: array(object({
+				id: text,
+				type: _enum([
+					"bearer",
+					"basic",
+					"apiKey"
+				]),
+				name: text.optional(),
+				in: _enum(["header", "query"]).optional()
+			}))
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -6747,6 +6766,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(),
@@ -6804,6 +6824,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -6875,7 +6900,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({
@@ -6883,6 +6912,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -7036,6 +7070,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.openapi.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.agent.set": {
 		taskId: text,
 		before: managed,
@@ -10201,6 +10240,67 @@ function isJsonObject(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",
@@ -10245,6 +10345,7 @@ var cronOutputs = [{
 }];
 function triggerOutputDefinitions(trigger) {
 	switch (trigger.kind) {
+		case "error": return errorOutputs;
 		case "manual": return [];
 		case "cron": return cronOutputs;
 		case "poll":
@@ -10316,6 +10417,7 @@ function nodeOutputPorts(document, node) {
 		case "cron":
 		case "integration":
 		case "poll":
+		case "error":
 		case "manual":
 		case "webhook": return triggerOutputPorts(node);
 	}
@@ -10714,6 +10816,7 @@ function runGraph(context, target, runId, inputs, parent, launchInputs = {}, tri
 				const kind = nodeKind(context.prepared, node);
 				const title = nodeTitle(context.prepared, node);
 				const projectedInputs = Object.fromEntries(Object.entries(nodeInputs).filter(([handle]) => {
+					if (node.kind == "task" && node.taskId != null && context.prepared.tasks[node.taskId]?.executor.kind == "openapi" && handle.startsWith("auth.")) return false;
 					const mapping = nodeInputMappings(node)[handle];
 					return mapping?.kind != "sources" || mapping.sources.every((source) => source.kind != "binding");
 				}));
@@ -10755,7 +10858,13 @@ function runGraph(context, target, runId, inputs, parent, launchInputs = {}, tri
 							additionalInputs: Object.fromEntries(Object.entries(nodeInputs).filter(([handle]) => additional.has(handle))),
 							blockId: node.task != null ? node.task.moduleId : node.taskId,
 							flowId: target.flowId,
-							input: Object.fromEntries(Object.entries(nodeInputs).filter(([handle]) => !additional.has(handle))),
+							input: Object.fromEntries(Object.entries(nodeInputs).filter(([handle]) => {
+								if (additional.has(handle)) return false;
+								const task = node.taskId == null ? void 0 : context.prepared.tasks[node.taskId];
+								if (task?.executor.kind != "openapi") return true;
+								const mapping = node.inputs[handle];
+								return mapping?.kind != "unset" && (mapping != null || task.inputs.some((port) => "handle" in port && port.handle == handle && port.value !== void 0));
+							})),
 							invocationId: saved?.invocationId ?? (config == null ? context.createId() : jobId),
 							...resolution == null || saved == null ? {} : { agent: {
 								action: resolution,
@@ -10863,14 +10972,19 @@ function runGraph(context, target, runId, inputs, parent, launchInputs = {}, tri
 			return createWait(nodeId, jobId, result.value);
 		};
 		const observe = (nodeId, jobId, effect) => effect.pipe(Effect.catchDefect((error) => Effect.fail(error instanceof Error ? error : new Error(String(error)))), Effect.tapError((error) => Effect.gen(function* () {
-			if (firstCause == null) firstFailure ??= error;
-			yield* context.emit({
+			const failure = {
 				...nodeFailure(error, context.projectFailure),
 				jobId,
 				nodeId,
 				runId,
 				type: "node.failed"
-			}).pipe(Effect.ignore);
+			};
+			if (!context.failures.has(error)) context.failures.set(error, failure);
+			if (firstCause == null) {
+				firstFailure = error;
+				firstCause = Cause.fail(error);
+			}
+			yield* context.emit(failure).pipe(Effect.ignore);
 		})), Effect.tapCause((cause) => Effect.sync(() => {
 			firstCause ??= cause;
 		})));
@@ -10960,7 +11074,8 @@ function runGraph(context, target, runId, inputs, parent, launchInputs = {}, tri
 				yield* context.emit({
 					message: firstFailure?.message ?? "Execution failed.",
 					runId,
-					type: "run.failed"
+					type: "run.failed",
+					...firstFailure == null ? {} : { failure: context.failures.get(firstFailure) }
 				}).pipe(Effect.ignore);
 				return yield* Effect.failCause(firstCause);
 			}
@@ -11052,6 +11167,7 @@ function runFlow(prepared, options) {
 		const triggerNode = options.trigger == null ? void 0 : prepared.graph.nodes[options.trigger.nodeId];
 		if (options.trigger != null && (triggerNode == null || "inputs" in triggerNode)) return yield* Effect.fail(/* @__PURE__ */ new Error(`Node "${options.trigger.nodeId}" is not a TriggerNode in Flow "${options.flowId}".`));
 		return yield* runGraph({
+			failures: /* @__PURE__ */ new WeakMap(),
 			counts: Object.fromEntries(Object.entries(checkpoint?.counts ?? {}).map(([scope, counts]) => [scope, { ...counts }])),
 			bindingValues: checkpoint?.bindingValues ?? options.bindingValues ?? {},
 			createId: options.createId,

package/dist/common/trigger-contract.d.ts

@@ -1,6 +1,8 @@
 import type { JsonValue, Port, PortDefinition, TriggerNode } from '../browser/flow-change.js';
 import { webhookMethods, webhookSupportsBody } from '../browser/webhook-method.js';
 export { webhookMethods, webhookSupportsBody };
+export declare const errorOutputs: readonly Port[];
+export declare const sampleErrorOutputs: Readonly<Record<string, JsonValue>>;
 export declare const webhookOutputs: readonly Port[];
 export declare function triggerOutputDefinitions(trigger: TriggerNode): readonly Port[];
 export declare function triggerOutputPorts(trigger: TriggerNode): Readonly<Record<string, PortDefinition>>;

package/dist/common/webhook-trigger.js

@@ -8485,6 +8485,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json,
+			auth: array(object({
+				id: text,
+				type: _enum([
+					"bearer",
+					"basic",
+					"apiKey"
+				]),
+				name: text.optional(),
+				in: _enum(["header", "query"]).optional()
+			}))
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -8601,6 +8619,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(),
@@ -8658,6 +8677,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -8729,7 +8753,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({
@@ -8737,6 +8765,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -8890,6 +8923,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.openapi.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.agent.set": {
 		taskId: text,
 		before: managed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oomol-lab/open-flow",
-  "version": "0.1.0-beta.50",
+  "version": "0.1.0-beta.52",
   "description": "TypeScript contracts and Browser runtime for Open Flow.",
   "license": "Apache-2.0",
   "repository": {
@@ -13,6 +13,10 @@
     ".": {
       "types": "./dist/index.d.ts"
     },
+    "./openapi": {
+      "types": "./dist/common/openapi.d.ts",
+      "import": "./dist/common/openapi.js"
+    },
     "./connector-action": {
       "types": "./dist/common/connector-action.d.ts",
       "import": "./dist/common/connector-action.js"