@executioncontrolprotocol/format-reactflow 0.12.0

package/README.md

@@ -0,0 +1,24 @@
+# `@executioncontrolprotocol/format-reactflow`
+
+Encode-only formatter that turns an `@executioncontrolprotocol.workflow` manifest into React Flow–compatible JSON (flat step nodes, projected Inputs/Outputs from `accepts`/`returns`, `$ref` data edges, and dagre layout).
+
+**Render contract (required reading):** [REACTFLOW_RENDER.md](./REACTFLOW_RENDER.md) — flat canvas, data edges only, port bindings, fan-out, and viewer run/configure expectations.
+
+Also binds lifecycle hooks that publish run progress on {@link reactFlowRunProgress} for browser viewers.
+
+```ts
+import "@executioncontrolprotocol/format-reactflow"
+import { registerFormatReactflowExtension, reactFlowRunProgress } from "@executioncontrolprotocol/format-reactflow"
+
+await registerFormatReactflowExtension()
+env.addExtensionBinding("@executioncontrolprotocol/format-reactflow", {})
+
+const encoded = await ecp
+  .encode(manifest)
+  .uses("@executioncontrolprotocol/format-reactflow")
+  .process()
+
+reactFlowRunProgress.addEventListener("step:status", (ev) => {
+  // CustomEvent detail: { stepId, status }
+})
+```

package/dist/extension.d.ts

@@ -0,0 +1,3 @@
+/** React Flow format extension (encode + run progress hooks). @category Extensions */
+export declare const formatReactflowExtension: import("@executioncontrolprotocol/core").ExtensionDefinition;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AA4EA,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,8DA0C3B,CAAA"}

package/dist/extension.js

