@oomol-lab/open-flow 0.1.0-alpha.9 → 0.1.0-beta.2

package/dist/common/connector-action.d.ts

@@ -17,4 +17,10 @@ export interface ConnectorActionPorts {
         readonly nullable: boolean;
     }[];
 }
+export interface ConnectorRuntimeInputPort {
+    readonly handle: string;
+    readonly jsonSchema: unknown;
+    readonly nullable: boolean;
+}
 export declare function connectorActionPorts(inputSchema: unknown, outputSchema: unknown): ConnectorActionPorts;
+export declare function normalizeConnectorRuntimeInputs<Value>(ports: readonly ConnectorRuntimeInputPort[], inputs: Readonly<Record<string, Value>>): Readonly<Record<string, Value>>;

package/dist/common/connector-action.js

@@ -3,82 +3,90 @@ var e = Array.isArray, t = (e) => typeof e == "object" && !!e, n = (n) => t(n) &
 //#endregion
 //#region src/connector/common/actionSchema.ts
 function i(e, t) {
-	let n = a(e);
+	let n = o(e);
 	return {
 		inputs: n,
 		initialInputs: n.flatMap((e) => e.value === void 0 ? [] : [{
 			handle: e.handle,
 			value: e.value
 		}]),
-		outputs: o(t)
+		outputs: s(t)
 	};
 }
