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

package/dist/common/mcp.js

@@ -5831,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),
@@ -6320,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,
@@ -8308,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,
@@ -8777,15 +8777,15 @@ 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
@@ -8801,7 +8801,7 @@ var source = union([object({
 })]);
 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"),
@@ -8852,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
@@ -8881,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([
@@ -8899,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([
@@ -8943,11 +8943,12 @@ var managed = object({
 			}).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
@@ -8958,7 +8959,7 @@ var condition = {
 		description: text.optional(),
 		output: text,
 		groups: array(object({ expressions: array(object({
-			left: operand,
+			left: operand$1,
 			operator: _enum([
 				"!=",
 				"<",
@@ -8981,7 +8982,7 @@ var condition = {
 				"notHasValue",
 				"startsWith"
 			]),
-			right: operand.optional()
+			right: operand$1.optional()
 		})) }))
 	}))
 };
@@ -8991,7 +8992,7 @@ var wait = {
 };
 var webhookOptions = object({
 	allowedMethods: never().optional(),
-	allowedOrigins: strings.optional(),
+	allowedOrigins: strings$1.optional(),
 	noResponseBody: never().optional(),
 	responseData: text.optional(),
 	responseHeaders: record$2(text, text).optional(),
@@ -9118,6 +9119,25 @@ var node = union([
 		})
 	})
 ]);
+/** 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,
@@ -9137,7 +9157,7 @@ var binding = object({
 });
 var module = object({
 	name: text,
-	imports: strings,
+	imports: strings$1,
 	source: text
 });
 var document = preprocess(rejectRetiredDefinitions, object({
@@ -9205,6 +9225,11 @@ var shapes = {
 		...at,
 		node
 	},
+	"graph.node.replace": {
+		...at,
+		before: node,
+		node
+	},
 	"graph.node.delete": at,
 	"graph.node.field.set": union([
 		object({
@@ -9309,9 +9334,9 @@ var shapes = {
 	},
 	"module.source.replace": {
 		moduleId: text,
-		beforeImports: strings,
+		beforeImports: strings$1,
 		beforeSource: text,
-		imports: strings,
+		imports: strings$1,
 		source: text
 	},
 	"graph.node.task.set": {
@@ -9362,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(""),
@@ -9455,9 +9772,10 @@ 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;
 	}
@@ -9922,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()
@@ -10157,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([
@@ -10321,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;
@@ -10337,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,
@@ -11403,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({
@@ -11585,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;
 	}
@@ -11763,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,
@@ -11801,31 +12188,16 @@ var mcpTools = {
 		cursor: id.optional(),
 		limit: pageLimit
 	}), true),
-	flow_get: tool("Read a compact Draft graph with input bindings, port handles 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. Use revisionId from flow_get; the returned node contains exact before values for edits.", strictObject({
-		flowId: flow,
-		revisionId: id,
-		nodeId: id
-	}), 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),
@@ -11839,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()
@@ -11934,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