@oomol-lab/open-flow 0.1.0-beta.64 → 0.1.0-beta.66

package/dist/browser/{createResourceDialog-BAJXbzNH.js → createResourceDialog-C-Si_cYs.js}

@@ -1,6 +1,6 @@
 import { l as useTranslate } from "./dist-BFmpkX4P.js";
-import { C as FieldDescription, E as FieldLabel, S as Field, T as FieldGroup, a as DialogDescription, c as DialogTitle, i as DialogContent, lr as Input, n as Dialog, o as DialogFooter, r as DialogClose, s as DialogHeader, t as Icon, w as FieldError, x as Spinner, xi as Button } from "./icons-Db2Jb2iX.js";
-import { t as WorkbenchSelect } from "./workbenchSelect-C-jf6NIM.js";
+import { C as FieldDescription, E as FieldLabel, S as Field, T as FieldGroup, a as DialogDescription, c as DialogTitle, fr as Input, i as DialogContent, n as Dialog, o as DialogFooter, r as DialogClose, s as DialogHeader, t as Icon, w as FieldError, wi as Button, x as Spinner } from "./icons-BD3m0RQq.js";
+import { t as WorkbenchSelect } from "./workbenchSelect-B-PFpF_Q.js";
 import { useEffect, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 //#region src/workbench/browser/runtime/shell/createResourceDialog.tsx

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

@@ -1,5 +1,5 @@
 import type { DecisionQuestion } from '../common/decision.js';
-import type { ChangeOperation, CodeModule, ConnectorCapability, GraphNode, InputMapping, InputValues, InputPort, JsonValue, PortDefinition, RevisionContent, TaskDefinition, TriggerKeySnapshot, TriggerNode, TriggerSchedule, WebhookOptions } from './flow-change.js';
+import type { ChangeOperation, CodeModule, ConnectorCapability, Group, GraphNode, InputMapping, InputValues, InputPort, JsonValue, Port, PortDefinition, RevisionContent, TaskDefinition, TriggerKeySnapshot, TriggerNode, TriggerSchedule, WebhookOptions } from './flow-change.js';
 export declare const defaultCodeTaskPorts: Pick<Extract<TaskDefinition, {
     readonly moduleId: string;
 }>, 'inputs' | 'outputs' | 'capabilities'>;
@@ -14,13 +14,17 @@ export interface LlmTaskOptions {
 }
 export type LlmInputHandle = 'input' | 'messages' | 'model' | 'template';
 export declare function defaultNodeName(_content: RevisionContent, node: GraphNode): string;
-export declare function repairNodeNames(content: RevisionContent): readonly ChangeOperation[];
+export declare function repairNodeNames(content: RevisionContent, defaults?: {
+    readonly start?: string;
+}): readonly ChangeOperation[];
 interface TriggerSettingsBase {
     readonly description?: string;
     readonly name: string;
 }
 export type TriggerSettings = (TriggerSettingsBase & {
     readonly kind: 'manual';
+}) | (TriggerSettingsBase & {
+    readonly kind: 'start';
 }) | (TriggerSettingsBase & {
     readonly kind: 'error';
 }) | (TriggerSettingsBase & {
@@ -69,7 +73,7 @@ export declare function createValue(nodeId: string, name: string, values?: reado
 export declare function createWait(nodeId: string, name: string): readonly ChangeOperation[];
 export declare function createApproval(nodeId: string, name: string): readonly ChangeOperation[];
 export declare function createBuiltinTrigger(nodeId: string, node: Extract<TriggerNode, {
-    readonly kind: 'error' | 'cron' | 'manual' | 'webhook';
+    readonly kind: 'error' | 'cron' | 'manual' | 'start' | 'webhook';
 }>): readonly ChangeOperation[];
 export declare function createProviderTrigger(nodeId: string, definition: TriggerKeySnapshot, options: {
     readonly config: Readonly<Record<string, JsonValue>>;
@@ -89,6 +93,8 @@ export declare function setInputSources(content: RevisionContent, nodeId: string
 export declare function setInputVariable(content: RevisionContent, nodeId: string, handle: string, name: string, bindingId: string): readonly ChangeOperation[] | undefined;
 export declare function cleanVariableBindings(content: RevisionContent, operations: readonly ChangeOperation[]): readonly ChangeOperation[];
 export declare function setConnectorConnection(content: RevisionContent, nodeId: string, connectionId: string | undefined): readonly ChangeOperation[] | undefined;
+/** Edit the workflow input contract and preserve references on a single-field rename. */
+export declare function updateStartInputDefs(content: RevisionContent, nodeId: string, value: readonly Port[]): readonly ChangeOperation[];
 export declare function updateTrigger(content: RevisionContent, nodeId: string, settings: TriggerSettings): readonly ChangeOperation[] | undefined;
 export declare function updateTriggerConfig(content: RevisionContent, nodeId: string, name: string, value: JsonValue | undefined): readonly ChangeOperation[] | undefined;
 export declare function updateTriggerSchedule(content: RevisionContent, nodeId: string, schedule: readonly TriggerSchedule[]): readonly ChangeOperation[] | undefined;
@@ -97,4 +103,7 @@ export declare function setCodeActions(content: RevisionContent, nodeId: string,
 export declare function createDecisionTask(identity: {
     readonly nodeId: string;
 }, name?: string, questions?: readonly DecisionQuestion[]): readonly ChangeOperation[];
+/** Edit an Outputs node's definitions and mappings as one undoable change. */
+export declare function updateOutputsDefs(content: RevisionContent, nodeId: string, value: readonly Port[], outputMappings?: Readonly<Record<string, InputMapping>>): readonly ChangeOperation[];
+export declare function renameFlowOutputSources(content: RevisionContent, nodeIds: ReadonlySet<string>, previous: readonly (Port | Group)[], next: readonly (Port | Group)[]): readonly ChangeOperation[];
 export {};

package/dist/browser/flow-authoring.js

@@ -59,11 +59,30 @@ function dequal(foo, bar) {
 //#endregion
 //#region src/flow/common/edgeChanges.ts
 function connect(content, edge) {
-	if (content.document.graph?.edges.some((candidate) => dequal(candidate, edge))) return [];
-	return [{
+	const selected = content.document.graph;
+	if (selected?.edges.some((candidate) => dequal(candidate, edge))) return [];
+	const changes = [{
 		edge,
 		kind: "graph.edge.connect"
 	}];
+	const source = selected.nodes[edge.source];
+	const target = selected.nodes[edge.target];
+	if (edge.sourceHandle == "pending" && (source?.kind == "approval" || source?.kind == "wait") && target?.kind == "task" && "executor" in target.task && target.task.executor.kind == "connector" && target.task.executor.action == "leina.send_notification" && (target.inputs.message == null || target.inputs.message.kind == "unset")) changes.push({
+		kind: "graph.node.input.set",
+		nodeId: edge.target,
+		handle: "message",
+		before: target.inputs.message,
+		value: {
+			kind: "sources",
+			sources: [{
+				kind: "node",
+				nodeId: edge.source,
+				output: "pending",
+				field: "message"
+			}]
+		}
+	});
+	return changes;
 }
 function disconnect(content, edge) {
 	if (!content.document.graph?.edges.some((candidate) => dequal(candidate, edge))) return [];
@@ -5803,6 +5822,10 @@ function preprocess(fn, schema) {
 		out: schema
 	});
 }
+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);
+}
 //#endregion
 //#region src/flow/common/triggerScheduleSchema.ts
 var triggerScheduleSchema = array(union([object({
@@ -5838,6 +5861,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(),
@@ -5995,6 +6019,11 @@ var managedFields = object({
 				messageHandle: text,
 				inputs: record$1(text, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text,
+			revisionId: text
 		})
 	])
 });
@@ -6103,6 +6132,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()),
@@ -6135,6 +6170,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger,
 		kind: literal("error"),
@@ -6199,35 +6239,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,
@@ -6380,6 +6436,12 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
+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");
@@ -6399,6 +6461,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",
@@ -6550,6 +6613,40 @@ function decodeConnectorCapabilities(value) {
 		};
 	});
 }
+function isTriggerNode(node) {
+	return [
+		"manual",
+		"start",
+		"error",
+		"webhook",
+		"cron",
+		"poll",
+		"integration"
+	].includes(node.kind);
+}
+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");
 }
@@ -6568,8 +6665,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;
@@ -6620,8 +6718,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,
@@ -6701,9 +6800,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.");
@@ -6761,11 +6861,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: {
@@ -6993,11 +7106,11 @@ function applyFlowChanges(content, operations) {
 		}
 	}
 	assertOpenApiAuthBindings(document);
-	return {
+	return upgradeDecodedRevisionContent({
 		document,
-		modelVersion: 6,
+		modelVersion: 8,
 		modules
-	};
+	});
 }
 //#endregion
 //#region src/json-schema-subset/utils.ts
@@ -10117,7 +10230,7 @@ function deleteNodes(content, nodeIds) {
 }
 function updateSettings(content, nodeId, settings) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return;
+	if (node == null || isTriggerNode(node)) return;
 	const operations = [];
 	if (node.name != settings.name) operations.push({
 		before: node.name,
@@ -10144,7 +10257,7 @@ function updateSettings(content, nodeId, settings) {
 }
 function setInputValues(content, nodeId, values) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return;
+	if (node == null || isTriggerNode(node)) return;
 	const operations = [];
 	for (const [handle, value] of Object.entries(values)) {
 		const before = nodeInputMappings(node)[handle];
@@ -10162,7 +10275,7 @@ function setInputValues(content, nodeId, values) {
 }
 function setInputSources(content, nodeId, handle, sources) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return [];
+	if (node == null || isTriggerNode(node)) return [];
 	return cleanVariableBindings(content, [{
 		kind: "graph.node.input.set",
 		nodeId,
@@ -10176,7 +10289,7 @@ function setInputSources(content, nodeId, handle, sources) {
 }
 function setInputVariable(content, nodeId, handle, name, bindingId) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return;
+	if (node == null || isTriggerNode(node)) return;
 	const mapping = nodeInputMappings(node)[handle];
 	const currentId = mapping?.kind == "sources" && mapping.sources.length == 1 && mapping.sources[0]?.kind == "binding" ? mapping.sources[0].bindingId : void 0;
 	const current = currentId == null ? void 0 : content.document.bindings[currentId];
@@ -10226,7 +10339,7 @@ function bindingReferences(document) {
 		references.set(bindingId, (references.get(bindingId) ?? 0) + 1);
 	};
 	for (const node of Object.values(document.graph.nodes)) {
-		if (!("inputs" in node)) continue;
+		if (isTriggerNode(node)) continue;
 		const inputs = Object.values(nodeInputMappings(node));
 		for (const mapping of inputs) {
 			if (mapping.kind != "sources") continue;
@@ -10274,6 +10387,7 @@ function updateTrigger(content, nodeId, settings) {
 		value: settings.description
 	});
 	switch (settings.kind) {
+		case "start":
 		case "error":
 		case "manual":
 			if (trigger.kind != settings.kind) return;

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 = 6;
+export declare const currentFlowModelVersion = 8;
 /** Configuration schemas shared by the node authoring boundary. */
 export declare const authoringDefinitionSchemas: {
     input: z.ZodObject<{
@@ -267,6 +267,8 @@ export declare const authoringDefinitionSchemas: {
         }, z.core.$strip>>;
     }, z.core.$strict>;
 };
+/** Explicit storage upgrade only. Normal reads and authoring still reject retired fields. */
+export declare function upgradeWorkflowInterfaceDocument(value: unknown): unknown;
 /** Best-effort recovery for a parseable Revision envelope. Invalid collection entries are discarded. */
 export declare function repairRevisionEnvelope(value: unknown): RevisionContent;
 export declare function decodeFlowDocument(value: unknown): FlowDocument;

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

@@ -108,7 +108,7 @@ export interface ConditionNode extends GraphNodeBase {
     readonly matchMode: 'first' | 'all';
     readonly kind: 'condition';
 }
-export type ManagedTaskExecutor = import('../common/decision.js').DecisionExecutor | import('../common/openapi.js').OpenApiExecutor | {
+export type ManagedTaskExecutor = import('../common/workflow.js').WorkflowExecutor | import('../common/decision.js').DecisionExecutor | import('../common/openapi.js').OpenApiExecutor | {
     readonly kind: 'connector';
     readonly action: string;
     readonly connectionId?: string;
@@ -257,6 +257,9 @@ interface TriggerNodeBase {
 }
 export type TriggerNode = (TriggerNodeBase & {
     readonly kind: 'manual';
+}) | (TriggerNodeBase & {
+    readonly kind: 'start';
+    readonly inputDefs: readonly Port[];
 }) | (TriggerNodeBase & {
     readonly kind: 'error';
     readonly sourceFlowIds?: readonly string[];
@@ -284,7 +287,13 @@ export type TriggerNode = (TriggerNodeBase & {
     };
     readonly kind: 'integration';
 });
-export type GraphNode = ApprovalNode | ConditionNode | TaskNode | TriggerNode | ValueNode | WaitNode;
+export interface OutputsNode extends Omit<GraphNodeBase, 'inputs'> {
+    readonly kind: 'outputs';
+    readonly outputDefs: readonly Port[];
+    readonly outputMappings: Readonly<Record<string, InputMapping>>;
+}
+export declare function isTriggerNode(node: GraphNode): node is TriggerNode;
+export type GraphNode = OutputsNode | ApprovalNode | ConditionNode | TaskNode | TriggerNode | ValueNode | WaitNode;
 export interface FlowDocument {
     readonly bindings: Readonly<Record<string, {
         readonly kind: 'variable';
@@ -299,7 +308,7 @@ export interface CodeModule {
 }
 export interface RevisionContent {
     readonly document: FlowDocument;
-    readonly modelVersion: 2 | 4 | 5 | typeof currentFlowModelVersion;
+    readonly modelVersion: 2 | 4 | 5 | 6 | 7 | typeof currentFlowModelVersion;
     readonly modules: Readonly<Record<string, CodeModule>>;
 }
 export interface GraphEdge {
@@ -307,6 +316,9 @@ export interface GraphEdge {
     readonly sourceHandle?: string;
     readonly target: string;
 }
+/** Lossless upgrade of readable content. Historical content and its encoding stay unchanged. */
+export declare function upgradeRevisionContent(content: RevisionContent): RevisionContent;
+export declare function upgradeManualTrigger(node: GraphNode): GraphNode;
 export declare function normalizeNodeName(value: string): string;
 export declare function nextNodeName(value: string, names: Iterable<string>): string;
 export declare function nodeNameIssue(graph: Graph, nodeId: string, value: string): 'duplicate' | 'empty' | undefined;