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

package/dist/common/mcp.js

@@ -6037,6 +6037,7 @@ function webhookSupportsBody(method) {
 	return method !== "GET";
 }
 var text = string$1();
+var actionConnection = text.describe("Account selection: omit while unconfigured; use an account ID to select it; use \"\" to explicitly defer configuration. Deferred Actions fail if called; deferred Agent tools are excluded from the callable tool set. Not supported by Triggers.");
 var json$3 = json$4();
 var strings$1 = array(text);
 var port$1 = object({
@@ -6045,6 +6046,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(),
@@ -6091,7 +6093,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6151,7 +6153,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -6191,17 +6193,22 @@ var managedFields = object({
 				name: text,
 				description: text,
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				approval: boolean(),
 				inputs: array(input.extend({ source: agentInput }))
 			})),
 			notification: object({
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text,
 				inputs: record$2(text, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text,
+			revisionId: text
 		})
 	])
 });
@@ -6310,6 +6317,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 +6355,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger,
 		kind: literal("error"),
@@ -6421,7 +6439,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 +6448,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 +6459,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 +6637,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 +9468,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 +9542,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 +9561,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 +9634,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 +9748,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 +9767,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 +9881,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 +9952,7 @@ function publishOperation(value) {
 	if (source.version != 1) return invalidResponse();
 	switch (status) {
 		case "pending":
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"operationId",
@@ -9883,7 +9966,7 @@ function publishOperation(value) {
 				status
 			};
 		case "succeeded":
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"operationId",
@@ -9899,7 +9982,7 @@ function publishOperation(value) {
 				status
 			};
 		case "failed": {
-			exact(source, [
+			requiredFields(source, [
 				"createdAt",
 				"flowId",
 				"issue",
@@ -9911,7 +9994,7 @@ function publishOperation(value) {
 			]);
 			const issue = record(source.issue);
 			const nodeId = issue.nodeId;
-			exact(issue, [
+			requiredFields(issue, [
 				"code",
 				"message",
 				...nodeId == null ? [] : ["nodeId"]
@@ -10152,43 +10235,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 +10289,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 +10304,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 +10324,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 +10637,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 +10666,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 +10691,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 +10742,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 +10766,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 +10784,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 +10794,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 +10816,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 +10830,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 +10868,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 +10887,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 +10982,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 +10997,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 +11008,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 +11019,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 +11044,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 +11075,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)
 		} },
@@ -11000,6 +11094,15 @@ function flow$1(value) {
 		version: 1
 	};
 }
+function flowListItem(value) {
+	const source = record(value);
+	const referenceCount = integer(source.referenceCount);
+	if (referenceCount < 0) return invalidResponse();
+	return {
+		...flow$1(source),
+		referenceCount
+	};
+}
 function flowPage(value) {
 	const source = record(value);
 	if (source.version != 1 || !Array.isArray(source.flows)) return invalidResponse();
@@ -11009,14 +11112,14 @@ function flowPage(value) {
 	if (total != null && !Number.isSafeInteger(total)) return invalidResponse();
 	return {
 		...nextCursor == null ? {} : { nextCursor },
-		flows: source.flows.map(flow$1),
+		flows: source.flows.map(flowListItem),
 		...total == null ? {} : { total },
 		version: 1
 	};
 }
 function variable(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"name",
 		"updatedAt",
 		"value",
@@ -11036,6 +11139,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 +11161,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 +11176,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 +11188,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 +11274,7 @@ function run$1(value) {
 }
 function runWaiting(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"actions",
 		"expiresAt",
 		"nodeId",
@@ -11199,6 +11293,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 +11309,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 +11377,7 @@ function runCancellation(value) {
 }
 function waitResolution(value) {
 	const source = record(value);
-	exact(source, [
+	requiredFields(source, [
 		"action",
 		"comment",
 		"resolutionAccepted",
@@ -11487,7 +11594,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 +11721,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 +11755,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 +11787,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 +11829,7 @@ var ControlClient = class {
 				command
 			})
 		}));
-		exact(source, [
+		requiredFields(source, [
 			"version",
 			"flowId",
 			"broadcast"
@@ -11851,11 +11969,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 +11992,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 +12002,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 +12115,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 +12177,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 +12329,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 +12465,8 @@ var mcpConformanceCases = [
 				kind: "graph.node.create",
 				nodeId: "start",
 				node: {
-					kind: "manual",
+					inputDefs: [],
+					kind: "start",
 					name: "Start"
 				}
 			}]);
@@ -12446,7 +12575,7 @@ var mutationKey = id.max(256).describe("Stable identity for this mutation. Retry
 var pageLimit = int().min(1).max(100).default(50);
 var flow = id.describe("Exact Flow ID returned by flow_list or flow_create.");
 var run = id.describe("Exact Run ID returned by flow_run or run_list.");
-var mcpInstructions = "Use flow_list, flow_read and flow_search to inspect root workflows. Read node type schemas with flow_schema. Use flow_edit with the observed baseRevision and a stable requestId. Node edits affect only the selected node. Text edits require exactly one match. Execution edges and input sources are independent. Legacy Subflow content is unsupported. Edits can save incomplete drafts; inspect returned diagnostics and use flow_check before running. Use flow_check before flow_run. Select an explicit Trigger node ID and fixed revision or publication. A new Flow has no Trigger until you add one. Before adding a Feishu Trigger, use event_source_list and compare its Connection IDs with connector_connections in the Flow scope. If no source is available, create and verify one in Workbench. Use flow_publish to publish a fixed Revision, then poll flow_publish_status until succeeded or failed. Use flow_live to inspect current online entries after publication. Use flow_set_enabled to enable or disable the observed Live publication. flow_run returns an accepted Run, not its final result. Find Runs with run_list, poll run_get and use run_result after terminal. Resolve a waiting Run only with an explicit run_resolve_wait action allowed by run_get. Use run_results and run_result_read to inspect stored Agent tool results; these are separate from the terminal Run result. Retry flow_edit with identical arguments and the same requestId. Retry flow_create, flow_import, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. Canvas commands are transient broadcasts without execution confirmation; never automatically retry flow_canvas because pan is relative. Other mutations use the same resource identity and arguments when retrying. Cancel a Run explicitly with run_cancel. Use nextCursor and nextAfter to read subsequent pages. Connector-backed deployments may require a Team; inspect connector_teams before creating a Flow.";
+var mcpInstructions = "Keep generated Flow and node names short enough to scan on the canvas. Aim for 2–4 English words or 4–8 Chinese characters, using the user's language unless the workflow has an established naming language. Name a Flow by its main purpose and a node by its action and object, such as \"AI Trend Digest\", \"Fetch trends\", \"Verify sources\", or \"发布文章\". Keep only qualifiers needed to distinguish similar nodes. Put detailed behavior in descriptions; avoid sentences, repeated workflow context, and obscure abbreviations. Preserve names explicitly supplied by the user, and do not rename unrelated existing nodes. Use flow_list, flow_read and flow_search to inspect root workflows. Read node type schemas with flow_schema. Use flow_edit with the observed baseRevision and a stable requestId. Node edits affect only the selected node. Text edits require exactly one match. Execution edges and input sources are independent. Legacy Subflow content is unsupported. Edits can save incomplete drafts; inspect returned diagnostics and use flow_check before running. Use flow_check before flow_run. Select an explicit Trigger node ID and fixed revision or publication. A new Flow has no Trigger until you add one. Before adding a Feishu Trigger, use event_source_list and compare its Connection IDs with connector_connections in the Flow scope. If no source is available, create and verify one in Workbench. Use flow_publish to publish a fixed Revision, then poll flow_publish_status until succeeded or failed. Use flow_live to inspect current online entries after publication. Use flow_set_enabled to enable or disable the observed Live publication. flow_run returns an accepted Run, not its final result. Find Runs with run_list, poll run_get and use run_result after terminal. Resolve a waiting Run only with an explicit run_resolve_wait action allowed by run_get. Use run_results and run_result_read to inspect stored Agent tool results; these are separate from the terminal Run result. Retry flow_edit with identical arguments and the same requestId. Retry flow_create, flow_import, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. Canvas commands are transient broadcasts without execution confirmation; never automatically retry flow_canvas because pan is relative. Other mutations use the same resource identity and arguments when retrying. Cancel a Run explicitly with run_cancel. Use nextCursor and nextAfter to read subsequent pages. Connector-backed deployments may require a Team; inspect connector_teams before creating a Flow.";
 function tool(description, schema, readOnly, idempotent = true) {
 	return {
 		description,
@@ -12518,7 +12647,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 +12737,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