@@ -0,0 +1,94 @@
+import { catalogExtension, capabilityFor, defineExtension, ecpEncodeInputSchema, ecpEncodeResultSchema, encodeFailure, hook, validateWorkflow, } from "@executioncontrolprotocol/core";
+import { LATEST_ECP_VERSION, } from "@executioncontrolprotocol/types";
+import { reactFlowRunProgress } from "./progress.js";
+import { workflowToReactFlow } from "./workflow-to-reactflow.js";
+function encodeToReactFlow(input, ctx) {
+    const sourceSchema = input.sourceSchema;
+    if (sourceSchema !== "@executioncontrolprotocol.workflow") {
+        return encodeFailure({
+            format: "reactflow",
+            sourceSchema,
+            diagnostics: [
+                {
+                    severity: "error",
+                    code: "FORMAT_UNSUPPORTED_SOURCE_SCHEMA",
+                    message: "React Flow encoder supports @executioncontrolprotocol.workflow only",
+                },
+            ],
+        });
+    }
+    const validation = validateWorkflow(input.source);
+    if (!validation.valid) {
+        return encodeFailure({
+            format: "reactflow",
+            sourceSchema,
+            validation,
+            diagnostics: [...validation.errors, ...validation.warnings],
+        });
+    }
+    const options = input.options;
+    const doc = workflowToReactFlow(input.source, ctx.registry, options);
+    return {
+        schema: "@executioncontrolprotocol.encode.result",
+        version: LATEST_ECP_VERSION,
+        success: true,
+        format: "reactflow",
+        mediaType: "application/vnd.reactflow+json",
+        sourceSchema,
+        sourceVersion: input.sourceVersion,
+        result: JSON.stringify(doc),
+        diagnostics: [],
+    };
+}
+function progressHook(event, handler) {
+    return hook(event, async (ctx) => {
+        handler(ctx);
+    });
+}
+/** React Flow format extension (encode + run progress hooks). @category Extensions */
+export const formatReactflowExtension = defineExtension("@executioncontrolprotocol", "format-reactflow")
+    .withCapabilities([
+    capabilityFor("@executioncontrolprotocol/format-reactflow", "encode")
+        .withInput(ecpEncodeInputSchema)
+        .withOutput(ecpEncodeResultSchema)
+        .withHandler((input, ctx) => {
+        const utilityCtx = ctx;
+        return encodeToReactFlow(input, utilityCtx);
+    }),
+])
+    .withHooks([
+    progressHook("run:before", (ctx) => {
+        reactFlowRunProgress.emitReset({ runId: ctx.run.id });
+    }),
+    progressHook("run:started", (ctx) => {
+        reactFlowRunProgress.emitReset({ runId: ctx.run.id });
+    }),
+    progressHook("step:started", (ctx) => {
+        if (ctx.step?.id)
+            reactFlowRunProgress.emitStepStatus(ctx.step.id, "running");
+    }),
+    progressHook("step:before", (ctx) => {
+        if (ctx.step?.id)
+            reactFlowRunProgress.emitStepStatus(ctx.step.id, "pending");
+    }),
+    progressHook("step:completed", (ctx) => {
+        if (ctx.step?.id)
+            reactFlowRunProgress.emitStepStatus(ctx.step.id, "completed");
+    }),
+    progressHook("step:failed", (ctx) => {
+        if (ctx.step?.id)
+            reactFlowRunProgress.emitStepStatus(ctx.step.id, "failed");
+    }),
+    progressHook("run:completed", (ctx) => {
+        reactFlowRunProgress.emitDone({ runId: ctx.run.id, outcome: "completed" });
+    }),
+    progressHook("run:failed", (ctx) => {
+        reactFlowRunProgress.emitDone({ runId: ctx.run.id, outcome: "failed" });
+    }),
+    progressHook("run:cancelled", (ctx) => {
+        reactFlowRunProgress.emitDone({ runId: ctx.run.id, outcome: "cancelled" });
+    }),
+])
+    .build();
+catalogExtension(formatReactflowExtension);
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,IAAI,EACJ,gBAAgB,GAGjB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,kBAAkB,GAInB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,SAAS,iBAAiB,CACxB,KAAqB,EACrB,GAA6B;IAE7B,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAA;IACvC,IAAI,YAAY,KAAK,oCAAoC,EAAE,CAAC;QAC1D,OAAO,aAAa,CAAC;YACnB,MAAM,EAAE,WAAW;YACnB,YAAY;YACZ,WAAW,EAAE;gBACX;oBACE,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,kCAAkC;oBACxC,OAAO,EAAE,qEAAqE;iBAC/E;aACF;SACF,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAA0B,CAAC,CAAA;IACrE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC;YACnB,MAAM,EAAE,WAAW;YACnB,YAAY;YACZ,UAAU;YACV,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC5D,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAA6C,CAAA;IACnE,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAA0B,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAExF,OAAO;QACL,MAAM,EAAE,yCAAyC;QACjD,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,gCAAgC;QAC3C,YAAY;QACZ,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QAC3B,WAAW,EAAE,EAAE;KAChB,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,KAAiC,EACjC,OAAwC;IAExC,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC/B,OAAO,CAAC,GAAG,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CACrD,2BAA2B,EAC3B,kBAAkB,CACnB;KACE,gBAAgB,CAAC;IAChB,aAAa,CAAC,4CAA4C,EAAE,QAAQ,CAAC;SAClE,SAAS,CAAC,oBAAoB,CAAC;SAC/B,UAAU,CAAC,qBAAqB,CAAC;SACjC,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,UAAU,GAAG,GAA0C,CAAA;QAC7D,OAAO,iBAAiB,CAAC,KAAuB,EAAE,UAAU,CAAC,CAAA;IAC/D,CAAC,CAAC;CACL,CAAC;KACD,SAAS,CAAC;IACT,YAAY,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;QACjC,oBAAoB,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC,CAAC;IACF,YAAY,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE;QAClC,oBAAoB,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC,CAAC;IACF,YAAY,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE;QACnC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE;YAAE,oBAAoB,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;IAC/E,CAAC,CAAC;IACF,YAAY,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE;QAClC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE;YAAE,oBAAoB,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;IAC/E,CAAC,CAAC;IACF,YAAY,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,EAAE;QACrC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE;YAAE,oBAAoB,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;IACjF,CAAC,CAAC;IACF,YAAY,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE;QAClC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE;YAAE,oBAAoB,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC9E,CAAC,CAAC;IACF,YAAY,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;QACpC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAA;IAC5E,CAAC,CAAC;IACF,YAAY,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;QACjC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;IACzE,CAAC,CAAC;IACF,YAAY,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;QACpC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAA;IAC5E,CAAC,CAAC;CACH,CAAC;KACD,KAAK,EAAE,CAAA;AAEV,gBAAgB,CAAC,wBAAwB,CAAC,CAAA"}

