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

package/dist/browser/flow-authoring-node.d.ts

@@ -1,5 +1,5 @@
 import type { DecisionQuestion } from '../common/decision.js';
-import type { ChangeOperation, CodeModule, ConnectorCapability, Group, GraphNode, InputMapping, InputValues, InputPort, JsonValue, Port, PortDefinition, RevisionContent, TaskDefinition, TriggerKeySnapshot, TriggerNode, TriggerSchedule, WebhookOptions } from './flow-change.js';
+import type { ChangeOperation, CodeModule, ConnectorCapability, Group, GraphNode, InputMapping, InputValues, InputPort, JsonValue, Port, PortDefinition, RetryConfiguration, RevisionContent, TaskDefinition, TriggerKeySnapshot, TriggerNode, TriggerSchedule, WebhookOptions } from './flow-change.js';
 export declare const defaultCodeTaskPorts: Pick<Extract<TaskDefinition, {
     readonly moduleId: string;
 }>, 'inputs' | 'outputs' | 'capabilities'>;
@@ -7,6 +7,8 @@ export interface Settings {
     readonly name?: string;
     readonly maxExecutions?: number;
     readonly timeoutMs?: number;
+    readonly onError?: 'stop' | 'error';
+    readonly retry?: RetryConfiguration;
 }
 export interface LlmTaskOptions {
     readonly inputs?: Readonly<Partial<Record<LlmInputHandle, JsonValue>>>;

package/dist/browser/flow-authoring.js

@@ -5827,6 +5827,28 @@ 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 retryNodeTypes = [
+	"code",
+	"connector",
+	"openapi",
+	"llm",
+	"decision"
+];
+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)
+});
+function supportsNodeRetry(node) {
+	return node.kind == "task" && retryNodeTypes.some((type) => type == ("moduleId" in node.task ? "code" : node.task.executor.kind));
+}
+//#endregion
 //#region src/flow/common/triggerScheduleSchema.ts
 var triggerScheduleSchema = array(union([object({
 	type: literal("cron"),
@@ -5872,6 +5894,7 @@ var source = union([object({
 	kind: literal("node"),
 	nodeId: text,
 	output: text,
+	system: literal(true).optional(),
 	field: text.optional()
 }), object({
 	kind: literal("binding"),
@@ -6130,7 +6153,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({
@@ -6251,7 +6276,8 @@ var revision = object({
 		literal(5),
 		literal(6),
 		literal(7),
-		literal(8)
+		literal(8),
+		literal(9)
 	]),
 	document,
 	modules: record$1(text, module)
@@ -6320,6 +6346,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"),
@@ -6333,7 +6366,8 @@ var shapes = {
 			field: _enum([
 				"description",
 				"icon",
-				"name"
+				"name",
+				"onError"
 			]),
 			before: text.optional(),
 			value: text.optional()
@@ -6438,6 +6472,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.");
@@ -6500,6 +6540,11 @@ function setConditionInput(node, handle, mapping) {
 	};
 }
 //#endregion
+//#region src/flow/common/errorHandling.ts
+function supportsNodeErrorHandling(node) {
+	return supportsNodeRetry(node);
+}
+//#endregion
 //#region src/flow/common/change.ts
 function decodeConnectorCapabilities(value) {
 	if (!Array.isArray(value)) throw new TypeError("Connector capabilities must be an array.");
@@ -6628,10 +6673,10 @@ function isTriggerNode(node) {
 function upgradeDecodedRevisionContent(content) {
 	const graph = content.document.graph;
 	const hasManual = Object.values(graph.nodes).some((node) => node.kind == "manual");
-	if (!hasManual && content.modelVersion == 8) return content;
+	if (!hasManual && content.modelVersion == 9) return content;
 	return {
 		...content,
-		modelVersion: 8,
+		modelVersion: 9,
 		document: {
 			...content.document,
 			graph: hasManual ? {
@@ -6666,7 +6711,7 @@ function invalid(message) {
 	throw new FlowChangeError(message);
 }
 function applyFlowChanges(content, operations) {
-	const source = content.modelVersion != 8 || Object.values(content.document.graph.nodes).some((node) => node.kind == "manual") ? decodeRevisionContent(content) : content;
+	const source = content.modelVersion != 9 || Object.values(content.document.graph.nodes).some((node) => node.kind == "manual") ? decodeRevisionContent(content) : content;
 	const document = { ...source.document };
 	const modules = { ...source.modules };
 	for (const operation of operations) switch (operation.kind) {
@@ -6838,6 +6883,8 @@ function applyFlowChanges(content, operations) {
 			const graph = document.graph;
 			const node = graph.nodes[operation.nodeId];
 			if (node == null) invalid("The Node does not exist in the target graph.");
+			if (operation.field == "onError" && operation.value != null && (!supportsNodeErrorHandling(node) || !["stop", "error"].includes(String(operation.value)))) invalid("This node does not support this error handling setting.");
+			if (operation.field == "retry" && operation.value != null && !supportsNodeRetry(node)) invalid("This node does not support retries.");
 			if (operation.field == "connectionId" && node.kind != "poll" && node.kind != "integration") invalid("Only provider Triggers select a node Connection.");
 			if (!dequal(Reflect.get(node, operation.field), operation.before)) invalid("The Node field changed before this operation was applied.");
 			const updated = { ...node };
@@ -7109,7 +7156,7 @@ function applyFlowChanges(content, operations) {
 	assertOpenApiAuthBindings(document);
 	return upgradeDecodedRevisionContent({
 		document,
-		modelVersion: 8,
+		modelVersion: 9,
 		modules
 	});
 }
@@ -10254,6 +10301,20 @@ function updateSettings(content, nodeId, settings) {
 		nodeId,
 		value: settings.timeoutMs
 	});
+	if (Object.hasOwn(settings, "onError") && node.onError != settings.onError) operations.push({
+		before: node.onError,
+		field: "onError",
+		kind: "graph.node.field.set",
+		nodeId,
+		value: settings.onError
+	});
+	if (Object.hasOwn(settings, "retry") && !dequal(node.retry, settings.retry)) operations.push({
+		before: node.retry,
+		field: "retry",
+		kind: "graph.node.field.set",
+		nodeId,
+		value: settings.retry
+	});
 	return operations;
 }
 function setInputValues(content, nodeId, values) {

package/dist/browser/flow-change-schema.d.ts

@@ -1,6 +1,6 @@
 import type { ChangeOperation, FlowDocument, JsonValue, RevisionContent } from './flow-change.js';
 import { z } from 'zod';
-export declare const currentFlowModelVersion = 8;
+export declare const currentFlowModelVersion = 9;
 /** Configuration schemas shared by the node authoring boundary. */
 export declare const authoringDefinitionSchemas: {
     input: z.ZodObject<{
@@ -57,6 +57,7 @@ export declare const authoringDefinitionSchemas: {
                             kind: z.ZodLiteral<"node">;
                             nodeId: z.ZodString;
                             output: z.ZodString;
+                            system: z.ZodOptional<z.ZodLiteral<true>>;
                             field: z.ZodOptional<z.ZodString>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"binding">;
@@ -95,6 +96,7 @@ export declare const authoringDefinitionSchemas: {
                             kind: z.ZodLiteral<"node">;
                             nodeId: z.ZodString;
                             output: z.ZodString;
+                            system: z.ZodOptional<z.ZodLiteral<true>>;
                             field: z.ZodOptional<z.ZodString>;
                         }, z.core.$strip>, z.ZodObject<{
                             kind: z.ZodLiteral<"binding">;

package/dist/browser/flow-change.d.ts

@@ -1,8 +1,13 @@
 import type { JsonValue, Port, PortDefinition } from '../index.js';
 export { fixedInputValue, inputValue, inputValues } from './flow-input-value.js';
+import type { RetryConfiguration } from '../common/flow-retry.js';
 import type { WebhookMethod } from './webhook-method.js';
 import { currentFlowModelVersion } from './flow-change-schema.js';
 export { changeOperationsSchema, currentFlowModelVersion, decodeChangeOperations } from './flow-change-schema.js';
+export type { RetryConfiguration } from '../common/flow-retry.js';
+export { supportsNodeRetry } from '../common/flow-retry.js';
+export { nodeSystemOutputPorts, supportsNodeErrorHandling, nodeErrorSchema } from '../common/flow-errorHandling.js';
+export type { NodeErrorData } from '../common/flow-errorHandling.js';
 export type { WebhookMethod };
 export type { JsonValue, Port, PortDefinition } from '../index.js';
 export type SchemaKeyword = 'const' | 'enum' | 'exclusiveMaximum' | 'exclusiveMinimum' | 'maximum' | 'maxItems' | 'maxLength' | 'maxProperties' | 'minimum' | 'minItems' | 'minLength' | 'minProperties' | 'multipleOf' | 'pattern' | 'required' | 'type';
@@ -35,6 +40,7 @@ export interface Group {
 }
 export declare function portsByHandle<Value extends Port>(ports: readonly (Value | Group)[]): Readonly<Record<string, Value>>;
 export interface NodeSource {
+    readonly system?: true;
     readonly field?: string;
     readonly kind: 'node';
     readonly nodeId: string;
@@ -62,6 +68,8 @@ interface GraphNodeBase {
     readonly name?: string;
     readonly maxExecutions?: number;
     readonly timeoutMs?: number;
+    readonly retry?: RetryConfiguration;
+    readonly onError?: 'stop' | 'error';
 }
 export interface ValueNode extends GraphNodeBase {
     readonly kind: 'value';
@@ -251,6 +259,7 @@ export interface WebhookOptions {
     readonly responseStatusCode?: number;
 }
 interface TriggerNodeBase {
+    readonly onError?: never;
     readonly description?: string;
     readonly icon?: string;
     readonly name: string;
@@ -308,7 +317,7 @@ export interface CodeModule {
 }
 export interface RevisionContent {
     readonly document: FlowDocument;
-    readonly modelVersion: 2 | 4 | 5 | 6 | 7 | typeof currentFlowModelVersion;
+    readonly modelVersion: 2 | 4 | 5 | 6 | 7 | 8 | typeof currentFlowModelVersion;
     readonly modules: Readonly<Record<string, CodeModule>>;
 }
 export interface GraphEdge {
@@ -374,10 +383,16 @@ export type ChangeOperation = {
     readonly nodeId: string;
 } | {
     readonly before?: number | string;
-    readonly field: 'connectionId' | 'description' | 'icon' | 'maxExecutions' | 'name' | 'timeoutMs';
+    readonly field: 'connectionId' | 'description' | 'icon' | 'maxExecutions' | 'name' | 'timeoutMs' | 'onError';
     readonly kind: 'graph.node.field.set';
     readonly nodeId: string;
     readonly value?: number | string;
+} | {
+    readonly before?: RetryConfiguration;
+    readonly field: 'retry';
+    readonly kind: 'graph.node.field.set';
+    readonly nodeId: string;
+    readonly value?: RetryConfiguration;
 } | {
     readonly before?: InputMapping;
     readonly handle: string;

package/dist/browser/flow-change.js

@@ -8756,6 +8756,28 @@ 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 retryNodeTypes = [
+	"code",
+	"connector",
+	"openapi",
+	"llm",
+	"decision"
+];
+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)
+});
+function supportsNodeRetry(node) {
+	return node.kind == "task" && retryNodeTypes.some((type) => type == ("moduleId" in node.task ? "code" : node.task.executor.kind));
+}
+//#endregion
 //#region src/flow/common/triggerScheduleSchema.ts
 var triggerScheduleSchema = array(union([object({
 	type: literal("cron"),
@@ -8783,7 +8805,7 @@ var webhookMethods = [
 ];
 //#endregion
 //#region src/flow/common/changeSchema.ts
-var currentFlowModelVersion = 8;
+var currentFlowModelVersion = 9;
 var text = string();
 var actionConnection = text.describe("Account selection: omit while unconfigured; use an account ID to select it; use \"\" to explicitly defer configuration. Deferred Actions fail if called; deferred Agent tools are excluded from the callable tool set. Not supported by Triggers.");
 var json = json$1();
@@ -8804,6 +8826,7 @@ var source = union([object({
 	kind: literal("node"),
 	nodeId: text,
 	output: text,
+	system: literal(true).optional(),
 	field: text.optional()
 }), object({
 	kind: literal("binding"),
@@ -9062,7 +9085,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({
@@ -9183,7 +9208,8 @@ var revision = object({
 		literal(5),
 		literal(6),
 		literal(7),
-		literal(8)
+		literal(8),
+		literal(9)
 	]),
 	document,
 	modules: record$1(text, module)
@@ -9252,6 +9278,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"),
@@ -9265,7 +9298,8 @@ var shapes = {
 			field: _enum([
 				"description",
 				"icon",
-				"name"
+				"name",
+				"onError"
 			]),
 			before: text.optional(),
 			value: text.optional()
@@ -9394,6 +9428,12 @@ function changeOperationsSchema(kind) {
 	return toJSONSchema(schema, { io: "input" });
 }
 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.");
@@ -9456,6 +9496,37 @@ function setConditionInput(node, handle, mapping) {
 	};
 }
 //#endregion
+//#region src/flow/common/errorHandling.ts
+var nodeErrorSchema = {
+	type: "object",
+	additionalProperties: false,
+	required: [
+		"code",
+		"message",
+		"nodeId",
+		"nodeName",
+		"runId",
+		"executionId"
+	],
+	properties: {
+		code: { type: "string" },
+		message: { type: "string" },
+		nodeId: { type: "string" },
+		nodeName: { type: "string" },
+		runId: { type: "string" },
+		executionId: { type: "string" }
+	}
+};
+function supportsNodeErrorHandling(node) {
+	return supportsNodeRetry(node);
+}
+function nodeSystemOutputPorts(node) {
+	return supportsNodeErrorHandling(node) && node.onError == "error" ? { error: {
+		jsonSchema: nodeErrorSchema,
+		nullable: true
+	} } : {};
+}
+//#endregion
 //#region src/flow/common/change.ts
 var schemaKeywords = /* @__PURE__ */ new Set([
 	"const",
@@ -9627,10 +9698,10 @@ function upgradeRevisionContent(content) {
 function upgradeDecodedRevisionContent(content) {
 	const graph = content.document.graph;
 	const hasManual = Object.values(graph.nodes).some((node) => node.kind == "manual");
-	if (!hasManual && content.modelVersion == 8) return content;
+	if (!hasManual && content.modelVersion == 9) return content;
 	return {
 		...content,
-		modelVersion: 8,
+		modelVersion: 9,
 		document: {
 			...content.document,
 			graph: hasManual ? {
@@ -9677,7 +9748,7 @@ function invalid(message) {
 	throw new FlowChangeError(message);
 }
 function applyFlowChanges(content, operations) {
-	const source = content.modelVersion != 8 || Object.values(content.document.graph.nodes).some((node) => node.kind == "manual") ? decodeRevisionContent(content) : content;
+	const source = content.modelVersion != 9 || Object.values(content.document.graph.nodes).some((node) => node.kind == "manual") ? decodeRevisionContent(content) : content;
 	const document = { ...source.document };
 	const modules = { ...source.modules };
 	for (const operation of operations) switch (operation.kind) {
@@ -9849,6 +9920,8 @@ function applyFlowChanges(content, operations) {
 			const graph = document.graph;
 			const node = graph.nodes[operation.nodeId];
 			if (node == null) invalid("The Node does not exist in the target graph.");
+			if (operation.field == "onError" && operation.value != null && (!supportsNodeErrorHandling(node) || !["stop", "error"].includes(String(operation.value)))) invalid("This node does not support this error handling setting.");
+			if (operation.field == "retry" && operation.value != null && !supportsNodeRetry(node)) invalid("This node does not support retries.");
 			if (operation.field == "connectionId" && node.kind != "poll" && node.kind != "integration") invalid("Only provider Triggers select a node Connection.");
 			if (!dequal(Reflect.get(node, operation.field), operation.before)) invalid("The Node field changed before this operation was applied.");
 			const updated = { ...node };
@@ -10120,9 +10193,9 @@ function applyFlowChanges(content, operations) {
 	assertOpenApiAuthBindings(document);
 	return upgradeDecodedRevisionContent({
 		document,
-		modelVersion: 8,
+		modelVersion: 9,
 		modules
 	});
 }
 //#endregion
-export { FlowChangeError, applyFlowChanges, changeOperationsSchema, currentFlowModelVersion, decodeChangeOperations, decodeConnectorCapabilities, fixedInputValue, inputValue, inputValues, isSchemaKeyword, isTriggerNode, nextNodeName, nodeNameIssue, normalizeNodeName, portsByHandle, resourceNameIssue, resourceNameMaxLength, upgradeManualTrigger, upgradeRevisionContent, validVariableName };
+export { FlowChangeError, applyFlowChanges, changeOperationsSchema, currentFlowModelVersion, decodeChangeOperations, decodeConnectorCapabilities, fixedInputValue, inputValue, inputValues, isSchemaKeyword, isTriggerNode, nextNodeName, nodeErrorSchema, nodeNameIssue, nodeSystemOutputPorts, normalizeNodeName, portsByHandle, resourceNameIssue, resourceNameMaxLength, supportsNodeErrorHandling, supportsNodeRetry, upgradeManualTrigger, upgradeRevisionContent, validVariableName };