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

package/dist/common/control-api-conformance.js

@@ -22,6 +22,15 @@ function dequal(foo, bar) {
 	return foo !== foo && bar !== bar;
 }
 //#endregion
+//#region src/openapi/common/authBindings.ts
+/** Never allow credentials to enter a Revision as literal node inputs. */
+function assertOpenApiAuthBindings(document) {
+	for (const node of Object.values(document.graph.nodes)) {
+		if (node.kind != "task" || !("executor" in node.task) || node.task.executor.kind != "openapi") continue;
+		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && mapping.kind == "value") throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+	}
+}
+//#endregion
 //#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
 	const numericValues = Object.values(entries).filter((v) => typeof v === "number");
@@ -5691,50 +5700,6 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region src/flow/common/webhookMethod.ts
-var webhookMethods = [
-	"GET",
-	"POST",
-	"PUT",
-	"PATCH",
-	"DELETE"
-];
-function webhookSupportsBody(method) {
-	return method !== "GET";
-}
-//#endregion
-//#region src/openapi/common/authBindings.ts
-/** Never allow credentials to enter a Revision as literal node inputs. */
-function assertOpenApiAuthBindings(document) {
-	for (const node of Object.values(document.graph.nodes)) {
-		if (node.kind != "task" || !("executor" in node.task) || node.task.executor.kind != "openapi") continue;
-		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && mapping.kind == "value") throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
-	}
-}
-//#endregion
-//#region src/flow/common/change.ts
-var schemaKeywords = /* @__PURE__ */ new Set([
-	"const",
-	"enum",
-	"exclusiveMaximum",
-	"exclusiveMinimum",
-	"maximum",
-	"maxItems",
-	"maxLength",
-	"maxProperties",
-	"minimum",
-	"minItems",
-	"minLength",
-	"minProperties",
-	"multipleOf",
-	"pattern",
-	"required",
-	"type"
-]);
-function isSchemaKeyword(value) {
-	return schemaKeywords.has(value);
-}
-//#endregion
 //#region src/json-schema-subset/utils.ts
 var nextId = 0;
 function createId() {
@@ -8601,6 +8566,18 @@ var triggerScheduleSchema = array(union([object({
 	]),
 	value: number()
 })]));
+//#endregion
+//#region src/flow/common/webhookMethod.ts
+var webhookMethods = [
+	"GET",
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE"
+];
+function webhookSupportsBody(method) {
+	return method !== "GET";
+}
 var text = string$1();
 var json$3 = json$4();
 var strings$1 = array(text);
@@ -8610,6 +8587,7 @@ var port$1 = object({
 	nullable: boolean(),
 	handle: text
 });
+var workflowInputDefs = array(port$1.strict());
 var input = port$1.extend({ value: json$3.optional() });
 var group = object({
 	collapsed: boolean().optional(),
@@ -8767,6 +8745,11 @@ var managedFields = object({
 				messageHandle: text,
 				inputs: record$3(text, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text,
+			revisionId: text
 		})
 	])
 });
