@oomol-lab/open-flow 0.1.0-beta.62 → 0.1.0-beta.64

package/dist/common/mcp.js

@@ -5851,6 +5851,23 @@ function preprocess(fn, schema) {
 		out: schema
 	});
 }
+/** Transient operations on each connected canvas's own viewport. */
+var canvasCommandSchema = discriminatedUnion("type", [
+	strictObject({
+		type: literal("focus"),
+		nodeId: string$1().min(1)
+	}),
+	strictObject({
+		type: literal("zoom"),
+		zoom: number().min(.1).max(3)
+	}),
+	strictObject({
+		type: literal("pan"),
+		dx: number(),
+		dy: number()
+	}),
+	strictObject({ type: literal("fit") })
+]);
 //#endregion
 //#region ../../node_modules/.bun/dequal@2.0.3/node_modules/dequal/lite/index.mjs
 var has = Object.prototype.hasOwnProperty;
@@ -6850,10 +6867,10 @@ function compileEnumAndConst(context, enumList, constValue, schema) {
 		}
 		if (compiledEnum.length === 0) recordWarn(context, "all of elements from list is rejected by currently schema object", "enum");
 	}
-	if (constValue && valid(schema, constValue) === ValidResult.Invalid) isNever = true;
+	if (constValue !== void 0 && valid(schema, constValue) === ValidResult.Invalid) isNever = true;
 	if (compiledEnum) {
 		if (compiledEnum.length === 0) isNever = true;
-		else if (constValue) {
+		else if (constValue !== void 0) {
 			let foundEquals = false;
 			for (const enumValue of compiledEnum) if (isDeepEquals(enumValue, constValue)) {
 				foundEquals = true;
@@ -6866,7 +6883,7 @@ function compileEnumAndConst(context, enumList, constValue, schema) {
 	const compiledSchema = {};
 	if (schema.type) compiledSchema.type = schema.type;
 	if (compiledEnum) compiledSchema.enum = compiledEnum;
-	if (constValue) compiledSchema.const = wrapCompiledValue(deepCopy(constValue));
+	if (constValue !== void 0) compiledSchema.const = wrapCompiledValue(deepCopy(constValue));
 	return wrapCompiledSchema(kind, compiledSchema, context.delegate, context.path);
 }
 //#endregion
@@ -7261,7 +7278,7 @@ function compileSchema(context, schema) {
 	let targetSchema = schema;
 	let shouldHandleEnumAndConst = false;
 	const { enum: enumList, const: constValue } = schema;
-	if (enumList || constValue) {
+	if (enumList || constValue !== void 0) {
 		const { enum: _0, const: _1, ...rest } = schema;
 		targetSchema = rest;
 		shouldHandleEnumAndConst = true;
@@ -7851,7 +7868,7 @@ function schemaEqualsChecker(extendsContext) {
 	}
 	function isValueEquals(value1, value2) {
 		if (value1 === value2) return true;
-		if (value1 === null) return false;
+		if (value1 === null || value2 === null) return false;
 		if (typeof value1 !== "object") return false;
 		if (typeof value1 !== typeof value2) return false;
 		if (isCompiledSchema(value1) && isCompiledSchema(value2)) return isCompiledSchemaEquals(value1, value2);
@@ -8417,7 +8434,7 @@ function findMismatchPath(source, target) {
 			if ((sourceSchema.maxProperties ?? Number.POSITIVE_INFINITY) > (targetSchema.maxProperties ?? Number.POSITIVE_INFINITY)) return [...targetPath, "maxProperties"];
 			break;
 		}
-		case CompiledKind.EnumOrConst: return [...targetPath, targetSchema.const == null ? "enum" : "const"];
+		case CompiledKind.EnumOrConst: return [...targetPath, targetSchema.const === void 0 ? "enum" : "const"];
 	}
 	return targetPath;
 }
@@ -8894,7 +8911,8 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional()
+			connectionId: text.optional(),
+			outputMode: literal("value").optional()
 		}),
 		object({
 			kind: literal("openapi"),
@@ -9525,7 +9543,7 @@ var authoringConfigurations = {
 		outputs: outputFields,
 		capabilities: authoringDefinitionSchemas.capabilities.optional()
 	}),
-	connector: authoringDefinitionSchemas.connector.strict(),
+	connector: authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
 	openapi: authoringOpenApiSchema,
 	agent: authoringDefinitionSchemas.agent.omit({
 		prompt: true,
@@ -10253,6 +10271,24 @@ function providerIconAppearance(metadata, position) {
 		}
 	};
 }
+//#endregion
+//#region src/flow/common/workflowFile.ts
+var envelope = strictObject({
+	kind: literal("open-flow-workflow"),
+	version: literal(1),
+	name: string$1().optional(),
+	content: unknown(),
+	presentation: record$2(string$1(), json$4()).optional()
+});
+/** Structural decoding only: incomplete drafts are supported, repair is never attempted. */
+function decodeWorkflowFile(value) {
+	checkJsonDepth(value, -1);
+	const file = envelope.parse(value);
+	return {
+		...file,
+		content: decodeRevisionContent(file.content)
+	};
+}
 new TextEncoder();
 //#endregion
 //#region src/control/common/providerAccess.ts
@@ -11620,6 +11656,26 @@ var ControlClient = class {
 		exact(source, ["version"]);
 		if (source.version != 1) return invalidResponse();
 	}
+	async exportFlow(flowId) {
+		const value = await this.request(`/v1/flows/${segment(flowId)}/export`);
+		try {
+			return decodeWorkflowFile(value);
+		} catch {
+			return invalidResponse();
+		}
+	}
+	async importFlow(file, options = {}) {
+		return flow$1(await this.request("/v1/flows/import", {
+			method: "POST",
+			headers: { "Idempotency-Key": options.idempotencyKey ?? `flow-${randomId()}` },
+			body: JSON.stringify({
+				file,
+				name: options.name,
+				teamId: options.teamId,
+				version: 1
+			})
+		}));
+	}
 	async createFlow(name, idempotencyKey = `flow-${randomId()}`, teamId) {
 		return flow$1(await this.request("/v1/flows", {
 			body: JSON.stringify({
@@ -11631,6 +11687,26 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
+	async broadcastCanvas(flowId, command) {
+		const source = record(await this.request(`/v1/flows/${segment(flowId)}/canvas`, {
+			method: "POST",
+			body: JSON.stringify({
+				version: 1,
+				command
+			})
+		}));
+		exact(source, [
+			"version",
+			"flowId",
+			"broadcast"
+		]);
+		if (source.version != 1 || source.broadcast !== true || source.flowId !== flowId) return invalidResponse();
+		return {
+			version: 1,
+			flowId: string(source.flowId),
+			broadcast: true
+		};
+	}
 	async getFlow(flowId) {
 		return flow$1(await this.request(`/v1/flows/${segment(flowId)}`));
 	}
@@ -12179,6 +12255,43 @@ async function rpc(harness, method, params) {
 	return body.result;
 }
 var mcpConformanceCases = [
+	{
+		name: "shares workflow import and export with REST and preserves idempotency",
+		async verify(harness) {
+			const client = new ControlClient((url, init) => harness.request(new Request(new URL(url, harness.origin), init)));
+			const original = await client.createFlow("Template source");
+			const exported = await rpc(harness, "tools/call", {
+				name: "flow_export",
+				arguments: { flowId: original.flowId }
+			});
+			assert(exported.isError != true, "MCP export failed.");
+			assert(dequal(exported.structuredContent, await client.exportFlow(original.flowId)), "MCP and REST exports differ.");
+			const args = {
+				file: exported.structuredContent,
+				name: "Imported template",
+				idempotencyKey: crypto.randomUUID()
+			};
+			const imported = await rpc(harness, "tools/call", {
+				name: "flow_import",
+				arguments: args
+			});
+			assert(imported.isError != true, "MCP import failed.");
+			const flow = imported.structuredContent;
+			assert(flow.flowId != original.flowId && flow.draftRevisionId != original.draftRevisionId, "Import reused resource identities.");
+			assert((await client.getEditor(flow.flowId)).live.publication == null, "Import published the Flow.");
+			assert(dequal((await rpc(harness, "tools/call", {
+				name: "flow_import",
+				arguments: args
+			})).structuredContent, imported.structuredContent), "Import retry created another Flow.");
+			assert((await rpc(harness, "tools/call", {
+				name: "flow_import",
+				arguments: {
+					...args,
+					name: "Changed import"
+				}
+			})).isError == true, "Changed import must conflict.");
+		}
+	},
 	{
 		name: "publishes the public MCP catalog, input schemas and annotations",
 		async verify(harness) {
@@ -12314,14 +12427,14 @@ var mutationKey = id.max(256).describe("Stable identity for this mutation. Retry
 var pageLimit = int().min(1).max(100).default(50);
 var flow = id.describe("Exact Flow ID returned by flow_list or flow_create.");
 var run = id.describe("Exact Run ID returned by flow_run or run_list.");
-var mcpInstructions = "Use flow_list, flow_read and flow_search to inspect root workflows. Read node type schemas with flow_schema. Use flow_edit with the observed baseRevision and a stable requestId. Node edits affect only the selected node. Text edits require exactly one match. Execution edges and input sources are independent. Legacy Subflow content is unsupported. Edits can save incomplete drafts; inspect returned diagnostics and use flow_check before running. Use flow_check before flow_run. Select an explicit Trigger node ID and fixed revision or publication. A new Flow has no Trigger until you add one. Before adding a Feishu Trigger, use event_source_list and compare its Connection IDs with connector_connections in the Flow scope. If no source is available, create and verify one in Workbench. Use flow_publish to publish a fixed Revision, then poll flow_publish_status until succeeded or failed. Use flow_live to inspect current online entries after publication. Use flow_set_enabled to enable or disable the observed Live publication. flow_run returns an accepted Run, not its final result. Find Runs with run_list, poll run_get and use run_result after terminal. Resolve a waiting Run only with an explicit run_resolve_wait action allowed by run_get. Use run_results and run_result_read to inspect stored Agent tool results; these are separate from the terminal Run result. Retry flow_edit with identical arguments and the same requestId. Retry flow_create, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. Other mutations use the same resource identity and arguments when retrying. Cancel a Run explicitly with run_cancel. Use nextCursor and nextAfter to read subsequent pages. Connector-backed deployments may require a Team; inspect connector_teams before creating a Flow.";
-function tool(description, schema, readOnly) {
+var mcpInstructions = "Use flow_list, flow_read and flow_search to inspect root workflows. Read node type schemas with flow_schema. Use flow_edit with the observed baseRevision and a stable requestId. Node edits affect only the selected node. Text edits require exactly one match. Execution edges and input sources are independent. Legacy Subflow content is unsupported. Edits can save incomplete drafts; inspect returned diagnostics and use flow_check before running. Use flow_check before flow_run. Select an explicit Trigger node ID and fixed revision or publication. A new Flow has no Trigger until you add one. Before adding a Feishu Trigger, use event_source_list and compare its Connection IDs with connector_connections in the Flow scope. If no source is available, create and verify one in Workbench. Use flow_publish to publish a fixed Revision, then poll flow_publish_status until succeeded or failed. Use flow_live to inspect current online entries after publication. Use flow_set_enabled to enable or disable the observed Live publication. flow_run returns an accepted Run, not its final result. Find Runs with run_list, poll run_get and use run_result after terminal. Resolve a waiting Run only with an explicit run_resolve_wait action allowed by run_get. Use run_results and run_result_read to inspect stored Agent tool results; these are separate from the terminal Run result. Retry flow_edit with identical arguments and the same requestId. Retry flow_create, flow_import, flow_publish and flow_run only with identical arguments and the same idempotencyKey; a new key can execute the Flow again. Canvas commands are transient broadcasts without execution confirmation; never automatically retry flow_canvas because pan is relative. Other mutations use the same resource identity and arguments when retrying. Cancel a Run explicitly with run_cancel. Use nextCursor and nextAfter to read subsequent pages. Connector-backed deployments may require a Team; inspect connector_teams before creating a Flow.";
+function tool(description, schema, readOnly, idempotent = true) {
 	return {
 		description,
 		annotations: {
 			readOnlyHint: readOnly,
 			destructiveHint: !readOnly,
-			idempotentHint: true,
+			idempotentHint: idempotent,
 			openWorldHint: true
 		},
 		inputSchema: { "~standard": {
@@ -12342,6 +12455,10 @@ function tool(description, schema, readOnly) {
 	};
 }
 var mcpTools = {
+	flow_canvas: tool("Broadcast a transient canvas command to connected Workbenches viewing this Flow. Success only confirms Server broadcast, not delivery or execution. No replay, session selection or Presentation save. Pan uses screen pixels (positive right/down); zoom is an absolute ratio (0.1–3); fit includes all nodes. Repeating pan moves again.", strictObject({
+		flowId: flow,
+		command: canvasCommandSchema
+	}), false, false),
 	flow_live: tool("Read the current published Flow, enablement and online entries, including Webhook URLs and request fields. Draft changes do not affect this view. An unpublished Flow returns not-published with no entries.", strictObject({ flowId: flow }), true),
 	flow_list: tool("List Flows in this deployment. Continue with nextCursor; cursors are compatible with the Control API.", strictObject({
 		cursor: id.optional(),
@@ -12350,6 +12467,13 @@ var mcpTools = {
 	flow_read: tool("Read an outline, selected node details, or a bounded code/prompt excerpt. Carry the returned revision into subsequent reads and edits.", authoringReadSchema.safeExtend({ flowId: flow }).meta({ ...authoringReadSchema.meta() }), true),
 	flow_search: tool("Find nodes by name, configuration or source text in a fixed Revision. Follow nextOffset for more matches.", authoringSearchSchema.extend({ flowId: flow }), true),
 	flow_schema: tool("Read node configuration schemas and the edit grammar, or an Action contract. Action lookup requires a flowId.", authoringSchemaQuery.safeExtend({ flowId: flow.optional() }), true),
+	flow_export: tool("Export the current draft as a shareable workflow JSON file. Structured external references are cleared. Literal secrets in code, prompts or business JSON remain; review before sharing.", strictObject({ flowId: flow }), true),
+	flow_import: tool("Import workflow JSON as a new unpublished draft. External references are cleared and must be configured again. Keep identical arguments and idempotencyKey when retrying.", strictObject({
+		file: json,
+		name: id.optional(),
+		teamId: id.optional(),
+		idempotencyKey: mutationKey
+	}), false),
 	flow_create: tool("Create an empty Flow. If this deployment uses OOMOL Connector, choose a teamId from connector_teams. Keep the key and arguments stable when retrying.", strictObject({
 		name: id.refine((name) => name == name.trim() && resourceNameIssue(name) == null, "Flow name is invalid."),
 		idempotencyKey: mutationKey,

package/dist/common/openapi.js

@@ -6801,7 +6801,8 @@ var managedFields = object$1({
 		object$1({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional()
+			connectionId: text.optional(),
+			outputMode: literal("value").optional()
 		}),
 		object$1({
 			kind: literal("openapi"),
@@ -8186,10 +8187,10 @@ function compileEnumAndConst(context, enumList, constValue, schema) {
 		}
 		if (compiledEnum.length === 0) recordWarn(context, "all of elements from list is rejected by currently schema object", "enum");
 	}
-	if (constValue && valid(schema, constValue) === ValidResult.Invalid) isNever = true;
+	if (constValue !== void 0 && valid(schema, constValue) === ValidResult.Invalid) isNever = true;
 	if (compiledEnum) {
 		if (compiledEnum.length === 0) isNever = true;
-		else if (constValue) {
+		else if (constValue !== void 0) {
 			let foundEquals = false;
 			for (const enumValue of compiledEnum) if (isDeepEquals(enumValue, constValue)) {
 				foundEquals = true;
@@ -8202,7 +8203,7 @@ function compileEnumAndConst(context, enumList, constValue, schema) {
 	const compiledSchema = {};
 	if (schema.type) compiledSchema.type = schema.type;
 	if (compiledEnum) compiledSchema.enum = compiledEnum;
-	if (constValue) compiledSchema.const = wrapCompiledValue(deepCopy(constValue));
+	if (constValue !== void 0) compiledSchema.const = wrapCompiledValue(deepCopy(constValue));
 	return wrapCompiledSchema(kind, compiledSchema, context.delegate, context.path);
 }
 //#endregion
@@ -8597,7 +8598,7 @@ function compileSchema(context, schema) {
 	let targetSchema = schema;
 	let shouldHandleEnumAndConst = false;
 	const { enum: enumList, const: constValue } = schema;
-	if (enumList || constValue) {
+	if (enumList || constValue !== void 0) {
 		const { enum: _0, const: _1, ...rest } = schema;
 		targetSchema = rest;
 		shouldHandleEnumAndConst = true;
@@ -9187,7 +9188,7 @@ function schemaEqualsChecker(extendsContext) {
 	}
 	function isValueEquals(value1, value2) {
 		if (value1 === value2) return true;
-		if (value1 === null) return false;
+		if (value1 === null || value2 === null) return false;
 		if (typeof value1 !== "object") return false;
 		if (typeof value1 !== typeof value2) return false;
 		if (isCompiledSchema(value1) && isCompiledSchema(value2)) return isCompiledSchemaEquals(value1, value2);
@@ -9753,7 +9754,7 @@ function findMismatchPath(source, target) {
 			if ((sourceSchema.maxProperties ?? Number.POSITIVE_INFINITY) > (targetSchema.maxProperties ?? Number.POSITIVE_INFINITY)) return [...targetPath, "maxProperties"];
 			break;
 		}
-		case CompiledKind.EnumOrConst: return [...targetPath, targetSchema.const == null ? "enum" : "const"];
+		case CompiledKind.EnumOrConst: return [...targetPath, targetSchema.const === void 0 ? "enum" : "const"];
 	}
 	return targetPath;
 }

package/dist/common/poll-trigger.js

@@ -6808,7 +6808,8 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional()
+			connectionId: text.optional(),
+			outputMode: literal("value").optional()
 		}),
 		object({
 			kind: literal("openapi"),
@@ -8193,10 +8194,10 @@ function compileEnumAndConst(context, enumList, constValue, schema) {
 		}
 		if (compiledEnum.length === 0) recordWarn(context, "all of elements from list is rejected by currently schema object", "enum");
 	}
-	if (constValue && valid(schema, constValue) === ValidResult.Invalid) isNever = true;
+	if (constValue !== void 0 && valid(schema, constValue) === ValidResult.Invalid) isNever = true;
 	if (compiledEnum) {
 		if (compiledEnum.length === 0) isNever = true;
-		else if (constValue) {
+		else if (constValue !== void 0) {
 			let foundEquals = false;
 			for (const enumValue of compiledEnum) if (isDeepEquals(enumValue, constValue)) {
 				foundEquals = true;
@@ -8209,7 +8210,7 @@ function compileEnumAndConst(context, enumList, constValue, schema) {
 	const compiledSchema = {};
 	if (schema.type) compiledSchema.type = schema.type;
 	if (compiledEnum) compiledSchema.enum = compiledEnum;
-	if (constValue) compiledSchema.const = wrapCompiledValue(deepCopy(constValue));
+	if (constValue !== void 0) compiledSchema.const = wrapCompiledValue(deepCopy(constValue));
 	return wrapCompiledSchema(kind, compiledSchema, context.delegate, context.path);
 }
 //#endregion
@@ -8604,7 +8605,7 @@ function compileSchema(context, schema) {
 	let targetSchema = schema;
 	let shouldHandleEnumAndConst = false;
 	const { enum: enumList, const: constValue } = schema;
-	if (enumList || constValue) {
+	if (enumList || constValue !== void 0) {
 		const { enum: _0, const: _1, ...rest } = schema;
 		targetSchema = rest;
 		shouldHandleEnumAndConst = true;
@@ -9194,7 +9195,7 @@ function schemaEqualsChecker(extendsContext) {
 	}
 	function isValueEquals(value1, value2) {
 		if (value1 === value2) return true;
-		if (value1 === null) return false;
+		if (value1 === null || value2 === null) return false;
 		if (typeof value1 !== "object") return false;
 		if (typeof value1 !== typeof value2) return false;
 		if (isCompiledSchema(value1) && isCompiledSchema(value2)) return isCompiledSchemaEquals(value1, value2);
@@ -9760,7 +9761,7 @@ function findMismatchPath(source, target) {
 			if ((sourceSchema.maxProperties ?? Number.POSITIVE_INFINITY) > (targetSchema.maxProperties ?? Number.POSITIVE_INFINITY)) return [...targetPath, "maxProperties"];
 			break;
 		}
-		case CompiledKind.EnumOrConst: return [...targetPath, targetSchema.const == null ? "enum" : "const"];
+		case CompiledKind.EnumOrConst: return [...targetPath, targetSchema.const === void 0 ? "enum" : "const"];
 	}
 	return targetPath;
 }

package/dist/common/runtime-contract.js

@@ -398,7 +398,7 @@ export default () => fs.readFileSync('/etc/passwd', 'utf8')`)
 				program: program(harness, `export default async (_input, context) => ({ available: typeof context.outputs, previous: await context.getPrevious(), value: 1 })`)
 			}), {
 				available: "undefined",
-				previous: null,
+				previous: [],
 				value: 1
 			}, "Final Task outputs");
 		}

package/dist/common/scheduler.d.ts

@@ -9,6 +9,8 @@ export interface WaitResolution {
     readonly resolvedAt: string;
     readonly comment: string | null;
 }
+export declare class PortValidationError extends Error {
+}
 export type SchedulerEvent = {
     readonly flowId: string;
     readonly parentJobId?: string;
@@ -103,6 +105,24 @@ export interface WaitHost {
     readonly resolutions: (waitIds: readonly string[], block: boolean) => Effect.Effect<Readonly<Record<string, WaitResolution>>, Error>;
 }
 export declare const waitRetentionMs = 120000;
+export interface DependenciesCheckpoint {
+    nextId: number;
+    iterations: Record<string, number>;
+    nodes: Record<string, DependencyState>;
+}
+interface DependencyState {
+    id: number;
+    status: 'pending' | 'running' | 'completed' | 'skipped';
+    input: Record<string, {
+        readonly execution: number;
+        readonly outputs: Readonly<Record<string, JsonValue>>;
+    }>;
+    output?: Readonly<Record<string, JsonValue>>;
+    previous: string[];
+    released: string[];
+    jobId?: string;
+    seeded: boolean;
+}
 export interface FlowRunCheckpoint {
     readonly bindingValues: Readonly<Record<string, string>>;
     readonly inputs: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
@@ -111,7 +131,7 @@ export interface FlowRunCheckpoint {
         readonly outputs: Readonly<Record<string, JsonValue>>;
     }>>;
     readonly counts: Readonly<Record<string, Readonly<Record<string, number>>>>;
-    readonly frames: Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, JsonValue>>>>>>;
+    readonly dependencies: DependenciesCheckpoint;
     readonly version: 5;
     readonly waits: readonly PendingWait[];
     readonly agents: Readonly<Record<string, {
@@ -143,7 +163,7 @@ interface TaskInvocationBase {
 export type TaskInvocation = TaskInvocationBase & ({
     readonly capabilities: readonly ConnectorCapability[];
     readonly moduleId: string;
-    readonly getPrevious: () => PreviousNode | null;
+    readonly getPrevious: () => readonly PreviousNode[];
 } | {
     readonly kind: 'managed';
 });