@oomol-lab/open-flow 0.1.0-beta.55 → 0.1.0-beta.57

package/dist/common/mcp.js

@@ -2780,6 +2780,9 @@ function handlePipeResult(left, next, ctx) {
 		issues: left.issues
 	}, ctx);
 }
+var $ZodPreprocess = /*@__PURE__*/ $constructor("$ZodPreprocess", (inst, def) => {
+	$ZodPipe.init(inst, def);
+});
 var $ZodReadonly = /*@__PURE__*/ $constructor("$ZodReadonly", (inst, def) => {
 	$ZodType.init(inst, def);
 	defineLazyInternal(inst, "propValues", (zod) => zod.def.innerType._zod.propValues);
@@ -5580,7 +5583,7 @@ var ZodRecord = /*@__PURE__*/ $constructor("ZodRecord", (inst, def) => {
 	inst.keyType = def.keyType;
 	inst.valueType = def.valueType;
 });
-function record$1(keyType, valueType, params) {
+function record$2(keyType, valueType, params) {
 	if (!valueType || !valueType._zod) return new ZodRecord({
 		type: "record",
 		keyType: string$1(),
@@ -5789,6 +5792,10 @@ function pipe(in_, out) {
 		out
 	});
 }
+var ZodPreprocess = /*@__PURE__*/ $constructor("ZodPreprocess", (inst, def) => {
+	ZodPipe.init(inst, def);
+	$ZodPreprocess.init(inst, def);
+});
 var ZodReadonly = /*@__PURE__*/ $constructor("ZodReadonly", (inst, def) => {
 	$ZodReadonly.init(inst, def);
 	ZodType.init(inst, def);
@@ -5824,7 +5831,7 @@ function refine(fn, _params = {}) {
 function superRefine(fn, params) {
 	return /* @__PURE__ */ _superRefine(fn, params);
 }
-function json$3(params) {
+function json$4(params) {
 	const jsonSchema = lazy(() => {
 		return union([
 			string$1(params),
@@ -5832,11 +5839,18 @@ function json$3(params) {
 			boolean(),
 			_null(),
 			array(jsonSchema),
-			record$1(string$1(), jsonSchema)
+			record$2(string$1(), jsonSchema)
 		]);
 	});
 	return jsonSchema;
 }
+function preprocess(fn, schema) {
+	return new ZodPreprocess({
+		type: "pipe",
+		in: transform(fn),
+		out: schema
+	});
+}
 //#endregion
 //#region ../../node_modules/.bun/dequal@2.0.3/node_modules/dequal/lite/index.mjs
 var has = Object.prototype.hasOwnProperty;
@@ -5881,9 +5895,9 @@ var waitCommentSchema = string$1().trim().refine((value) => [...value].length <=
 //#region src/openapi/common/authBindings.ts
 /** Never allow credentials to enter a Revision as literal node inputs. */
 function assertOpenApiAuthBindings(document) {
-	for (const graph of [document.graph, ...Object.values(document.subflows).map((subflow) => subflow.graph)]) for (const node of Object.values(graph.nodes)) {
-		if (node.kind != "task" || node.taskId == null || document.tasks[node.taskId]?.executor.kind != "openapi") continue;
-		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && (mapping.kind == "value" || mapping.kind == "sources" && mapping.sources.some((source) => source.kind == "flow"))) throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+	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
@@ -6306,7 +6320,7 @@ var ExpressionKind = Object.freeze({
 });
 //#endregion
 //#region src/json-schema-subset/expression/expression.ts
-var expression = (delegate) => (e1, e2) => {
+var expression$1 = (delegate) => (e1, e2) => {
 	const rootNode = {
 		parent: null,
 		swapped: false,
@@ -8294,7 +8308,7 @@ function checkWithResult(extendsContext, schema1, schema2) {
 	const describe = describer();
 	const equals = schemaEqualsChecker(extendsContext);
 	context.isEquals = wrapEqualsCheckerWithCache(isDeepEquals);
-	context.calculate = expression({
+	context.calculate = expression$1({
 		describe,
 		equals,
 		calculate,
@@ -8533,7 +8547,7 @@ var isObject = (x) => x !== null && typeof x === "object";
 var isPlainObject = (x) => isObject(x) && !isArray(x);
 var toPlainObject = (x) => isPlainObject(x) ? x : void 0;
 //#endregion
-//#region src/manifest/common/schemaComparer.ts
+//#region src/flow/common/schemaComparer.ts
 function isStringLikeSchema(value) {
 	return toPlainObject(value)?.type === "string";
 }
@@ -8763,46 +8777,37 @@ var webhookMethods = [
 	"DELETE"
 ];
 var text = string$1();
-var json$2 = json$3();
-var strings = array(text);
+var json$3 = json$4();
+var strings$1 = array(text);
 var port$1 = object({
 	description: text.optional(),
-	jsonSchema: json$2,
+	jsonSchema: json$3,
 	nullable: boolean(),
 	handle: text
 });
-var input = port$1.extend({ value: json$2.optional() });
+var input = port$1.extend({ value: json$3.optional() });
 var group = object({
 	collapsed: boolean().optional(),
 	group: text
 });
-var nodeSource = object({
+var source = union([object({
 	kind: literal("node"),
 	nodeId: text,
 	output: text,
 	field: text.optional()
-});
-var flowSource = object({
-	kind: literal("flow"),
-	input: text
-});
-var source = union([
-	nodeSource,
-	flowSource,
-	object({
-		kind: literal("binding"),
-		bindingId: text
-	})
-]);
+}), object({
+	kind: literal("binding"),
+	bindingId: text
+})]);
 var fixedInput = union([object({ kind: literal("unset") }), object({
 	kind: literal("value"),
-	value: json$2
+	value: json$3
 })]);
 var mapping = union([fixedInput, object({
 	kind: literal("sources"),
 	sources: array(source)
 })]);
-var inputs = record$1(text, mapping);
+var inputs = record$2(text, mapping);
 var ports$1 = {
 	inputs: array(union([input, group])),
 	outputs: array(union([port$1, group]))
@@ -8847,7 +8852,7 @@ var inline = object({
 });
 var agentValue = union([object({
 	kind: literal("value"),
-	value: json$2
+	value: json$3
 }), object({
 	kind: literal("input"),
 	input: text
@@ -8876,10 +8881,10 @@ var decisionQuestion = discriminatedUnion("type", [
 		name: text,
 		instructions: text,
 		type: literal("score"),
-		criteria: strings
+		criteria: strings$1
 	})
 ]);
-var managed = object({
+var managedFields = object({
 	...ports$1,
 	name: text,
 	executor: union([
@@ -8894,7 +8899,7 @@ var managed = object({
 			method: text,
 			path: text,
 			serverUrl: text,
-			document: json$2,
+			document: json$3,
 			auth: array(object({
 				id: text,
 				type: _enum([
@@ -8930,17 +8935,20 @@ var managed = object({
 				inputs: array(input.extend({ source: agentInput }))
 			})),
 			notification: object({
-				taskId: text,
+				action: text,
+				connectionId: text.optional(),
+				inputDefinitions: array(input),
 				messageHandle: text,
-				inputs: record$1(text, agentValue)
+				inputs: record$2(text, agentValue)
 			}).optional()
 		})
 	])
-}).transform(limitDecisionTask);
-var operand = union([object({
+});
+var managed = managedFields.transform(limitDecisionTask);
+var operand$1 = union([object({
 	kind: literal("value"),
-	value: json$2.optional(),
-	jsonSchema: json$2.optional()
+	value: json$3.optional(),
+	jsonSchema: json$3.optional()
 }), object({
 	kind: literal("source"),
 	source
@@ -8951,7 +8959,7 @@ var condition = {
 		description: text.optional(),
 		output: text,
 		groups: array(object({ expressions: array(object({
-			left: operand,
+			left: operand$1,
 			operator: _enum([
 				"!=",
 				"<",
@@ -8974,7 +8982,7 @@ var condition = {
 				"notHasValue",
 				"startsWith"
 			]),
-			right: operand.optional()
+			right: operand$1.optional()
 		})) }))
 	}))
 };
@@ -8984,10 +8992,10 @@ var wait = {
 };
 var webhookOptions = object({
 	allowedMethods: never().optional(),
-	allowedOrigins: strings.optional(),
+	allowedOrigins: strings$1.optional(),
 	noResponseBody: never().optional(),
 	responseData: text.optional(),
-	responseHeaders: record$1(text, text).optional(),
+	responseHeaders: record$2(text, text).optional(),
 	responseStatusCode: number().int().min(200).max(599).optional()
 });
 var webhook = {
@@ -9043,7 +9051,7 @@ var base = {
 var node = union([
 	object({
 		...base,
-		inputs: record$1(text, never()),
+		inputs: record$2(text, never()),
 		kind: literal("condition"),
 		...condition
 	}),
@@ -9053,21 +9061,10 @@ var node = union([
 		kind: literal("value"),
 		values: array(input)
 	}),
-	object({
-		...base,
-		kind: literal("subflow"),
-		subflowId: text
-	}),
 	object({
 		...base,
 		kind: literal("task"),
-		task: inline,
-		additionalInputs: array(input).optional()
-	}),
-	object({
-		...base,
-		kind: literal("task"),
-		taskId: text,
+		task: union([inline, managed]),
 		additionalInputs: array(input).optional()
 	}),
 	strictObject({
@@ -9103,7 +9100,7 @@ var node = union([
 		...trigger,
 		kind: literal("poll"),
 		connectionId: text.min(1).optional(),
-		config: record$1(text, fixedInput),
+		config: record$2(text, fixedInput),
 		definition: object({
 			...definition,
 			type: literal("poll")
@@ -9114,7 +9111,7 @@ var node = union([
 		...trigger,
 		kind: literal("integration"),
 		connectionId: text.min(1).optional(),
-		config: record$1(text, fixedInput),
+		config: record$2(text, fixedInput),
 		definition: object({
 			...definition,
 			type: literal("integration"),
@@ -9122,10 +9119,25 @@ var node = union([
 		})
 	})
 ]);
-var target = union([object({ kind: literal("flow") }), object({
-	kind: literal("subflow"),
-	id: text
-})]);
+/** Configuration schemas shared by the node authoring boundary. */
+var authoringDefinitionSchemas = {
+	input,
+	port: port$1,
+	ports: ports$1,
+	condition: strictObject(condition),
+	wait: strictObject(wait),
+	webhook: strictObject(webhook),
+	schedule: triggerScheduleSchema,
+	capabilities: array(capability),
+	connector: managedFields.shape.executor.options[0].omit({ kind: true }).strict(),
+	openapi: managedFields.shape.executor.options[1].omit({ kind: true }).strict(),
+	decision: managedFields.shape.executor.options[2].omit({ kind: true }).strict(),
+	llm: managedFields.shape.executor.options[3].omit({ kind: true }).strict(),
+	agent: managedFields.shape.executor.options[4].omit({
+		kind: true,
+		notification: true
+	}).strict()
+};
 var edge = object({
 	source: text,
 	target: text,
@@ -9133,15 +9145,10 @@ var edge = object({
 });
 var at = {
 	nodeId: text,
-	target
+	target: never().optional()
 };
-var subflow = object({
-	name: text,
-	inputs: array(input),
-	outputs: array(port$1.extend({ sources: array(union([nodeSource, flowSource])) }))
-});
 var graph = object({
-	nodes: record$1(text, node),
+	nodes: record$2(text, node),
 	edges: array(edge).default([])
 });
 var binding = object({
@@ -9150,32 +9157,43 @@ var binding = object({
 });
 var module = object({
 	name: text,
-	imports: strings,
+	imports: strings$1,
 	source: text
 });
-var document = object({
-	bindings: record$1(text, binding),
-	graph,
-	subflows: record$1(text, subflow.extend({ graph })),
-	tasks: record$1(text, managed)
-});
+var document = preprocess(rejectRetiredDefinitions, object({
+	bindings: record$2(text, binding),
+	graph
+}));
 var revision = object({
 	modelVersion: union([
 		literal(2),
 		literal(4),
-		literal(5)
+		literal(5),
+		literal(6)
 	]),
 	document,
-	modules: record$1(text, module)
+	modules: record$2(text, module)
 });
 revision.extend({
 	kind: literal("open-flow-flow-revision"),
 	version: literal(1)
 });
+function rejectRetiredDefinitions(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.");
+	return value;
+}
+function record$1(value) {
+	return value != null && typeof value == "object" && !Array.isArray(value) ? value : {};
+}
 function decodeRevisionContent(value) {
 	checkJsonDepth(value);
 	const content = revision.parse(value);
-	checkErrorModelVersion(content);
+	checkModelVersion(content);
 	assertOpenApiAuthBindings(content.document);
 	return content;
 }
@@ -9196,17 +9214,22 @@ var shapes = {
 		value: text
 	},
 	"graph.edge.connect": {
-		target,
-		edge
+		edge,
+		target: never().optional()
 	},
 	"graph.edge.disconnect": {
-		target,
-		edge
+		edge,
+		target: never().optional()
 	},
 	"graph.node.create": {
 		...at,
 		node
 	},
+	"graph.node.replace": {
+		...at,
+		before: node,
+		node
+	},
 	"graph.node.delete": at,
 	"graph.node.field.set": union([
 		object({
@@ -9265,13 +9288,11 @@ var shapes = {
 	},
 	"graph.node.resolution.set": {
 		...at,
-		target: object({ kind: literal("flow") }),
 		before: object(wait),
 		value: object(wait)
 	},
 	"graph.node.webhook.set": {
 		...at,
-		target: object({ kind: literal("flow") }),
 		before: object(webhook),
 		value: object(webhook)
 	},
@@ -9313,63 +9334,24 @@ var shapes = {
 	},
 	"module.source.replace": {
 		moduleId: text,
-		beforeImports: strings,
+		beforeImports: strings$1,
 		beforeSource: text,
-		imports: strings,
+		imports: strings$1,
 		source: text
 	},
-	"subflow.create": {
-		subflowId: text,
-		subflow: subflow.extend({ graph })
-	},
-	"subflow.definition.set": {
-		subflowId: text,
-		before: subflow,
-		definition: subflow
-	},
-	"subflow.delete": { subflowId: text },
-	"task.create": {
-		taskId: text,
-		task: managed
-	},
-	"task.delete": { taskId: text },
-	"task.connector.connection.set": {
-		taskId: text,
-		before: text.optional(),
-		value: text.optional()
-	},
-	"task.decision.set": {
-		taskId: text,
-		before: managed,
-		value: managed
-	},
-	"task.openapi.set": {
-		taskId: text,
-		before: managed,
-		value: managed
-	},
-	"task.agent.set": {
-		taskId: text,
-		before: managed,
-		value: managed
-	},
-	"task.llm.mode.set": {
-		taskId: text,
-		before: _enum(["chat", "json"]),
-		value: _enum(["chat", "json"])
-	},
-	"task.name.set": {
-		taskId: text,
-		before: text,
-		value: text
+	"graph.node.task.set": {
+		...at,
+		before: union([inline, managed]),
+		value: union([inline, managed])
 	}
 };
 array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, shape instanceof ZodType ? shape : object({
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
-function checkErrorModelVersion(content) {
-	if (content.modelVersion < 5 && [content.document.graph, ...Object.values(content.document.subflows).map((item) => item.graph)].some((item) => Object.values(item.nodes).some((itemNode) => itemNode.kind == "error"))) throw new TypeError("Error workflows require Flow model version 5.");
+function checkModelVersion(content) {
+	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
@@ -9405,6 +9387,298 @@ function resourceNameIssue(value) {
 	if (!/^[\p{L}\p{N}](?:[\p{L}\p{N} _-]*[\p{L}\p{N}])?$/u.test(name)) return "specialCharacter";
 }
 //#endregion
+//#region src/control/common/authoringLlm.ts
+var authoringLlmConfiguration = strictObject({
+	mode: _enum(["chat", "json"]),
+	resultSchema: json$4(),
+	model: json$4().optional().describe("Default model settings: {model, temperature?, top_p?, max_tokens?}. A bound model input takes precedence."),
+	template: json$4().optional().describe("Default message templates: [{role: \"system\" | \"user\" | \"assistant\", content: \"Text with {{namedInput}}\"}]."),
+	messages: json$4().optional().describe("Default conversation history, prepended without template interpolation; an array of {role, content} or null.")
+});
+//#endregion
+//#region src/control/common/authoringOpenApi.ts
+var authenticationSchema = union([
+	strictObject({ schemes: array(string$1().min(1)).describe("One complete security alternative advertised by this operation; [] selects no authentication.") }),
+	strictObject({ type: _enum(["bearer", "basic"]) }),
+	strictObject({
+		type: literal("apiKey"),
+		name: string$1().min(1),
+		in: _enum(["header", "query"])
+	})
+]);
+strictObject({
+	sourceUrl: string$1().min(1),
+	path: string$1().min(1),
+	method: string$1().min(1),
+	serverUrl: string$1().optional(),
+	authentication: authenticationSchema.optional().describe("Omit to use the operation default. Bind credentials through the advertised node inputs.")
+});
+//#endregion
+//#region src/control/common/authoringSchema.ts
+var id$2 = string$1().min(1);
+var json$2 = json$4();
+var patch = record$2(id$2, json$2);
+var type = _enum([
+	"manual",
+	"webhook",
+	"cron",
+	"error",
+	"poll",
+	"integration",
+	"code",
+	"connector",
+	"agent",
+	"llm",
+	"decision",
+	"openapi",
+	"condition",
+	"value",
+	"wait",
+	"approval"
+]);
+var referenceSchema = id$2.describe("An existing node reference returned by read/search, or $alias for a preceding node.add in this edit batch. For node.add.as \"step\", reference \"$step\", never bare \"step\". Aliases are local to one batch.");
+var output = strictObject({
+	kind: literal("output"),
+	node: referenceSchema,
+	port: id$2.optional().describe("Omit for a node with one output. For multiple outputs, choose a name from node details."),
+	field: string$1().optional()
+});
+var variable$1 = strictObject({
+	kind: literal("variable"),
+	name: id$2
+});
+var authoringSourceSchema = union([
+	output,
+	variable$1,
+	strictObject({
+		kind: literal("value"),
+		value: json$2
+	}),
+	strictObject({ kind: literal("unset") }),
+	strictObject({ kind: literal("default") }),
+	strictObject({
+		kind: literal("sources"),
+		sources: array(union([output, variable$1])).min(1)
+	})
+]);
+var operand = union([
+	strictObject({
+		kind: literal("value"),
+		value: json$2.optional(),
+		schema: json$2.optional()
+	}),
+	output,
+	variable$1
+]);
+var agentTool = authoringDefinitionSchemas.agent.shape.tools.element.omit({
+	id: true,
+	inputs: true
+}).extend({ inputs: record$2(id$2, authoringDefinitionSchemas.agent.shape.tools.element.shape.inputs.element.shape.source).optional().describe("Action input sources by name. The tool resolves types from the Action. New inputs default to model-provided; existing sources are preserved when omitted.") }).strict();
+var notification = strictObject({
+	...authoringDefinitionSchemas.connector.shape,
+	messageHandle: id$2,
+	inputs: record$2(id$2, union([strictObject({
+		kind: literal("value"),
+		value: json$2
+	}), strictObject({
+		kind: literal("input"),
+		input: id$2
+	})]))
+});
+var field = strictObject({
+	schema: json$2.optional(),
+	nullable: boolean().optional(),
+	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 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,
+	operator: authoringDefinitionSchemas.condition.shape.cases.element.shape.groups.element.shape.expressions.element.shape.operator,
+	right: operand.optional()
+});
+var all = strictObject({ all: array(expression) });
+var when = union([
+	expression,
+	all,
+	strictObject({ any: array(union([expression, all])) })
+]);
+strictObject({}), strictObject({ sourceFlowIds: array(id$2).optional() }), authoringDefinitionSchemas.webhook.omit({ bodyFields: true }).extend({ body: inputFields }).strict(), strictObject({ schedule: authoringDefinitionSchemas.schedule }), strictObject({
+	key: id$2,
+	connectionId: id$2.optional(),
+	schedule: authoringDefinitionSchemas.schedule
+}), strictObject({
+	key: id$2,
+	connectionId: id$2.optional()
+}), strictObject({
+	inputs: inputFields,
+	outputs: outputFields,
+	capabilities: authoringDefinitionSchemas.capabilities.optional()
+}), authoringDefinitionSchemas.connector.strict(), authoringDefinitionSchemas.agent.omit({
+	prompt: true,
+	tools: true
+}).extend({
+	inputs: inputFields,
+	resultSchema: json$2.describe("JSON schema of the final result. Defaults to text. The tool manages the output definition; references can omit port."),
+	tools: array(agentTool),
+	notification: notification.optional()
+}).strict(), authoringLlmConfiguration.extend({ inputs: inputFields }), authoringDefinitionSchemas.decision, strictObject({
+	match: _enum(["first", "all"]),
+	branches: array(strictObject({
+		name: id$2,
+		description: string$1().optional(),
+		when
+	}))
+}), strictObject({
+	values: patch,
+	outputs: outputFields
+}), strictObject({ inputs: inputFields }), strictObject({ inputs: inputFields });
+var updates = strictObject({
+	name: id$2.optional(),
+	description: string$1().optional(),
+	icon: string$1().optional(),
+	maxExecutions: int().positive().optional(),
+	timeoutMs: number().nonnegative().optional(),
+	config: patch.optional().describe("Recursively merge configuration; omitted fields remain unchanged and arrays replace as a whole. This includes schema objects: {} does not clear an existing schema. Use clear paths to remove fields, e.g. [\"config\",\"inputs\",\"amount\",\"schema\",\"type\"].")
+});
+var authoringEditSchema = discriminatedUnion("op", [
+	strictObject({
+		op: literal("node.add"),
+		as: id$2.regex(/^[A-Za-z][\w-]*$/).describe("Unique batch-local alias without the $ prefix. Later edits must reference this new node as $alias; the bare alias is not its node ID."),
+		type,
+		name: id$2,
+		config: patch.optional(),
+		inputs: record$2(id$2, authoringSourceSchema).optional().describe("Input data sources, applied after creation, as input.set operations. Execution edges are separate."),
+		code: string$1().optional(),
+		prompt: string$1().optional()
+	}),
+	strictObject({
+		op: literal("node.update"),
+		node: referenceSchema,
+		set: updates.optional(),
+		clear: array(array(id$2).min(1)).optional()
+	}),
+	strictObject({
+		op: literal("node.remove"),
+		node: referenceSchema
+	}),
+	strictObject({
+		op: literal("input.set"),
+		node: referenceSchema,
+		input: id$2,
+		source: authoringSourceSchema
+	}),
+	strictObject({
+		op: _enum(["edge.connect", "edge.disconnect"]),
+		source: referenceSchema,
+		target: referenceSchema,
+		branch: id$2.optional()
+	}),
+	strictObject({
+		op: literal("text.edit"),
+		node: referenceSchema,
+		field: _enum(["code", "prompt"]),
+		oldText: id$2,
+		newText: string$1()
+	}),
+	strictObject({
+		op: literal("text.set"),
+		node: referenceSchema,
+		field: _enum(["code", "prompt"]),
+		text: string$1()
+	})
+]);
+var authoringRequestSchema = strictObject({
+	baseRevision: id$2,
+	requestId: id$2.max(256),
+	edits: array(authoringEditSchema).min(1).max(1e3)
+});
+var authoringReadSchema = strictObject({
+	revision: id$2.optional().describe("Fixed revision from a previous read; omit to read the current draft."),
+	nodes: array(id$2).min(1).max(100).optional().describe("Node references to read in one batch. Mutually exclusive with text. Long texts return metadata."),
+	text: strictObject({
+		node: id$2,
+		field: _enum(["code", "prompt"]),
+		start: int().positive().default(1),
+		lines: int().min(1).max(200).default(80)
+	}).optional().describe("Read code or prompt by line (1-based). Mutually exclusive with nodes. Follow nextStart at the same revision until truncated is false.")
+}).refine((v) => v.nodes == null || v.text == null, "Choose nodes or text.").meta({
+	not: { required: ["nodes", "text"] },
+	description: "Omit nodes and text for an outline; provide nodes for details, or text for an excerpt."
+});
+strictObject({ revisionId: id$2 });
+var authoringSearchSchema = strictObject({
+	revision: id$2.optional(),
+	query: id$2.max(1e3),
+	type: type.optional(),
+	offset: int().nonnegative().default(0),
+	limit: int().min(1).max(100).default(20)
+});
+var authoringSchemaQuery = strictObject({
+	type: type.optional(),
+	action: id$2.optional()
+}).refine((v) => v.type == null || v.action == null, "Choose type or action.");
+var authoringDiagnosticSchema = object({
+	code: id$2,
+	message: string$1(),
+	nodes: array(id$2),
+	field: string$1().optional(),
+	line: number().optional(),
+	column: number().optional()
+});
+var authoringCheckResponse = object({
+	flowId: id$2,
+	revisionId: id$2,
+	valid: boolean(),
+	diagnostics: array(authoringDiagnosticSchema),
+	version: literal(1)
+});
+var authoringEditResponse = object({
+	flowId: id$2,
+	saved: literal(true),
+	revision: id$2,
+	nodes: record$2(id$2, id$2),
+	changes: array(object({
+		index: int(),
+		op: id$2,
+		node: id$2.optional()
+	})),
+	validation: object({
+		status: _enum([
+			"valid",
+			"invalid",
+			"unavailable"
+		]),
+		diagnostics: array(authoringDiagnosticSchema).optional()
+	}),
+	version: literal(1)
+});
+var authoringReadResponse = object({
+	flowId: id$2,
+	revision: id$2,
+	data: object({
+		nodes: array(record$2(string$1(), json$2)).optional(),
+		edges: array(json$2).optional(),
+		text: record$2(string$1(), json$2).optional()
+	}),
+	version: literal(1)
+});
+var authoringSearchResponse = object({
+	flowId: id$2,
+	revision: id$2,
+	data: object({
+		matches: array(object({
+			node: id$2,
+			field: id$2,
+			line: int().optional(),
+			excerpt: string$1()
+		})),
+		total: int(),
+		nextOffset: int().optional()
+	}),
+	version: literal(1)
+});
+//#endregion
 //#region src/control/common/resultQuery.ts
 var resultQuerySchema = strictObject({
 	pointer: string$1().max(4096).default(""),
@@ -9498,31 +9772,42 @@ var controlErrorCode = {
 };
 controlErrorCode.eventSourceInvalid, controlErrorCode.eventSourceIdentityUnavailable, controlErrorCode.eventSourceNotFound, controlErrorCode.eventSourceConflict, controlErrorCode.authenticationRequired, controlErrorCode.authorizationDenied, controlErrorCode.bindingUnresolved, controlErrorCode.connectorActionNotFound, controlErrorCode.connectorAccessConflict, controlErrorCode.connectorAccessInvalid, controlErrorCode.connectorAccessRequired, controlErrorCode.connectorAccessUnsupported, controlErrorCode.connectorUnconfigured, controlErrorCode.connectorUnavailable, controlErrorCode.connectorConsoleUnconfigured, controlErrorCode.engineUnavailable, controlErrorCode.engineUnsupported, controlErrorCode.flowInvalid, controlErrorCode.flowRepairRequired, controlErrorCode.flowUpgradeRequired, controlErrorCode.flowNotFound, controlErrorCode.flowBusy, controlErrorCode.flowConflict, controlErrorCode.flowPresentationConflict, controlErrorCode.flowRevisionConflict, controlErrorCode.liveConflict, controlErrorCode.liveNotFound, controlErrorCode.pageInvalidCursor, controlErrorCode.publicationConflict, controlErrorCode.publicationNotFound, controlErrorCode.publicationUnsupported, controlErrorCode.publishOperationNotFound, controlErrorCode.routeNotFound, controlErrorCode.runConflict, controlErrorCode.runEventsExpired, controlErrorCode.runInvalid, controlErrorCode.runNotFound, controlErrorCode.runNotTerminal, controlErrorCode.runOverloaded, controlErrorCode.runWaitNotFound, controlErrorCode.triggerKeyInvalid, controlErrorCode.triggerKeyNotFound, controlErrorCode.triggerNotFound, controlErrorCode.variableInvalid, controlErrorCode.variableLimitReached, controlErrorCode.variableNotFound;
 var ApiError = class extends Error {
-	constructor(status, code, message) {
+	constructor(status, code, message, details) {
 		super(message);
 		this.code = code;
+		this.details = details;
 		this.name = "ApiError";
 		this.status = status;
 	}
 };
 //#endregion
 //#region src/control/common/decoding.ts
-function invalidResponse() {
-	throw new ApiError(502, "response.invalid", "The Control API returned an invalid response.");
+var InvalidResponseError = class extends ApiError {
+	constructor(detail) {
+		super(502, "response.invalid", `The Control API returned an invalid response.${detail == null ? "" : ` ${detail}`}`);
+		this.detail = detail;
+	}
+};
+function invalidResponse(detail) {
+	throw new InvalidResponseError(detail);
 }
 function record(value) {
-	if (value == null || typeof value != "object" || Array.isArray(value)) return invalidResponse();
+	if (value == null || typeof value != "object" || Array.isArray(value)) return invalidResponse("Expected an object.");
 	return value;
 }
 function string(value) {
-	return typeof value == "string" && value.length > 0 ? value : invalidResponse();
+	return typeof value == "string" && value.length > 0 ? value : invalidResponse("Expected a non-empty string.");
 }
 function exact(value, keys) {
 	const actual = Object.keys(value);
-	if (actual.length != keys.length || actual.some((key) => !keys.includes(key))) invalidResponse();
+	if (actual.length != keys.length || actual.some((key) => !keys.includes(key))) {
+		const missing = keys.filter((key) => !Object.hasOwn(value, key));
+		const unexpected = actual.filter((key) => !keys.includes(key));
+		invalidResponse([missing.length > 0 ? `Missing fields: ${missing.join(", ")}.` : "", unexpected.length > 0 ? `Unexpected fields: ${unexpected.join(", ")}.` : ""].filter(Boolean).join(" "));
+	}
 }
 function integer(value) {
-	return Number.isSafeInteger(value) ? value : invalidResponse();
+	return Number.isSafeInteger(value) ? value : invalidResponse("Expected a safe integer.");
 }
 function jsonValue(value) {
 	if (value === null || typeof value == "boolean" || typeof value == "string") return value;
@@ -9557,10 +9842,19 @@ function accessPermissions(value) {
 		"configured",
 		"proxy"
 	]);
-	if (!Array.isArray(source.triggerIds) || typeof source.allTriggers != "boolean" || !Array.isArray(source.actionIds) || typeof source.allActions != "boolean" || typeof source.configured != "boolean" || typeof source.proxy != "boolean") return invalidResponse();
+	if (!Array.isArray(source.actionIds)) return invalidResponse("permissions.actionIds: expected an array.");
+	if (!Array.isArray(source.triggerIds)) return invalidResponse("permissions.triggerIds: expected an array.");
+	if (typeof source.allActions != "boolean") return invalidResponse("permissions.allActions: expected a boolean.");
+	if (typeof source.allTriggers != "boolean") return invalidResponse("permissions.allTriggers: expected a boolean.");
+	if (typeof source.configured != "boolean") return invalidResponse("permissions.configured: expected a boolean.");
+	if (typeof source.proxy != "boolean") return invalidResponse("permissions.proxy: expected a boolean.");
 	const actionIds = source.actionIds.map(string);
 	const triggerIds = source.triggerIds.map(string);
-	if (new Set(actionIds).size != actionIds.length || source.allActions && actionIds.length != 0 || new Set(triggerIds).size != triggerIds.length || source.allTriggers && triggerIds.length != 0 || source.proxy && (!source.allActions || !source.allTriggers || source.configured)) return invalidResponse();
+	if (new Set(actionIds).size != actionIds.length) return invalidResponse("permissions.actionIds: duplicate IDs.");
+	if (source.allActions && actionIds.length != 0) return invalidResponse("permissions.actionIds: must be empty when allActions is true.");
+	if (new Set(triggerIds).size != triggerIds.length) return invalidResponse("permissions.triggerIds: duplicate IDs.");
+	if (source.allTriggers && triggerIds.length != 0) return invalidResponse("permissions.triggerIds: must be empty when allTriggers is true.");
+	if (source.proxy && (!source.allActions || !source.allTriggers || source.configured)) return invalidResponse("permissions.proxy: requires allActions=true, allTriggers=true and configured=false.");
 	return {
 		actionIds,
 		triggerIds,
@@ -9590,15 +9884,15 @@ function accessBinding(value, candidate) {
 		"providerId",
 		...candidate ? [] : ["status"]
 	]);
-	if (policyRevision != null && typeof policyRevision != "string") return invalidResponse();
-	if (candidate && isDefault !== void 0 && typeof isDefault != "boolean") return invalidResponse();
-	if (permissionGroupName !== void 0 && permissionGroupName !== null && typeof permissionGroupName != "string") return invalidResponse();
+	if (policyRevision != null && typeof policyRevision != "string") return invalidResponse("policyRevision: expected a string.");
+	if (candidate && isDefault !== void 0 && typeof isDefault != "boolean") return invalidResponse("isDefault: expected a boolean.");
+	if (permissionGroupName !== void 0 && permissionGroupName !== null && typeof permissionGroupName != "string") return invalidResponse("permissionGroupName: expected a string or null.");
 	if (!candidate && status != "active" && status != "forbidden" && status != "invalid" && status != "missing") return invalidResponse();
 	let bindingSource;
 	try {
 		bindingSource = parseProviderAccessSource(source.source);
 	} catch {
-		return invalidResponse();
+		return invalidResponse("source: expected { kind: 'admin-delegation' } or { kind: 'policy', ruleId: string | null }.");
 	}
 	return {
 		accessBindingId: string(source.accessBindingId),
@@ -9614,7 +9908,7 @@ function accessBinding(value, candidate) {
 	};
 }
 function accessMode(value) {
-	if (value != "implicit" && value != "selectable") return invalidResponse();
+	if (value != "implicit" && value != "selectable") return invalidResponse("mode: expected implicit or selectable.");
 	return value;
 }
 function connectorAccess(value) {
@@ -9723,10 +10017,12 @@ function connectorAccessCandidates(value, providerId) {
 		"providerId",
 		"version"
 	]);
-	if (source.version != 1 || string(source.providerId) != providerId || !Array.isArray(source.candidates)) return invalidResponse();
+	if (source.version != 1) return invalidResponse("version: expected 1.");
+	if (string(source.providerId) != providerId) return invalidResponse("providerId: does not match the requested provider.");
+	if (!Array.isArray(source.candidates)) return invalidResponse("candidates: expected an array.");
 	const candidates = source.candidates.map((candidate) => accessBinding(candidate, true));
-	if (candidates.some((candidate) => candidate.providerId != providerId)) return invalidResponse();
-	if (new Set(candidates.map((candidate) => candidate.accessBindingId)).size != candidates.length) return invalidResponse();
+	if (candidates.some((candidate) => candidate.providerId != providerId)) return invalidResponse("candidates[].providerId: does not match the requested provider.");
+	if (new Set(candidates.map((candidate) => candidate.accessBindingId)).size != candidates.length) return invalidResponse("candidates[].accessBindingId: duplicate IDs.");
 	return {
 		candidates,
 		mode: accessMode(source.mode),
@@ -9737,12 +10033,13 @@ function connectorAccessCandidates(value, providerId) {
 function connectorAccessCandidatesBatch(value, providerIds) {
 	const source = record(value);
 	exact(source, ["results", "version"]);
-	if (source.version != 1 || !Array.isArray(source.results)) return invalidResponse();
+	if (source.version != 1) return invalidResponse("version: expected 1.");
+	if (!Array.isArray(source.results)) return invalidResponse("results: expected an array.");
 	const remaining = new Set(providerIds);
 	const results = source.results.map((entry) => {
 		const item = record(entry);
 		const providerId = string(item.providerId);
-		if (!remaining.delete(providerId)) return invalidResponse();
+		if (!remaining.delete(providerId)) return invalidResponse("results[].providerId: duplicate or unrequested provider.");
 		if (!Object.hasOwn(item, "error")) return connectorAccessCandidates(item, providerId);
 		exact(item, ["providerId", "error"]);
 		const error = record(item.error);
@@ -9755,7 +10052,7 @@ function connectorAccessCandidatesBatch(value, providerIds) {
 			}
 		};
 	});
-	if (remaining.size != 0) return invalidResponse();
+	if (remaining.size != 0) return invalidResponse("results: missing requested providers.");
 	return {
 		results,
 		version: 1
@@ -9943,9 +10240,9 @@ function isUiLanguage(value) {
 var configInputsSchema = array(union([strictObject({
 	handle: string$1().min(1),
 	description: string$1().optional(),
-	jsonSchema: json$3(),
+	jsonSchema: json$4(),
 	nullable: boolean(),
-	value: json$3().optional()
+	value: json$4().optional()
 }), strictObject({
 	group: string$1(),
 	collapsed: boolean().optional()
@@ -10178,7 +10475,7 @@ function labels(value, handles) {
 }
 //#endregion
 //#region src/control/common/results.ts
-var json$1 = json$3();
+var json$1 = json$4();
 var entry = strictObject({
 	pointer: string$1(),
 	type: _enum([
@@ -10342,6 +10639,43 @@ function connectorConnectionsQuery(serviceId, flowId) {
 }
 //#endregion
 //#region src/control/common/flowDecoders.ts
+function strings(value) {
+	return Array.isArray(value) ? value.map(string) : invalidResponse();
+}
+function resourceReferences(input) {
+	const source = record(input);
+	const draft = source.draft === null ? null : record(source.draft);
+	const shared = record(source.sharedAccess);
+	if (draft != null && !Array.isArray(draft.connections)) return invalidResponse();
+	if (!Array.isArray(shared.bindings)) return invalidResponse();
+	const accessRevision = integer(shared.accessRevision);
+	if (accessRevision < 0) return invalidResponse();
+	return {
+		draft: draft == null ? null : {
+			variableNames: strings(draft.variableNames),
+			errorSourceFlowIds: strings(draft.errorSourceFlowIds),
+			connections: draft.connections.map((value) => {
+				const connection = record(value);
+				return {
+					providerId: string(connection.providerId),
+					connectionId: string(connection.connectionId)
+				};
+			})
+		},
+		sharedAccess: {
+			accessRevision,
+			providerIds: strings(shared.providerIds),
+			bindings: shared.bindings.map((value) => {
+				const binding = record(value);
+				return {
+					providerId: string(binding.providerId),
+					connectionId: binding.connectionId === null ? null : string(binding.connectionId),
+					accessBindingId: string(binding.accessBindingId)
+				};
+			})
+		}
+	};
+}
 function flow$1(value) {
 	const source = record(value);
 	const status = source.status;
@@ -10358,6 +10692,7 @@ function flow$1(value) {
 		createdAt: string(source.createdAt),
 		...source.connectorTeamId == null ? {} : { connectorTeamId: string(source.connectorTeamId) },
 		draftRevisionId: string(source.draftRevisionId),
+		resourceReferences: resourceReferences(source.resourceReferences),
 		flowId: string(source.flowId),
 		name: string(source.name),
 		status,
@@ -10938,7 +11273,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 !== "subflow" && 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 !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,
@@ -11424,6 +11759,37 @@ var ControlClient = class {
 			return invalidResponse();
 		}
 	}
+	async readAuthoring(flowId, query = {}) {
+		return authoringReadResponse.parse(await this.request(`/v1/flows/${segment(flowId)}/authoring/read`, {
+			method: "POST",
+			body: JSON.stringify(query)
+		}));
+	}
+	async searchAuthoring(flowId, query) {
+		return authoringSearchResponse.parse(await this.request(`/v1/flows/${segment(flowId)}/authoring/search`, {
+			method: "POST",
+			body: JSON.stringify(query)
+		}));
+	}
+	async authoringSchema(flowId, query) {
+		return record(await this.request(`/v1/flows/${segment(flowId)}/authoring/schema`, {
+			method: "POST",
+			body: JSON.stringify(query)
+		}));
+	}
+	async editAuthoring(flowId, request) {
+		return authoringEditResponse.parse(await this.request(`/v1/flows/${segment(flowId)}/authoring/edit`, {
+			method: "POST",
+			headers: { "idempotency-key": request.requestId },
+			body: JSON.stringify(request)
+		}));
+	}
+	async checkAuthoring(flowId, revisionId) {
+		return authoringCheckResponse.parse(await this.request(`/v1/flows/${segment(flowId)}/authoring/check`, {
+			method: "POST",
+			body: JSON.stringify({ revisionId })
+		}));
+	}
 	async changeDraft(flowId, expectedRevisionId, operations, changeId = operationKey("change")) {
 		return draftChange(await this.request(`/v1/flows/${segment(flowId)}/draft/changes`, {
 			body: JSON.stringify({
@@ -11606,7 +11972,7 @@ var ControlClient = class {
 			}
 			const error = record(value).error;
 			const source = error == null ? void 0 : record(error);
-			throw new ApiError(response.status, typeof source?.code == "string" ? source.code : "request.failed", typeof source?.message == "string" ? source.message : `Request failed with status ${response.status}.`);
+			throw new ApiError(response.status, typeof source?.code == "string" ? source.code : "request.failed", typeof source?.message == "string" ? source.message : `Request failed with status ${response.status}.`, source?.details == null ? void 0 : record(source.details));
 		}
 		return response;
 	}
@@ -11679,7 +12045,6 @@ var mcpConformanceCases = [
 			const flow = await client.createFlow("MCP Run listing");
 			const changed = await client.changeDraft(flow.flowId, flow.draftRevisionId, [{
 				kind: "graph.node.create",
-				target: { kind: "flow" },
 				nodeId: "start",
 				node: {
 					kind: "manual",
@@ -11785,13 +12150,13 @@ var mcpConformanceCases = [
 //#endregion
 //#region src/control/common/mcp.ts
 var mcpProtocolVersion = "2026-07-28";
-var json = json$3();
+var json = json$4();
 var id = string$1().min(1);
 var mutationKey = id.max(256).describe("Stable identity for this mutation. Retry with the same key and identical arguments, even after a lost response.");
 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 and flow_get to inspect a Flow. Use flow_node_get with the observed revisionId for individual node schemas or code. Use flow_schema to learn atomic edit operations, then flow_apply with the observed expectedRevisionId and a stable idempotencyKey. 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_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_create, flow_apply, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. 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 = "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_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_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. 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) {
 	return {
 		description,
@@ -11823,32 +12188,16 @@ var mcpTools = {
 		cursor: id.optional(),
 		limit: pageLimit
 	}), true),
-	flow_get: tool("Read a compact Draft graph with input bindings, port handles, subflows and Live status. Use full=true for complete Revision content, schemas, source code and exact before values required by complex edits. Unreadable Drafts return draft=null and draftIssue; flow.live still identifies the published version. Use draft.revisionId as the base of an edit.", strictObject({
-		flowId: flow,
-		full: boolean().optional()
-	}), true),
-	flow_node_get: tool("Read one node and its Task definition or code module from a fixed Revision. Omit subflowId for the root graph. Use revisionId from flow_get; the returned node contains exact before values for edits.", strictObject({
-		flowId: flow,
-		revisionId: id,
-		nodeId: id,
-		subflowId: id.optional()
-	}), true),
-	flow_schema: tool("Get an operation schema by kind, or a complete apply batch by example (connector, poll, poll-notification, code, wait). Use example=index to list examples. graph.trigger.create resolves a provider key into a fixed definition at commit.", strictObject({
-		kind: id.optional(),
-		example: id.optional()
-	}).refine((value) => value.kind == null || value.example == null, "Choose kind or example, not both."), true),
+	flow_read: tool("Read an outline, selected node details, or a bounded code/prompt excerpt. Carry the returned revision into subsequent reads and edits.", authoringReadSchema.safeExtend({ flowId: flow }).meta({ ...authoringReadSchema.meta() }), true),
+	flow_search: tool("Find nodes by name, configuration or source text in a fixed Revision. Follow nextOffset for more matches.", authoringSearchSchema.extend({ flowId: flow }), true),
+	flow_schema: tool("Read node configuration schemas and the edit grammar, or an Action contract. Action lookup requires a flowId.", authoringSchemaQuery.safeExtend({ flowId: flow.optional() }), true),
 	flow_create: tool("Create an empty Flow. If this deployment uses OOMOL Connector, choose a teamId from connector_teams. Keep the key and arguments stable when retrying.", strictObject({
 		name: id.refine((name) => name == name.trim() && resourceNameIssue(name) == null, "Flow name is invalid."),
 		idempotencyKey: mutationKey,
 		teamId: id.optional()
 	}), false),
-	flow_apply: tool("Apply ordered atomic changes. Read flow_schema first. A stale expectedRevisionId is a conflict; reread the Draft before deciding on a new edit.", strictObject({
-		flowId: flow,
-		expectedRevisionId: id,
-		idempotencyKey: mutationKey,
-		operations: array(json).min(1).describe("Change operations defined by flow_schema. Explicit IDs and before values refer to the base Revision.")
-	}), false),
-	flow_check: tool("Validate a fixed Revision and return diagnostics. Get its revisionId from flow_get or flow_apply.", strictObject({
+	flow_edit: tool("Atomically edit root nodes, input sources, execution edges and text. Use $alias for preceding creations. Preserve baseRevision and requestId when retrying. A saved draft may have validation diagnostics.", authoringRequestSchema.extend({ flowId: flow }), false),
+	flow_check: tool("Validate a fixed Revision and return diagnostics. Use the revision returned by flow_read or flow_edit as revisionId.", strictObject({
 		flowId: flow,
 		revisionId: id
 	}), true),
@@ -11862,7 +12211,7 @@ var mcpTools = {
 		flowId: flow,
 		operationId: id
 	}), true),
-	flow_set_enabled: tool("Enable or disable a published Flow. Supply expectedPublicationId from flow_get; a changed Live publication is a conflict. This does not cancel accepted Runs; use run_cancel for those.", strictObject({
+	flow_set_enabled: tool("Enable or disable a published Flow. Supply expectedPublicationId from flow_list; a changed Live publication is a conflict. This does not cancel accepted Runs; use run_cancel for those.", strictObject({
 		flowId: flow,
 		expectedPublicationId: id,
 		enabled: boolean()
@@ -11873,18 +12222,18 @@ var mcpTools = {
 		revisionId: id,
 		trigger: strictObject({
 			nodeId: id,
-			outputs: record$1(string$1(), json)
+			outputs: record$2(string$1(), json)
 		}),
-		inputs: record$1(string$1(), record$1(string$1(), json)).default({}),
+		inputs: record$2(string$1(), record$2(string$1(), json)).default({}),
 		idempotencyKey: mutationKey
 	}), strictObject({
 		source: literal("live"),
 		publicationId: id,
 		trigger: strictObject({
 			nodeId: id,
-			outputs: record$1(string$1(), json)
+			outputs: record$2(string$1(), json)
 		}),
-		inputs: record$1(string$1(), record$1(string$1(), json)).default({}),
+		inputs: record$2(string$1(), record$2(string$1(), json)).default({}),
 		idempotencyKey: mutationKey
 	})]).meta({ type: "object" }), false),
 	run_list: tool("List Runs for a Flow, optionally filtered by status. Continue with nextCursor; cursors are compatible with the Control API.", strictObject({
@@ -11957,7 +12306,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_get. 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. 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_get: tool("Read a provider Trigger definition before creating its node.", strictObject({ key: id }), true)
 };
 //#endregion