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

package/dist/common/integration-trigger.js

@@ -9369,6 +9369,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"])
@@ -9485,6 +9503,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 +9561,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -9613,7 +9637,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 +9649,11 @@ object({
 	version: literal(1)
 });
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -9774,6 +9807,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/mcp.js

@@ -5877,6 +5877,15 @@ var runStatuses = [
 //#region src/execution/common/wait.ts
 /** Shared by decision entry points, the editor, and durable decision storage. */
 var waitCommentSchema = string$1().trim().refine((value) => [...value].length <= 2e3, "Wait comment must contain at most 2,000 Unicode code points.").nullable().optional();
+//#endregion
+//#region src/openapi/common/authBindings.ts
+/** Never allow credentials to enter a Revision as literal node inputs. */
+function assertOpenApiAuthBindings(document) {
+	for (const graph of [document.graph, ...Object.values(document.subflows).map((subflow) => subflow.graph)]) for (const node of Object.values(graph.nodes)) {
+		if (node.kind != "task" || node.taskId == null || document.tasks[node.taskId]?.executor.kind != "openapi") continue;
+		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && (mapping.kind == "value" || mapping.kind == "sources" && mapping.sources.some((source) => source.kind == "flow"))) throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+	}
+}
 function checkJsonDepth(value, depth = 0) {
 	if (depth > 64) throw new TypeError("Value exceeds the maximum JSON depth.");
 	if (value != null && typeof value == "object") for (const child of Object.values(value)) checkJsonDepth(child, depth + 1);
@@ -6007,6 +6016,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json$2,
+			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"])
@@ -6123,6 +6150,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 +6208,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("error"),
+		sourceFlowIds: sourceFlowIds.optional()
+	}),
 	object({
 		...trigger,
 		kind: literal("webhook"),
@@ -6251,7 +6284,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 +6298,17 @@ revision.extend({
 });
 function decodeRevisionContent(value) {
 	checkJsonDepth(value);
-	return revision.parse(value);
+	const content = revision.parse(value);
+	checkErrorModelVersion(content);
+	assertOpenApiAuthBindings(content.document);
+	return content;
 }
 var shapes = {
+	"graph.trigger.sources.set": {
+		nodeId: text,
+		before: sourceFlowIds.optional(),
+		value: sourceFlowIds.optional()
+	},
 	"binding.create": {
 		bindingId: text,
 		binding
@@ -6417,6 +6462,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,
@@ -6437,6 +6487,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 +9893,7 @@ function triggerKey(value) {
 	};
 }
 var triggerKinds = /* @__PURE__ */ new Set([
+	"error",
 	"cron",
 	"integration",
 	"poll",
@@ -10172,6 +10226,7 @@ function flow$1(value) {
 			revisionId: string(target.revisionId)
 		} },
 		createdAt: string(source.createdAt),
+		...source.connectorTeamId == null ? {} : { connectorTeamId: string(source.connectorTeamId) },
 		draftRevisionId: string(source.draftRevisionId),
 		flowId: string(source.flowId),
 		name: string(source.name),
@@ -10216,6 +10271,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 +10540,7 @@ function runDetails(value) {
 	};
 	const details = {
 		...summary,
+		...errorHandling(source),
 		closureDigest: string(source.closureDigest),
 		engineContract: string(source.engineContract),
 		engineDigest: string(source.engineDigest),
@@ -10573,10 +10640,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 +10648,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() {
@@ -10707,7 +10808,7 @@ function decodeRunEvent(value) {
 			switch (kind) {
 				case "node.started": {
 					const nodeKind = payload.nodeKind;
-					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "subflow" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
+					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "subflow" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,
@@ -10816,6 +10917,18 @@ var ControlClient = class {
 	constructor(requestControl) {
 		this.requestControl = requestControl;
 	}
+	async loadOpenApiDocument(url, signal) {
+		const result = record(await this.request("/v1/openapi/document", {
+			method: "POST",
+			body: JSON.stringify({
+				url,
+				version: 1
+			}),
+			signal
+		}));
+		if (result.version != 1) return invalidResponse();
+		return jsonValue(result.document);
+	}
 	async listFlows(options = {}) {
 		const parameters = new URLSearchParams();
 		if (options.cursor != null) parameters.set("cursor", options.cursor);
@@ -10891,6 +11004,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/openapi.d.ts

@@ -0,0 +1,53 @@
+import type { JsonValue, ManagedTaskDefinition } from '../browser/flow-change.js';
+type ObjectValue = {
+    [key: string]: JsonValue;
+};
+export interface OpenApiAuth {
+    readonly id: string;
+    readonly type: 'bearer' | 'basic' | 'apiKey';
+    readonly name?: string;
+    readonly in?: 'header' | 'query';
+}
+export interface OpenApiExecutor {
+    readonly kind: 'openapi';
+    readonly sourceUrl: string;
+    readonly method: string;
+    readonly path: string;
+    readonly serverUrl: string;
+    readonly document: JsonValue;
+    readonly auth: readonly OpenApiAuth[];
+}
+export interface OpenApiOperation {
+    readonly method: string;
+    readonly path: string;
+    readonly label: string;
+    readonly tag: string;
+}
+export declare function object(value: unknown): ObjectValue;
+export declare function httpUrl(value: string, base?: string): string;
+export declare function parseOpenApi(value: unknown): ObjectValue;
+export declare function listOperations(documentValue: JsonValue): OpenApiOperation[];
+export declare function servers(value: JsonValue, path: string, method: string): readonly ObjectValue[];
+export declare function serverAddress(server: ObjectValue, sourceUrl: string, variables?: Readonly<Record<string, string>>): string;
+export declare function securityOptions(value: JsonValue, path: string, method: string): readonly {
+    label: string;
+    auth?: readonly OpenApiAuth[];
+    error?: string;
+}[];
+export declare function snapshot(documentValue: JsonValue, path: string, method: string): JsonValue;
+export declare function authHandles(auth: readonly OpenApiAuth[]): string[];
+export declare function openApiTask(config: OpenApiExecutor, name?: string): ManagedTaskDefinition;
+export interface OpenApiFieldIssue {
+    readonly field: 'sourceUrl' | 'operation' | 'serverUrl';
+    readonly message: string;
+}
+/** The canvas validator and property panel share the same configuration contract. */
+export declare function openApiFieldIssues(task: ManagedTaskDefinition): OpenApiFieldIssue[];
+export declare function openApiIssues(task: ManagedTaskDefinition): string[];
+export declare function selectOperation(value: JsonValue, sourceUrl: string, path: string, method: string): OpenApiExecutor;
+export declare function buildRequest(config: OpenApiExecutor, input: Readonly<Record<string, JsonValue>>): {
+    url: string;
+    init: RequestInit;
+};
+export declare function parseResponse(config: OpenApiExecutor, status: number, headers: Headers, text: string): Record<string, JsonValue>;
+export {};