@oomol-lab/open-flow 0.1.0-alpha.10 → 0.1.0-alpha.13

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

@@ -126,6 +126,45 @@ function v(e, t, n) {
 	});
 }
 var y = [
+	{
+		name: "manages deployment Variables with stable limits and exact-case identity",
+		async verify(e) {
+			i(await c(await u(e, "/v1/variables"), 200, "List empty Variables"), {
+				variables: [],
+				version: 1
+			}, "Empty Variables");
+			let t = (t, n, r = { value: n }) => u(e, `/v1/variables/${encodeURIComponent(t)}`, {
+				body: JSON.stringify(r),
+				method: "PUT"
+			}), n = await c(await t("Token", ""), 200, "Create Variable");
+			i(Object.keys(n).toSorted(), [
+				"name",
+				"updatedAt",
+				"value",
+				"version"
+			], "Variable fields"), i(n.name, "Token", "Variable name"), i(n.value, "", "Empty Variable value"), i(n.version, 1, "Variable version"), s(n.updatedAt, "Variable updatedAt"), i(await c(await u(e, "/v1/variables/Token"), 200, "Read Variable"), n, "Read Variable"), i(await c(await t("Token", ""), 200, "Put same Variable"), n, "Same Variable update");
+			for (let e of [
+				"A",
+				"Z",
+				"a",
+				"token"
+			]) await c(await t(e, e), 200, `Create ${e} Variable`);
+			i(o((await c(await u(e, "/v1/variables"), 200, "List Variables")).variables, "Variables").map((e) => a(e, "Variable").name), [
+				"A",
+				"Token",
+				"Z",
+				"a",
+				"token"
+			], "Variable binary order");
+			let r = `${"值".repeat(21845)}x`;
+			i(new TextEncoder().encode(r).byteLength, 65536, "Variable UTF-8 boundary fixture"), await c(await t("BIG", r), 200, "Create maximum Variable value"), await l(await t("BIG", `${r}x`), 400, "variable.invalid", "Reject oversized Variable value"), await l(await t("OO_TOKEN", "value"), 400, "variable.invalid", "Reject reserved Variable name"), await l(await t("bad-name", "value"), 400, "variable.invalid", "Reject invalid Variable name"), await l(await t("EXTRA", "value", {
+				extra: !0,
+				value: "value"
+			}), 400, "variable.invalid", "Reject extra Variable field"), await l(await u(e, "/v1/variables/MISSING"), 404, "variable.not-found", "Read missing Variable"), await l(await u(e, "/v1/variables/MISSING", { method: "DELETE" }), 404, "variable.not-found", "Delete missing Variable"), i(await c(await u(e, "/v1/variables/Token", { method: "DELETE" }), 200, "Delete Variable"), { version: 1 }, "Delete response");
+			for (let e = 0; e < 195; e += 1) await c(await t(`V${String(e).padStart(3, "0")}`, "value"), 200, `Fill Variable ${e}`);
+			await l(await t("V195", "value"), 409, "variable.limit-reached", "Reject Variable over limit"), i((await c(await t("A", "updated"), 200, "Update full Variable catalog")).value, "updated", "Full catalog update");
+		}
+	},
 	{
 		name: "creates, replays, lists, reads, renames, and retires a Flow",
 		async verify(e) {

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

@@ -27,6 +27,9 @@ export declare const controlErrorCode: {
     readonly triggerKeyInvalid: 'trigger-key.invalid';
     readonly triggerKeyNotFound: 'trigger-key.not-found';
     readonly triggerNotFound: 'trigger.not-found';
+    readonly variableInvalid: 'variable.invalid';
+    readonly variableLimitReached: 'variable.limit-reached';
+    readonly variableNotFound: 'variable.not-found';
 };
 export type ControlErrorCode = (typeof controlErrorCode)[keyof typeof controlErrorCode];
 export declare const controlErrorMetadata: {
@@ -114,4 +117,13 @@ export declare const controlErrorMetadata: {
     readonly "trigger.not-found": {
         readonly status: 404;
     };
+    readonly "variable.invalid": {
+        readonly status: 400;
+    };
+    readonly "variable.limit-reached": {
+        readonly status: 409;
+    };
+    readonly "variable.not-found": {
+        readonly status: 404;
+    };
 };

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

@@ -20,6 +20,12 @@ export interface FlowPage {
     readonly total?: number;
     readonly version: 1;
 }
+export interface Variable {
+    readonly name: string;
+    readonly updatedAt: string;
+    readonly value: string;
+    readonly version: 1;
+}
 export interface TriggerKeySummary {
     readonly description: string;
     readonly displayName: string;
@@ -266,6 +272,13 @@ export declare class ControlClient {
         readonly includeTotal?: boolean;
         readonly limit?: number;
     }): Promise<FlowPage>;
+    listVariables(): Promise<{
+        readonly variables: readonly Variable[];
+        readonly version: 1;
+    }>;
+    getVariable(name: string): Promise<Variable>;
+    putVariable(name: string, value: string): Promise<Variable>;
+    deleteVariable(name: string): Promise<void>;
     createFlow(name: string, idempotencyKey?: string): Promise<Flow>;
     getFlow(flowId: string): Promise<Flow>;
     renameFlow(flowId: string, name: string): Promise<Flow>;

package/dist/common/control-api.js

@@ -27,7 +27,10 @@ var e = {
 	runOverloaded: "run.overloaded",
 	triggerKeyInvalid: "trigger-key.invalid",
 	triggerKeyNotFound: "trigger-key.not-found",
-	triggerNotFound: "trigger.not-found"
+	triggerNotFound: "trigger.not-found",
+	variableInvalid: "variable.invalid",
+	variableLimitReached: "variable.limit-reached",
+	variableNotFound: "variable.not-found"
 }, t = {
 	[e.authenticationRequired]: { status: 401 },
 	[e.authorizationDenied]: { status: 403 },
@@ -56,7 +59,10 @@ var e = {
 	[e.runOverloaded]: { status: 429 },
 	[e.triggerKeyInvalid]: { status: 409 },
 	[e.triggerKeyNotFound]: { status: 404 },
-	[e.triggerNotFound]: { status: 404 }
+	[e.triggerNotFound]: { status: 404 },
+	[e.variableInvalid]: { status: 400 },
+	[e.variableLimitReached]: { status: 409 },
+	[e.variableNotFound]: { status: 404 }
 }, n = [
 	"canceled",
 	"completed",
@@ -326,6 +332,27 @@ function O(e) {
 	};
 }
 function k(e) {
+	let t = a(e);
+	if (s(t, [
+		"name",
+		"updatedAt",
+		"value",
+		"version"
+	]), t.version != 1 || typeof t.value != "string") return i();
+	let n = o(t.updatedAt);
+	try {
+		if (new Date(n).toISOString() != n) return i();
+	} catch {
+		return i();
+	}
+	return {
+		name: o(t.name),
+		updatedAt: n,
+		value: t.value,
+		version: 1
+	};
+}
+function A(e) {
 	let t = a(e), n = t.parentRevisionId;
 	return t.version != 1 || n !== null && typeof n != "string" ? i() : {
 		actorId: o(t.actorId),
@@ -338,24 +365,24 @@ function k(e) {
 		version: 1
 	};
 }
-function A(e) {
+function j(e) {
 	let t = a(e), n = a(t.content);
 	return n.modelVersion == 1 ? (a(n.document), a(n.modules), {
-		...k(t),
+		...A(t),
 		content: t.content
 	}) : i();
 }
-function j(e) {
+function M(e) {
 	let t = a(e);
 	return t.version == 1 ? {
-		revision: k(t.revision),
+		revision: A(t.revision),
 		version: 1
 	} : i();
 }
-function M(e) {
+function N(e) {
 	let t = a(e);
 	return t.version == 1 ? t.kind == "snapshot" ? {
-		draft: A(t.draft),
+		draft: j(t.draft),
 		kind: "snapshot",
 		version: 1
 	} : t.kind != "changes" || !Array.isArray(t.revisions) ? i() : {
@@ -366,13 +393,13 @@ function M(e) {
 			for (let e of t.operations) if (typeof a(e).kind != "string") return i();
 			return {
 				operations: t.operations,
-				revision: k(t.revision)
+				revision: A(t.revision)
 			};
 		}),
 		version: 1
 	} : i();
 }
-function N(e) {
+function P(e) {
 	let t = a(e), n = t.operation, r = t.sourcePublicationId;
 	return t.version != 1 || n != "publish" && n != "rollback" || r != null && typeof r != "string" ? i() : {
 		actorId: o(t.actorId),
@@ -389,7 +416,7 @@ function N(e) {
 		version: 1
 	};
 }
-function P(e) {
+function F(e) {
 	let t = a(e);
 	return {
 		code: o(t.code),
@@ -399,11 +426,11 @@ function P(e) {
 		path: typeof t.path == "string" ? t.path : i()
 	};
 }
-function F(e) {
+function I(e) {
 	let t = a(e);
 	return t.version != 1 || typeof t.valid != "boolean" || !Array.isArray(t.diagnostics) ? i() : {
 		closureDigest: o(t.closureDigest),
-		diagnostics: t.diagnostics.map(P),
+		diagnostics: t.diagnostics.map(F),
 		engineContract: o(t.engineContract),
 		flowId: o(t.flowId),
 		modelVersion: c(t.modelVersion),
@@ -413,31 +440,31 @@ function F(e) {
 		version: 1
 	};
 }
-function I(e) {
+function L(e) {
 	let t = a(e), n = t.status, r = t.publication;
 	return t.version != 1 || typeof t.hasUnpublishedChanges != "boolean" || n != "not-published" && n != "runnable" && n != "suspended" || n == "not-published" && r !== null || n != "not-published" && r === null ? i() : {
 		flowId: o(t.flowId),
 		hasUnpublishedChanges: t.hasUnpublishedChanges,
-		publication: r === null ? null : N(r),
+		publication: r === null ? null : P(r),
 		revision: c(t.revision),
 		status: n,
 		version: 1
 	};
 }
-function L(e) {
+function R(e) {
 	let t = a(e), n = t.nextCursor, r = t.total;
 	return t.version != 1 || !Array.isArray(t.publications) || n != null && typeof n != "string" || r != null && !Number.isSafeInteger(r) ? i() : {
 		...n == null ? {} : { nextCursor: n },
-		publications: t.publications.map(N),
+		publications: t.publications.map(P),
 		...r == null ? {} : { total: r },
 		version: 1
 	};
 }
-var R = new Set(n);
-function z(e) {
-	return typeof e == "string" && R.has(e) ? e : i();
-}
+var z = new Set(n);
 function B(e) {
+	return typeof e == "string" && z.has(e) ? e : i();
+}
+function V(e) {
 	let t = a(e), n = t.source, r = t.startedAt, s = t.finishedAt;
 	return t.version != 1 || n != "draft" && n != "live" && n != "trigger" || r != null && typeof r != "string" || s != null && typeof s != "string" ? i() : {
 		createdAt: o(t.createdAt),
@@ -447,12 +474,12 @@ function B(e) {
 		runId: o(t.runId),
 		source: n,
 		...r == null ? {} : { startedAt: r },
-		status: z(t.status),
+		status: B(t.status),
 		version: 1
 	};
 }
-function V(e) {
-	let t = a(e), n = B(t), r = t.eventsExpiresAt;
+function H(e) {
+	let t = a(e), n = V(t), r = t.eventsExpiresAt;
 	if (r != null && typeof r != "string") return i();
 	let s = {
 		...n,
@@ -482,16 +509,16 @@ function V(e) {
 		};
 	}
 }
-function H(e) {
+function U(e) {
 	let t = a(e), n = t.nextCursor;
 	return t.version != 1 || !Array.isArray(t.runs) || n != null && typeof n != "string" ? i() : {
 		flowId: o(t.flowId),
 		...n == null ? {} : { nextCursor: n },
-		runs: t.runs.map(B),
+		runs: t.runs.map(V),
 		version: 1
 	};
 }
-var U = /* @__PURE__ */ new Set([
+var W = /* @__PURE__ */ new Set([
 	"node.artifact",
 	"node.completed",
 	"node.failed",
@@ -508,9 +535,9 @@ var U = /* @__PURE__ */ new Set([
 	"run.queued",
 	"run.started"
 ]);
-function W(e) {
+function G(e) {
 	let t = a(e), n = t.kind, r = c(t.sequence), s = t.sourceSequence;
-	return typeof n != "string" || !U.has(n) || r < 0 || s != null && (!Number.isSafeInteger(s) || s < 0) ? i() : {
+	return typeof n != "string" || !W.has(n) || r < 0 || s != null && (!Number.isSafeInteger(s) || s < 0) ? i() : {
 		createdAt: o(t.createdAt),
 		kind: n,
 		payload: a(t.payload),
@@ -518,11 +545,11 @@ function W(e) {
 		...s == null ? {} : { sourceSequence: s }
 	};
 }
-function G(e) {
+function K(e) {
 	let t = a(e), n = t.eventsExpiresAt, r = c(t.nextAfter);
 	return t.version != 1 || !Array.isArray(t.events) || typeof t.done != "boolean" || typeof t.historyComplete != "boolean" || n != null && typeof n != "string" || r < 0 ? i() : {
 		done: t.done,
-		events: t.events.map(W),
+		events: t.events.map(G),
 		...n == null ? {} : { eventsExpiresAt: n },
 		historyComplete: t.historyComplete,
 		nextAfter: r,
@@ -530,8 +557,8 @@ function G(e) {
 		version: 1
 	};
 }
-function K(e) {
-	let t = a(e), n = z(t.status);
+function q(e) {
+	let t = a(e), n = B(t.status);
 	return t.version != 1 || typeof t.cancelAccepted != "boolean" || n == "queued" || n == "starting" || n == "running" ? i() : {
 		cancelAccepted: t.cancelAccepted,
 		runId: o(t.runId),
@@ -539,7 +566,7 @@ function K(e) {
 		version: 1
 	};
 }
-function q(e) {
+function J(e) {
 	let t = a(e), n = t.status;
 	if (t.version != 1) return i();
 	let r = {
@@ -580,11 +607,11 @@ function q(e) {
 	}
 	return i();
 }
-var J = encodeURIComponent;
-function Y(e) {
+var Y = encodeURIComponent;
+function X(e) {
 	return `${e}-${crypto.randomUUID()}`;
 }
-var X = class {
+var Z = class {
 	constructor(e) {
 		this.requestControl = e;
 	}
@@ -594,6 +621,26 @@ var X = class {
 		let n = t.size == 0 ? "" : `?${t}`;
 		return O(await this.request(`/v1/flows${n}`));
 	}
+	async listVariables() {
+		let e = a(await this.request("/v1/variables"));
+		return s(e, ["variables", "version"]), e.version != 1 || !Array.isArray(e.variables) ? i() : {
+			variables: e.variables.map(k),
+			version: 1
+		};
+	}
+	async getVariable(e) {
+		return k(await this.request(`/v1/variables/${Y(e)}`));
+	}
+	async putVariable(e, t) {
+		return k(await this.request(`/v1/variables/${Y(e)}`, {
+			body: JSON.stringify({ value: t }),
+			method: "PUT"
+		}));
+	}
+	async deleteVariable(e) {
+		let t = a(await this.request(`/v1/variables/${Y(e)}`, { method: "DELETE" }));
+		if (s(t, ["version"]), t.version != 1) return i();
+	}
 	async createFlow(e, t = `flow-${crypto.randomUUID()}`) {
 		return D(await this.request("/v1/flows", {
 			body: JSON.stringify({
@@ -605,10 +652,10 @@ var X = class {
 		}));
 	}
 	async getFlow(e) {
-		return D(await this.request(`/v1/flows/${J(e)}`));
+		return D(await this.request(`/v1/flows/${Y(e)}`));
 	}
 	async renameFlow(e, t) {
-		return D(await this.request(`/v1/flows/${J(e)}`, {
+		return D(await this.request(`/v1/flows/${Y(e)}`, {
 			body: JSON.stringify({
 				name: t,
 				version: 1
@@ -617,7 +664,7 @@ var X = class {
 		}));
 	}
 	async deleteFlow(e) {
-		return D(await this.request(`/v1/flows/${J(e)}`, { method: "DELETE" }));
+		return D(await this.request(`/v1/flows/${Y(e)}`, { method: "DELETE" }));
 	}
 	async listTriggerKeys(e) {
 		let t = a(await this.request("/v1/trigger-keys", { signal: e }));
@@ -628,49 +675,49 @@ var X = class {
 		return t.version != 1 || !Array.isArray(t.definitions) ? i() : t.definitions.map(_);
 	}
 	async getTriggerKey(e, t) {
-		let n = a(await this.request(`/v1/trigger-keys/${J(e)}`, { signal: t }));
+		let n = a(await this.request(`/v1/trigger-keys/${Y(e)}`, { signal: t }));
 		return n.version == 1 ? _(n.definition) : i();
 	}
 	async listFlowTriggerBindings(e) {
-		let t = a(await this.request(`/v1/flows/${J(e)}/triggers`));
+		let t = a(await this.request(`/v1/flows/${Y(e)}/triggers`));
 		return t.version != 1 || o(t.flowId) != e || !Array.isArray(t.bindings) ? i() : t.bindings.map(S);
 	}
 	async getFlowTriggerBinding(e, t) {
-		return C(await this.request(`/v1/flows/${J(e)}/triggers/${J(t)}`));
+		return C(await this.request(`/v1/flows/${Y(e)}/triggers/${Y(t)}`));
 	}
 	async listFlowTriggerActivities(e, t, n = {}) {
 		let r = new URLSearchParams();
 		n.cursor != null && r.set("cursor", n.cursor), n.limit != null && r.set("limit", String(n.limit));
 		let i = r.size == 0 ? "" : `?${r}`;
-		return T(await this.request(`/v1/flows/${J(e)}/triggers/${J(t)}/activities${i}`));
+		return T(await this.request(`/v1/flows/${Y(e)}/triggers/${Y(t)}/activities${i}`));
 	}
 	async pauseFlowTrigger(e, t) {
-		return S(await this.request(`/v1/flows/${J(e)}/triggers/${J(t)}/pause`, {
+		return S(await this.request(`/v1/flows/${Y(e)}/triggers/${Y(t)}/pause`, {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		}));
 	}
 	async resumeFlowTrigger(e, t) {
-		return S(await this.request(`/v1/flows/${J(e)}/triggers/${J(t)}/resume`, {
+		return S(await this.request(`/v1/flows/${Y(e)}/triggers/${Y(t)}/resume`, {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		}));
 	}
 	async testFlowPollTrigger(e, t) {
-		return E(await this.request(`/v1/flows/${J(e)}/triggers/${J(t)}/test`, {
+		return E(await this.request(`/v1/flows/${Y(e)}/triggers/${Y(t)}/test`, {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		}));
 	}
 	async getDraft(e) {
-		return A(await this.request(`/v1/flows/${J(e)}/draft`));
+		return j(await this.request(`/v1/flows/${Y(e)}/draft`));
 	}
 	async syncDraft(e, t) {
-		let n = t == null ? "" : `?fromRevisionId=${J(t)}`;
-		return M(await this.request(`/v1/flows/${J(e)}/draft/sync${n}`));
+		let n = t == null ? "" : `?fromRevisionId=${Y(t)}`;
+		return N(await this.request(`/v1/flows/${Y(e)}/draft/sync${n}`));
 	}
 	async getRevision(e, t) {
-		return A(await this.request(`/v1/flows/${J(e)}/revisions/${J(t)}`));
+		return j(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}`));
 	}
 	async listConnectorProviders(e) {
 		let t = a(await this.request("/v1/connector/providers", { signal: e }));
@@ -683,11 +730,11 @@ var X = class {
 		return await this.connectorActions({ q: e.trim() }, t);
 	}
 	async getConnectorAction(e, t) {
-		let n = a(await this.request(`/v1/connector/actions/${J(e)}`, { signal: t }));
+		let n = a(await this.request(`/v1/connector/actions/${Y(e)}`, { signal: t }));
 		return s(n, ["action", "version"]), n.version == 1 ? m(n.action) : i();
 	}
 	async listConnectorConnections(e, t) {
-		let n = a(await this.request(`/v1/connector/connections/${J(e)}`, { signal: t }));
+		let n = a(await this.request(`/v1/connector/connections/${Y(e)}`, { signal: t }));
 		return s(n, [
 			"connections",
 			"serviceId",
@@ -695,7 +742,7 @@ var X = class {
 		]), n.version != 1 || o(n.serviceId) != e || !Array.isArray(n.connections) ? i() : n.connections.map(u);
 	}
 	async createConnectorConnectionPage(e) {
-		let t = a(await this.request(`/v1/connector/connections/${J(e)}/page`, {
+		let t = a(await this.request(`/v1/connector/connections/${Y(e)}/page`, {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		}));
@@ -708,7 +755,7 @@ var X = class {
 		}
 	}
 	async changeDraft(e, t, n) {
-		return j(await this.request(`/v1/flows/${J(e)}/draft/changes`, {
+		return M(await this.request(`/v1/flows/${Y(e)}/draft/changes`, {
 			body: JSON.stringify({
 				expectedRevisionId: t,
 				operations: n,
@@ -718,7 +765,7 @@ var X = class {
 		}));
 	}
 	async checkFlow(e, t) {
-		return F(await this.request(`/v1/flows/${J(e)}/revisions/${J(t)}/check`, {
+		return I(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}/check`, {
 			body: JSON.stringify({
 				engineContract: "open-flow-engine/v1",
 				version: 1
@@ -727,85 +774,85 @@ var X = class {
 		}));
 	}
 	async getLive(e) {
-		return I(await this.request(`/v1/flows/${J(e)}/live`));
+		return L(await this.request(`/v1/flows/${Y(e)}/live`));
 	}
 	async listPublications(e, t = {}) {
 		let n = new URLSearchParams();
 		t.cursor != null && n.set("cursor", t.cursor), t.limit != null && n.set("limit", String(t.limit)), t.includeTotal != null && n.set("includeTotal", String(t.includeTotal));
 		let r = n.size == 0 ? "" : `?${n}`;
-		return L(await this.request(`/v1/flows/${J(e)}/publications${r}`));
+		return R(await this.request(`/v1/flows/${Y(e)}/publications${r}`));
 	}
 	async createDraftRun(e, t, n = {}) {
-		let r = V(await this.request(`/v1/flows/${J(e)}/revisions/${J(t)}/runs`, {
+		let r = H(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}/runs`, {
 			body: JSON.stringify({
 				engineContract: "open-flow-engine/v1",
 				inputs: n.inputs ?? {},
 				version: 1
 			}),
-			headers: { "idempotency-key": n.idempotencyKey ?? Y("run") },
+			headers: { "idempotency-key": n.idempotencyKey ?? X("run") },
 			method: "POST"
 		}));
 		return r.source == "draft" ? r : i();
 	}
 	async createLiveRun(e, t = {}) {
-		let n = V(await this.request("/v1/runs", {
+		let n = H(await this.request("/v1/runs", {
 			body: JSON.stringify({
 				inputs: t.inputs ?? {},
 				publicationId: e,
 				version: 1
 			}),
-			headers: { "idempotency-key": t.idempotencyKey ?? Y("run") },
+			headers: { "idempotency-key": t.idempotencyKey ?? X("run") },
 			method: "POST"
 		}));
 		return n.source == "live" ? n : i();
 	}
 	async publishFlow(e, t, n, r = {}) {
-		return N(await this.request(`/v1/flows/${J(e)}/revisions/${J(t)}/publications`, {
+		return P(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}/publications`, {
 			body: JSON.stringify({
 				engineContract: "open-flow-engine/v1",
 				expectedLivePublicationId: n,
 				version: 1
 			}),
-			headers: { "idempotency-key": r.idempotencyKey ?? Y("publication") },
+			headers: { "idempotency-key": r.idempotencyKey ?? X("publication") },
 			method: "POST"
 		}));
 	}
 	async rollbackFlow(e, t, n, r = {}) {
-		return N(await this.request(`/v1/flows/${J(e)}/publications/${J(t)}/rollback`, {
+		return P(await this.request(`/v1/flows/${Y(e)}/publications/${Y(t)}/rollback`, {
 			body: JSON.stringify({
 				expectedLivePublicationId: n,
 				version: 1
 			}),
-			headers: { "idempotency-key": r.idempotencyKey ?? Y("publication") },
+			headers: { "idempotency-key": r.idempotencyKey ?? X("publication") },
 			method: "POST"
 		}));
 	}
 	async getRun(e) {
-		return V(await this.request(`/v1/runs/${J(e)}`));
+		return H(await this.request(`/v1/runs/${Y(e)}`));
 	}
 	async listRuns(e, t = {}) {
 		let n = new URLSearchParams();
 		t.cursor != null && n.set("cursor", t.cursor), t.limit != null && n.set("limit", String(t.limit)), t.status != null && n.set("status", t.status);
 		let r = n.size == 0 ? "" : `?${n}`;
-		return H(await this.request(`/v1/flows/${J(e)}/runs${r}`));
+		return U(await this.request(`/v1/flows/${Y(e)}/runs${r}`));
 	}
 	async getRunEvents(e, t = {}) {
 		let n = new URLSearchParams();
 		t.after != null && n.set("after", String(t.after)), t.limit != null && n.set("limit", String(t.limit));
 		let r = n.size == 0 ? "" : `?${n}`;
-		return G(await this.request(`/v1/runs/${J(e)}/events${r}`));
+		return K(await this.request(`/v1/runs/${Y(e)}/events${r}`));
 	}
 	async getRunResult(e) {
-		return q(await this.request(`/v1/runs/${J(e)}/result`));
+		return J(await this.request(`/v1/runs/${Y(e)}/result`));
 	}
 	async cancelRun(e) {
-		return K(await this.request(`/v1/runs/${J(e)}/cancel`, {
+		return q(await this.request(`/v1/runs/${Y(e)}/cancel`, {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		}));
 	}
 	async connectorActions(e, t) {
-		let n = Object.entries(e).map(([e, t]) => `${J(e)}=${J(t)}`).join("&"), r = n == "" ? "" : `?${n}`, o = a(await this.request(`/v1/connector/actions${r}`, { signal: t }));
+		let n = Object.entries(e).map(([e, t]) => `${Y(e)}=${Y(t)}`).join("&"), r = n == "" ? "" : `?${n}`, o = a(await this.request(`/v1/connector/actions${r}`, { signal: t }));
 		return s(o, ["actions", "version"]), o.version != 1 || !Array.isArray(o.actions) ? i() : o.actions.map(m);
 	}
 	async request(e, t = {}) {
@@ -828,4 +875,4 @@ var X = class {
 	}
 };
 //#endregion
-export { r as ApiError, X as ControlClient, e as controlErrorCode, t as controlErrorMetadata };
+export { r as ApiError, Z as ControlClient, e as controlErrorCode, t as controlErrorMetadata };

package/dist/common/flow-encoding.d.ts

@@ -1,8 +1,8 @@
-import type { CodeModule, FlowDocument, Graph, InputPort, JsonValue, OutputMapping, Port, RevisionContent } from '@oomol-lab/open-flow/flow-change';
+import type { CodeModule, FlowDocument, Graph, Group, InputPort, JsonValue, OutputMapping, Port, RevisionContent } from '@oomol-lab/open-flow/flow-change';
 export declare const maxJsonDepth = 64;
 export declare function canonicalJsonBytes(value: JsonValue): Uint8Array;
 export declare function digestBytes(bytes: Uint8Array): Promise<string>;
-export declare function canonicalPorts(value: readonly (InputPort | Port)[]): JsonValue;
+export declare function canonicalPorts(value: readonly (InputPort | Port | Group)[]): JsonValue;
 export declare function canonicalOutputs(value: readonly (OutputMapping & Port)[]): JsonValue;
 export declare function canonicalGraph(value: Graph): JsonValue;
 export declare function canonicalTask(task: FlowDocument['tasks'][string]): JsonValue;

package/dist/common/flow-encoding.js

@@ -17,12 +17,15 @@ function a(e) {
 	return Object.keys(e).toSorted().map((t) => [t, e[t]]);
 }
 function o(e) {
-	return {
+	return "handle" in e ? {
 		...e.description == null ? {} : { description: e.description },
 		handle: e.handle,
 		jsonSchema: e.jsonSchema,
 		nullable: e.nullable,
 		...Object.hasOwn(e, "value") ? { value: e.value } : {}
+	} : e.collapsed == null ? { group: e.group } : {
+		collapsed: e.collapsed,
+		group: e.group
 	};
 }
 function s(e) {

package/dist/common/flow-semantics.d.ts

@@ -12,6 +12,7 @@ export interface SemanticClosure {
     readonly digest: string;
 }
 export declare function flowClosure(content: RevisionContent): Promise<SemanticClosure>;
+export declare function variableBindings(revision: RevisionContent, bindingIds: Iterable<string>): Readonly<Record<string, string>>;
 export interface Diagnostic {
     readonly code: string;
     readonly column: number;
@@ -26,6 +27,7 @@ export interface FlowValidation {
 }
 export declare function triggerPayloadSchema(trigger: TriggerNode): JsonValue;
 export declare function matchesSchema(value: JsonValue, schema: JsonValue): boolean;
+export declare function variableInputCompatible(jsonSchema: JsonValue): boolean;
 export type FlowInputsValidation = 'invalid' | 'valid';
 export declare function validateFlowInputs(revision: RevisionContent, value: unknown): FlowInputsValidation;
 export declare function validateModules(revision: RevisionContent, moduleIds: readonly string[], engine: EngineContract): readonly Diagnostic[];