@duckflux/runner 0.7.0 → 0.7.1

package/dist/main.js

@@ -126,7 +126,7 @@ async function createHub(config) {
 var init_eventhub = () => {};
 
 // src/main.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync } from "fs";
 import { parseArgs } from "util";
 import { dirname as dirname5, resolve as resolve5 } from "path";
 
@@ -136,7 +136,6 @@ import { dirname as dirname2 } from "node:path";
 // ../core/dist/index.js
 import { createRequire as createRequire2 } from "node:module";
 import { readFile } from "node:fs/promises";
-import { readFileSync } from "node:fs";
 import { constants } from "node:fs";
 import { access } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -25799,6 +25798,549 @@ var require_dist2 = __commonJS((exports, module) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.default = formatsPlugin;
 });
+var duckflux_schema_default;
+var init_duckflux_schema = __esm2(() => {
+  duckflux_schema_default = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://raw.githubusercontent.com/duckflux/spec/main/duckflux.schema.json",
+    title: "duckflux Workflow",
+    description: "Schema for duckflux — a minimal, deterministic, runtime-agnostic workflow DSL.",
+    type: "object",
+    required: ["flow"],
+    additionalProperties: false,
+    properties: {
+      id: {
+        type: "string",
+        description: "Unique identifier for the workflow."
+      },
+      name: {
+        type: "string",
+        description: "Human-readable workflow name."
+      },
+      version: {
+        description: "Version identifier for the workflow definition.",
+        oneOf: [
+          { type: "string" },
+          { type: "integer" }
+        ]
+      },
+      defaults: {
+        $ref: "#/$defs/defaults"
+      },
+      inputs: {
+        $ref: "#/$defs/inputs"
+      },
+      participants: {
+        type: "object",
+        description: "Named steps that can be referenced in the flow.",
+        additionalProperties: {
+          $ref: "#/$defs/participant"
+        },
+        not: {
+          anyOf: [
+            { required: ["workflow"] },
+            { required: ["execution"] },
+            { required: ["input"] },
+            { required: ["output"] },
+            { required: ["env"] },
+            { required: ["loop"] },
+            { required: ["event"] }
+          ]
+        }
+      },
+      flow: {
+        $ref: "#/$defs/flowSequence"
+      },
+      output: {
+        $ref: "#/$defs/workflowOutput"
+      }
+    },
+    $defs: {
+      duration: {
+        type: "string",
+        pattern: "^[0-9]+(ms|s|m|h|d)$",
+        description: "Duration string, e.g. '30s', '5m', '2h', '1d'."
+      },
+      celExpression: {
+        type: "string",
+        description: "A Google CEL expression."
+      },
+      defaults: {
+        type: "object",
+        description: "Global defaults applied to all participants.",
+        additionalProperties: false,
+        properties: {
+          timeout: {
+            $ref: "#/$defs/duration"
+          },
+          cwd: {
+            type: "string",
+            description: "Default working directory for exec participants. Supports CEL expressions."
+          }
+        }
+      },
+      inputs: {
+        type: "object",
+        description: "Workflow input parameters. Accessed in CEL as workflow.inputs.<field>. Each key is a parameter name. Value can be null (string, no schema), or a JSON Schema object for validation.",
+        additionalProperties: {
+          oneOf: [
+            { type: "null" },
+            { $ref: "#/$defs/inputField" }
+          ]
+        }
+      },
+      inputField: {
+        type: "object",
+        description: "JSON Schema field definition with optional 'required: true' shortcut.",
+        properties: {
+          type: {
+            type: "string",
+            enum: ["string", "integer", "number", "boolean", "array", "object"]
+          },
+          description: { type: "string" },
+          default: {},
+          required: { type: "boolean" },
+          format: { type: "string" },
+          enum: { type: "array" },
+          minimum: { type: "number" },
+          maximum: { type: "number" },
+          minLength: { type: "integer" },
+          maxLength: { type: "integer" },
+          pattern: { type: "string" },
+          items: {
+            $ref: "#/$defs/inputField"
+          }
+        },
+        additionalProperties: false
+      },
+      retryConfig: {
+        type: "object",
+        description: "Retry configuration. Only applies when onError is 'retry'.",
+        additionalProperties: false,
+        required: ["max"],
+        properties: {
+          max: {
+            type: "integer",
+            minimum: 1,
+            description: "Maximum number of retry attempts."
+          },
+          backoff: {
+            $ref: "#/$defs/duration",
+            description: "Interval between attempts. Default: 0s."
+          },
+          factor: {
+            type: "number",
+            minimum: 1,
+            description: "Backoff multiplier. Default: 1 (no escalation)."
+          }
+        }
+      },
+      onError: {
+        type: "string",
+        description: "Error handling strategy: 'fail' (default), 'skip', 'retry', or a participant name for redirect.",
+        minLength: 1
+      },
+      onTimeout: {
+        type: "string",
+        description: "Timeout handling strategy: 'fail' (default), 'skip', or a participant name for redirect.",
+        minLength: 1
+      },
+      participantInput: {
+        description: "Explicit input mapping. String for direct passthrough, object for structured mapping. Values are CEL expressions. Merged with implicit I/O chain input at runtime.",
+        oneOf: [
+          { type: "string" },
+          {
+            type: "object",
+            additionalProperties: {
+              type: "string"
+            }
+          }
+        ]
+      },
+      participantOutputSchema: {
+        type: "object",
+        description: "Output schema (JSON Schema fields). Opt-in validation.",
+        additionalProperties: {
+          $ref: "#/$defs/inputField"
+        }
+      },
+      payload: {
+        description: "Event payload. String (CEL expression) or object with CEL expressions as values.",
+        oneOf: [
+          { type: "string" },
+          {
+            type: "object",
+            additionalProperties: {}
+          }
+        ]
+      },
+      participant: {
+        type: "object",
+        required: ["type"],
+        description: "A named, reusable building block of the workflow.",
+        properties: {
+          type: {
+            type: "string",
+            enum: ["exec", "http", "mcp", "workflow", "emit"],
+            description: "Participant type."
+          },
+          as: {
+            type: "string",
+            description: "Human-readable display name."
+          },
+          timeout: {
+            $ref: "#/$defs/duration"
+          },
+          onError: {
+            $ref: "#/$defs/onError"
+          },
+          retry: {
+            $ref: "#/$defs/retryConfig"
+          },
+          input: {
+            $ref: "#/$defs/participantInput"
+          },
+          output: {
+            $ref: "#/$defs/participantOutputSchema"
+          },
+          run: {
+            type: "string",
+            description: "[exec] Shell command to execute."
+          },
+          cwd: {
+            type: "string",
+            description: "[exec] Working directory. Supports CEL expressions."
+          },
+          url: {
+            type: "string",
+            description: "[http] Target URL. Supports CEL expressions."
+          },
+          method: {
+            type: "string",
+            enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
+            description: "[http] HTTP method."
+          },
+          headers: {
+            type: "object",
+            additionalProperties: { type: "string" },
+            description: "[http] HTTP headers. Values support CEL expressions."
+          },
+          body: {
+            description: "[http] Request body. String or object. Supports CEL expressions.",
+            oneOf: [
+              { type: "string" },
+              { type: "object" }
+            ]
+          },
+          path: {
+            type: "string",
+            description: "[workflow] Path to the sub-workflow YAML file."
+          },
+          server: {
+            type: "string",
+            description: "[mcp] MCP server identifier."
+          },
+          tool: {
+            type: "string",
+            description: "[mcp] MCP tool name to invoke."
+          },
+          event: {
+            type: "string",
+            description: "[emit] Event name to emit."
+          },
+          payload: {
+            $ref: "#/$defs/payload",
+            description: "[emit] Event payload. CEL expression or object with CEL expressions."
+          },
+          ack: {
+            type: "boolean",
+            description: "[emit] If true, wait for delivery acknowledgment. Default: false.",
+            default: false
+          }
+        },
+        additionalProperties: false
+      },
+      inlineParticipant: {
+        type: "object",
+        required: ["type"],
+        description: "An inline participant definition in the flow. 'as' is optional — if omitted, the participant is anonymous and its output is only accessible via the implicit I/O chain.",
+        properties: {
+          as: {
+            type: "string",
+            description: "Optional name for inline participants. If provided, must be unique across all participant names. Enables output reference by name."
+          },
+          type: {
+            type: "string",
+            enum: ["exec", "http", "mcp", "workflow", "emit"],
+            description: "Participant type."
+          },
+          when: {
+            $ref: "#/$defs/celExpression",
+            description: "Guard condition. If false, step is skipped."
+          },
+          timeout: {
+            $ref: "#/$defs/duration"
+          },
+          onError: {
+            $ref: "#/$defs/onError"
+          },
+          retry: {
+            $ref: "#/$defs/retryConfig"
+          },
+          input: {
+            $ref: "#/$defs/participantInput"
+          },
+          output: {
+            $ref: "#/$defs/participantOutputSchema"
+          },
+          run: { type: "string" },
+          cwd: { type: "string" },
+          url: { type: "string" },
+          method: { type: "string", enum: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+          headers: { type: "object", additionalProperties: { type: "string" } },
+          body: { oneOf: [{ type: "string" }, { type: "object" }] },
+          path: { type: "string" },
+          server: { type: "string" },
+          tool: { type: "string" },
+          event: { type: "string" },
+          payload: { $ref: "#/$defs/payload" },
+          ack: { type: "boolean" }
+        },
+        additionalProperties: false
+      },
+      flowSequence: {
+        type: "array",
+        description: "Ordered list of flow steps. Each step's output is implicitly chained as input to the next step.",
+        minItems: 1,
+        items: {
+          $ref: "#/$defs/flowStep"
+        }
+      },
+      flowStep: {
+        description: "A single step in the flow: participant reference (string), control construct, inline participant (named or anonymous), or participant override.",
+        oneOf: [
+          {
+            type: "string",
+            description: "Simple participant reference by name."
+          },
+          { $ref: "#/$defs/loopStep" },
+          { $ref: "#/$defs/parallelStep" },
+          { $ref: "#/$defs/ifStep" },
+          { $ref: "#/$defs/setStep" },
+          { $ref: "#/$defs/waitStep" },
+          { $ref: "#/$defs/inlineParticipant" },
+          { $ref: "#/$defs/participantOverrideStep" }
+        ]
+      },
+      loopStep: {
+        type: "object",
+        required: ["loop"],
+        additionalProperties: false,
+        properties: {
+          loop: {
+            type: "object",
+            additionalProperties: false,
+            required: ["steps"],
+            properties: {
+              as: {
+                type: "string",
+                description: "Renames the loop context variable. Access as <as>.index, <as>.iteration, etc. instead of loop.*"
+              },
+              until: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL condition to break out of the loop."
+              },
+              max: {
+                description: "Maximum iterations. Integer or CEL expression.",
+                oneOf: [
+                  { type: "integer", minimum: 1 },
+                  { type: "string" }
+                ]
+              },
+              steps: {
+                $ref: "#/$defs/flowSequence"
+              }
+            },
+            anyOf: [
+              { required: ["until"] },
+              { required: ["max"] }
+            ]
+          }
+        }
+      },
+      parallelStep: {
+        type: "object",
+        required: ["parallel"],
+        additionalProperties: false,
+        properties: {
+          parallel: {
+            $ref: "#/$defs/flowSequence",
+            description: "Steps to run concurrently. The chained output after a parallel block is an array of all branch outputs in declaration order."
+          }
+        }
+      },
+      ifStep: {
+        type: "object",
+        required: ["if"],
+        additionalProperties: false,
+        properties: {
+          if: {
+            type: "object",
+            required: ["condition", "then"],
+            additionalProperties: false,
+            properties: {
+              condition: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL expression that determines which branch to take."
+              },
+              then: {
+                $ref: "#/$defs/flowSequence"
+              },
+              else: {
+                $ref: "#/$defs/flowSequence"
+              }
+            }
+          }
+        }
+      },
+      setStep: {
+        type: "object",
+        required: ["set"],
+        additionalProperties: false,
+        properties: {
+          set: {
+            type: "object",
+            description: "Writes values into execution.context. Each key becomes execution.context.<key>. Values are CEL expressions.",
+            minProperties: 1,
+            additionalProperties: {
+              $ref: "#/$defs/celExpression"
+            },
+            not: {
+              anyOf: [
+                { required: ["workflow"] },
+                { required: ["execution"] },
+                { required: ["input"] },
+                { required: ["output"] },
+                { required: ["env"] },
+                { required: ["loop"] },
+                { required: ["event"] }
+              ]
+            }
+          }
+        }
+      },
+      waitStep: {
+        type: "object",
+        required: ["wait"],
+        additionalProperties: false,
+        properties: {
+          wait: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+              event: {
+                type: "string",
+                description: "Event name to wait for (event mode)."
+              },
+              match: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL condition to match against event payload. 'event' variable contains the payload."
+              },
+              until: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL condition to wait for (polling mode)."
+              },
+              poll: {
+                $ref: "#/$defs/duration",
+                description: "Polling interval for 'until' condition. Default: runtime decides."
+              },
+              timeout: {
+                $ref: "#/$defs/duration",
+                description: "Maximum wait time."
+              },
+              onTimeout: {
+                $ref: "#/$defs/onTimeout",
+                description: "Strategy when timeout is reached: 'fail' (default), 'skip', or participant name."
+              }
+            }
+          }
+        }
+      },
+      participantOverrideStep: {
+        type: "object",
+        description: "A participant reference with flow-level overrides (timeout, onError, when, input, workflow, etc.).",
+        minProperties: 1,
+        maxProperties: 1,
+        not: {
+          anyOf: [
+            { required: ["loop"] },
+            { required: ["parallel"] },
+            { required: ["if"] },
+            { required: ["wait"] },
+            { required: ["set"] },
+            { required: ["type"] }
+          ]
+        },
+        additionalProperties: {
+          type: "object",
+          properties: {
+            when: {
+              $ref: "#/$defs/celExpression",
+              description: "Guard condition. If false, step is skipped."
+            },
+            timeout: {
+              $ref: "#/$defs/duration"
+            },
+            onError: {
+              $ref: "#/$defs/onError"
+            },
+            retry: {
+              $ref: "#/$defs/retryConfig"
+            },
+            input: {
+              $ref: "#/$defs/participantInput"
+            },
+            workflow: {
+              type: "string",
+              description: "Inline sub-workflow path (alternative to defining as participant)."
+            }
+          },
+          additionalProperties: false
+        }
+      },
+      workflowOutput: {
+        description: "Workflow output. Accessed in CEL as workflow.output. String (single CEL expression), object (structured mapping), or object with schema+map.",
+        oneOf: [
+          {
+            type: "string",
+            description: "Single CEL expression mapping."
+          },
+          {
+            type: "object",
+            description: "Structured output mapping (key → CEL expression) or schema+map.",
+            properties: {
+              schema: {
+                type: "object",
+                additionalProperties: {
+                  $ref: "#/$defs/inputField"
+                }
+              },
+              map: {
+                type: "object",
+                additionalProperties: {
+                  type: "string"
+                }
+              }
+            },
+            additionalProperties: {
+              type: "string"
+            }
+          }
+        ]
+      }
+    }
+  };
+});
 function validateSchema(workflow) {
   const valid = validate(workflow);
   if (valid) {
@@ -25812,15 +26354,14 @@ function validateSchema(workflow) {
 }
 var import__2020;
 var import_ajv_formats;
-var rawSchema;
 var schema;
 var ajv;
 var validate;
 var init_schema = __esm2(() => {
+  init_duckflux_schema();
   import__2020 = __toESM(require_2020(), 1);
   import_ajv_formats = __toESM(require_dist2(), 1);
-  rawSchema = readFileSync(new URL("./schema/duckflux.schema.json", import.meta.url), "utf-8");
-  schema = JSON.parse(rawSchema);
+  schema = { ...duckflux_schema_default };
   delete schema.$schema;
   ajv = new import__2020.default({ allErrors: true, strict: false });
   import_ajv_formats.default(ajv);
@@ -27883,7 +28424,6 @@ import { readFile as readFile5 } from "node:fs/promises";
 // ../core/dist/engine/index.js
 import { createRequire as createRequire3 } from "node:module";
 import { readFile as readFile3 } from "node:fs/promises";
-import { readFileSync as readFileSync2 } from "node:fs";
 import { constants as constants2 } from "node:fs";
 import { access as access2 } from "node:fs/promises";
 import { resolve as resolve3 } from "node:path";
@@ -53549,6 +54089,549 @@ var require_dist22 = __commonJS2((exports, module) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.default = formatsPlugin;
 });
+var duckflux_schema_default2;
+var init_duckflux_schema2 = __esm3(() => {
+  duckflux_schema_default2 = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://raw.githubusercontent.com/duckflux/spec/main/duckflux.schema.json",
+    title: "duckflux Workflow",
+    description: "Schema for duckflux — a minimal, deterministic, runtime-agnostic workflow DSL.",
+    type: "object",
+    required: ["flow"],
+    additionalProperties: false,
+    properties: {
+      id: {
+        type: "string",
+        description: "Unique identifier for the workflow."
+      },
+      name: {
+        type: "string",
+        description: "Human-readable workflow name."
+      },
+      version: {
+        description: "Version identifier for the workflow definition.",
+        oneOf: [
+          { type: "string" },
+          { type: "integer" }
+        ]
+      },
+      defaults: {
+        $ref: "#/$defs/defaults"
+      },
+      inputs: {
+        $ref: "#/$defs/inputs"
+      },
+      participants: {
+        type: "object",
+        description: "Named steps that can be referenced in the flow.",
+        additionalProperties: {
+          $ref: "#/$defs/participant"
+        },
+        not: {
+          anyOf: [
+            { required: ["workflow"] },
+            { required: ["execution"] },
+            { required: ["input"] },
+            { required: ["output"] },
+            { required: ["env"] },
+            { required: ["loop"] },
+            { required: ["event"] }
+          ]
+        }
+      },
+      flow: {
+        $ref: "#/$defs/flowSequence"
+      },
+      output: {
+        $ref: "#/$defs/workflowOutput"
+      }
+    },
+    $defs: {
+      duration: {
+        type: "string",
+        pattern: "^[0-9]+(ms|s|m|h|d)$",
+        description: "Duration string, e.g. '30s', '5m', '2h', '1d'."
+      },
+      celExpression: {
+        type: "string",
+        description: "A Google CEL expression."
+      },
+      defaults: {
+        type: "object",
+        description: "Global defaults applied to all participants.",
+        additionalProperties: false,
+        properties: {
+          timeout: {
+            $ref: "#/$defs/duration"
+          },
+          cwd: {
+            type: "string",
+            description: "Default working directory for exec participants. Supports CEL expressions."
+          }
+        }
+      },
+      inputs: {
+        type: "object",
+        description: "Workflow input parameters. Accessed in CEL as workflow.inputs.<field>. Each key is a parameter name. Value can be null (string, no schema), or a JSON Schema object for validation.",
+        additionalProperties: {
+          oneOf: [
+            { type: "null" },
+            { $ref: "#/$defs/inputField" }
+          ]
+        }
+      },
+      inputField: {
+        type: "object",
+        description: "JSON Schema field definition with optional 'required: true' shortcut.",
+        properties: {
+          type: {
+            type: "string",
+            enum: ["string", "integer", "number", "boolean", "array", "object"]
+          },
+          description: { type: "string" },
+          default: {},
+          required: { type: "boolean" },
+          format: { type: "string" },
+          enum: { type: "array" },
+          minimum: { type: "number" },
+          maximum: { type: "number" },
+          minLength: { type: "integer" },
+          maxLength: { type: "integer" },
+          pattern: { type: "string" },
+          items: {
+            $ref: "#/$defs/inputField"
+          }
+        },
+        additionalProperties: false
+      },
+      retryConfig: {
+        type: "object",
+        description: "Retry configuration. Only applies when onError is 'retry'.",
+        additionalProperties: false,
+        required: ["max"],
+        properties: {
+          max: {
+            type: "integer",
+            minimum: 1,
+            description: "Maximum number of retry attempts."
+          },
+          backoff: {
+            $ref: "#/$defs/duration",
+            description: "Interval between attempts. Default: 0s."
+          },
+          factor: {
+            type: "number",
+            minimum: 1,
+            description: "Backoff multiplier. Default: 1 (no escalation)."
+          }
+        }
+      },
+      onError: {
+        type: "string",
+        description: "Error handling strategy: 'fail' (default), 'skip', 'retry', or a participant name for redirect.",
+        minLength: 1
+      },
+      onTimeout: {
+        type: "string",
+        description: "Timeout handling strategy: 'fail' (default), 'skip', or a participant name for redirect.",
+        minLength: 1
+      },
+      participantInput: {
+        description: "Explicit input mapping. String for direct passthrough, object for structured mapping. Values are CEL expressions. Merged with implicit I/O chain input at runtime.",
+        oneOf: [
+          { type: "string" },
+          {
+            type: "object",
+            additionalProperties: {
+              type: "string"
+            }
+          }
+        ]
+      },
+      participantOutputSchema: {
+        type: "object",
+        description: "Output schema (JSON Schema fields). Opt-in validation.",
+        additionalProperties: {
+          $ref: "#/$defs/inputField"
+        }
+      },
+      payload: {
+        description: "Event payload. String (CEL expression) or object with CEL expressions as values.",
+        oneOf: [
+          { type: "string" },
+          {
+            type: "object",
+            additionalProperties: {}
+          }
+        ]
+      },
+      participant: {
+        type: "object",
+        required: ["type"],
+        description: "A named, reusable building block of the workflow.",
+        properties: {
+          type: {
+            type: "string",
+            enum: ["exec", "http", "mcp", "workflow", "emit"],
+            description: "Participant type."
+          },
+          as: {
+            type: "string",
+            description: "Human-readable display name."
+          },
+          timeout: {
+            $ref: "#/$defs/duration"
+          },
+          onError: {
+            $ref: "#/$defs/onError"
+          },
+          retry: {
+            $ref: "#/$defs/retryConfig"
+          },
+          input: {
+            $ref: "#/$defs/participantInput"
+          },
+          output: {
+            $ref: "#/$defs/participantOutputSchema"
+          },
+          run: {
+            type: "string",
+            description: "[exec] Shell command to execute."
+          },
+          cwd: {
+            type: "string",
+            description: "[exec] Working directory. Supports CEL expressions."
+          },
+          url: {
+            type: "string",
+            description: "[http] Target URL. Supports CEL expressions."
+          },
+          method: {
+            type: "string",
+            enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
+            description: "[http] HTTP method."
+          },
+          headers: {
+            type: "object",
+            additionalProperties: { type: "string" },
+            description: "[http] HTTP headers. Values support CEL expressions."
+          },
+          body: {
+            description: "[http] Request body. String or object. Supports CEL expressions.",
+            oneOf: [
+              { type: "string" },
+              { type: "object" }
+            ]
+          },
+          path: {
+            type: "string",
+            description: "[workflow] Path to the sub-workflow YAML file."
+          },
+          server: {
+            type: "string",
+            description: "[mcp] MCP server identifier."
+          },
+          tool: {
+            type: "string",
+            description: "[mcp] MCP tool name to invoke."
+          },
+          event: {
+            type: "string",
+            description: "[emit] Event name to emit."
+          },
+          payload: {
+            $ref: "#/$defs/payload",
+            description: "[emit] Event payload. CEL expression or object with CEL expressions."
+          },
+          ack: {
+            type: "boolean",
+            description: "[emit] If true, wait for delivery acknowledgment. Default: false.",
+            default: false
+          }
+        },
+        additionalProperties: false
+      },
+      inlineParticipant: {
+        type: "object",
+        required: ["type"],
+        description: "An inline participant definition in the flow. 'as' is optional — if omitted, the participant is anonymous and its output is only accessible via the implicit I/O chain.",
+        properties: {
+          as: {
+            type: "string",
+            description: "Optional name for inline participants. If provided, must be unique across all participant names. Enables output reference by name."
+          },
+          type: {
+            type: "string",
+            enum: ["exec", "http", "mcp", "workflow", "emit"],
+            description: "Participant type."
+          },
+          when: {
+            $ref: "#/$defs/celExpression",
+            description: "Guard condition. If false, step is skipped."
+          },
+          timeout: {
+            $ref: "#/$defs/duration"
+          },
+          onError: {
+            $ref: "#/$defs/onError"
+          },
+          retry: {
+            $ref: "#/$defs/retryConfig"
+          },
+          input: {
+            $ref: "#/$defs/participantInput"
+          },
+          output: {
+            $ref: "#/$defs/participantOutputSchema"
+          },
+          run: { type: "string" },
+          cwd: { type: "string" },
+          url: { type: "string" },
+          method: { type: "string", enum: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+          headers: { type: "object", additionalProperties: { type: "string" } },
+          body: { oneOf: [{ type: "string" }, { type: "object" }] },
+          path: { type: "string" },
+          server: { type: "string" },
+          tool: { type: "string" },
+          event: { type: "string" },
+          payload: { $ref: "#/$defs/payload" },
+          ack: { type: "boolean" }
+        },
+        additionalProperties: false
+      },
+      flowSequence: {
+        type: "array",
+        description: "Ordered list of flow steps. Each step's output is implicitly chained as input to the next step.",
+        minItems: 1,
+        items: {
+          $ref: "#/$defs/flowStep"
+        }
+      },
+      flowStep: {
+        description: "A single step in the flow: participant reference (string), control construct, inline participant (named or anonymous), or participant override.",
+        oneOf: [
+          {
+            type: "string",
+            description: "Simple participant reference by name."
+          },
+          { $ref: "#/$defs/loopStep" },
+          { $ref: "#/$defs/parallelStep" },
+          { $ref: "#/$defs/ifStep" },
+          { $ref: "#/$defs/setStep" },
+          { $ref: "#/$defs/waitStep" },
+          { $ref: "#/$defs/inlineParticipant" },
+          { $ref: "#/$defs/participantOverrideStep" }
+        ]
+      },
+      loopStep: {
+        type: "object",
+        required: ["loop"],
+        additionalProperties: false,
+        properties: {
+          loop: {
+            type: "object",
+            additionalProperties: false,
+            required: ["steps"],
+            properties: {
+              as: {
+                type: "string",
+                description: "Renames the loop context variable. Access as <as>.index, <as>.iteration, etc. instead of loop.*"
+              },
+              until: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL condition to break out of the loop."
+              },
+              max: {
+                description: "Maximum iterations. Integer or CEL expression.",
+                oneOf: [
+                  { type: "integer", minimum: 1 },
+                  { type: "string" }
+                ]
+              },
+              steps: {
+                $ref: "#/$defs/flowSequence"
+              }
+            },
+            anyOf: [
+              { required: ["until"] },
+              { required: ["max"] }
+            ]
+          }
+        }
+      },
+      parallelStep: {
+        type: "object",
+        required: ["parallel"],
+        additionalProperties: false,
+        properties: {
+          parallel: {
+            $ref: "#/$defs/flowSequence",
+            description: "Steps to run concurrently. The chained output after a parallel block is an array of all branch outputs in declaration order."
+          }
+        }
+      },
+      ifStep: {
+        type: "object",
+        required: ["if"],
+        additionalProperties: false,
+        properties: {
+          if: {
+            type: "object",
+            required: ["condition", "then"],
+            additionalProperties: false,
+            properties: {
+              condition: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL expression that determines which branch to take."
+              },
+              then: {
+                $ref: "#/$defs/flowSequence"
+              },
+              else: {
+                $ref: "#/$defs/flowSequence"
+              }
+            }
+          }
+        }
+      },
+      setStep: {
+        type: "object",
+        required: ["set"],
+        additionalProperties: false,
+        properties: {
+          set: {
+            type: "object",
+            description: "Writes values into execution.context. Each key becomes execution.context.<key>. Values are CEL expressions.",
+            minProperties: 1,
+            additionalProperties: {
+              $ref: "#/$defs/celExpression"
+            },
+            not: {
+              anyOf: [
+                { required: ["workflow"] },
+                { required: ["execution"] },
+                { required: ["input"] },
+                { required: ["output"] },
+                { required: ["env"] },
+                { required: ["loop"] },
+                { required: ["event"] }
+              ]
+            }
+          }
+        }
+      },
+      waitStep: {
+        type: "object",
+        required: ["wait"],
+        additionalProperties: false,
+        properties: {
+          wait: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+              event: {
+                type: "string",
+                description: "Event name to wait for (event mode)."
+              },
+              match: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL condition to match against event payload. 'event' variable contains the payload."
+              },
+              until: {
+                $ref: "#/$defs/celExpression",
+                description: "CEL condition to wait for (polling mode)."
+              },
+              poll: {
+                $ref: "#/$defs/duration",
+                description: "Polling interval for 'until' condition. Default: runtime decides."
+              },
+              timeout: {
+                $ref: "#/$defs/duration",
+                description: "Maximum wait time."
+              },
+              onTimeout: {
+                $ref: "#/$defs/onTimeout",
+                description: "Strategy when timeout is reached: 'fail' (default), 'skip', or participant name."
+              }
+            }
+          }
+        }
+      },
+      participantOverrideStep: {
+        type: "object",
+        description: "A participant reference with flow-level overrides (timeout, onError, when, input, workflow, etc.).",
+        minProperties: 1,
+        maxProperties: 1,
+        not: {
+          anyOf: [
+            { required: ["loop"] },
+            { required: ["parallel"] },
+            { required: ["if"] },
+            { required: ["wait"] },
+            { required: ["set"] },
+            { required: ["type"] }
+          ]
+        },
+        additionalProperties: {
+          type: "object",
+          properties: {
+            when: {
+              $ref: "#/$defs/celExpression",
+              description: "Guard condition. If false, step is skipped."
+            },
+            timeout: {
+              $ref: "#/$defs/duration"
+            },
+            onError: {
+              $ref: "#/$defs/onError"
+            },
+            retry: {
+              $ref: "#/$defs/retryConfig"
+            },
+            input: {
+              $ref: "#/$defs/participantInput"
+            },
+            workflow: {
+              type: "string",
+              description: "Inline sub-workflow path (alternative to defining as participant)."
+            }
+          },
+          additionalProperties: false
+        }
+      },
+      workflowOutput: {
+        description: "Workflow output. Accessed in CEL as workflow.output. String (single CEL expression), object (structured mapping), or object with schema+map.",
+        oneOf: [
+          {
+            type: "string",
+            description: "Single CEL expression mapping."
+          },
+          {
+            type: "object",
+            description: "Structured output mapping (key → CEL expression) or schema+map.",
+            properties: {
+              schema: {
+                type: "object",
+                additionalProperties: {
+                  $ref: "#/$defs/inputField"
+                }
+              },
+              map: {
+                type: "object",
+                additionalProperties: {
+                  type: "string"
+                }
+              }
+            },
+            additionalProperties: {
+              type: "string"
+            }
+          }
+        ]
+      }
+    }
+  };
+});
 function validateSchema2(workflow) {
   const valid = validate2(workflow);
   if (valid) {
@@ -53562,15 +54645,14 @@ function validateSchema2(workflow) {
 }
 var import__20202;
 var import_ajv_formats2;
-var rawSchema2;
 var schema2;
 var ajv2;
 var validate2;
 var init_schema2 = __esm3(() => {
+  init_duckflux_schema2();
   import__20202 = __toESM2(require_20202(), 1);
   import_ajv_formats2 = __toESM2(require_dist22(), 1);
-  rawSchema2 = readFileSync2(new URL("./schema/duckflux.schema.json", import.meta.url), "utf-8");
-  schema2 = JSON.parse(rawSchema2);
+  schema2 = { ...duckflux_schema_default2 };
   delete schema2.$schema;
   ajv2 = new import__20202.default({ allErrors: true, strict: false });
   import_ajv_formats2.default(ajv2);
@@ -55961,7 +57043,7 @@ async function validateCommand(filePath, cliValues) {
 // src/main.ts
 function getVersion() {
   try {
-    const pkg = JSON.parse(readFileSync3(resolve5(dirname5(new URL(import.meta.url).pathname), "../package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync(resolve5(dirname5(new URL(import.meta.url).pathname), "../package.json"), "utf-8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckflux/runner",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "type": "module",
   "bin": {
     "quack": "dist/main.js"