@oomol-lab/open-flow 0.1.0-beta.30 → 0.1.0-beta.31

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

@@ -4489,7 +4489,10 @@ var Ys = k(M([A({
 		}))
 	})),
 	defaultOutput: z.optional()
-}, dc = { prompt: z }, fc = {
+}, dc = {
+	inputDefinitions: k(V),
+	prompt: z
+}, fc = {
 	bodyFields: k(V),
 	options: A({
 		allowedMethods: Xs.optional(),
@@ -4571,13 +4574,11 @@ var Ys = k(M([A({
 	j({
 		...gc,
 		kind: F("approval"),
-		input: V,
 		...dc
 	}).omit({ timeoutMs: !0 }),
 	j({
 		...gc,
 		kind: F("wait"),
-		input: V,
 		...dc
 	}).omit({ timeoutMs: !0 }),
 	A({
@@ -4645,16 +4646,16 @@ var Ys = k(M([A({
 	graph: xc,
 	subflows: N(z, bc.extend({ graph: xc })),
 	tasks: N(z, lc)
-}), Tc = A({
+});
+A({
 	modelVersion: M([F(2), F(3)]),
 	document: wc,
 	modules: N(z, Cc)
-});
-Tc.extend({ modelVersion: F(3) }), Tc.extend({
+}).extend({
 	kind: F("open-flow-flow-revision"),
 	version: F(1)
 });
-var Ec = {
+var Tc = {
 	"binding.create": {
 		bindingId: z,
 		binding: Sc
@@ -4817,16 +4818,16 @@ var Ec = {
 		value: z
 	}
 };
-k(M([...new Map(Object.entries(Ec).map(([e, t]) => [e, t instanceof w ? t : A({
+k(M([...new Map(Object.entries(Tc).map(([e, t]) => [e, t instanceof w ? t : A({
 	kind: F(e),
 	...t
 })])).values()])).min(1), new TextEncoder();
-var Dc = N(T(), $o()), Oc = A({
+var Ec = N(T(), $o()), Dc = A({
 	jsonSchema: $o(),
 	nullable: O(),
 	value: $o().optional(),
 	description: T().optional()
-}).strict(), kc = N(T(), Oc), Ac = M([A({
+}).strict(), Oc = N(T(), Dc), kc = M([A({
 	kind: F("value"),
 	value: $o()
 }).strict(), A({
@@ -4836,36 +4837,36 @@ var Dc = N(T(), $o()), Oc = A({
 		nodeId: T(),
 		output: T()
 	}).strict())
-}).strict()]), jc = {
+}).strict()]), Ac = {
 	name: T().optional(),
 	description: T().optional(),
 	icon: T().optional()
-}, Mc = M([
+}, jc = M([
 	A({
-		...jc,
+		...Ac,
 		kind: F("cron"),
 		cronTimes: k($o())
 	}).strict(),
 	A({
-		...jc,
+		...Ac,
 		kind: F("manual")
 	}).strict(),
 	A({
-		...jc,
+		...Ac,
 		kind: F("task"),
 		concurrency: F(1).optional(),
-		inputs: N(T(), Ac),
+		inputs: N(T(), kc),
 		task: A({
 			name: T(),
 			moduleId: T(),
-			inputs: kc,
-			outputs: N(T(), Oc.omit({ value: !0 }))
+			inputs: Oc,
+			outputs: N(T(), Dc.omit({ value: !0 }))
 		}).strict()
 	}).strict()
 ]);
 A({
 	name: T(),
-	graph: A({ nodes: N(T(), Mc) }).strict()
+	graph: A({ nodes: N(T(), jc) }).strict()
 }).strict(), A({
 	kind: F("open-flow-project-revision"),
 	version: F(1),
@@ -4876,15 +4877,15 @@ A({
 		imports: k(T())
 	}).strict()),
 	document: A({
-		bindings: Dc,
-		flows: Dc,
-		subflows: Dc,
-		tasks: Dc
+		bindings: Ec,
+		flows: Ec,
+		subflows: Ec,
+		tasks: Ec
 	}).strict()
 }).strict();
 //#endregion
 //#region src/control/common/api.ts
-function Nc(e) {
+function Mc(e) {
 	let t = Hs(e), n = Us(t.sequence);
 	if (n < 0) return L();
 	let r = {
@@ -4912,7 +4913,7 @@ function Nc(e) {
 			payload: {
 				flowId: R(i.flowId),
 				scopeId: R(i.scopeId),
-				progress: Pc(i.progress)
+				progress: Nc(i.progress)
 			}
 		};
 		case "run.waiting": return Array.isArray(i.waitIds) ? {
@@ -4932,11 +4933,12 @@ function Nc(e) {
 		};
 		case "run.resolved": {
 			let e = i.action;
-			return e !== "approve" && e !== "continue" && e !== "reject" ? L() : {
+			return e !== "approve" && e !== "continue" && e !== "reject" || i.comment !== null && typeof i.comment != "string" ? L() : {
 				...r,
 				kind: a,
 				payload: {
 					action: e,
+					comment: i.comment,
 					resolvedAt: R(i.resolvedAt),
 					waitId: R(i.waitId)
 				}
@@ -5020,7 +5022,7 @@ function Nc(e) {
 					kind: a,
 					payload: {
 						...e,
-						progress: Pc(i.progress)
+						progress: Nc(i.progress)
 					}
 				};
 				case "node.artifact": {
@@ -5046,7 +5048,7 @@ function Nc(e) {
 		default: return L();
 	}
 }
-function Pc(e) {
+function Nc(e) {
 	return typeof e == "number" && Number.isFinite(e) && e >= 0 && e <= 100 ? e : L();
 }
 //#endregion
@@ -5083,7 +5085,7 @@ function Z(e, t, n = {}) {
 		headers: r
 	}));
 }
-function Fc(e, t, n) {
+function Pc(e, t, n) {
 	return Z(e, "/v1/flows", {
 		body: JSON.stringify({
 			name: t,
@@ -5094,9 +5096,9 @@ function Fc(e, t, n) {
 	});
 }
 async function Q(e, t, n) {
-	return Y(await Fc(e, t, n), 201, "Create Flow");
+	return Y(await Pc(e, t, n), 201, "Create Flow");
 }
-function Ic(e, t, n, r, i = `change-${crypto.randomUUID()}`) {
+function Fc(e, t, n, r, i = `change-${crypto.randomUUID()}`) {
 	return Z(e, `/v1/flows/${encodeURIComponent(t)}/draft/changes`, {
 		body: JSON.stringify({
 			expectedRevisionId: n,
@@ -5108,7 +5110,7 @@ function Ic(e, t, n, r, i = `change-${crypto.randomUUID()}`) {
 	});
 }
 function $(e, t, n, r = "marker", i) {
-	return Ic(e, t, n, [{
+	return Fc(e, t, n, [{
 		kind: "graph.node.create",
 		node: {
 			inputs: {},
@@ -5125,8 +5127,8 @@ function $(e, t, n, r = "marker", i) {
 		target: { kind: "flow" }
 	}], i);
 }
-async function Lc(e, t, n) {
-	return Rc(await Y(await Ic(e, t, n, [{
+async function Ic(e, t, n) {
+	return Lc(await Y(await Fc(e, t, n, [{
 		kind: "graph.node.create",
 		node: {
 			kind: "manual",
@@ -5136,10 +5138,10 @@ async function Lc(e, t, n) {
 		target: { kind: "flow" }
 	}]), 200, "Add manual trigger"), "Manual trigger Revision");
 }
-function Rc(e, t) {
+function Lc(e, t) {
 	return J(K(e.revision, `${t} revision`).revisionId, `${t} revisionId`);
 }
-function zc(e, t, n, r, i) {
+function Rc(e, t, n, r, i) {
 	return Z(e, `/v1/flows/${encodeURIComponent(t)}/revisions/${encodeURIComponent(n)}/publications`, {
 		body: JSON.stringify({
 			engineContract: U,
@@ -5150,7 +5152,7 @@ function zc(e, t, n, r, i) {
 		method: "POST"
 	});
 }
-async function Bc(e, t, n, r) {
+async function zc(e, t, n, r) {
 	let i = await Y(t, n, r), a = J(i.operationId, `${r} operationId`);
 	for (let t = 0; i.status == "pending" && t < 100; t += 1) await new Promise((e) => setTimeout(e, 10)), i = await Y(await Z(e, `/v1/flows/${J(i.flowId, `${r} flowId`)}/publish-operations/${a}`), 200, `${r} operation`);
 	G(i.status, "succeeded", `${r} terminal status`);
@@ -5160,7 +5162,7 @@ async function Bc(e, t, n, r) {
 		publication: s
 	};
 }
-function Vc(e, t, n, r, i) {
+function Bc(e, t, n, r, i) {
 	return Z(e, `/v1/flows/${encodeURIComponent(t)}/publications/${encodeURIComponent(n)}/rollback`, {
 		body: JSON.stringify({
 			expectedLivePublicationId: r,
@@ -5170,7 +5172,7 @@ function Vc(e, t, n, r, i) {
 		method: "POST"
 	});
 }
-function Hc(e, t, n) {
+function Vc(e, t, n) {
 	return Z(e, "/v1/runs", {
 		body: JSON.stringify({
 			inputs: {},
@@ -5185,11 +5187,11 @@ function Hc(e, t, n) {
 		method: "POST"
 	});
 }
-var Uc = [
+var Hc = [
 	{
 		name: "admits simultaneous retries as one Run and preserves its Trigger identity",
 		async verify(e) {
-			let t = await Q(e, "Concurrent Run", "concurrent-run-flow"), n = J(t.flowId, "Flow ID"), r = await Lc(e, n, J(t.draftRevisionId, "Revision ID")), i = (t = {}) => Z(e, `/v1/flows/${n}/revisions/${r}/runs`, {
+			let t = await Q(e, "Concurrent Run", "concurrent-run-flow"), n = J(t.flowId, "Flow ID"), r = await Ic(e, n, J(t.draftRevisionId, "Revision ID")), i = (t = {}) => Z(e, `/v1/flows/${n}/revisions/${r}/runs`, {
 				method: "POST",
 				headers: { "idempotency-key": "concurrent-run" },
 				body: JSON.stringify({
@@ -5221,7 +5223,7 @@ var Uc = [
 	{
 		name: "deduplicates simultaneous creation and lost-response retries",
 		async verify(e) {
-			let t = await Promise.all(Array.from({ length: 4 }, () => Fc(e, "Concurrent Flow", "concurrent-create")));
+			let t = await Promise.all(Array.from({ length: 4 }, () => Pc(e, "Concurrent Flow", "concurrent-create")));
 			G(t.map((e) => e.status).toSorted(), [
 				200,
 				200,
@@ -5230,7 +5232,7 @@ var Uc = [
 			], "One creation commits");
 			let n = await Promise.all(t.map((e) => e.json()));
 			for (let e of n) G(e, n[0], "Concurrent replay identity");
-			G(await Y(await Fc(e, "Concurrent Flow", "concurrent-create"), 200, "Retry lost creation response"), n[0], "Lost-response replay"), await X(await Fc(e, "Different Flow", "concurrent-create"), 409, "flow.conflict", "Reject changed retry");
+			G(await Y(await Pc(e, "Concurrent Flow", "concurrent-create"), 200, "Retry lost creation response"), n[0], "Lost-response replay"), await X(await Pc(e, "Different Flow", "concurrent-create"), 409, "flow.conflict", "Reject changed retry");
 		}
 	},
 	{
@@ -5289,7 +5291,7 @@ var Uc = [
 		name: "creates, replays, lists, reads, renames, and retires a Flow",
 		async verify(e) {
 			let t = await Q(e, "Control flow", "flow-lifecycle"), n = J(t.flowId, "Created Flow flowId"), r = J(t.draftRevisionId, "Created Flow draftRevisionId");
-			G(t.name, "Control flow", "Created Flow name"), G(t.status, "active", "Created Flow status"), G(await Y(await Fc(e, "Control flow", "flow-lifecycle"), 200, "Replay Flow"), t, "Replayed Flow"), await X(await Fc(e, "Different flow", "flow-lifecycle"), 409, "flow.conflict", "Conflicting Flow"), G(await Y(await Z(e, `/v1/flows/${n}`), 200, "Read Flow"), t, "Read Flow");
+			G(t.name, "Control flow", "Created Flow name"), G(t.status, "active", "Created Flow status"), G(await Y(await Pc(e, "Control flow", "flow-lifecycle"), 200, "Replay Flow"), t, "Replayed Flow"), await X(await Pc(e, "Different flow", "flow-lifecycle"), 409, "flow.conflict", "Conflicting Flow"), G(await Y(await Z(e, `/v1/flows/${n}`), 200, "Read Flow"), t, "Read Flow");
 			let i = await Y(await Z(e, "/v1/flows?includeTotal=true"), 200, "List Flows");
 			G(i.flows, [t], "Listed Flows"), G(i.total, 1, "Flow total");
 			let a = await Q(e, "Second control flow", "flow-lifecycle-second"), o = await Y(await Z(e, "/v1/flows?limit=1"), 200, "List first Flow page");
@@ -5307,8 +5309,8 @@ var Uc = [
 	{
 		name: "commits immutable Draft Revisions for one Flow",
 		async verify(e) {
-			let t = await Q(e, "Draft flow", "draft-flow"), n = J(t.flowId, "Draft Flow flowId"), r = J(t.draftRevisionId, "Draft Flow revisionId"), i = await Y(await $(e, n, r, "marker", "draft-change"), 200, "Change Draft"), a = Rc(i, "Changed Draft");
-			G(K(i.revision, "Changed Draft revision").parentRevisionId, r, "Changed Draft parent"), G(await Y(await $(e, n, r, "marker", "draft-change"), 200, "Replay Draft change"), i, "Replayed Draft change"), await X(await $(e, n, r, "another-marker", "draft-change"), 409, "flow.conflict", "Conflicting Draft change replay"), await X(await $(e, n, a, "marker"), 400, "flow.invalid", "Duplicate Draft Node", "A Node with this ID already exists"), await X(await Ic(e, n, a, [{
+			let t = await Q(e, "Draft flow", "draft-flow"), n = J(t.flowId, "Draft Flow flowId"), r = J(t.draftRevisionId, "Draft Flow revisionId"), i = await Y(await $(e, n, r, "marker", "draft-change"), 200, "Change Draft"), a = Lc(i, "Changed Draft");
+			G(K(i.revision, "Changed Draft revision").parentRevisionId, r, "Changed Draft parent"), G(await Y(await $(e, n, r, "marker", "draft-change"), 200, "Replay Draft change"), i, "Replayed Draft change"), await X(await $(e, n, r, "another-marker", "draft-change"), 409, "flow.conflict", "Conflicting Draft change replay"), await X(await $(e, n, a, "marker"), 400, "flow.invalid", "Duplicate Draft Node", "A Node with this ID already exists"), await X(await Fc(e, n, a, [{
 				before: [{
 					handle: "ready",
 					jsonSchema: { type: "boolean" },
@@ -5343,7 +5345,7 @@ var Uc = [
 					version: 1
 				})
 			}), 200, "Update editor Presentation"), a = await Y(await Z(e, `/v1/flows/${n}/editor`), 200, "Read editor");
-			G(a.version, 1, "Editor version"), G(K(a.flow, "Editor Flow").draftRevisionId, Rc(r, "Editor change"), "Editor Draft head");
+			G(a.version, 1, "Editor version"), G(K(a.flow, "Editor Flow").draftRevisionId, Lc(r, "Editor change"), "Editor Draft head");
 			for (let t of [
 				"flow",
 				"draft",
@@ -5393,7 +5395,7 @@ var Uc = [
 	{
 		name: "admits a Draft entry while unrelated branches remain invalid",
 		async verify(e) {
-			let t = await Q(e, "Partial Draft", "partial-draft"), n = J(t.flowId, "Partial Flow identity"), r = Rc(await Y(await Ic(e, n, await Lc(e, n, J(t.draftRevisionId, "Partial Draft identity")), [
+			let t = await Q(e, "Partial Draft", "partial-draft"), n = J(t.flowId, "Partial Flow identity"), r = Lc(await Y(await Fc(e, n, await Ic(e, n, J(t.draftRevisionId, "Partial Draft identity")), [
 				{
 					kind: "graph.node.create",
 					nodeId: "other",
@@ -5454,13 +5456,13 @@ var Uc = [
 					version: 2
 				})
 			});
-			await Y(await a("start"), 202, "Run valid entry"), await X(await a("other"), 400, "flow.invalid", "Reject invalid entry branch"), await X(await zc(e, n, r, null, "partial-publish"), 400, "flow.invalid", "Reject incomplete publication");
+			await Y(await a("start"), 202, "Run valid entry"), await X(await a("other"), 400, "flow.invalid", "Reject invalid entry branch"), await X(await Rc(e, n, r, null, "partial-publish"), 400, "flow.invalid", "Reject incomplete publication");
 		}
 	},
 	{
 		name: "validates, admits, lists, and cancels one Draft Run",
 		async verify(e) {
-			let t = await Q(e, "Run flow", "run-flow"), n = J(t.flowId, "Run Flow flowId"), r = await Lc(e, n, J(t.draftRevisionId, "Run Flow revisionId"));
+			let t = await Q(e, "Run flow", "run-flow"), n = J(t.flowId, "Run Flow flowId"), r = await Ic(e, n, J(t.draftRevisionId, "Run Flow revisionId"));
 			G((await Y(await Z(e, `/v1/flows/${n}/revisions/${r}/check`, {
 				body: JSON.stringify({
 					engineContract: U,
@@ -5554,15 +5556,15 @@ var Uc = [
 		name: "pauses, resolves, resumes, and cancels waiting Draft Runs",
 		runtime: !0,
 		async verify(e) {
-			let t = await Q(e, "Wait flow", "wait-flow"), n = J(t.flowId, "Wait Flow flowId"), r = `/v1/flows/${n}/revisions/${Rc(await Y(await Ic(e, n, await Lc(e, n, J(t.draftRevisionId, "Wait Flow revisionId")), [{
+			let t = await Q(e, "Wait flow", "wait-flow"), n = J(t.flowId, "Wait Flow flowId"), r = `/v1/flows/${n}/revisions/${Lc(await Y(await Fc(e, n, await Ic(e, n, J(t.draftRevisionId, "Wait Flow revisionId")), [{
 				kind: "graph.node.create",
 				node: {
-					input: {
+					inputDefinitions: [{
 						handle: "value",
 						jsonSchema: {},
 						nullable: !0,
 						value: null
-					},
+					}],
 					inputs: { value: {
 						kind: "value",
 						value: { request: 1 }
@@ -5600,7 +5602,7 @@ var Uc = [
 			let l = J(c.waitId, "Wait id");
 			G(q((await Y(await Z(e, `/v1/flows/${n}/runs?pendingWait=true`), 200, "List waiting Runs")).runs, "Waiting Runs").map((e) => K(e, "Waiting Run").runId), [o], "Waiting Run list");
 			let u = await Y(await Z(e, `/v1/runs/${o}/events`), 200, "Read waiting Run events");
-			for (let e of q(u.events, "Run events")) Nc(e);
+			for (let e of q(u.events, "Run events")) Mc(e);
 			G(u.done, !1, "Waiting events done"), q(u.events, "Waiting events").some((e) => K(e, "Waiting event").kind == "wait.created") || W("Waiting Run must contain wait.created."), await X(await Z(e, `/v1/runs/${o}/result`), 409, "run.not-terminal", "Read waiting Run result");
 			let d = `/v1/runs/${o}/waits/${l}/resolve`, f = (t) => Z(e, d, {
 				body: JSON.stringify({
@@ -5619,7 +5621,7 @@ var Uc = [
 			let te = await Y(await f("approve"), 200, "Replay approved Wait");
 			G(te.resolutionAccepted, !0, "Replayed resolution"), G(te.status, "completed", "Replayed terminal status");
 			let ne = await Y(await Z(e, `/v1/runs/${o}/events`), 200, "Read resumed Run events");
-			for (let e of q(ne.events, "Run events")) Nc(e);
+			for (let e of q(ne.events, "Run events")) Mc(e);
 			G(q(ne.events, "Completed events").filter((e) => K(e, "Completed event").kind == "run.resolved").length, 1, "Resolved event count");
 			let re = await i("wait-run-cancel", "Create cancelable Wait Run"), ie = J(re.runId, "Cancelable Wait Run id"), ae = re;
 			for (let t = 0; q(ae.waits, "Waits").length == 0 && t < 200; t += 1) await new Promise((e) => setTimeout(e, 10)), ae = await Y(await Z(e, `/v1/runs/${ie}`), 200, "Read cancelable Wait Run");
@@ -5674,11 +5676,11 @@ var Uc = [
 			await X(await c(o, "unsupported-engine/v1", "unsupported-run"), 409, "engine.unsupported", "Run unsupported Engine"), await X(await c(n, U, "missing-revision-run"), 404, "flow.not-found", "Run missing Revision");
 		}
 	}
-], Wc = [
+], Uc = [
 	{
 		name: "controls Live admission independently from publishing and Draft testing",
 		async verify(e) {
-			let t = await Q(e, "Enabled flow", "enabled-flow"), n = J(t.flowId, "Flow id"), r = await Lc(e, n, J(t.draftRevisionId, "Draft id")), i = (t, r) => Z(e, `/v1/flows/${n}/enabled`, {
+			let t = await Q(e, "Enabled flow", "enabled-flow"), n = J(t.flowId, "Flow id"), r = await Ic(e, n, J(t.draftRevisionId, "Draft id")), i = (t, r) => Z(e, `/v1/flows/${n}/enabled`, {
 				method: "PUT",
 				body: JSON.stringify({
 					enabled: t,
@@ -5687,12 +5689,12 @@ var Uc = [
 				})
 			});
 			await X(await i(!0, "missing"), 409, "flow.conflict", "Cannot enable unpublished Flow");
-			let a = J((await Bc(e, await zc(e, n, r, null, "enable-first"), 202, "Publish")).publication.publicationId, "Publication id"), o = await Y(await i(!1, a), 200, "Disable");
+			let a = J((await zc(e, await Rc(e, n, r, null, "enable-first"), 202, "Publish")).publication.publicationId, "Publication id"), o = await Y(await i(!1, a), 200, "Disable");
 			G(o.live, {
 				enabled: !1,
 				publicationId: a,
 				revisionId: r
-			}, "Disabled summary"), G((await Y(await Z(e, "/v1/flows"), 200, "List disabled Flow")).flows, [o], "List includes Live state"), G((await Y(await Z(e, `/v1/flows/${n}/live`), 200, "Disabled Live")).status, "suspended", "Disabled Live status"), await X(await Hc(e, a, "disabled-run"), 412, "live.conflict", "Disabled Live rejects Run"), await Y(await Z(e, `/v1/flows/${n}/revisions/${r}/runs`, {
+			}, "Disabled summary"), G((await Y(await Z(e, "/v1/flows"), 200, "List disabled Flow")).flows, [o], "List includes Live state"), G((await Y(await Z(e, `/v1/flows/${n}/live`), 200, "Disabled Live")).status, "suspended", "Disabled Live status"), await X(await Vc(e, a, "disabled-run"), 412, "live.conflict", "Disabled Live rejects Run"), await Y(await Z(e, `/v1/flows/${n}/revisions/${r}/runs`, {
 				method: "POST",
 				headers: { "idempotency-key": "disabled-draft" },
 				body: JSON.stringify({
@@ -5705,17 +5707,17 @@ var Uc = [
 					version: 2
 				})
 			}), 202, "Disabled Flow permits Draft test");
-			let s = J((await Bc(e, await zc(e, n, r, a, "enable-next"), 202, "Publish disabled Flow")).publication.publicationId, "Next Publication id");
-			G(K((await Y(await Z(e, `/v1/flows/${n}`), 200, "Read Flow")).live, "Live").enabled, !1, "Publish preserves disabled state"), await X(await i(!0, a), 409, "flow.conflict", "Stale switch rejects"), await Y(await i(!0, s), 200, "Enable"), await Y(await Hc(e, s, "enabled-run"), 202, "Enabled Live accepts Run");
+			let s = J((await zc(e, await Rc(e, n, r, a, "enable-next"), 202, "Publish disabled Flow")).publication.publicationId, "Next Publication id");
+			G(K((await Y(await Z(e, `/v1/flows/${n}`), 200, "Read Flow")).live, "Live").enabled, !1, "Publish preserves disabled state"), await X(await i(!0, a), 409, "flow.conflict", "Stale switch rejects"), await Y(await i(!0, s), 200, "Enable"), await Y(await Vc(e, s, "enabled-run"), 202, "Enabled Live accepts Run");
 		}
 	},
 	{
 		name: "publishes one immutable Flow with idempotent Live CAS",
 		async verify(e) {
-			let t = await Q(e, "Publication flow", "publication-flow"), n = J(t.flowId, "Publication Flow flowId"), r = await Lc(e, n, J(t.draftRevisionId, "Publication Flow revisionId"));
+			let t = await Q(e, "Publication flow", "publication-flow"), n = J(t.flowId, "Publication Flow flowId"), r = await Ic(e, n, J(t.draftRevisionId, "Publication Flow revisionId"));
 			G((await Y(await Z(e, `/v1/flows/${n}/live`), 200, "Read Live")).status, "not-published", "Initial Live status");
-			let i = () => zc(e, n, r, null, "publication-first"), a = await Bc(e, await i(), 202, "Publish Flow"), o = a.publication, s = J(o.publicationId, "Publication id");
-			G(await Y(await i(), 202, "Replay Publish"), a.operation, "Replayed Publish operation"), await X(await zc(e, n, r, s, "publication-first"), 409, "publication.conflict", "Conflicting replay");
+			let i = () => Rc(e, n, r, null, "publication-first"), a = await zc(e, await i(), 202, "Publish Flow"), o = a.publication, s = J(o.publicationId, "Publication id");
+			G(await Y(await i(), 202, "Replay Publish"), a.operation, "Replayed Publish operation"), await X(await Rc(e, n, r, s, "publication-first"), 409, "publication.conflict", "Conflicting replay");
 			let c = await Y(await Z(e, `/v1/flows/${n}/live`), 200, "Read published Live");
 			G(c.publication, o, "Live Publication"), G((await Y(await Z(e, `/v1/flows/${n}/editor`), 200, "Read published editor")).live, c, "Published editor Live projection");
 			let l = await Y(await Z(e, `/v1/flows/${n}/publications?includeTotal=true`), 200, "List Publications");
@@ -5727,21 +5729,21 @@ var Uc = [
 				}),
 				headers: { "idempotency-key": "unsupported-publication" },
 				method: "POST"
-			}), 409, "engine.unsupported", "Publish unsupported Engine"), await X(await zc(e, n, "00000000-0000-7000-8000-000000000002", s, "missing-revision-publication"), 404, "flow.not-found", "Publish missing Revision"), await X(await Vc(e, n, "00000000-0000-7000-8000-000000000004", s, "missing-rollback"), 404, "publication.not-found", "Rollback missing Publication"), await X(await Hc(e, "00000000-0000-7000-8000-000000000004", "missing-publication-run"), 404, "publication.not-found", "Run missing Publication");
+			}), 409, "engine.unsupported", "Publish unsupported Engine"), await X(await Rc(e, n, "00000000-0000-7000-8000-000000000002", s, "missing-revision-publication"), 404, "flow.not-found", "Publish missing Revision"), await X(await Bc(e, n, "00000000-0000-7000-8000-000000000004", s, "missing-rollback"), 404, "publication.not-found", "Rollback missing Publication"), await X(await Vc(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 Q(e, "Rollback flow", "rollback-flow"), n = J(t.flowId, "Rollback Flow flowId"), r = await Lc(e, n, J(t.draftRevisionId, "Rollback Flow revisionId")), i = (await Bc(e, await zc(e, n, r, null, "publish-first"), 202, "Publish first Revision")).publication, a = J(i.publicationId, "First Publication"), o = (await Bc(e, await zc(e, n, Rc(await Y(await $(e, n, r), 200, "Change Draft"), "Second Revision"), a, "publish-second"), 202, "Publish second Revision")).publication, s = J(o.publicationId, "Second Publication");
-			await X(await Hc(e, a, "stale-live-run"), 412, "live.conflict", "Run stale Publication");
-			let c = () => Vc(e, n, a, s, "rollback-first"), l = await Y(await c(), 201, "Rollback Flow"), u = J(l.publicationId, "Rollback Publication");
+			let t = await Q(e, "Rollback flow", "rollback-flow"), n = J(t.flowId, "Rollback Flow flowId"), r = await Ic(e, n, J(t.draftRevisionId, "Rollback Flow revisionId")), i = (await zc(e, await Rc(e, n, r, null, "publish-first"), 202, "Publish first Revision")).publication, a = J(i.publicationId, "First Publication"), o = (await zc(e, await Rc(e, n, Lc(await Y(await $(e, n, r), 200, "Change Draft"), "Second Revision"), a, "publish-second"), 202, "Publish second Revision")).publication, s = J(o.publicationId, "Second Publication");
+			await X(await Vc(e, a, "stale-live-run"), 412, "live.conflict", "Run stale Publication");
+			let c = () => Bc(e, n, a, s, "rollback-first"), l = await Y(await c(), 201, "Rollback Flow"), u = J(l.publicationId, "Rollback Publication");
 			G(l.operation, "rollback", "Rollback operation"), G(l.sourcePublicationId, a, "Rollback source"), G(await Y(await c(), 200, "Replay Rollback"), l, "Replayed Rollback");
-			let d = await Y(await Hc(e, u, "rollback-run"), 202, "Create Live Run");
-			G(d.flowId, n, "Live Run flowId"), G(d.revisionId, r, "Live Run revisionId"), await Y(await Z(e, `/v1/flows/${n}`, { method: "DELETE" }), 202, "Retire Flow"), await X(await Hc(e, u, "retired-run"), 409, "flow.busy", "Run retired Flow");
+			let d = await Y(await Vc(e, u, "rollback-run"), 202, "Create Live Run");
+			G(d.flowId, n, "Live Run flowId"), G(d.revisionId, r, "Live Run revisionId"), await Y(await Z(e, `/v1/flows/${n}`, { method: "DELETE" }), 202, "Retire Flow"), await X(await Vc(e, u, "retired-run"), 409, "flow.busy", "Run retired Flow");
 		}
 	}
-], Gc = [{
+], Wc = [{
 	name: "exposes one deployment-scoped Trigger Key catalog",
 	async verify(e) {
 		let t = await Y(await Z(e, "/v1/trigger-keys"), 200, "List Trigger Keys"), n = await Y(await Z(e, "/v1/trigger-keys/catalog"), 200, "List Trigger definitions"), r = q(t.keys, "Trigger Keys").map((e) => K(e, "Trigger Key")), i = q(n.definitions, "Trigger definitions").map((e) => K(e, "Trigger definition"));
@@ -5755,7 +5757,7 @@ var Uc = [
 }, {
 	name: "operates and retires one Live Trigger binding",
 	async verify(e) {
-		let t = await Q(e, "Trigger flow", "trigger-flow"), n = J(t.flowId, "Trigger Flow flowId"), r = Rc(await Y(await Ic(e, n, J(t.draftRevisionId, "Trigger Flow revisionId"), [{
+		let t = await Q(e, "Trigger flow", "trigger-flow"), n = J(t.flowId, "Trigger Flow flowId"), r = Lc(await Y(await Fc(e, n, J(t.draftRevisionId, "Trigger Flow revisionId"), [{
 			kind: "graph.node.create",
 			node: {
 				cronTimes: [{
@@ -5777,7 +5779,7 @@ var Uc = [
 			},
 			nodeId: "webhook",
 			target: { kind: "flow" }
-		}]), 200, "Create Trigger nodes"), "Trigger Revision"), i = (await Bc(e, await zc(e, n, r, null, "trigger-publication"), 202, "Publish Trigger Flow")).publication, a = J(i.publicationId, "Trigger Publication"), o = `/v1/flows/${n}/triggers`, s = q((await Y(await Z(e, o), 200, "List Trigger bindings")).bindings, "Trigger bindings").map((e) => K(e, "Trigger binding"));
+		}]), 200, "Create Trigger nodes"), "Trigger Revision"), i = (await zc(e, await Rc(e, n, r, null, "trigger-publication"), 202, "Publish Trigger Flow")).publication, a = J(i.publicationId, "Trigger Publication"), o = `/v1/flows/${n}/triggers`, s = q((await Y(await Z(e, o), 200, "List Trigger bindings")).bindings, "Trigger bindings").map((e) => K(e, "Trigger binding"));
 		G(s.map((e) => e.triggerNodeId), ["cron", "webhook"], "Trigger binding order");
 		for (let e of s) G(e.currentPublicationId, a, "Trigger Publication");
 		let c = `${o}/webhook`, l = J(K((await Y(await Z(e, c), 200, "Read Webhook")).binding, "Webhook").endpointUrl, "Webhook endpoint"), u = (t) => Z(e, `${c}/${t}`, {
@@ -5793,13 +5795,13 @@ var Uc = [
 				version: 1
 			})
 		});
-		await Y(await d(!1), 200, "Disable Trigger Flow"), G((await e.request(new Request(l, { method: "POST" }))).status, 404, "Disabled Flow blocks callback"), await Y(await u("pause"), 200, "Pause binding while Flow disabled"), await Y(await d(!0), 200, "Enable Trigger Flow"), G((await e.request(new Request(l, { method: "POST" }))).status, 404, "Enabling preserves binding pause"), await Y(await u("resume"), 200, "Resume binding after enabling Flow"), G((await e.request(new Request(l, { method: "POST" }))).status, 200, "Enabled Flow permits callback"), await Bc(e, await zc(e, n, Rc(await Y(await Ic(e, n, r, [{
+		await Y(await d(!1), 200, "Disable Trigger Flow"), G((await e.request(new Request(l, { method: "POST" }))).status, 404, "Disabled Flow blocks callback"), await Y(await u("pause"), 200, "Pause binding while Flow disabled"), await Y(await d(!0), 200, "Enable Trigger Flow"), G((await e.request(new Request(l, { method: "POST" }))).status, 404, "Enabling preserves binding pause"), await Y(await u("resume"), 200, "Resume binding after enabling Flow"), G((await e.request(new Request(l, { method: "POST" }))).status, 200, "Enabled Flow permits callback"), await zc(e, await Rc(e, n, Lc(await Y(await Fc(e, n, r, [{
 			kind: "graph.node.delete",
 			nodeId: "webhook",
 			target: { kind: "flow" }
 		}]), 200, "Delete Webhook"), "Retired Trigger Revision"), a, "retire-trigger"), 202, "Publish retired Trigger"), G(K((await Y(await Z(e, c), 200, "Read retired Webhook")).binding, "Retired Webhook").currentPublicationId, void 0, "Retired Publication");
 	}
-}], Kc = [{
+}], Gc = [{
 	name: "projects the deployment Connector catalog and authorized Connections",
 	async verify(e) {
 		let t = q((await Y(await Z(e, "/v1/connector/providers"), 200, "List Connector Providers")).providers, "Connector Providers").map((e) => K(e, "Connector Provider")), n = q((await Y(await Z(e, "/v1/connector/actions"), 200, "List Connector Actions")).actions, "Connector Actions").map((e) => K(e, "Connector Action"));
@@ -5819,12 +5821,12 @@ var Uc = [
 	async verify(e) {
 		await X(await Z(e, "/v1/connector/actions?service=mail&q=send"), 400, "flow.invalid", "Conflicting Connector query"), await X(await Z(e, "/v1/connector/actions?q=%20%20"), 400, "flow.invalid", "Empty Connector query"), await X(await Z(e, `/v1/connector/connections/${"a".repeat(257)}`), 400, "flow.invalid", "Oversized Connector service"), await X(await Z(e, "/v1/connector/actions/conformance.missing"), 404, "connector.action-not-found", "Missing Connector Action");
 	}
-}], qc = [{
+}], Kc = [{
 	name: "preserves committed mutations and idempotency receipts after restart",
 	async verify(e) {
 		let t = await Q(e, "Recovery", "recovery-create"), n = J(t.flowId, "Flow ID"), r = J(t.draftRevisionId, "Revision ID"), i = await Y(await $(e, n, r, "marker", "recovery-change"), 200, "Commit change");
-		await e.restart(), G((await Y(await Fc(e, "Recovery", "recovery-create"), 200, "Replay creation after restart")).flowId, n, "Durable creation identity"), G(await Y(await $(e, n, r, "marker", "recovery-change"), 200, "Replay change after restart"), i, "Durable change receipt"), G((await Y(await Z(e, `/v1/flows/${n}/draft`), 200, "Recovered Draft")).revisionId, K(i.revision, "Revision").revisionId, "Recovered head");
+		await e.restart(), G((await Y(await Pc(e, "Recovery", "recovery-create"), 200, "Replay creation after restart")).flowId, n, "Durable creation identity"), G(await Y(await $(e, n, r, "marker", "recovery-change"), 200, "Replay change after restart"), i, "Durable change receipt"), G((await Y(await Z(e, `/v1/flows/${n}/draft`), 200, "Recovered Draft")).revisionId, K(i.revision, "Revision").revisionId, "Recovered head");
 	}
 }];
 //#endregion
-export { Kc as connectorControlApiConformanceCases, Uc as controlApiConformanceCases, qc as controlRecoveryConformanceCases, Wc as publicationControlApiConformanceCases, Gc as triggerControlApiConformanceCases };
+export { Gc as connectorControlApiConformanceCases, Hc as controlApiConformanceCases, Kc as controlRecoveryConformanceCases, Uc as publicationControlApiConformanceCases, Wc as triggerControlApiConformanceCases };

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

@@ -348,6 +348,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -366,6 +367,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -383,6 +385,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -400,6 +403,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -418,6 +422,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly waitId: string;
         readonly waitingSince: string;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly result?: undefined;
     };
@@ -434,6 +439,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action: "approve" | "continue" | "reject";
+        readonly comment: string | null;
         readonly resolvedAt: string;
         readonly waitId: string;
         readonly result?: undefined;
@@ -451,6 +457,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly nodeId?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result: JsonValue;
@@ -472,6 +479,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly expiresAt?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -493,6 +501,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly expiresAt?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -514,6 +523,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly expiresAt?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -536,6 +546,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly expiresAt?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -555,6 +566,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly expiresAt?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -574,6 +586,7 @@ export declare function decodeRunEvent(value: unknown): {
         readonly expiresAt?: undefined;
         readonly waitingSince?: undefined;
         readonly action?: undefined;
+        readonly comment?: undefined;
         readonly resolvedAt?: undefined;
         readonly waitId?: undefined;
         readonly result?: undefined;
@@ -698,8 +711,9 @@ export declare class ControlClient {
     downloadRunResult(runId: string, resultId: string, signal?: AbortSignal): Promise<Blob>;
     getRunResult(runId: string, signal?: AbortSignal): Promise<RunResult>;
     cancelRun(runId: string): Promise<RunCancellation>;
-    resolveRunWait(runId: string, waitId: string, action: WaitAction): Promise<{
+    resolveRunWait(runId: string, waitId: string, action: WaitAction, comment?: string | null): Promise<{
         readonly action: WaitAction | null;
+        readonly comment: string | null;
         readonly resolutionAccepted: boolean;
         readonly resolvedAt: string | null;
         readonly runId: string;