-function a(e) {
+function a(e, t) {
+	let n = new Map(e.map((e) => [e.handle, e])), r = {};
+	for (let [e, i] of Object.entries(t)) {
+		let t = n.get(e);
+		i == null && t?.nullable == 1 && !f(t.jsonSchema) || (r[e] = i);
+	}
+	return r;
+}
+function o(e) {
 	let t = r(e);
 	if (t == null || t.type != "object" && t.properties == null) throw Error("Connector action inputSchema must be an object schema.");
 	let n = r(t.properties);
 	if (n == null) return [];
-	let i = u(t.required);
+	let i = d(t.required);
 	return Object.entries(n).map(([e, n]) => {
-		let r = !i.has(e) || d(n, t);
+		let r = !i.has(e) || f(n, t);
 		return {
-			description: c(t, n),
+			description: l(t, n),
 			handle: e,
-			json_schema: s(t, n),
+			json_schema: c(t, n),
 			nullable: r,
-			value: l(t, n, r)
+			value: u(t, n, r)
 		};
 	});
 }
-function o(e) {
+function s(e) {
 	let t = r(e), n = r(t?.properties);
 	if (t != null && (t.type == "object" || n != null)) {
 		if (n == null) return [];
-		let e = u(t.required);
+		let e = d(t.required);
 		return Object.entries(n).map(([n, r]) => ({
-			description: c(t, r),
+			description: l(t, r),
 			handle: n,
-			json_schema: s(t, r),
-			nullable: !e.has(n) || d(r, t)
+			json_schema: c(t, r),
+			nullable: !e.has(n) || f(r, t)
 		}));
 	}
 	return [{
-		description: c(t, e),
+		description: l(t, e),
 		handle: "output",
 		json_schema: e,
-		nullable: d(e)
+		nullable: f(e)
 	}];
 }
-function s(e, t) {
+function c(e, t) {
 	let n = r(t);
 	if (n == null) return t;
 	let i = Object.assign({}, n);
 	return i.$defs == null && e.$defs != null && (i.$defs = e.$defs), i.definitions == null && e.definitions != null && (i.definitions = e.definitions), i;
 }
-function c(e, t) {
-	for (let n of f(e, t)) if (typeof n.description == "string") return n.description;
+function l(e, t) {
+	for (let n of p(e, t)) if (typeof n.description == "string") return n.description;
 }
-function l(e, t, n) {
-	for (let n of f(e, t)) if (Object.hasOwn(n, "default")) return n.default;
+function u(e, t, n) {
+	for (let n of p(e, t)) if (Object.hasOwn(n, "default")) return n.default;
 	return n ? null : void 0;
 }
-function u(e) {
+function d(e) {
 	return Array.isArray(e) ? new Set(e.filter((e) => typeof e == "string")) : /* @__PURE__ */ new Set();
 }
-function d(e, t = e, n = /* @__PURE__ */ new Set()) {
+function f(e, t = e, n = /* @__PURE__ */ new Set()) {
 	let i = r(e);
 	if (i == null) return !1;
 	if (Object.hasOwn(i, "type")) return i.type == "null" || Array.isArray(i.type) && i.type.includes("null");
 	if (Object.hasOwn(i, "enum")) return Array.isArray(i.enum) && i.enum.includes(null);
-	for (let e of ["anyOf", "oneOf"]) if (Object.hasOwn(i, e)) return Array.isArray(i[e]) && i[e].some((e) => d(e, t, n));
+	for (let e of ["anyOf", "oneOf"]) if (Object.hasOwn(i, e)) return Array.isArray(i[e]) && i[e].some((e) => f(e, t, n));
 	let a = typeof i.$ref == "string" ? i.$ref : void 0;
 	if (a == null || n.has(a)) return !1;
-	let o = p(t, a);
+	let o = m(t, a);
 	if (o === void 0) return !1;
 	let s = new Set(n);
-	return s.add(a), d(o, t, s);
+	return s.add(a), f(o, t, s);
 }
-function f(e, t) {
+function p(e, t) {
 	let n = [], i = /* @__PURE__ */ new Set(), a = t;
 	for (;;) {
 		let t = r(a);
@@ -86,12 +94,12 @@ function f(e, t) {
 		n.push(t);
 		let o = typeof t.$ref == "string" ? t.$ref : void 0;
 		if (o == null || i.has(o)) return n;
-		let s = p(e, o);
+		let s = m(e, o);
 		if (s === void 0) return n;
 		i.add(o), a = s;
 	}
 }
-function p(e, t) {
+function m(e, t) {
 	if (t == "#") return e;
 	if (!t.startsWith("#/")) return;
 	let n = e;
@@ -103,4 +111,4 @@ function p(e, t) {
 	return n;
 }
 //#endregion
-export { i as connectorActionPorts };
+export { i as connectorActionPorts, a as normalizeConnectorRuntimeInputs };

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

@@ -104,7 +104,17 @@ function g(e, t, r, i, a) {
 		method: "POST"
 	});
 }
-function _(e, t, n, r, i) {
+async function _(e, t, n, r) {
+	let o = await c(t, n, r), l = s(o.operationId, `${r} operationId`);
+	for (let t = 0; o.status == "pending" && t < 100; t += 1) await new Promise((e) => setTimeout(e, 10)), o = await c(await u(e, `/v1/flows/${s(o.flowId, `${r} flowId`)}/publish-operations/${l}`), 200, `${r} operation`);
+	i(o.status, "succeeded", `${r} terminal status`);
+	let d = s(o.publicationId, `${r} publicationId`), f = a((await c(await u(e, `/v1/flows/${s(o.flowId, `${r} flowId`)}/live`), 200, `${r} Live`)).publication, `${r} Publication`);
+	return i(f.publicationId, d, `${r} Live Publication`), {
+		operation: o,
+		publication: f
+	};
+}
+function v(e, t, n, r, i) {
 	return u(e, `/v1/flows/${encodeURIComponent(t)}/publications/${encodeURIComponent(n)}/rollback`, {
 		body: JSON.stringify({
 			expectedLivePublicationId: r,
@@ -114,7 +124,7 @@ function _(e, t, n, r, i) {
 		method: "POST"
 	});
 }
-function v(e, t, n) {
+function y(e, t, n) {
 	return u(e, "/v1/runs", {
 		body: JSON.stringify({
 			inputs: {},
@@ -125,7 +135,46 @@ function v(e, t, n) {
 		method: "POST"
 	});
 }
-var y = [
+var b = [
+	{
+		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) {
@@ -221,7 +270,7 @@ var y = [
 				method: "POST"
 			}), h = await c(await m(), 202, "Create Draft Run"), g = s(h.runId, "Draft Run runId");
 			i(await c(await m(), 200, "Replay Draft Run"), h, "Replayed Draft Run"), await l(await u(e, `/v1/runs/${g}/result`), 409, "run.not-terminal", "Read queued Run result");
-			let _ = await c(await u(e, p, {
+			let _ = s((await c(await u(e, p, {
 				body: JSON.stringify({
 					engineContract: n,
 					inputs: {},
@@ -229,11 +278,13 @@ var y = [
 				}),
 				headers: { "idempotency-key": "draft-run-second" },
 				method: "POST"
-			}), 202, "Create second Draft Run"), v = await c(await u(e, `/v1/flows/${r}/runs?limit=1`), 200, "List Runs");
-			i(o(v.runs, "Runs").map((e) => a(e, "Run").runId), [g], "Listed Runs"), s(v.nextCursor, "Run cursor"), i((await c(await u(e, `/v1/runs/${g}/cancel`, {
+			}), 202, "Create second Draft Run")).runId, "Second Draft Run"), v = await c(await u(e, `/v1/flows/${r}/runs?limit=1`), 200, "List Runs");
+			i(o(v.runs, "Runs").map((e) => a(e, "Run").runId), [_], "Listed Runs");
+			let y = s(v.nextCursor, "Run cursor");
+			i(o((await c(await u(e, `/v1/flows/${r}/runs?limit=1&cursor=${encodeURIComponent(y)}`), 200, "List next Runs")).runs, "Next Runs").map((e) => a(e, "Run").runId), [g], "Listed next Runs"), i((await c(await u(e, `/v1/runs/${g}/cancel`, {
 				body: JSON.stringify({ version: 1 }),
 				method: "POST"
-			}), 200, "Cancel Run")).status, "canceled", "Canceled Run status"), i((await c(await u(e, `/v1/runs/${g}/result`), 200, "Read canceled Run result")).status, "canceled", "Canceled Run result"), i((await c(await u(e, `/v1/runs/${g}/events`), 200, "Read canceled Run events")).done, !0, "Canceled Run events"), i((await c(await u(e, `/v1/runs/${s(_.runId, "Second Draft Run")}/cancel`, {
+			}), 200, "Cancel Run")).status, "canceled", "Canceled Run status"), i((await c(await u(e, `/v1/runs/${g}/result`), 200, "Read canceled Run result")).status, "canceled", "Canceled Run result"), i((await c(await u(e, `/v1/runs/${g}/events`), 200, "Read canceled Run events")).done, !0, "Canceled Run events"), i((await c(await u(e, `/v1/runs/${_}/cancel`, {
 				body: JSON.stringify({ version: 1 }),
 				method: "POST"
 			}), 200, "Cancel second Draft Run")).status, "canceled", "Second canceled Run status");
@@ -280,35 +331,35 @@ var y = [
 			await l(await p(c, "unsupported-engine/v1", "unsupported-run"), 409, "engine.unsupported", "Run unsupported Engine"), await l(await p(r, n, "missing-revision-run"), 404, "flow.not-found", "Run missing Revision");
 		}
 	}
-], b = [{
+], x = [{
 	name: "publishes one immutable Flow with idempotent Live CAS",
 	async verify(e) {
 		let t = await f(e, "Publication flow", "publication-flow"), n = s(t.flowId, "Publication Flow flowId"), r = s(t.draftRevisionId, "Publication Flow revisionId");
 		i((await c(await u(e, `/v1/flows/${n}/live`), 200, "Read Live")).status, "not-published", "Initial Live status");
-		let a = () => g(e, n, r, null, "publication-first"), o = await c(await a(), 201, "Publish Flow"), d = s(o.publicationId, "Publication id");
-		i(await c(await a(), 200, "Replay Publish"), o, "Replayed Publication"), await l(await g(e, n, r, d, "publication-first"), 409, "publication.conflict", "Conflicting replay"), i((await c(await u(e, `/v1/flows/${n}/live`), 200, "Read published Live")).publication, o, "Live Publication");
-		let p = await c(await u(e, `/v1/flows/${n}/publications?includeTotal=true`), 200, "List Publications");
-		i(p.publications, [o], "Publication history"), i(p.total, 1, "Publication total"), await l(await u(e, `/v1/flows/${n}/revisions/${r}/publications`, {
+		let a = () => g(e, n, r, null, "publication-first"), o = await _(e, await a(), 202, "Publish Flow"), d = o.publication, p = s(d.publicationId, "Publication id");
+		i(await c(await a(), 202, "Replay Publish"), o.operation, "Replayed Publish operation"), await l(await g(e, n, r, p, "publication-first"), 409, "publication.conflict", "Conflicting replay"), i((await c(await u(e, `/v1/flows/${n}/live`), 200, "Read published Live")).publication, d, "Live Publication");
+		let m = await c(await u(e, `/v1/flows/${n}/publications?includeTotal=true`), 200, "List Publications");
+		i(m.publications, [d], "Publication history"), i(m.total, 1, "Publication total"), await l(await u(e, `/v1/flows/${n}/revisions/${r}/publications`, {
 			body: JSON.stringify({
 				engineContract: "unsupported-engine/v1",
-				expectedLivePublicationId: d,
+				expectedLivePublicationId: p,
 				version: 1
 			}),
 			headers: { "idempotency-key": "unsupported-publication" },
 			method: "POST"
-		}), 409, "engine.unsupported", "Publish unsupported Engine"), await l(await g(e, n, "00000000-0000-7000-8000-000000000002", d, "missing-revision-publication"), 404, "flow.not-found", "Publish missing Revision"), await l(await _(e, n, "00000000-0000-7000-8000-000000000004", d, "missing-rollback"), 404, "publication.not-found", "Rollback missing Publication"), await l(await v(e, "00000000-0000-7000-8000-000000000004", "missing-publication-run"), 404, "publication.not-found", "Run missing Publication");
+		}), 409, "engine.unsupported", "Publish unsupported Engine"), await l(await g(e, n, "00000000-0000-7000-8000-000000000002", p, "missing-revision-publication"), 404, "flow.not-found", "Publish missing Revision"), await l(await v(e, n, "00000000-0000-7000-8000-000000000004", p, "missing-rollback"), 404, "publication.not-found", "Rollback missing Publication"), await l(await y(e, "00000000-0000-7000-8000-000000000004", "missing-publication-run"), 404, "publication.not-found", "Run missing Publication");
 	}
 }, {
 	name: "rolls back immutable history and fixes a Live Run target",
 	async verify(e) {
-		let t = await f(e, "Rollback flow", "rollback-flow"), n = s(t.flowId, "Rollback Flow flowId"), r = s(t.draftRevisionId, "Rollback Flow revisionId"), a = s((await c(await g(e, n, r, null, "publish-first"), 201, "Publish first Revision")).publicationId, "First Publication"), o = s((await c(await g(e, n, h(await c(await m(e, n, r), 200, "Change Draft"), "Second Revision"), a, "publish-second"), 201, "Publish second Revision")).publicationId, "Second Publication");
-		await l(await v(e, a, "stale-live-run"), 412, "live.conflict", "Run stale Publication");
-		let d = () => _(e, n, a, o, "rollback-first"), p = await c(await d(), 201, "Rollback Flow"), y = s(p.publicationId, "Rollback Publication");
-		i(p.operation, "rollback", "Rollback operation"), i(p.sourcePublicationId, a, "Rollback source"), i(await c(await d(), 200, "Replay Rollback"), p, "Replayed Rollback");
-		let b = await c(await v(e, y, "rollback-run"), 202, "Create Live Run");
-		i(b.flowId, n, "Live Run flowId"), i(b.revisionId, r, "Live Run revisionId"), await c(await u(e, `/v1/flows/${n}`, { method: "DELETE" }), 202, "Retire Flow"), await l(await v(e, y, "retired-run"), 409, "flow.busy", "Run retired Flow");
+		let t = await f(e, "Rollback flow", "rollback-flow"), n = s(t.flowId, "Rollback Flow flowId"), r = s(t.draftRevisionId, "Rollback Flow revisionId"), a = (await _(e, await g(e, n, r, null, "publish-first"), 202, "Publish first Revision")).publication, o = s(a.publicationId, "First Publication"), d = (await _(e, await g(e, n, h(await c(await m(e, n, r), 200, "Change Draft"), "Second Revision"), o, "publish-second"), 202, "Publish second Revision")).publication, p = s(d.publicationId, "Second Publication");
+		await l(await y(e, o, "stale-live-run"), 412, "live.conflict", "Run stale Publication");
+		let b = () => v(e, n, o, p, "rollback-first"), x = await c(await b(), 201, "Rollback Flow"), S = s(x.publicationId, "Rollback Publication");
+		i(x.operation, "rollback", "Rollback operation"), i(x.sourcePublicationId, o, "Rollback source"), i(await c(await b(), 200, "Replay Rollback"), x, "Replayed Rollback");
+		let C = await c(await y(e, S, "rollback-run"), 202, "Create Live Run");
+		i(C.flowId, n, "Live Run flowId"), i(C.revisionId, r, "Live Run revisionId"), await c(await u(e, `/v1/flows/${n}`, { method: "DELETE" }), 202, "Retire Flow"), await l(await y(e, S, "retired-run"), 409, "flow.busy", "Run retired Flow");
 	}
-}], x = [{
+}], S = [{
 	name: "exposes one deployment-scoped Trigger Key catalog",
 	async verify(e) {
 		let t = await c(await u(e, "/v1/trigger-keys"), 200, "List Trigger Keys"), n = await c(await u(e, "/v1/trigger-keys/catalog"), 200, "List Trigger definitions"), r = o(t.keys, "Trigger Keys").map((e) => a(e, "Trigger Key")), d = o(n.definitions, "Trigger definitions").map((e) => a(e, "Trigger definition"));
@@ -344,20 +395,20 @@ var y = [
 			},
 			nodeId: "webhook",
 			target: { kind: "flow" }
-		}]), 200, "Create Trigger nodes"), "Trigger Revision"), l = s((await c(await g(e, n, r, null, "trigger-publication"), 201, "Publish Trigger Flow")).publicationId, "Trigger Publication"), d = `/v1/flows/${n}/triggers`, m = o((await c(await u(e, d), 200, "List Trigger bindings")).bindings, "Trigger bindings").map((e) => a(e, "Trigger binding"));
-		i(m.map((e) => e.triggerNodeId), ["cron", "webhook"], "Trigger binding order");
-		for (let e of m) i(e.currentPublicationId, l, "Trigger Publication");
-		let _ = `${d}/webhook`, v = s(a((await c(await u(e, _), 200, "Read Webhook")).binding, "Webhook").endpointUrl, "Webhook endpoint"), y = (t) => u(e, `${_}/${t}`, {
+		}]), 200, "Create Trigger nodes"), "Trigger Revision"), l = (await _(e, await g(e, n, r, null, "trigger-publication"), 202, "Publish Trigger Flow")).publication, d = s(l.publicationId, "Trigger Publication"), m = `/v1/flows/${n}/triggers`, v = o((await c(await u(e, m), 200, "List Trigger bindings")).bindings, "Trigger bindings").map((e) => a(e, "Trigger binding"));
+		i(v.map((e) => e.triggerNodeId), ["cron", "webhook"], "Trigger binding order");
+		for (let e of v) i(e.currentPublicationId, d, "Trigger Publication");
+		let y = `${m}/webhook`, b = s(a((await c(await u(e, y), 200, "Read Webhook")).binding, "Webhook").endpointUrl, "Webhook endpoint"), x = (t) => u(e, `${y}/${t}`, {
 			body: JSON.stringify({ version: 1 }),
 			method: "POST"
 		});
-		i((await c(await y("pause"), 200, "Pause Webhook")).operatorState, "paused", "Paused state"), i((await e.request(new Request(v, { method: "POST" }))).status, 404, "Paused callback"), i((await c(await y("resume"), 200, "Resume Webhook")).operatorState, "active", "Resumed state"), i((await e.request(new Request(v, { method: "POST" }))).status, 200, "Resumed callback"), await c(await g(e, n, h(await c(await p(e, n, r, [{
+		i((await c(await x("pause"), 200, "Pause Webhook")).operatorState, "paused", "Paused state"), i((await e.request(new Request(b, { method: "POST" }))).status, 404, "Paused callback"), i((await c(await x("resume"), 200, "Resume Webhook")).operatorState, "active", "Resumed state"), i((await e.request(new Request(b, { method: "POST" }))).status, 200, "Resumed callback"), await _(e, await g(e, n, h(await c(await p(e, n, r, [{
 			kind: "graph.node.delete",
 			nodeId: "webhook",
 			target: { kind: "flow" }
-		}]), 200, "Delete Webhook"), "Retired Trigger Revision"), l, "retire-trigger"), 201, "Publish retired Trigger"), i(a((await c(await u(e, _), 200, "Read retired Webhook")).binding, "Retired Webhook").currentPublicationId, void 0, "Retired Publication");
+		}]), 200, "Delete Webhook"), "Retired Trigger Revision"), d, "retire-trigger"), 202, "Publish retired Trigger"), i(a((await c(await u(e, y), 200, "Read retired Webhook")).binding, "Retired Webhook").currentPublicationId, void 0, "Retired Publication");
 	}
-}], S = [{
+}], C = [{
 	name: "projects the deployment Connector catalog and authorized Connections",
 	async verify(e) {
 		let t = o((await c(await u(e, "/v1/connector/providers"), 200, "List Connector Providers")).providers, "Connector Providers").map((e) => a(e, "Connector Provider")), n = o((await c(await u(e, "/v1/connector/actions"), 200, "List Connector Actions")).actions, "Connector Actions").map((e) => a(e, "Connector Action"));
@@ -379,4 +430,4 @@ var y = [
 	}
 }];
 //#endregion
-export { S as connectorControlApiConformanceCases, y as controlApiConformanceCases, b as publicationControlApiConformanceCases, x as triggerControlApiConformanceCases };
+export { C as connectorControlApiConformanceCases, b as controlApiConformanceCases, x as publicationControlApiConformanceCases, S as triggerControlApiConformanceCases };

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

@@ -3,6 +3,7 @@ export declare const controlErrorCode: {
     readonly authorizationDenied: 'authorization.denied';
     readonly bindingUnresolved: 'binding.unresolved';
     readonly connectorActionNotFound: 'connector.action-not-found';
+    readonly connectorUnconfigured: 'connector.unconfigured';
     readonly connectorUnavailable: 'connector.unavailable';
     readonly engineUnavailable: 'engine.unavailable';
     readonly engineUnsupported: 'engine.unsupported';
@@ -17,6 +18,8 @@ export declare const controlErrorCode: {
     readonly pageInvalidCursor: 'page.invalid-cursor';
     readonly publicationConflict: 'publication.conflict';
     readonly publicationNotFound: 'publication.not-found';
+    readonly publicationUnsupported: 'publication.unsupported';
+    readonly publishOperationNotFound: 'publication.operation-not-found';
     readonly routeNotFound: 'route.not-found';
     readonly runConflict: 'run.conflict';
     readonly runEventsExpired: 'run.events-expired';
@@ -27,6 +30,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: {
@@ -42,6 +48,9 @@ export declare const controlErrorMetadata: {
     readonly "connector.action-not-found": {
         readonly status: 404;
     };
+    readonly "connector.unconfigured": {
+        readonly status: 503;
+    };
     readonly "connector.unavailable": {
         readonly status: 503;
     };
@@ -84,6 +93,12 @@ export declare const controlErrorMetadata: {
     readonly "publication.not-found": {
         readonly status: 404;
     };
+    readonly "publication.unsupported": {
+        readonly status: 409;
+    };
+    readonly "publication.operation-not-found": {
+        readonly status: 404;
+    };
     readonly "route.not-found": {
         readonly status: 404;
     };
@@ -114,4 +129,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;
@@ -74,6 +80,7 @@ export interface ConnectorConnection {
 }
 export interface ConnectorAction {
     readonly actionId: string;
+    readonly authenticated: boolean;
     readonly defaultConnection?: ConnectorConnection;
     readonly description: string;
     readonly icon?: string;
@@ -131,12 +138,44 @@ export interface Publication {
     readonly sourcePublicationId?: string;
     readonly version: 1;
 }
+export type PublishOperation = {
+    readonly createdAt: string;
+    readonly flowId: string;
+    readonly operationId: string;
+    readonly revisionId: string;
+    readonly status: 'pending';
+    readonly updatedAt: string;
+    readonly version: 1;
+} | {
+    readonly createdAt: string;
+    readonly flowId: string;
+    readonly operationId: string;
+    readonly publicationId: string;
+    readonly revisionId: string;
+    readonly status: 'succeeded';
+    readonly updatedAt: string;
+    readonly version: 1;
+} | {
+    readonly createdAt: string;
+    readonly flowId: string;
+    readonly issue: {
+        readonly code: string;
+        readonly message: string;
+        readonly nodeId?: string;
+    };
+    readonly operationId: string;
+    readonly revisionId: string;
+    readonly status: 'failed';
+    readonly updatedAt: string;
+    readonly version: 1;
+};
 export interface Diagnostic {
     readonly code: string;
     readonly column: number;
     readonly line: number;
     readonly message: string;
     readonly path: string;
+    readonly values?: Readonly<Record<string, string | number>>;
 }
 export interface FlowCheck {
     readonly closureDigest: string;
@@ -266,6 +305,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>;
@@ -285,12 +331,12 @@ export declare class ControlClient {
     getDraft(flowId: string): Promise<Draft>;
     syncDraft(flowId: string, fromRevisionId?: string): Promise<DraftSync>;
     getRevision(flowId: string, revisionId: string): Promise<Draft>;
-    listConnectorProviders(signal?: AbortSignal): Promise<readonly ConnectorProvider[]>;
-    listConnectorActions(serviceId?: string, signal?: AbortSignal): Promise<readonly ConnectorAction[]>;
-    searchConnectorActions(query: string, signal?: AbortSignal): Promise<readonly ConnectorAction[]>;
-    getConnectorAction(actionId: string, signal?: AbortSignal): Promise<ConnectorAction>;
-    listConnectorConnections(serviceId: string, signal?: AbortSignal): Promise<readonly ConnectorConnection[]>;
-    createConnectorConnectionPage(serviceId: string): Promise<string>;
+    listConnectorProviders(signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorProvider[]>;
+    listConnectorActions(serviceId?: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorAction[]>;
+    searchConnectorActions(query: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorAction[]>;
+    getConnectorAction(actionId: string, signal?: AbortSignal, flowId?: string): Promise<ConnectorAction>;
+    listConnectorConnections(serviceId: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorConnection[]>;
+    createConnectorConnectionPage(serviceId: string, flowId?: string): Promise<string>;
     changeDraft(flowId: string, expectedRevisionId: string, operations: readonly ChangeOperation[]): Promise<DraftChange>;
     checkFlow(flowId: string, revisionId: string): Promise<FlowCheck>;
     getLive(flowId: string): Promise<Live>;
@@ -301,7 +347,8 @@ export declare class ControlClient {
     }): Promise<PublicationPage>;
     createDraftRun(flowId: string, revisionId: string, options?: RunOptions): Promise<DraftRun>;
     createLiveRun(publicationId: string, options?: RunOptions): Promise<LiveRun>;
-    publishFlow(flowId: string, revisionId: string, expectedLivePublicationId: string | null, options?: PublicationOptions): Promise<Publication>;
+    publishFlow(flowId: string, revisionId: string, expectedLivePublicationId: string | null, options?: PublicationOptions): Promise<PublishOperation>;
+    getPublishOperation(flowId: string, operationId: string): Promise<PublishOperation>;
     rollbackFlow(flowId: string, publicationId: string, expectedLivePublicationId: string, options?: PublicationOptions): Promise<Publication>;
     getRun(runId: string): Promise<RunDetails>;
     listRuns(flowId: string, options?: {