@oomol-lab/open-flow 0.1.0-beta.61 → 0.1.0-beta.63

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.61",
+  "version": "0.1.0-beta.63",
   "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; published resources, 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.
@@ -29,5 +29,8 @@ Server; do not duplicate them in the CLI.
 <!-- agentic:endif -->
 
 Keep the requested boundary: editing a Draft does not authorize a Run,
-publication, or enabling automatic execution. Report the resulting Flow and
-Revision, verification result, and any unresolved configuration.
+publication, or enabling automatic execution. Inspecting an entry does not
+by itself authorize invoking it. For edits, report the Flow and Revision,
+verification result, and unresolved configuration. For a publication, report
+the Publication and available online entries. For a query, report the observed
+online state.

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

@@ -22,12 +22,33 @@ 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
 <!-- agentic:var flowCommand --> list --json
 <!-- agentic:var flowCommand --> create "Order summary" --json
 <!-- agentic:var flowCommand --> show FLOW_ID --json
+<!-- agentic:var flowCommand --> live FLOW_ID --json
 <!-- agentic:var flowCommand --> read FLOW_ID --json
 <!-- agentic:var flowCommand --> search FLOW_ID --input '{"query":"Customer summary","type":"agent"}' --json
 <!-- agentic:var flowCommand --> read FLOW_ID --input '{"revision":"REVISION","nodes":["NODE"]}' --json
@@ -35,7 +56,10 @@ supplies the edit operations. Use these when a configuration is unfamiliar.
 ```
 
 A known Flow ID avoids a list lookup. `show` gives lifecycle and publication
-state. `read` gives a graph outline, selected node details, or a text excerpt;
+state. `live` gives the current published version, enablement, and online entries,
+including Webhook URLs and request fields. `resourceReferences.draft` in Flow
+metadata describes Draft dependencies, not online resources. `read` defaults to
+the Draft and gives a graph outline, selected node details, or a text excerpt;
 `nodes` and `text` are alternative modes. `search` finds matches in names,
 configuration and source text, optionally restricted by node type.
 
@@ -342,33 +366,27 @@ Use the observed Live publication ID for `--expected-publication`; if it changed
 read the current state before deciding whether to apply the switch to that version.
 The MCP equivalent is `flow_set_enabled({ flowId, expectedPublicationId, enabled })`.
 
+Successful `publish` includes the same `live` details as `live FLOW_ID --json`;
+use that result without immediately querying again. Query `live` after waiting
+for an asynchronous publication, when details are missing, or when current state
+is needed later. An unpublished Flow returns `status: not-published` with no entries.
+
+For an authorized Webhook call, use the entry's `binding.endpointUrl`,
+`config.method`, and `config.body` field contracts. These retain schema,
+nullable and default semantics; methods without a request body have no body
+fields. Do not reconstruct URLs from node IDs. Flow `enabled` and `status` are
+independent of a binding's `health` and `listener`; a healthy
+subscription alone does not establish that automatic execution is enabled.
+Shared event source and account references can be inspected through their own
+commands when relevant.
+
 `workbench` returns a URL; `open` opens the system browser. Browser authentication
 belongs to the host. An open Workbench receives Revision notifications, so a CLI
 edit does not require a page reload.
 
-### Inspect published resources
-
-```bash
-<!-- agentic:var flowCommand --> resources FLOW_ID --json
-<!-- agentic:var flowCommand --> resources FLOW_ID RESOURCE_ID --json
-<!-- agentic:var flowCommand --> publications list FLOW_ID --json
-<!-- agentic:var flowCommand --> resources FLOW_ID --publication PUBLICATION_ID --json
-```
-
-`resources` defaults to the current Live publication and returns its managed
-Trigger resources, runtime health and Webhook URLs. The response's `enabled`
-describes the Flow switch; healthy resources can belong to a disabled Flow.
-Use a returned `resourceId` for detail, and pin `publicationId` when subsequent
-reads must refer to the same publication. Configuration comes from the fixed
-published Revision, so unpublished Draft edits do not appear here.
-
-Historical results contain configuration only, without runtime state, `enabled`
-or callable URLs. Querying history does not reactivate it; restoring a historical
-version requires an authorized rollback. Manual entry nodes are read through
-`read` and are not managed resources. `trigger search` and `trigger show` discover
-provider Trigger definitions; use `resources` to inspect a Flow's published Triggers.
-MCP equivalents are `flow_resources({ flowId, publicationId? })` and
-`flow_resource_get({ flowId, resourceId, publicationId? })`.
+`live` includes Manual entry nodes without a runtime binding. `trigger search`
+and `trigger show` discover provider definitions; `live` inspects the Flow's
+current online entries. The MCP equivalent is `flow_live({ flowId })`.
 
 ## Recover without losing another change or repeating an effect
 
@@ -380,6 +398,12 @@ MCP equivalents are `flow_resources({ flowId, publicationId? })` and
   resolve that uncertainty; a new key describes a new mutation.
 - **Saved with diagnostics:** the edit happened. Repair the saved Revision or
   investigate unavailable validation; resubmitting it is not a validation step.
+- **Published with detail warnings:** a succeeded `operation` confirms the
+  publication even if metadata or online details could not be read. Query `live`
+  rather than publishing again to retrieve an address. A pending operation still
+  requires observing that same operation. If `live.publication.publicationId`
+  differs from the successful operation's `publicationId`, the entries describe
+  the current Live version, not the earlier publication.
 - **Failed Run:** events and results identify the failing node and available
   inputs. Consider already-completed external effects before running it again.
 

package/dist/common/publicationResources.d.ts

@@ -1,29 +0,0 @@
-import type { JsonValue, RevisionContent } from '../browser/flow-change.js';
-import type { TriggerBinding } from './control-api.js';
-export interface PublicationResource {
-    readonly resourceId: string;
-    readonly kind: 'trigger';
-    readonly type: TriggerBinding['kind'];
-    readonly name: string;
-    readonly description?: string;
-    readonly config: JsonValue;
-    readonly inputs: JsonValue;
-    readonly runtime?: TriggerBinding;
-}
-export interface PublicationResourceContext {
-    readonly flowId: string;
-    readonly publicationId: string;
-    readonly revisionId: string;
-    readonly status: 'live' | 'historical';
-    readonly enabled?: boolean;
-    readonly version: 1;
-}
-export interface PublicationResources extends PublicationResourceContext {
-    readonly resources: readonly PublicationResource[];
-}
-export interface PublicationResourceDetail extends PublicationResourceContext {
-    readonly resource: PublicationResource;
-}
-export declare function publicationResources(content: RevisionContent): readonly PublicationResource[];
-export declare function decodePublicationResources(value: unknown): PublicationResources;
-export declare function decodePublicationResource(value: unknown): PublicationResourceDetail;