@oomol-lab/open-flow 0.1.0-beta.67 → 0.1.0-beta.69

package/dist/common/control-api.js

@@ -1,3 +1,32 @@
+//#region src/execution/common/engineContract.ts
+var currentEngineContract = "open-flow-engine/v6";
+`${JSON.stringify(currentEngineContract)}`, new Set([
+	"assert",
+	"assert/strict",
+	"buffer",
+	"console",
+	"constants",
+	"crypto",
+	"events",
+	"fs",
+	"fs/promises",
+	"os",
+	"path",
+	"path/posix",
+	"process",
+	"punycode",
+	"querystring",
+	"stream",
+	"stream/promises",
+	"stream/web",
+	"string_decoder",
+	"timers",
+	"timers/promises",
+	"url",
+	"util",
+	"zlib"
+].flatMap((name) => [name, `node:${name}`])), `${JSON.stringify("open-flow-engine/v6/nodejs-compat-v1")}`;
+//#endregion
 //#region ../../node_modules/.bun/dequal@2.0.3/node_modules/dequal/lite/index.mjs
 var has = Object.prototype.hasOwnProperty;
 function dequal(foo, bar) {
@@ -5794,6 +5823,18 @@ function checkJsonDepth(value, depth = 0) {
 	if (value != null && typeof value == "object") for (const child of Object.values(value)) checkJsonDepth(child, depth + 1);
 }
 //#endregion
+//#region src/flow/common/retry.ts
+var nodeRetryLimits = {
+	maxRetries: 5,
+	minIntervalMs: 1e3,
+	maxIntervalMs: 6e4,
+	intervalStepMs: 1e3
+};
+var retryConfigurationSchema = strictObject({
+	maxRetries: number().int().min(0).max(nodeRetryLimits.maxRetries),
+	intervalMs: number().int().min(nodeRetryLimits.minIntervalMs).max(nodeRetryLimits.maxIntervalMs).multipleOf(nodeRetryLimits.intervalStepMs)
+});
+//#endregion
 //#region src/flow/common/triggerScheduleSchema.ts
 var triggerScheduleSchema = array(union([object({
 	type: literal("cron"),
@@ -5842,6 +5883,7 @@ var source = union([object({
 	kind: literal("node"),
 	nodeId: text,
 	output: text,
+	system: literal(true).optional(),
 	field: text.optional()
 }), object({
 	kind: literal("binding"),
@@ -6100,7 +6142,9 @@ var base = {
 	name: text.optional(),
 	description: text.optional(),
 	icon: text.optional(),
-	timeoutMs: number().optional()
+	timeoutMs: number().optional(),
+	retry: retryConfigurationSchema.optional(),
+	onError: _enum(["stop", "error"]).optional()
 };
 var node = union([
 	strictObject({
@@ -6236,7 +6280,8 @@ var revision = object({
 		literal(5),
 		literal(6),
 		literal(7),
-		literal(8)
+		literal(8),
+		literal(9)
 	]),
 	document,
 	modules: record$2(text, module)
@@ -6305,6 +6350,13 @@ var shapes = {
 	},
 	"graph.node.delete": at,
 	"graph.node.field.set": union([
+		object({
+			...at,
+			kind: literal("graph.node.field.set"),
+			field: literal("retry"),
+			before: retryConfigurationSchema.optional(),
+			value: retryConfigurationSchema.optional()
+		}),
 		object({
 			...at,
 			kind: literal("graph.node.field.set"),
@@ -6318,7 +6370,8 @@ var shapes = {
 			field: _enum([
 				"description",
 				"icon",
-				"name"
+				"name",
+				"onError"
 			]),
 			before: text.optional(),
 			value: text.optional()
@@ -6423,6 +6476,12 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...shape
 })])).values()])).min(1);
 function checkModelVersion(content) {
+	if (content.modelVersion < 9 && Object.values(content.document.graph.nodes).some((candidateNode) => "retry" in candidateNode && candidateNode.retry != null)) throw new TypeError("Node retries require Flow model version 9.");
+	if (content.modelVersion < 9 && Object.values(content.document.graph.nodes).some((candidateNode) => {
+		if (candidateNode.onError != null) return true;
+		if ([...Object.values("inputs" in candidateNode ? candidateNode.inputs : {}), ...Object.values(candidateNode.kind == "outputs" ? candidateNode.outputMappings : {})].some((candidateMapping) => candidateMapping.kind == "sources" && candidateMapping.sources.some((candidateSource) => candidateSource.kind == "node" && candidateSource.system))) return true;
+		return candidateNode.kind == "condition" && candidateNode.cases.some((item) => item.groups.some((candidateGroup) => candidateGroup.expressions.some((expression) => [expression.left, expression.right].some((candidateOperand) => candidateOperand?.kind == "source" && candidateOperand.source.kind == "node" && candidateOperand.source.system))));
+	})) throw new TypeError("Node error handling requires Flow model version 9.");
 	if (content.modelVersion < 8 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "outputs")) throw new TypeError("Workflow outputs require Flow model version 8.");
 	if (content.modelVersion < 7 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "start")) throw new TypeError("Start Triggers require Flow model version 7.");
 	if (content.modelVersion < 6 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task)) throw new TypeError("Node-owned managed Tasks require Flow model version 6.");
@@ -9330,12 +9389,19 @@ var output = strictObject({
 	port: id$1.optional().describe("Omit for a node with one output. For multiple outputs, choose a name from node details."),
 	field: string$1().optional()
 });
+var system = strictObject({
+	kind: literal("system"),
+	node: referenceSchema,
+	port: literal("error"),
+	field: string$1().optional()
+});
 var variable$1 = strictObject({
 	kind: literal("variable"),
 	name: id$1
 });
 var authoringSourceSchema = union([
 	output,
+	system,
 	variable$1,
 	strictObject({
 		kind: literal("value"),
@@ -9345,7 +9411,11 @@ var authoringSourceSchema = union([
 	strictObject({ kind: literal("default") }),
 	strictObject({
 		kind: literal("sources"),
-		sources: array(union([output, variable$1])).min(1)
+		sources: array(union([
+			output,
+			system,
+			variable$1
+		])).min(1)
 	})
 ]);
 var operand = union([
@@ -9355,6 +9425,7 @@ var operand = union([
 		schema: json$1.optional()
 	}),
 	output,
+	system,
 	variable$1
 ]);
 var agentTool = authoringDefinitionSchemas.agent.shape.tools.element.omit({
@@ -9446,11 +9517,13 @@ var authoringConfigurations = {
 	approval: strictObject({ inputs: inputFields })
 };
 var updates = strictObject({
+	onError: _enum(["stop", "error"]).optional(),
 	name: id$1.optional(),
 	description: string$1().optional(),
 	icon: string$1().optional(),
 	maxExecutions: int().positive().optional(),
 	timeoutMs: number().nonnegative().optional(),
+	retry: retryConfigurationSchema.partial().optional().describe("Node retry policy for Code, Connector, OpenAPI, LLM and AI Decision. Omitted update fields preserve the policy; use clear: [[\"retry\"]] to disable it. maxRetries counts additional attempts; intervalMs is 1000–60000 in whole seconds."),
 	config: patch.optional().describe("Recursively merge configuration; omitted fields remain unchanged and arrays replace as a whole. This includes schema objects: {} does not clear an existing schema. Use clear paths to remove fields, e.g. [\"config\",\"inputs\",\"amount\",\"schema\",\"type\"].")
 });
 var authoringEditSchema = discriminatedUnion("op", [
@@ -9459,6 +9532,8 @@ var authoringEditSchema = discriminatedUnion("op", [
 		as: id$1.regex(/^[A-Za-z][\w-]*$/).describe("Unique batch-local alias without the $ prefix. Later edits must reference this new node as $alias; the bare alias is not its node ID."),
 		type,
 		name: id$1,
+		onError: _enum(["stop", "error"]).optional(),
+		retry: retryConfigurationSchema.optional(),
 		config: patch.optional(),
 		inputs: record$2(id$1, authoringSourceSchema).optional().describe("Input data sources, applied after creation, as input.set operations. Execution edges are separate."),
 		code: string$1().optional(),
@@ -11080,22 +11155,44 @@ function nodeDetails(content, nodeId, node) {
 //#endregion
 //#region src/control/common/eventSources.ts
 var id = string$1().min(1).max(256);
-var eventType = string$1().regex(/^[a-z][a-z0-9_.]{0,127}$/);
+var eventType = string$1().regex(/^[a-z][a-z0-9_.:]{0,127}$/);
 var name = string$1().trim().min(1).max(128);
 var eventSourceSchema = object({
 	version: literal(1),
 	sourceId: id,
 	revision: int().positive(),
 	name,
-	provider: _enum(["feishu", "feishu_app_bot"]),
-	appId: id,
+	provider: _enum([
+		"feishu",
+		"feishu_app_bot",
+		"slackbot",
+		"intercom",
+		"sentry",
+		"zoom",
+		"fireflies",
+		"jira"
+	]),
+	appId: id.nullable(),
+	workspaceId: id.optional(),
+	installationId: id.optional(),
+	organizationId: id.optional(),
+	projectId: id.optional(),
+	projectKey: id.optional(),
+	subscriptionStatus: _enum([
+		"idle",
+		"pending",
+		"ready",
+		"error"
+	]).optional(),
+	lastError: string$1().optional(),
+	signingSecretConfigured: boolean().optional(),
 	connectionId: id,
 	teamId: id.nullable(),
 	enabled: boolean(),
 	eventTypes: array(eventType),
-	manageSubscriptions: boolean(),
-	verificationTokenConfigured: boolean(),
-	encryptKeyConfigured: boolean(),
+	manageSubscriptions: boolean().nullable(),
+	verificationTokenConfigured: boolean().nullable(),
+	encryptKeyConfigured: boolean().nullable(),
 	endpointUrl: string$1().nullable(),
 	verifiedAt: string$1().nullable(),
 	lastReceivedAt: string$1().nullable(),
@@ -11106,6 +11203,21 @@ var eventSourceSchema = object({
 		triggerNodeId: id
 	}))
 });
+eventSourceSchema.pick({
+	appId: true,
+	workspaceId: true,
+	installationId: true,
+	organizationId: true,
+	projectId: true,
+	projectKey: true,
+	subscriptionStatus: true,
+	lastError: true,
+	signingSecretConfigured: true,
+	manageSubscriptions: true,
+	verificationTokenConfigured: true,
+	encryptKeyConfigured: true,
+	verifiedAt: true
+});
 function decodeEventSource(value) {
 	return eventSourceSchema.parse(value);
 }
@@ -11758,6 +11870,21 @@ function workflowIdentity(value) {
 		executionId: string(ref.executionId)
 	};
 }
+function runInitiator(value) {
+	const source = record(value);
+	if (![
+		"workbench",
+		"cli",
+		"mcp",
+		"api",
+		"trigger",
+		"workflow"
+	].includes(source.channel)) return invalidResponse();
+	return {
+		channel: source.channel,
+		...source.actorId === void 0 ? {} : { actorId: string(source.actorId) }
+	};
+}
 function runDetails(value) {
 	const source = record(value);
 	const summary = run(source);
@@ -11779,6 +11906,7 @@ function runDetails(value) {
 	if (source.calls !== void 0 && !Array.isArray(source.calls)) return invalidResponse();
 	const details = {
 		...summary,
+		...source.initiator === void 0 ? {} : { initiator: runInitiator(source.initiator) },
 		...errorHandling(source),
 		...source.triggerNodeId === void 0 ? {} : { triggerNodeId: string(source.triggerNodeId) },
 		...source.caller === void 0 ? {} : { caller: workflowIdentity(source.caller) },
@@ -12070,6 +12198,7 @@ function decodeRunEvent(value) {
 					kind,
 					payload: {
 						...node,
+						...payload.systemOutputs === void 0 ? {} : { systemOutputs: Object.fromEntries(Object.entries(record(payload.systemOutputs)).map(([key, item]) => [key, jsonValue(item)])) },
 						outputs: Object.fromEntries(Object.entries(record(payload.outputs)).map(([key, item]) => [key, jsonValue(item)]))
 					}
 				};
@@ -12080,6 +12209,8 @@ function decodeRunEvent(value) {
 						kind,
 						payload: {
 							...node,
+							...payload.handled === true ? { handled: true } : {},
+							...payload.systemOutputs === void 0 ? {} : { systemOutputs: Object.fromEntries(Object.entries(record(payload.systemOutputs)).map(([key, item]) => [key, jsonValue(item)])) },
 							error: {
 								code: string(error.code),
 								message: string(error.message)
@@ -12159,7 +12290,8 @@ function operationKey(operation) {
 	return `${operation}-${randomId()}`;
 }
 var ControlClient = class {
-	constructor(requestControl) {
+	constructor(requestControl, channel = "api") {
+		this.channel = channel;
 		this.requestControl = requestControl;
 	}
 	async loadOpenApiDocument(url, signal) {
@@ -12185,8 +12317,8 @@ var ControlClient = class {
 	async listEventSources(flowId, signal) {
 		return decodeEventSources(await this.request("/v1/event-sources" + (flowId == null ? "" : `?flowId=${segment(flowId)}`), { signal }));
 	}
-	async listEventSourceConnections(teamId, signal) {
-		const source = record(await this.request(`/v1/event-sources/connections${teamId == null ? "" : `?teamId=${segment(teamId)}`}`, { signal }));
+	async listEventSourceConnections(teamId, signal, kind = "feishu") {
+		const source = record(await this.request(`/v1/event-sources/connections?kind=${kind}${teamId == null ? "" : `&teamId=${segment(teamId)}`}`, { signal }));
 		requiredFields(source, ["version", "connections"]);
 		if (source.version != 1 || !Array.isArray(source.connections)) return invalidResponse();
 		return source.connections.map(connection);
@@ -12649,7 +12781,7 @@ var ControlClient = class {
 	async checkFlow(flowId, revisionId) {
 		return flowCheck(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}/check`, {
 			body: JSON.stringify({
-				engineContract: "open-flow-engine/v5",
+				engineContract: currentEngineContract,
 				version: 1
 			}),
 			method: "POST"
@@ -12674,12 +12806,15 @@ var ControlClient = class {
 	async createDraftRun(flowId, revisionId, options) {
 		const created = runDetails(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}/runs`, {
 			body: JSON.stringify({
-				engineContract: "open-flow-engine/v5",
+				engineContract: currentEngineContract,
 				inputs: options.inputs ?? {},
 				trigger: options.trigger,
 				version: 2
 			}),
-			headers: { "idempotency-key": options.idempotencyKey ?? operationKey("run") },
+			headers: {
+				"idempotency-key": options.idempotencyKey ?? operationKey("run"),
+				"x-open-flow-client": this.channel
+			},
 			method: "POST"
 		}));
 		return created.source == "draft" ? created : invalidResponse();
@@ -12692,7 +12827,10 @@ var ControlClient = class {
 				publicationId,
 				version: 2
 			}),
-			headers: { "idempotency-key": options.idempotencyKey ?? operationKey("run") },
+			headers: {
+				"idempotency-key": options.idempotencyKey ?? operationKey("run"),
+				"x-open-flow-client": this.channel
+			},
 			method: "POST"
 		}));
 		return created.source == "live" ? created : invalidResponse();
@@ -12710,7 +12848,7 @@ var ControlClient = class {
 	async publishFlow(flowId, revisionId, expectedLivePublicationId, options = {}) {
 		return publishOperation(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}/publications`, {
 			body: JSON.stringify({
-				engineContract: "open-flow-engine/v5",
+				engineContract: currentEngineContract,
 				expectedLivePublicationId,
 				version: 1
 			}),

package/dist/common/control-requests.d.ts

@@ -37,12 +37,22 @@ export declare const controlRequests: {
             as: string;
             type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow";
             name: string;
+            onError?: "error" | "stop" | undefined;
+            retry?: {
+                maxRetries: number;
+                intervalMs: number;
+            } | undefined;
             config?: Record<string, z.JSONType> | undefined;
             inputs?: Record<string, {
                 kind: "output";
                 node: string;
                 port?: string | undefined;
                 field?: string | undefined;
+            } | {
+                kind: "system";
+                node: string;
+                port: "error";
+                field?: string | undefined;
             } | {
                 kind: "variable";
                 name: string;
@@ -60,6 +70,11 @@ export declare const controlRequests: {
                     node: string;
                     port?: string | undefined;
                     field?: string | undefined;
+                } | {
+                    kind: "system";
+                    node: string;
+                    port: "error";
+                    field?: string | undefined;
                 } | {
                     kind: "variable";
                     name: string;
@@ -71,11 +86,16 @@ export declare const controlRequests: {
             op: "node.update";
             node: string;
             set?: {
+                onError?: "error" | "stop" | undefined;
                 name?: string | undefined;
                 description?: string | undefined;
                 icon?: string | undefined;
                 maxExecutions?: number | undefined;
                 timeoutMs?: number | undefined;
+                retry?: {
+                    maxRetries?: number | undefined;
+                    intervalMs?: number | undefined;
+                } | undefined;
                 config?: Record<string, z.JSONType> | undefined;
             } | undefined;
             clear?: string[][] | undefined;
@@ -94,6 +114,11 @@ export declare const controlRequests: {
                 node: string;
                 port?: string | undefined;
                 field?: string | undefined;
+            } | {
+                kind: "system";
+                node: string;
+                port: "error";
+                field?: string | undefined;
             } | {
                 kind: "variable";
                 name: string;
@@ -111,6 +136,11 @@ export declare const controlRequests: {
                     node: string;
                     port?: string | undefined;
                     field?: string | undefined;
+                } | {
+                    kind: "system";
+                    node: string;
+                    port: "error";
+                    field?: string | undefined;
                 } | {
                     kind: "variable";
                     name: string;
@@ -159,25 +189,8 @@ export declare const controlRequests: {
         url: string;
         version: 1;
     };
-    createEventSource: (value: unknown) => {
-        version: 1;
-        name: string;
-        connectionId: string;
-        teamId: string | null;
-        verificationToken: string;
-        encryptKey: string;
-        eventTypes: string[];
-        manageSubscriptions: boolean;
-    };
-    updateEventSource: (value: unknown) => {
-        version: 1;
-        expectedRevision: number;
-        name: string;
-        enabled: boolean;
-        eventTypes: string[];
-        verificationToken?: string | undefined;
-        encryptKey?: string | undefined;
-    };
+    createEventSource: (value: unknown) => import("./event-sources.js").CreateEventSource;
+    updateEventSource: (value: unknown) => import("./event-sources.js").UpdateEventSource;
     eventSourceRevision: (value: unknown) => {
         version: 1;
         expectedRevision: number;