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

package/dist/common/authoringExamples.d.ts

@@ -8,7 +8,7 @@ declare const descriptions: {
     readonly integration: 'Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.';
     readonly decision: 'AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running.';
     readonly openapi: 'A fixed JSON API operation. Replace the example document and URL before running.';
-    readonly connector: 'A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show.';
+    readonly connector: 'A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account.';
     readonly code: 'A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions.';
     readonly condition: 'A condition with true and false execution branches.';
     readonly value: 'A fixed value node.';
@@ -22,7 +22,7 @@ declare const descriptions: {
 export declare const authoringExampleNames: (keyof typeof descriptions)[];
 export declare const authoringExamples: {
     name: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm-chat" | "llm-json" | "openapi" | "poll" | "poll-notification" | "start" | "value" | "wait" | "webhook";
-    description: "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show." | "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Start node with a required message parameter. Supply it through trigger.outputs." | "A Wait with a continue action and a built-in notification output." | "A Webhook start node." | "A condition with true and false execution branches." | "A fixed JSON API operation. Replace the example document and URL before running." | "A fixed value node." | "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running." | "An Agent with code computation enabled. Configure a model available in the deployment." | "An Approval with approve and reject decision branches and a built-in notification output." | "An LLM JSON Task and its node; configure a model available in the deployment." | "An LLM chat Task and its node; configure a model available in the deployment." | "An hourly scheduled start node." | "Gmail events → JavaScript text formatting → Connector notification. Replace connection/action IDs and match the notification input ports." | "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection." | "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.";
+    description: "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account." | "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Start node with a required message parameter. Supply it through trigger.outputs." | "A Wait with a continue action and a built-in notification output." | "A Webhook start node." | "A condition with true and false execution branches." | "A fixed JSON API operation. Replace the example document and URL before running." | "A fixed value node." | "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running." | "An Agent with code computation enabled. Configure a model available in the deployment." | "An Approval with approve and reject decision branches and a built-in notification output." | "An LLM JSON Task and its node; configure a model available in the deployment." | "An LLM chat Task and its node; configure a model available in the deployment." | "An hourly scheduled start node." | "Gmail events → JavaScript text formatting → Connector notification. Replace connection/action IDs and match the notification input ports." | "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection." | "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.";
 }[];
 export declare function authoringExample(name: string): {
     version: 1;

package/dist/common/control-api-conformance.js

@@ -8579,6 +8579,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({
@@ -8634,7 +8635,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -8694,7 +8695,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -8734,13 +8735,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$3(text, agentValue)
@@ -10891,6 +10892,15 @@ function flow(value) {
 		version: 1
 	};
 }
+function flowListItem(value) {
+	const source = record$1(value);
+	const referenceCount = integer(source.referenceCount);
+	if (referenceCount < 0) return invalidResponse();
+	return {
+		...flow(source),
+		referenceCount
+	};
+}
 function flowPage(value) {
 	const source = record$1(value);
 	if (source.version != 1 || !Array.isArray(source.flows)) return invalidResponse();
@@ -10900,7 +10910,7 @@ function flowPage(value) {
 	if (total != null && !Number.isSafeInteger(total)) return invalidResponse();
 	return {
 		...nextCursor == null ? {} : { nextCursor },
-		flows: source.flows.map(flow),
+		flows: source.flows.map(flowListItem),
 		...total == null ? {} : { total },
 		version: 1
 	};
@@ -12712,13 +12722,22 @@ var controlApiConformanceCases = [
 			await error(await createFlowRequest(harness, "Different flow", "flow-lifecycle"), 409, "flow.conflict", "Conflicting Flow");
 			equal(await json(await request(harness, `/v1/flows/${flowId}`), 200, "Read Flow"), created, "Read Flow");
 			const page = await json(await request(harness, "/v1/flows?includeTotal=true"), 200, "List Flows");
-			equal(page.flows, [created], "Listed Flows");
+			equal(page.flows, [{
+				...created,
+				referenceCount: 0
+			}], "Listed Flows");
 			equal(page.total, 1, "Flow total");
 			const second = await createFlow(harness, "Second control flow", "flow-lifecycle-second");
 			const firstPage = await json(await request(harness, "/v1/flows?limit=1"), 200, "List first Flow page");
-			equal(firstPage.flows, [created], "First Flow page");
+			equal(firstPage.flows, [{
+				...created,
+				referenceCount: 0
+			}], "First Flow page");
 			const cursor = requiredString(firstPage.nextCursor, "Flow cursor");
-			equal((await json(await request(harness, `/v1/flows?limit=1&cursor=${encodeURIComponent(cursor)}`), 200, "List second Flow page")).flows, [second], "Second Flow page");
+			equal((await json(await request(harness, `/v1/flows?limit=1&cursor=${encodeURIComponent(cursor)}`), 200, "List second Flow page")).flows, [{
+				...second,
+				referenceCount: 0
+			}], "Second Flow page");
 			equal((await json(await request(harness, `/v1/flows/${flowId}`, {
 				body: JSON.stringify({
 					name: "Renamed flow",
@@ -13259,7 +13278,10 @@ var publicationControlApiConformanceCases = [
 				publicationId,
 				revisionId
 			}, "Disabled summary");
-			equal((await json(await request(harness, "/v1/flows"), 200, "List disabled Flow")).flows, [disabled], "List includes Live state");
+			equal((await json(await request(harness, "/v1/flows"), 200, "List disabled Flow")).flows, [{
+				...disabled,
+				referenceCount: 0
+			}], "List includes Live state");
 			equal((await json(await request(harness, `/v1/flows/${flowId}/live`), 200, "Disabled Live")).status, "suspended", "Disabled Live status");
 			await error(await liveRunRequest(harness, publicationId, "disabled-run"), 412, "live.conflict", "Disabled Live rejects Run");
 			await json(await request(harness, `/v1/flows/${flowId}/revisions/${revisionId}/runs`, {

package/dist/common/control-api.d.ts

@@ -86,8 +86,11 @@ export interface Presentation {
     readonly value: Readonly<Record<string, JsonValue>>;
     readonly version: 1;
 }
+export interface FlowListItem extends Flow {
+    readonly referenceCount: number;
+}
 export interface FlowPage {
-    readonly flows: readonly Flow[];
+    readonly flows: readonly FlowListItem[];
     readonly nextCursor?: string;
     readonly total?: number;
     readonly version: 1;

package/dist/common/control-api.js

@@ -5823,6 +5823,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$2 = json$3();
 var strings$1 = array(text);
 var port$1 = object({
@@ -5878,7 +5879,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -5938,7 +5939,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -5978,13 +5979,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)
@@ -11538,6 +11539,15 @@ function flow(value) {
 		version: 1
 	};
 }
+function flowListItem(value) {
+	const source = record(value);
+	const referenceCount = integer(source.referenceCount);
+	if (referenceCount < 0) return invalidResponse();
+	return {
+		...flow(source),
+		referenceCount
+	};
+}
 function flowPage(value) {
 	const source = record(value);
 	if (source.version != 1 || !Array.isArray(source.flows)) return invalidResponse();
@@ -11547,7 +11557,7 @@ function flowPage(value) {
 	if (total != null && !Number.isSafeInteger(total)) return invalidResponse();
 	return {
 		...nextCursor == null ? {} : { nextCursor },
-		flows: source.flows.map(flow),
+		flows: source.flows.map(flowListItem),
 		...total == null ? {} : { total },
 		version: 1
 	};

package/dist/common/control-requests.js

@@ -6887,7 +6887,7 @@ function decodeConnectorCapabilities(value) {
 		const actions = source.actions.map((entry) => {
 			if (entry == null || typeof entry != "object" || Array.isArray(entry)) throw new TypeError("Invalid Connector Action.");
 			const action = entry;
-			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && (typeof action.connectionId != "string" || action.connectionId.length == 0)) throw new TypeError("Invalid Connector Action permission.");
+			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && typeof action.connectionId != "string") throw new TypeError("Invalid Connector Action permission.");
 			return action.connectionId == null ? { action: action.action } : {
 				action: action.action,
 				connectionId: action.connectionId
@@ -10423,6 +10423,7 @@ function webhookSupportsBody(method) {
 	return method !== "GET";
 }
 var text$1 = string();
+var actionConnection = text$1.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$4 = json$5();
 var strings = array(text$1);
 var port = object$1({
@@ -10478,7 +10479,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text$1,
-			connectionId: text$1.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -10538,7 +10539,7 @@ var managedFields = object$1({
 		object$1({
 			kind: literal("connector"),
 			action: text$1,
-			connectionId: text$1.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object$1({
@@ -10578,13 +10579,13 @@ var managedFields = object$1({
 				name: text$1,
 				description: text$1,
 				action: text$1,
-				connectionId: text$1.optional(),
+				connectionId: actionConnection.optional(),
 				approval: boolean(),
 				inputs: array(input.extend({ source: agentInput }))
 			})),
 			notification: object$1({
 				action: text$1,
-				connectionId: text$1.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text$1,
 				inputs: record$3(text$1, agentValue)
@@ -14170,7 +14171,7 @@ var descriptions = {
 	"integration": "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.",
 	"decision": "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running.",
 	"openapi": "A fixed JSON API operation. Replace the example document and URL before running.",
-	"connector": "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show.",
+	"connector": "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account.",
 	"code": "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions.",
 	"condition": "A condition with true and false execution branches.",
 	"value": "A fixed value node.",

package/dist/common/decision.js

@@ -6597,6 +6597,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({
@@ -6652,7 +6653,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6712,7 +6713,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -6752,13 +6753,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/flow-encoding.js

@@ -8579,6 +8579,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({
@@ -8634,7 +8635,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -8694,7 +8695,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -8734,13 +8735,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)
@@ -9522,6 +9523,7 @@ function clearNodeConnections(graph, connectionId) {
 			if ("executor" in node.task) {
 				const executor = node.task.executor;
 				const clear = (value) => {
+					if (value.connectionId === "") return value;
 					if (connectionId != null && value.connectionId != connectionId) return value;
 					const { connectionId: _, ...rest } = value;
 					return rest;
@@ -9566,6 +9568,7 @@ function clearNodeConnections(graph, connectionId) {
 				return {
 					...capability,
 					actions: capability.actions.map((action) => {
+						if (action.connectionId === "") return action;
 						if (connectionId != null && action.connectionId != connectionId) return action;
 						const { connectionId: _, ...remaining } = action;
 						return remaining;

package/dist/common/flow-semantics.js

@@ -6611,6 +6611,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$1({
@@ -6666,7 +6667,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -6726,7 +6727,7 @@ var managedFields = object$1({
 		object$1({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object$1({
@@ -6766,13 +6767,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$1 }))
 			})),
 			notification: object$1({
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text,
 				inputs: record$1(text, agentValue)
@@ -7367,7 +7368,7 @@ function decodeConnectorCapabilities(value) {
 		const actions = source.actions.map((entry) => {
 			if (entry == null || typeof entry != "object" || Array.isArray(entry)) throw new TypeError("Invalid Connector Action.");
 			const action = entry;
-			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && (typeof action.connectionId != "string" || action.connectionId.length == 0)) throw new TypeError("Invalid Connector Action permission.");
+			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && typeof action.connectionId != "string") throw new TypeError("Invalid Connector Action permission.");
 			return action.connectionId == null ? { action: action.action } : {
 				action: action.action,
 				connectionId: action.connectionId
@@ -11097,6 +11098,7 @@ function clearNodeConnections(graph, connectionId) {
 			if ("executor" in node.task) {
 				const executor = node.task.executor;
 				const clear = (value) => {
+					if (value.connectionId === "") return value;
 					if (connectionId != null && value.connectionId != connectionId) return value;
 					const { connectionId: _, ...rest } = value;
 					return rest;
@@ -11141,6 +11143,7 @@ function clearNodeConnections(graph, connectionId) {
 				return {
 					...capability,
 					actions: capability.actions.map((action) => {
+						if (action.connectionId === "") return action;
 						if (connectionId != null && action.connectionId != connectionId) return action;
 						const { connectionId: _, ...remaining } = action;
 						return remaining;
@@ -11606,7 +11609,7 @@ function agentConfigIssues(task) {
 		ids.add(tool.id);
 		names.add(tool.name);
 		if (tool.description.trim().length == 0) issues.push(`Tool ${tool.name} requires a description.`);
-		if (!/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(tool.action) || tool.connectionId === "") issues.push(`Tool ${tool.name} has an invalid Action or Connection.`);
+		if (!/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(tool.action)) issues.push(`Tool ${tool.name} has an invalid Action or Connection.`);
 		const fields = /* @__PURE__ */ new Set();
 		for (const port of tool.inputs) {
 			if (port.handle.length == 0 || fields.has(port.handle)) issues.push(`Tool ${tool.name} has an empty or duplicate input.`);
@@ -24177,7 +24180,7 @@ function variableBindings(revision, bindingIds) {
 function flowResourceReferences(content) {
 	const connections = /* @__PURE__ */ new Map();
 	for (const use of connectionUsage(content.document)) {
-		if (use.connectionId == null) continue;
+		if (use.connectionId == null || use.connectionId === "") continue;
 		connections.set(JSON.stringify([use.providerId, use.connectionId]), {
 			providerId: use.providerId,
 			connectionId: use.connectionId
@@ -24432,7 +24435,7 @@ function agentActions(flow) {
 		const task = node.task;
 		if (task.executor.kind != "agent") return [];
 		const notice = task.executor.notification;
-		return [...task.executor.tools, ...notice != null ? [notice] : []].map((tool) => ({
+		return [...task.executor.tools, ...notice != null ? [notice] : []].filter((tool) => tool.connectionId !== "").map((tool) => ({
 			kind: "connector",
 			action: tool.action,
 			connections: tool.connectionId == null ? [] : [{ connectionId: tool.connectionId }]

package/dist/common/integration-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$2(text, agentValue)

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
 	};
@@ -12565,7 +12575,7 @@ var mutationKey = id.max(256).describe("Stable identity for this mutation. Retry
 var pageLimit = int().min(1).max(100).default(50);
 var flow = id.describe("Exact Flow ID returned by flow_list or flow_create.");
 var run = id.describe("Exact Run ID returned by flow_run or run_list.");
-var mcpInstructions = "Use flow_list, flow_read and flow_search to inspect root workflows. Read node type schemas with flow_schema. Use flow_edit with the observed baseRevision and a stable requestId. Node edits affect only the selected node. Text edits require exactly one match. Execution edges and input sources are independent. Legacy Subflow content is unsupported. Edits can save incomplete drafts; inspect returned diagnostics and use flow_check before running. Use flow_check before flow_run. Select an explicit Trigger node ID and fixed revision or publication. A new Flow has no Trigger until you add one. Before adding a Feishu Trigger, use event_source_list and compare its Connection IDs with connector_connections in the Flow scope. If no source is available, create and verify one in Workbench. Use flow_publish to publish a fixed Revision, then poll flow_publish_status until succeeded or failed. Use flow_live to inspect current online entries after publication. Use flow_set_enabled to enable or disable the observed Live publication. flow_run returns an accepted Run, not its final result. Find Runs with run_list, poll run_get and use run_result after terminal. Resolve a waiting Run only with an explicit run_resolve_wait action allowed by run_get. Use run_results and run_result_read to inspect stored Agent tool results; these are separate from the terminal Run result. Retry flow_edit with identical arguments and the same requestId. Retry flow_create, flow_import, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. Canvas commands are transient broadcasts without execution confirmation; never automatically retry flow_canvas because pan is relative. Other mutations use the same resource identity and arguments when retrying. Cancel a Run explicitly with run_cancel. Use nextCursor and nextAfter to read subsequent pages. Connector-backed deployments may require a Team; inspect connector_teams before creating a Flow.";
+var mcpInstructions = "Keep generated Flow and node names short enough to scan on the canvas. Aim for 2–4 English words or 4–8 Chinese characters, using the user's language unless the workflow has an established naming language. Name a Flow by its main purpose and a node by its action and object, such as \"AI Trend Digest\", \"Fetch trends\", \"Verify sources\", or \"发布文章\". Keep only qualifiers needed to distinguish similar nodes. Put detailed behavior in descriptions; avoid sentences, repeated workflow context, and obscure abbreviations. Preserve names explicitly supplied by the user, and do not rename unrelated existing nodes. Use flow_list, flow_read and flow_search to inspect root workflows. Read node type schemas with flow_schema. Use flow_edit with the observed baseRevision and a stable requestId. Node edits affect only the selected node. Text edits require exactly one match. Execution edges and input sources are independent. Legacy Subflow content is unsupported. Edits can save incomplete drafts; inspect returned diagnostics and use flow_check before running. Use flow_check before flow_run. Select an explicit Trigger node ID and fixed revision or publication. A new Flow has no Trigger until you add one. Before adding a Feishu Trigger, use event_source_list and compare its Connection IDs with connector_connections in the Flow scope. If no source is available, create and verify one in Workbench. Use flow_publish to publish a fixed Revision, then poll flow_publish_status until succeeded or failed. Use flow_live to inspect current online entries after publication. Use flow_set_enabled to enable or disable the observed Live publication. flow_run returns an accepted Run, not its final result. Find Runs with run_list, poll run_get and use run_result after terminal. Resolve a waiting Run only with an explicit run_resolve_wait action allowed by run_get. Use run_results and run_result_read to inspect stored Agent tool results; these are separate from the terminal Run result. Retry flow_edit with identical arguments and the same requestId. Retry flow_create, flow_import, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. Canvas commands are transient broadcasts without execution confirmation; never automatically retry flow_canvas because pan is relative. Other mutations use the same resource identity and arguments when retrying. Cancel a Run explicitly with run_cancel. Use nextCursor and nextAfter to read subsequent pages. Connector-backed deployments may require a Team; inspect connector_teams before creating a Flow.";
 function tool(description, schema, readOnly, idempotent = true) {
 	return {
 		description,

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)