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

package/dist/common/webhook-trigger.js

@@ -5924,7 +5924,8 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional()
+			connectionId: text.optional(),
+			outputMode: literal("value").optional()
 		}),
 		object({
 			kind: literal("openapi"),
@@ -7309,10 +7310,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;
@@ -7325,7 +7326,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
@@ -7720,7 +7721,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;
@@ -8310,7 +8311,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);
@@ -8876,7 +8877,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/index.d.ts

@@ -75,8 +75,8 @@ export interface TaskContext<Actions extends object = Record<string, never>> {
     readonly artifact: ArtifactCapability;
     readonly fetch: typeof fetch;
     readonly logger: TaskLogger;
-    /** Reads the node that triggered this invocation, or null for a graph root. */
-    getPrevious(): Promise<PreviousNode | null>;
+    /** Reads the selected direct predecessors, sorted by node ID; empty for a graph root. */
+    getPrevious(): Promise<readonly PreviousNode[]>;
     preview(payload: PreviewPayload, id?: string): Promise<void>;
     reportProgress(progress: number): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oomol-lab/open-flow",
-  "version": "0.1.0-beta.62",
+  "version": "0.1.0-beta.64",
   "description": "TypeScript contracts and Browser runtime for Open Flow.",
   "license": "Apache-2.0",
   "repository": {

package/skills/open-flow/SKILL.md

@@ -9,7 +9,7 @@ Use `<!-- agentic:var flowCommand -->` to operate the selected deployment.
 Consult the references relevant to the task:
 
 - [Flow capabilities and examples](references/flow-authoring.md): inspect, edit,
-  connect, validate, run and publish; online entries and Flow enable/disable;
+  connect, validate, run and publish; import/export workflow templates; online entries and Flow enable/disable;
   concurrency and Run diagnostics.
 - [n8n conversion](references/flow-n8n-conversion.md): represent collections,
   branches, provider operations and state while preserving source behavior.

package/skills/open-flow/references/flow-authoring.md

@@ -22,6 +22,26 @@ text. It builds internal definitions, ports and Module identities for you.
 `schema TYPE` supplies the current contract and a node example; `schema edit`
 supplies the edit operations. Use these when a configuration is unfamiliar.
 
+## Share a workflow template
+
+```bash
+<!-- agentic:var flowCommand --> export FLOW_ID > template.openflow.json
+<!-- agentic:var flowCommand --> import --file template.openflow.json --name "Imported workflow" --idempotency-key IMPORT_KEY --json
+```
+
+Export writes only JSON to stdout. Import also accepts `--file -` for stdin and creates
+a new unpublished Draft; it never overwrites the source Flow. Keep the same file, name,
+and idempotency key when retrying an uncertain import. MCP equivalents are `flow_export`
+with `flowId`, and `flow_import` with the JSON `file`, `idempotencyKey`, optional `name`
+and optional target `teamId`.
+
+Both operations clear structured accounts, Variables, error-source workflows and
+Trigger resource selections. Graphs, shared code Modules, fixed inputs, prompts, model
+choices and layout remain. Inspect the imported Draft, configure missing resources with
+the normal editor or authoring interface, and check it before running or publishing.
+Code, prompts and business JSON may still contain literal sensitive data. Review the
+file before sharing; cleanup does not rewrite arbitrary strings.
+
 ## Find a Flow or a relevant part
 
 ```bash
@@ -390,3 +410,32 @@ current online entries. The MCP equivalent is `flow_live({ flowId })`.
 A useful completion report identifies the Flow and Revision, what changed,
 what was actually checked or executed, and any remaining blocker. Its detail
 should match the task.
+
+## Workbench node annotations
+
+Node annotations from the Codex browser show the node title as the annotation name.
+Metadata contains `flowId`, `revisionId`, `nodeId`, and `syncState`, plus `description`
+when nonempty. The identity fields are never truncated; `revisionId` identifies the
+saved Revision. Descriptions may be shortened with an ellipsis to fit the annotation
+limits; read full content
+through the public API. The browser supplies the source page URL separately. Continue
+using the configured deployment and verify it matches the referenced Flow.
+Read the referenced node with the public read command before acting. Before editing,
+read the current Draft and use its revision checks; a captured annotation may be older
+than the current Draft. If the node no longer exists, report that instead of choosing
+another node by name.
+
+`syncState` describes the Workbench's known save state (`saved`, `dirty`, `saving`, or
+`failed`). The revision always identifies saved data; pending local changes, including
+unsaved code, are not part of that snapshot. An annotation does not save those changes
+or establish a CLI/MCP connection. Missing or invalid metadata is not sufficient to
+identify a node for editing.
+
+A multi-node annotation carries the same `flowId`, `revisionId`, and `syncState`,
+with `nodeIds` instead of `nodeId`. Parse `nodeIds` as a JSON-encoded string array
+and read every referenced node. The group contains business nodes and Triggers;
+Comment cards have no authoring node identity and are not included in this feature.
+If the complete list exceeds the annotation limits, metadata contains `nodeCount`
+and `error` instead of `nodeIds`. Ask for a smaller selection; never infer a partial
+list or treat a missing list as the whole Flow. The annotation captures the selection
+at creation time, not whichever nodes happen to be selected when the agent acts.