package/dist/extract-data-edges.d.ts

@@ -0,0 +1,17 @@
+import type { WorkflowNode } from "@executioncontrolprotocol/types";
+import type { ReactFlowEdge } from "./types.js";
+/**
+ * Parse `state.<asKey>[.<rest>]` into as-key and optional nested path for handles.
+ * @category Encoding
+ */
+export declare function parseStateRef(refPath: string): {
+    asKey: string;
+    fieldPath: string;
+} | undefined;
+/**
+ * Extract data edges from step `.with()` `$ref` values.
+ * `acceptsKeys` maps `state.<key>` refs to the projected Inputs node.
+ * @category Encoding
+ */
+export declare function extractDataEdges(nodes: WorkflowNode[], acceptsKeys?: ReadonlySet<string>): ReactFlowEdge[];
+//# sourceMappingURL=extract-data-edges.d.ts.map

package/dist/extract-data-edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-data-edges.d.ts","sourceRoot":"","sources":["../src/extract-data-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAEzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAiC/C;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAQlD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EAAE,EACrB,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,aAAa,EAAE,CA4CjB"}

package/dist/extract-data-edges.js

@@ -0,0 +1,95 @@
+import { WORKFLOW_ACCEPTS_NODE_ID } from "./io-from-schema.js";
+function isStepNode(node) {
+    return !node.type || node.type === "step";
+}
+function collectSteps(nodes, out) {
+    for (const node of nodes) {
+        if (isStepNode(node)) {
+            out.push(node);
+            continue;
+        }
+        if (node.type === "parallel") {
+            for (const branch of node.branches)
+                collectSteps(branch, out);
+            continue;
+        }
+        if (node.type === "branch") {
+            for (const arm of node.branches)
+                collectSteps(arm.steps, out);
+            continue;
+        }
+        collectSteps(node.steps, out);
+    }
+}
+function isRefValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "$ref" in value &&
+        typeof value.$ref === "string");
+}
+/**
+ * Parse `state.<asKey>[.<rest>]` into as-key and optional nested path for handles.
+ * @category Encoding
+ */
+export function parseStateRef(refPath) {
+    const normalized = refPath.startsWith("state.") ? refPath.slice("state.".length) : refPath;
+    if (!normalized)
+        return undefined;
+    const parts = normalized.split(".");
+    const asKey = parts[0];
+    if (!asKey)
+        return undefined;
+    const fieldPath = parts.slice(1).join(".");
+    return { asKey, fieldPath };
+}
+/**
+ * Extract data edges from step `.with()` `$ref` values.
+ * `acceptsKeys` maps `state.<key>` refs to the projected Inputs node.
+ * @category Encoding
+ */
+export function extractDataEdges(nodes, acceptsKeys) {
+    const steps = [];
+    collectSteps(nodes, steps);
+    const asToStepId = new Map();
+    for (const step of steps) {
+        if (step.as)
+            asToStepId.set(step.as, step.id);
+    }
+    if (acceptsKeys) {
+        for (const key of acceptsKeys) {
+            if (!asToStepId.has(key))
+                asToStepId.set(key, WORKFLOW_ACCEPTS_NODE_ID);
+        }
+    }
+    const edges = [];
+    let edgeIndex = 0;
+    for (const step of steps) {
+        if (!step.input)
+            continue;
+        for (const [paramName, value] of Object.entries(step.input)) {
+            if (!isRefValue(value))
+                continue;
+            const parsed = parseStateRef(value.$ref);
+            if (!parsed)
+                continue;
+            const sourceStepId = asToStepId.get(parsed.asKey);
+            if (!sourceStepId)
+                continue;
+            const sourceHandle = sourceStepId === WORKFLOW_ACCEPTS_NODE_ID
+                ? parsed.asKey
+                : parsed.fieldPath
+                    ? parsed.fieldPath.split(".")[0]
+                    : "output";
+            edges.push({
+                id: `data-${edgeIndex++}-${sourceStepId}-${step.id}-${paramName}`,
+                source: sourceStepId,
+                target: step.id,
+                sourceHandle,
+                targetHandle: paramName,
+                data: { kind: "data" },
+            });
+        }
+    }
+    return edges;
+}
+//# sourceMappingURL=extract-data-edges.js.map

