@oomol-lab/open-flow 0.1.0-beta.27 → 0.1.0-beta.28

package/dist/common/flowInspection.d.ts

@@ -0,0 +1,16 @@
+import type { Draft, Flow } from './control-api.js';
+export declare function inspectFlowDraft(flow: Flow, readDraft: () => Draft | Promise<Draft>): Promise<{
+    flow: Flow;
+    draft: Draft;
+    version: 1;
+    draftIssue?: undefined;
+} | {
+    flow: Flow;
+    draft: null;
+    draftIssue: {
+        code: unknown;
+        message: string;
+        revisionId: string;
+    };
+    version: 1;
+}>;

package/dist/common/integration-trigger.d.ts

@@ -14,7 +14,7 @@ export interface ListenerPage {
     readonly checkpoint: JsonValue;
     readonly dedupeKey: string;
     readonly hasMore: boolean;
-    readonly payload: Readonly<Record<string, JsonValue>> | null;
+    readonly outputs: Readonly<Record<string, JsonValue>> | null;
 }
 export interface ListenerSource {
     readonly intervalMs: number;
@@ -28,7 +28,7 @@ export type IntegrationReceiveResult = {
     readonly continue?: boolean;
     readonly dedupeKey?: string;
     readonly outcome: 'event';
-    readonly payload: Readonly<Record<string, JsonValue>>;
+    readonly outputs: Readonly<Record<string, JsonValue>>;
 } | {
     readonly checkpoint?: JsonValue;
     readonly continue?: boolean;

package/dist/common/integration-trigger.js

@@ -90,7 +90,7 @@ var a = 65536, o = 5, s = /^\/v1\/integrations\/(endpoint_[0-9a-f]{32})$/, c = n
 function l(e) {
 	if (!i(e) || e.checkpoint == null || !r(e.checkpoint) || typeof e.hasMore != "boolean") throw TypeError("Listener page must contain a JSON checkpoint and a boolean hasMore.");
 	if (typeof e.dedupeKey != "string" || e.dedupeKey.length == 0 || c.encode(e.dedupeKey).byteLength > 1024) throw TypeError("Listener page identity must contain between 1 and 1024 bytes.");
-	if (e.payload !== null && !i(e.payload)) throw TypeError("Listener page payload must be an object or null.");
+	if (e.outputs !== null && !i(e.outputs)) throw TypeError("Listener page outputs must be an object or null.");
 	if (c.encode(JSON.stringify(e.checkpoint)).byteLength > 65536) throw TypeError("Listener checkpoint exceeds 64 KiB.");
 }
 var u = class extends Error {
@@ -163,11 +163,11 @@ var g = {
 					continue: r < i,
 					dedupeKey: `${a}:${r}`,
 					outcome: "event",
-					payload: {
+					outputs: { payload: {
 						body: { page: r },
 						deliveryId: a,
 						event: "conformance"
-					}
+					} }
 				};
 			}
 			let n = typeof t?.deliveryId == "string" ? t.deliveryId : "delivery", r = C(t?.body) ?? {};
@@ -175,11 +175,11 @@ var g = {
 				checkpoint: { deliveryId: n },
 				dedupeKey: n,
 				outcome: "event",
-				payload: {
+				outputs: { payload: {
 					body: r,
 					deliveryId: n,
 					event: "conformance"
-				}
+				} }
 			};
 		},
 		async reconcile(e) {
@@ -359,16 +359,16 @@ var g = {
 					checkpoint: n + 1,
 					dedupeKey: String(n),
 					hasMore: n + 1 < r,
-					payload: {
+					outputs: { payload: {
 						body: {},
 						deliveryId: String(n),
 						event: "change"
-					}
+					} }
 				} : {
 					checkpoint: e,
 					dedupeKey: String(n),
 					hasMore: !1,
-					payload: null
+					outputs: null
 				};
 			}
 		}

package/dist/common/mcp.d.ts

