@oomol-lab/open-flow 0.1.0-beta.23 → 0.1.0-beta.26

package/dist/common/run-lifecycle.d.ts

@@ -42,7 +42,7 @@ export type RunTransition = {
     readonly status: 'waiting';
 } | {
     readonly kind: 'resolved';
-    readonly status: 'queued';
+    readonly status: 'queued' | 'starting' | 'running';
 } | {
     readonly kind: 'stale';
     readonly status: RunStatus;

package/dist/common/run-lifecycle.js

@@ -84,12 +84,12 @@ function a(e, t) {
 			kind: "stale",
 			status: e
 		};
-		case "resolve": return e == "waiting" ? {
-			kind: "resolved",
-			status: "queued"
-		} : {
+		case "resolve": return i(e) ? {
 			kind: "stale",
 			status: e
+		} : {
+			kind: "resolved",
+			status: e == "waiting" ? "queued" : e
 		};
 		case "fail-start":
 		case "fail-resume": return e == "starting" ? {
@@ -102,7 +102,7 @@ function a(e, t) {
 		case "commit": return i(e) ? {
 			kind: "stale",
 			status: e
-		} : t.status == "canceled" || e == "running" || t.status == "failed" && e == "waiting" ? {
+		} : t.status == "canceled" || e == "running" || t.status == "failed" ? {
 			kind: "committed",
 			status: t.status
 		} : {

package/dist/common/runtime-contract.d.ts

@@ -1,6 +1,8 @@
 import type { CodeModule, ConnectorCapability, JsonValue } from '../browser/flow-change.js';
 export { currentEngineContract, nodejsEngineContract, findEngineContract, type EngineContract } from './engine-contract.js';
 export type RuntimeModule = Pick<CodeModule, 'imports' | 'source'>;
+/** Snapshot a Task result before JSON transport can discard or coerce invalid values. */
+export declare function snapshotRuntimeResult(value: unknown): JsonValue | undefined;
 export declare const nodejsRuntimeConformanceCases: readonly RuntimeConformanceCase[];
 export interface RuntimeProgram {
     readonly engineContract: string;

package/dist/common/runtime-contract.js

@@ -19,7 +19,7 @@ function t(n, r) {
 }
 //#endregion
 //#region src/execution/common/engineContract.ts
-var n = "open-flow-engine/v2", r = "open-flow-engine/v2/nodejs-compat-v1", i = {
+var n = "open-flow-engine/v4", r = "open-flow-engine/v4/nodejs-compat-v1", i = {
 	platformExports: /* @__PURE__ */ new Set(["engineContract", "identity"]),
 	platformModule: "open-flow:platform",
 	platformSource: `export const engineContract = ${JSON.stringify(n)}
@@ -58,15 +58,26 @@ export function identity(value) { return value }
 `
 };
 function o(e) {
-	if (e == "open-flow-engine/v2") return i;
-	if (e == "open-flow-engine/v2/nodejs-compat-v1") return a;
+	if (e == "open-flow-engine/v4") return i;
+	if (e == "open-flow-engine/v4/nodejs-compat-v1") return a;
 }
 //#endregion
 //#region src/execution/common/runtime.ts
-var s = [{
+function s(e) {
+	let t = /* @__PURE__ */ new Set(), n = (e, r) => {
+		if (r > 64) throw Error("Task result exceeds the maximum JSON depth.");
+		if (e === null || typeof e == "string" || typeof e == "boolean" || typeof e == "number" && Number.isFinite(e)) return e;
+		if (typeof e != "object" || t.has(e) || !Array.isArray(e) && Object.getPrototypeOf(e) !== Object.prototype && Object.getPrototypeOf(e) !== null || Object.getOwnPropertySymbols(e).length > 0) throw Error("Task result must contain only JSON values.");
+		t.add(e);
+		let i = Array.isArray(e) ? Array.from(e, (e) => n(e, r + 1)) : Object.fromEntries(Object.entries(e).filter(([, e]) => r != 0 || e !== void 0).map(([e, t]) => [e, n(t, r + 1)]));
+		return t.delete(e), i;
+	};
+	return e === void 0 ? void 0 : n(e, 0);
+}
+var c = [{
 	name: "supports Node builtin imports and asynchronous virtual file operations",
 	async verify(e) {
-		l(await e.invoke({
+		u(await e.invoke({
 			capability: async () => ({
 				body: null,
 				status: 403
@@ -74,7 +85,7 @@ var s = [{
 			input: null,
 			invocationId: "nodejs-files",
 			program: {
-				...c(e, "import assert from 'node:assert/strict';\nimport { Buffer } from 'node:buffer'; import path from 'node:path'; import fs from 'node:fs/promises';\nexport default async () => {\n  const file = path.join('/tmp', 'conformance.txt');\n  await fs.writeFile(file, Buffer.from('你好'));\n  const text = await fs.readFile(file, 'utf8');\n  assert.equal(text, '你好');\n  await fs.unlink(file);\n  return { text, bytes: Buffer.byteLength(text) };\n}"),
+				...l(e, "import assert from 'node:assert/strict';\nimport { Buffer } from 'node:buffer'; import path from 'node:path'; import fs from 'node:fs/promises';\nexport default async () => {\n  const file = path.join('/tmp', 'conformance.txt');\n  await fs.writeFile(file, Buffer.from('你好'));\n  const text = await fs.readFile(file, 'utf8');\n  assert.equal(text, '你好');\n  await fs.unlink(file);\n  return { text, bytes: Buffer.byteLength(text) };\n}"),
 				engineContract: r
 			}
 		}), {
@@ -85,7 +96,7 @@ var s = [{
 }, {
 	name: "preserves abort reasons and cancels Promise timers",
 	async verify(e) {
-		l(await e.invoke({
+		u(await e.invoke({
 			capability: async () => ({
 				body: null,
 				status: 403
@@ -93,7 +104,7 @@ var s = [{
 			input: null,
 			invocationId: "nodejs-abort",
 			program: {
-				...c(e, "import { setTimeout } from 'node:timers/promises';\nexport default async () => {\n  const controller = new AbortController(); const reason = { message: 'stop' };\n  const combined = AbortSignal.any([controller.signal]);\n  const pending = setTimeout(60000, 'late', { signal: combined });\n  controller.abort(reason); controller.abort('ignored');\n  let thrown; try { combined.throwIfAborted(); } catch (error) { thrown = error; }\n  try { await pending; return false; } catch (error) {\n    return { sameReason: combined.reason === reason && thrown === reason, name: error.name };\n  }\n}"),
+				...l(e, "import { setTimeout } from 'node:timers/promises';\nexport default async () => {\n  const controller = new AbortController(); const reason = { message: 'stop' };\n  const combined = AbortSignal.any([controller.signal]);\n  const pending = setTimeout(60000, 'late', { signal: combined });\n  controller.abort(reason); controller.abort('ignored');\n  let thrown; try { combined.throwIfAborted(); } catch (error) { thrown = error; }\n  try { await pending; return false; } catch (error) {\n    return { sameReason: combined.reason === reason && thrown === reason, name: error.name };\n  }\n}"),
 				engineContract: r
 			}
 		}), {
@@ -102,7 +113,7 @@ var s = [{
 		}, "Node cancellation");
 	}
 }];
-function c(e, t, r = {}) {
+function l(e, t, r = {}) {
 	return {
 		engineContract: n,
 		engineDigest: e.engineDigest,
@@ -116,10 +127,10 @@ function c(e, t, r = {}) {
 		}
 	};
 }
-function l(e, n, r) {
+function u(e, n, r) {
 	if (!t(e, n)) throw Error(`${r}: expected ${JSON.stringify(n)}, received ${JSON.stringify(e)}.`);
 }
-async function u(e, t, n) {
+async function d(e, t, n) {
 	try {
 		await e;
 	} catch (e) {
@@ -128,7 +139,60 @@ async function u(e, t, n) {
 	}
 	throw Error(`${n}: operation unexpectedly succeeded.`);
 }
-var d = [
+var f = [
+	{
+		name: "rejects Task results that JSON transport would discard or coerce",
+		async verify(e) {
+			for (let t of [
+				"{ value: () => 42 }",
+				"{ value: Symbol(\"value\") }",
+				"{ value: NaN }",
+				"{ value: Infinity }",
+				"{ value: 1n }",
+				"{ value: { nested: undefined } }",
+				"{ value: [undefined] }",
+				"{ value: Array(1) }",
+				"{ value: new Date() }",
+				"{ value: { toJSON() { return \"hidden\" } } }",
+				"{ [Symbol(\"key\")]: 1 }",
+				"(() => { const value = {}; value.self = value; return { value } })()"
+			]) await d(e.invoke({
+				capability: async () => ({
+					body: null,
+					status: 200
+				}),
+				input: null,
+				invocationId: "invalid-task-result",
+				program: l(e, `export default () => (${t})`)
+			}), /Task result must contain only JSON values/, `Invalid Task result: ${t}`);
+		}
+	},
+	{
+		name: "snapshots JSON results while preserving missing ports and shared values",
+		async verify(e) {
+			let t = await e.invoke({
+				capability: async () => ({
+					body: null,
+					status: 200
+				}),
+				input: null,
+				invocationId: "json-task-result",
+				program: l(e, "export default () => {\n            const shared = { text: 'hello', values: [1, true, null] };\n            return { missing: undefined, nullable: null, first: shared, second: shared };\n          }")
+			}), n = {
+				text: "hello",
+				values: [
+					1,
+					!0,
+					null
+				]
+			};
+			u(t, {
+				nullable: null,
+				first: n,
+				second: n
+			}, "JSON Task result");
+		}
+	},
 	{
 		name: "preserves Action error codes and fixed per-call Connection selection",
 		async verify(e) {
@@ -140,10 +204,10 @@ var d = [
 					alias: "office"
 				}, { connectionId: "home" }]
 			}];
-			l(await e.invoke({
+			u(await e.invoke({
 				capabilities: t,
 				capability: async ({ payload: e }) => {
-					let n = p(t, e);
+					let n = m(t, e);
 					if (n.input.fail) throw Object.assign(/* @__PURE__ */ Error("Provider unavailable."), { code: "connector.unavailable" });
 					return {
 						body: n.connectionId ?? null,
@@ -152,7 +216,7 @@ var d = [
 				},
 				input: null,
 				invocationId: "action-accounts",
-				program: c(e, "export default async (_, context) => {\n          const values = await Promise.all([\n            context.actions.example.echo({}, { connectionAlias: 'office' }),\n            context.actions['example.echo']({}, { connectionId: 'home' }),\n          ])\n          try { await context.actions.example.echo({ fail: true }, { connectionId: 'work' }) }\n          catch (error) { values.push(error.code) }\n          return values\n        }")
+				program: l(e, "export default async (_, context) => {\n          const values = await Promise.all([\n            context.actions.example.echo({}, { connectionAlias: 'office' }),\n            context.actions['example.echo']({}, { connectionId: 'home' }),\n          ])\n          try { await context.actions.example.echo({ fail: true }, { connectionId: 'work' }) }\n          catch (error) { values.push(error.code) }\n          return values\n        }")
 			}), [
 				"work",
 				"home",
@@ -164,7 +228,7 @@ var d = [
 		name: "shares Action entries and assigns independent concurrent call identities",
 		async verify(e) {
 			let t = [];
-			l(await e.invoke({
+			u(await e.invoke({
 				capabilities: [{
 					kind: "connector",
 					action: "example.echo",
@@ -176,7 +240,7 @@ var d = [
 				}),
 				input: null,
 				invocationId: "action-calls",
-				program: c(e, "export default async (_input, context) => {\n          const call = context.actions.example.echo\n          return { same: call === context.actions['example.echo'], values: await Promise.all([call({ value: 1 }), call({ value: 2 }), call({ value: 3 })]) }\n        }")
+				program: l(e, "export default async (_input, context) => {\n          const call = context.actions.example.echo\n          return { same: call === context.actions['example.echo'], values: await Promise.all([call({ value: 1 }), call({ value: 2 }), call({ value: 3 })]) }\n        }")
 			}), {
 				same: !0,
 				values: [
@@ -187,7 +251,7 @@ var d = [
 					action: "example.echo",
 					input: { value: e }
 				}))
-			}, "Action results"), l(new Set(t.map((e) => e.callId)).size, 3, "Independent Action identities"), l(t.map((e) => e.invocationId), [
+			}, "Action results"), u(new Set(t.map((e) => e.callId)).size, 3, "Independent Action identities"), u(t.map((e) => e.invocationId), [
 				"action-calls",
 				"action-calls",
 				"action-calls"
@@ -197,13 +261,13 @@ var d = [
 	{
 		name: "loads the fixed ESM closure and platform module",
 		async verify(e) {
-			l(await e.invoke({
+			u(await e.invoke({
 				capability: async () => {
 					throw Error("Capability must not be called.");
 				},
 				input: { value: 6 },
 				invocationId: "module-closure",
-				program: c(e, "import { double } from './helper.mjs'\nimport { engineContract, identity } from 'open-flow:platform'\nexport default (input) => ({ engineContract, value: identity(double(input.value)) })", { helper: {
+				program: l(e, "import { double } from './helper.mjs'\nimport { engineContract, identity } from 'open-flow:platform'\nexport default (input) => ({ engineContract, value: identity(double(input.value)) })", { helper: {
 					imports: [],
 					source: "export const double = (value) => value * 2"
 				} })
@@ -216,14 +280,14 @@ var d = [
 	{
 		name: "rejects modules outside the fixed closure",
 		async verify(e) {
-			await u(e.invoke({
+			await d(e.invoke({
 				capability: async () => ({
 					body: null,
 					status: 200
 				}),
 				input: null,
 				invocationId: "closed-linker",
-				program: c(e, "import fs from 'node:fs'\nexport default () => fs.readFileSync('/etc/passwd', 'utf8')")
+				program: l(e, "import fs from 'node:fs'\nexport default () => fs.readFileSync('/etc/passwd', 'utf8')")
 			}), /invalid|unsupported|cannot import|not part of/i, "Closed linker");
 		}
 	},
@@ -231,7 +295,7 @@ var d = [
 		name: "copies asynchronous Capability requests and responses",
 		async verify(e) {
 			let t = [];
-			l(await e.invoke({
+			u(await e.invoke({
 				capability: async (e) => (t.push(e), {
 					body: {
 						accepted: !0,
@@ -241,7 +305,7 @@ var d = [
 				}),
 				input: { issue: 42 },
 				invocationId: "async-capability",
-				program: c(e, "export default async (input, capability) => capability.artifact.put({ action: 'read', input })")
+				program: l(e, "export default async (input, capability) => capability.artifact.put({ action: 'read', input })")
 			}), {
 				body: {
 					accepted: !0,
@@ -251,7 +315,7 @@ var d = [
 					}
 				},
 				status: 200
-			}, "Capability result"), l(t.map(({ invocationId: e, kind: t, payload: n }) => ({
+			}, "Capability result"), u(t.map(({ invocationId: e, kind: t, payload: n }) => ({
 				invocationId: e,
 				kind: t,
 				payload: n
@@ -268,13 +332,13 @@ var d = [
 	{
 		name: "returns final outputs without exposing intermediate output capability",
 		async verify(e) {
-			l(await e.invoke({
+			u(await e.invoke({
 				capability: async () => {
 					throw Error("Capability must not be called.");
 				},
 				input: null,
 				invocationId: "final-outputs",
-				program: c(e, "export default (_input, context) => ({ available: typeof context.outputs, value: 1 })")
+				program: l(e, "export default (_input, context) => ({ available: typeof context.outputs, value: 1 })")
 			}), {
 				available: "undefined",
 				value: 1
@@ -297,14 +361,14 @@ var d = [
 				}, { once: !0 }))),
 				input: null,
 				invocationId: "canceled-capability",
-				program: c(e, "export default async (_input, context) => context.actions.example.wait({})"),
+				program: l(e, "export default async (_input, context) => context.actions.example.wait({})"),
 				signal: t.signal
 			});
-			await i, t.abort(/* @__PURE__ */ Error("Invocation canceled.")), await u(a, /cancel|abort|disposed/i, "Canceled invocation"), l(n, !0, "Capability cancellation");
+			await i, t.abort(/* @__PURE__ */ Error("Invocation canceled.")), await d(a, /cancel|abort|disposed/i, "Canceled invocation"), u(n, !0, "Capability cancellation");
 		}
 	}
 ];
-function f(e, t) {
+function p(e, t) {
 	let n = (e, t) => {
 		if (!(e === null || typeof e == "string" || typeof e == "boolean" || typeof e == "number" && Number.isFinite(e))) {
 			if (typeof e != "object" || t.has(e) || !Array.isArray(e) && Object.getPrototypeOf(e) !== Object.prototype && Object.getPrototypeOf(e) !== null || Object.getOwnPropertySymbols(e).length > 0) throw Object.assign(/* @__PURE__ */ Error("Action parameters must contain only JSON values."), { code: "capability.invalid" });
@@ -326,7 +390,7 @@ function f(e, t) {
 	for (let e of i.values()) Object.freeze(e);
 	return Object.freeze(r);
 }
-function p(e, t) {
+function m(e, t) {
 	let n = Object.assign(/* @__PURE__ */ Error("The Action request is invalid."), { code: "capability.invalid" }), r = Object.assign(/* @__PURE__ */ Error("The Action or Connection is not declared for this Task."), { code: "capability.denied" });
 	if (typeof t != "object" || !t || Array.isArray(t)) throw n;
 	let i = t;
@@ -356,4 +420,4 @@ function p(e, t) {
 	};
 }
 //#endregion
-export { f as createActions, n as currentEngineContract, o as findEngineContract, r as nodejsEngineContract, s as nodejsRuntimeConformanceCases, p as resolveAction, d as runtimeConformanceCases };
+export { p as createActions, n as currentEngineContract, o as findEngineContract, r as nodejsEngineContract, c as nodejsRuntimeConformanceCases, m as resolveAction, f as runtimeConformanceCases, s as snapshotRuntimeResult };

package/dist/common/scheduler.d.ts

@@ -60,6 +60,40 @@ export interface FlowRunResult {
         readonly outputs: Readonly<Record<string, JsonValue>>;
     }[];
 }
+export interface PendingWait {
+    readonly jobId: string;
+    readonly nodeId: string;
+    readonly value: JsonValue;
+    readonly waitId: string;
+    readonly notification?: JsonValue;
+}
+export interface WaitRequest {
+    readonly jobId: string;
+    readonly nodeId: string;
+    readonly value: JsonValue;
+    readonly waitId: string;
+    readonly actions: readonly ['continue'] | readonly ['approve', 'reject'];
+    readonly prompt: string;
+    readonly notify: boolean;
+    readonly notification?: {
+        readonly input: Readonly<Record<string, JsonValue>>;
+        readonly messageHandle: string;
+        readonly taskId: string;
+    };
+}
+export type WaitOperation = {
+    readonly kind: 'create';
+    readonly wait: WaitRequest;
+} | {
+    readonly kind: 'resolutions';
+    readonly waitIds: readonly string[];
+    readonly block: boolean;
+};
+export interface WaitHost {
+    readonly create: (wait: WaitRequest) => Effect.Effect<JsonValue | undefined, Error>;
+    readonly resolutions: (waitIds: readonly string[], block: boolean) => Effect.Effect<Readonly<Record<string, WaitAction>>, Error>;
+}
+export declare const waitRetentionMs = 120000;
 export interface FlowRunCheckpoint {
     readonly bindingValues: Readonly<Record<string, string>>;
     readonly inputs: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
@@ -68,36 +102,19 @@ export interface FlowRunCheckpoint {
         readonly outputs: Readonly<Record<string, JsonValue>>;
     }>>;
     readonly skipped: readonly string[];
-    readonly version: 2;
-    readonly queue: readonly FlowRunCheckpoint['wait'][];
+    readonly version: 3;
+    readonly waits: readonly PendingWait[];
     readonly agents: Readonly<Record<string, {
         readonly invocationId: string;
         readonly input: Readonly<Record<string, JsonValue>>;
         readonly remainingMs?: number;
         readonly checkpoint: AgentCheckpoint;
     }>>;
-    readonly wait: {
-        readonly jobId: string;
-        readonly nodeId: string;
-        readonly value: JsonValue;
-        readonly waitId: string;
-    };
 }
 export type FlowRunOutcome = FlowRunResult | {
     readonly checkpoint: FlowRunCheckpoint;
     readonly kind: 'waiting';
-    readonly notification?: {
-        readonly input: Readonly<Record<string, JsonValue>>;
-        readonly messageHandle: string;
-        readonly taskId: string;
-    };
-    readonly wait: {
-        readonly actions: readonly ['continue'] | readonly ['approve', 'reject'];
-        readonly prompt: string;
-        readonly jobId: string;
-        readonly nodeId: string;
-        readonly waitId: string;
-    };
+    readonly remainingMs?: number;
 };
 export interface SubflowRunResult {
     readonly kind: 'function-outputs';
@@ -139,6 +156,8 @@ export type FlowRunOptions = {
     readonly invokeTask: (invocation: TaskInvocation) => Effect.Effect<unknown, Error>;
     readonly projectFailure?: (error: unknown) => SchedulerFailure;
     readonly runId: string;
+    readonly waits?: WaitHost;
+    readonly remainingMs?: number;
 } & RunLaunch;
 export type RunLaunch = {
     readonly bindingValues?: Readonly<Record<string, string>>;
@@ -147,7 +166,6 @@ export type RunLaunch = {
     readonly resume?: never;
 } | {
     readonly resume: {
-        readonly action: WaitAction;
         readonly checkpoint: unknown;
     };
     readonly bindingValues?: never;