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

package/dist/browser/flow-change.js

@@ -8783,8 +8783,9 @@ var webhookMethods = [
 ];
 //#endregion
 //#region src/flow/common/changeSchema.ts
-var currentFlowModelVersion = 6;
+var currentFlowModelVersion = 8;
 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();
 var strings = array(text);
 var port = object({
@@ -8793,6 +8794,7 @@ var port = object({
 	nullable: boolean(),
 	handle: text
 });
+var workflowInputDefs = array(port.strict());
 var input = port.extend({ value: json.optional() });
 var group = object({
 	collapsed: boolean().optional(),
@@ -8839,7 +8841,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -8899,7 +8901,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -8939,17 +8941,22 @@ var managedFields = object({
 				name: text,
 				description: text,
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				approval: boolean(),
 				inputs: array(input.extend({ source: agentInput }))
 			})),
 			notification: object({
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text,
 				inputs: record$1(text, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text,
+			revisionId: text
 		})
 	])
 });
@@ -9058,6 +9065,12 @@ var base = {
 	timeoutMs: number().optional()
 };
 var node = union([
+	strictObject({
+		...base,
+		kind: literal("outputs"),
+		outputDefs: array(port.strict()),
+		outputMappings: inputs
+	}).omit({ inputs: true }),
 	object({
 		...base,
 		inputs: record$1(text, never()),
@@ -9090,6 +9103,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger,
 		kind: literal("error"),
@@ -9154,35 +9172,51 @@ var module = object({
 	imports: strings,
 	source: text
 });
-var document = preprocess(rejectRetiredDefinitions, object({
+var document = preprocess(normalizeDocument, object({
 	bindings: record$1(text, binding),
 	graph
 }));
-object({
+var revision = object({
 	modelVersion: union([
 		literal(2),
 		literal(4),
 		literal(5),
-		literal(6)
+		literal(6),
+		literal(7),
+		literal(8)
 	]),
 	document,
 	modules: record$1(text, module)
-}).extend({
+});
+revision.extend({
 	kind: literal("open-flow-flow-revision"),
 	version: literal(1)
 });
-function rejectRetiredDefinitions(value) {
+function normalizeDocument(value) {
 	const candidate = record(value);
 	if (candidate.tasks !== void 0 && (candidate.tasks === null || typeof candidate.tasks !== "object" || Array.isArray(candidate.tasks) || Object.keys(candidate.tasks).length > 0)) throw new TypeError("Independent Task definitions are no longer supported.");
 	if (Object.values(record(record(candidate.graph).nodes)).some((candidateNode) => Object.hasOwn(record(candidateNode), "taskId"))) throw new TypeError("Task references are no longer supported.");
 	const subflows = candidate.subflows;
 	if (subflows !== void 0 && (subflows === null || typeof subflows !== "object" || Array.isArray(subflows) || Object.keys(subflows).length > 0)) throw new TypeError("Subflows are no longer supported.");
 	if (Object.values(record(record(candidate.graph).nodes)).some((candidateNode) => record(candidateNode).kind === "subflow")) throw new TypeError("Subflow nodes are no longer supported.");
+	if ([
+		"inputDefs",
+		"outputDefs",
+		"outputMappings"
+	].some((field) => Object.hasOwn(candidate, field))) throw new TypeError("Workflow interface configuration must belong to Start and Outputs nodes.");
+	if (Object.values(record(record(candidate.graph).nodes)).some((candidateNode) => record(candidateNode).kind == "start" && Object.hasOwn(record(candidateNode), "parameters"))) throw new TypeError("Legacy Start.parameters is unsupported; configure node.inputDefs.");
 	return value;
 }
 function record(value) {
 	return value != null && typeof value == "object" && !Array.isArray(value) ? value : {};
 }
+function decodeRevisionContent(value) {
+	checkJsonDepth(value);
+	const content = revision.parse(value);
+	checkModelVersion(content);
+	assertOpenApiAuthBindings(content.document);
+	return content;
+}
 var shapes = {
 	"graph.trigger.sources.set": {
 		nodeId: text,
@@ -9359,6 +9393,12 @@ function changeOperationsSchema(kind) {
 	if (schema == null) throw new TypeError(`Unknown operation ${JSON.stringify(kind)}.`);
 	return toJSONSchema(schema, { io: "input" });
 }
+function checkModelVersion(content) {
+	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.");
+	if (content.modelVersion < 5 && Object.values(content.document.graph.nodes).some((itemNode) => itemNode.kind == "error")) throw new TypeError("Error workflows require Flow model version 5.");
+}
 //#endregion
 //#region src/flow/common/condition.ts
 var unaryOperator = (operator) => operator.startsWith("is");
@@ -9378,6 +9418,7 @@ function conditionOperands(node) {
 	}] : []])));
 }
 function nodeInputMappings(node) {
+	if (node.kind == "outputs") return node.outputMappings;
 	if (node.kind != "condition") return "inputs" in node ? node.inputs : {};
 	return Object.fromEntries(conditionOperands(node).flatMap(({ handle, operand }) => operand.kind == "source" ? [[handle, {
 		kind: "sources",
@@ -9475,7 +9516,7 @@ function decodeConnectorCapabilities(value) {
 		const actions = source.actions.map((entry) => {
 			if (entry == null || typeof entry != "object" || Array.isArray(entry)) throw new TypeError("Invalid Connector Action.");
 			const action = entry;
-			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && (typeof action.connectionId != "string" || action.connectionId.length == 0)) throw new TypeError("Invalid Connector Action permission.");
+			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && typeof action.connectionId != "string") throw new TypeError("Invalid Connector Action permission.");
 			return action.connectionId == null ? { action: action.action } : {
 				action: action.action,
 				connectionId: action.connectionId
@@ -9567,6 +9608,45 @@ function decodeConnectorCapabilities(value) {
 		};
 	});
 }
+function isTriggerNode(node) {
+	return [
+		"manual",
+		"start",
+		"error",
+		"webhook",
+		"cron",
+		"poll",
+		"integration"
+	].includes(node.kind);
+}
+/** Lossless upgrade of readable content. Historical content and its encoding stay unchanged. */
+function upgradeRevisionContent(content) {
+	const upgraded = upgradeDecodedRevisionContent(decodeRevisionContent(content));
+	return dequal(content, upgraded) ? content : upgraded;
+}
+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;
+	return {
+		...content,
+		modelVersion: 8,
+		document: {
+			...content.document,
+			graph: hasManual ? {
+				...graph,
+				nodes: Object.fromEntries(Object.entries(graph.nodes).map(([id, node]) => [id, upgradeManualTrigger(node)]))
+			} : graph
+		}
+	};
+}
+function upgradeManualTrigger(node) {
+	return node.kind == "manual" ? {
+		...node,
+		kind: "start",
+		inputDefs: []
+	} : node;
+}
 function normalizeNodeName(value) {
 	return value.trim().normalize("NFC");
 }
@@ -9597,8 +9677,9 @@ function invalid(message) {
 	throw new FlowChangeError(message);
 }
 function applyFlowChanges(content, operations) {
-	const document = { ...content.document };
-	const modules = { ...content.modules };
+	const source = content.modelVersion != 8 || 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) {
 		case "graph.trigger.sources.set": {
 			const graph = document.graph;
@@ -9649,8 +9730,9 @@ function applyFlowChanges(content, operations) {
 		case "graph.edge.connect": {
 			const graph = document.graph;
 			if (graph.nodes[operation.edge.source] == null) invalid("The source Node does not exist.");
+			if (graph.nodes[operation.edge.source]?.kind == "outputs") invalid("Outputs cannot have downstream execution edges.");
 			const node = graph.nodes[operation.edge.target];
-			if (node == null || !("inputs" in node)) invalid("The target Node does not accept execution dependencies.");
+			if (node == null || isTriggerNode(node)) invalid("The target Node does not accept execution dependencies.");
 			if (graph.edges.some((edge) => dequal(edge, operation.edge))) invalid("The Nodes are already connected.");
 			Object.assign(document, { graph: {
 				...graph,
@@ -9730,9 +9812,10 @@ function applyFlowChanges(content, operations) {
 			const graph = document.graph;
 			if (graph.nodes[operation.nodeId] != null) invalid("A Node with this ID already exists in the target graph.");
 			if (operation.node.kind == "error" && Object.values(graph.nodes).some((node) => node.kind == "error")) invalid("A graph can contain only one Flow Error node.");
-			if (operation.node.kind == "manual" && Object.values(graph.nodes).some((node) => node.kind == "manual")) invalid("A graph can contain only one manual Trigger.");
+			if ((operation.node.kind == "manual" || operation.node.kind == "start") && Object.values(graph.nodes).some((node) => node.kind == "manual" || node.kind == "start")) invalid("A graph can contain only one Start Trigger.");
 			if (operation.node.kind == "task" && "moduleId" in operation.node.task && operation.node.task.capabilities !== void 0) decodeConnectorCapabilities(operation.node.task.capabilities);
 			if (operation.node.name == null) invalid("A Node name cannot be empty.");
+			if (operation.node.kind == "outputs" && Object.values(graph.nodes).some((node) => node.kind == "outputs")) invalid("A graph can contain only one Outputs node.");
 			const name = normalizeNodeName(operation.node.name);
 			const issue = nodeNameIssue(graph, operation.nodeId, name);
 			if (issue == "empty") invalid("A Node name cannot be empty.");
@@ -9790,11 +9873,24 @@ function applyFlowChanges(content, operations) {
 		case "graph.node.input.set": {
 			const graph = document.graph;
 			const node = graph.nodes[operation.nodeId];
-			if (node == null || !("inputs" in node)) invalid("The Node does not accept inputs.");
+			if (node == null || isTriggerNode(node)) invalid("The Node does not accept inputs.");
 			if (!dequal(nodeInputMappings(node)[operation.handle], operation.before)) invalid("The Node input changed before this operation was applied.");
-			const inputs = { ...node.inputs };
+			const inputs = { ...nodeInputMappings(node) };
 			if (operation.value == null) delete inputs[operation.handle];
 			else inputs[operation.handle] = operation.value;
+			if (node.kind == "outputs") {
+				document.graph = {
+					...graph,
+					nodes: {
+						...graph.nodes,
+						[operation.nodeId]: {
+							...node,
+							outputMappings: inputs
+						}
+					}
+				};
+				break;
+			}
 			Object.assign(document, { graph: {
 				...graph,
 				nodes: {
@@ -10022,11 +10118,11 @@ function applyFlowChanges(content, operations) {
 		}
 	}
 	assertOpenApiAuthBindings(document);
-	return {
+	return upgradeDecodedRevisionContent({
 		document,
-		modelVersion: 6,
+		modelVersion: 8,
 		modules
-	};
+	});
 }
 //#endregion
-export { FlowChangeError, applyFlowChanges, changeOperationsSchema, currentFlowModelVersion, decodeChangeOperations, decodeConnectorCapabilities, fixedInputValue, inputValue, inputValues, isSchemaKeyword, nextNodeName, nodeNameIssue, normalizeNodeName, portsByHandle, resourceNameIssue, resourceNameMaxLength, validVariableName };
+export { FlowChangeError, applyFlowChanges, changeOperationsSchema, currentFlowModelVersion, decodeChangeOperations, decodeConnectorCapabilities, fixedInputValue, inputValue, inputValues, isSchemaKeyword, isTriggerNode, nextNodeName, nodeNameIssue, normalizeNodeName, portsByHandle, resourceNameIssue, resourceNameMaxLength, upgradeManualTrigger, upgradeRevisionContent, validVariableName };