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

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({
@@ -6092,7 +6093,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6152,7 +6153,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -6192,13 +6193,13 @@ 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)
@@ -11093,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();
@@ -11102,7 +11112,7 @@ 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
 	};
@@ -11292,6 +11302,21 @@ function workflowIdentity(value) {
 		executionId: string(ref.executionId)
 	};
 }
+function runInitiator(value) {
+	const source = record(value);
+	if (![
+		"workbench",
+		"cli",
+		"mcp",
+		"api",
+		"trigger",
+		"workflow"
+	].includes(source.channel)) return invalidResponse();
+	return {
+		channel: source.channel,
+		...source.actorId === void 0 ? {} : { actorId: string(source.actorId) }
+	};
+}
 function runDetails(value) {
 	const source = record(value);
 	const summary = run$1(source);
@@ -11313,6 +11338,7 @@ function runDetails(value) {
 	if (source.calls !== void 0 && !Array.isArray(source.calls)) return invalidResponse();
 	const details = {
 		...summary,
+		...source.initiator === void 0 ? {} : { initiator: runInitiator(source.initiator) },
 		...errorHandling(source),
 		...source.triggerNodeId === void 0 ? {} : { triggerNodeId: string(source.triggerNodeId) },
 		...source.caller === void 0 ? {} : { caller: workflowIdentity(source.caller) },
@@ -11690,7 +11716,8 @@ function operationKey(operation) {
 	return `${operation}-${randomId()}`;
 }
 var ControlClient = class {
-	constructor(requestControl) {
+	constructor(requestControl, channel = "api") {
+		this.channel = channel;
 		this.requestControl = requestControl;
 	}
 	async loadOpenApiDocument(url, signal) {
@@ -12210,7 +12237,10 @@ var ControlClient = class {
 				trigger: options.trigger,
 				version: 2
 			}),
-			headers: { "idempotency-key": options.idempotencyKey ?? operationKey("run") },
+			headers: {
+				"idempotency-key": options.idempotencyKey ?? operationKey("run"),
+				"x-open-flow-client": this.channel
+			},
 			method: "POST"
 		}));
 		return created.source == "draft" ? created : invalidResponse();
@@ -12223,7 +12253,10 @@ var ControlClient = class {
 				publicationId,
 				version: 2
 			}),
-			headers: { "idempotency-key": options.idempotencyKey ?? operationKey("run") },
+			headers: {
+				"idempotency-key": options.idempotencyKey ?? operationKey("run"),
+				"x-open-flow-client": this.channel
+			},
 			method: "POST"
 		}));
 		return created.source == "live" ? created : invalidResponse();
@@ -12565,7 +12598,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,

package/dist/common/openapi.js

@@ -6687,6 +6687,7 @@ var webhookMethods = [
 	"DELETE"
 ];
 var text = string();
+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 = json$1();
 var strings = array(text);
 var port = object$1({
@@ -6742,7 +6743,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6802,7 +6803,7 @@ var managedFields = object$1({
 		object$1({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object$1({
@@ -6842,13 +6843,13 @@ var managedFields = object$1({
 				name: text,
 				description: text,
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				approval: boolean(),
 				inputs: array(input.extend({ source: agentInput }))
 			})),
 			notification: object$1({
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text,
 				inputs: record$1(text, agentValue)

package/dist/common/poll-trigger.js

@@ -6694,6 +6694,7 @@ var webhookMethods = [
 	"DELETE"
 ];
 var text = string();
+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 = json$1();
 var strings = array(text);
 var port = object({
@@ -6749,7 +6750,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6809,7 +6810,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -6849,13 +6850,13 @@ 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$1(text, agentValue)

package/dist/common/scheduler.js

@@ -9496,6 +9496,7 @@ function webhookSupportsBody(method) {
 	return method !== "GET";
 }
 var text = string();
+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 = json$1();
 var strings = array(text);
 var port = object({
@@ -9551,7 +9552,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -9611,7 +9612,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -9651,13 +9652,13 @@ var managedFields = object({
 				name: text,
 				description: text,
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				approval: boolean(),
 				inputs: array(input.extend({ source: agentInput$1 }))
 			})),
 			notification: object({
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text,
 				inputs: record$1(text, agentValue)

package/dist/common/webhook-trigger.js

@@ -5810,6 +5810,7 @@ function webhookSupportsBody(method) {
 	return method !== "GET";
 }
 var text = string();
+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 = json$1();
 var strings = array(text);
 var port = object({
@@ -5865,7 +5866,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -5925,7 +5926,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -5965,13 +5966,13 @@ 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$1(text, agentValue)

package/dist/common/workflow.js

@@ -6687,6 +6687,7 @@ var webhookMethods = [
 	"DELETE"
 ];
 var text = string();
+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 = json$1();
 var strings = array(text);
 var port = object({
@@ -6742,7 +6743,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6802,7 +6803,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -6842,13 +6843,13 @@ 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$1(text, agentValue)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oomol-lab/open-flow",
-  "version": "0.1.0-beta.66",
+  "version": "0.1.0-beta.68",
   "description": "TypeScript contracts and Browser runtime for Open Flow.",
   "license": "Apache-2.0",
   "repository": {

package/skills/open-flow/SKILL.md

@@ -14,6 +14,15 @@ Consult the references relevant to the task:
 - [n8n conversion](references/flow-n8n-conversion.md): represent collections,
   branches, provider operations and state while preserving source behavior.
 
+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.
+
 <!-- agentic:if localDevelopment -->
 
 Run commands from this repository's root. The development CLI connects to the

package/skills/open-flow/references/flow-authoring.md

@@ -289,6 +289,8 @@ unavailable action and an action lacking an active Connection are different
 problems. Actions marked `authenticated: false` need no account. Connection
 selection rules come from the selected node contract.
 
+For Connector Tasks, independent Code Actions, Agent tools and notifications, an omitted `connectionId` means unconfigured; `connectionId: ""` explicitly defers account configuration. Deferred selections pass account readiness checks but fail with `connector.connection-required` if invoked. Deferred Agent tools are excluded from the callable tool set. Provider Triggers still require a nonempty account ID. Public edits and portable exports preserve the empty string; clear the field to return to the unconfigured state.
+
 | Capability                      | Relevant schema and configuration                                                                                                  |
 | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
 | Provider read or write          | `connector`: discovered `action`, optional `connectionId`, named input bindings.                                                   |