@@ -80,6 +80,7 @@ export declare const mcpTools: {
                 validate(value: unknown): {
                     value: {
                         kind?: string | undefined;
+                        example?: string | undefined;
                     };
                 } | {
                     issues: {
@@ -300,7 +301,7 @@ export declare const mcpTools: {
                         publicationId?: string | undefined;
                         trigger: {
                             nodeId: string;
-                            payload: JsonValue;
+                            outputs: Record<string, JsonValue>;
                         };
                         inputs: Record<string, Record<string, JsonValue>>;
                         idempotencyKey: string;

package/dist/common/mcp.js

@@ -4458,39 +4458,53 @@ function sc(e, t = 0) {
 	if (typeof e == "object" && e) for (let n of Object.values(e)) sc(n, t + 1);
 }
 //#endregion
-//#region src/flow/common/changeSchema.ts
-var R = D(), z = rc(), cc = j(R), lc = M({
+//#region src/flow/common/triggerScheduleSchema.ts
+var cc = j(P([M({
+	type: L("cron"),
+	expression: D(),
+	timezone: D()
+}), M({
+	type: L("every"),
+	unit: I([
+		"day",
+		"hour",
+		"minute",
+		"month",
+		"week"
+	]),
+	value: k()
+})])), R = D(), z = rc(), lc = j(R), uc = M({
 	description: R.optional(),
 	jsonSchema: z,
 	nullable: A(),
 	handle: R
-}), B = lc.extend({ value: z.optional() }), uc = M({
+}), B = uc.extend({ value: z.optional() }), dc = M({
 	collapsed: A().optional(),
 	group: R
-}), dc = M({
+}), fc = M({
 	kind: L("node"),
 	nodeId: R,
 	output: R
-}), fc = M({
+}), pc = M({
 	kind: L("flow"),
 	input: R
-}), pc = P([
-	dc,
+}), mc = P([
 	fc,
+	pc,
 	M({
 		kind: L("binding"),
 		bindingId: R
 	})
-]), mc = P([M({
+]), hc = P([M({
 	kind: L("value"),
 	value: z
 }), M({
 	kind: L("sources"),
-	sources: j(pc)
-})]), hc = F(R, mc), gc = {
-	inputs: j(P([B, uc])),
-	outputs: j(P([lc, uc]))
-}, _c = M({
+	sources: j(mc)
+})]), gc = F(R, hc), _c = {
+	inputs: j(P([B, dc])),
+	outputs: j(P([uc, dc]))
+}, vc = M({
 	kind: L("connector"),
 	action: R,
 	connectionId: R.optional(),
@@ -4498,19 +4512,19 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 		connectionId: R,
 		alias: R.optional()
 	}))
-}), vc = M({
-	...gc,
+}), yc = M({
+	..._c,
 	name: R,
 	moduleId: R,
-	capabilities: j(_c).optional()
-}), yc = P([M({
+	capabilities: j(vc).optional()
+}), bc = P([M({
 	kind: L("value"),
 	value: z
 }), M({
 	kind: L("input"),
 	input: R
-})]), bc = P([yc, M({ kind: L("model") })]), xc = M({
-	...gc,
+})]), xc = P([bc, M({ kind: L("model") })]), Sc = M({
+	..._c,
 	name: R,
 	executor: P([
 		M({
@@ -4526,7 +4540,7 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 			kind: L("agent"),
 			code: A().optional(),
 			model: R,
-			prompt: yc,
+			prompt: bc,
 			system: R,
 			maxRounds: k(),
 			tools: j(M({
@@ -4536,16 +4550,16 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 				action: R,
 				connectionId: R.optional(),
 				approval: A(),
-				inputs: j(B.extend({ source: bc }))
+				inputs: j(B.extend({ source: xc }))
 			})),
 			notification: M({
 				taskId: R,
 				messageHandle: R,
-				inputs: F(R, yc)
+				inputs: F(R, bc)
 			}).optional()
 		})
 	])
-}), Sc = {
+}), Cc = {
 	input: B,
 	cases: j(M({
 		output: R,
@@ -4578,41 +4592,27 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 		}))
 	})),
 	defaultOutput: R.optional()
