@duckflux/core 0.6.8 → 0.7.1

package/dist/parser/index.js

@@ -26165,8 +26165,552 @@ var require_dist2 = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
+// src/parser/schema/duckflux.schema.json
+var duckflux_schema_default;
+var init_duckflux_schema = __esm(() => {
+  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"
+            }
+          }
+        ]
+      }
+    }
+  };
+});
+
 // src/parser/schema.ts
-import { readFileSync } from "node:fs";
 function validateSchema(workflow) {
   const valid = validate(workflow);
   if (valid) {
@@ -26178,12 +26722,12 @@ function validateSchema(workflow) {
   }));
   return { valid: false, errors };
 }
-var import__2020, import_ajv_formats, rawSchema, schema, ajv, validate;
+var import__2020, import_ajv_formats, schema, ajv, validate;
 var init_schema = __esm(() => {
+  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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckflux/core",
-  "version": "0.6.8",
+  "version": "0.7.1",
   "type": "module",
   "main": "src/index.ts",
   "exports": {