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

package/dist/common/mcp.js

@@ -6045,6 +6045,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(),
@@ -6202,6 +6203,11 @@ var managedFields = object({
 				messageHandle: text,
 				inputs: record$2(text, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text,
+			revisionId: text
 		})
 	])
 });
@@ -6310,6 +6316,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$2(text, never()),
@@ -6342,6 +6354,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger,
 		kind: literal("error"),
@@ -6421,7 +6438,7 @@ var module = object({
 	imports: strings$1,
 	source: text
 });
-var document = preprocess(rejectRetiredDefinitions, object({
+var document = preprocess(normalizeDocument, object({
 	bindings: record$2(text, binding$1),
 	graph
 }));
@@ -6430,7 +6447,9 @@ var revision = object({
 		literal(2),
 		literal(4),
 		literal(5),
-		literal(6)
+		literal(6),
+		literal(7),
+		literal(8)
 	]),
 	document,
 	modules: record$2(text, module)
@@ -6439,13 +6458,19 @@ revision.extend({
 	kind: literal("open-flow-flow-revision"),
 	version: literal(1)
 });
-function rejectRetiredDefinitions(value) {
+function normalizeDocument(value) {
 	const candidate = record$1(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$1(record$1(candidate.graph).nodes)).some((candidateNode) => Object.hasOwn(record$1(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$1(record$1(candidate.graph).nodes)).some((candidateNode) => record$1(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$1(record$1(candidate.graph).nodes)).some((candidateNode) => record$1(candidateNode).kind == "start" && Object.hasOwn(record$1(candidateNode), "parameters"))) throw new TypeError("Legacy Start.parameters is unsupported; configure node.inputDefs.");
 	return value;
 }
 function record$1(value) {
@@ -6611,6 +6636,8 @@ 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.");
 }
@@ -9440,7 +9467,9 @@ var id$2 = string$1().min(1);
 var json$2 = json$4();
 var patch = record$2(id$2, json$2);
 var type = _enum([
-	"manual",
+	"start",
+	"outputs",
+	"workflow",
 	"webhook",
 	"cron",
 	"error",
@@ -9512,6 +9541,12 @@ var field = strictObject({
 	description: string$1().optional()
 });
 var inputFields = record$2(id$2, 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$2(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$2(id$2, field.extend({
+	schema: json$2,
+	nullable: boolean()
+}));
 var outputFields = record$2(id$2, field).describe("Code return fields by name. Omitted schema accepts any JSON; omitted nullable is true.");
 var expression = strictObject({
 	left: operand,
@@ -9525,7 +9560,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 }),
@@ -9596,6 +9633,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
@@ -9706,7 +9747,7 @@ var authoringSearchResponse = object({
 	revision: id$2,
 	data: object({
 		matches: array(object({
-			node: id$2,
+			node: id$2.optional(),
 			field: id$2,
 			line: int().optional(),
 			excerpt: string$1()
@@ -9725,6 +9766,43 @@ var resultQuerySchema = strictObject({
 	maxBytes: number().int().min(1).max(1048576).default(15e3)
 });
 //#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/errors.ts
 var controlErrorCode = {
 	authenticationRequired: "authentication.required",
@@ -9802,6 +9880,10 @@ function record(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))) {
@@ -9869,7 +9951,7 @@ function publishOperation(value) {
 	if (source.version != 1) return invalidResponse();
 	switch (status) {
 		case "pending":
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"operationId",
@@ -9883,7 +9965,7 @@ function publishOperation(value) {
 				status
 			};
 		case "succeeded":
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"operationId",
@@ -9899,7 +9981,7 @@ function publishOperation(value) {
 				status
 			};
 		case "failed": {
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"issue",
@@ -9911,7 +9993,7 @@ function publishOperation(value) {
 			]);
 			const issue = record(source.issue);
 			const nodeId = issue.nodeId;
-			exact(issue, [
+			requiredFields(issue, [
 				"code",
 				"message",
 				...nodeId == null ? [] : ["nodeId"]
@@ -10152,43 +10234,48 @@ var metadata = {
 var binding = unknown().transform(triggerBinding);
 var provider = {
 	provider: string$1().min(1),
-	inputs: record$2(string$1(), discriminatedUnion("kind", [strictObject({
+	inputs: record$2(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"),
@@ -10201,9 +10288,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: [],
@@ -10215,8 +10303,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,
@@ -10232,7 +10323,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;
@@ -10545,7 +10636,7 @@ function connectorAccessCandidatesBatch(value, providerIds) {
 }
 function connection(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		...Object.hasOwn(source, "providerAccountId") ? ["providerAccountId"] : [],
 		...Object.hasOwn(source, "alias") ? ["alias"] : [],
 		...Object.hasOwn(source, "builtInAccount") ? ["builtInAccount"] : [],
@@ -10574,7 +10665,7 @@ function port(value, input = false) {
 	const source = record(value);
 	const description = source.description;
 	const hasValue = input && Object.hasOwn(source, "value");
-	exact(source, [
+	requiredFields(source, [
 		"jsonSchema",
 		"nullable",
 		...description == null ? [] : ["description"],
@@ -10599,7 +10690,7 @@ function connectorActionMetadata(value) {
 	const source = record(value);
 	const homepageUrl = source.homepageUrl;
 	const icon = source.icon;
-	exact(source, [
+	requiredFields(source, [
 		"actionId",
 		...Object.hasOwn(source, "operationType") ? ["operationType"] : [],
 		...Object.hasOwn(source, "inputSchema") ? ["inputSchema"] : [],
@@ -10650,7 +10741,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",
@@ -10674,7 +10765,7 @@ function connectorProvider(value) {
 var id$1 = 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$1,
 	revision: int().positive(),
@@ -10692,7 +10783,7 @@ var eventSourceSchema = strictObject({
 	verifiedAt: string$1().nullable(),
 	lastReceivedAt: string$1().nullable(),
 	updatedAt: string$1(),
-	consumers: array(strictObject({
+	consumers: array(object({
 		flowId: id$1,
 		flowName: string$1(),
 		triggerNodeId: id$1
@@ -10702,7 +10793,7 @@ function decodeEventSource(value) {
 	return eventSourceSchema.parse(value);
 }
 function decodeEventSources(value) {
-	return strictObject({
+	return object({
 		version: literal(1),
 		sources: array(eventSourceSchema),
 		teamId: id$1.nullable().optional()
@@ -10724,7 +10815,7 @@ function isUiLanguage(value) {
 //#region src/control/common/triggerCatalog.ts
 function decodeTriggerCatalog(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"version",
 		"locale",
 		"definitions",
@@ -10738,7 +10829,7 @@ function decodeTriggerCatalog(value) {
 	const display = Object.fromEntries(definitions.map((definition) => {
 		const { key } = definition;
 		const copy = record(entries[key]);
-		exact(copy, [
+		requiredFields(copy, [
 			"configInputs",
 			"configInputLabels",
 			"displayName",
@@ -10776,7 +10867,7 @@ function labels(value, handles) {
 //#endregion
 //#region src/control/common/results.ts
 var json$1 = json$4();
-var entry = strictObject({
+var entry = object({
 	pointer: string$1(),
 	type: _enum([
 		"object",
@@ -10795,25 +10886,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,
@@ -10890,7 +10981,7 @@ function connectorProvidersQuery(flowId, locale) {
 		path: `/v1/connector/providers${parameters ? `?${parameters}` : ""}`,
 		decode: (value) => {
 			const source = record(value);
-			exact(source, ["providers", "version"]);
+			requiredFields(source, ["providers", "version"]);
 			if (source.version != 1 || !Array.isArray(source.providers)) return invalidResponse();
 			return source.providers.map(connectorProvider);
 		}
@@ -10905,7 +10996,7 @@ function connectorActionQuery(actionId, flowId, locale) {
 		path: `/v1/connector/actions/${encodeURIComponent(actionId)}${parameters ? `?${parameters}` : ""}`,
 		decode: (value) => {
 			const source = record(value);
-			exact(source, ["action", "version"]);
+			requiredFields(source, ["action", "version"]);
 			if (source.version != 1) return invalidResponse();
 			return connectorAction(source.action);
 		}
@@ -10916,7 +11007,7 @@ function allConnectorConnectionsQuery(flowId) {
 		path: `/v1/connector/connections${scope(flowId)}`,
 		decode: (value) => {
 			const source = record(value);
-			exact(source, ["connections", "version"]);
+			requiredFields(source, ["connections", "version"]);
 			if (source.version != 1 || !Array.isArray(source.connections)) return invalidResponse();
 			return source.connections.map(connection);
 		}
@@ -10927,7 +11018,7 @@ function connectorConnectionsQuery(serviceId, flowId) {
 		path: `/v1/connector/connections/${encodeURIComponent(serviceId)}${scope(flowId)}`,
 		decode: (value) => {
 			const source = record(value);
-			exact(source, [
+			requiredFields(source, [
 				"connections",
 				"serviceId",
 				"version"
@@ -10952,6 +11043,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) => {
@@ -10982,10 +11074,11 @@ function flow$1(value) {
 	if (source.version != 1) return invalidResponse();
 	if (status != "active" && status != "retiring") return invalidResponse();
 	const target = source.live == null ? void 0 : record(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)
 		} },
@@ -11016,7 +11109,7 @@ function flowPage(value) {
 }
 function variable(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"name",
 		"updatedAt",
 		"value",
@@ -11036,6 +11129,15 @@ function variable(value) {
 		version: 1
 	};
 }
+function variableListItem(value) {
+	const { referenceCount, ...fields } = record(value);
+	const count = integer(referenceCount);
+	if (count < 0) return invalidResponse();
+	return {
+		...variable(fields),
+		referenceCount: count
+	};
+}
 function errorListener(value) {
 	const source = record(value);
 	if (typeof source.enabled != "boolean") return invalidResponse();
@@ -11049,17 +11151,13 @@ function errorListener(value) {
 }
 function variableReferences(input) {
 	const source = record(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(value);
-			exact(item, [
+			requiredFields(item, [
 				"flowId",
 				"flowName",
 				"draft",
@@ -11068,7 +11166,7 @@ function variableReferences(input) {
 			if (typeof item.draft != "boolean") return invalidResponse();
 			const live = item.live === null ? null : record(item.live);
 			if (live != null) {
-				exact(live, ["publicationId", "enabled"]);
+				requiredFields(live, ["publicationId", "enabled"]);
 				if (typeof live.enabled != "boolean") return invalidResponse();
 			}
 			return {
@@ -11080,20 +11178,6 @@ function variableReferences(input) {
 					enabled: live.enabled
 				}
 			};
-		}),
-		unknown: source.unknown.map((value) => {
-			const item = record(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
-			};
 		})
 	};
 }
@@ -11180,7 +11264,7 @@ function run$1(value) {
 }
 function runWaiting(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"actions",
 		"expiresAt",
 		"nodeId",
@@ -11199,6 +11283,15 @@ function runWaiting(value) {
 		waitingSince: string(source.waitingSince)
 	};
 }
+function workflowIdentity(value) {
+	const ref = record(value);
+	return {
+		flowId: string(ref.flowId),
+		runId: string(ref.runId),
+		nodeId: string(ref.nodeId),
+		executionId: string(ref.executionId)
+	};
+}
 function runDetails(value) {
 	const source = record(value);
 	const summary = run$1(source);
@@ -11206,20 +11299,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(item).status === null ? null : runStatus(record(item).status) })) },
 		closureDigest: string(source.closureDigest),
 		engineContract: string(source.engineContract),
 		engineDigest: string(source.engineDigest),
@@ -11270,7 +11367,7 @@ function runCancellation(value) {
 }
 function waitResolution(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"action",
 		"comment",
 		"resolutionAccepted",
@@ -11487,7 +11584,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,
@@ -11614,14 +11711,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(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);
 	}
@@ -11648,13 +11745,24 @@ var ControlClient = class {
 	}
 	async listVariables() {
 		const source = record(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 }));
 	}
@@ -11669,7 +11777,7 @@ var ControlClient = class {
 	}
 	async deleteVariable(name) {
 		const source = record(await this.request(`/v1/variables/${segment(name)}`, { method: "DELETE" }));
-		exact(source, ["version"]);
+		requiredFields(source, ["version"]);
 		if (source.version != 1) return invalidResponse();
 	}
 	async exportFlow(flowId) {
@@ -11711,7 +11819,7 @@ var ControlClient = class {
 				command
 			})
 		}));
-		exact(source, [
+		requiredFields(source, [
 			"version",
 			"flowId",
 			"broadcast"
@@ -11851,11 +11959,11 @@ var ControlClient = class {
 	}
 	async listTriggerConfigOptions(flowId, nodeId, field, signal) {
 		const source = record(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(value);
-			exact(item, [
+			requiredFields(item, [
 				"value",
 				"label",
 				...item.color == null ? [] : ["color"]
@@ -11874,7 +11982,7 @@ var ControlClient = class {
 	}
 	async listConnectorTeams(signal) {
 		const source = record(await this.request("/v1/connector/teams", { signal }));
-		exact(source, [
+		requiredFields(source, [
 			"enabled",
 			"teams",
 			"version"
@@ -11884,7 +11992,7 @@ var ControlClient = class {
 			enabled: source.enabled,
 			teams: source.teams.map((value) => {
 				const team = record(value);
-				exact(team, [
+				requiredFields(team, [
 					"id",
 					"name",
 					"systemCreated"
@@ -11997,7 +12105,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));
@@ -12059,6 +12167,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({
@@ -12201,7 +12319,7 @@ var ControlClient = class {
 		const suffix = query == "" ? "" : `?${query}`;
 		return this.connectorRequest(`/v1/connector/actions${suffix}`, "actions", signal, (value) => {
 			const source = record(value);
-			exact(source, ["actions", "version"]);
+			requiredFields(source, ["actions", "version"]);
 			if (source.version != 1 || !Array.isArray(source.actions)) return invalidResponse();
 			return source.actions.map(connectorAction);
 		});
@@ -12337,7 +12455,8 @@ var mcpConformanceCases = [
 				kind: "graph.node.create",
 				nodeId: "start",
 				node: {
-					kind: "manual",
+					inputDefs: [],
+					kind: "start",
 					name: "Start"
 				}
 			}]);
@@ -12518,7 +12637,7 @@ var mcpTools = {
 		expectedPublicationId: id,
 		enabled: boolean()
 	}), false),
-	flow_run: tool("Start a Run and return its runId. For draft supply flowId and revisionId; for live supply publicationId. Always fix the source, Trigger and idempotencyKey. Poll run_get for completion.", discriminatedUnion("source", [strictObject({
+	flow_run: tool("Start a Run and return its runId. For draft supply flowId and revisionId; for live supply publicationId and select a Start node. Only draft Runs may simulate other Triggers. Always fix the source, Trigger and idempotencyKey. Start parameters come from the Start node’s flow_read config.inputDefs and are supplied in trigger.outputs; required parameters must be present, omitted nullable parameters become null, and unknown parameters are rejected. Poll run_get for completion.", discriminatedUnion("source", [strictObject({
 		source: literal("draft"),
 		flowId: flow,
 		revisionId: id,
@@ -12608,7 +12727,7 @@ var mcpTools = {
 		flowId: flow.optional()
 	}), true),
 	event_source_list: tool("List independent Feishu event sources, including Team, Connection, event types, enabled and verification status. Inspect consumers for Flows actually using each source.", strictObject({}), true),
-	trigger_search: tool("Search provider Trigger summaries; omit query to list all. Flow trigger instances are in flow_read. Manual, Webhook and Cron are built-in node kinds described by flow_schema.", strictObject({ query: string$1().trim().min(1).max(256).optional() }), true),
+	trigger_search: tool("Search provider Trigger summaries; omit query to list all. Flow trigger instances are in flow_read. Start, Webhook and Cron are built-in node kinds described by flow_schema.", strictObject({ query: string$1().trim().min(1).max(256).optional() }), true),
 	trigger_get: tool("Read a provider Trigger definition before creating its node.", strictObject({ key: id }), true)
 };
 //#endregion