package/dist/extract-data-edges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-data-edges.js","sourceRoot":"","sources":["../src/extract-data-edges.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type Registry } from "@executioncontrolprotocol/core";
+export { formatReactflowExtension } from "./extension.js";
+export { workflowToReactFlow } from "./workflow-to-reactflow.js";
+export { extractDataEdges, parseStateRef } from "./extract-data-edges.js";
+export { acceptsReactFlowNode, returnsReactFlowNode, portsFromJsonSchemaObject, jsonSchemaObjectProperties, WORKFLOW_ACCEPTS_NODE_ID, WORKFLOW_RETURNS_NODE_ID, } from "./io-from-schema.js";
+export { portsForStep, formatLiteralValue, truncateLiteralPreview, ensureOutputPort } from "./ports-from-zod.js";
+export { valueSchemaFromZod, valueSchemaFromEqlLabel, valueSchemaFromJsonSchemaProp, valueSchemasFromCapabilitySchema, unwrapZodType, type ValueSchemaHint, } from "./value-schema-hint.js";
+export { layoutReactFlowDocument } from "./layout.js";
+export { reactFlowRunProgress, ReactFlowRunProgress, type ReactFlowProgressEventName, } from "./progress.js";
+export type { ReactFlowDocument, ReactFlowEdge, ReactFlowEdgeKind, ReactFlowEncodeOptions, ReactFlowGroupData, ReactFlowIoData, ReactFlowIoKind, ReactFlowNode, ReactFlowPort, ReactFlowPortBinding, ReactFlowRunLifecycleDetail, ReactFlowStepData, ReactFlowStepStatus, ReactFlowStepStatusDetail, } from "./types.js";
+/** Register React Flow format extension. @category Extensions */
+export declare function registerFormatReactflowExtension(registry?: Registry): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAG9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAChH,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,gCAAgC,EAChC,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AAEnB,iEAAiE;AACjE,wBAAsB,gCAAgC,CACpD,QAAQ,GAAE,QAAyB,GAClC,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { globalRegistry } from "@executioncontrolprotocol/core";
+import { formatReactflowExtension } from "./extension.js";
+export { formatReactflowExtension } from "./extension.js";
+export { workflowToReactFlow } from "./workflow-to-reactflow.js";
+export { extractDataEdges, parseStateRef } from "./extract-data-edges.js";
+export { acceptsReactFlowNode, returnsReactFlowNode, portsFromJsonSchemaObject, jsonSchemaObjectProperties, WORKFLOW_ACCEPTS_NODE_ID, WORKFLOW_RETURNS_NODE_ID, } from "./io-from-schema.js";
+export { portsForStep, formatLiteralValue, truncateLiteralPreview, ensureOutputPort } from "./ports-from-zod.js";
+export { valueSchemaFromZod, valueSchemaFromEqlLabel, valueSchemaFromJsonSchemaProp, valueSchemasFromCapabilitySchema, unwrapZodType, } from "./value-schema-hint.js";
+export { layoutReactFlowDocument } from "./layout.js";
+export { reactFlowRunProgress, ReactFlowRunProgress, } from "./progress.js";
+/** Register React Flow format extension. @category Extensions */
+export async function registerFormatReactflowExtension(registry = globalRegistry) {
+    if (!registry.getExtension("@executioncontrolprotocol/format-reactflow")) {
+        await registry.registerExtension(formatReactflowExtension);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAChH,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,gCAAgC,EAChC,aAAa,GAEd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,eAAe,CAAA;AAkBtB,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,WAAqB,cAAc;IAEnC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,4CAA4C,CAAC,EAAE,CAAC;QACzE,MAAM,QAAQ,CAAC,iBAAiB,CAAC,wBAAwB,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC"}

package/dist/io-from-schema.d.ts

@@ -0,0 +1,36 @@
+import type { WorkflowManifest } from "@executioncontrolprotocol/types";
+import type { ReactFlowNode, ReactFlowPort } from "./types.js";
+/** Synthetic React Flow node id for `workflow.accepts`. @category Encoding */
+export declare const WORKFLOW_ACCEPTS_NODE_ID = "ecp:accepts";
+/** Synthetic React Flow node id for `workflow.returns`. @category Encoding */
+export declare const WORKFLOW_RETURNS_NODE_ID = "ecp:returns";
+/**
+ * List object-schema properties for workflow `accepts` / `returns`.
+ * @category Encoding
+ */
+export declare function jsonSchemaObjectProperties(schema: Record<string, unknown> | undefined): Array<{
+    name: string;
+    schema: Record<string, unknown>;
+    required: boolean;
+}>;
+/**
+ * Ports from a JSON Schema object (`accepts` / `returns` properties).
+ * @category Encoding
+ */
+export declare function portsFromJsonSchemaObject(schema: Record<string, unknown> | undefined): ReactFlowPort[];
+/**
+ * Project workflow `accepts` as an output-only Inputs node (always present).
+ * @category Encoding
+ */
+export declare function acceptsReactFlowNode(manifest: WorkflowManifest): ReactFlowNode;
+/**
+ * State keys that can source a `returns` port (step `.as` or `accepts` properties).
+ * @category Encoding
+ */
+export declare function returnsSourceKeys(manifest: WorkflowManifest): Set<string>;
+/**
+ * Project workflow `returns` as an input-only Outputs node when it has properties.
+ * @category Encoding
+ */
+export declare function returnsReactFlowNode(manifest: WorkflowManifest): ReactFlowNode | undefined;
+//# sourceMappingURL=io-from-schema.d.ts.map

package/dist/io-from-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-from-schema.d.ts","sourceRoot":"","sources":["../src/io-from-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,gBAAgB,EAAgB,MAAM,iCAAiC,CAAA;AAC/F,OAAO,KAAK,EAAmB,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/E,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,gBAAgB,CAAA;AAErD,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,gBAAgB,CAAA;AAMrD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAkB7E;AAQD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,aAAa,EAAE,CAYjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa,CAc9E;AAwBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,CAAC,CAMzE;AAWD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAgB1F"}

package/dist/io-from-schema.js

@@ -0,0 +1,136 @@
+import { valueSchemaFromEqlLabel, valueSchemaFromJsonSchemaProp } from "./value-schema-hint.js";
+/** Synthetic React Flow node id for `workflow.accepts`. @category Encoding */
+export const WORKFLOW_ACCEPTS_NODE_ID = "ecp:accepts";
+/** Synthetic React Flow node id for `workflow.returns`. @category Encoding */
+export const WORKFLOW_RETURNS_NODE_ID = "ecp:returns";
+function isJsonSchemaObject(schema) {
+    return schema !== null && typeof schema === "object" && !Array.isArray(schema);
+}
+/**
+ * List object-schema properties for workflow `accepts` / `returns`.
+ * @category Encoding
+ */
+export function jsonSchemaObjectProperties(schema) {
+    if (!schema)
+        return [];
+    const props = schema.properties;
+    if (!isJsonSchemaObject(props))
+        return [];
+    const required = new Set(Array.isArray(schema.required)
+        ? schema.required.filter((k) => typeof k === "string")
+        : []);
+    const out = [];
+    for (const [name, prop] of Object.entries(props)) {
+        out.push({
+            name,
+            schema: isJsonSchemaObject(prop) ? prop : {},
+            required: required.has(name),
+        });
+    }
+    return out;
+}
+function typeLabelFromSchema(schema, required) {
+    const t = schema.type;
+    const base = typeof t === "string" ? t : "unknown";
+    return required ? `${base}!` : base;
+}
+/**
+ * Ports from a JSON Schema object (`accepts` / `returns` properties).
+ * @category Encoding
+ */
+export function portsFromJsonSchemaObject(schema) {
+    return jsonSchemaObjectProperties(schema).map((field) => {
+        const typeLabel = typeLabelFromSchema(field.schema, field.required);
+        const port = {
+            id: field.name,
+            name: field.name,
+            typeLabel,
+            required: field.required,
+            valueSchema: valueSchemaFromJsonSchemaProp(field.schema) ?? valueSchemaFromEqlLabel(typeLabel),
+        };
+        return port;
+    });
+}
+/**
+ * Project workflow `accepts` as an output-only Inputs node (always present).
+ * @category Encoding
+ */
+export function acceptsReactFlowNode(manifest) {
+    const outputs = portsFromJsonSchemaObject(manifest.workflow.accepts);
+    const data = {
+        label: "Inputs",
+        kind: "accepts",
+        inputs: [],
+        outputs,
+    };
+    return {
+        id: WORKFLOW_ACCEPTS_NODE_ID,
+        type: "ecp-io",
+        position: { x: 0, y: 0 },
+        data,
+    };
+}
+function isStepNode(node) {
+    return !node.type || node.type === "step";
+}
+function collectCommitKeys(nodes, into) {
+    for (const node of nodes) {
+        if (isStepNode(node)) {
+            if (node.as)
+                into.add(node.as);
+            continue;
+        }
+        if (node.type === "parallel") {
+            for (const branch of node.branches)
+                collectCommitKeys(branch, into);
+            continue;
+        }
+        if (node.type === "branch") {
+            for (const arm of node.branches)
+                collectCommitKeys(arm.steps, into);
+            continue;
+        }
+        collectCommitKeys(node.steps, into);
+    }
+}
+/**
+ * State keys that can source a `returns` port (step `.as` or `accepts` properties).
+ * @category Encoding
+ */
+export function returnsSourceKeys(manifest) {
+    const keys = new Set(jsonSchemaObjectProperties(manifest.workflow.accepts).map((field) => field.name));
+    collectCommitKeys(manifest.steps, keys);
+    return keys;
+}
+function annotateReturnsPorts(manifest, ports) {
+    const sources = returnsSourceKeys(manifest);
+    for (const port of ports) {
+        if (!sources.has(port.id))
+            continue;
+        port.binding = "ref";
+        port.refPath = port.id;
+    }
+}
+/**
+ * Project workflow `returns` as an input-only Outputs node when it has properties.
+ * @category Encoding
+ */
+export function returnsReactFlowNode(manifest) {
+    const inputs = portsFromJsonSchemaObject(manifest.workflow.returns);
+    if (inputs.length === 0)
+        return undefined;
+    annotateReturnsPorts(manifest, inputs);
+    const data = {
+        label: "Outputs",
+        kind: "returns",
+        inputs,
+        outputs: [],
+    };
+    return {
+        id: WORKFLOW_RETURNS_NODE_ID,
+        type: "ecp-io",
+        position: { x: 0, y: 0 },
+        data,
+    };
+}
+//# sourceMappingURL=io-from-schema.js.map

package/dist/io-from-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-from-schema.js","sourceRoot":"","sources":["../src/io-from-schema.ts"],"names":[],"mappings":"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"}

package/dist/layout.d.ts

@@ -0,0 +1,7 @@
+import type { ReactFlowDocument, ReactFlowEncodeOptions } from "./types.js";
+/**
+ * Assign dagre layout positions to nodes (mutates a copy).
+ * @category Encoding
+ */
+export declare function layoutReactFlowDocument(doc: ReactFlowDocument, options?: ReactFlowEncodeOptions): ReactFlowDocument;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EAIvB,MAAM,YAAY,CAAA;AAqBnB;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,iBAAiB,CAmDnB"}

package/dist/layout.js

@@ -0,0 +1,67 @@
+import dagre from "@dagrejs/dagre";
+const DEFAULT_NODE_WIDTH = 260;
+const DEFAULT_NODE_HEIGHT = 160;
+const PORT_ROW_ESTIMATE = 18;
+const HEADER_ESTIMATE = 72;
+function estimateNodeHeight(node, fallback) {
+    if (node.type === "ecp-step") {
+        const data = node.data;
+        const portRows = Math.max(data.inputs.length, 1) + Math.max(data.outputs.length, 1);
+        return Math.max(fallback, HEADER_ESTIMATE + portRows * PORT_ROW_ESTIMATE);
+    }
+    if (node.type === "ecp-io") {
+        const data = node.data;
+        const portRows = Math.max(data.inputs.length + data.outputs.length, 1);
+        return Math.max(fallback, HEADER_ESTIMATE + portRows * PORT_ROW_ESTIMATE);
+    }
+    return fallback;
+}
+/**
+ * Assign dagre layout positions to nodes (mutates a copy).
+ * @category Encoding
+ */
+export function layoutReactFlowDocument(doc, options) {
+    const direction = options?.direction ?? "LR";
+    const nodeWidth = options?.nodeWidth ?? DEFAULT_NODE_WIDTH;
+    const nodeHeight = options?.nodeHeight ?? DEFAULT_NODE_HEIGHT;
+    const g = new dagre.graphlib.Graph();
+    g.setDefaultEdgeLabel(() => ({}));
+    g.setGraph({
+        rankdir: direction,
+        nodesep: 56,
+        ranksep: 96,
+        marginx: 24,
+        marginy: 24,
+    });
+    const byId = new Map(doc.nodes.map((n) => [n.id, n]));
+    const heights = new Map(doc.nodes.map((node) => [node.id, estimateNodeHeight(node, nodeHeight)]));
+    for (const node of doc.nodes) {
+        g.setNode(node.id, { width: nodeWidth, height: heights.get(node.id) ?? nodeHeight });
+    }
+    for (const edge of doc.edges) {
+        if (byId.has(edge.source) && byId.has(edge.target)) {
+            g.setEdge(edge.source, edge.target);
+        }
+    }
+    dagre.layout(g);
+    const nodes = doc.nodes.map((node) => {
+        const laid = g.node(node.id);
+        const height = heights.get(node.id) ?? nodeHeight;
+        if (!laid)
+            return { ...node, position: { ...node.position } };
+        return {
+            ...node,
+            position: {
+                x: laid.x - nodeWidth / 2,
+                y: laid.y - height / 2,
+            },
+            // Width only — height comes from content (top inputs / bottom outputs).
+            style: {
+                ...node.style,
+                width: nodeWidth,
+            },
+        };
+    });
+    return { nodes, edges: doc.edges.map((e) => ({ ...e })) };
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"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"}

package/dist/ports-from-zod.d.ts

@@ -0,0 +1,28 @@
+import type { Registry } from "@executioncontrolprotocol/core";
+import type { StepNode } from "@executioncontrolprotocol/types";
+import type { ReactFlowPort } from "./types.js";
+/**
+ * Compact string form of a literal input value (for previews / editors).
+ * @category Encoding
+ */
+export declare function formatLiteralValue(value: unknown): string;
+/**
+ * Truncate a literal for port row display.
+ * @category Encoding
+ */
+export declare function truncateLiteralPreview(full: string, max?: number): string;
+/**
+ * Ensure an output port exists for a data-edge source handle.
+ * @category Encoding
+ */
+export declare function ensureOutputPort(outputs: ReactFlowPort[], handleId: string): void;
+/**
+ * Build input/output ports from capability Zod schemas, with input-key fallback
+ * and literal / `$ref` binding metadata from `step.input`.
+ * @category Encoding
+ */
+export declare function portsForStep(step: StepNode, registry: Registry | undefined): {
+    inputs: ReactFlowPort[];
+    outputs: ReactFlowPort[];
+};
+//# sourceMappingURL=ports-from-zod.d.ts.map

package/dist/ports-from-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-from-zod.d.ts","sourceRoot":"","sources":["../src/ports-from-zod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAE9D,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AA0C/C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAsB,GAAG,MAAM,CAGtF;AAmCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOjF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CA4EvD"}