-}, Cc = {
+}, wc = {
 	actions: P([Os([L("continue")]), Os([L("approve"), L("reject")])]),
 	prompt: R
-}, wc = {
-	inputsDef: j(B),
+}, Tc = {
+	bodyFields: j(B),
 	options: M({
-		allowedMethods: cc.optional(),
-		allowedOrigins: cc.optional(),
+		allowedMethods: lc.optional(),
+		allowedOrigins: lc.optional(),
 		noResponseBody: A().optional(),
 		responseData: R.optional(),
 		responseHeaders: F(R, R).optional(),
 		responseStatusCode: k().optional()
 	}).optional()
-}, Tc = j(P([M({
-	type: L("cron"),
-	expression: R,
-	timezone: R
-}), M({
-	type: L("every"),
-	unit: I([
-		"day",
-		"hour",
-		"minute",
-		"month",
-		"week"
-	]),
-	value: k()
-})])), Ec = {
+}, Ec = {
 	configSchema: z,
-	definitionVersion: k(),
+	definitionVersion: L(2),
 	description: R,
 	displayName: R,
 	key: R,
 	name: R,
-	payloadSchema: z,
+	outputs: j(uc).refine((e) => new Set(e.map((e) => e.handle)).size === e.length, "Duplicate Trigger output handle."),
 	provider: R
 }, Dc = M({
 	body: M({
@@ -4639,7 +4639,8 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 	description: R.optional(),
 	icon: R.optional()
 }, kc = {
-	inputs: hc,
+	maxExecutions: k().int().positive().max(2 ** 53 - 1).optional(),
+	inputs: gc,
 	name: R.optional(),
 	description: R.optional(),
 	icon: R.optional(),
@@ -4648,7 +4649,7 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 	M({
 		...kc,
 		kind: L("condition"),
-		...Sc
+		...Cc
 	}),
 	M({
 		...kc,
@@ -4664,7 +4665,7 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 	M({
 		...kc,
 		kind: L("task"),
-		task: vc,
+		task: yc,
 		additionalInputs: j(B).optional()
 	}),
 	M({
@@ -4677,7 +4678,7 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 		...kc,
 		kind: L("wait"),
 		input: B,
-		...Cc
+		...wc
 	}).omit({ timeoutMs: !0 }),
 	M({
 		...Oc,
@@ -4686,12 +4687,12 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 	M({
 		...Oc,
 		kind: L("webhook"),
-		...wc
+		...Tc
 	}),
 	M({
 		...Oc,
 		kind: L("cron"),
-		cronTimes: Tc
+		cronTimes: cc
 	}),
 	M({
 		...Oc,
@@ -4702,7 +4703,7 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 			...Ec,
 			type: L("poll")
 		}),
-		pollTimes: Tc
+		pollTimes: cc
 	}),
 	M({
 		...Oc,
@@ -4728,7 +4729,7 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 }, Nc = M({
 	name: R,
 	inputs: j(B),
-	outputs: j(lc.extend({ sources: j(P([dc, fc])) }))
+	outputs: j(uc.extend({ sources: j(P([fc, pc])) }))
 }), Pc = M({
 	nodes: F(R, Ac),
 	edges: j(Mc).default([])
@@ -4737,15 +4738,15 @@ var R = D(), z = rc(), cc = j(R), lc = M({
 	target: R
 }), Ic = M({
 	name: R,
-	imports: cc,
+	imports: lc,
 	source: R
 }), Lc = M({
 	bindings: F(R, Fc),
 	graph: Pc,
 	subflows: F(R, Nc.extend({ graph: Pc })),
-	tasks: F(R, xc)
+	tasks: F(R, Sc)
 }), Rc = M({
-	modelVersion: L(1),
+	modelVersion: L(2),
 	document: Lc,
 	modules: F(R, Ic)
 });
@@ -4780,28 +4781,38 @@ var Bc = {
 		node: Ac
 	},
 	"graph.node.delete": V,
-	"graph.node.field.set": P([M({
-		...V,
-		kind: L("graph.node.field.set"),
-		field: I([
-			"description",
-			"icon",
-			"name"
-		]),
-		before: R.optional(),
-		value: R.optional()
-	}), M({
-		...V,
-		kind: L("graph.node.field.set"),
-		field: L("timeoutMs"),
-		before: k().optional(),
-		value: k().optional()
-	})]),
+	"graph.node.field.set": P([
+		M({
+			...V,
+			kind: L("graph.node.field.set"),
+			field: I([
+				"description",
+				"icon",
+				"name"
+			]),
+			before: R.optional(),
+			value: R.optional()
+		}),
+		M({
+			...V,
+			kind: L("graph.node.field.set"),
+			field: L("maxExecutions"),
+			before: k().int().positive().max(2 ** 53 - 1).optional(),
+			value: k().int().positive().max(2 ** 53 - 1).optional()
+		}),
+		M({
+			...V,
+			kind: L("graph.node.field.set"),
+			field: L("timeoutMs"),
+			before: k().optional(),
+			value: k().optional()
+		})
+	]),
 	"graph.node.input.set": {
 		...V,
 		handle: R,
-		before: mc.optional(),
-		value: mc.optional()
+		before: hc.optional(),
+		value: hc.optional()
 	},
 	"graph.node.additional-inputs.set": {
 		...V,
@@ -4810,8 +4821,8 @@ var Bc = {
 	},
 	"graph.node.condition.set": {
 		...V,
-		before: M(Sc),
-		value: M(Sc)
+		before: M(Cc),
+		value: M(Cc)
 	},
 	"graph.node.values.set": {
 		...V,
@@ -4821,19 +4832,19 @@ var Bc = {
 	"graph.node.wait.set": {
 		...V,
 		target: M({ kind: L("flow") }),
-		before: M(Cc),
-		value: M(Cc)
+		before: M(wc),
+		value: M(wc)
 	},
 	"graph.node.webhook.set": {
 		...V,
 		target: M({ kind: L("flow") }),
-		before: M(wc),
-		value: M(wc)
+		before: M(Tc),
+		value: M(Tc)
 	},
 	"graph.node.task.ports.set": {
 		...V,
-		before: M(gc),
-		value: M(gc)
+		before: M(_c),
+		value: M(_c)
 	},
 	"graph.node.task.name.set": {
 		...V,
@@ -4842,8 +4853,8 @@ var Bc = {
 	},
 	"graph.node.task.capabilities.set": {
 		...V,
-		before: j(_c).optional(),
-		value: j(_c).optional()
+		before: j(vc).optional(),
+		value: j(vc).optional()
 	},
 	"graph.trigger.config.set": {
 		nodeId: R,
@@ -4853,8 +4864,8 @@ var Bc = {
 	},
 	"graph.trigger.schedule.set": {
 		nodeId: R,
-		before: Tc,
-		value: Tc
+		before: cc,
+		value: cc
 	},
 	"module.create": {
 		moduleId: R,
@@ -4868,9 +4879,9 @@ var Bc = {
 	},
 	"module.source.replace": {
 		moduleId: R,
-		beforeImports: cc,
+		beforeImports: lc,
 		beforeSource: R,
-		imports: cc,
+		imports: lc,
 		source: R
 	},
 	"subflow.create": {
@@ -4885,7 +4896,7 @@ var Bc = {
 	"subflow.delete": { subflowId: R },
 	"task.create": {
 		taskId: R,
-		task: xc
+		task: Sc
 	},
 	"task.delete": { taskId: R },
 	"task.connector.connection.set": {
@@ -4895,8 +4906,8 @@ var Bc = {
 	},
 	"task.agent.set": {
 		taskId: R,
-		before: xc,
-		value: xc
+		before: Sc,
+		value: Sc
 	},
 	"task.llm.mode.set": {
 		taskId: R,
@@ -5017,6 +5028,8 @@ var H = {
 	eventSourceNotFound: "event-source.not-found",
 	eventSourceConflict: "event-source.conflict",
 	flowInvalid: "flow.invalid",
+	flowRepairRequired: "flow.repair-required",
+	flowUpgradeRequired: "flow.upgrade-required",
 	flowNotFound: "flow.not-found",
 	flowBusy: "flow.busy",
 	flowConflict: "flow.conflict",
@@ -5044,7 +5057,7 @@ var H = {
 	variableLimitReached: "variable.limit-reached",
 	variableNotFound: "variable.not-found"
 };
-H.eventSourceInvalid, H.eventSourceIdentityUnavailable, H.eventSourceNotFound, H.eventSourceConflict, H.authenticationRequired, H.authorizationDenied, H.bindingUnresolved, H.connectorActionNotFound, H.connectorUnconfigured, H.connectorUnavailable, H.connectorConsoleUnconfigured, H.engineUnavailable, H.engineUnsupported, H.flowInvalid, H.flowNotFound, H.flowBusy, H.flowConflict, H.flowPresentationConflict, H.flowRevisionConflict, H.liveConflict, H.liveNotFound, H.pageInvalidCursor, H.publicationConflict, H.publicationNotFound, H.publicationUnsupported, H.publishOperationNotFound, H.routeNotFound, H.runConflict, H.runEventsExpired, H.runInvalid, H.runNotFound, H.runNotTerminal, H.runOverloaded, H.runWaitNotFound, H.triggerKeyInvalid, H.triggerKeyNotFound, H.triggerNotFound, H.variableInvalid, H.variableLimitReached, H.variableNotFound;
+H.eventSourceInvalid, H.eventSourceIdentityUnavailable, H.eventSourceNotFound, H.eventSourceConflict, H.authenticationRequired, H.authorizationDenied, H.bindingUnresolved, H.connectorActionNotFound, H.connectorUnconfigured, H.connectorUnavailable, H.connectorConsoleUnconfigured, H.engineUnavailable, H.engineUnsupported, H.flowInvalid, H.flowRepairRequired, H.flowUpgradeRequired, H.flowNotFound, H.flowBusy, H.flowConflict, H.flowPresentationConflict, H.flowRevisionConflict, H.liveConflict, H.liveNotFound, H.pageInvalidCursor, H.publicationConflict, H.publicationNotFound, H.publicationUnsupported, H.publishOperationNotFound, H.routeNotFound, H.runConflict, H.runEventsExpired, H.runInvalid, H.runNotFound, H.runNotTerminal, H.runOverloaded, H.runWaitNotFound, H.triggerKeyInvalid, H.triggerKeyNotFound, H.triggerNotFound, H.variableInvalid, H.variableLimitReached, H.variableNotFound;
 var $c = class extends Error {
 	constructor(e, t, n) {
 		super(n), this.code = t, this.name = "ApiError", this.status = e;
@@ -5093,12 +5106,19 @@ function tl(e) {
 function nl(e) {
 	let t = W(e), n = tl(t), r = {
 		configSchema: J(t.configSchema),
-		definitionVersion: q(t.definitionVersion),
+		definitionVersion: t.definitionVersion === 2 ? 2 : U(),
 		description: n.description,
 		displayName: n.displayName,
 		key: n.key,
 		name: n.name,
-		payloadSchema: J(t.payloadSchema),
+		outputs: (Array.isArray(t.outputs) ? t.outputs : U()).map((e) => {
+			let t = W(e);
+			return Object.assign({
+				handle: G(t.handle),
+				jsonSchema: J(t.jsonSchema),
+				nullable: typeof t.nullable == "boolean" ? t.nullable : U()
+			}, t.description == null ? {} : { description: G(t.description) });
+		}),
 		provider: n.provider
 	};
 	if (n.type == "poll") return {
@@ -5695,7 +5715,7 @@ M({
 }).strict(), M({
 	kind: L("open-flow-project-revision"),
 	version: L(1),
-	modelVersion: L(1),
+	modelVersion: P([L(1), L(2)]),
 	modules: F(D(), M({
 		name: D(),
 		source: D(),
@@ -6378,10 +6398,20 @@ var mu = class {
 			method: "POST"
 		}));
 	}
+	async repairDraft(e, t, n = pu("repair")) {
+		return Ql(await this.request(`/v1/flows/${Y(e)}/draft/repair`, {
+			body: JSON.stringify({
+				expectedRevisionId: t,
+				version: 1
+			}),
+			headers: { "idempotency-key": n },
+			method: "POST"
+		}));
+	}
 	async checkFlow(e, t) {
 		return Cl(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}/check`, {
 			body: JSON.stringify({
-				engineContract: "open-flow-engine/v4",
+				engineContract: "open-flow-engine/v5",
 				version: 1
 			}),
 			method: "POST"
@@ -6399,10 +6429,10 @@ var mu = class {
 	async createDraftRun(e, t, n) {
 		let r = iu(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}/runs`, {
 			body: JSON.stringify({
-				engineContract: "open-flow-engine/v4",
+				engineContract: "open-flow-engine/v5",
 				inputs: n.inputs ?? {},
 				trigger: n.trigger,
-				version: 1
+				version: 2
 			}),
 			headers: { "idempotency-key": n.idempotencyKey ?? pu("run") },
 			method: "POST"
@@ -6415,7 +6445,7 @@ var mu = class {
 				inputs: t.inputs ?? {},
 				trigger: t.trigger,
 				publicationId: e,
-				version: 1
+				version: 2
 			}),
 			headers: { "idempotency-key": t.idempotencyKey ?? pu("run") },
 			method: "POST"
@@ -6435,7 +6465,7 @@ var mu = class {
 	async publishFlow(e, t, n, r = {}) {
 		return Bl(await this.request(`/v1/flows/${Y(e)}/revisions/${Y(t)}/publications`, {
 			body: JSON.stringify({
-				engineContract: "open-flow-engine/v4",
+				engineContract: "open-flow-engine/v5",
 				expectedLivePublicationId: n,
 				version: 1
 			}),
@@ -6600,7 +6630,7 @@ var gu = [
 				revisionId: r.revision.revisionId,
 				trigger: {
 					nodeId: "start",
-					payload: {}
+					outputs: {}
 				}
 			}, a = [];
 			for (let t = 0; t < 2; t++) {
@@ -6711,8 +6741,11 @@ var Cu = {
 		cursor: Z.optional(),
 		limit: bu
 	}), !0),
-	flow_get: $("Read Flow metadata, the full Draft and current Live publication. Use draft.revisionId as the base of an edit.", N({ flowId: Q }), !0),
-	flow_schema: $("Get the JSON Schema for atomic change operations, optionally one operation kind. Node titles must be non-empty and unique within a graph.", N({ kind: Z.optional() }), !0),
+	flow_get: $("Read Flow metadata, the full Draft and current Live publication. Unreadable Drafts return draft=null and draftIssue; flow.live still identifies the published version. Use draft.revisionId as the base of an edit.", N({ flowId: Q }), !0),
+	flow_schema: $("Get an operation schema by kind, or a complete apply batch by example (connector, poll, poll-notification, code, wait). Use example=index to list examples. graph.trigger.create resolves a provider key into a fixed definition at commit.", N({
+		kind: Z.optional(),
+		example: Z.optional()
+	}).refine((e) => e.kind == null || e.example == null, "Choose kind or example, not both."), !0),
 	flow_create: $("Create an empty Flow. If this deployment uses OOMOL Connector, choose a teamId from connector_teams. Keep the key and arguments stable when retrying.", N({
 		name: Z.refine((e) => e == e.trim() && Uc(e) == null, "Flow name is invalid."),
 		idempotencyKey: yu,
@@ -6750,7 +6783,7 @@ var Cu = {
 		publicationId: Z.optional(),
 		trigger: N({
 			nodeId: Z,
-			payload: vu
+			outputs: F(D(), vu)
 		}),
 		inputs: F(D(), F(D(), vu)).default({}),
 		idempotencyKey: yu

package/dist/common/poll-trigger.d.ts

@@ -21,7 +21,10 @@ export interface PollContext {
     readonly now: Date;
     readonly signal?: AbortSignal;
 }
+export declare function payloadPollOutputs(events: readonly PollEvent[]): Readonly<Record<string, JsonValue>>;
 export interface PollDefinition {
+    /** Constructs one Run's outputs from a nonempty batch of fresh, deduplicated events. */
+    readonly buildOutputs: (events: readonly PollEvent[]) => Readonly<Record<string, JsonValue>>;
     readonly configOptions?: (context: TriggerConfigOptionsContext) => Promise<readonly TriggerConfigOption[]>;
     readonly poll: (context: PollContext) => Promise<PollResult>;
     readonly snapshot: TriggerKeySnapshot & {