@oomol-lab/open-flow 0.1.0-beta.1 → 0.1.0-beta.10

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

@@ -5,6 +5,7 @@ export interface ControlApiConformanceHarness {
 }
 export interface ControlApiConformanceCase {
     readonly name: string;
+    readonly runtime?: true;
     verify(harness: ControlApiConformanceHarness): Promise<void>;
 }
 export declare const controlApiConformanceCases: readonly ControlApiConformanceCase[];

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

@@ -38,9 +38,11 @@ function s(e, t) {
 async function c(e, t, n) {
 	return i(e.status, t, `${n} status`), a(await e.json().catch(() => r(`${n} body: expected JSON.`)), `${n} body`);
 }
-async function l(e, t, n, r) {
-	let o = await c(e, t, r);
-	i(a(o.error, `${r} error`).code, n, `${r} error code`), i(o.version, 1, `${r} version`);
+async function l(e, t, n, o, l) {
+	let u = await c(e, t, o), d = a(u.error, `${o} error`);
+	i(d.code, n, `${o} error code`);
+	let f = s(d.message, `${o} error message`);
+	l != null && !f.includes(l) && r(`${o} error message: expected ${JSON.stringify(l)} in ${JSON.stringify(f)}.`), i(u.version, 1, `${o} version`);
 }
 function u(e, t, n = {}) {
 	let r = new Headers(n.headers);
@@ -62,17 +64,18 @@ function d(e, t, n) {
 async function f(e, t, n) {
 	return c(await d(e, t, n), 201, "Create Flow");
 }
-function p(e, t, n, r) {
+function p(e, t, n, r, i = `change-${crypto.randomUUID()}`) {
 	return u(e, `/v1/flows/${encodeURIComponent(t)}/draft/changes`, {
 		body: JSON.stringify({
 			expectedRevisionId: n,
 			operations: r,
 			version: 1
 		}),
+		headers: { "idempotency-key": i },
 		method: "POST"
 	});
 }
-function m(e, t, n, r = "marker") {
+function m(e, t, n, r = "marker", i) {
 	return p(e, t, n, [{
 		kind: "graph.node.create",
 		node: {
@@ -88,7 +91,7 @@ function m(e, t, n, r = "marker") {
 		},
 		nodeId: r,
 		target: { kind: "flow" }
-	}]);
+	}], i);
 }
 function h(e, t) {
 	return s(a(e.revision, `${t} revision`).revisionId, `${t} revisionId`);
@@ -104,7 +107,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 +127,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 +138,7 @@ 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) {
@@ -187,24 +200,25 @@ var y = [
 	{
 		name: "commits immutable Draft Revisions for one Flow",
 		async verify(e) {
-			let t = await f(e, "Draft flow", "draft-flow"), n = s(t.flowId, "Draft Flow flowId"), r = s(t.draftRevisionId, "Draft Flow revisionId"), o = await c(await m(e, n, r), 200, "Change Draft"), d = h(o, "Changed Draft");
-			i(a(o.revision, "Changed Draft revision").parentRevisionId, r, "Changed Draft parent"), await l(await p(e, n, d, [{
-				kind: "graph.node.replace",
-				node: {
-					concurrency: 1,
-					inputs: {},
-					kind: "value",
-					values: [{
-						handle: "ready",
-						jsonSchema: { type: "boolean" },
-						nullable: !1,
-						value: !0
-					}]
-				},
+			let t = await f(e, "Draft flow", "draft-flow"), n = s(t.flowId, "Draft Flow flowId"), r = s(t.draftRevisionId, "Draft Flow revisionId"), o = await c(await m(e, n, r, "marker", "draft-change"), 200, "Change Draft"), d = h(o, "Changed Draft");
+			i(a(o.revision, "Changed Draft revision").parentRevisionId, r, "Changed Draft parent"), i(await c(await m(e, n, r, "marker", "draft-change"), 200, "Replay Draft change"), o, "Replayed Draft change"), await l(await m(e, n, r, "another-marker", "draft-change"), 409, "flow.conflict", "Conflicting Draft change replay"), await l(await m(e, n, d, "marker"), 400, "flow.invalid", "Duplicate Draft Node", "A Node with this ID already exists"), await l(await p(e, n, d, [{
+				before: [{
+					handle: "ready",
+					jsonSchema: { type: "boolean" },
+					nullable: !1,
+					value: !0
+				}],
+				kind: "graph.node.values.set",
 				nodeId: "marker",
-				target: { kind: "flow" }
+				target: { kind: "flow" },
+				value: [{
+					handle: "ready",
+					jsonSchema: { type: "boolean" },
+					nullable: !1,
+					value: !0
+				}]
 			}]), 400, "flow.invalid", "No-op Draft change"), await l(await m(e, n, r, "stale"), 412, "flow.revision-conflict", "Stale Draft change"), i(a(a(a(a((await c(await u(e, `/v1/flows/${n}/revisions/${r}`), 200, "Read old Revision")).content, "Old content").document, "Old document").graph, "Old graph").nodes, "Old nodes"), {}, "Old Revision nodes"), i((await c(await u(e, `/v1/flows/${n}/draft`), 200, "Read Draft")).revisionId, d, "Draft revisionId");
-			let g = await c(await u(e, `/v1/flows/${n}/draft/sync?fromRevisionId=${r}`), 200, "Sync Draft");
+			let g = await c(await u(e, `/v1/flows/${n}/draft/sync`), 200, "Sync Draft");
 			i(g.kind, "snapshot", "Draft sync kind"), i(a(g.draft, "Draft snapshot").revisionId, d, "Draft snapshot revisionId");
 		}
 	},
@@ -280,6 +294,71 @@ var y = [
 			}), 200, "Cancel second Draft Run")).status, "canceled", "Second canceled Run status");
 		}
 	},
+	{
+		name: "pauses, resolves, resumes, and cancels waiting Draft Runs",
+		runtime: !0,
+		async verify(e) {
+			let t = await f(e, "Wait flow", "wait-flow"), d = s(t.flowId, "Wait Flow flowId"), m = `/v1/flows/${d}/revisions/${h(await c(await p(e, d, s(t.draftRevisionId, "Wait Flow revisionId"), [{
+				kind: "graph.node.create",
+				node: {
+					actions: ["approve", "reject"],
+					concurrency: 1,
+					input: {
+						handle: "value",
+						jsonSchema: {},
+						nullable: !0,
+						value: null
+					},
+					inputs: { value: {
+						kind: "value",
+						value: { request: 1 }
+					} },
+					kind: "wait",
+					prompt: "Approve request 1?"
+				},
+				nodeId: "approval",
+				target: { kind: "flow" }
+			}]), 200, "Create Wait"), "Wait Revision")}/runs`, g = async (t, r) => c(await u(e, m, {
+				body: JSON.stringify({
+					engineContract: n,
+					inputs: {},
+					version: 1
+				}),
+				headers: { "idempotency-key": t },
+				method: "POST"
+			}), 202, r), _ = await g("wait-run", "Create Wait Run"), v = s(_.runId, "Wait Run runId"), y = _;
+			for (let t = 0; y.status != "waiting" && t < 200; t += 1) await new Promise((e) => setTimeout(e, 10)), y = await c(await u(e, `/v1/runs/${v}`), 200, "Read Wait Run");
+			i(y.status, "waiting", "Wait Run status");
+			let b = a(y.waiting, "Active Wait");
+			i(b.actions, ["approve", "reject"], "Wait actions"), i(b.nodeId, "approval", "Wait node"), i(b.prompt, "Approve request 1?", "Wait prompt"), s(b.expiresAt, "Wait expiry"), s(b.waitingSince, "Wait start");
+			let x = s(b.waitId, "Wait id");
+			i(o((await c(await u(e, `/v1/flows/${d}/runs?status=waiting`), 200, "List waiting Runs")).runs, "Waiting Runs").map((e) => a(e, "Waiting Run").runId), [v], "Waiting Run list");
+			let S = await c(await u(e, `/v1/runs/${v}/events`), 200, "Read waiting Run events");
+			i(S.done, !1, "Waiting events done"), o(S.events, "Waiting events").some((e) => a(e, "Waiting event").kind == "run.waiting") || r("Waiting Run must contain run.waiting."), await l(await u(e, `/v1/runs/${v}/result`), 409, "run.not-terminal", "Read waiting Run result");
+			let C = `/v1/runs/${v}/waits/${x}/resolve`, w = (t) => u(e, C, {
+				body: JSON.stringify({
+					action: t,
+					version: 1
+				}),
+				method: "POST"
+			});
+			await l(await w("continue"), 400, "run.invalid", "Reject unsupported Wait action");
+			let T = await c(await w("approve"), 200, "Approve Wait");
+			i(T.action, "approve", "Approved action"), i(T.resolutionAccepted, !0, "Approved resolution"), i(T.status, "queued", "Resolved Run status"), s(T.resolvedAt, "Wait resolution time");
+			let E = await c(await w("reject"), 200, "Reject resolved Wait");
+			i(E.action, "approve", "Winning action"), i(E.resolutionAccepted, !1, "Competing resolution");
+			for (let t = 0; y.status != "completed" && t < 200; t += 1) await new Promise((e) => setTimeout(e, 10)), y = await c(await u(e, `/v1/runs/${v}`), 200, "Read resumed Run");
+			i(y.status, "completed", "Resumed Run status"), i(y.waiting, void 0, "Completed Wait projection");
+			let D = await c(await w("approve"), 200, "Replay approved Wait");
+			i(D.resolutionAccepted, !0, "Replayed resolution"), i(D.status, "completed", "Replayed terminal status"), i(o((await c(await u(e, `/v1/runs/${v}/events`), 200, "Read resumed Run events")).events, "Completed events").filter((e) => a(e, "Completed event").kind == "run.resolved").length, 1, "Resolved event count");
+			let O = await g("wait-run-cancel", "Create cancelable Wait Run"), k = s(O.runId, "Cancelable Wait Run id"), A = O;
+			for (let t = 0; A.status != "waiting" && t < 200; t += 1) await new Promise((e) => setTimeout(e, 10)), A = await c(await u(e, `/v1/runs/${k}`), 200, "Read cancelable Wait Run");
+			i(A.status, "waiting", "Cancelable Wait status"), i((await c(await u(e, `/v1/runs/${k}/cancel`, {
+				body: JSON.stringify({ version: 1 }),
+				method: "POST"
+			}), 200, "Cancel waiting Run")).status, "canceled", "Canceled waiting Run status");
+		}
+	},
 	{
 		name: "rejects invalid and missing Flow control targets",
 		async verify(e) {
@@ -321,35 +400,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"));
@@ -385,20 +464,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"));
@@ -420,4 +499,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

@@ -18,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';
@@ -25,6 +27,7 @@ export declare const controlErrorCode: {
     readonly runNotFound: 'run.not-found';
     readonly runNotTerminal: 'run.not-terminal';
     readonly runOverloaded: 'run.overloaded';
+    readonly runWaitNotFound: 'run.wait-not-found';
     readonly triggerKeyInvalid: 'trigger-key.invalid';
     readonly triggerKeyNotFound: 'trigger-key.not-found';
     readonly triggerNotFound: 'trigger.not-found';
@@ -91,6 +94,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;
     };
@@ -112,6 +121,9 @@ export declare const controlErrorMetadata: {
     readonly "run.overloaded": {
         readonly status: 429;
     };
+    readonly "run.wait-not-found": {
+        readonly status: 404;
+    };
     readonly "trigger-key.invalid": {
         readonly status: 409;
     };

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

@@ -1,6 +1,6 @@
 import type { RunStatus } from './run-lifecycle.js';
-import type { ChangeOperation, InputPortDefinition, JsonValue, PortDefinition, RevisionContent, TriggerKeySnapshot } from '../browser/flow-change.js';
-export type { JsonValue, TriggerKeySnapshot } from '../browser/flow-change.js';
+import type { ChangeOperation, InputPortDefinition, JsonValue, PortDefinition, RevisionContent, TriggerKeySnapshot, WaitAction } from '../browser/flow-change.js';
+export type { JsonValue, TriggerKeySnapshot, WaitAction } from '../browser/flow-change.js';
 export type { RunStatus } from './run-lifecycle.js';
 export { controlErrorCode, controlErrorMetadata, type ControlErrorCode } from './control-api-errors.js';
 export type { FlowCatalogEvent, FlowChangeEvent } from './flow-notifications.js';
@@ -80,8 +80,10 @@ export interface ConnectorConnection {
 }
 export interface ConnectorAction {
     readonly actionId: string;
+    readonly authenticated: boolean;
     readonly defaultConnection?: ConnectorConnection;
     readonly description: string;
+    readonly homepageUrl?: string;
     readonly icon?: string;
     readonly inputs: Readonly<Record<string, InputPortDefinition>>;
     readonly name: string;
@@ -90,6 +92,7 @@ export interface ConnectorAction {
     readonly serviceName: string;
 }
 export interface ConnectorProvider {
+    readonly homepageUrl?: string;
     readonly icon?: string;
     readonly serviceId: string;
     readonly serviceName: string;
@@ -111,18 +114,11 @@ export interface DraftChange {
     readonly revision: RevisionMetadata;
     readonly version: 1;
 }
-export type DraftSync = {
-    readonly kind: 'changes';
-    readonly revisions: readonly {
-        readonly operations: readonly ChangeOperation[];
-        readonly revision: RevisionMetadata;
-    }[];
-    readonly version: 1;
-} | {
+export interface DraftSync {
     readonly draft: Draft;
     readonly kind: 'snapshot';
     readonly version: 1;
-};
+}
 export interface Publication {
     readonly actorId: string;
     readonly closureDigest: string;
@@ -137,6 +133,37 @@ 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;
@@ -188,6 +215,14 @@ interface RunDetailsBase extends Run {
     readonly eventsExpiresAt?: string;
     readonly modelVersion: number;
     readonly revisionDigest: string;
+    readonly waiting?: {
+        readonly actions: readonly ['continue'] | readonly ['approve', 'reject'];
+        readonly expiresAt: string;
+        readonly nodeId: string;
+        readonly prompt: string;
+        readonly waitId: string;
+        readonly waitingSince: string;
+    };
 }
 export type DraftRun = RunDetailsBase & {
     readonly source: 'draft';
@@ -209,7 +244,7 @@ export interface RunPage {
     readonly runs: readonly Run[];
     readonly version: 1;
 }
-export type RunEventKind = 'node.artifact' | 'node.completed' | 'node.failed' | 'node.log' | 'node.output' | 'node.progress' | 'node.started' | 'run.canceled' | 'run.completed' | 'run.events-truncated' | 'run.failed' | 'run.indeterminate' | 'run.progress' | 'run.queued' | 'run.started';
+export type RunEventKind = 'node.artifact' | 'node.completed' | 'node.failed' | 'node.log' | 'node.output' | 'node.progress' | 'node.started' | 'run.canceled' | 'run.completed' | 'run.events-truncated' | 'run.failed' | 'run.indeterminate' | 'run.progress' | 'run.queued' | 'run.resolved' | 'run.started' | 'run.waiting';
 export interface RunEvent {
     readonly createdAt: string;
     readonly kind: RunEventKind;
@@ -297,7 +332,7 @@ export declare class ControlClient {
     resumeFlowTrigger(flowId: string, triggerNodeId: string): Promise<TriggerBinding>;
     testFlowPollTrigger(flowId: string, triggerNodeId: string): Promise<PollTriggerTestResult>;
     getDraft(flowId: string): Promise<Draft>;
-    syncDraft(flowId: string, fromRevisionId?: string): Promise<DraftSync>;
+    syncDraft(flowId: string): Promise<DraftSync>;
     getRevision(flowId: string, revisionId: string): Promise<Draft>;
     listConnectorProviders(signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorProvider[]>;
     listConnectorActions(serviceId?: string, signal?: AbortSignal, flowId?: string): Promise<readonly ConnectorAction[]>;
@@ -305,7 +340,7 @@ export declare class ControlClient {
     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>;
+    changeDraft(flowId: string, expectedRevisionId: string, operations: readonly ChangeOperation[], changeId?: string): Promise<DraftChange>;
     checkFlow(flowId: string, revisionId: string): Promise<FlowCheck>;
     getLive(flowId: string): Promise<Live>;
     listPublications(flowId: string, options?: {
@@ -315,7 +350,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?: {
@@ -329,6 +365,15 @@ export declare class ControlClient {
     }): Promise<RunEvents>;
     getRunResult(runId: string): Promise<RunResult>;
     cancelRun(runId: string): Promise<RunCancellation>;
+    resolveRunWait(runId: string, waitId: string, action: WaitAction): Promise<{
+        readonly action: WaitAction | null;
+        readonly resolutionAccepted: boolean;
+        readonly resolvedAt: string | null;
+        readonly runId: string;
+        readonly status: RunStatus;
+        readonly version: 1;
+        readonly waitId: string;
+    }>;
     private connectorActions;
     protected request<Value = unknown>(path: string, init?: RequestInit): Promise<Value>;
 }