@oomol-lab/open-flow 0.1.0-beta.69 → 0.1.0-beta.70

package/dist/common/control-api.js

@@ -1,5 +1,5 @@
 //#region src/execution/common/engineContract.ts
-var currentEngineContract = "open-flow-engine/v6";
+var currentEngineContract = "open-flow-engine/v7";
 `${JSON.stringify(currentEngineContract)}`, new Set([
 	"assert",
 	"assert/strict",
@@ -25,7 +25,7 @@ var currentEngineContract = "open-flow-engine/v6";
 	"url",
 	"util",
 	"zlib"
-].flatMap((name) => [name, `node:${name}`])), `${JSON.stringify("open-flow-engine/v6/nodejs-compat-v1")}`;
+].flatMap((name) => [name, `node:${name}`])), `${JSON.stringify("open-flow-engine/v7/nodejs-compat-v1")}`;
 //#endregion
 //#region ../../node_modules/.bun/dequal@2.0.3/node_modules/dequal/lite/index.mjs
 var has = Object.prototype.hasOwnProperty;
@@ -1072,7 +1072,7 @@ function timeSource(args) {
 function time(args) {
 	return new RegExp(`^${timeSource(args)}$`);
 }
-function datetime(args) {
+function datetime$1(args) {
 	const opts = ["Z"];
 	if (args.offset) opts.push(`([+-](?:[01]\\d|2[0-3]):[0-5]\\d)`);
 	const qualified = `${timeSource({
@@ -1723,7 +1723,7 @@ var $ZodKSUID = /*@__PURE__*/ $constructor("$ZodKSUID", (inst, def) => {
 	$ZodStringFormat.init(inst, def);
 });
 var $ZodISODateTime = /*@__PURE__*/ $constructor("$ZodISODateTime", (inst, def) => {
-	def.pattern ?? (def.pattern = datetime(def));
+	def.pattern ?? (def.pattern = datetime$1(def));
 	$ZodStringFormat.init(inst, def);
 });
 var $ZodISODate = /*@__PURE__*/ $constructor("$ZodISODate", (inst, def) => {
@@ -5720,6 +5720,11 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
+//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/iso.js
+function datetime(params) {
+	return /* @__PURE__ */ _isoDateTime(ZodISODateTime, params);
+}
+//#endregion
 //#region src/openapi/common/authBindings.ts
 /** Never allow credentials to enter a Revision as literal node inputs. */
 function assertOpenApiAuthBindings(document) {
@@ -5852,6 +5857,33 @@ var triggerScheduleSchema = array(union([object({
 	value: number()
 })]));
 //#endregion
+//#region src/localization/common/timeZone.ts
+/** Validate a named timezone using the same runtime data used for date conversion. */
+function isTimeZone(value) {
+	try {
+		Intl.DateTimeFormat("en", { timeZone: value });
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/flow/common/wait.ts
+/** Drafts retain incomplete values; semantic validation gates publication and execution. */
+var waitAutoContinueDraftSchema = discriminatedUnion("kind", [strictObject({
+	kind: literal("after"),
+	durationMs: number().nullable()
+}), strictObject({
+	kind: literal("at"),
+	at: string$1(),
+	timezone: string$1().optional()
+})]);
+/** Static business configuration; the deployment owns the allowed wait lifetime. */
+var waitAutoContinueSchema = discriminatedUnion("kind", [waitAutoContinueDraftSchema.options[0].extend({ durationMs: number().int().positive().max(Number.MAX_SAFE_INTEGER) }), waitAutoContinueDraftSchema.options[1].extend({
+	at: datetime({ offset: true }),
+	timezone: string$1().refine(isTimeZone, "Select a valid IANA timezone.").optional()
+})]);
+//#endregion
 //#region src/flow/common/webhookMethod.ts
 var webhookMethods = [
 	"GET",
@@ -5863,6 +5895,44 @@ var webhookMethods = [
 function webhookSupportsBody(method) {
 	return method !== "GET";
 }
+//#endregion
+//#region src/flow/common/webhookResponse.ts
+var webhookResponseTimeout = {
+	defaultMs: 3e4,
+	minMs: 1e3,
+	maxMs: 6e4
+};
+/** Fixed inputs belong to the node, not author-supplied definitions. */
+var webhookResponseInputs = [
+	{
+		handle: "body",
+		jsonSchema: {},
+		nullable: true,
+		value: ""
+	},
+	{
+		handle: "statusCode",
+		jsonSchema: { type: "number" },
+		nullable: false,
+		value: 200
+	},
+	{
+		handle: "headers",
+		jsonSchema: {
+			jsonSchema: {
+				type: "object",
+				additionalProperties: { type: [
+					"string",
+					"number",
+					"boolean"
+				] }
+			},
+			nullable: true
+		}.jsonSchema,
+		nullable: false,
+		value: {}
+	}
+];
 var text = string$1();
 var actionConnection = text.describe("Account selection: omit while unconfigured; use an account ID to select it; use \"\" to explicitly defer configuration. Deferred Actions fail if called; deferred Agent tools are excluded from the callable tool set. Not supported by Triggers.");
 var json$2 = json$3();
@@ -6090,9 +6160,24 @@ var webhookOptions = object({
 	allowedMethods: never().optional(),
 	allowedOrigins: strings$1.optional(),
 	noResponseBody: never().optional(),
+	responseBody: discriminatedUnion("kind", [strictObject({
+		kind: literal("workflow-outputs"),
+		output: text.optional(),
+		timeoutMs: number().int().min(webhookResponseTimeout.minMs).max(webhookResponseTimeout.maxMs).optional()
+	}), strictObject({
+		kind: literal("webhook-response"),
+		nodeId: text.optional(),
+		timeoutMs: number().int().min(webhookResponseTimeout.minMs).max(webhookResponseTimeout.maxMs).optional()
+	})]).optional(),
 	responseData: text.optional(),
 	responseHeaders: record$2(text, text).optional(),
-	responseStatusCode: number().int().min(200).max(599).optional()
+	responseHeadersSource: strictObject({
+		kind: literal("workflow-outputs"),
+		output: text.optional()
+	}).optional(),
+	responseHeaderOutputs: record$2(text, text).optional(),
+	responseStatusCode: number().int().min(200).max(599).optional(),
+	responseStatusCodeOutput: text.optional()
 });
 var webhook = {
 	bodyFields: array(input),
@@ -6147,6 +6232,12 @@ var base = {
 	onError: _enum(["stop", "error"]).optional()
 };
 var node = union([
+	strictObject({
+		...base,
+		kind: literal("webhook-response"),
+		retry: never().optional(),
+		onError: never().optional()
+	}),
 	strictObject({
 		...base,
 		kind: literal("outputs"),
@@ -6179,7 +6270,8 @@ var node = union([
 	strictObject({
 		...base,
 		kind: literal("wait"),
-		...wait
+		...wait,
+		autoContinue: waitAutoContinueDraftSchema.optional()
 	}).omit({ timeoutMs: true }),
 	object({
 		...trigger,
@@ -6235,6 +6327,7 @@ var authoringDefinitionSchemas = {
 	ports: ports$1,
 	condition: strictObject(condition),
 	wait: strictObject(wait),
+	waitAutoContinue: waitAutoContinueSchema,
 	webhook: strictObject(webhook),
 	schedule: triggerScheduleSchema,
 	capabilities: array(capability),
@@ -6281,7 +6374,8 @@ var revision = object({
 		literal(6),
 		literal(7),
 		literal(8),
-		literal(9)
+		literal(9),
+		literal(10)
 	]),
 	document,
 	modules: record$2(text, module)
@@ -6414,8 +6508,14 @@ var shapes = {
 	},
 	"graph.node.resolution.set": {
 		...at,
-		before: object(wait),
-		value: object(wait)
+		before: strictObject({
+			...wait,
+			autoContinue: waitAutoContinueDraftSchema.optional()
+		}),
+		value: strictObject({
+			...wait,
+			autoContinue: waitAutoContinueDraftSchema.optional()
+		})
 	},
 	"graph.node.webhook.set": {
 		...at,
@@ -6476,12 +6576,14 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...shape
 })])).values()])).min(1);
 function checkModelVersion(content) {
+	if (content.modelVersion < 10 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "webhook" && (candidateNode.options?.responseBody != null || candidateNode.options?.responseStatusCodeOutput != null || candidateNode.options?.responseHeadersSource != null || candidateNode.options?.responseHeaderOutputs != null))) throw new TypeError("Dynamic Webhook responses require Flow model version 10.");
 	if (content.modelVersion < 9 && Object.values(content.document.graph.nodes).some((candidateNode) => "retry" in candidateNode && candidateNode.retry != null)) throw new TypeError("Node retries require Flow model version 9.");
 	if (content.modelVersion < 9 && Object.values(content.document.graph.nodes).some((candidateNode) => {
 		if (candidateNode.onError != null) return true;
 		if ([...Object.values("inputs" in candidateNode ? candidateNode.inputs : {}), ...Object.values(candidateNode.kind == "outputs" ? candidateNode.outputMappings : {})].some((candidateMapping) => candidateMapping.kind == "sources" && candidateMapping.sources.some((candidateSource) => candidateSource.kind == "node" && candidateSource.system))) return true;
 		return candidateNode.kind == "condition" && candidateNode.cases.some((item) => item.groups.some((candidateGroup) => candidateGroup.expressions.some((expression) => [expression.left, expression.right].some((candidateOperand) => candidateOperand?.kind == "source" && candidateOperand.source.kind == "node" && candidateOperand.source.system))));
 	})) throw new TypeError("Node error handling requires Flow model version 9.");
+	if (content.modelVersion < 10 && Object.values(content.document.graph.nodes).some((candidate) => candidate.kind === "webhook-response")) throw new TypeError("Webhook response nodes require Flow model version 10.");
 	if (content.modelVersion < 8 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "outputs")) throw new TypeError("Workflow outputs require Flow model version 8.");
 	if (content.modelVersion < 7 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "start")) throw new TypeError("Start Triggers require Flow model version 7.");
 	if (content.modelVersion < 6 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task)) throw new TypeError("Node-owned managed Tasks require Flow model version 6.");
@@ -9365,6 +9467,7 @@ var patch = record$2(id$1, json$1);
 var type = _enum([
 	"start",
 	"outputs",
+	"webhook-response",
 	"workflow",
 	"webhook",
 	"cron",
@@ -9468,29 +9571,30 @@ var when = union([
 	strictObject({ any: array(union([expression, all])) })
 ]);
 var authoringConfigurations = {
-	workflow: strictObject({ flowId: id$1 }),
-	start: strictObject({ inputDefs: flowInputFields.default({}) }),
-	outputs: strictObject({ outputDefs: flowOutputFields.default({}) }),
-	error: strictObject({ sourceFlowIds: array(id$1).optional() }),
-	webhook: authoringDefinitionSchemas.webhook.omit({ bodyFields: true }).extend({ body: inputFields }).strict(),
-	cron: strictObject({ schedule: authoringDefinitionSchemas.schedule }),
-	poll: strictObject({
+	"webhook-response": strictObject({}),
+	"workflow": strictObject({ flowId: id$1 }),
+	"start": strictObject({ inputDefs: flowInputFields.default({}) }),
+	"outputs": strictObject({ outputDefs: flowOutputFields.default({}) }),
+	"error": strictObject({ sourceFlowIds: array(id$1).optional() }),
+	"webhook": authoringDefinitionSchemas.webhook.omit({ bodyFields: true }).extend({ body: inputFields }).strict(),
+	"cron": strictObject({ schedule: authoringDefinitionSchemas.schedule }),
+	"poll": strictObject({
 		key: id$1,
 		connectionId: id$1.optional(),
 		schedule: authoringDefinitionSchemas.schedule
 	}),
-	integration: strictObject({
+	"integration": strictObject({
 		key: id$1,
 		connectionId: id$1.optional()
 	}),
-	code: strictObject({
+	"code": strictObject({
 		inputs: inputFields,
 		outputs: outputFields,
 		capabilities: authoringDefinitionSchemas.capabilities.optional()
 	}),
-	connector: authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
-	openapi: authoringOpenApiSchema,
-	agent: authoringDefinitionSchemas.agent.omit({
+	"connector": authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
+	"openapi": authoringOpenApiSchema,
+	"agent": authoringDefinitionSchemas.agent.omit({
 		prompt: true,
 		tools: true
 	}).extend({
@@ -9499,9 +9603,9 @@ var authoringConfigurations = {
 		tools: array(agentTool),
 		notification: notification.optional()
 	}).strict(),
-	llm: authoringLlmConfiguration.extend({ inputs: inputFields }),
-	decision: authoringDefinitionSchemas.decision,
-	condition: strictObject({
+	"llm": authoringLlmConfiguration.extend({ inputs: inputFields }),
+	"decision": authoringDefinitionSchemas.decision,
+	"condition": strictObject({
 		match: _enum(["first", "all"]),
 		branches: array(strictObject({
 			name: id$1,
@@ -9509,12 +9613,15 @@ var authoringConfigurations = {
 			when
 		}))
 	}),
-	value: strictObject({
+	"value": strictObject({
 		values: patch,
 		outputs: outputFields
 	}),
-	wait: strictObject({ inputs: inputFields }),
-	approval: strictObject({ inputs: inputFields })
+	"wait": strictObject({
+		inputs: inputFields,
+		autoContinue: authoringDefinitionSchemas.waitAutoContinue.optional().describe("Wait only. Omit to disable; clear config.autoContinue to remove. after counts from each wait registration; at requires an explicit offset and continues immediately if already past. Optional timezone preserves the editor zone; at remains the absolute instant. Server requires the deadline to precede the 7-day expiry.")
+	}),
+	"approval": strictObject({ inputs: inputFields })
 };
 var updates = strictObject({
 	onError: _enum(["stop", "error"]).optional(),
@@ -10888,6 +10995,7 @@ function triggerOutputPorts(trigger) {
 //#region src/flow/common/graph.ts
 function nodeInputPorts(node) {
 	switch (node.kind) {
+		case "webhook-response": return portsByHandle(webhookResponseInputs);
 		case "outputs": return portsByHandle(node.outputDefs);
 		case "condition": return conditionInputPorts(node);
 		case "value": return {};
@@ -10934,7 +11042,8 @@ function resolutionOutputPorts(node) {
 				pattern: "\\S"
 			},
 			...Object.fromEntries(actions.map((action) => [`${action}Url`, { type: "string" }])),
-			expiresAt: { type: "string" }
+			expiresAt: { type: "string" },
+			...node.kind == "wait" && node.autoContinue != null ? { autoContinueAt: { type: "string" } } : {}
 		}),
 		...Object.fromEntries(actions.map((action) => [action, objectPort({
 			inputs,
@@ -10946,6 +11055,7 @@ function resolutionOutputPorts(node) {
 }
 function nodeOutputPorts(node) {
 	switch (node.kind) {
+		case "webhook-response":
 		case "outputs":
 		case "condition": return {};
 		case "value": return portsByHandle(node.values);
@@ -11039,6 +11149,10 @@ function inspectNode(node) {
 		...Object.keys(defaults).length == 0 ? {} : { inputDefaults: defaults }
 	};
 	switch (node.kind) {
+		case "webhook-response": return {
+			...node,
+			...ports
+		};
 		case "outputs": return {
 			...node,
 			...ports,
@@ -11854,6 +11968,7 @@ function runWaiting(value) {
 	if (!Array.isArray(actions) || !(actions.length == 1 && actions[0] == "continue" || actions.length == 2 && actions[0] == "approve" && actions[1] == "reject")) return invalidResponse();
 	return {
 		actions,
+		...source.autoContinueAt === void 0 ? {} : { autoContinueAt: string(source.autoContinueAt) },
 		expiresAt: string(source.expiresAt),
 		nodeId: string(source.nodeId),
 		prompt: string(source.prompt),
@@ -12128,24 +12243,32 @@ function decodeRunEvent(value) {
 				kind,
 				payload: { waitIds: payload.waitIds.map((id) => string(id)) }
 			};
-		case "wait.created": return {
-			...base,
-			kind,
-			payload: {
-				expiresAt: string(payload.expiresAt),
-				nodeId: string(payload.nodeId),
-				waitId: string(payload.waitId),
-				waitingSince: string(payload.waitingSince)
-			}
-		};
+		case "wait.created": {
+			const timing = payload.autoContinueAt === void 0 ? {} : { autoContinueAt: string(payload.autoContinueAt) };
+			return {
+				...base,
+				kind,
+				payload: {
+					...timing,
+					expiresAt: string(payload.expiresAt),
+					nodeId: string(payload.nodeId),
+					waitId: string(payload.waitId),
+					waitingSince: string(payload.waitingSince)
+				}
+			};
+		}
 		case "run.resolved": {
 			const action = payload.action;
+			const resolutionSource = payload.source;
+			if (resolutionSource !== void 0 && resolutionSource !== "manual" && resolutionSource !== "automatic") return invalidResponse();
+			const audit = resolutionSource === void 0 ? {} : { source: resolutionSource };
 			if (action !== "approve" && action !== "continue" && action !== "reject") return invalidResponse();
 			if (payload.comment !== null && typeof payload.comment != "string") return invalidResponse();
 			return {
 				...base,
 				kind,
 				payload: {
+					...audit,
 					action,
 					comment: payload.comment,
 					resolvedAt: string(payload.resolvedAt),
@@ -12181,7 +12304,7 @@ function decodeRunEvent(value) {
 			switch (kind) {
 				case "node.started": {
 					const nodeKind = payload.nodeKind;
-					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "decision" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "value" && nodeKind !== "outputs" && nodeKind !== "workflow" && nodeKind !== "wait") return invalidResponse();
+					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "decision" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "value" && nodeKind !== "outputs" && nodeKind !== "webhook-response" && nodeKind !== "workflow" && nodeKind !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,

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

@@ -35,7 +35,7 @@ export declare const controlRequests: {
         edits: ({
             op: "node.add";
             as: string;
-            type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow";
+            type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
             name: string;
             onError?: "error" | "stop" | undefined;
             retry?: {
@@ -177,12 +177,12 @@ export declare const controlRequests: {
     authoringSearch: (value: unknown) => {
         revision?: string | undefined;
         query: string;
-        type?: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow" | undefined;
+        type?: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow" | undefined;
         offset: number;
         limit: number;
     };
     authoringSchema: (value: unknown) => {
-        type?: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "workflow" | undefined;
+        type?: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow" | undefined;
         action?: string | undefined;
     };
     loadOpenApiDocument: (value: unknown) => {