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

package/dist/common/control-requests.js

@@ -6810,6 +6810,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",
@@ -6978,6 +6979,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");
 }
@@ -6996,8 +7036,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;
@@ -7048,8 +7089,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,
@@ -7129,9 +7171,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.");
@@ -7189,11 +7232,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: {
@@ -7421,11 +7477,11 @@ function applyFlowChanges(content, operations) {
 		}
 	}
 	assertOpenApiAuthBindings(document);
-	return {
+	return upgradeDecodedRevisionContent({
 		document,
-		modelVersion: 6,
+		modelVersion: 8,
 		modules
-	};
+	});
 }
 //#endregion
 //#region src/json-schema-subset/utils.ts
@@ -10375,6 +10431,7 @@ var port = object$1({
 	nullable: boolean(),
 	handle: text$1
 });
+var workflowInputDefs = array(port.strict());
 var input = port.extend({ value: json$4.optional() });
 var group = object$1({
 	collapsed: boolean().optional(),
@@ -10532,6 +10589,11 @@ var managedFields = object$1({
 				messageHandle: text$1,
 				inputs: record$3(text$1, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text$1,
+			revisionId: text$1
 		})
 	])
 });
@@ -10640,6 +10702,12 @@ var base = {
 	timeoutMs: number().optional()
 };
 var node = union([
+	strictObject({
+		...base,
+		kind: literal("outputs"),
+		outputDefs: array(port.strict()),
+		outputMappings: inputs$1
+	}).omit({ inputs: true }),
 	object$1({
 		...base,
 		inputs: record$3(text$1, never()),
@@ -10672,6 +10740,11 @@ var node = union([
 		...trigger$1,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger$1,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger$1,
 		kind: literal("error"),
@@ -10751,35 +10824,51 @@ var module = object$1({
 	imports: strings,
 	source: text$1
 });
-var document = preprocess(rejectRetiredDefinitions, object$1({
+var document = preprocess(normalizeDocument, object$1({
 	bindings: record$3(text$1, binding),
 	graph
 }));
-object$1({
+var revision = object$1({
 	modelVersion: union([
 		literal(2),
 		literal(4),
 		literal(5),
-		literal(6)
+		literal(6),
+		literal(7),
+		literal(8)
 	]),
 	document,
 	modules: record$3(text$1, module)
-}).extend({
+});
+revision.extend({
 	kind: literal("open-flow-flow-revision"),
 	version: literal(1)
 });
-function rejectRetiredDefinitions(value) {
+function normalizeDocument(value) {
 	const candidate = record$2(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$2(record$2(candidate.graph).nodes)).some((candidateNode) => Object.hasOwn(record$2(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$2(record$2(candidate.graph).nodes)).some((candidateNode) => record$2(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$2(record$2(candidate.graph).nodes)).some((candidateNode) => record$2(candidateNode).kind == "start" && Object.hasOwn(record$2(candidateNode), "parameters"))) throw new TypeError("Legacy Start.parameters is unsupported; configure node.inputDefs.");
 	return value;
 }
 function record$2(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$1,
@@ -10956,6 +11045,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/control/common/authoringLlm.ts
 var authoringLlmConfiguration = strictObject({
@@ -11527,7 +11622,9 @@ var id$2 = string().min(1);
 var json$3 = json$5();
 var patch = record$3(id$2, json$3);
 var authoringTypes = [
-	"manual",
+	"start",
+	"outputs",
+	"workflow",
 	"webhook",
 	"cron",
 	"error",
@@ -11600,6 +11697,12 @@ var field = strictObject({
 	description: string().optional()
 });
 var inputFields = record$3(id$2, field.extend({ default: json$3.optional() })).describe("Optional business input constraints by name. A binding to a new Code, Agent, LLM, Wait or Approval input automatically declares an input accepting any JSON. Existing constraints are preserved. Omitted schema accepts any JSON; omitted nullable is true. Use default for inherited values; input.set supplies data.");
+var flowInputFields = record$3(id$2, field).describe("Workflow input definitions by name. Omitted schema accepts any JSON; omitted nullable is true. No defaults. Supply call values as trigger.outputs.");
+var flowOutputFields = flowInputFields.describe("Workflow output definitions by name. Omitted schema accepts any JSON; omitted nullable is true. No defaults. Set values on the Outputs node with input.set or node.add.inputs.");
+var flowInputFieldsView = record$3(id$2, field.extend({
+	schema: json$3,
+	nullable: boolean()
+}));
 var outputFields = record$3(id$2, field).describe("Code return fields by name. Omitted schema accepts any JSON; omitted nullable is true.");
 var expression = strictObject({
 	left: operand,
@@ -11613,7 +11716,9 @@ var when = union([
 	strictObject({ any: array(union([expression, all])) })
 ]);
 var authoringConfigurations = {
-	manual: strictObject({}),
+	workflow: strictObject({ flowId: id$2 }),
+	start: strictObject({ inputDefs: flowInputFields.default({}) }),
+	outputs: strictObject({ outputDefs: flowOutputFields.default({}) }),
 	error: strictObject({ sourceFlowIds: array(id$2).optional() }),
 	webhook: authoringDefinitionSchemas.webhook.omit({ bodyFields: true }).extend({ body: inputFields }).strict(),
 	cron: strictObject({ schedule: authoringDefinitionSchemas.schedule }),
@@ -11684,6 +11789,10 @@ var authoringEditSchema = discriminatedUnion("op", [
 		set: updates.optional(),
 		clear: array(array(id$2).min(1)).optional()
 	}),
+	strictObject({
+		op: literal("node.refresh"),
+		node: referenceSchema
+	}),
 	strictObject({
 		op: literal("node.remove"),
 		node: referenceSchema
@@ -11747,7 +11856,7 @@ var authoringSchemaQuery = strictObject({
 var requestContracts = {
 	read: {
 		schema: authoringReadSchema,
-		guidance: "Choose one mode: outline (omit nodes and text), node details (nodes), or text excerpt (text). nodes and text are mutually exclusive. Text defaults to 80 lines, at most 200 lines and 24000 characters. For the complete text, repeat at nextStart with the same revision until truncated is false.",
+		guidance: "Read Start and Outputs node details for their interface definitions and data sources. Choose one mode: outline (omit nodes and text), node details (nodes), or text excerpt (text). nodes and text are mutually exclusive. Text defaults to 80 lines, at most 200 lines and 24000 characters. For the complete text, repeat at nextStart with the same revision until truncated is false.",
 		examples: [
 			{},
 			{
@@ -11775,7 +11884,7 @@ var requestContracts = {
 	},
 	edit: {
 		schema: authoringRequestSchema,
-		guidance: "Use the observed revision as baseRevision and a stable requestId. Edits are ordered and atomic. node.add.as declares a batch-local alias without $. Every later reference to that new node must use $alias, including node, edge source/target and output source node fields; a bare alias is not the node ID. Use returned node references in later batches. Updates recursively merge objects (including schemas); {} preserves existing fields. Arrays replace as a whole. Remove fields with clear paths. Text replacement requires exactly one match. Read the target text first. A saved draft can have validation diagnostics.",
+		guidance: "Edit Start config.inputDefs and Outputs config.outputDefs through node.add or node.update; clear paths are relative to the node, e.g. [\"config\",\"inputDefs\",\"amount\"]. Set Outputs values with input.set. Use the observed revision as baseRevision and a stable requestId. Edits are ordered and atomic. node.add.as declares a batch-local alias without $. Every later reference to that new node must use $alias, including node, edge source/target and output source node fields; a bare alias is not the node ID. Use returned node references in later batches. Updates recursively merge objects (including schemas); {} preserves existing fields. Arrays replace as a whole. Remove fields with clear paths. Text replacement requires exactly one match. Read the target text first. A saved draft can have validation diagnostics.",
 		examples: [{
 			baseRevision: "REVISION",
 			requestId: "CREATE_REQUEST",
@@ -11783,7 +11892,7 @@ var requestContracts = {
 				{
 					op: "node.add",
 					as: "start",
-					type: "manual",
+					type: "start",
 					name: "Start"
 				},
 				{
@@ -11844,7 +11953,8 @@ function authoringSchema(kind) {
 			"unset",
 			"default"
 		] : [
-			"manual",
+			"start",
+			"outputs",
 			"error",
 			"cron",
 			"webhook",
@@ -11865,13 +11975,16 @@ function authoringSchema(kind) {
 			"wait",
 			"approval"
 		].includes(kind),
-		guidance: kind == "condition" ? "Edit branch operands through config.branches. A branch can test one expression, all expressions, or any alternatives. Unmatched execution uses branch otherwise." : ["poll", "integration"].includes(kind) ? "Configure static parameters with node.add.inputs or input.set. Definitions come from the selected Trigger key; execution output and variable sources are unavailable." : kind == "llm" ? "Configure model settings, message templates and history as defaults. Input bindings with the same names override these defaults; named business inputs can be bound directly. Template strings interpolate {{name}}." : kind == "openapi" ? "Select an operation; the tool resolves its ports and authentication. Read authenticationChoices from node details. authentication is replaced as a complete choice. Bind advertised credentials through inputs." : "Supply business configuration and input data. Fixed definitions are assembled by the tool. Existing constraints and defaults are preserved on partial updates.",
+		guidance: kind == "outputs" ? "Declare output fields through config.outputDefs. Set their values through node.add.inputs or input.set. Outputs is a singleton execution sink; it waits for its predecessors and produces workflow business outputs independently of node logs. No downstream edges or data references to Outputs are allowed." : kind == "start" ? "Declare workflow inputs through config.inputDefs; read them in Start node details. REST calls and manual runs supply them as trigger.outputs. Downstream nodes bind these parameters as Start outputs. Start has no input sources or defaults; non-nullable parameters are required, and omitted nullable parameters become null." : kind == "condition" ? "Edit branch operands through config.branches. A branch can test one expression, all expressions, or any alternatives. Unmatched execution uses branch otherwise." : ["poll", "integration"].includes(kind) ? "Configure static parameters with node.add.inputs or input.set. Definitions come from the selected Trigger key; execution output and variable sources are unavailable." : kind == "llm" ? "Configure model settings, message templates and history as defaults. Input bindings with the same names override these defaults; named business inputs can be bound directly. Template strings interpolate {{name}}." : kind == "openapi" ? "Select an operation; the tool resolves its ports and authentication. Read authenticationChoices from node details. authentication is replaced as a complete choice. Bind advertised credentials through inputs." : kind == "workflow" ? "Select another workflow with config.flowId. A workflow cannot call itself, including in a disconnected node. Owned unpublished or unavailable targets may be saved as incomplete drafts. Use node.refresh to load the current published interface." : "Supply business configuration and input data. Fixed definitions are assembled by the tool. Existing constraints and defaults are preserved on partial updates.",
 		example: {
 			op: "node.add",
 			as: "step",
 			type: kind,
 			name: "Step",
 			...{
+				start: { config: { inputDefs: {} } },
+				outputs: { config: { outputDefs: {} } },
+				workflow: { config: { flowId: "<Flow ID>" } },
 				connector: { config: {
 					action: "<Action ID>",
 					connectionId: "<Connection ID>"
@@ -12026,7 +12139,7 @@ var authoringSearchResponse = object$1({
 	revision: id$2,
 	data: object$1({
 		matches: array(object$1({
-			node: id$2,
+			node: id$2.optional(),
 			field: id$2,
 			line: int().optional(),
 			excerpt: string()
@@ -12044,6 +12157,41 @@ function connectorOutputMode(schema) {
 	return properties != null && Object.keys(properties).length > 0 || root?.type == "object" && root.additionalProperties === false ? "fields" : "value";
 }
 //#endregion
+//#region src/flow/common/edgeChanges.ts
+function connect(content, edge) {
+	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 [];
+	return [{
+		edge,
+		kind: "graph.edge.disconnect"
+	}];
+}
+//#endregion
 //#region src/trigger/common/contract.ts
 var errorOutputs = [
 	{
@@ -12152,6 +12300,7 @@ function triggerOutputDefinitions(trigger) {
 	switch (trigger.kind) {
 		case "error": return errorOutputs;
 		case "manual": return [];
+		case "start": return trigger.inputDefs;
 		case "cron": return cronOutputs;
 		case "poll":
 		case "integration": return trigger.definition.outputs;
@@ -12170,6 +12319,7 @@ function triggerOutputPorts(trigger) {
 //#region src/flow/common/graph.ts
 function nodeInputPorts(node) {
 	switch (node.kind) {
+		case "outputs": return portsByHandle(node.outputDefs);
 		case "condition": return conditionInputPorts(node);
 		case "value": return {};
 		case "task": return portsByHandle([...node.task.inputs, ...node.additionalInputs ?? []]);
@@ -12180,6 +12330,7 @@ function nodeInputPorts(node) {
 		case "poll":
 		case "error":
 		case "manual":
+		case "start":
 		case "webhook": return {};
 	}
 }
@@ -12207,6 +12358,12 @@ function resolutionOutputPorts(node) {
 		pending: objectPort({
 			inputs,
 			prompt: { type: "string" },
+			pageUrl: { type: "string" },
+			message: {
+				type: "string",
+				minLength: 1,
+				pattern: "\\S"
+			},
 			...Object.fromEntries(actions.map((action) => [`${action}Url`, { type: "string" }])),
 			expiresAt: { type: "string" }
 		}),
@@ -12220,6 +12377,7 @@ function resolutionOutputPorts(node) {
 }
 function nodeOutputPorts(node) {
 	switch (node.kind) {
+		case "outputs":
 		case "condition": return {};
 		case "value": return portsByHandle(node.values);
 		case "task": return portsByHandle(node.task.outputs);
@@ -12230,6 +12388,7 @@ function nodeOutputPorts(node) {
 		case "poll":
 		case "error":
 		case "manual":
+		case "start":
 		case "webhook": return triggerOutputPorts(node);
 	}
 }
@@ -12254,6 +12413,42 @@ async function imports(source) {
 	}
 }
 //#endregion
+//#region src/flow/common/portChanges.ts
+function renamedPort(previous, next) {
+	const previousNames = new Set(previous.flatMap((port) => "handle" in port ? [port.handle] : []));
+	const nextNames = new Set(next.flatMap((port) => "handle" in port ? [port.handle] : []));
+	const removed = [...previousNames].filter((name) => !nextNames.has(name));
+	const added = [...nextNames].filter((name) => !previousNames.has(name));
+	return removed.length == 1 && added.length == 1 ? [removed[0], added[0]] : void 0;
+}
+function renameOutputMapping(mapping, nodeIds, rename) {
+	if (rename == null || mapping.kind != "sources") return mapping;
+	const sources = mapping.sources.map((source) => source.kind == "node" && nodeIds.has(source.nodeId) && source.output == rename[0] ? {
+		...source,
+		output: rename[1]
+	} : source);
+	return sources.every((source, index) => source === mapping.sources[index]) ? mapping : {
+		kind: "sources",
+		sources
+	};
+}
+/** Carry saved mappings through a field rename and remove only fields absent from the new contract. */
+function remapInputMappings(mappings, ports, rename) {
+	const inputs = { ...mappings };
+	if (rename != null && Object.hasOwn(inputs, rename[0])) {
+		Object.defineProperty(inputs, rename[1], {
+			value: inputs[rename[0]],
+			enumerable: true,
+			configurable: true,
+			writable: true
+		});
+		delete inputs[rename[0]];
+	}
+	const names = new Set(ports.flatMap((port) => "handle" in port ? [port.handle] : []));
+	for (const name of Object.keys(inputs)) if (!names.has(name)) delete inputs[name];
+	return inputs;
+}
+//#endregion
 //#region src/flow/common/nodeChanges.ts
 var codeTaskTemplate = `export default async function (inputs, context) {
   return { result: inputs.value }
@@ -12503,7 +12698,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;
@@ -12512,6 +12707,40 @@ function bindingReferences(document) {
 	}
 	return references;
 }
+/** Edit the workflow input contract and preserve references on a single-field rename. */
+function updateStartInputDefs(content, nodeId, value) {
+	const node = content.document.graph.nodes[nodeId];
+	if (node?.kind != "start") throw new TypeError("Expected a Start node.");
+	const previous = node.inputDefs;
+	if (dequal(previous, value)) return [];
+	const operations = [{
+		kind: "graph.node.replace",
+		nodeId,
+		before: node,
+		node: {
+			...node,
+			inputDefs: value
+		}
+	}];
+	const rename = renamedPort(previous, value);
+	if (rename != null) {
+		const instances = /* @__PURE__ */ new Set([nodeId]);
+		for (const [id, downstream] of Object.entries(content.document.graph.nodes)) {
+			if (isTriggerNode(downstream)) continue;
+			for (const [handle, before] of Object.entries(nodeInputMappings(downstream))) {
+				const mapping = renameOutputMapping(before, instances, rename);
+				if (before !== mapping) operations.push({
+					before,
+					kind: "graph.node.input.set",
+					nodeId: id,
+					handle,
+					value: mapping
+				});
+			}
+		}
+	}
+	return operations;
+}
 function defaultInputs(ports) {
 	return Object.fromEntries(ports.flatMap((port) => "handle" in port && Object.hasOwn(port, "value") ? [[port.handle, {
 		kind: "value",
@@ -12524,6 +12753,112 @@ function llmInputValue(values, handle, fallback) {
 function createDecisionTask(identity, name = "AI Decision", questions) {
 	return createManagedTask(identity, decisionTask(questions, name));
 }
+/** Edit an Outputs node's definitions and mappings as one undoable change. */
+function updateOutputsDefs(content, nodeId, value, outputMappings) {
+	const node = content.document.graph.nodes[nodeId];
+	if (node?.kind != "outputs") throw new TypeError("Expected an Outputs node.");
+	const mappings = outputMappings ?? remapInputMappings(node.outputMappings, value, renamedPort(node.outputDefs, value));
+	const next = {
+		...node,
+		outputDefs: value,
+		outputMappings: mappings
+	};
+	return dequal(node, next) ? [] : cleanVariableBindings(content, [{
+		kind: "graph.node.replace",
+		nodeId,
+		before: node,
+		node: next
+	}]);
+}
+function renameFlowOutputSources(content, nodeIds, previous, next) {
+	const rename = renamedPort(previous, next);
+	if (rename == null) return [];
+	return Object.entries(content.document.graph.nodes).flatMap(([nodeId, node]) => {
+		if (node.kind != "outputs") return [];
+		const outputMappings = Object.fromEntries(Object.entries(node.outputMappings).map(([name, mapping]) => [name, renameOutputMapping(mapping, nodeIds, rename)]));
+		return dequal(node.outputMappings, outputMappings) ? [] : [{
+			kind: "graph.node.replace",
+			nodeId,
+			before: node,
+			node: {
+				...node,
+				outputMappings
+			}
+		}];
+	});
+}
+//#endregion
+//#region src/workflow/common/workflow.ts
+var portSchema = object$1({
+	handle: string().min(1),
+	jsonSchema: json$5(),
+	nullable: boolean(),
+	description: string().optional()
+});
+strictObject({
+	inputs: array(portSchema).nullable(),
+	outputs: array(portSchema).nullable()
+});
+object$1({
+	version: literal(1),
+	flowId: string().min(1),
+	name: string(),
+	revisionId: string().min(1),
+	publicationId: string().min(1),
+	inputs: array(portSchema),
+	outputs: array(portSchema).nullable()
+});
+/** A selected target is durable even before its callable interface is available. */
+function workflowSelectionTask(candidate, contract, previous) {
+	if (contract != null) return workflowTask(contract, candidate.name);
+	if (previous?.executor.kind == "workflow" && previous.executor.flowId == candidate.flowId) return previous;
+	return {
+		name: candidate.name,
+		inputs: [],
+		outputs: [],
+		executor: {
+			kind: "workflow",
+			flowId: candidate.flowId,
+			revisionId: ""
+		}
+	};
+}
+function workflowTask(contract, name = contract.name) {
+	return {
+		name,
+		executor: {
+			kind: "workflow",
+			flowId: contract.flowId,
+			revisionId: contract.revisionId
+		},
+		inputs: contract.inputs,
+		outputs: contract.outputs ?? []
+	};
+}
+/** Refresh capability ports by exact name; removed outputs remain unresolved at consumers. */
+function withWorkflowTask(node, task) {
+	return {
+		...node,
+		task,
+		inputs: Object.fromEntries(Object.entries(node.inputs).filter(([handle]) => task.inputs.some((port) => "handle" in port && port.handle == handle)))
+	};
+}
+object$1({
+	version: literal(1),
+	direction: _enum(["incoming", "outgoing"]),
+	total: int().nonnegative(),
+	nextOffset: int().nonnegative().optional(),
+	references: array(object$1({
+		flowId: string(),
+		name: string().nullable(),
+		available: boolean(),
+		draft: boolean(),
+		live: object$1({
+			publicationId: string(),
+			enabled: boolean()
+		}).nullable()
+	}))
+});
 //#endregion
 //#region src/control/common/authoringCondition.ts
 /** Preserve empty groups in invalid drafts; do not turn them into unconditional branches. */
@@ -12640,8 +12975,9 @@ function portField(ports, path, parent) {
 	}
 }
 /** Accept a decoded JSON Pointer, including or omitting its initial empty component. */
-function authoringDiagnosticField(_content, node, parts) {
+function authoringDiagnosticField(node, parts) {
 	const path = parts[0] == "" ? parts.slice(1) : parts;
+	if (node == null) return "config";
 	if (path[0] == "modules") return "code";
 	let location = path[0] == "document" && path[1] == "graph" && path[2] == "nodes" ? path.slice(4) : path;
 	const inlineDefinition = node.kind == "task" && location[0] == "task";
@@ -12649,6 +12985,9 @@ function authoringDiagnosticField(_content, node, parts) {
 	if (location.length == 0) return "config";
 	const head = location[0];
 	if (!inlineDefinition && metadata.has(head)) return location.join(".");
+	if (node.kind == "start" && head == "inputDefs") return portField(node.inputDefs, location.slice(1), "config.inputDefs");
+	if (node.kind == "outputs" && head == "outputDefs") return portField(node.outputDefs, location.slice(1), "config.outputDefs");
+	if (node.kind == "outputs" && head == "outputMappings") return ["inputs", ...location.slice(1)].join(".");
 	if (head == "prompt") return "prompt";
 	if (head == "inputs" && !inlineDefinition) {
 		if (node.kind == "condition" && location[1] != null) {
@@ -12695,6 +13034,7 @@ function authoringDiagnosticField(_content, node, parts) {
 			const field = location[1];
 			if (field == null || field == "kind") return "config";
 			if (field == "prompt") return "prompt";
+			if (executor?.kind == "workflow" && field == "revisionId") return "config.flowId";
 			if (executor?.kind == "openapi") {
 				if (field == "document") return "config";
 				if (field == "auth") return "config.authentication";
@@ -12728,6 +13068,7 @@ function authoringDiagnosticField(_content, node, parts) {
 		case "condition": return head == "cases" || head == "matchMode" ? ["config", ...conditionConfigurationFieldPath(node, location)].join(".") : "config";
 		case "wait":
 		case "approval": return head == "inputDefinitions" ? portField(node.inputDefinitions, location.slice(1), "config.inputs") : "config";
+		case "start": return "config";
 		case "webhook":
 			if (head == "bodyFields") return portField(node.bodyFields, location.slice(1), "config.body");
 			return head == "method" || head == "options" ? ["config", ...location].join(".") : "config";
@@ -12843,6 +13184,7 @@ async function prepareAgentTools(tools, previous, action, id) {
 /** Shared business configuration for authoring and published entry inspection. */
 function triggerConfiguration(node) {
 	switch (node.kind) {
+		case "start": return { inputDefs: fieldsView(node.inputDefs) };
 		case "manual": return {};
 		case "webhook": return {
 			body: fieldsView(node.bodyFields),
@@ -12895,7 +13237,7 @@ function inputMappings(node) {
 }
 function typeOf(node) {
 	const task = taskAt(node);
-	return node.kind != "task" ? node.kind : task != null && "executor" in task ? task.executor.kind : "code";
+	return node.kind == "manual" ? "start" : node.kind != "task" ? node.kind : task != null && "executor" in task ? task.executor.kind : "code";
 }
 function outwardSource(content, value) {
 	if (Array.isArray(value)) return value.map((v) => outwardSource(content, v));
@@ -12952,6 +13294,7 @@ function authoringNode(content, ref) {
 			...llmConfigurationView(task),
 			inputs: fieldsView([...task.inputs, ...node.kind == "task" ? node.additionalInputs ?? [] : []].filter((port) => !("handle" in port) || !llmReservedInputs.includes(port.handle)))
 		};
+		else if (task.executor.kind == "workflow") config = { flowId: task.executor.flowId };
 		else if (task.executor.kind == "openapi") config = { ...openApiConfigView(task.executor) };
 	} else if (node.kind == "task" && "moduleId" in node.task) {
 		config = {
@@ -12961,6 +13304,9 @@ function authoringNode(content, ref) {
 		};
 		texts.code = content.modules[node.task.moduleId]?.source ?? "";
 	} else switch (node.kind) {
+		case "outputs":
+			config = { outputDefs: fieldsView(node.outputDefs) };
+			break;
 		case "condition":
 			config = { ...conditionConfigurationView(node, (value) => outwardSource(content, value)) };
 			break;
@@ -12976,6 +13322,9 @@ function authoringNode(content, ref) {
 			texts.prompt = node.prompt;
 			break;
 		case "manual":
+			config = {};
+			break;
+		case "start":
 		case "webhook":
 		case "cron":
 		case "error":
@@ -13127,9 +13476,11 @@ function clearPath(value, path) {
 }
 async function compileAuthoring(base, request, host) {
 	const parsed = authoringRequestSchema.parse(request);
-	let content = base, index = 0, sequence = 0;
+	const upgraded = upgradeRevisionContent(base);
+	let content = upgraded, index = 0, sequence = 0;
 	const operations = [], aliases = {};
 	const touchedModules = /* @__PURE__ */ new Set();
+	const explicitMessages = /* @__PURE__ */ new Set();
 	function fresh(label) {
 		return host.id(`${index}:${label}:${sequence++}`);
 	}
@@ -13174,12 +13525,16 @@ async function compileAuthoring(base, request, host) {
 	}
 	function replace(ref, node) {
 		const before = nodeAt(content, ref);
-		if (!dequal(before, node)) apply([{
-			kind: "graph.node.replace",
-			nodeId: ref,
-			before,
-			node
-		}]);
+		if (!dequal(before, node)) {
+			const previous = before.kind == "task" ? before.task.outputs : before.kind == "value" ? before.values : [];
+			const next = node.kind == "task" ? node.task.outputs : node.kind == "value" ? node.values : [];
+			apply([{
+				kind: "graph.node.replace",
+				nodeId: ref,
+				before,
+				node
+			}, ...node.kind == "task" && "executor" in node.task && node.task.executor.kind == "workflow" ? [] : renameFlowOutputSources(content, /* @__PURE__ */ new Set([ref]), previous, next)]);
+		}
 	}
 	function taskNode(ref, task) {
 		const node = nodeAt(content, ref);
@@ -13203,6 +13558,14 @@ async function compileAuthoring(base, request, host) {
 			outputs: Object.entries(action.outputs).map(([handle, port]) => Object.assign({ handle }, port))
 		};
 	}
+	async function resolveWorkflow(flowId, name, previous) {
+		if (host.workflow == null) fail("workflow.unavailable", "Workflow calls are unavailable.");
+		const target = await host.workflow(flowId);
+		return "inputs" in target ? workflowTask(target, name) : workflowSelectionTask({
+			...target,
+			name
+		}, void 0, previous);
+	}
 	async function configure(ref, patch = {}, clear = []) {
 		const node = nodeAt(content, ref), view = authoringNode(content, ref), type = view.type;
 		const update = record(merge({
@@ -13224,12 +13587,19 @@ async function compileAuthoring(base, request, host) {
 			...rest,
 			...metadata
 		};
-		if ("inputs" in node) {
+		if (!isTriggerNode(node)) {
 			const clean = { ...next };
 			if (!Object.hasOwn(update, "timeoutMs")) delete clean.timeoutMs;
 			if (!Object.hasOwn(update, "maxExecutions")) delete clean.maxExecutions;
 			next = clean;
 		} else if (update.timeoutMs != null || update.maxExecutions != null) fail("node.invalid-field", "Trigger nodes do not have execution limits.");
+		if (node.kind == "start" || node.kind == "outputs") {
+			replace(ref, next);
+			const ports = fieldsToPorts(node.kind == "start" ? config.inputDefs : config.outputDefs, node.kind == "start" ? node.inputDefs : node.outputDefs).filter((port) => "handle" in port);
+			const changes = node.kind == "start" ? updateStartInputDefs(content, ref, ports) : updateOutputsDefs(content, ref, ports);
+			if (changes.length > 0) apply(changes);
+			return;
+		}
 		function taskInputs(task, reserved = []) {
 			if (node.kind != "task") throw new Error("Expected a task.");
 			const fields = record(config.inputs);
@@ -13265,7 +13635,16 @@ async function compileAuthoring(base, request, host) {
 		} else if (node.kind == "task" && "executor" in node.task) {
 			const before = node.task;
 			let task;
-			if (type == "connector") {
+			if (type == "workflow") {
+				task = before.executor.kind == "workflow" && before.executor.flowId == config.flowId ? {
+					...before,
+					name: String(update.name)
+				} : await resolveWorkflow(String(config.flowId), String(update.name));
+				next = withWorkflowTask({
+					...node,
+					...metadata
+				}, task);
+			} else if (type == "connector") {
 				if (before.executor.kind == "connector" && config.action == before.executor.action) {
 					const { connectionId: _connectionId, ...executor } = before.executor;
 					task = {
@@ -13439,6 +13818,7 @@ async function compileAuthoring(base, request, host) {
 		});
 	}
 	async function setInput(ref, input, value) {
+		if (input == "message") explicitMessages.add(ref);
 		const node = nodeAt(content, ref);
 		if (node.kind == "condition") fail("input.unsupported", "Edit the branch condition operands through config.branches.", {
 			node: ref,
@@ -13504,6 +13884,18 @@ async function compileAuthoring(base, request, host) {
 	for (const edit of parsed.edits) {
 		try {
 			switch (edit.op) {
+				case "node.refresh": {
+					const ref = resolve(edit.node);
+					const node = nodeAt(content, ref);
+					if (node.kind != "task" || !("executor" in node.task) || node.task.executor.kind != "workflow") fail("node.invalid-type", "Only workflow call nodes support refresh.");
+					apply([{
+						kind: "graph.node.replace",
+						nodeId: ref,
+						before: node,
+						node: withWorkflowTask(node, await resolveWorkflow(node.task.executor.flowId, node.name ?? node.task.name, node.task))
+					}]);
+					break;
+				}
 				case "node.add": {
 					if (Object.hasOwn(aliases, edit.as)) fail("node.alias-duplicate", `Duplicate alias ${edit.as}.`);
 					const nodeId = host.id(`node:${edit.as}`), identity = {
@@ -13514,6 +13906,21 @@ async function compileAuthoring(base, request, host) {
 					const config = edit.config ?? {};
 					let changes;
 					switch (edit.type) {
+						case "workflow":
+							changes = createManagedTask(identity, await resolveWorkflow(String(authoringConfigurations.workflow.parse(config).flowId), name));
+							break;
+						case "outputs":
+							changes = [{
+								kind: "graph.node.create",
+								nodeId,
+								node: {
+									outputDefs: [],
+									outputMappings: {},
+									kind: "outputs",
+									name
+								}
+							}];
+							break;
 						case "code":
 							changes = createCodeTask(identity, name, void 0, {
 								inputs: [],
@@ -13566,6 +13973,7 @@ async function compileAuthoring(base, request, host) {
 							node: {
 								kind: edit.type,
 								name,
+								...edit.type == "start" ? { inputDefs: [] } : {},
 								...edit.type == "cron" ? { cronTimes: [{
 									type: "every",
 									unit: "hour",
@@ -13615,11 +14023,8 @@ async function compileAuthoring(base, request, host) {
 						target: to,
 						...edit.branch == null ? {} : { sourceHandle: edit.branch }
 					};
-					const exists = content.document.graph.edges.some((e) => dequal(e, edge));
-					if (edit.op == "edge.connect" != exists) apply([{
-						kind: edit.op == "edge.connect" ? "graph.edge.connect" : "graph.edge.disconnect",
-						edge
-					}]);
+					const changes = edit.op == "edge.connect" ? connect(content, edge) : disconnect(content, edge);
+					apply(explicitMessages.has(to) ? changes.filter((change) => change.kind != "graph.node.input.set") : changes);
 					break;
 				}
 				case "text.set":
@@ -13649,10 +14054,10 @@ async function compileAuthoring(base, request, host) {
 		kind: "module.delete",
 		moduleId
 	}]);
-	const cleaned = cleanVariableBindings(base, operations);
+	const cleaned = cleanVariableBindings(upgraded, operations);
 	return {
 		operations: cleaned,
-		content: cleaned.length == 0 ? base : applyFlowChanges(base, cleaned),
+		content: cleaned.length == 0 ? upgraded : applyFlowChanges(upgraded, cleaned),
 		nodes: aliases
 	};
 }
@@ -13675,7 +14080,7 @@ function authoringDiagnostics(content, diagnostics) {
 			code: diagnostic.code,
 			message,
 			nodes: affected.map(([id]) => id),
-			field: affected[0] == null ? "config" : authoringDiagnosticField(content, affected[0][1], parts),
+			field: authoringDiagnosticField(affected[0]?.[1], parts),
 			...diagnostic.line ? {
 				line: diagnostic.line,
 				column: diagnostic.column
@@ -13757,7 +14162,7 @@ var eventSourceRevisionSchema = strictObject({
 //#endregion
 //#region src/control/common/authoringExamples.ts
 var descriptions = {
-	"manual": "A Manual start node.",
+	"start": "A Start node with a required message parameter. Supply it through trigger.outputs.",
 	"error": "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs.",
 	"webhook": "A Webhook start node.",
 	"cron": "An hourly scheduled start node.",
@@ -13805,11 +14210,16 @@ function authoringExample(name) {
 				} } } } } } } }
 			}, "https://api.example.com/openapi.json", "/items", "get")));
 			break;
-		case "manual":
-			operations = createBuiltinTrigger("start", {
-				kind: "manual",
+		case "start":
+			operations = [...createBuiltinTrigger("start", {
+				inputDefs: [{
+					handle: "message",
+					jsonSchema: { type: "string" },
+					nullable: false
+				}],
+				kind: "start",
 				name: "Start"
-			});
+			})];
 			break;
 		case "webhook":
 			operations = createBuiltinTrigger("start", {
@@ -14069,6 +14479,10 @@ var schemas = {
 		expectedRevisionId: id,
 		version
 	}),
+	upgradeDraft: strictObject({
+		expectedRevisionId: id,
+		version
+	}),
 	setEnabled: strictObject({
 		enabled: boolean(),
 		expectedPublicationId: id,
@@ -14165,6 +14579,7 @@ var controlRequests = {
 		};
 	},
 	repairDraft: decoder(schemas.repairDraft),
+	upgradeDraft: decoder(schemas.upgradeDraft),
 	setEnabled: decoder(schemas.setEnabled),
 	updatePresentation: decoder(schemas.updatePresentation),
 	checkFlow: decoder(schemas.checkFlow),
@@ -14193,4 +14608,4 @@ function controlRequestSchema(name) {
 	return schema;
 }
 //#endregion
-export { AuthoringError, authoringCheckResponse, authoringCheckSchema, authoringConfigurations, authoringDiagnosticSchema, authoringDiagnostics, authoringEditResponse, authoringEditSchema, authoringExample, authoringExamples, authoringNode, authoringReadResponse, authoringReadSchema, authoringRequestContract, authoringRequestSchema, authoringSchema, authoringSchemaQuery, authoringSearchResponse, authoringSearchSchema, authoringSourceSchema, authoringTypes, canvasCommandSchema, compileAuthoring, controlRequestSchema, controlRequests, decodeDraftOperations, draftOperationsSchema, readAuthoring, resolveDraftOperations, searchAuthoring, waitActionBodySchema };
+export { AuthoringError, authoringCheckResponse, authoringCheckSchema, authoringConfigurations, authoringDiagnosticSchema, authoringDiagnostics, authoringEditResponse, authoringEditSchema, authoringExample, authoringExamples, authoringNode, authoringReadResponse, authoringReadSchema, authoringRequestContract, authoringRequestSchema, authoringSchema, authoringSchemaQuery, authoringSearchResponse, authoringSearchSchema, authoringSourceSchema, authoringTypes, canvasCommandSchema, compileAuthoring, controlRequestSchema, controlRequests, decodeDraftOperations, draftOperationsSchema, flowInputFields, flowInputFieldsView, flowOutputFields, readAuthoring, resolveDraftOperations, searchAuthoring, waitActionBodySchema };