@@ -8875,6 +8858,12 @@ var base = {
 	timeoutMs: number().optional()
 };
 var node = union([
+	strictObject({
+		...base,
+		kind: literal("outputs"),
+		outputDefs: array(port$1.strict()),
+		outputMappings: inputs
+	}).omit({ inputs: true }),
 	object({
 		...base,
 		inputs: record$3(text, never()),
@@ -8907,6 +8896,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger,
 		kind: literal("error"),
@@ -8986,7 +8980,7 @@ var module = object({
 	imports: strings$1,
 	source: text
 });
-var document = preprocess(rejectRetiredDefinitions, object({
+var document = preprocess(normalizeDocument, object({
 	bindings: record$3(text, binding$1),
 	graph
 }));
@@ -8995,7 +8989,9 @@ var revision = object({
 		literal(2),
 		literal(4),
 		literal(5),
-		literal(6)
+		literal(6),
+		literal(7),
+		literal(8)
 	]),
 	document,
 	modules: record$3(text, module)
@@ -9004,13 +9000,19 @@ 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) {
@@ -9176,10 +9178,100 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...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/change.ts
+var schemaKeywords = /* @__PURE__ */ new Set([
+	"const",
+	"enum",
+	"exclusiveMaximum",
+	"exclusiveMinimum",
+	"maximum",
+	"maxItems",
+	"maxLength",
+	"maxProperties",
+	"minimum",
+	"minItems",
+	"minLength",
+	"minProperties",
+	"multipleOf",
+	"pattern",
+	"required",
+	"type"
+]);
+function isSchemaKeyword(value) {
+	return schemaKeywords.has(value);
+}
+/** 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;
+}
+//#endregion
+//#region src/workflow/common/workflow.ts
+var portSchema = object({
+	handle: string$1().min(1),
+	jsonSchema: json$4(),
+	nullable: boolean(),
+	description: string$1().optional()
+});
+strictObject({
+	inputs: array(portSchema).nullable(),
+	outputs: array(portSchema).nullable()
+});
+var workflowContractSchema = object({
+	version: literal(1),
+	flowId: string$1().min(1),
+	name: string$1(),
+	revisionId: string$1().min(1),
+	publicationId: string$1().min(1),
+	inputs: array(portSchema),
+	outputs: array(portSchema).nullable()
+});
+var workflowReferencesSchema = object({
+	version: literal(1),
+	direction: _enum(["incoming", "outgoing"]),
+	total: int().nonnegative(),
+	nextOffset: int().nonnegative().optional(),
+	references: array(object({
+		flowId: string$1(),
+		name: string$1().nullable(),
+		available: boolean(),
+		draft: boolean(),
+		live: object({
+			publicationId: string$1(),
+			enabled: boolean()
+		}).nullable()
+	}))
+});
+//#endregion
 //#region src/control/common/authoringLlm.ts
 var authoringLlmConfiguration = strictObject({
 	mode: _enum(["chat", "json"]),
@@ -9212,7 +9304,9 @@ var id$1 = string$1().min(1);
 var json$2 = json$4();
 var patch = record$3(id$1, json$2);
 var type = _enum([
-	"manual",
+	"start",
+	"outputs",
+	"workflow",
 	"webhook",
 	"cron",
 	"error",
@@ -9284,6 +9378,12 @@ var field = strictObject({
 	description: string$1().optional()
 });
 var inputFields = record$3(id$1, field.extend({ default: json$2.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$1, 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$1, field.extend({
+	schema: json$2,
+	nullable: boolean()
+}));
 var outputFields = record$3(id$1, field).describe("Code return fields by name. Omitted schema accepts any JSON; omitted nullable is true.");
 var expression = strictObject({
 	left: operand,
@@ -9297,7 +9397,9 @@ var when = union([
 	strictObject({ any: array(union([expression, all])) })
 ]);
 var authoringConfigurations = {
-	manual: strictObject({}),
+	workflow: strictObject({ flowId: id$1 }),
+	start: strictObject({ inputDefs: flowInputFields.default({}) }),
+	outputs: strictObject({ outputDefs: flowOutputFields.default({}) }),
 	error: strictObject({ sourceFlowIds: array(id$1).optional() }),
 	webhook: authoringDefinitionSchemas.webhook.omit({ bodyFields: true }).extend({ body: inputFields }).strict(),
 	cron: strictObject({ schedule: authoringDefinitionSchemas.schedule }),
@@ -9368,6 +9470,10 @@ var authoringEditSchema = discriminatedUnion("op", [
 		set: updates.optional(),
 		clear: array(array(id$1).min(1)).optional()
 	}),
+	strictObject({
+		op: literal("node.refresh"),
+		node: referenceSchema
+	}),
 	strictObject({
 		op: literal("node.remove"),
 		node: referenceSchema
@@ -9478,7 +9584,7 @@ var authoringSearchResponse = object({
 	revision: id$1,
 	data: object({
 		matches: array(object({
-			node: id$1,
+			node: id$1.optional(),
 			field: id$1,
 			line: int().optional(),
 			excerpt: string$1()
@@ -9566,6 +9672,10 @@ function record$1(value) {
 function string(value) {
 	return typeof value == "string" && value.length > 0 ? value : invalidResponse("Expected a non-empty string.");
 }
+function requiredFields(value, keys) {
+	const missing = keys.filter((key) => !Object.hasOwn(value, key));
+	if (missing.length > 0) invalidResponse(`Missing fields: ${missing.join(", ")}.`);
+}
 function exact(value, keys) {
 	const actual = Object.keys(value);
 	if (actual.length != keys.length || actual.some((key) => !keys.includes(key))) {
@@ -9633,7 +9743,7 @@ function publishOperation(value) {
 	if (source.version != 1) return invalidResponse();
 	switch (status) {
 		case "pending":
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"operationId",
@@ -9647,7 +9757,7 @@ function publishOperation(value) {
 				status
 			};
 		case "succeeded":
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"operationId",
@@ -9663,7 +9773,7 @@ function publishOperation(value) {
 				status
 			};
 		case "failed": {
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"issue",
@@ -9675,7 +9785,7 @@ function publishOperation(value) {
 			]);
 			const issue = record$1(source.issue);
 			const nodeId = issue.nodeId;
-			exact(issue, [
+			requiredFields(issue, [
 				"code",
 				"message",
 				...nodeId == null ? [] : ["nodeId"]
@@ -9916,43 +10026,48 @@ var metadata = {
 var binding = unknown().transform(triggerBinding);
 var provider = {
 	provider: string$1().min(1),
-	inputs: record$3(string$1(), discriminatedUnion("kind", [strictObject({
+	inputs: record$3(string$1(), discriminatedUnion("kind", [object({
 		kind: literal("value"),
 		value: json$4()
-	}), strictObject({ kind: literal("unset") })]))
+	}), object({ kind: literal("unset") })]))
 };
 var entrySchema = discriminatedUnion("type", [
-	strictObject({
+	object({
+		...metadata,
+		type: literal("start"),
+		config: authoringConfigurations.start
+	}),
+	object({
 		...metadata,
 		type: literal("manual"),
-		config: authoringConfigurations.manual
+		config: object({})
 	}),
-	strictObject({
+	object({
 		...metadata,
 		type: literal("webhook"),
 		config: authoringConfigurations.webhook,
 		binding
 	}),
-	strictObject({
+	object({
 		...metadata,
 		type: literal("cron"),
 		config: authoringConfigurations.cron,
 		binding
 	}),
-	strictObject({
+	object({
 		...metadata,
 		type: literal("error"),
 		config: authoringConfigurations.error,
 		binding
 	}),
-	strictObject({
+	object({
 		...metadata,
 		...provider,
 		type: literal("poll"),
 		config: authoringConfigurations.poll,
 		binding
 	}),
-	strictObject({
+	object({
 		...metadata,
 		...provider,
 		type: literal("integration"),
@@ -9965,9 +10080,10 @@ function decodeLiveDetails(value) {
 	const flowId = string(source.flowId);
 	if (source.version != 1 || !Array.isArray(source.entries)) return invalidResponse();
 	if (source.publication === null) {
-		if (source.status != "not-published" || source.entries.length != 0 || Object.hasOwn(source, "enabled")) return invalidResponse();
+		if (source.inputDefs !== null || source.status != "not-published" || source.entries.length != 0 || Object.hasOwn(source, "enabled")) return invalidResponse();
 		return {
 			flowId,
+			inputDefs: null,
 			publication: null,
 			status: "not-published",
 			entries: [],
@@ -9979,8 +10095,11 @@ function decodeLiveDetails(value) {
 	if (current.flowId != flowId || typeof source.enabled != "boolean") return invalidResponse();
 	if (status != "runnable" && status != "suspended") return invalidResponse();
 	if (!source.enabled && source.status == "runnable") return invalidResponse();
+	const inputDefs = flowInputFieldsView.safeParse(source.inputDefs);
+	if (!inputDefs.success) return invalidResponse();
 	return {
 		flowId,
+		inputDefs: inputDefs.data,
 		publication: current,
 		status,
 		enabled: source.enabled,
@@ -9996,7 +10115,7 @@ function decodeEntries(values, current) {
 	for (const entry of parsed.data) {
 		if (ids.has(entry.nodeId)) return invalidResponse();
 		ids.add(entry.nodeId);
-		if (entry.type != "manual" && (entry.binding.flowId != current.flowId || entry.binding.triggerNodeId != entry.nodeId || entry.binding.kind != entry.type || entry.binding.currentPublicationId != current.publicationId || entry.binding.currentRevisionId != current.revisionId)) return invalidResponse();
+		if (entry.type != "start" && entry.type != "manual" && (entry.binding.flowId != current.flowId || entry.binding.triggerNodeId != entry.nodeId || entry.binding.kind != entry.type || entry.binding.currentPublicationId != current.publicationId || entry.binding.currentRevisionId != current.revisionId)) return invalidResponse();
 		if (entry.type == "webhook" && (!entry.binding.endpointUrl || !webhookSupportsBody(entry.config.method) && Object.keys(entry.config.body).length > 0)) return invalidResponse();
 	}
 	return parsed.data;
@@ -10309,7 +10428,7 @@ function connectorAccessCandidatesBatch(value, providerIds) {
 }
 function connection(value) {
 	const source = record$1(value);
-	exact(source, [
+	requiredFields(source, [
 		...Object.hasOwn(source, "providerAccountId") ? ["providerAccountId"] : [],
 		...Object.hasOwn(source, "alias") ? ["alias"] : [],
 		...Object.hasOwn(source, "builtInAccount") ? ["builtInAccount"] : [],
@@ -10338,7 +10457,7 @@ function port(value, input = false) {
 	const source = record$1(value);
 	const description = source.description;
 	const hasValue = input && Object.hasOwn(source, "value");
-	exact(source, [
+	requiredFields(source, [
 		"jsonSchema",
 		"nullable",
 		...description == null ? [] : ["description"],
@@ -10363,7 +10482,7 @@ function connectorActionMetadata(value) {
 	const source = record$1(value);
 	const homepageUrl = source.homepageUrl;
 	const icon = source.icon;
-	exact(source, [
+	requiredFields(source, [
 		"actionId",
 		...Object.hasOwn(source, "operationType") ? ["operationType"] : [],
 		...Object.hasOwn(source, "inputSchema") ? ["inputSchema"] : [],
@@ -10414,7 +10533,7 @@ function connectorProvider(value) {
 	const homepageUrl = source.homepageUrl;
 	const icon = source.icon;
 	if (source.noSetup !== void 0 && typeof source.noSetup != "boolean") return invalidResponse();
-	exact(source, [
+	requiredFields(source, [
 		...Object.hasOwn(source, "noSetup") ? ["noSetup"] : [],
 		"serviceId",
 		"serviceName",
@@ -10438,7 +10557,7 @@ function connectorProvider(value) {
 var id = string$1().min(1).max(256);
 var eventType = string$1().regex(/^[a-z][a-z0-9_.]{0,127}$/);
 var name = string$1().trim().min(1).max(128);
-var eventSourceSchema = strictObject({
+var eventSourceSchema = object({
 	version: literal(1),
 	sourceId: id,
 	revision: int().positive(),
@@ -10456,7 +10575,7 @@ var eventSourceSchema = strictObject({
 	verifiedAt: string$1().nullable(),
 	lastReceivedAt: string$1().nullable(),
 	updatedAt: string$1(),
-	consumers: array(strictObject({
+	consumers: array(object({
 		flowId: id,
 		flowName: string$1(),
 		triggerNodeId: id
@@ -10466,7 +10585,7 @@ function decodeEventSource(value) {
 	return eventSourceSchema.parse(value);
 }
 function decodeEventSources(value) {
-	return strictObject({
+	return object({
 		version: literal(1),
 		sources: array(eventSourceSchema),
 		teamId: id.nullable().optional()
@@ -10488,7 +10607,7 @@ function isUiLanguage(value) {
 //#region src/control/common/triggerCatalog.ts
 function decodeTriggerCatalog(value) {
 	const source = record$1(value);
-	exact(source, [
+	requiredFields(source, [
 		"version",
 		"locale",
 		"definitions",
@@ -10502,7 +10621,7 @@ function decodeTriggerCatalog(value) {
 	const display = Object.fromEntries(definitions.map((definition) => {
 		const { key } = definition;
 		const copy = record$1(entries[key]);
-		exact(copy, [
+		requiredFields(copy, [
 			"configInputs",
 			"configInputLabels",
 			"displayName",
@@ -10546,7 +10665,7 @@ strictObject({
 //#endregion
 //#region src/control/common/results.ts
 var json$1 = json$4();
-var entry = strictObject({
+var entry = object({
 	pointer: string$1(),
 	type: _enum([
 		"object",
@@ -10565,25 +10684,25 @@ var page = entry.extend({
 	nextOffset: number().int().positive().optional(),
 	entries: array(entry).optional()
 });
-var result = strictObject({
+var result = object({
 	resultId: string$1().min(1),
 	callId: string$1().min(1),
 	toolId: string$1().min(1),
-	source: discriminatedUnion("kind", [strictObject({
+	source: discriminatedUnion("kind", [object({
 		kind: literal("connector"),
 		action: string$1().min(1)
-	}), strictObject({ kind: literal("code") })]),
+	}), object({ kind: literal("code") })]),
 	bytes: number().int().nonnegative(),
 	digest: string$1().regex(/^[a-f0-9]{64}$/),
 	createdAt: string$1().datetime()
 });
-var listSchema = strictObject({
+var listSchema = object({
 	version: literal(1),
 	runId: string$1(),
 	results: array(result),
 	nextAfter: string$1().optional()
 });
-var readSchema = strictObject({
+var readSchema = object({
 	version: literal(1),
 	runId: string$1(),
 	result,
@@ -10660,7 +10779,7 @@ function connectorProvidersQuery(flowId, locale) {
 		path: `/v1/connector/providers${parameters ? `?${parameters}` : ""}`,
 		decode: (value) => {
 			const source = record$1(value);
-			exact(source, ["providers", "version"]);
+			requiredFields(source, ["providers", "version"]);
 			if (source.version != 1 || !Array.isArray(source.providers)) return invalidResponse();
 			return source.providers.map(connectorProvider);
 		}
@@ -10675,7 +10794,7 @@ function connectorActionQuery(actionId, flowId, locale) {
 		path: `/v1/connector/actions/${encodeURIComponent(actionId)}${parameters ? `?${parameters}` : ""}`,
 		decode: (value) => {
 			const source = record$1(value);
-			exact(source, ["action", "version"]);
+			requiredFields(source, ["action", "version"]);
 			if (source.version != 1) return invalidResponse();
 			return connectorAction(source.action);
 		}
@@ -10686,7 +10805,7 @@ function allConnectorConnectionsQuery(flowId) {
 		path: `/v1/connector/connections${scope(flowId)}`,
 		decode: (value) => {
 			const source = record$1(value);
-			exact(source, ["connections", "version"]);
+			requiredFields(source, ["connections", "version"]);
 			if (source.version != 1 || !Array.isArray(source.connections)) return invalidResponse();
 			return source.connections.map(connection);
 		}
@@ -10697,7 +10816,7 @@ function connectorConnectionsQuery(serviceId, flowId) {
 		path: `/v1/connector/connections/${encodeURIComponent(serviceId)}${scope(flowId)}`,
 		decode: (value) => {
 			const source = record$1(value);
-			exact(source, [
+			requiredFields(source, [
 				"connections",
 				"serviceId",
 				"version"
@@ -10722,6 +10841,7 @@ function resourceReferences(input) {
 	if (accessRevision < 0) return invalidResponse();
 	return {
 		draft: draft == null ? null : {
+			...draft.calledFlowIds === void 0 ? {} : { calledFlowIds: strings(draft.calledFlowIds) },
 			variableNames: strings(draft.variableNames),
 			errorSourceFlowIds: strings(draft.errorSourceFlowIds),
 			connections: draft.connections.map((value) => {
@@ -10752,10 +10872,11 @@ function flow(value) {
 	if (source.version != 1) return invalidResponse();
 	if (status != "active" && status != "retiring") return invalidResponse();
 	const target = source.live == null ? void 0 : record$1(source.live);
-	if (target != null && typeof target.enabled != "boolean") return invalidResponse();
+	if (target != null && (typeof target.enabled != "boolean" || typeof target.hasStart != "boolean")) return invalidResponse();
 	return {
 		...target == null ? {} : { live: {
 			enabled: target.enabled,
+			hasStart: target.hasStart,
 			publicationId: string(target.publicationId),
 			revisionId: string(target.revisionId)
 		} },
@@ -10786,7 +10907,7 @@ function flowPage(value) {
 }
 function variable(value) {
 	const source = record$1(value);
-	exact(source, [
+	requiredFields(source, [
 		"name",
 		"updatedAt",
 		"value",
@@ -10806,6 +10927,15 @@ function variable(value) {
 		version: 1
 	};
 }
+function variableListItem(value) {
+	const { referenceCount, ...fields } = record$1(value);
+	const count = integer(referenceCount);
+	if (count < 0) return invalidResponse();
+	return {
+		...variable(fields),
+		referenceCount: count
+	};
+}
 function errorListener(value) {
 	const source = record$1(value);
 	if (typeof source.enabled != "boolean") return invalidResponse();
@@ -10819,17 +10949,13 @@ function errorListener(value) {
 }
 function variableReferences(input) {
 	const source = record$1(input);
-	exact(source, [
-		"version",
-		"references",
-		"unknown"
-	]);
-	if (source.version != 1 || !Array.isArray(source.references) || !Array.isArray(source.unknown)) return invalidResponse();
+	requiredFields(source, ["version", "references"]);
+	if (source.version != 1 || !Array.isArray(source.references)) return invalidResponse();
 	return {
 		version: 1,
 		references: source.references.map((value) => {
 			const item = record$1(value);
-			exact(item, [
+			requiredFields(item, [
 				"flowId",
 				"flowName",
 				"draft",
@@ -10838,7 +10964,7 @@ function variableReferences(input) {
 			if (typeof item.draft != "boolean") return invalidResponse();
 			const live = item.live === null ? null : record$1(item.live);
 			if (live != null) {
-				exact(live, ["publicationId", "enabled"]);
+				requiredFields(live, ["publicationId", "enabled"]);
 				if (typeof live.enabled != "boolean") return invalidResponse();
 			}
 			return {
@@ -10850,20 +10976,6 @@ function variableReferences(input) {
 					enabled: live.enabled
 				}
 			};
-		}),
-		unknown: source.unknown.map((value) => {
-			const item = record$1(value);
-			exact(item, [
-				"flowId",
-				"flowName",
-				"scope"
-			]);
-			if (item.scope !== "draft" && item.scope !== "live") return invalidResponse();
-			return {
-				flowId: string(item.flowId),
-				flowName: string(item.flowName),
-				scope: item.scope
-			};
 		})
 	};
 }
@@ -10961,7 +11073,7 @@ function run(value) {
 }
 function runWaiting(value) {
 	const source = record$1(value);
-	exact(source, [
+	requiredFields(source, [
 		"actions",
 		"expiresAt",
 		"nodeId",
@@ -10980,6 +11092,15 @@ function runWaiting(value) {
 		waitingSince: string(source.waitingSince)
 	};
 }
+function workflowIdentity(value) {
+	const ref = record$1(value);
+	return {
+		flowId: string(ref.flowId),
+		runId: string(ref.runId),
+		nodeId: string(ref.nodeId),
+		executionId: string(ref.executionId)
+	};
+}
 function runDetails(value) {
 	const source = record$1(value);
 	const summary = run(source);
@@ -10987,20 +11108,24 @@ function runDetails(value) {
 	if (eventsExpiresAt != null && typeof eventsExpiresAt != "string") return invalidResponse();
 	if (source.waiting !== void 0 || !Array.isArray(source.waits)) return invalidResponse();
 	const waits = source.waits.map(runWaiting);
-	if (new Set(waits.map((wait) => wait.waitId)).size != waits.length || summary.status == "waiting" && waits.length == 0 || [
+	if (new Set(waits.map((wait) => wait.waitId)).size != waits.length || summary.status == "waiting" && waits.length == 0 && (!Array.isArray(source.calls) || source.calls.length == 0) || [
 		"completed",
 		"failed",
 		"canceled",
 		"indeterminate"
 	].includes(summary.status) && waits.length > 0) return invalidResponse();
-	if (source.occurrenceId === void 0 != (source.triggerNodeId === void 0)) return invalidResponse();
+	if (source.occurrenceId !== void 0 && source.triggerNodeId === void 0) return invalidResponse();
 	const state = {
 		status: summary.status,
 		waits
 	};
+	if (source.calls !== void 0 && !Array.isArray(source.calls)) return invalidResponse();
 	const details = {
 		...summary,
 		...errorHandling(source),
+		...source.triggerNodeId === void 0 ? {} : { triggerNodeId: string(source.triggerNodeId) },
+		...source.caller === void 0 ? {} : { caller: workflowIdentity(source.caller) },
+		...source.calls === void 0 ? {} : { calls: source.calls.map((item) => Object.assign(workflowIdentity(item), { status: record$1(item).status === null ? null : runStatus(record$1(item).status) })) },
 		closureDigest: string(source.closureDigest),
 		engineContract: string(source.engineContract),
 		engineDigest: string(source.engineDigest),
@@ -11051,7 +11176,7 @@ function runCancellation(value) {
 }
 function waitResolution(value) {
 	const source = record$1(value);
-	exact(source, [
+	requiredFields(source, [
 		"action",
 		"comment",
 		"resolutionAccepted",
@@ -11268,7 +11393,7 @@ function decodeRunEvent(value) {
 			switch (kind) {
 				case "node.started": {
 					const nodeKind = payload.nodeKind;
-					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "decision" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
+					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "decision" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "value" && nodeKind !== "outputs" && nodeKind !== "workflow" && nodeKind !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,
@@ -11395,14 +11520,14 @@ var ControlClient = class {
 		if (options.limit != null) parameters.set("limit", String(options.limit));
 		if (options.includeTotal != null) parameters.set("includeTotal", String(options.includeTotal));
 		const query = parameters.size == 0 ? "" : `?${parameters}`;
-		return flowPage(await this.request(`/v1/flows${query}`));
+		return flowPage(await this.request(`/v1/flows${query}`, options.signal == null ? void 0 : { signal: options.signal }));
 	}
 	async listEventSources(flowId, signal) {
 		return decodeEventSources(await this.request("/v1/event-sources" + (flowId == null ? "" : `?flowId=${segment(flowId)}`), { signal }));
 	}
 	async listEventSourceConnections(teamId, signal) {
 		const source = record$1(await this.request(`/v1/event-sources/connections${teamId == null ? "" : `?teamId=${segment(teamId)}`}`, { signal }));
-		exact(source, ["version", "connections"]);
+		requiredFields(source, ["version", "connections"]);
 		if (source.version != 1 || !Array.isArray(source.connections)) return invalidResponse();
 		return source.connections.map(connection);
 	}
@@ -11429,13 +11554,24 @@ var ControlClient = class {
 	}
 	async listVariables() {
 		const source = record$1(await this.request("/v1/variables"));
-		exact(source, ["variables", "version"]);
+		requiredFields(source, ["variables", "version"]);
 		if (source.version != 1 || !Array.isArray(source.variables)) return invalidResponse();
 		return {
-			variables: source.variables.map(variable),
+			variables: source.variables.map(variableListItem),
 			version: 1
 		};
 	}
+	async getFlowReferences(flowId, options = {}) {
+		const query = new URLSearchParams({
+			direction: options.direction ?? "incoming",
+			offset: String(options.offset ?? 0),
+			limit: String(options.limit ?? 50)
+		});
+		return workflowReferencesSchema.parse(await this.request(`/v1/flows/${segment(flowId)}/references?${query}`, { signal: options.signal }));
+	}
+	async getWorkflowContract(flowId, signal) {
+		return workflowContractSchema.parse(await this.request(`/v1/flows/${segment(flowId)}/call-contract`, { signal }));
+	}
 	async getVariableReferences(name, signal) {
 		return variableReferences(await this.request(`/v1/variables/${segment(name)}/references`, { signal }));
 	}
@@ -11450,7 +11586,7 @@ var ControlClient = class {
 	}
 	async deleteVariable(name) {
 		const source = record$1(await this.request(`/v1/variables/${segment(name)}`, { method: "DELETE" }));
-		exact(source, ["version"]);
+		requiredFields(source, ["version"]);
 		if (source.version != 1) return invalidResponse();
 	}
 	async exportFlow(flowId) {
@@ -11492,7 +11628,7 @@ var ControlClient = class {
 				command
 			})
 		}));
-		exact(source, [
+		requiredFields(source, [
 			"version",
 			"flowId",
 			"broadcast"
@@ -11632,11 +11768,11 @@ var ControlClient = class {
 	}
 	async listTriggerConfigOptions(flowId, nodeId, field, signal) {
 		const source = record$1(await this.request(`/v1/flows/${segment(flowId)}/triggers/${segment(nodeId)}/options/${segment(field)}`, { signal }));
-		exact(source, ["options", "version"]);
+		requiredFields(source, ["options", "version"]);
 		if (source.version != 1 || !Array.isArray(source.options) || source.options.length > 1e3) return invalidResponse();
 		return source.options.map((value) => {
 			const item = record$1(value);
-			exact(item, [
+			requiredFields(item, [
 				"value",
 				"label",
 				...item.color == null ? [] : ["color"]
@@ -11655,7 +11791,7 @@ var ControlClient = class {
 	}
 	async listConnectorTeams(signal) {
 		const source = record$1(await this.request("/v1/connector/teams", { signal }));
-		exact(source, [
+		requiredFields(source, [
 			"enabled",
 			"teams",
 			"version"
@@ -11665,7 +11801,7 @@ var ControlClient = class {
 			enabled: source.enabled,
 			teams: source.teams.map((value) => {
 				const team = record$1(value);
-				exact(team, [
+				requiredFields(team, [
 					"id",
 					"name",
 					"systemCreated"
@@ -11778,7 +11914,7 @@ var ControlClient = class {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		}));
-		exact(source, ["url", "version"]);
+		requiredFields(source, ["url", "version"]);
 		if (source.version != 1) return invalidResponse();
 		try {
 			const url = new URL(string(source.url));
@@ -11840,6 +11976,16 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
+	async upgradeDraft(flowId, expectedRevisionId, options = {}) {
+		return draftChange(await this.request(`/v1/flows/${segment(flowId)}/draft/upgrade`, {
+			body: JSON.stringify({
+				expectedRevisionId,
+				version: 1
+			}),
+			headers: { "idempotency-key": options.idempotencyKey ?? operationKey("upgrade") },
+			method: "POST"
+		}));
+	}
 	async checkFlow(flowId, revisionId) {
 		return flowCheck(await this.request(`/v1/flows/${segment(flowId)}/revisions/${segment(revisionId)}/check`, {
 			body: JSON.stringify({
@@ -11982,7 +12128,7 @@ var ControlClient = class {
 		const suffix = query == "" ? "" : `?${query}`;
 		return this.connectorRequest(`/v1/connector/actions${suffix}`, "actions", signal, (value) => {
 			const source = record$1(value);
-			exact(source, ["actions", "version"]);
+			requiredFields(source, ["actions", "version"]);
 			if (source.version != 1 || !Array.isArray(source.actions)) return invalidResponse();
 			return source.actions.map(connectorAction);
 		});
@@ -12119,15 +12265,16 @@ function addValueNode(harness, flowId, revisionId, nodeId = "marker", changeId)
 		nodeId
 	}], changeId);
 }
-async function addManualTrigger(harness, flowId, revisionId) {
+async function addStartTrigger(harness, flowId, revisionId) {
 	return changedRevisionId(await json(await changeRequest(harness, flowId, revisionId, [{
 		kind: "graph.node.create",
 		node: {
-			kind: "manual",
+			inputDefs: [],
+			kind: "start",
 			name: "Start"
 		},
 		nodeId: "start"
-	}]), 200, "Add manual trigger"), "Manual trigger Revision");
+	}]), 200, "Add Start node"), "Start Revision");
 }
 function changedRevisionId(change, message) {
 	return requiredString(record(change.revision, `${message} revision`).revisionId, `${message} revisionId`);
@@ -12216,7 +12363,10 @@ var controlApiConformanceCases = [
 			const idempotencyKey = crypto.randomUUID();
 			const created = await api.importFlow(file, { idempotencyKey });
 			equal(dequal(await api.importFlow(file, { idempotencyKey }), created), true, "Import retry must return the same Flow.");
-			equal(dequal(await api.exportFlow(created.flowId), file), true, "Export must retain the graph and Presentation.");
+			equal(dequal(await api.exportFlow(created.flowId), {
+				...file,
+				content: upgradeRevisionContent(file.content)
+			}), true, "Export must upgrade legacy Manual nodes and retain the graph and Presentation.");
 			const editor = await api.getEditor(created.flowId);
 			equal(editor.live.publication == null, true, "Import must not publish.");
 			equal(editor.draft.parentRevisionId == null, true, "Import must create an initial Revision.");
@@ -12323,12 +12473,107 @@ var controlApiConformanceCases = [
 			equal((await api.checkAuthoring(flow.flowId, changed.revision)).revisionId, changed.revision, "Fixed check identity");
 		}
 	},
+	{
+		name: "authors Start parameters and admits their shared call contract",
+		async verify(harness) {
+			const api = client(harness), flow = await api.createFlow("Start parameters");
+			equal((await api.authoringSchema(flow.flowId, { type: "start" })).type, "start", "Start discovery");
+			const created = await api.editAuthoring(flow.flowId, {
+				baseRevision: flow.draftRevisionId,
+				requestId: "start-parameters-create",
+				edits: [{
+					op: "node.add",
+					as: "start",
+					type: "start",
+					name: "Start",
+					config: { inputDefs: {
+						message: {
+							schema: { type: "string" },
+							nullable: false,
+							description: "Original"
+						},
+						note: {
+							schema: { type: "string" },
+							nullable: true
+						}
+					} }
+				}]
+			});
+			const nodeId = created.nodes.start;
+			const changed = await api.editAuthoring(flow.flowId, {
+				baseRevision: created.revision,
+				requestId: "start-parameters-update",
+				edits: [{
+					op: "node.update",
+					node: nodeId,
+					set: { config: { inputDefs: { message: { description: "Call message" } } } }
+				}]
+			});
+			equal(((await api.readAuthoring(flow.flowId, { nodes: [nodeId] })).data.nodes?.[0]?.config)?.inputDefs, {
+				message: {
+					schema: { type: "string" },
+					nullable: false,
+					description: "Call message"
+				},
+				note: {
+					schema: { type: "string" },
+					nullable: true
+				}
+			}, "Local parameter update preserves the contract");
+			const runPath = `/v1/flows/${flow.flowId}/revisions/${changed.revision}/runs`;
+			const run = (outputs, key) => request(harness, runPath, {
+				method: "POST",
+				headers: { "idempotency-key": key },
+				body: JSON.stringify({
+					engineContract,
+					inputs: {},
+					trigger: {
+						nodeId,
+						outputs
+					},
+					version: 2
+				})
+			});
+			for (const [index, outputs] of [
+				{},
+				{ message: 0 },
+				{
+					message: "Hello",
+					extra: true
+				}
+			].entries()) await error(await run(outputs, `start-invalid-${index}`), 400, "run.invalid", "Reject invalid Start parameters");
+			const admitted = await json(await run({ message: "Hello" }, "start-call"), 202, "Admit omitted nullable parameter");
+			equal(await json(await run({ message: "Hello" }, "start-call"), 200, "Replay Start call"), admitted, "Stable Start admission");
+			await error(await run({
+				message: "Hello",
+				note: null
+			}, "start-call"), 409, "run.conflict", "Preserve original request identity before normalization");
+			await json(await run({
+				message: "Hello",
+				note: null
+			}, "start-explicit-null"), 202, "Admit explicit null");
+			equal(((await api.readAuthoring(flow.flowId, {
+				revision: created.revision,
+				nodes: [nodeId]
+			})).data.nodes?.[0]?.config)?.inputDefs, {
+				message: {
+					schema: { type: "string" },
+					nullable: false,
+					description: "Original"
+				},
+				note: {
+					schema: { type: "string" },
+					nullable: true
+				}
+			}, "Fixed Start read preserves old configuration");
+		}
+	},
 	{
 		name: "admits simultaneous retries as one Run and preserves its Trigger identity",
 		async verify(harness) {
 			const flow = await createFlow(harness, "Concurrent Run", "concurrent-run-flow");
 			const flowId = requiredString(flow.flowId, "Flow ID");
-			const revisionId = await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Revision ID"));
+			const revisionId = await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Revision ID"));
 			const submit = (payload = {}) => request(harness, `/v1/flows/${flowId}/revisions/${revisionId}/runs`, {
 				method: "POST",
 				headers: { "idempotency-key": "concurrent-run" },
@@ -12458,6 +12703,7 @@ var controlApiConformanceCases = [
 			equal(created.name, "Control flow", "Created Flow name");
 			equal(created.status, "active", "Created Flow status");
 			equal(record(created.resourceReferences, "Flow resource references").draft, {
+				calledFlowIds: [],
 				variableNames: [],
 				connections: [],
 				errorSourceFlowIds: []
@@ -12629,7 +12875,7 @@ var controlApiConformanceCases = [
 		async verify(harness) {
 			const flow = await createFlow(harness, "Partial Draft", "partial-draft");
 			const flowId = requiredString(flow.flowId, "Partial Flow identity");
-			const revisionId = changedRevisionId(await json(await changeRequest(harness, flowId, await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Partial Draft identity")), [
+			const revisionId = changedRevisionId(await json(await changeRequest(harness, flowId, await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Partial Draft identity")), [
 				{
 					kind: "graph.node.create",
 					nodeId: "other",
@@ -12699,7 +12945,7 @@ var controlApiConformanceCases = [
 		async verify(harness) {
 			const flow = await createFlow(harness, "Run flow", "run-flow");
 			const flowId = requiredString(flow.flowId, "Run Flow flowId");
-			const draftRevisionId = await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Run Flow revisionId"));
+			const draftRevisionId = await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Run Flow revisionId"));
 			equal((await json(await request(harness, `/v1/flows/${flowId}/revisions/${draftRevisionId}/check`, {
 				body: JSON.stringify({
 					engineContract,
@@ -12823,7 +13069,7 @@ var controlApiConformanceCases = [
 		async verify(harness) {
 			const flow = await createFlow(harness, "Wait flow", "wait-flow");
 			const flowId = requiredString(flow.flowId, "Wait Flow flowId");
-			const runPath = `/v1/flows/${flowId}/revisions/${changedRevisionId(await json(await changeRequest(harness, flowId, await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Wait Flow revisionId")), [{
+			const runPath = `/v1/flows/${flowId}/revisions/${changedRevisionId(await json(await changeRequest(harness, flowId, await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Wait Flow revisionId")), [{
 				kind: "graph.node.create",
 				node: {
 					inputDefinitions: [{
@@ -12995,7 +13241,7 @@ var publicationControlApiConformanceCases = [
 		async verify(harness) {
 			const flow = await createFlow(harness, "Enabled flow", "enabled-flow");
 			const flowId = requiredString(flow.flowId, "Flow id");
-			const revisionId = await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Draft id"));
+			const revisionId = await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Draft id"));
 			const change = (enabled, expectedPublicationId) => request(harness, `/v1/flows/${flowId}/enabled`, {
 				method: "PUT",
 				body: JSON.stringify({
@@ -13009,6 +13255,7 @@ var publicationControlApiConformanceCases = [
 			const disabled = await json(await change(false, publicationId), 200, "Disable");
 			equal(disabled.live, {
 				enabled: false,
+				hasStart: true,
 				publicationId,
 				revisionId
 			}, "Disabled summary");
@@ -13040,7 +13287,7 @@ var publicationControlApiConformanceCases = [
 		async verify(harness) {
 			const flow = await createFlow(harness, "Publication flow", "publication-flow");
 			const flowId = requiredString(flow.flowId, "Publication Flow flowId");
-			const draftRevisionId = await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Publication Flow revisionId"));
+			const draftRevisionId = await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Publication Flow revisionId"));
 			equal((await json(await request(harness, `/v1/flows/${flowId}/live`), 200, "Read Live")).status, "not-published", "Initial Live status");
 			const publish = () => publishRequest(harness, flowId, draftRevisionId, null, "publication-first");
 			const completed = await completePublish(harness, await publish(), 202, "Publish Flow");
@@ -13073,7 +13320,7 @@ var publicationControlApiConformanceCases = [
 		async verify(harness) {
 			const flow = await createFlow(harness, "Rollback flow", "rollback-flow");
 			const flowId = requiredString(flow.flowId, "Rollback Flow flowId");
-			const firstRevisionId = await addManualTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Rollback Flow revisionId"));
+			const firstRevisionId = await addStartTrigger(harness, flowId, requiredString(flow.draftRevisionId, "Rollback Flow revisionId"));
 			const layoutApi = client(harness);
 			const initialLayout = await layoutApi.getPresentation(flowId);
 			const publishedLayout = await json(await request(harness, `/v1/flows/${flowId}/presentation`, {
@@ -13434,7 +13681,7 @@ function selectableConnectorAccessControlApiConformanceCases(fixture) {
 			equal(record(binding, "Selected Connector access binding").connectionDisplayName, fixture.connectionDisplayName, "Selected Provider access binding connection display name");
 			equal(record(binding, "Selected Connector access binding").permissionGroupName, fixture.permissionGroupName, "Selected Provider access binding permission group name");
 			const selectedDigest = requiredString(selected.sharedAccessDigest, "Selected Connector access digest");
-			const revisionId = await addManualTrigger(harness, flowId, requiredString(created.draftRevisionId, "Draft Revision ID"));
+			const revisionId = await addStartTrigger(harness, flowId, requiredString(created.draftRevisionId, "Draft Revision ID"));
 			equal((await json(await request(harness, `/v1/flows/${flowId}/revisions/${revisionId}/runs`, {
 				body: JSON.stringify({
 					engineContract,