@octaviaflow/flow-rules 0.19.1 → 0.21.0

package/dist/index.cjs

@@ -121,6 +121,7 @@ __export(exports_src, {
   contractDrift: () => contractDrift,
   contractFieldsFor: () => contractFieldsFor,
   contractFor: () => contractFor,
+  contractValidationErrors: () => contractValidationErrors,
   contractVocabularyDrift: () => contractVocabularyDrift,
   declaredKeys: () => declaredKeys,
   detectRecordFields: () => detectRecordFields,
@@ -150,6 +151,7 @@ __export(exports_src, {
   isQueryableConnector: () => isQueryableConnector,
   mappingTransformFunctionName: () => mappingTransformFunctionName,
   migrateDelayConfig: () => migrateDelayConfig,
+  missingContractRequired: () => missingContractRequired,
   queryDefinition: () => queryDefinition,
   queryFieldsSatisfied: () => queryFieldsSatisfied,
   queryTablesSatisfied: () => queryTablesSatisfied,
@@ -2929,859 +2931,230 @@ var getActionsByCategory = (category) => {
     return [];
   return Object.values(categoryActions);
 };
-// src/rules/nodeConfigStatus.ts
-var HIDDEN_STATUS_ACTIONS = new Set(["console_log"]);
-function isFieldFilled(value) {
-  if (value === undefined || value === null)
-    return false;
-  if (typeof value === "string")
-    return value.trim().length > 0;
-  if (typeof value === "number")
-    return true;
-  if (typeof value === "boolean")
-    return true;
-  if (Array.isArray(value))
-    return value.length > 0;
-  if (typeof value === "object")
-    return Object.keys(value).length > 0;
-  return false;
-}
-function isSatisfiedOutOfBand(actionId, fieldKey, config) {
-  if (actionId === "connector_trigger" && fieldKey === "events") {
-    return Number(config.eventCount ?? 0) > 0;
-  }
-  if (MESSAGE_BODY_ACTIONS.has(actionId) && (fieldKey === "message" || fieldKey === "text")) {
-    const text = config.text ?? config.message;
-    if (typeof text === "string" && text.trim().length > 0)
-      return true;
-    return Array.isArray(config.blocks) && config.blocks.length > 0;
-  }
-  if (actionId === "query" && fieldKey === "visualConfig.fields")
-    return queryFieldsSatisfied(config);
-  if (actionId === "query" && fieldKey === "visualConfig.tables")
-    return queryTablesSatisfied(config);
-  return false;
-}
-var MESSAGE_BODY_ACTIONS = new Set([
-  "slack_message",
-  "teams_message",
-  "google_chat"
-]);
-function getNestedValue(config, keyPath) {
-  const parts = keyPath.split(".");
-  let current = config;
-  for (const part of parts) {
-    if (current === null || current === undefined || typeof current !== "object") {
-      return;
+// src/catalog/actions/console-log/config.ts
+var ConsoleLogConfig = {
+  defaults: {
+    message: "",
+    level: "info",
+    data: undefined,
+    includeInputData: true
+  },
+  schema: {
+    includeInputData: { type: "boolean", required: false },
+    message: {
+      type: "string",
+      required: true,
+      description: "Message to log"
+    },
+    level: {
+      type: "select",
+      required: false,
+      options: ["info", "warning", "error", "debug"],
+      description: "Log level for the message"
+    },
+    data: {
+      type: "json",
+      required: false,
+      description: "Additional data to log"
     }
-    current = current[part];
-  }
-  return current;
-}
-function isFieldActive(field, config) {
-  if (!field.conditional || field.conditional.length === 0) {
-    return true;
-  }
-  return field.conditional.some((cond) => {
-    if (cond.action !== "show" && cond.action !== "require") {
-      return false;
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.message) {
+      errors.push("Message is required");
+    } else if (typeof config.message !== "string") {
+      errors.push("Message must be a string");
     }
-    const fieldValue = getNestedValue(config, cond.field);
-    switch (cond.operator) {
-      case "==":
-        return fieldValue === cond.value;
-      case "!=":
-        return fieldValue !== cond.value;
-      case ">":
-        return fieldValue > cond.value;
-      case "<":
-        return fieldValue < cond.value;
-      case ">=":
-        return fieldValue >= cond.value;
-      case "<=":
-        return fieldValue <= cond.value;
-      case "in":
-        return Array.isArray(cond.value) && cond.value.includes(fieldValue);
-      case "not_in":
-        return Array.isArray(cond.value) && !cond.value.includes(fieldValue);
-      case "contains":
-        return typeof fieldValue === "string" && fieldValue.includes(cond.value);
-      default:
-        return false;
+    if (config.level && !["info", "warning", "error", "debug"].includes(config.level)) {
+      errors.push("Invalid log level");
     }
-  });
-}
-function getNodeConfigStatus(node) {
-  if (HIDDEN_STATUS_ACTIONS.has(node.actionDefinitionId)) {
     return {
-      status: "hidden",
-      requiredTotal: 0,
-      requiredFilled: 0,
-      optionalTotal: 0,
-      optionalFilled: 0,
-      missingRequired: [],
-      filledOptional: []
+      valid: errors.length === 0,
+      errors
     };
-  }
-  const definition = getActionById(node.actionDefinitionId);
-  if (!definition) {
+  },
+  merge: (userConfig) => {
     return {
-      status: "unconfigured",
-      requiredTotal: 0,
-      requiredFilled: 0,
-      optionalTotal: 0,
-      optionalFilled: 0,
-      missingRequired: [],
-      filledOptional: []
+      ...ConsoleLogConfig.defaults,
+      ...userConfig
     };
+  },
+  getLabel: (config) => {
+    return `Log [${config.level}]: ${config.message}`;
   }
-  const fields = definition.inputSchema?.fields ?? [];
-  const config = node.config ?? {};
-  const activeFields = fields.filter((f) => !f.hidden && isFieldActive(f, config));
-  const requiredFields = activeFields.filter((f) => f.validation?.required);
-  const optionalFields = activeFields.filter((f) => !f.validation?.required);
-  const missingRequired = [];
-  let requiredFilled = 0;
-  for (const field of requiredFields) {
-    const value = getNestedValue(config, field.key);
-    if (isFieldFilled(value)) {
-      requiredFilled++;
-    } else if (isFieldFilled(field.defaultValue)) {
-      requiredFilled++;
-    } else if (isSatisfiedOutOfBand(node.actionDefinitionId, field.key, config)) {
-      requiredFilled++;
-    } else {
-      missingRequired.push(field.key);
+};
+
+// src/catalog/actions/delay/config.ts
+var DelayConfig = {
+  defaults: {
+    duration: 1000,
+    unit: "milliseconds"
+  },
+  schema: {
+    duration: {
+      type: "number",
+      required: true,
+      description: "Duration to delay",
+      min: 0
+    },
+    unit: {
+      type: "select",
+      required: false,
+      options: ["milliseconds", "seconds", "minutes", "hours"],
+      description: "Time unit for the duration"
     }
-  }
-  const filledOptional = [];
-  let optionalFilled = 0;
-  for (const field of optionalFields) {
-    const value = getNestedValue(config, field.key);
-    if (isFieldFilled(value)) {
-      optionalFilled++;
-      filledOptional.push(field.key);
+  },
+  validate: (config) => {
+    const errors = [];
+    if (config.duration === undefined || config.duration === null) {
+      errors.push("Duration is required");
+    } else if (typeof config.duration !== "number") {
+      errors.push("Duration must be a number");
+    } else if (config.duration < 0) {
+      errors.push("Duration must be non-negative");
     }
+    if (config.unit && !["milliseconds", "seconds", "minutes", "hours"].includes(config.unit)) {
+      errors.push("Invalid time unit");
+    }
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  },
+  toMilliseconds: (duration, unit = "milliseconds") => {
+    const multipliers = {
+      milliseconds: 1,
+      seconds: 1000,
+      minutes: 60000,
+      hours: 3600000
+    };
+    return duration * (multipliers[unit] || 1);
+  },
+  merge: (userConfig) => {
+    return {
+      ...DelayConfig.defaults,
+      ...userConfig
+    };
+  },
+  getLabel: (config) => {
+    return `Delay ${config.duration}${config.unit ? " " + config.unit : "ms"}`;
   }
-  const requiredTotal = requiredFields.length;
-  const optionalTotal = optionalFields.length;
-  let status;
-  if (requiredTotal === 0) {
-    status = "valid";
-  } else if (missingRequired.length === 0) {
-    status = "valid";
-  } else if (requiredFilled > 0 || optionalFilled > 0) {
-    status = "warning";
-  } else {
-    status = "error";
-  }
-  return {
-    status,
-    requiredTotal,
-    requiredFilled,
-    optionalTotal,
-    optionalFilled,
-    missingRequired,
-    filledOptional
-  };
-}
+};
 
-// src/rules/workflowValidator.ts
-var nodeName = (n) => n.label || n.id;
-function validateNode(node, allNodes, allEdges) {
-  const errors = [];
-  if (!node.id || node.id.trim().length === 0) {
-    errors.push({
-      id: `node-${node.id}-id`,
-      type: "node",
-      severity: "error",
-      message: "Node ID is required",
-      nodeId: node.id
-    });
-  }
-  if (!node.label || node.label.trim().length === 0) {
-    errors.push({
-      id: `node-${node.id}-label`,
-      type: "node",
-      severity: "error",
-      message: "Node label is required",
-      nodeId: node.id
-    });
-  }
-  const cfg = getNodeConfigStatus(node);
-  if (cfg.missingRequired.length > 0) {
-    const fields = cfg.missingRequired.slice(0, 4).join(", ");
-    const more = cfg.missingRequired.length > 4 ? ` +${cfg.missingRequired.length - 4} more` : "";
-    errors.push({
-      id: `node-${node.id}-config`,
-      type: "node",
-      severity: "error",
-      message: `Missing required settings: ${fields}${more}. Open the step and fill them in.`,
-      nodeId: node.id
-    });
-  }
-  const hasOutput = allEdges.some((edge) => edge.source === node.id);
-  if (!hasOutput && node.type === "trigger") {
-    errors.push({
-      id: `node-${node.id}-output`,
-      type: "node",
-      severity: "warning",
-      message: `Trigger "${nodeName(node)}" has no outgoing connections`,
-      nodeId: node.id
-    });
-  }
-  return errors;
-}
-function validateEdge(edge, allNodes, allEdges = []) {
-  const errors = [];
-  const sourceNode = allNodes.find((n) => n.id === edge.source);
-  if (!sourceNode) {
-    errors.push({
-      id: `edge-${edge.id}-source`,
-      type: "edge",
-      severity: "error",
-      message: `Source node "${edge.source}" does not exist`,
-      edgeId: edge.id
-    });
-  }
-  const targetNode = allNodes.find((n) => n.id === edge.target);
-  if (!targetNode) {
-    errors.push({
-      id: `edge-${edge.id}-target`,
-      type: "edge",
-      severity: "error",
-      message: `Target node "${edge.target}" does not exist`,
-      edgeId: edge.id
-    });
-  }
-  if (edge.source === edge.target) {
-    errors.push({
-      id: `edge-${edge.id}-loop`,
-      type: "edge",
-      severity: "error",
-      message: "Nodes cannot connect to themselves",
-      edgeId: edge.id
-    });
-  }
-  const key = (e) => `${e.source}|${e.sourceHandle ?? ""}→${e.target}|${e.targetHandle ?? ""}`;
-  const myKey = key(edge);
-  const firstIndex = allEdges.findIndex((e) => key(e) === myKey);
-  const myIndex = allEdges.findIndex((e) => e.id === edge.id);
-  if (firstIndex !== -1 && myIndex > firstIndex) {
-    errors.push({
-      id: `edge-${edge.id}-duplicate`,
-      type: "edge",
-      severity: "warning",
-      message: `Duplicate connection between "${sourceNode ? nodeName(sourceNode) : edge.source}" and "${targetNode ? nodeName(targetNode) : edge.target}"`,
-      edgeId: edge.id
-    });
-  }
-  return errors;
-}
-function validateWorkflow(nodes, edges) {
-  const allErrors = [];
-  const hasTrigger = nodes.some((node) => node.type === "trigger");
-  if (!hasTrigger) {
-    allErrors.push({
-      id: "workflow-trigger",
-      type: "workflow",
-      severity: "error",
-      message: "Workflow must have at least one trigger node"
-    });
-  }
-  const hasAction = nodes.some((node) => node.type === "action");
-  if (!hasAction && nodes.length > 0) {
-    allErrors.push({
-      id: "workflow-action",
-      type: "workflow",
-      severity: "warning",
-      message: "Workflow should have at least one action node"
-    });
-  }
-  nodes.forEach((node) => {
-    const nodeErrors = validateNode(node, nodes, edges);
-    allErrors.push(...nodeErrors);
-  });
-  edges.forEach((edge) => {
-    const edgeErrors = validateEdge(edge, nodes, edges);
-    allErrors.push(...edgeErrors);
-  });
-  if (nodes.length > 0 && edges.length > 0) {
-    const inDegree = new Map(nodes.map((n) => [n.id, 0]));
-    const out = new Map;
-    for (const e of edges) {
-      if (e.source === e.target)
-        continue;
-      if (!inDegree.has(e.source) || !inDegree.has(e.target))
-        continue;
-      inDegree.set(e.target, (inDegree.get(e.target) ?? 0) + 1);
-      const list = out.get(e.source);
-      if (list)
-        list.push(e.target);
-      else
-        out.set(e.source, [e.target]);
-    }
-    const queue = nodes.filter((n) => (inDegree.get(n.id) ?? 0) === 0).map((n) => n.id);
-    let visited = 0;
-    while (queue.length) {
-      const cur = queue.shift();
-      visited++;
-      for (const next of out.get(cur) ?? []) {
-        const d = (inDegree.get(next) ?? 1) - 1;
-        inDegree.set(next, d);
-        if (d === 0)
-          queue.push(next);
-      }
-    }
-    if (visited < nodes.length) {
-      const stuck = nodes.filter((n) => (inDegree.get(n.id) ?? 0) > 0);
-      const names = stuck.slice(0, 3).map(nodeName).join(", ");
-      const more = stuck.length > 3 ? ` +${stuck.length - 3} more` : "";
-      allErrors.push({
-        id: "workflow-cycle",
-        type: "workflow",
-        severity: "error",
-        message: `Circular connection detected involving: ${names}${more}. Break the loop — execution order is undefined inside a cycle.`,
-        nodeId: stuck[0]?.id
-      });
-    }
-  }
-  const isTrigger = (n) => n.type === "trigger" || String(n.actionDefinitionId ?? "").endsWith("_trigger");
-  const triggerIds = nodes.filter(isTrigger).map((n) => n.id);
-  const adjacency = new Map;
-  for (const e of edges) {
-    const list = adjacency.get(e.source);
-    if (list)
-      list.push(e.target);
-    else
-      adjacency.set(e.source, [e.target]);
-  }
-  const reachable = new Set(triggerIds);
-  const queue = [...triggerIds];
-  while (queue.length) {
-    const cur = queue.shift();
-    for (const next of adjacency.get(cur) ?? []) {
-      if (!reachable.has(next)) {
-        reachable.add(next);
-        queue.push(next);
-      }
-    }
-  }
-  let changed = true;
-  while (changed) {
-    changed = false;
-    for (const n of nodes) {
-      if (reachable.has(n.id)) {
-        if (n.parentId && !reachable.has(n.parentId)) {
-          reachable.add(n.parentId);
-          changed = true;
-        }
-      } else if (n.parentId && reachable.has(n.parentId)) {
-        reachable.add(n.id);
-        changed = true;
-      }
-    }
-  }
-  nodes.forEach((node) => {
-    if (isTrigger(node))
-      return;
-    const isConnected = edges.some((e) => e.source === node.id || e.target === node.id);
-    const wontRun = triggerIds.length > 0 ? !reachable.has(node.id) : !isConnected;
-    if (wontRun) {
-      allErrors.push({
-        id: `node-${node.id}-orphan`,
-        type: "node",
-        severity: "warning",
-        message: isConnected ? `"${nodeName(node)}" isn't reachable from a trigger and won't run.` : `"${nodeName(node)}" isn't connected to a flow and won't run.`,
-        nodeId: node.id
-      });
-    }
-  });
-  if (triggerIds.length > 1) {
-    const parentOf = new Map(nodes.filter((n) => n.parentId).map((n) => [n.id, n.parentId]));
-    const undirected = new Map;
-    const link = (a, b) => {
-      const la = undirected.get(a);
-      if (la)
-        la.push(b);
-      else
-        undirected.set(a, [b]);
-    };
-    for (const e of edges) {
-      link(e.source, e.target);
-      link(e.target, e.source);
-    }
-    for (const [child, parent] of parentOf) {
-      link(child, parent);
-      link(parent, child);
-    }
-    const seen = new Set;
-    let flowsWithTrigger = 0;
-    for (const t of triggerIds) {
-      if (seen.has(t))
-        continue;
-      flowsWithTrigger++;
-      const stack = [t];
-      seen.add(t);
-      while (stack.length) {
-        const cur = stack.pop();
-        for (const next of undirected.get(cur) ?? []) {
-          if (!seen.has(next)) {
-            seen.add(next);
-            stack.push(next);
-          }
-        }
-      }
-    }
-    if (flowsWithTrigger > 1) {
-      allErrors.push({
-        id: "workflow-multi-flow",
-        type: "workflow",
-        severity: "warning",
-        message: `This canvas holds ${flowsWithTrigger} separate flows. Each trigger runs only its own flow — consider splitting them into separate flows for clarity.`
-      });
-    }
-  }
-  const errors = allErrors.filter((e) => e.severity === "error");
-  const warnings = allErrors.filter((e) => e.severity === "warning");
-  return {
-    isValid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
-function getNodeValidationStatus(nodeId, validationResult) {
-  const hasError = validationResult.errors.some((e) => e.nodeId === nodeId);
-  if (hasError)
-    return "error";
-  const hasWarning = validationResult.warnings.some((e) => e.nodeId === nodeId);
-  if (hasWarning)
-    return "warning";
-  return "valid";
-}
-function getEdgeValidationStatus(edgeId, validationResult) {
-  const hasError = validationResult.errors.some((e) => e.edgeId === edgeId);
-  if (hasError)
-    return "error";
-  const hasWarning = validationResult.warnings.some((e) => e.edgeId === edgeId);
-  if (hasWarning)
-    return "warning";
-  return "valid";
-}
-// src/catalog/logic/condition/config.ts
-var CONDITION_OPERATORS = [
-  { id: "equals", label: "Equals", needsValue: true },
-  { id: "not_equals", label: "Not Equals", needsValue: true },
-  { id: "greater_than", label: "Greater Than", needsValue: true },
-  { id: "greater_than_equals", label: "Greater Than or Equals", needsValue: true },
-  { id: "less_than", label: "Less Than", needsValue: true },
-  { id: "less_than_equals", label: "Less Than or Equals", needsValue: true },
-  { id: "like", label: "Like", needsValue: true },
-  { id: "contains", label: "Contains", needsValue: true },
-  { id: "starts_with", label: "Starts With", needsValue: true },
-  { id: "ends_with", label: "Ends With", needsValue: true },
-  { id: "is_null", label: "Is Null", needsValue: false },
-  { id: "is_not_null", label: "Is Not Null", needsValue: false },
-  { id: "is_empty", label: "Is Empty", needsValue: false }
-];
-function isMissingValue(value) {
-  return value === undefined || value === null || value === "";
-}
-var ConditionConfig = {
-  defaults: {
-    mode: "visual",
-    filters: [],
-    condition: ""
-  },
-  schema: {
-    mode: { type: "select", required: true, options: ["visual", "expression"] },
-    filters: { type: "array", required: false },
-    condition: { type: "expression", required: false }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (config.mode === "expression") {
-      if (!config.condition) {
-        errors.push("Condition expression is required");
-      } else {
-        try {
-          new Function(`return ${config.condition}`);
-        } catch (e) {
-          errors.push(`Invalid expression: ${e instanceof Error ? e.message : "Unknown error"}`);
-        }
-      }
-    } else {
-      if (!config.filters || config.filters.length === 0) {
-        errors.push("At least one condition filter is required");
-      } else {
-        config.filters.forEach((f, i) => {
-          if (!f.field)
-            errors.push(`Filter ${i + 1}: Field is required`);
-          if (!f.operator)
-            errors.push(`Filter ${i + 1}: Operator is required`);
-          const opDef = CONDITION_OPERATORS.find((o) => o.id === f.operator);
-          if (opDef?.needsValue && isMissingValue(f.value)) {
-            errors.push(`Filter ${i + 1}: Value is required`);
-          }
-        });
-      }
-    }
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...ConditionConfig.defaults, ...userConfig };
-  },
-  generateName: (filters) => {
-    if (filters.length === 0)
-      return "If …";
-    const parts = filters.map((f, i) => {
-      const opLabel = CONDITION_OPERATORS.find((o) => o.id === f.operator)?.label || f.operator;
-      const base = `${f.field || "?"} ${opLabel}${f.value ? ` ${f.value}` : ""}`;
-      if (i === 0)
-        return base;
-      return `${(f.logicalOperator || "and").toUpperCase()} ${base}`;
-    });
-    return `If ${parts.join(" ")}`;
-  },
-  getLabel: (config) => {
-    if (config.mode === "expression")
-      return `If ${config.condition || "…"}`;
-    return ConditionConfig.generateName(config.filters);
-  },
-  createFilterId: () => `cond_${Date.now()}_${randomSuffix(5)}`
-};
-// src/catalog/logic/for-each/config.ts
-var SOURCELESS_MODES = new Set(["range", "cursor", "while"]);
-var ForEachConfig = {
-  defaults: {
-    arrayPath: "",
-    iterationMode: "records",
-    itemVariable: "item",
-    indexVariable: "index",
-    batchSize: 0,
-    continueOnError: false,
-    concurrency: "sequential",
-    collect: "array"
-  },
-  schema: {
-    arrayPath: {
-      type: "select",
-      required: false,
-      dynamic: true,
-      description: "A path to an array in the upstream step's output (the Query's object name, or a field holding a list) — the values come from that step's data, not from the catalog"
-    },
-    iterationMode: {
-      type: "select",
-      required: false,
-      options: ["records", "fields", "range", "nested", "batch", "cursor", "while", "array"],
-      description: "What one iteration is: records (one per record, the default; array is its legacy alias), fields, range, nested, batch, cursor or while"
-    },
-    itemVariable: { type: "string", required: true },
-    indexVariable: { type: "string", required: false },
-    batchSize: { type: "number", required: false },
-    continueOnError: { type: "boolean", required: false },
-    collect: {
-      type: "select",
-      required: false,
-      options: ["array", "none", "groupBy", "reduce", "rows"],
-      description: "What the Done port carries besides the counts: array (each iteration's result in `results`, the default), none, groupBy (by groupByPath), " + "reduce (reduceOp over reducePath), or rows — also `data`: every row the body produced (each iteration's Query/Transform rows, else its result), " + "so ONE step on the Done port maps and writes them all instead of a write per iteration."
-    }
-  },
-  validate: (config) => {
-    const errors = [];
-    const mode = config.iterationMode || "records";
-    if (mode === "range") {
-      if (!config.count || config.count <= 0) {
-        errors.push("Range mode needs a positive iteration count");
-      }
-    } else if (mode === "nested") {
-      if (!config.arrayPath)
-        errors.push("Select the records to drill into");
-      if (!config.nestedPath)
-        errors.push('Nested mode needs the sub-array path to iterate (e.g. "lineItems")');
-    } else if (!SOURCELESS_MODES.has(mode)) {
-      if (!config.arrayPath) {
-        errors.push("Array path is required — select which records to iterate over");
-      }
-    }
-    if (config.concurrency === "parallel" && config.maxConcurrency !== undefined && config.maxConcurrency < 1) {
-      errors.push("Max concurrency must be at least 1");
-    }
-    if (config.batchSize !== undefined && config.batchSize < 0) {
-      errors.push("Batch size must be 0 (all) or a positive number");
-    }
-    if (config.collect === "groupBy" && !config.groupByPath) {
-      errors.push("Group-by collection needs a field path to group on");
-    }
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...ForEachConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => {
-    const mode = config.iterationMode || "records";
-    if (mode === "range")
-      return `ForEach ×${config.count ?? "…"}`;
-    if (mode === "cursor")
-      return "ForEach (paginate)";
-    if (mode === "while")
-      return "ForEach (while)";
-    return `ForEach in ${config.arrayPath || "…"}`;
-  },
-  generateName: (arrayPath) => {
-    return `ForEach in ${arrayPath || "…"}`;
-  }
-};
-// src/catalog/logic/for-each/pathOptions.ts
-function inferSchemaFromSample(sample) {
-  const properties = {};
-  for (const [key, value] of Object.entries(sample)) {
-    if (value === null || value === undefined) {
-      properties[key] = { type: "string" };
-    } else if (Array.isArray(value)) {
-      if (value.length > 0 && typeof value[0] === "object" && value[0] !== null) {
-        properties[key] = { type: "array", items: inferSchemaFromSample(value[0]) };
-      } else {
-        properties[key] = { type: "array" };
-      }
-    } else if (typeof value === "object") {
-      properties[key] = inferSchemaFromSample(value);
-    } else if (typeof value === "number") {
-      properties[key] = { type: "number" };
-    } else if (typeof value === "boolean") {
-      properties[key] = { type: "boolean" };
-    } else {
-      properties[key] = { type: "string" };
-    }
-  }
-  return { type: "object", properties };
-}
-function collectArrayPaths(schema, prefix, add, depth = 0) {
-  if (!schema || typeof schema !== "object" || depth > 8)
-    return;
-  if (schema.type === "array") {
-    if (prefix) {
-      const itemsType = schema.items?.type;
-      const label = itemsType === "object" ? "array of objects" : "array";
-      add(prefix, `${prefix}  (${label})`, `Iterate over "${prefix}"`);
-    }
-    if (schema.items) {
-      collectArrayPaths(schema.items, prefix, add, depth + 1);
-    }
-    return;
-  }
-  if (schema.type === "object" && schema.properties) {
-    for (const [key, child] of Object.entries(schema.properties)) {
-      const next = prefix ? `${prefix}.${key}` : key;
-      collectArrayPaths(child, next, add, depth + 1);
-    }
-  }
-}
-function collectArrayPathsFromSample(sample, prefix, add, depth = 0) {
-  if (!sample || typeof sample !== "object" || depth > 8)
-    return;
-  if (Array.isArray(sample)) {
-    if (prefix) {
-      const itemsObj = sample.length > 0 && typeof sample[0] === "object" && sample[0] !== null;
-      const label = itemsObj ? "array of objects" : "array";
-      add(prefix, `${prefix}  (${label})`, `Iterate over "${prefix}"`);
-    }
-    if (sample.length > 0) {
-      collectArrayPathsFromSample(sample[0], prefix, add, depth + 1);
-    }
-    return;
-  }
-  for (const [key, value] of Object.entries(sample)) {
-    const next = prefix ? `${prefix}.${key}` : key;
-    collectArrayPathsFromSample(value, next, add, depth + 1);
-  }
-}
-function buildPathOptions(upstreamNodes) {
-  const paths = [];
-  const seen = new Set;
-  const add = (id, text, description) => {
-    if (seen.has(id))
-      return;
-    seen.add(id);
-    paths.push({ id, text, description });
-  };
-  if (upstreamNodes) {
-    for (const node of upstreamNodes) {
-      const label = node.label || node.type || "Upstream";
-      const queryTable = node.config?.visualConfig?.tables?.[0];
-      add("data", queryTable ? `${queryTable} (${label})` : `All records (${label})`, queryTable ? `Iterate over every ${queryTable} record` : "Iterate over every record from upstream");
-      const schema = node.outputSchema || node.config?._outputSchema;
-      if (schema)
-        collectArrayPaths(schema, "", add);
-      const output = node.executionData?.output;
-      if (output) {
-        const records = Array.isArray(output.data) ? output.data : Array.isArray(output) ? output : null;
-        if (records && records.length > 0 && typeof records[0] === "object") {
-          collectArrayPathsFromSample(records[0], "", add);
-        }
-      }
-    }
-  }
-  if (paths.length === 0) {
-    add("data", "data (upstream output)");
-  }
-  return paths;
+// src/catalog/actions/http-request/config.ts
+function urlCheckedAtRunTime(url, connectionId) {
+  const u = url.trim();
+  if (u.startsWith("{{"))
+    return true;
+  const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(u);
+  return !!connectionId && !hasScheme;
 }
-// src/catalog/utility/variables/config.ts
-var RESERVED_KEYS = new Set(["_lineage", "_meta", "_redacted", "_error"]);
-var KEY_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-var VariablesConfig = {
-  schema: {
-    fields: { type: "array", required: true }
-  },
+var HTTPRequestConfig = {
   defaults: {
-    fields: []
-  },
-  validate(config) {
-    const errors = [];
-    const fields = config.fields ?? [];
-    const seen = new Set;
-    for (const f of fields) {
-      if (!f.key) {
-        errors.push("Each field needs a key.");
-        continue;
-      }
-      if (RESERVED_KEYS.has(f.key)) {
-        errors.push(`"${f.key}" is reserved — pick another key.`);
-        continue;
-      }
-      if (!KEY_PATTERN.test(f.key)) {
-        errors.push(`"${f.key}" is not a valid identifier (letters, digits, underscore; must not start with a digit).`);
-        continue;
-      }
-      if (seen.has(f.key)) {
-        errors.push(`Duplicate key "${f.key}".`);
-        continue;
-      }
-      seen.add(f.key);
-      if (!f.type)
-        errors.push(`"${f.key}" is missing a type.`);
-      if (!f.source)
-        errors.push(`"${f.key}" is missing a source.`);
-    }
-    return { valid: errors.length === 0, errors };
+    apiType: "rest",
+    method: "GET",
+    url: "",
+    queryParams: [],
+    headers: [],
+    bodyType: "json",
+    body: undefined,
+    formData: [],
+    graphqlQuery: "",
+    graphqlVariables: {},
+    auth: { type: "none" },
+    timeout: 30000,
+    failOnError: true,
+    followRedirects: true,
+    retry: { maxAttempts: 1, retryOn: [429, 500, 502, 503, 504], initialDelayMs: 1000, backoffFactor: 2, maxDelayMs: 30000 },
+    pagination: { type: "none" },
+    extract: {},
+    responseType: "json",
+    expectedContentTypes: []
   },
-  computeOutputSchema(fields) {
-    const properties = {};
-    for (const f of fields) {
-      properties[f.key] = fieldToJsonSchema(f);
-    }
-    return { type: "object", properties };
-  }
-};
-function fieldToJsonSchema(f) {
-  const node = { type: f.type };
-  if (f.description)
-    node.description = f.description;
-  if (f.validation?.enum)
-    node.enum = f.validation.enum;
-  return node;
-}
-// src/catalog/utility/debug/config.ts
-var DebugConfig = {
   schema: {
-    mode: { type: "select", required: true, options: ["log", "snapshot", "watch", "assert", "profile"] },
-    label: { type: "string", required: false },
-    pinned: { type: "boolean", required: false },
-    condition: { type: "expression", required: false },
-    sampling: { type: "object", required: false },
-    log: { type: "object", required: false },
-    snapshot: { type: "object", required: false },
-    watch: { type: "object", required: false },
-    assert: { type: "object", required: false },
-    profile: { type: "object", required: false }
-  },
-  defaults: {
-    mode: "log",
-    label: "",
-    log: { level: "info", message: "" }
-  },
-  validate(config) {
-    const errors = [];
-    if (!config.mode)
-      errors.push("Mode is required.");
-    if (!config.label?.trim())
-      errors.push("Label is required.");
-    switch (config.mode) {
-      case "log":
-        if (!config.log?.message?.trim())
-          errors.push("Log mode: message is required.");
-        if (!config.log?.level)
-          errors.push("Log mode: level is required.");
-        break;
-      case "snapshot":
-        break;
-      case "watch":
-        if (!config.watch?.expressions?.length) {
-          errors.push("Watch mode: add at least one expression.");
-        } else {
-          for (const e of config.watch.expressions) {
-            if (!e.label?.trim())
-              errors.push("Watch mode: each expression needs a label.");
-            if (!e.expression?.trim())
-              errors.push("Watch mode: each expression needs an expression string.");
-          }
-        }
-        break;
-      case "assert":
-        if (!config.assert?.predicate?.trim())
-          errors.push("Assert mode: predicate is required.");
-        if (!config.assert?.failureMessage?.trim())
-          errors.push("Assert mode: failure message is required.");
-        break;
-      case "profile":
-        if (!config.profile?.scope)
-          errors.push("Profile mode: scope is required.");
-        break;
+    apiType: { type: "select", required: false, options: ["rest", "graphql"] },
+    baseUrl: { type: "string", required: false },
+    queryParams: { type: "array", required: false },
+    bodyType: { type: "select", required: false, options: ["none", "json", "raw", "form-data", "xml"] },
+    formData: { type: "array", required: false },
+    graphqlQuery: { type: "code", required: false },
+    graphqlVariables: { type: "json", required: false },
+    auth: { type: "object", required: false },
+    failOnError: { type: "boolean", required: false },
+    followRedirects: { type: "boolean", required: false },
+    retry: { type: "object", required: false },
+    pagination: { type: "object", required: false },
+    extract: { type: "object", required: false },
+    responseType: { type: "select", required: false, options: ["json", "text", "binary"] },
+    expectedContentTypes: { type: "array", required: false },
+    method: {
+      type: "select",
+      required: true,
+      options: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
+      description: "HTTP method to use"
+    },
+    url: {
+      type: "url",
+      required: true,
+      description: "The URL to send the request to"
+    },
+    headers: {
+      type: "json",
+      required: false,
+      description: "HTTP headers to send with the request"
+    },
+    body: {
+      type: "json",
+      required: false,
+      description: "Request body (for POST, PUT, PATCH)"
+    },
+    timeout: {
+      type: "number",
+      required: false,
+      description: "Request timeout in milliseconds",
+      min: 1000
     }
-    return { valid: errors.length === 0, errors };
   },
-  migrateLegacyStub(config) {
-    if (config.mode) {
-      const { value: _stub, ...rest } = config;
-      return { ...DebugConfig.defaults, ...rest };
+  validate: (config) => {
+    const errors = [];
+    const apiType = config.apiType ?? "rest";
+    if (apiType === "rest" && !config.method) {
+      errors.push("Method is required");
     }
-    return {
-      mode: "log",
-      label: config.label ?? "Debug",
-      log: {
-        level: "info",
-        message: config.label ?? "Debug",
-        includeInputData: true
+    if (apiType === "graphql" && !config.graphqlQuery?.trim()) {
+      errors.push("GraphQL query is required");
+    }
+    if (!config.url) {
+      errors.push("URL is required");
+    } else if (typeof config.url === "string" && !urlCheckedAtRunTime(config.url, config.connectionId)) {
+      try {
+        new URL(config.url);
+      } catch {
+        errors.push("Invalid URL format");
+      }
+    }
+    if (config.timeout !== undefined && typeof config.timeout === "number") {
+      if (config.timeout < 1000) {
+        errors.push("Timeout must be at least 1000ms");
       }
+    }
+    return {
+      valid: errors.length === 0,
+      errors
     };
   },
-  merge(userConfig) {
-    return { ...DebugConfig.defaults, ...userConfig };
+  merge: (userConfig) => {
+    return {
+      ...HTTPRequestConfig.defaults,
+      ...userConfig
+    };
   },
-  getLabel(config) {
-    return `Debug [${config.mode}]: ${config.label}`;
+  getLabel: (config) => {
+    const type = config.apiType === "graphql" ? "GraphQL" : config.method ?? "GET";
+    return `${type} ${config.url}`;
   }
 };
-// src/catalog/actions/delay/migrate.ts
-var LEGACY_UNITS = new Set([
-  "milliseconds",
-  "seconds",
-  "minutes",
-  "hours"
-]);
-function migrateDelayConfig(raw) {
-  if (raw && typeof raw === "object" && "mode" in raw) {
-    return raw;
-  }
-  const legacy = raw ?? {};
-  const duration = typeof legacy.duration === "number" && Number.isFinite(legacy.duration) ? legacy.duration : 1;
-  const unit = typeof legacy.unit === "string" && LEGACY_UNITS.has(legacy.unit) ? legacy.unit : "milliseconds";
-  return {
-    mode: "fixed",
-    fixed: { duration, unit }
-  };
-}
+
 // src/catalog/communication/email-send/config.ts
 var EmailConfig = {
   defaults: {
@@ -3836,27 +3209,183 @@ var EmailConfig = {
     return { valid: errors.length === 0, errors };
   },
   merge: (userConfig) => {
-    return { ...EmailConfig.defaults, ...userConfig };
+    return { ...EmailConfig.defaults, ...userConfig };
+  },
+  getLabel: (config) => {
+    switch (config.operation) {
+      case "send":
+        return `Email: Send to ${config.to}`;
+      case "read":
+        return `Email: Read from ${config.folder}`;
+      case "search":
+        return `Email: Search "${config.query}"`;
+      case "delete":
+        return `Email: Delete from ${config.folder}`;
+      case "move":
+        return `Email: Move to ${config.folder}`;
+      case "mark_read":
+        return `Email: Mark as read`;
+      default:
+        return `Email: ${config.operation}`;
+    }
+  }
+};
+
+// src/catalog/communication/google-chat/config.ts
+var GoogleChatConfig = {
+  defaults: { connection: "", space: "", spaceName: "", text: "", threadKey: "" },
+  schema: {
+    connection: { type: "connection", required: true },
+    space: { type: "string", required: true },
+    text: { type: "string", required: false },
+    threadKey: { type: "string", required: false }
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.connection)
+      errors.push("Connect a Google Chat account");
+    if (!config.space)
+      errors.push("Pick a space");
+    if (!config.text && !config.message)
+      errors.push("Add a message");
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => ({
+    ...GoogleChatConfig.defaults,
+    ...userConfig
+  }),
+  getLabel: () => "Google Chat"
+};
+
+// src/catalog/communication/slack-message/config.ts
+var SlackMessageConfig = {
+  defaults: { connection: "", messageType: "channel", channel: "", channelName: "", text: "", blocks: undefined },
+  schema: {
+    connection: { type: "connection", required: true },
+    messageType: { type: "string", required: false },
+    channel: { type: "string", required: true },
+    text: { type: "string", required: false },
+    blocks: { type: "json", required: false }
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.connection)
+      errors.push("Slack workspace connection is required");
+    if (!config.channel)
+      errors.push(config.messageType === "user" ? "A user is required" : "A channel is required");
+    const hasText = Boolean(config.text || config.message);
+    const hasBlocks = Array.isArray(config.blocks) && config.blocks.length > 0;
+    if (!hasText && !hasBlocks)
+      errors.push("Add a message or at least one block");
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => {
+    return { ...SlackMessageConfig.defaults, ...userConfig };
+  },
+  getLabel: (config) => {
+    const prefix = config.messageType === "user" ? "@" : "#";
+    return config.channelName ? `Slack: ${prefix}${config.channelName}` : config.channel ? `Slack: ${config.channel}` : "Slack";
+  }
+};
+
+// src/catalog/communication/teams-message/config.ts
+var TeamsMessageConfig = {
+  defaults: { connection: "", teamId: "", teamName: "", channelId: "", channelName: "", title: "", message: "" },
+  schema: {
+    connection: { type: "connection", required: true },
+    teamId: { type: "string", required: true },
+    channelId: { type: "string", required: true },
+    title: { type: "string", required: false },
+    message: { type: "string", required: true }
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.connection)
+      errors.push("Connect a Microsoft Teams account");
+    if (!config.teamId)
+      errors.push("Pick a team");
+    if (!config.channelId)
+      errors.push("Pick a channel");
+    if (!config.message)
+      errors.push("Add a message");
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => {
+    return { ...TeamsMessageConfig.defaults, ...userConfig };
+  },
+  getLabel: (config) => config.channelName ? `Teams: #${config.channelName}` : "Teams"
+};
+
+// src/catalog/communication/webhook-call/config.ts
+var WebhookCallConfig = {
+  defaults: {
+    url: "",
+    method: "POST",
+    payload: {},
+    headers: {}
+  },
+  schema: {
+    url: { type: "url", required: true },
+    method: { type: "select", required: true, options: ["POST", "PUT", "PATCH", "GET"] },
+    payload: { type: "json", required: false },
+    headers: { type: "json", required: false }
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.url)
+      errors.push("Webhook URL is required");
+    if (!config.method)
+      errors.push("HTTP method is required");
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => {
+    return { ...WebhookCallConfig.defaults, ...userConfig };
+  },
+  getLabel: (config) => {
+    return `${config.method}: ${config.url.substring(0, 40)}...`;
+  }
+};
+
+// src/catalog/communication/whatsapp-send/config.ts
+var WhatsappSendConfig = {
+  schema: {
+    connection: { type: "connection", required: true },
+    to: { type: "string", required: true },
+    mode: { type: "select", required: true, options: ["template", "text"] },
+    templateName: { type: "string", required: false },
+    templateLanguage: { type: "string", required: false },
+    templateVariables: { type: "array", required: false },
+    text: { type: "string", required: false },
+    previewUrl: { type: "boolean", required: false }
+  },
+  defaults: {
+    connection: "",
+    to: "",
+    mode: "template",
+    templateLanguage: "en_US",
+    templateVariables: []
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.connection)
+      errors.push("Select a WhatsApp connection");
+    if (!config.to?.trim())
+      errors.push("Recipient phone number is required");
+    if (config.mode === "text") {
+      if (!config.text?.trim())
+        errors.push("Message text is required");
+    } else {
+      if (!config.templateName?.trim())
+        errors.push("Choose an approved template");
+    }
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => {
+    return { ...WhatsappSendConfig.defaults, ...userConfig };
   },
-  getLabel: (config) => {
-    switch (config.operation) {
-      case "send":
-        return `Email: Send to ${config.to}`;
-      case "read":
-        return `Email: Read from ${config.folder}`;
-      case "search":
-        return `Email: Search "${config.query}"`;
-      case "delete":
-        return `Email: Delete from ${config.folder}`;
-      case "move":
-        return `Email: Move to ${config.folder}`;
-      case "mark_read":
-        return `Email: Mark as read`;
-      default:
-        return `Email: ${config.operation}`;
-    }
-  }
+  getLabel: (config) => config.mode === "text" ? `WhatsApp to ${config.to || "—"}` : `WhatsApp template "${config.templateName || "—"}" to ${config.to || "—"}`
 };
+
 // src/catalog/general/transform/config.ts
 var TRANSFORM_MODES = ["visual", "expression"];
 var TRANSFORM_OPERATIONS = [
@@ -4014,6 +3543,7 @@ var TransformConfig = {
     return `map_${Date.now()}_${randomSuffix(5)}`;
   }
 };
+
 // src/catalog/general/aggregate/config.ts
 var AGGREGATE_FUNCTIONS = [
   "sum",
@@ -4035,8 +3565,8 @@ var AGGREGATE_FUNCTION_DESCRIPTIONS = {
   first: "the field's value on the first record",
   last: "the field's value on the last record"
 };
-var RESERVED_KEYS2 = new Set(["_meta", "_lineage", "_redacted", "_error"]);
-var KEY_PATTERN2 = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+var RESERVED_KEYS = new Set(["_meta", "_lineage", "_redacted", "_error"]);
+var KEY_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 var NUMBER_VALUED = new Set(["sum", "avg", "count", "count_distinct"]);
 function groupKeyName(path) {
   const trimmed = String(path ?? "").trim().replace(/\[\]$/, "");
@@ -4088,430 +3618,492 @@ var AggregateConfig = {
       required: true,
       description: 'What to compute, at least one: [{ "fn", "field", "as", "decimals"? }]. ' + `fn is one of ${FUNCTION_LIST} (` + AGGREGATE_FUNCTIONS.map((fn) => `${fn}: ${AGGREGATE_FUNCTION_DESCRIPTIONS[fn]}`).join("; ") + "). field is the record key it reads (a dot-path; count may omit it to count records). " + "as is the output key. decimals rounds a sum or avg. " + 'Example: [{ "fn": "sum", "field": "Balance", "as": "TotalAmount", "decimals": 2 }, { "fn": "count", "as": "Invoices" }]'
     },
-    outputAs: {
-      type: "string",
+    outputAs: {
+      type: "string",
+      required: false,
+      description: "The name later steps use for this result, e.g. totals → {{totals[].TotalAmount}} in a Transform mapping. " + "A message or AI prompt reads it as {{ods://steps/<this step id>/output/data[0]/TotalAmount}} — the mapping form is not resolved there. " + "Defaults to the step name."
+    }
+  },
+  defaults: {
+    arrayPath: "",
+    groupBy: [],
+    metrics: [],
+    outputAs: ""
+  },
+  validate(config) {
+    const errors = [];
+    const metrics = Array.isArray(config.metrics) ? config.metrics : [];
+    if (metrics.length === 0) {
+      errors.push('Add at least one metric — what to compute, e.g. { "fn": "sum", "field": "Balance", "as": "TotalAmount" }.');
+    }
+    const groupKeys = [];
+    const groupBy = config.groupBy;
+    if (groupBy !== undefined && groupBy !== null) {
+      if (!Array.isArray(groupBy)) {
+        errors.push('groupBy must be a list of record fields (dot-paths), e.g. ["CustomerRef.name"].');
+      } else {
+        for (const g of groupBy) {
+          if (typeof g !== "string" || g.trim() === "") {
+            errors.push("groupBy has an empty entry — each one is a record field (dot-path).");
+            continue;
+          }
+          groupKeys.push(groupKeyName(g));
+        }
+      }
+    }
+    const seen = new Set;
+    for (const key of groupKeys) {
+      if (seen.has(key)) {
+        errors.push(`Two group-by fields both land under "${key}" — group by fields whose last segment differs.`);
+      }
+      seen.add(key);
+    }
+    metrics.forEach((m, i) => {
+      const where = m && typeof m === "object" && typeof m.as === "string" && m.as ? `"${m.as}"` : `metric ${i + 1}`;
+      if (!m || typeof m !== "object") {
+        errors.push(`${where}: a metric is an object { "fn", "field", "as" }.`);
+        return;
+      }
+      const fn = m.fn;
+      const fnValid = isOneOf(AGGREGATE_FUNCTIONS, fn);
+      if (fn === undefined || fn === null || fn === "") {
+        errors.push(`${where}: fn is required — one of ${FUNCTION_LIST}.`);
+      } else if (!fnValid) {
+        errors.push(`${where}: fn must be one of: ${FUNCTION_LIST} (got "${String(fn)}").`);
+      }
+      const field = m.field;
+      if (field !== undefined && field !== null && typeof field !== "string") {
+        errors.push(`${where}: field must be a string — a dot-path on the record, e.g. "Balance".`);
+      } else if (fnValid && fn !== "count" && (typeof field !== "string" || field.trim() === "")) {
+        errors.push(`${where}: ${fn} needs a field — the record key it reads, e.g. "Balance".`);
+      }
+      const as = m.as;
+      if (typeof as !== "string" || as === "") {
+        errors.push(`${where}: as is required — the output key the value lands under, e.g. "TotalAmount".`);
+      } else if (RESERVED_KEYS.has(as)) {
+        errors.push(`"${as}" is reserved — pick another output key.`);
+      } else if (!KEY_PATTERN.test(as)) {
+        errors.push(`"${as}" is not a valid output key (letters, digits, underscore; must not start with a digit).`);
+      } else if (seen.has(as)) {
+        errors.push(`Duplicate output key "${as}" — every metric and group-by key lands under its own name.`);
+      } else {
+        seen.add(as);
+      }
+      const decimals = m.decimals;
+      if (decimals !== undefined && decimals !== null) {
+        if (typeof decimals !== "number" || !Number.isInteger(decimals) || decimals < 0 || decimals > 10) {
+          errors.push(`${where}: decimals must be a whole number from 0 to 10.`);
+        }
+      }
+    });
+    const outputAs = config.outputAs;
+    if (outputAs !== undefined && outputAs !== null && outputAs !== "") {
+      if (typeof outputAs !== "string" || !KEY_PATTERN.test(outputAs)) {
+        errors.push('outputAs must be a single name (letters, digits, underscore), e.g. "totals" — later steps read {{totals[].<key>}}.');
+      }
+    }
+    const arrayPath = config.arrayPath;
+    if (arrayPath !== undefined && arrayPath !== null && typeof arrayPath !== "string") {
+      errors.push("arrayPath must be a string — a path to an array in the upstream output, or empty for its records.");
+    }
+    return { valid: errors.length === 0, errors };
+  },
+  computeOutputSchema(config, source) {
+    const properties = {};
+    for (const g of Array.isArray(config.groupBy) ? config.groupBy : []) {
+      if (typeof g !== "string" || g.trim() === "")
+        continue;
+      properties[groupKeyName(g)] = { ...leafOf(schemaAt(source, g), "string"), description: `group: ${g}` };
+    }
+    for (const m of Array.isArray(config.metrics) ? config.metrics : []) {
+      if (!m || typeof m !== "object" || typeof m.as !== "string" || !m.as || !isOneOf(AGGREGATE_FUNCTIONS, m.fn))
+        continue;
+      properties[m.as] = metricSchema(m, source);
+    }
+    return { type: "object", properties };
+  },
+  merge(userConfig) {
+    return { ...AggregateConfig.defaults, ...userConfig };
+  },
+  getLabel(config) {
+    const metrics = Array.isArray(config.metrics) ? config.metrics : [];
+    const parts = metrics.filter((m) => m && typeof m === "object" && m.fn).map((m) => m.field ? `${m.fn}(${m.field})` : String(m.fn));
+    const by = Array.isArray(config.groupBy) && config.groupBy.length > 0 ? ` by ${config.groupBy.map(groupKeyName).join(", ")}` : "";
+    return parts.length > 0 ? `${parts.join(", ")}${by}` : "Aggregate";
+  }
+};
+
+// src/catalog/logic/condition/config.ts
+var CONDITION_OPERATORS = [
+  { id: "equals", label: "Equals", needsValue: true },
+  { id: "not_equals", label: "Not Equals", needsValue: true },
+  { id: "greater_than", label: "Greater Than", needsValue: true },
+  { id: "greater_than_equals", label: "Greater Than or Equals", needsValue: true },
+  { id: "less_than", label: "Less Than", needsValue: true },
+  { id: "less_than_equals", label: "Less Than or Equals", needsValue: true },
+  { id: "like", label: "Like", needsValue: true },
+  { id: "contains", label: "Contains", needsValue: true },
+  { id: "starts_with", label: "Starts With", needsValue: true },
+  { id: "ends_with", label: "Ends With", needsValue: true },
+  { id: "is_null", label: "Is Null", needsValue: false },
+  { id: "is_not_null", label: "Is Not Null", needsValue: false },
+  { id: "is_empty", label: "Is Empty", needsValue: false }
+];
+function isMissingValue(value) {
+  return value === undefined || value === null || value === "";
+}
+var ConditionConfig = {
+  defaults: {
+    mode: "visual",
+    filters: [],
+    condition: ""
+  },
+  schema: {
+    mode: { type: "select", required: true, options: ["visual", "expression"] },
+    filters: { type: "array", required: false },
+    condition: { type: "expression", required: false }
+  },
+  validate: (config) => {
+    const errors = [];
+    if (config.mode === "expression") {
+      if (!config.condition) {
+        errors.push("Condition expression is required");
+      } else {
+        try {
+          new Function(`return ${config.condition}`);
+        } catch (e) {
+          errors.push(`Invalid expression: ${e instanceof Error ? e.message : "Unknown error"}`);
+        }
+      }
+    } else {
+      if (!config.filters || config.filters.length === 0) {
+        errors.push("At least one condition filter is required");
+      } else {
+        config.filters.forEach((f, i) => {
+          if (!f.field)
+            errors.push(`Filter ${i + 1}: Field is required`);
+          if (!f.operator)
+            errors.push(`Filter ${i + 1}: Operator is required`);
+          const opDef = CONDITION_OPERATORS.find((o) => o.id === f.operator);
+          if (opDef?.needsValue && isMissingValue(f.value)) {
+            errors.push(`Filter ${i + 1}: Value is required`);
+          }
+        });
+      }
+    }
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => {
+    return { ...ConditionConfig.defaults, ...userConfig };
+  },
+  generateName: (filters) => {
+    if (filters.length === 0)
+      return "If …";
+    const parts = filters.map((f, i) => {
+      const opLabel = CONDITION_OPERATORS.find((o) => o.id === f.operator)?.label || f.operator;
+      const base = `${f.field || "?"} ${opLabel}${f.value ? ` ${f.value}` : ""}`;
+      if (i === 0)
+        return base;
+      return `${(f.logicalOperator || "and").toUpperCase()} ${base}`;
+    });
+    return `If ${parts.join(" ")}`;
+  },
+  getLabel: (config) => {
+    if (config.mode === "expression")
+      return `If ${config.condition || "…"}`;
+    return ConditionConfig.generateName(config.filters);
+  },
+  createFilterId: () => `cond_${Date.now()}_${randomSuffix(5)}`
+};
+
+// src/catalog/logic/for-each/config.ts
+var SOURCELESS_MODES = new Set(["range", "cursor", "while"]);
+var ForEachConfig = {
+  defaults: {
+    arrayPath: "",
+    iterationMode: "records",
+    itemVariable: "item",
+    indexVariable: "index",
+    batchSize: 0,
+    continueOnError: false,
+    concurrency: "sequential",
+    collect: "array"
+  },
+  schema: {
+    arrayPath: {
+      type: "select",
+      required: false,
+      dynamic: true,
+      description: "A path to an array in the upstream step's output (the Query's object name, or a field holding a list) — the values come from that step's data, not from the catalog"
+    },
+    iterationMode: {
+      type: "select",
+      required: false,
+      options: ["records", "fields", "range", "nested", "batch", "cursor", "while", "array"],
+      description: "What one iteration is: records (one per record, the default; array is its legacy alias), fields, range, nested, batch, cursor or while"
+    },
+    itemVariable: { type: "string", required: true },
+    indexVariable: { type: "string", required: false },
+    batchSize: { type: "number", required: false },
+    continueOnError: { type: "boolean", required: false },
+    collect: {
+      type: "select",
       required: false,
-      description: "The name later steps use for this result, e.g. totals → {{totals[].TotalAmount}} in a Transform mapping. " + "A message or AI prompt reads it as {{ods://steps/<this step id>/output/data[0]/TotalAmount}} — the mapping form is not resolved there. " + "Defaults to the step name."
+      options: ["array", "none", "groupBy", "reduce", "rows"],
+      description: "What the Done port carries besides the counts: array (each iteration's result in `results`, the default), none, groupBy (by groupByPath), " + "reduce (reduceOp over reducePath), or rows — also `data`: every row the body produced (each iteration's Query/Transform rows, else its result), " + "so ONE step on the Done port maps and writes them all instead of a write per iteration."
     }
   },
-  defaults: {
-    arrayPath: "",
-    groupBy: [],
-    metrics: [],
-    outputAs: ""
-  },
-  validate(config) {
+  validate: (config) => {
     const errors = [];
-    const metrics = Array.isArray(config.metrics) ? config.metrics : [];
-    if (metrics.length === 0) {
-      errors.push('Add at least one metric — what to compute, e.g. { "fn": "sum", "field": "Balance", "as": "TotalAmount" }.');
-    }
-    const groupKeys = [];
-    const groupBy = config.groupBy;
-    if (groupBy !== undefined && groupBy !== null) {
-      if (!Array.isArray(groupBy)) {
-        errors.push('groupBy must be a list of record fields (dot-paths), e.g. ["CustomerRef.name"].');
-      } else {
-        for (const g of groupBy) {
-          if (typeof g !== "string" || g.trim() === "") {
-            errors.push("groupBy has an empty entry — each one is a record field (dot-path).");
-            continue;
-          }
-          groupKeys.push(groupKeyName(g));
-        }
+    const mode = config.iterationMode || "records";
+    if (mode === "range") {
+      if (!config.count || config.count <= 0) {
+        errors.push("Range mode needs a positive iteration count");
       }
-    }
-    const seen = new Set;
-    for (const key of groupKeys) {
-      if (seen.has(key)) {
-        errors.push(`Two group-by fields both land under "${key}" — group by fields whose last segment differs.`);
+    } else if (mode === "nested") {
+      if (!config.arrayPath)
+        errors.push("Select the records to drill into");
+      if (!config.nestedPath)
+        errors.push('Nested mode needs the sub-array path to iterate (e.g. "lineItems")');
+    } else if (!SOURCELESS_MODES.has(mode)) {
+      if (!config.arrayPath) {
+        errors.push("Array path is required — select which records to iterate over");
       }
-      seen.add(key);
     }
-    metrics.forEach((m, i) => {
-      const where = m && typeof m === "object" && typeof m.as === "string" && m.as ? `"${m.as}"` : `metric ${i + 1}`;
-      if (!m || typeof m !== "object") {
-        errors.push(`${where}: a metric is an object { "fn", "field", "as" }.`);
-        return;
-      }
-      const fn = m.fn;
-      const fnValid = isOneOf(AGGREGATE_FUNCTIONS, fn);
-      if (fn === undefined || fn === null || fn === "") {
-        errors.push(`${where}: fn is required — one of ${FUNCTION_LIST}.`);
-      } else if (!fnValid) {
-        errors.push(`${where}: fn must be one of: ${FUNCTION_LIST} (got "${String(fn)}").`);
-      }
-      const field = m.field;
-      if (field !== undefined && field !== null && typeof field !== "string") {
-        errors.push(`${where}: field must be a string — a dot-path on the record, e.g. "Balance".`);
-      } else if (fnValid && fn !== "count" && (typeof field !== "string" || field.trim() === "")) {
-        errors.push(`${where}: ${fn} needs a field — the record key it reads, e.g. "Balance".`);
-      }
-      const as = m.as;
-      if (typeof as !== "string" || as === "") {
-        errors.push(`${where}: as is required — the output key the value lands under, e.g. "TotalAmount".`);
-      } else if (RESERVED_KEYS2.has(as)) {
-        errors.push(`"${as}" is reserved — pick another output key.`);
-      } else if (!KEY_PATTERN2.test(as)) {
-        errors.push(`"${as}" is not a valid output key (letters, digits, underscore; must not start with a digit).`);
-      } else if (seen.has(as)) {
-        errors.push(`Duplicate output key "${as}" — every metric and group-by key lands under its own name.`);
-      } else {
-        seen.add(as);
-      }
-      const decimals = m.decimals;
-      if (decimals !== undefined && decimals !== null) {
-        if (typeof decimals !== "number" || !Number.isInteger(decimals) || decimals < 0 || decimals > 10) {
-          errors.push(`${where}: decimals must be a whole number from 0 to 10.`);
-        }
-      }
-    });
-    const outputAs = config.outputAs;
-    if (outputAs !== undefined && outputAs !== null && outputAs !== "") {
-      if (typeof outputAs !== "string" || !KEY_PATTERN2.test(outputAs)) {
-        errors.push('outputAs must be a single name (letters, digits, underscore), e.g. "totals" — later steps read {{totals[].<key>}}.');
-      }
+    if (config.concurrency === "parallel" && config.maxConcurrency !== undefined && config.maxConcurrency < 1) {
+      errors.push("Max concurrency must be at least 1");
     }
-    const arrayPath = config.arrayPath;
-    if (arrayPath !== undefined && arrayPath !== null && typeof arrayPath !== "string") {
-      errors.push("arrayPath must be a string — a path to an array in the upstream output, or empty for its records.");
+    if (config.batchSize !== undefined && config.batchSize < 0) {
+      errors.push("Batch size must be 0 (all) or a positive number");
+    }
+    if (config.collect === "groupBy" && !config.groupByPath) {
+      errors.push("Group-by collection needs a field path to group on");
     }
     return { valid: errors.length === 0, errors };
   },
-  computeOutputSchema(config, source) {
-    const properties = {};
-    for (const g of Array.isArray(config.groupBy) ? config.groupBy : []) {
-      if (typeof g !== "string" || g.trim() === "")
-        continue;
-      properties[groupKeyName(g)] = { ...leafOf(schemaAt(source, g), "string"), description: `group: ${g}` };
-    }
-    for (const m of Array.isArray(config.metrics) ? config.metrics : []) {
-      if (!m || typeof m !== "object" || typeof m.as !== "string" || !m.as || !isOneOf(AGGREGATE_FUNCTIONS, m.fn))
-        continue;
-      properties[m.as] = metricSchema(m, source);
-    }
-    return { type: "object", properties };
+  merge: (userConfig) => {
+    return { ...ForEachConfig.defaults, ...userConfig };
   },
-  merge(userConfig) {
-    return { ...AggregateConfig.defaults, ...userConfig };
+  getLabel: (config) => {
+    const mode = config.iterationMode || "records";
+    if (mode === "range")
+      return `ForEach ×${config.count ?? "…"}`;
+    if (mode === "cursor")
+      return "ForEach (paginate)";
+    if (mode === "while")
+      return "ForEach (while)";
+    return `ForEach in ${config.arrayPath || "…"}`;
   },
-  getLabel(config) {
-    const metrics = Array.isArray(config.metrics) ? config.metrics : [];
-    const parts = metrics.filter((m) => m && typeof m === "object" && m.fn).map((m) => m.field ? `${m.fn}(${m.field})` : String(m.fn));
-    const by = Array.isArray(config.groupBy) && config.groupBy.length > 0 ? ` by ${config.groupBy.map(groupKeyName).join(", ")}` : "";
-    return parts.length > 0 ? `${parts.join(", ")}${by}` : "Aggregate";
+  generateName: (arrayPath) => {
+    return `ForEach in ${arrayPath || "…"}`;
   }
 };
-// src/catalog/logic/for-each/recordSchema.ts
-function resolveSchemaPath(root, path) {
-  if (!root)
-    return;
-  const parts = path.split(".").filter(Boolean);
-  let cur = root;
-  for (const part of parts) {
-    if (cur?.type === "object" && cur.properties && part in cur.properties) {
-      cur = cur.properties[part];
-      continue;
-    }
-    if (cur?.type === "array" && cur.items?.properties && part in cur.items.properties) {
-      cur = cur.items.properties[part];
-      continue;
-    }
-    return;
-  }
-  if (cur?.type === "array" && cur.items)
-    return cur.items;
-  if (cur?.type === "object" && cur.properties)
-    return cur;
-  return;
-}
-function resolveSamplePath(sample, path) {
-  const parts = path.split(".").filter(Boolean);
-  let cur = sample;
-  for (const part of parts) {
-    if (cur === null || cur === undefined)
-      return;
-    if (Array.isArray(cur)) {
-      if (cur.length === 0 || typeof cur[0] !== "object" || cur[0] === null)
-        return;
-      cur = cur[0][part];
-      continue;
-    }
-    if (typeof cur === "object") {
-      cur = cur[part];
-      continue;
-    }
-    return;
-  }
-  return cur;
-}
-function sampleRecords(node) {
-  const output = node?.executionData?.output;
-  if (!output)
-    return null;
-  if (Array.isArray(output))
-    return output;
-  const data = output.data;
-  return Array.isArray(data) ? data : null;
-}
-var isRootPath = (path) => path === "" || path === "data";
-function resolveRecordSchema(upstreamNodes, arrayPath) {
-  const node = upstreamNodes?.[0];
-  if (!node)
-    return;
-  const path = (arrayPath || "").trim();
-  const isRoot = isRootPath(path);
-  const schema = node.outputSchema || node.config?._outputSchema;
-  if (schema?.properties) {
-    if (isRoot) {
-      const hasDeepFields = Object.values(schema.properties).some((f) => f?.properties || f?.items);
-      if (hasDeepFields)
-        return schema;
-    } else {
-      const resolved = resolveSchemaPath(schema, path);
-      if (resolved)
-        return resolved;
-    }
-  }
-  const records = sampleRecords(node);
-  if (records && records.length > 0 && typeof records[0] === "object" && records[0] !== null) {
-    const sample = records[0];
-    if (isRoot)
-      return inferSchemaFromSample(sample);
-    const resolved = resolveSamplePath(sample, path);
-    if (Array.isArray(resolved) && resolved.length > 0 && typeof resolved[0] === "object" && resolved[0] !== null) {
-      return inferSchemaFromSample(resolved[0]);
-    }
-    if (resolved && typeof resolved === "object" && !Array.isArray(resolved)) {
-      return inferSchemaFromSample(resolved);
-    }
-    if (!path.includes("."))
-      return inferSchemaFromSample(sample);
-  }
-  return schema?.properties ? schema : undefined;
-}
-function detectRecordFields(upstreamNodes, arrayPath) {
-  const set = new Set;
-  const props = resolveRecordSchema(upstreamNodes, arrayPath)?.properties;
-  if (props && typeof props === "object")
-    for (const k of Object.keys(props))
-      set.add(k);
-  const records = sampleRecords(upstreamNodes?.[0]);
-  if (records) {
-    const path = (arrayPath || "").trim();
-    const addKeys = (v) => {
-      if (v && typeof v === "object" && !Array.isArray(v))
-        for (const k of Object.keys(v))
-          set.add(k);
-    };
-    for (const r of records.slice(0, 25)) {
-      if (isRootPath(path)) {
-        addKeys(r);
-        continue;
+
+// src/catalog/triggers/schedule-trigger/config.ts
+var ScheduleTriggerConfig = {
+  defaults: {
+    scheduleType: "interval",
+    interval: 60,
+    intervalUnit: "minutes",
+    timezone: "UTC"
+  },
+  schema: {
+    scheduleType: { type: "select", required: true, options: ["interval", "cron", "specific"] },
+    interval: { type: "number", required: false, min: 1 },
+    intervalUnit: { type: "select", required: false, options: ["minutes", "hours", "days", "weeks"] },
+    cronExpression: { type: "string", required: false },
+    timezone: { type: "string", required: false }
+  },
+  validate: (config) => {
+    const errors = [];
+    if (!config.scheduleType) {
+      errors.push("Schedule type is required");
+    }
+    if (config.scheduleType === "interval") {
+      if (!config.interval || config.interval < 1) {
+        errors.push("Interval must be at least 1");
       }
-      const at = resolveSamplePath(r, path);
-      if (Array.isArray(at))
-        for (const item of at.slice(0, 25))
-          addKeys(item);
-      else if (at && typeof at === "object")
-        addKeys(at);
-      else if (!path.includes("."))
-        addKeys(r);
     }
-  }
-  return Array.from(set);
-}
-// src/catalog/storage/storageCapabilities.ts
-var contentTypeField = {
-  key: "contentType",
-  label: "Content type",
-  type: "string",
-  placeholder: "application/octet-stream",
-  advanced: true,
-  hint: "MIME type for the uploaded file."
-};
-var STORAGE_PROVIDERS = {
-  aws_s3: {
-    connectorId: "aws_s3",
-    label: "Amazon S3",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "prefix", label: "Folder", selectMode: "folder" }, fields: [{ key: "maxKeys", label: "Max results", type: "number", defaultValue: 100, advanced: true }] },
-      { value: "download", label: "Download file", path: { key: "key", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "key", label: "Destination key", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
-      { value: "delete", label: "Delete file", path: { key: "key", label: "File", selectMode: "both", required: true } },
-      { value: "copy", label: "Copy file", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
-      { value: "move", label: "Move / rename", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
-      { value: "presign", label: "Get signed URL", path: { key: "key", label: "File", selectMode: "both", required: true }, fields: [{ key: "expiresIn", label: "Expiry (seconds)", type: "number", defaultValue: 3600, advanced: true }] }
-    ]
+    if (config.scheduleType === "cron" && !config.cronExpression) {
+      errors.push("Cron expression is required");
+    }
+    return { valid: errors.length === 0, errors };
   },
-  ftp_sftp: {
-    connectorId: "ftp_sftp",
-    label: "FTP / SFTP",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "remotePath", label: "Folder", selectMode: "folder" } },
-      { value: "download", label: "Download file", path: { key: "remotePath", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "remotePath", label: "Destination path", selectMode: "both", required: true }, content: true },
-      { value: "delete", label: "Delete file", path: { key: "remotePath", label: "File", selectMode: "both", required: true } },
-      { value: "move", label: "Move / rename", path: { key: "remotePath", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } }
-    ]
+  merge: (userConfig) => {
+    return { ...ScheduleTriggerConfig.defaults, ...userConfig };
   },
-  dropbox: {
-    connectorId: "dropbox",
-    label: "Dropbox",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "path", label: "Folder", selectMode: "folder" } },
-      { value: "download", label: "Download file", path: { key: "path", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "path", label: "Destination path", selectMode: "both", required: true }, content: true, fields: [{ key: "mode", label: "Write mode", type: "select", options: [{ label: "Overwrite", value: "overwrite" }, { label: "Add (keep both)", value: "add" }], defaultValue: "overwrite", advanced: true }] },
-      { value: "delete", label: "Delete file", path: { key: "path", label: "File", selectMode: "both", required: true } },
-      { value: "copy", label: "Copy file", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } },
-      { value: "move", label: "Move / rename", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } }
-    ]
+  getLabel: (config) => {
+    if (config.scheduleType === "interval") {
+      return `Every ${config.interval} ${config.intervalUnit}`;
+    }
+    return `Schedule: ${config.scheduleType}`;
+  }
+};
+
+// src/catalog/triggers/webhook-trigger/config.ts
+var WebhookTriggerConfig = {
+  defaults: {
+    method: "POST",
+    requireAuth: true
   },
-  onedrive: {
-    connectorId: "onedrive",
-    label: "OneDrive",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "path", label: "Folder", selectMode: "folder" } },
-      { value: "download", label: "Download file", path: { key: "path", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "path", label: "Destination path", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
-      { value: "delete", label: "Delete file", path: { key: "path", label: "File", selectMode: "both", required: true } },
-      { value: "copy", label: "Copy file", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } },
-      { value: "move", label: "Move / rename", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } }
-    ]
+  schema: {
+    webhookPath: { type: "string", required: false },
+    method: { type: "select", required: true, options: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
+    requireAuth: { type: "boolean", required: false }
   },
-  google_drive: {
-    connectorId: "google_drive",
-    label: "Google Drive",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "folderId", label: "Folder", selectMode: "folder" }, fields: [{ key: "query", label: "Search query", type: "string", advanced: true }, { key: "pageSize", label: "Max results", type: "number", defaultValue: 50, advanced: true }] },
-      { value: "download", label: "Download file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
-      {
-        value: "upload",
-        label: "Upload file",
-        path: { key: "folderId", label: "Destination folder", selectMode: "both" },
-        content: true,
-        fields: [
-          { key: "fileName", label: "File name", type: "string", required: true },
-          { key: "folderName", label: "Folder path", type: "string", advanced: true, placeholder: "Reports/2026", hint: "Folders under My Drive, separated by /. Missing ones are created on the first run. Ignored when a destination folder is picked." },
-          { key: "ifExists", label: "If the file already exists", type: "select", options: [{ label: "Replace it (Drive keeps the versions)", value: "overwrite" }, { label: "Skip it", value: "skip" }, { label: "Keep both (rename)", value: "rename" }], defaultValue: "overwrite", advanced: true },
-          { key: "mimeType", label: "Content type", type: "string", advanced: true }
-        ]
-      },
-      { value: "delete", label: "Delete file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
-      { value: "move", label: "Move", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both", required: true } },
-      { value: "copy", label: "Copy", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both" }, fields: [{ key: "fileName", label: "New name", type: "string" }] },
-      { value: "share", label: "Share", path: { key: "fileId", label: "File", selectMode: "both", required: true }, fields: [{ key: "shareEmail", label: "Share with (email)", type: "string", required: true }, { key: "shareRole", label: "Role", type: "select", options: [{ label: "Viewer", value: "reader" }, { label: "Editor", value: "writer" }], defaultValue: "reader" }] },
-      { value: "create_folder", label: "Create folder", path: { key: "folderId", label: "Parent folder", selectMode: "both" }, fields: [{ key: "fileName", label: "Folder name", type: "string", required: true }] }
-    ]
+  validate: (config) => {
+    const errors = [];
+    if (!config.method) {
+      errors.push("HTTP method is required");
+    }
+    return { valid: errors.length === 0, errors };
   },
-  gcs: {
-    connectorId: "gcs",
-    label: "Google Cloud Storage",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "prefix", label: "Folder", selectMode: "folder" }, fields: [{ key: "maxKeys", label: "Max results", type: "number", defaultValue: 100, advanced: true }] },
-      { value: "download", label: "Download file", path: { key: "key", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "key", label: "Destination key", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
-      { value: "delete", label: "Delete file", path: { key: "key", label: "File", selectMode: "both", required: true } },
-      { value: "copy", label: "Copy file", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
-      { value: "move", label: "Move / rename", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
-      { value: "presign", label: "Get signed URL", path: { key: "key", label: "File", selectMode: "both", required: true }, fields: [{ key: "expiresIn", label: "Expiry (seconds)", type: "number", defaultValue: 3600, advanced: true }] }
-    ]
+  merge: (userConfig) => {
+    return { ...WebhookTriggerConfig.defaults, ...userConfig };
   },
-  azure_blob: {
-    connectorId: "azure_blob",
-    label: "Azure Blob Storage",
-    browse: true,
-    operations: [
-      { value: "list", label: "List files", path: { key: "prefix", label: "Folder", selectMode: "folder" }, fields: [{ key: "maxKeys", label: "Max results", type: "number", defaultValue: 100, advanced: true }] },
-      { value: "download", label: "Download file", path: { key: "blob", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "blob", label: "Destination blob", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
-      { value: "delete", label: "Delete file", path: { key: "blob", label: "File", selectMode: "both", required: true } },
-      { value: "copy", label: "Copy file", path: { key: "blob", label: "Source blob", selectMode: "both", required: true }, dest: { key: "destBlob", label: "Destination blob", selectMode: "both", required: true } },
-      { value: "move", label: "Move / rename", path: { key: "blob", label: "Source blob", selectMode: "both", required: true }, dest: { key: "destBlob", label: "Destination blob", selectMode: "both", required: true } },
-      { value: "presign", label: "Get signed URL", path: { key: "blob", label: "File", selectMode: "both", required: true }, fields: [{ key: "expiresIn", label: "Expiry (seconds)", type: "number", defaultValue: 3600, advanced: true }] }
-    ]
+  getLabel: (config) => {
+    return `Webhook ${config.method}${config.webhookPath ? ` ${config.webhookPath}` : ""}`;
   }
 };
-STORAGE_PROVIDERS.google_sheets = { ...STORAGE_PROVIDERS.google_drive, connectorId: "google_sheets" };
-var transferOp = {
-  value: "transfer",
-  label: "Transfer to another connector",
-  path: { key: "path", label: "Source file or folder", selectMode: "both", required: true }
-};
-for (const id of ["aws_s3", "ftp_sftp", "dropbox", "onedrive", "google_drive", "gcs", "azure_blob"]) {
-  STORAGE_PROVIDERS[id].operations.push(transferOp);
-}
-var syncOp = {
-  value: "sync",
-  label: "Sync folder to another connector",
-  path: { key: "path", label: "Source folder", selectMode: "both", required: true },
-  fields: [
-    {
-      key: "ifExists",
-      label: "If a file already exists",
-      type: "select",
-      options: [
-        { label: "Overwrite", value: "overwrite" },
-        { label: "Skip it", value: "skip" },
-        { label: "Keep both (rename)", value: "rename" }
-      ],
-      defaultValue: "overwrite",
-      hint: "What to do when the destination already has the file."
-    },
-    {
-      key: "onError",
-      label: "On file error",
-      type: "select",
-      options: [
-        { label: "Stop the sync", value: "abort" },
-        { label: "Skip the file & continue", value: "skip" }
-      ],
-      defaultValue: "abort",
-      hint: "A bad file (timeout, lock, permission) stops the whole sync, or is skipped."
+
+// src/catalog/utility/debug/config.ts
+var DebugConfig = {
+  schema: {
+    mode: { type: "select", required: true, options: ["log", "snapshot", "watch", "assert", "profile"] },
+    label: { type: "string", required: false },
+    pinned: { type: "boolean", required: false },
+    condition: { type: "expression", required: false },
+    sampling: { type: "object", required: false },
+    log: { type: "object", required: false },
+    snapshot: { type: "object", required: false },
+    watch: { type: "object", required: false },
+    assert: { type: "object", required: false },
+    profile: { type: "object", required: false }
+  },
+  defaults: {
+    mode: "log",
+    label: "",
+    log: { level: "info", message: "" }
+  },
+  validate(config) {
+    const errors = [];
+    if (!config.mode)
+      errors.push("Mode is required.");
+    if (!config.label?.trim())
+      errors.push("Label is required.");
+    switch (config.mode) {
+      case "log":
+        if (!config.log?.message?.trim())
+          errors.push("Log mode: message is required.");
+        if (!config.log?.level)
+          errors.push("Log mode: level is required.");
+        break;
+      case "snapshot":
+        break;
+      case "watch":
+        if (!config.watch?.expressions?.length) {
+          errors.push("Watch mode: add at least one expression.");
+        } else {
+          for (const e of config.watch.expressions) {
+            if (!e.label?.trim())
+              errors.push("Watch mode: each expression needs a label.");
+            if (!e.expression?.trim())
+              errors.push("Watch mode: each expression needs an expression string.");
+          }
+        }
+        break;
+      case "assert":
+        if (!config.assert?.predicate?.trim())
+          errors.push("Assert mode: predicate is required.");
+        if (!config.assert?.failureMessage?.trim())
+          errors.push("Assert mode: failure message is required.");
+        break;
+      case "profile":
+        if (!config.profile?.scope)
+          errors.push("Profile mode: scope is required.");
+        break;
     }
-  ]
+    return { valid: errors.length === 0, errors };
+  },
+  migrateLegacyStub(config) {
+    if (config.mode) {
+      const { value: _stub, ...rest } = config;
+      return { ...DebugConfig.defaults, ...rest };
+    }
+    return {
+      mode: "log",
+      label: config.label ?? "Debug",
+      log: {
+        level: "info",
+        message: config.label ?? "Debug",
+        includeInputData: true
+      }
+    };
+  },
+  merge(userConfig) {
+    return { ...DebugConfig.defaults, ...userConfig };
+  },
+  getLabel(config) {
+    return `Debug [${config.mode}]: ${config.label}`;
+  }
 };
-for (const id of ["aws_s3", "ftp_sftp", "dropbox", "onedrive", "google_drive", "gcs", "azure_blob"]) {
-  STORAGE_PROVIDERS[id].operations.push(syncOp);
-}
-var STORAGE_CONNECTOR_IDS = Object.keys(STORAGE_PROVIDERS).filter((id) => id !== "google_sheets");
-function getStorageProvider(connectorId) {
-  if (!connectorId)
-    return;
-  return STORAGE_PROVIDERS[connectorId] ?? STORAGE_PROVIDERS[connectorId.replace(/-/g, "_")];
-}
-function storageConfigKeys() {
-  const keys = new Set([
-    "operation",
-    "connector",
-    "content",
-    "outputAs",
-    "path",
-    "destPath",
-    "destConnector",
-    "sourceIsDirectory",
-    "cursor",
-    "fileBudget",
-    "timeBudgetMs"
-  ]);
-  for (const provider of Object.values(STORAGE_PROVIDERS)) {
-    for (const op of provider.operations) {
-      if (op.path)
-        keys.add(op.path.key);
-      if (op.dest)
-        keys.add(op.dest.key);
-      for (const f of op.fields ?? [])
-        keys.add(f.key);
+
+// src/catalog/utility/variables/config.ts
+var RESERVED_KEYS2 = new Set(["_lineage", "_meta", "_redacted", "_error"]);
+var KEY_PATTERN2 = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+var VariablesConfig = {
+  schema: {
+    fields: { type: "array", required: true }
+  },
+  defaults: {
+    fields: []
+  },
+  validate(config) {
+    const errors = [];
+    const fields = config.fields ?? [];
+    const seen = new Set;
+    for (const f of fields) {
+      if (!f.key) {
+        errors.push("Each field needs a key.");
+        continue;
+      }
+      if (RESERVED_KEYS2.has(f.key)) {
+        errors.push(`"${f.key}" is reserved — pick another key.`);
+        continue;
+      }
+      if (!KEY_PATTERN2.test(f.key)) {
+        errors.push(`"${f.key}" is not a valid identifier (letters, digits, underscore; must not start with a digit).`);
+        continue;
+      }
+      if (seen.has(f.key)) {
+        errors.push(`Duplicate key "${f.key}".`);
+        continue;
+      }
+      seen.add(f.key);
+      if (!f.type)
+        errors.push(`"${f.key}" is missing a type.`);
+      if (!f.source)
+        errors.push(`"${f.key}" is missing a source.`);
+    }
+    return { valid: errors.length === 0, errors };
+  },
+  computeOutputSchema(fields) {
+    const properties = {};
+    for (const f of fields) {
+      properties[f.key] = fieldToJsonSchema(f);
     }
+    return { type: "object", properties };
   }
-  return [...keys];
+};
+function fieldToJsonSchema(f) {
+  const node = { type: f.type };
+  if (f.description)
+    node.description = f.description;
+  if (f.validation?.enum)
+    node.enum = f.validation.enum;
+  return node;
 }
+
 // src/catalog/ai/ai-agent/config.ts
 var AiAgentConfig = {
   defaults: {
@@ -4543,6 +4135,7 @@ var AiAgentConfig = {
   merge: (userConfig) => ({ ...AiAgentConfig.defaults, ...userConfig }),
   getLabel: (config) => config.agentId ? `Agent ${config.agentId}` : "AI Agent"
 };
+
 // src/catalog/ai/idp-extract/config.ts
 var IDP_EXTRACT_STRATEGIES = ["vision-direct", "auto"];
 var IdpExtractConfig = {
@@ -4576,6 +4169,7 @@ var IdpExtractConfig = {
   merge: (userConfig) => ({ ...IdpExtractConfig.defaults, ...userConfig }),
   getLabel: (config) => config.model ? `IDP: ${config.model}` : "IDP Extract"
 };
+
 // src/catalog/logic/group/config.ts
 var GroupConfig = {
   defaults: {},
@@ -4584,6 +4178,7 @@ var GroupConfig = {
   merge: (_userConfig) => ({}),
   getLabel: () => "Group"
 };
+
 // src/catalog/triggers/connector-trigger/events.ts
 var EVENT_CAPABLE_CONNECTOR_IDS = new Set([
   "quickbooks_online",
@@ -4750,6 +4345,7 @@ var ConnectorTriggerConfig = {
   merge: (userConfig) => ({ ...ConnectorTriggerConfig.defaults, ...userConfig }),
   getLabel: (config) => config.summary || config.connectorName || "Connector Trigger"
 };
+
 // src/catalog/storage/fileEditContract.ts
 var FILE_FORMAT_OPERATIONS = ["parse", "generate", "edit"];
 var FILE_EDIT_OPERATIONS = ["append", "update", "upsert", "set_fields"];
@@ -4788,6 +4384,7 @@ function fileFormatErrors(config) {
   }
   return [...errors, ...fileEditErrors(config)];
 }
+
 // src/catalog/storage/csv-action/config.ts
 var CsvActionConfig = {
   defaults: {
@@ -4814,6 +4411,7 @@ var CsvActionConfig = {
   merge: (userConfig) => ({ ...CsvActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `CSV: ${config.operation || "parse"}`
 };
+
 // src/catalog/storage/json-action/config.ts
 var JsonActionConfig = {
   defaults: {
@@ -4831,62 +4429,257 @@ var JsonActionConfig = {
     jsonl: { type: "boolean", required: false, description: "edit: treat the file as JSONL" },
     ...FILE_EDIT_SCHEMA
   },
-  validate: (config) => {
-    const errors = fileFormatErrors(config);
-    const format = config.format;
-    if (format !== undefined && format !== "" && !["json", "jsonl"].includes(format)) {
-      errors.push(`Unknown format "${format}" — use json or jsonl`);
-    }
-    return { valid: errors.length === 0, errors };
+  validate: (config) => {
+    const errors = fileFormatErrors(config);
+    const format = config.format;
+    if (format !== undefined && format !== "" && !["json", "jsonl"].includes(format)) {
+      errors.push(`Unknown format "${format}" — use json or jsonl`);
+    }
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => ({ ...JsonActionConfig.defaults, ...userConfig }),
+  getLabel: (config) => `JSON: ${config.operation || "parse"}`
+};
+
+// src/catalog/storage/xml-action/config.ts
+var XmlActionConfig = {
+  defaults: {
+    operation: "parse",
+    rootElement: "data",
+    rowElement: "row",
+    fileName: "export.xml"
+  },
+  schema: {
+    operation: { type: "select", required: true, options: FILE_FORMAT_OPERATIONS, description: "parse (XML → records), generate (records → XML) or edit an existing file" },
+    content: { type: "text", required: false, description: "XML text, or a reference to an earlier step's file content" },
+    rootElement: { type: "string", required: false, description: "generate: root element name" },
+    rowElement: { type: "string", required: false, description: "Element that holds one record" },
+    fileName: { type: "string", required: false, description: "generate: name of the produced file" },
+    ...FILE_EDIT_SCHEMA
+  },
+  validate: (config) => {
+    const errors = fileFormatErrors(config);
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => ({ ...XmlActionConfig.defaults, ...userConfig }),
+  getLabel: (config) => `XML: ${config.operation || "parse"}`
+};
+
+// src/catalog/storage/excel-action/config.ts
+var ExcelActionConfig = {
+  defaults: {
+    operation: "parse",
+    headerRow: 1,
+    fileName: "export.xlsx"
+  },
+  schema: {
+    operation: { type: "select", required: true, options: FILE_FORMAT_OPERATIONS, description: "parse (Excel → records), generate (records → Excel) or edit an existing file" },
+    content: { type: "text", required: false, description: "A reference to an earlier step's Excel file (its s3Key output), or base64 bytes" },
+    sheetName: { type: "string", required: false, description: "Sheet to read; the first sheet when absent" },
+    headerRow: { type: "number", required: false, min: 1, description: "1-based row that holds the column headers" },
+    fileName: { type: "string", required: false, description: "generate: name of the produced file" },
+    ...FILE_EDIT_SCHEMA
+  },
+  validate: (config) => {
+    const errors = fileFormatErrors(config);
+    return { valid: errors.length === 0, errors };
+  },
+  merge: (userConfig) => ({ ...ExcelActionConfig.defaults, ...userConfig }),
+  getLabel: (config) => `Excel: ${config.operation || "parse"}`
+};
+
+// src/catalog/storage/storageCapabilities.ts
+var contentTypeField = {
+  key: "contentType",
+  label: "Content type",
+  type: "string",
+  placeholder: "application/octet-stream",
+  advanced: true,
+  hint: "MIME type for the uploaded file."
+};
+var STORAGE_PROVIDERS = {
+  aws_s3: {
+    connectorId: "aws_s3",
+    label: "Amazon S3",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "prefix", label: "Folder", selectMode: "folder" }, fields: [{ key: "maxKeys", label: "Max results", type: "number", defaultValue: 100, advanced: true }] },
+      { value: "download", label: "Download file", path: { key: "key", label: "File", selectMode: "both", required: true } },
+      { value: "upload", label: "Upload file", path: { key: "key", label: "Destination key", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
+      { value: "delete", label: "Delete file", path: { key: "key", label: "File", selectMode: "both", required: true } },
+      { value: "copy", label: "Copy file", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
+      { value: "move", label: "Move / rename", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
+      { value: "presign", label: "Get signed URL", path: { key: "key", label: "File", selectMode: "both", required: true }, fields: [{ key: "expiresIn", label: "Expiry (seconds)", type: "number", defaultValue: 3600, advanced: true }] }
+    ]
+  },
+  ftp_sftp: {
+    connectorId: "ftp_sftp",
+    label: "FTP / SFTP",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "remotePath", label: "Folder", selectMode: "folder" } },
+      { value: "download", label: "Download file", path: { key: "remotePath", label: "File", selectMode: "both", required: true } },
+      { value: "upload", label: "Upload file", path: { key: "remotePath", label: "Destination path", selectMode: "both", required: true }, content: true },
+      { value: "delete", label: "Delete file", path: { key: "remotePath", label: "File", selectMode: "both", required: true } },
+      { value: "move", label: "Move / rename", path: { key: "remotePath", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } }
+    ]
+  },
+  dropbox: {
+    connectorId: "dropbox",
+    label: "Dropbox",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "path", label: "Folder", selectMode: "folder" } },
+      { value: "download", label: "Download file", path: { key: "path", label: "File", selectMode: "both", required: true } },
+      { value: "upload", label: "Upload file", path: { key: "path", label: "Destination path", selectMode: "both", required: true }, content: true, fields: [{ key: "mode", label: "Write mode", type: "select", options: [{ label: "Overwrite", value: "overwrite" }, { label: "Add (keep both)", value: "add" }], defaultValue: "overwrite", advanced: true }] },
+      { value: "delete", label: "Delete file", path: { key: "path", label: "File", selectMode: "both", required: true } },
+      { value: "copy", label: "Copy file", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } },
+      { value: "move", label: "Move / rename", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } }
+    ]
+  },
+  onedrive: {
+    connectorId: "onedrive",
+    label: "OneDrive",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "path", label: "Folder", selectMode: "folder" } },
+      { value: "download", label: "Download file", path: { key: "path", label: "File", selectMode: "both", required: true } },
+      { value: "upload", label: "Upload file", path: { key: "path", label: "Destination path", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
+      { value: "delete", label: "Delete file", path: { key: "path", label: "File", selectMode: "both", required: true } },
+      { value: "copy", label: "Copy file", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } },
+      { value: "move", label: "Move / rename", path: { key: "path", label: "Source file", selectMode: "both", required: true }, dest: { key: "destPath", label: "Destination path", selectMode: "both", required: true } }
+    ]
+  },
+  google_drive: {
+    connectorId: "google_drive",
+    label: "Google Drive",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "folderId", label: "Folder", selectMode: "folder" }, fields: [{ key: "query", label: "Search query", type: "string", advanced: true }, { key: "pageSize", label: "Max results", type: "number", defaultValue: 50, advanced: true }] },
+      { value: "download", label: "Download file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
+      {
+        value: "upload",
+        label: "Upload file",
+        path: { key: "folderId", label: "Destination folder", selectMode: "both" },
+        content: true,
+        fields: [
+          { key: "fileName", label: "File name", type: "string", required: true },
+          { key: "folderName", label: "Folder path", type: "string", advanced: true, placeholder: "Reports/2026", hint: "Folders under My Drive, separated by /. Missing ones are created on the first run. Ignored when a destination folder is picked." },
+          { key: "ifExists", label: "If the file already exists", type: "select", options: [{ label: "Replace it (Drive keeps the versions)", value: "overwrite" }, { label: "Skip it", value: "skip" }, { label: "Keep both (rename)", value: "rename" }], defaultValue: "overwrite", advanced: true },
+          { key: "mimeType", label: "Content type", type: "string", advanced: true }
+        ]
+      },
+      { value: "delete", label: "Delete file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
+      { value: "move", label: "Move", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both", required: true } },
+      { value: "copy", label: "Copy", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both" }, fields: [{ key: "fileName", label: "New name", type: "string" }] },
+      { value: "share", label: "Share", path: { key: "fileId", label: "File", selectMode: "both", required: true }, fields: [{ key: "shareEmail", label: "Share with (email)", type: "string", required: true }, { key: "shareRole", label: "Role", type: "select", options: [{ label: "Viewer", value: "reader" }, { label: "Editor", value: "writer" }], defaultValue: "reader" }] },
+      { value: "create_folder", label: "Create folder", path: { key: "folderId", label: "Parent folder", selectMode: "both" }, fields: [{ key: "fileName", label: "Folder name", type: "string", required: true }] }
+    ]
+  },
+  gcs: {
+    connectorId: "gcs",
+    label: "Google Cloud Storage",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "prefix", label: "Folder", selectMode: "folder" }, fields: [{ key: "maxKeys", label: "Max results", type: "number", defaultValue: 100, advanced: true }] },
+      { value: "download", label: "Download file", path: { key: "key", label: "File", selectMode: "both", required: true } },
+      { value: "upload", label: "Upload file", path: { key: "key", label: "Destination key", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
+      { value: "delete", label: "Delete file", path: { key: "key", label: "File", selectMode: "both", required: true } },
+      { value: "copy", label: "Copy file", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
+      { value: "move", label: "Move / rename", path: { key: "key", label: "Source file", selectMode: "both", required: true }, dest: { key: "destKey", label: "Destination key", selectMode: "both", required: true } },
+      { value: "presign", label: "Get signed URL", path: { key: "key", label: "File", selectMode: "both", required: true }, fields: [{ key: "expiresIn", label: "Expiry (seconds)", type: "number", defaultValue: 3600, advanced: true }] }
+    ]
   },
-  merge: (userConfig) => ({ ...JsonActionConfig.defaults, ...userConfig }),
-  getLabel: (config) => `JSON: ${config.operation || "parse"}`
+  azure_blob: {
+    connectorId: "azure_blob",
+    label: "Azure Blob Storage",
+    browse: true,
+    operations: [
+      { value: "list", label: "List files", path: { key: "prefix", label: "Folder", selectMode: "folder" }, fields: [{ key: "maxKeys", label: "Max results", type: "number", defaultValue: 100, advanced: true }] },
+      { value: "download", label: "Download file", path: { key: "blob", label: "File", selectMode: "both", required: true } },
+      { value: "upload", label: "Upload file", path: { key: "blob", label: "Destination blob", selectMode: "both", required: true }, content: true, fields: [contentTypeField] },
+      { value: "delete", label: "Delete file", path: { key: "blob", label: "File", selectMode: "both", required: true } },
+      { value: "copy", label: "Copy file", path: { key: "blob", label: "Source blob", selectMode: "both", required: true }, dest: { key: "destBlob", label: "Destination blob", selectMode: "both", required: true } },
+      { value: "move", label: "Move / rename", path: { key: "blob", label: "Source blob", selectMode: "both", required: true }, dest: { key: "destBlob", label: "Destination blob", selectMode: "both", required: true } },
+      { value: "presign", label: "Get signed URL", path: { key: "blob", label: "File", selectMode: "both", required: true }, fields: [{ key: "expiresIn", label: "Expiry (seconds)", type: "number", defaultValue: 3600, advanced: true }] }
+    ]
+  }
 };
-// src/catalog/storage/xml-action/config.ts
-var XmlActionConfig = {
-  defaults: {
-    operation: "parse",
-    rootElement: "data",
-    rowElement: "row",
-    fileName: "export.xml"
-  },
-  schema: {
-    operation: { type: "select", required: true, options: FILE_FORMAT_OPERATIONS, description: "parse (XML → records), generate (records → XML) or edit an existing file" },
-    content: { type: "text", required: false, description: "XML text, or a reference to an earlier step's file content" },
-    rootElement: { type: "string", required: false, description: "generate: root element name" },
-    rowElement: { type: "string", required: false, description: "Element that holds one record" },
-    fileName: { type: "string", required: false, description: "generate: name of the produced file" },
-    ...FILE_EDIT_SCHEMA
-  },
-  validate: (config) => {
-    const errors = fileFormatErrors(config);
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => ({ ...XmlActionConfig.defaults, ...userConfig }),
-  getLabel: (config) => `XML: ${config.operation || "parse"}`
+STORAGE_PROVIDERS.google_sheets = { ...STORAGE_PROVIDERS.google_drive, connectorId: "google_sheets" };
+var transferOp = {
+  value: "transfer",
+  label: "Transfer to another connector",
+  path: { key: "path", label: "Source file or folder", selectMode: "both", required: true }
 };
-// src/catalog/storage/excel-action/config.ts
-var ExcelActionConfig = {
-  defaults: {
-    operation: "parse",
-    headerRow: 1,
-    fileName: "export.xlsx"
-  },
-  schema: {
-    operation: { type: "select", required: true, options: FILE_FORMAT_OPERATIONS, description: "parse (Excel → records), generate (records → Excel) or edit an existing file" },
-    content: { type: "text", required: false, description: "A reference to an earlier step's Excel file (its s3Key output), or base64 bytes" },
-    sheetName: { type: "string", required: false, description: "Sheet to read; the first sheet when absent" },
-    headerRow: { type: "number", required: false, min: 1, description: "1-based row that holds the column headers" },
-    fileName: { type: "string", required: false, description: "generate: name of the produced file" },
-    ...FILE_EDIT_SCHEMA
-  },
-  validate: (config) => {
-    const errors = fileFormatErrors(config);
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => ({ ...ExcelActionConfig.defaults, ...userConfig }),
-  getLabel: (config) => `Excel: ${config.operation || "parse"}`
+for (const id of ["aws_s3", "ftp_sftp", "dropbox", "onedrive", "google_drive", "gcs", "azure_blob"]) {
+  STORAGE_PROVIDERS[id].operations.push(transferOp);
+}
+var syncOp = {
+  value: "sync",
+  label: "Sync folder to another connector",
+  path: { key: "path", label: "Source folder", selectMode: "both", required: true },
+  fields: [
+    {
+      key: "ifExists",
+      label: "If a file already exists",
+      type: "select",
+      options: [
+        { label: "Overwrite", value: "overwrite" },
+        { label: "Skip it", value: "skip" },
+        { label: "Keep both (rename)", value: "rename" }
+      ],
+      defaultValue: "overwrite",
+      hint: "What to do when the destination already has the file."
+    },
+    {
+      key: "onError",
+      label: "On file error",
+      type: "select",
+      options: [
+        { label: "Stop the sync", value: "abort" },
+        { label: "Skip the file & continue", value: "skip" }
+      ],
+      defaultValue: "abort",
+      hint: "A bad file (timeout, lock, permission) stops the whole sync, or is skipped."
+    }
+  ]
 };
+for (const id of ["aws_s3", "ftp_sftp", "dropbox", "onedrive", "google_drive", "gcs", "azure_blob"]) {
+  STORAGE_PROVIDERS[id].operations.push(syncOp);
+}
+var STORAGE_CONNECTOR_IDS = Object.keys(STORAGE_PROVIDERS).filter((id) => id !== "google_sheets");
+function getStorageProvider(connectorId) {
+  if (!connectorId)
+    return;
+  return STORAGE_PROVIDERS[connectorId] ?? STORAGE_PROVIDERS[connectorId.replace(/-/g, "_")];
+}
+function storageConfigKeys() {
+  const keys = new Set([
+    "operation",
+    "connector",
+    "content",
+    "outputAs",
+    "path",
+    "destPath",
+    "destConnector",
+    "sourceIsDirectory",
+    "cursor",
+    "fileBudget",
+    "timeBudgetMs"
+  ]);
+  for (const provider of Object.values(STORAGE_PROVIDERS)) {
+    for (const op of provider.operations) {
+      if (op.path)
+        keys.add(op.path.key);
+      if (op.dest)
+        keys.add(op.dest.key);
+      for (const f of op.fields ?? [])
+        keys.add(f.key);
+    }
+  }
+  return [...keys];
+}
+
 // src/catalog/storage/storage-action/config.ts
 var FIXED_SCHEMA = {
   connector: { type: "connection", required: true, description: "Storage connector instance; its provider decides the operations" },
@@ -4980,6 +4773,7 @@ var StorageActionConfig = {
   merge: (userConfig) => ({ ...StorageActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `Storage: ${config.operation || "download"}`
 };
+
 // src/catalog/storage/s3-action/config.ts
 var S3_OPERATIONS = ["list", "download", "upload", "delete", "copy", "move", "presign"];
 var S3ActionConfig = {
@@ -5017,6 +4811,7 @@ var S3ActionConfig = {
   merge: (userConfig) => ({ ...S3ActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `S3: ${config.operation || "download"}`
 };
+
 // src/catalog/storage/ftp-action/config.ts
 var FTP_OPERATIONS = ["download", "upload", "list", "delete", "move"];
 var FtpActionConfig = {
@@ -5047,6 +4842,7 @@ var FtpActionConfig = {
   merge: (userConfig) => ({ ...FtpActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `FTP: ${config.operation || "download"}`
 };
+
 // src/catalog/storage/google-drive-action/config.ts
 var GOOGLE_DRIVE_OPERATIONS = ["upload", "download", "list", "delete", "move", "copy", "share", "create_folder"];
 var GoogleDriveActionConfig = {
@@ -5088,6 +4884,7 @@ var GoogleDriveActionConfig = {
   merge: (userConfig) => ({ ...GoogleDriveActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `Drive: ${config.operation || "upload"}`
 };
+
 // src/catalog/storage/dropbox-action/config.ts
 var DROPBOX_OPERATIONS = ["list", "download", "upload", "delete", "move", "copy"];
 var DropboxActionConfig = {
@@ -5118,6 +4915,7 @@ var DropboxActionConfig = {
   merge: (userConfig) => ({ ...DropboxActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `Dropbox: ${config.operation || "download"}`
 };
+
 // src/catalog/storage/onedrive-action/config.ts
 var ONEDRIVE_OPERATIONS = ["download", "upload", "list", "delete", "move", "copy"];
 var OneDriveActionConfig = {
@@ -5149,881 +4947,1167 @@ var OneDriveActionConfig = {
   merge: (userConfig) => ({ ...OneDriveActionConfig.defaults, ...userConfig }),
   getLabel: (config) => `OneDrive: ${config.operation || "download"}`
 };
-// src/catalog/workflow.ts
-var NodeStatus;
-((NodeStatus) => {
-  NodeStatus["Idle"] = "idle";
-  NodeStatus["Running"] = "running";
-  NodeStatus["Success"] = "success";
-  NodeStatus["Error"] = "error";
-  NodeStatus["Warning"] = "warning";
-  NodeStatus["Disabled"] = "disabled";
-})(NodeStatus ||= {});
-var EdgeType;
-((EdgeType) => {
-  EdgeType["Default"] = "default";
-  EdgeType["Conditional"] = "conditional";
-  EdgeType["Loop"] = "loop";
-  EdgeType["Error"] = "error";
-})(EdgeType ||= {});
-// src/rules/flattenNestedWorkflow.ts
-function workflowIsNested(workflow) {
-  const stack = [...workflow.steps];
-  while (stack.length > 0) {
-    const s = stack.pop();
-    if (s.branches && Object.keys(s.branches).length > 0)
+
+// src/rules/configContracts.ts
+var asValidator = (fn) => (config) => fn(config);
+var CONFIG_CONTRACTS = {
+  console_log: { schema: ConsoleLogConfig.schema, validate: asValidator(ConsoleLogConfig.validate) },
+  delay: { schema: DelayConfig.schema, validate: asValidator(DelayConfig.validate) },
+  http_request: { schema: HTTPRequestConfig.schema, validate: asValidator(HTTPRequestConfig.validate) },
+  email: { schema: EmailConfig.schema, validate: asValidator(EmailConfig.validate) },
+  google_chat: { schema: GoogleChatConfig.schema, validate: asValidator(GoogleChatConfig.validate) },
+  slack_message: { schema: SlackMessageConfig.schema, validate: asValidator(SlackMessageConfig.validate) },
+  teams_message: { schema: TeamsMessageConfig.schema, validate: asValidator(TeamsMessageConfig.validate) },
+  webhook_call: { schema: WebhookCallConfig.schema, validate: asValidator(WebhookCallConfig.validate) },
+  whatsapp_send: { schema: WhatsappSendConfig.schema, validate: asValidator(WhatsappSendConfig.validate) },
+  query: {
+    schema: BuildQueryContractSchema,
+    validate: (config) => {
+      const r = validateBuildQueryConfig(config);
+      const errors = (r.errors ?? []).filter((e) => e.severity !== "warning").map((e) => e.message);
+      return { valid: errors.length === 0, errors };
+    }
+  },
+  transform: { schema: TransformConfig.schema, validate: asValidator(TransformConfig.validate) },
+  aggregate: { schema: AggregateConfig.schema, validate: asValidator(AggregateConfig.validate) },
+  condition: { schema: ConditionConfig.schema, validate: asValidator(ConditionConfig.validate) },
+  for_each: { schema: ForEachConfig.schema, validate: asValidator(ForEachConfig.validate) },
+  manual_trigger: { schema: ManualTriggerConfig.schema, validate: asValidator(ManualTriggerConfig.validate) },
+  schedule_trigger: { schema: ScheduleTriggerConfig.schema, validate: asValidator(ScheduleTriggerConfig.validate) },
+  webhook_trigger: { schema: WebhookTriggerConfig.schema, validate: asValidator(WebhookTriggerConfig.validate) },
+  debug: { schema: DebugConfig.schema, validate: asValidator(DebugConfig.validate) },
+  variables: { schema: VariablesConfig.schema, validate: asValidator(VariablesConfig.validate) },
+  ai_agent: { schema: AiAgentConfig.schema, validate: asValidator(AiAgentConfig.validate) },
+  idp_extract: { schema: IdpExtractConfig.schema, validate: asValidator(IdpExtractConfig.validate) },
+  group: { schema: GroupConfig.schema, validate: asValidator(GroupConfig.validate) },
+  connector_trigger: { schema: ConnectorTriggerConfig.schema, validate: asValidator(ConnectorTriggerConfig.validate) },
+  csv_action: { schema: CsvActionConfig.schema, validate: asValidator(CsvActionConfig.validate) },
+  json_action: { schema: JsonActionConfig.schema, validate: asValidator(JsonActionConfig.validate) },
+  xml_action: { schema: XmlActionConfig.schema, validate: asValidator(XmlActionConfig.validate) },
+  excel_action: { schema: ExcelActionConfig.schema, validate: asValidator(ExcelActionConfig.validate) },
+  storage_action: { schema: StorageActionConfig.schema, validate: asValidator(StorageActionConfig.validate) },
+  s3_action: { schema: S3ActionConfig.schema, validate: asValidator(S3ActionConfig.validate) },
+  ftp_action: { schema: FtpActionConfig.schema, validate: asValidator(FtpActionConfig.validate) },
+  google_drive_action: { schema: GoogleDriveActionConfig.schema, validate: asValidator(GoogleDriveActionConfig.validate) },
+  dropbox_action: { schema: DropboxActionConfig.schema, validate: asValidator(DropboxActionConfig.validate) },
+  onedrive_action: { schema: OneDriveActionConfig.schema, validate: asValidator(OneDriveActionConfig.validate) }
+};
+function contractFor(actionId) {
+  return actionId ? CONFIG_CONTRACTS[actionId] : undefined;
+}
+function declaredKeys(actionId) {
+  const c = contractFor(actionId);
+  if (!c)
+    return [];
+  return Object.entries(c.schema).filter(([, f]) => f.type !== "none").map(([k]) => k);
+}
+function isEditorPrivateKey(key) {
+  return key.startsWith("_");
+}
+var CONTRACT_TYPE_TO_FIELD_TYPE = {
+  string: "string" /* String */,
+  text: "string" /* String */,
+  select: "select" /* Select */,
+  json: "json" /* JSON */,
+  connection: "connection" /* Connection */,
+  number: "number" /* Number */,
+  boolean: "boolean" /* Boolean */,
+  array: "array" /* Array */,
+  object: "object" /* Object */,
+  url: "url" /* URL */,
+  expression: "expression" /* Expression */,
+  code: "code" /* Code */
+};
+function humanise(key) {
+  return key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+}
+function contractFieldsFor(definition) {
+  const declared = definition.inputSchema?.fields ?? [];
+  const contract = contractFor(definition.id);
+  if (!contract)
+    return declared;
+  const seen = new Set(declared.map((f) => f.key));
+  const derived = [];
+  for (const [key, field] of Object.entries(contract.schema)) {
+    if (seen.has(key) || field.type === "none")
+      continue;
+    derived.push({
+      key,
+      label: humanise(key),
+      type: CONTRACT_TYPE_TO_FIELD_TYPE[field.type] ?? "string" /* String */,
+      validation: { required: field.required === true },
+      ...typeof field.description === "string" && field.description ? { description: field.description } : {},
+      ...field.options ? { options: field.options.map((v) => ({ label: String(v), value: v })) } : {}
+    });
+  }
+  return [...declared, ...derived];
+}
+function selectsWithoutValues(actionId) {
+  const contract = contractFor(actionId);
+  if (!contract)
+    return [];
+  return Object.entries(contract.schema).filter(([, f]) => f.type === "select" && !(f.options && f.options.length > 0) && f.dynamic !== true).map(([key]) => key);
+}
+function contractDrift(definition) {
+  const contract = contractFor(definition.id);
+  if (!contract)
+    return [];
+  const covers = (key) => {
+    if (key in contract.schema)
+      return true;
+    const root = key.split(".")[0];
+    const rootField = contract.schema[root];
+    return !!rootField && (rootField.type === "object" || rootField.type === "json");
+  };
+  return (definition.inputSchema?.fields ?? []).map((f) => f.key).filter((k) => !covers(k));
+}
+function contractVocabularyDrift(actionId) {
+  const c = contractFor(actionId);
+  if (!c)
+    return [];
+  const known = new Set([...Object.keys(CONTRACT_TYPE_TO_FIELD_TYPE), "none"]);
+  return Object.entries(c.schema).filter(([, f]) => !known.has(f.type)).map(([k, f]) => `${k}:${f.type}`);
+}
+function contractDerivedKeys(definition) {
+  const own = new Set((definition.inputSchema?.fields ?? []).map((f) => f.key));
+  return new Set(contractFieldsFor(definition).map((f) => f.key).filter((k) => !own.has(k)));
+}
+
+// src/rules/nodeConfigStatus.ts
+var HIDDEN_STATUS_ACTIONS = new Set(["console_log"]);
+function isFieldFilled(value) {
+  if (value === undefined || value === null)
+    return false;
+  if (typeof value === "string")
+    return value.trim().length > 0;
+  if (typeof value === "number")
+    return true;
+  if (typeof value === "boolean")
+    return true;
+  if (Array.isArray(value))
+    return value.length > 0;
+  if (typeof value === "object")
+    return Object.keys(value).length > 0;
+  return false;
+}
+function isSatisfiedOutOfBand(actionId, fieldKey, config) {
+  if (actionId === "connector_trigger" && fieldKey === "events") {
+    return Number(config.eventCount ?? 0) > 0;
+  }
+  if (MESSAGE_BODY_ACTIONS.has(actionId) && (fieldKey === "message" || fieldKey === "text")) {
+    const text = config.text ?? config.message;
+    if (typeof text === "string" && text.trim().length > 0)
       return true;
+    return Array.isArray(config.blocks) && config.blocks.length > 0;
   }
+  if (actionId === "query" && fieldKey === "visualConfig.fields")
+    return queryFieldsSatisfied(config);
+  if (actionId === "query" && fieldKey === "visualConfig.tables")
+    return queryTablesSatisfied(config);
   return false;
 }
-function flattenNestedWorkflow(workflow) {
-  if (!workflowIsNested(workflow))
-    return workflow;
-  const flatSteps = [];
-  const flatConns = [...workflow.connections];
-  const groups = [];
-  const walk = (steps, parentIdForSubflow) => {
-    for (const step of steps) {
-      const { branches, ...rest } = step;
-      const flatStep = {
-        ...rest,
-        ...parentIdForSubflow ? { parentId: parentIdForSubflow } : {}
-      };
-      flatSteps.push(flatStep);
-      if (!branches)
-        continue;
-      if (branches.body && step.type === "group") {
-        const body = branches.body;
-        groups.push({
-          group: flatStep,
-          bodyStepIds: body.steps.map((s) => s.id),
-          bodyConnections: body.connections
-        });
-        for (const c of body.connections)
-          flatConns.push(c);
-        walk(body.steps, step.id);
-      }
-      for (const branchKey of Object.keys(branches)) {
-        if (branchKey === "body" && step.type === "group")
-          continue;
-        const sub = branches[branchKey];
-        if (!sub)
-          continue;
-        for (const c of sub.connections)
-          flatConns.push(c);
-        walk(sub.steps, parentIdForSubflow);
-      }
+var MESSAGE_BODY_ACTIONS = new Set([
+  "slack_message",
+  "teams_message",
+  "google_chat"
+]);
+function getNestedValue(config, keyPath) {
+  const parts = keyPath.split(".");
+  let current = config;
+  for (const part of parts) {
+    if (current === null || current === undefined || typeof current !== "object") {
+      return;
     }
-  };
-  walk(workflow.steps, undefined);
-  for (const g of groups) {
-    if (g.bodyStepIds.length === 0)
-      continue;
-    const bodyIdSet = new Set(g.bodyStepIds);
-    const inDeg = new Map;
-    const outDeg = new Map;
-    for (const id of g.bodyStepIds) {
-      inDeg.set(id, 0);
-      outDeg.set(id, 0);
+    current = current[part];
+  }
+  return current;
+}
+function isFieldActive(field, config) {
+  if (!field.conditional || field.conditional.length === 0) {
+    return true;
+  }
+  return field.conditional.some((cond) => {
+    if (cond.action !== "show" && cond.action !== "require") {
+      return false;
     }
-    for (const c of g.bodyConnections) {
-      if (bodyIdSet.has(c.sourceStepId)) {
-        outDeg.set(c.sourceStepId, (outDeg.get(c.sourceStepId) ?? 0) + 1);
-      }
-      if (bodyIdSet.has(c.targetStepId)) {
-        inDeg.set(c.targetStepId, (inDeg.get(c.targetStepId) ?? 0) + 1);
-      }
+    const fieldValue = getNestedValue(config, cond.field);
+    switch (cond.operator) {
+      case "==":
+        return fieldValue === cond.value;
+      case "!=":
+        return fieldValue !== cond.value;
+      case ">":
+        return fieldValue > cond.value;
+      case "<":
+        return fieldValue < cond.value;
+      case ">=":
+        return fieldValue >= cond.value;
+      case "<=":
+        return fieldValue <= cond.value;
+      case "in":
+        return Array.isArray(cond.value) && cond.value.includes(fieldValue);
+      case "not_in":
+        return Array.isArray(cond.value) && !cond.value.includes(fieldValue);
+      case "contains":
+        return typeof fieldValue === "string" && fieldValue.includes(cond.value);
+      default:
+        return false;
     }
-    const roots = g.bodyStepIds.filter((id) => (inDeg.get(id) ?? 0) === 0);
-    const leaves = g.bodyStepIds.filter((id) => (outDeg.get(id) ?? 0) === 0);
-    for (const rootId of roots) {
-      flatConns.push({
-        id: `synth-inner-in-${g.group.id}-${rootId}`,
-        sourceStepId: g.group.id,
-        targetStepId: rootId,
-        sourcePort: "_inner_in"
-      });
+  });
+}
+function getNodeConfigStatus(node) {
+  if (HIDDEN_STATUS_ACTIONS.has(node.actionDefinitionId)) {
+    return {
+      status: "hidden",
+      requiredTotal: 0,
+      requiredFilled: 0,
+      optionalTotal: 0,
+      optionalFilled: 0,
+      missingRequired: [],
+      filledOptional: []
+    };
+  }
+  const definition = getActionById(node.actionDefinitionId);
+  if (!definition) {
+    return {
+      status: "unconfigured",
+      requiredTotal: 0,
+      requiredFilled: 0,
+      optionalTotal: 0,
+      optionalFilled: 0,
+      missingRequired: [],
+      filledOptional: []
+    };
+  }
+  const fields = definition.inputSchema?.fields ?? [];
+  const config = node.config ?? {};
+  const activeFields = fields.filter((f) => !f.hidden && isFieldActive(f, config));
+  const requiredFields = activeFields.filter((f) => f.validation?.required);
+  const optionalFields = activeFields.filter((f) => !f.validation?.required);
+  const missingRequired = [];
+  let requiredFilled = 0;
+  for (const field of requiredFields) {
+    const value = getNestedValue(config, field.key);
+    if (isFieldFilled(value)) {
+      requiredFilled++;
+    } else if (isFieldFilled(field.defaultValue)) {
+      requiredFilled++;
+    } else if (isSatisfiedOutOfBand(node.actionDefinitionId, field.key, config)) {
+      requiredFilled++;
+    } else {
+      missingRequired.push(field.key);
     }
-    for (const leafId of leaves) {
-      flatConns.push({
-        id: `synth-inner-out-${leafId}-${g.group.id}`,
-        sourceStepId: leafId,
-        targetStepId: g.group.id,
-        targetPort: "_inner_out"
-      });
+  }
+  const filledOptional = [];
+  let optionalFilled = 0;
+  for (const field of optionalFields) {
+    const value = getNestedValue(config, field.key);
+    if (isFieldFilled(value)) {
+      optionalFilled++;
+      filledOptional.push(field.key);
     }
   }
-  return { ...workflow, steps: flatSteps, connections: flatConns };
+  const requiredTotal = requiredFields.length;
+  const optionalTotal = optionalFields.length;
+  let status;
+  if (requiredTotal === 0) {
+    status = "valid";
+  } else if (missingRequired.length === 0) {
+    status = "valid";
+  } else if (requiredFilled > 0 || optionalFilled > 0) {
+    status = "warning";
+  } else {
+    status = "error";
+  }
+  return {
+    status,
+    requiredTotal,
+    requiredFilled,
+    optionalTotal,
+    optionalFilled,
+    missingRequired,
+    filledOptional
+  };
 }
-
-// src/rules/flowShape.ts
-function transformStepToNode(step) {
-  const stepType = step.type;
-  const stepActionDefId = step.actionDefinitionId ?? "";
-  const nodeType = stepType === "trigger" ? "trigger" : stepType === "group" || stepActionDefId === "group" ? "group" : "action";
-  let nodeStatus = "idle" /* Idle */;
-  switch (step.status?.toLowerCase()) {
-    case "running":
-    case "executing":
-      nodeStatus = "running" /* Running */;
-      break;
-    case "completed":
-    case "success":
-      nodeStatus = "success" /* Success */;
-      break;
-    case "failed":
-    case "error":
-      nodeStatus = "error" /* Error */;
-      break;
-    case "pending":
-    case "waiting":
-      nodeStatus = "idle" /* Idle */;
-      break;
-    default:
-      nodeStatus = "idle" /* Idle */;
+function missingContractRequired(node) {
+  if (HIDDEN_STATUS_ACTIONS.has(node.actionDefinitionId))
+    return [];
+  const definition = getActionById(node.actionDefinitionId);
+  const contract = contractFor(node.actionDefinitionId);
+  if (!definition || !contract)
+    return [];
+  const requiredInSchema = new Set((definition.inputSchema?.fields ?? []).filter((f) => f.validation?.required).map((f) => f.key));
+  const config = node.config ?? {};
+  const missing = [];
+  for (const [key, field] of Object.entries(contract.schema)) {
+    if (field.type === "none" || field.required !== true || requiredInSchema.has(key))
+      continue;
+    if (isFieldFilled(getNestedValue(config, key)))
+      continue;
+    if (isSatisfiedOutOfBand(node.actionDefinitionId, key, config))
+      continue;
+    missing.push(key);
   }
-  const position = step.position || { x: step.position_x || 0, y: step.position_y || 0 };
-  const posX = typeof position === "object" && position !== null && "x" in position ? position.x : step.position_x || 0;
-  const posY = typeof position === "object" && position !== null && "y" in position ? position.y : step.position_y || 0;
-  const config = step.config || {};
-  const configData = config.data || config || {};
-  const derivedFromName = step.name ? step.name.toLowerCase().replace(/\s+/g, "_") : undefined;
-  const resolvedActionDefinitionId = step.actionDefinitionId || config.connector_id || step.connector_id || derivedFromName || step.type;
-  const actionDef = getActionById(resolvedActionDefinitionId);
-  const node = {
-    id: step.id,
-    type: nodeType,
-    actionDefinitionId: resolvedActionDefinitionId,
-    actionDefinition: actionDef,
-    label: step.label || step.name,
-    description: step.description || config.description || actionDef?.description || "",
-    icon: actionDef?.icon ?? getIconForStepType(step.type),
-    position: {
-      x: posX,
-      y: posY
-    },
-    ...step.parentId ? { parentId: step.parentId } : {},
-    ...step.extent ? { extent: step.extent } : {},
-    ...step.disabled ? { disabled: true } : {},
-    ...step.dimensions && nodeType === "group" ? { dimensions: step.dimensions } : nodeType === "group" ? { dimensions: { width: 480, height: 240 } } : {},
-    config: {
-      ...configData,
-      timeout: step.timeout_seconds,
-      retryPolicy: step.retry_policy,
-      notes: step.notes,
-      tags: step.tags,
-      stepCount: step.step_count
-    },
-    ports: {
-      input: nodeType === "action" || nodeType === "group" ? [
-        {
-          id: `${step.id}-input`,
-          type: "input",
-          position: "top",
-          connected: false
-        }
-      ] : [],
-      output: (() => {
-        if (resolvedActionDefinitionId === "condition") {
-          return [
-            { id: `${step.id}_output_true`, type: "output", position: "bottom", label: "True", connected: false },
-            { id: `${step.id}_output_false`, type: "output", position: "bottom", label: "False", connected: false }
-          ];
-        }
-        if (resolvedActionDefinitionId === "for_each" || resolvedActionDefinitionId === "for-each") {
-          return [
-            { id: `${step.id}_output_each`, type: "output", position: "bottom", label: "Each", connected: false },
-            { id: `${step.id}_output_done`, type: "output", position: "bottom", label: "Done", connected: false }
-          ];
-        }
-        if (resolvedActionDefinitionId === "group") {
-          return [
-            { id: `${step.id}_output_0`, type: "output", position: "bottom", connected: false }
-          ];
-        }
-        return [
-          { id: `${step.id}-output`, type: "output", position: "bottom", connected: false }
-        ];
-      })()
-    },
-    configStatus: step.configStatus || undefined,
-    ...step.outputSchema ? { outputSchema: step.outputSchema } : {},
-    status: nodeStatus,
-    selected: false,
-    dragging: false,
-    isValid: step.configStatus ? step.configStatus === "valid" : true,
-    expanded: step.expanded,
-    minimized: false,
-    locked: false,
-    createdAt: step.created_at || new Date().toISOString(),
-    updatedAt: step.updated_at || new Date().toISOString()
-  };
-  return node;
+  return missing;
 }
-function transformConnectionToEdge(connection) {
-  const sourceStepId = connection.sourceStepId || connection.source_step_id;
-  const targetStepId = connection.targetStepId || connection.target_step_id;
-  const sourcePort = connection.sourcePort || connection.source_port || `${sourceStepId}-output`;
-  const targetPort = connection.targetPort || connection.target_port || `${targetStepId}-input`;
-  let edgeType = "default" /* Default */;
-  if (connection.type === "success" || connection.type === "failure") {
-    edgeType = "conditional" /* Conditional */;
+function contractValidationErrors(node) {
+  if (HIDDEN_STATUS_ACTIONS.has(node.actionDefinitionId))
+    return [];
+  const contract = contractFor(node.actionDefinitionId);
+  if (!contract?.validate)
+    return [];
+  try {
+    const verdict = contract.validate(node.config ?? {});
+    if (verdict.valid)
+      return [];
+    return [...new Set(verdict.errors.map((e) => String(e).trim()).filter(Boolean))];
+  } catch {
+    return [];
   }
-  return {
-    id: connection.id,
-    source: sourceStepId,
-    target: targetStepId,
-    sourcePort,
-    targetPort,
-    type: edgeType,
-    label: connection.label,
-    selected: false,
-    animated: false,
-    createdAt: new Date().toISOString()
-  };
 }
-function generateConnectionsFromSteps(steps) {
-  const connections = [];
-  const sortedSteps = [...steps].sort((a, b) => a.step_count - b.step_count);
-  for (let i = 0;i < sortedSteps.length - 1; i++) {
-    const sourceStep = sortedSteps[i];
-    const targetStep = sortedSteps[i + 1];
-    connections.push({
-      id: `${sourceStep.id}-${targetStep.id}`,
-      source_step_id: sourceStep.id,
-      target_step_id: targetStep.id,
-      source_port: `${sourceStep.id}-output`,
-      target_port: `${targetStep.id}-input`,
-      type: "default"
+
+// src/rules/workflowValidator.ts
+var nodeName = (n) => n.label || n.id;
+function validateNode(node, allNodes, allEdges) {
+  const errors = [];
+  if (!node.id || node.id.trim().length === 0) {
+    errors.push({
+      id: `node-${node.id}-id`,
+      type: "node",
+      severity: "error",
+      message: "Node ID is required",
+      nodeId: node.id
+    });
+  }
+  if (!node.label || node.label.trim().length === 0) {
+    errors.push({
+      id: `node-${node.id}-label`,
+      type: "node",
+      severity: "error",
+      message: "Node label is required",
+      nodeId: node.id
+    });
+  }
+  const cfg = getNodeConfigStatus(node);
+  if (cfg.missingRequired.length > 0) {
+    const fields = cfg.missingRequired.slice(0, 4).join(", ");
+    const more = cfg.missingRequired.length > 4 ? ` +${cfg.missingRequired.length - 4} more` : "";
+    errors.push({
+      id: `node-${node.id}-config`,
+      type: "node",
+      severity: "error",
+      message: `Missing required settings: ${fields}${more}. Open the step and fill them in.`,
+      nodeId: node.id
+    });
+  }
+  const contractIssues = cfg.missingRequired.length === 0 ? contractValidationErrors(node) : [];
+  const contractGaps = missingContractRequired(node);
+  if (contractIssues.length > 0) {
+    const shown = contractIssues.slice(0, 3).map((e) => e.replace(/[.\s]+$/, ""));
+    const more = contractIssues.length > 3 ? ` (+${contractIssues.length - 3} more)` : "";
+    errors.push({
+      id: `node-${node.id}-contract`,
+      type: "node",
+      severity: "warning",
+      message: `This step will not run as set up: ${shown.join("; ")}${more}. Open the step to fix it.`,
+      nodeId: node.id
+    });
+  } else if (contractGaps.length > 0) {
+    const fields = contractGaps.slice(0, 4).join(", ");
+    const more = contractGaps.length > 4 ? ` +${contractGaps.length - 4} more` : "";
+    errors.push({
+      id: `node-${node.id}-contract`,
+      type: "node",
+      severity: "warning",
+      message: `Not set: ${fields}${more}. This step needs ${contractGaps.length === 1 ? "it" : "them"} to run. Open the step and fill ${contractGaps.length === 1 ? "it" : "them"} in.`,
+      nodeId: node.id
+    });
+  }
+  const hasOutput = allEdges.some((edge) => edge.source === node.id);
+  if (!hasOutput && node.type === "trigger") {
+    errors.push({
+      id: `node-${node.id}-output`,
+      type: "node",
+      severity: "warning",
+      message: `Trigger "${nodeName(node)}" has no outgoing connections`,
+      nodeId: node.id
+    });
+  }
+  return errors;
+}
+function validateEdge(edge, allNodes, allEdges = []) {
+  const errors = [];
+  const sourceNode = allNodes.find((n) => n.id === edge.source);
+  if (!sourceNode) {
+    errors.push({
+      id: `edge-${edge.id}-source`,
+      type: "edge",
+      severity: "error",
+      message: `Source node "${edge.source}" does not exist`,
+      edgeId: edge.id
+    });
+  }
+  const targetNode = allNodes.find((n) => n.id === edge.target);
+  if (!targetNode) {
+    errors.push({
+      id: `edge-${edge.id}-target`,
+      type: "edge",
+      severity: "error",
+      message: `Target node "${edge.target}" does not exist`,
+      edgeId: edge.id
+    });
+  }
+  if (edge.source === edge.target) {
+    errors.push({
+      id: `edge-${edge.id}-loop`,
+      type: "edge",
+      severity: "error",
+      message: "Nodes cannot connect to themselves",
+      edgeId: edge.id
+    });
+  }
+  const key = (e) => `${e.source}|${e.sourceHandle ?? ""}→${e.target}|${e.targetHandle ?? ""}`;
+  const myKey = key(edge);
+  const firstIndex = allEdges.findIndex((e) => key(e) === myKey);
+  const myIndex = allEdges.findIndex((e) => e.id === edge.id);
+  if (firstIndex !== -1 && myIndex > firstIndex) {
+    errors.push({
+      id: `edge-${edge.id}-duplicate`,
+      type: "edge",
+      severity: "warning",
+      message: `Duplicate connection between "${sourceNode ? nodeName(sourceNode) : edge.source}" and "${targetNode ? nodeName(targetNode) : edge.target}"`,
+      edgeId: edge.id
     });
   }
-  return connections;
-}
-function getIconForStepType(type) {
-  const iconMap = {
-    trigger: "PlayOutline",
-    transform: "Transform",
-    action: "Application",
-    condition: "DecisionTree",
-    loop: "Repeat"
-  };
-  return iconMap[type] || "Application";
+  return errors;
 }
-function transformFlowToWorkflow(flow) {
-  const flatWorkflow = flattenNestedWorkflow(flow.workflow);
-  const nodes = flatWorkflow.steps.map((step) => transformStepToNode(step));
-  let connections = flatWorkflow.connections;
-  if (connections === undefined || connections === null) {
-    connections = generateConnectionsFromSteps(flatWorkflow.steps);
-  } else {
-    connections = connections || [];
+function validateWorkflow(nodes, edges) {
+  const allErrors = [];
+  const hasTrigger = nodes.some((node) => node.type === "trigger");
+  if (!hasTrigger) {
+    allErrors.push({
+      id: "workflow-trigger",
+      type: "workflow",
+      severity: "error",
+      message: "Workflow must have at least one trigger node"
+    });
   }
-  const edges = connections.map((conn, index) => {
-    if (!conn.id) {
-      conn.id = `edge-${conn.source_step_id}-${conn.target_step_id}-${index}`;
-    }
-    return transformConnectionToEdge(conn);
+  const hasAction = nodes.some((node) => node.type === "action");
+  if (!hasAction && nodes.length > 0) {
+    allErrors.push({
+      id: "workflow-action",
+      type: "workflow",
+      severity: "warning",
+      message: "Workflow should have at least one action node"
+    });
+  }
+  nodes.forEach((node) => {
+    const nodeErrors = validateNode(node, nodes, edges);
+    allErrors.push(...nodeErrors);
   });
   edges.forEach((edge) => {
-    const sourceNode = nodes.find((n) => n.id === edge.source);
-    const targetNode = nodes.find((n) => n.id === edge.target);
-    if (sourceNode) {
-      const port = sourceNode.ports.output.find((p) => p.id === edge.sourcePort);
-      if (port)
-        port.connected = true;
+    const edgeErrors = validateEdge(edge, nodes, edges);
+    allErrors.push(...edgeErrors);
+  });
+  if (nodes.length > 0 && edges.length > 0) {
+    const inDegree = new Map(nodes.map((n) => [n.id, 0]));
+    const out = new Map;
+    for (const e of edges) {
+      if (e.source === e.target)
+        continue;
+      if (!inDegree.has(e.source) || !inDegree.has(e.target))
+        continue;
+      inDegree.set(e.target, (inDegree.get(e.target) ?? 0) + 1);
+      const list = out.get(e.source);
+      if (list)
+        list.push(e.target);
+      else
+        out.set(e.source, [e.target]);
     }
-    if (targetNode) {
-      const port = targetNode.ports.input.find((p) => p.id === edge.targetPort);
-      if (port)
-        port.connected = true;
+    const queue = nodes.filter((n) => (inDegree.get(n.id) ?? 0) === 0).map((n) => n.id);
+    let visited = 0;
+    while (queue.length) {
+      const cur = queue.shift();
+      visited++;
+      for (const next of out.get(cur) ?? []) {
+        const d = (inDegree.get(next) ?? 1) - 1;
+        inDegree.set(next, d);
+        if (d === 0)
+          queue.push(next);
+      }
     }
-  });
-  return {
-    id: flow.workflow.id,
-    name: flow.workflow.name,
-    description: flow.workflow.description,
-    nodes,
-    edges,
-    workflowHistory: flow.workflowHistory || []
-  };
-}
-function validateFlowData(flow) {
-  if (!flow || typeof flow !== "object")
-    return false;
-  const f = flow;
-  return typeof f.id === "string" && typeof f.name === "string" && f.workflow !== undefined && typeof f.workflow === "object" && f.workflow !== null && Array.isArray(f.workflow.steps);
-}
-// src/catalog/actions/console-log/config.ts
-var ConsoleLogConfig = {
-  defaults: {
-    message: "",
-    level: "info",
-    data: undefined,
-    includeInputData: true
-  },
-  schema: {
-    includeInputData: { type: "boolean", required: false },
-    message: {
-      type: "string",
-      required: true,
-      description: "Message to log"
-    },
-    level: {
-      type: "select",
-      required: false,
-      options: ["info", "warning", "error", "debug"],
-      description: "Log level for the message"
-    },
-    data: {
-      type: "json",
-      required: false,
-      description: "Additional data to log"
+    if (visited < nodes.length) {
+      const stuck = nodes.filter((n) => (inDegree.get(n.id) ?? 0) > 0);
+      const names = stuck.slice(0, 3).map(nodeName).join(", ");
+      const more = stuck.length > 3 ? ` +${stuck.length - 3} more` : "";
+      allErrors.push({
+        id: "workflow-cycle",
+        type: "workflow",
+        severity: "error",
+        message: `Circular connection detected involving: ${names}${more}. Break the loop — execution order is undefined inside a cycle.`,
+        nodeId: stuck[0]?.id
+      });
     }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.message) {
-      errors.push("Message is required");
-    } else if (typeof config.message !== "string") {
-      errors.push("Message must be a string");
+  }
+  const isTrigger = (n) => n.type === "trigger" || String(n.actionDefinitionId ?? "").endsWith("_trigger");
+  const triggerIds = nodes.filter(isTrigger).map((n) => n.id);
+  const adjacency = new Map;
+  for (const e of edges) {
+    const list = adjacency.get(e.source);
+    if (list)
+      list.push(e.target);
+    else
+      adjacency.set(e.source, [e.target]);
+  }
+  const reachable = new Set(triggerIds);
+  const queue = [...triggerIds];
+  while (queue.length) {
+    const cur = queue.shift();
+    for (const next of adjacency.get(cur) ?? []) {
+      if (!reachable.has(next)) {
+        reachable.add(next);
+        queue.push(next);
+      }
     }
-    if (config.level && !["info", "warning", "error", "debug"].includes(config.level)) {
-      errors.push("Invalid log level");
+  }
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const n of nodes) {
+      if (reachable.has(n.id)) {
+        if (n.parentId && !reachable.has(n.parentId)) {
+          reachable.add(n.parentId);
+          changed = true;
+        }
+      } else if (n.parentId && reachable.has(n.parentId)) {
+        reachable.add(n.id);
+        changed = true;
+      }
     }
-    return {
-      valid: errors.length === 0,
-      errors
-    };
-  },
-  merge: (userConfig) => {
-    return {
-      ...ConsoleLogConfig.defaults,
-      ...userConfig
-    };
-  },
-  getLabel: (config) => {
-    return `Log [${config.level}]: ${config.message}`;
   }
-};
-
-// src/catalog/actions/delay/config.ts
-var DelayConfig = {
-  defaults: {
-    duration: 1000,
-    unit: "milliseconds"
-  },
-  schema: {
-    duration: {
-      type: "number",
-      required: true,
-      description: "Duration to delay",
-      min: 0
-    },
-    unit: {
-      type: "select",
-      required: false,
-      options: ["milliseconds", "seconds", "minutes", "hours"],
-      description: "Time unit for the duration"
+  nodes.forEach((node) => {
+    if (isTrigger(node))
+      return;
+    const isConnected = edges.some((e) => e.source === node.id || e.target === node.id);
+    const wontRun = triggerIds.length > 0 ? !reachable.has(node.id) : !isConnected;
+    if (wontRun) {
+      allErrors.push({
+        id: `node-${node.id}-orphan`,
+        type: "node",
+        severity: "warning",
+        message: isConnected ? `"${nodeName(node)}" isn't reachable from a trigger and won't run.` : `"${nodeName(node)}" isn't connected to a flow and won't run.`,
+        nodeId: node.id
+      });
+    }
+  });
+  if (triggerIds.length > 1) {
+    const parentOf = new Map(nodes.filter((n) => n.parentId).map((n) => [n.id, n.parentId]));
+    const undirected = new Map;
+    const link = (a, b) => {
+      const la = undirected.get(a);
+      if (la)
+        la.push(b);
+      else
+        undirected.set(a, [b]);
+    };
+    for (const e of edges) {
+      link(e.source, e.target);
+      link(e.target, e.source);
+    }
+    for (const [child, parent] of parentOf) {
+      link(child, parent);
+      link(parent, child);
+    }
+    const seen = new Set;
+    let flowsWithTrigger = 0;
+    for (const t of triggerIds) {
+      if (seen.has(t))
+        continue;
+      flowsWithTrigger++;
+      const stack = [t];
+      seen.add(t);
+      while (stack.length) {
+        const cur = stack.pop();
+        for (const next of undirected.get(cur) ?? []) {
+          if (!seen.has(next)) {
+            seen.add(next);
+            stack.push(next);
+          }
+        }
+      }
     }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (config.duration === undefined || config.duration === null) {
-      errors.push("Duration is required");
-    } else if (typeof config.duration !== "number") {
-      errors.push("Duration must be a number");
-    } else if (config.duration < 0) {
-      errors.push("Duration must be non-negative");
+    if (flowsWithTrigger > 1) {
+      allErrors.push({
+        id: "workflow-multi-flow",
+        type: "workflow",
+        severity: "warning",
+        message: `This canvas holds ${flowsWithTrigger} separate flows. Each trigger runs only its own flow — consider splitting them into separate flows for clarity.`
+      });
     }
-    if (config.unit && !["milliseconds", "seconds", "minutes", "hours"].includes(config.unit)) {
-      errors.push("Invalid time unit");
+  }
+  const errors = allErrors.filter((e) => e.severity === "error");
+  const warnings = allErrors.filter((e) => e.severity === "warning");
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function getNodeValidationStatus(nodeId, validationResult) {
+  const hasError = validationResult.errors.some((e) => e.nodeId === nodeId);
+  if (hasError)
+    return "error";
+  const hasWarning = validationResult.warnings.some((e) => e.nodeId === nodeId);
+  if (hasWarning)
+    return "warning";
+  return "valid";
+}
+function getEdgeValidationStatus(edgeId, validationResult) {
+  const hasError = validationResult.errors.some((e) => e.edgeId === edgeId);
+  if (hasError)
+    return "error";
+  const hasWarning = validationResult.warnings.some((e) => e.edgeId === edgeId);
+  if (hasWarning)
+    return "warning";
+  return "valid";
+}
+// src/catalog/logic/for-each/pathOptions.ts
+function inferSchemaFromSample(sample) {
+  const properties = {};
+  for (const [key, value] of Object.entries(sample)) {
+    if (value === null || value === undefined) {
+      properties[key] = { type: "string" };
+    } else if (Array.isArray(value)) {
+      if (value.length > 0 && typeof value[0] === "object" && value[0] !== null) {
+        properties[key] = { type: "array", items: inferSchemaFromSample(value[0]) };
+      } else {
+        properties[key] = { type: "array" };
+      }
+    } else if (typeof value === "object") {
+      properties[key] = inferSchemaFromSample(value);
+    } else if (typeof value === "number") {
+      properties[key] = { type: "number" };
+    } else if (typeof value === "boolean") {
+      properties[key] = { type: "boolean" };
+    } else {
+      properties[key] = { type: "string" };
     }
-    return {
-      valid: errors.length === 0,
-      errors
-    };
-  },
-  toMilliseconds: (duration, unit = "milliseconds") => {
-    const multipliers = {
-      milliseconds: 1,
-      seconds: 1000,
-      minutes: 60000,
-      hours: 3600000
-    };
-    return duration * (multipliers[unit] || 1);
-  },
-  merge: (userConfig) => {
-    return {
-      ...DelayConfig.defaults,
-      ...userConfig
-    };
-  },
-  getLabel: (config) => {
-    return `Delay ${config.duration}${config.unit ? " " + config.unit : "ms"}`;
   }
-};
-
-// src/catalog/actions/http-request/config.ts
-function urlCheckedAtRunTime(url, connectionId) {
-  const u = url.trim();
-  if (u.startsWith("{{"))
-    return true;
-  const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(u);
-  return !!connectionId && !hasScheme;
+  return { type: "object", properties };
 }
-var HTTPRequestConfig = {
-  defaults: {
-    apiType: "rest",
-    method: "GET",
-    url: "",
-    queryParams: [],
-    headers: [],
-    bodyType: "json",
-    body: undefined,
-    formData: [],
-    graphqlQuery: "",
-    graphqlVariables: {},
-    auth: { type: "none" },
-    timeout: 30000,
-    failOnError: true,
-    followRedirects: true,
-    retry: { maxAttempts: 1, retryOn: [429, 500, 502, 503, 504], initialDelayMs: 1000, backoffFactor: 2, maxDelayMs: 30000 },
-    pagination: { type: "none" },
-    extract: {},
-    responseType: "json",
-    expectedContentTypes: []
-  },
-  schema: {
-    apiType: { type: "select", required: false, options: ["rest", "graphql"] },
-    baseUrl: { type: "string", required: false },
-    queryParams: { type: "array", required: false },
-    bodyType: { type: "select", required: false, options: ["none", "json", "raw", "form-data", "xml"] },
-    formData: { type: "array", required: false },
-    graphqlQuery: { type: "code", required: false },
-    graphqlVariables: { type: "json", required: false },
-    auth: { type: "object", required: false },
-    failOnError: { type: "boolean", required: false },
-    followRedirects: { type: "boolean", required: false },
-    retry: { type: "object", required: false },
-    pagination: { type: "object", required: false },
-    extract: { type: "object", required: false },
-    responseType: { type: "select", required: false, options: ["json", "text", "binary"] },
-    expectedContentTypes: { type: "array", required: false },
-    method: {
-      type: "select",
-      required: true,
-      options: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
-      description: "HTTP method to use"
-    },
-    url: {
-      type: "url",
-      required: true,
-      description: "The URL to send the request to"
-    },
-    headers: {
-      type: "json",
-      required: false,
-      description: "HTTP headers to send with the request"
-    },
-    body: {
-      type: "json",
-      required: false,
-      description: "Request body (for POST, PUT, PATCH)"
-    },
-    timeout: {
-      type: "number",
-      required: false,
-      description: "Request timeout in milliseconds",
-      min: 1000
+function collectArrayPaths(schema, prefix, add, depth = 0) {
+  if (!schema || typeof schema !== "object" || depth > 8)
+    return;
+  if (schema.type === "array") {
+    if (prefix) {
+      const itemsType = schema.items?.type;
+      const label = itemsType === "object" ? "array of objects" : "array";
+      add(prefix, `${prefix}  (${label})`, `Iterate over "${prefix}"`);
     }
-  },
-  validate: (config) => {
-    const errors = [];
-    const apiType = config.apiType ?? "rest";
-    if (apiType === "rest" && !config.method) {
-      errors.push("Method is required");
+    if (schema.items) {
+      collectArrayPaths(schema.items, prefix, add, depth + 1);
     }
-    if (apiType === "graphql" && !config.graphqlQuery?.trim()) {
-      errors.push("GraphQL query is required");
+    return;
+  }
+  if (schema.type === "object" && schema.properties) {
+    for (const [key, child] of Object.entries(schema.properties)) {
+      const next = prefix ? `${prefix}.${key}` : key;
+      collectArrayPaths(child, next, add, depth + 1);
     }
-    if (!config.url) {
-      errors.push("URL is required");
-    } else if (typeof config.url === "string" && !urlCheckedAtRunTime(config.url, config.connectionId)) {
-      try {
-        new URL(config.url);
-      } catch {
-        errors.push("Invalid URL format");
-      }
+  }
+}
+function collectArrayPathsFromSample(sample, prefix, add, depth = 0) {
+  if (!sample || typeof sample !== "object" || depth > 8)
+    return;
+  if (Array.isArray(sample)) {
+    if (prefix) {
+      const itemsObj = sample.length > 0 && typeof sample[0] === "object" && sample[0] !== null;
+      const label = itemsObj ? "array of objects" : "array";
+      add(prefix, `${prefix}  (${label})`, `Iterate over "${prefix}"`);
     }
-    if (config.timeout !== undefined && typeof config.timeout === "number") {
-      if (config.timeout < 1000) {
-        errors.push("Timeout must be at least 1000ms");
+    if (sample.length > 0) {
+      collectArrayPathsFromSample(sample[0], prefix, add, depth + 1);
+    }
+    return;
+  }
+  for (const [key, value] of Object.entries(sample)) {
+    const next = prefix ? `${prefix}.${key}` : key;
+    collectArrayPathsFromSample(value, next, add, depth + 1);
+  }
+}
+function buildPathOptions(upstreamNodes) {
+  const paths = [];
+  const seen = new Set;
+  const add = (id, text, description) => {
+    if (seen.has(id))
+      return;
+    seen.add(id);
+    paths.push({ id, text, description });
+  };
+  if (upstreamNodes) {
+    for (const node of upstreamNodes) {
+      const label = node.label || node.type || "Upstream";
+      const queryTable = node.config?.visualConfig?.tables?.[0];
+      add("data", queryTable ? `${queryTable} (${label})` : `All records (${label})`, queryTable ? `Iterate over every ${queryTable} record` : "Iterate over every record from upstream");
+      const schema = node.outputSchema || node.config?._outputSchema;
+      if (schema)
+        collectArrayPaths(schema, "", add);
+      const output = node.executionData?.output;
+      if (output) {
+        const records = Array.isArray(output.data) ? output.data : Array.isArray(output) ? output : null;
+        if (records && records.length > 0 && typeof records[0] === "object") {
+          collectArrayPathsFromSample(records[0], "", add);
+        }
       }
     }
-    return {
-      valid: errors.length === 0,
-      errors
-    };
-  },
-  merge: (userConfig) => {
-    return {
-      ...HTTPRequestConfig.defaults,
-      ...userConfig
-    };
-  },
-  getLabel: (config) => {
-    const type = config.apiType === "graphql" ? "GraphQL" : config.method ?? "GET";
-    return `${type} ${config.url}`;
   }
-};
-
-// src/catalog/communication/google-chat/config.ts
-var GoogleChatConfig = {
-  defaults: { connection: "", space: "", spaceName: "", text: "", threadKey: "" },
-  schema: {
-    connection: { type: "connection", required: true },
-    space: { type: "string", required: true },
-    text: { type: "string", required: false },
-    threadKey: { type: "string", required: false }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.connection)
-      errors.push("Connect a Google Chat account");
-    if (!config.space)
-      errors.push("Pick a space");
-    if (!config.text && !config.message)
-      errors.push("Add a message");
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => ({
-    ...GoogleChatConfig.defaults,
-    ...userConfig
-  }),
-  getLabel: () => "Google Chat"
-};
-
-// src/catalog/communication/slack-message/config.ts
-var SlackMessageConfig = {
-  defaults: { connection: "", messageType: "channel", channel: "", channelName: "", text: "", blocks: undefined },
-  schema: {
-    connection: { type: "connection", required: true },
-    messageType: { type: "string", required: false },
-    channel: { type: "string", required: true },
-    text: { type: "string", required: false },
-    blocks: { type: "json", required: false }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.connection)
-      errors.push("Slack workspace connection is required");
-    if (!config.channel)
-      errors.push(config.messageType === "user" ? "A user is required" : "A channel is required");
-    const hasText = Boolean(config.text || config.message);
-    const hasBlocks = Array.isArray(config.blocks) && config.blocks.length > 0;
-    if (!hasText && !hasBlocks)
-      errors.push("Add a message or at least one block");
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...SlackMessageConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => {
-    const prefix = config.messageType === "user" ? "@" : "#";
-    return config.channelName ? `Slack: ${prefix}${config.channelName}` : config.channel ? `Slack: ${config.channel}` : "Slack";
+  if (paths.length === 0) {
+    add("data", "data (upstream output)");
   }
-};
-
-// src/catalog/communication/teams-message/config.ts
-var TeamsMessageConfig = {
-  defaults: { connection: "", teamId: "", teamName: "", channelId: "", channelName: "", title: "", message: "" },
-  schema: {
-    connection: { type: "connection", required: true },
-    teamId: { type: "string", required: true },
-    channelId: { type: "string", required: true },
-    title: { type: "string", required: false },
-    message: { type: "string", required: true }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.connection)
-      errors.push("Connect a Microsoft Teams account");
-    if (!config.teamId)
-      errors.push("Pick a team");
-    if (!config.channelId)
-      errors.push("Pick a channel");
-    if (!config.message)
-      errors.push("Add a message");
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...TeamsMessageConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => config.channelName ? `Teams: #${config.channelName}` : "Teams"
-};
-
-// src/catalog/communication/webhook-call/config.ts
-var WebhookCallConfig = {
-  defaults: {
-    url: "",
-    method: "POST",
-    payload: {},
-    headers: {}
-  },
-  schema: {
-    url: { type: "url", required: true },
-    method: { type: "select", required: true, options: ["POST", "PUT", "PATCH", "GET"] },
-    payload: { type: "json", required: false },
-    headers: { type: "json", required: false }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.url)
-      errors.push("Webhook URL is required");
-    if (!config.method)
-      errors.push("HTTP method is required");
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...WebhookCallConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => {
-    return `${config.method}: ${config.url.substring(0, 40)}...`;
+  return paths;
+}
+// src/catalog/actions/delay/migrate.ts
+var LEGACY_UNITS = new Set([
+  "milliseconds",
+  "seconds",
+  "minutes",
+  "hours"
+]);
+function migrateDelayConfig(raw) {
+  if (raw && typeof raw === "object" && "mode" in raw) {
+    return raw;
   }
-};
-
-// src/catalog/communication/whatsapp-send/config.ts
-var WhatsappSendConfig = {
-  schema: {
-    connection: { type: "connection", required: true },
-    to: { type: "string", required: true },
-    mode: { type: "select", required: true, options: ["template", "text"] },
-    templateName: { type: "string", required: false },
-    templateLanguage: { type: "string", required: false },
-    templateVariables: { type: "array", required: false },
-    text: { type: "string", required: false },
-    previewUrl: { type: "boolean", required: false }
-  },
-  defaults: {
-    connection: "",
-    to: "",
-    mode: "template",
-    templateLanguage: "en_US",
-    templateVariables: []
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.connection)
-      errors.push("Select a WhatsApp connection");
-    if (!config.to?.trim())
-      errors.push("Recipient phone number is required");
-    if (config.mode === "text") {
-      if (!config.text?.trim())
-        errors.push("Message text is required");
+  const legacy = raw ?? {};
+  const duration = typeof legacy.duration === "number" && Number.isFinite(legacy.duration) ? legacy.duration : 1;
+  const unit = typeof legacy.unit === "string" && LEGACY_UNITS.has(legacy.unit) ? legacy.unit : "milliseconds";
+  return {
+    mode: "fixed",
+    fixed: { duration, unit }
+  };
+}
+// src/catalog/logic/for-each/recordSchema.ts
+function resolveSchemaPath(root, path) {
+  if (!root)
+    return;
+  const parts = path.split(".").filter(Boolean);
+  let cur = root;
+  for (const part of parts) {
+    if (cur?.type === "object" && cur.properties && part in cur.properties) {
+      cur = cur.properties[part];
+      continue;
+    }
+    if (cur?.type === "array" && cur.items?.properties && part in cur.items.properties) {
+      cur = cur.items.properties[part];
+      continue;
+    }
+    return;
+  }
+  if (cur?.type === "array" && cur.items)
+    return cur.items;
+  if (cur?.type === "object" && cur.properties)
+    return cur;
+  return;
+}
+function resolveSamplePath(sample, path) {
+  const parts = path.split(".").filter(Boolean);
+  let cur = sample;
+  for (const part of parts) {
+    if (cur === null || cur === undefined)
+      return;
+    if (Array.isArray(cur)) {
+      if (cur.length === 0 || typeof cur[0] !== "object" || cur[0] === null)
+        return;
+      cur = cur[0][part];
+      continue;
+    }
+    if (typeof cur === "object") {
+      cur = cur[part];
+      continue;
+    }
+    return;
+  }
+  return cur;
+}
+function sampleRecords(node) {
+  const output = node?.executionData?.output;
+  if (!output)
+    return null;
+  if (Array.isArray(output))
+    return output;
+  const data = output.data;
+  return Array.isArray(data) ? data : null;
+}
+var isRootPath = (path) => path === "" || path === "data";
+function resolveRecordSchema(upstreamNodes, arrayPath) {
+  const node = upstreamNodes?.[0];
+  if (!node)
+    return;
+  const path = (arrayPath || "").trim();
+  const isRoot = isRootPath(path);
+  const schema = node.outputSchema || node.config?._outputSchema;
+  if (schema?.properties) {
+    if (isRoot) {
+      const hasDeepFields = Object.values(schema.properties).some((f) => f?.properties || f?.items);
+      if (hasDeepFields)
+        return schema;
     } else {
-      if (!config.templateName?.trim())
-        errors.push("Choose an approved template");
+      const resolved = resolveSchemaPath(schema, path);
+      if (resolved)
+        return resolved;
+    }
+  }
+  const records = sampleRecords(node);
+  if (records && records.length > 0 && typeof records[0] === "object" && records[0] !== null) {
+    const sample = records[0];
+    if (isRoot)
+      return inferSchemaFromSample(sample);
+    const resolved = resolveSamplePath(sample, path);
+    if (Array.isArray(resolved) && resolved.length > 0 && typeof resolved[0] === "object" && resolved[0] !== null) {
+      return inferSchemaFromSample(resolved[0]);
     }
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...WhatsappSendConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => config.mode === "text" ? `WhatsApp to ${config.to || "—"}` : `WhatsApp template "${config.templateName || "—"}" to ${config.to || "—"}`
-};
-
-// src/catalog/triggers/schedule-trigger/config.ts
-var ScheduleTriggerConfig = {
-  defaults: {
-    scheduleType: "interval",
-    interval: 60,
-    intervalUnit: "minutes",
-    timezone: "UTC"
-  },
-  schema: {
-    scheduleType: { type: "select", required: true, options: ["interval", "cron", "specific"] },
-    interval: { type: "number", required: false, min: 1 },
-    intervalUnit: { type: "select", required: false, options: ["minutes", "hours", "days", "weeks"] },
-    cronExpression: { type: "string", required: false },
-    timezone: { type: "string", required: false }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.scheduleType) {
-      errors.push("Schedule type is required");
+    if (resolved && typeof resolved === "object" && !Array.isArray(resolved)) {
+      return inferSchemaFromSample(resolved);
     }
-    if (config.scheduleType === "interval") {
-      if (!config.interval || config.interval < 1) {
-        errors.push("Interval must be at least 1");
+    if (!path.includes("."))
+      return inferSchemaFromSample(sample);
+  }
+  return schema?.properties ? schema : undefined;
+}
+function detectRecordFields(upstreamNodes, arrayPath) {
+  const set = new Set;
+  const props = resolveRecordSchema(upstreamNodes, arrayPath)?.properties;
+  if (props && typeof props === "object")
+    for (const k of Object.keys(props))
+      set.add(k);
+  const records = sampleRecords(upstreamNodes?.[0]);
+  if (records) {
+    const path = (arrayPath || "").trim();
+    const addKeys = (v) => {
+      if (v && typeof v === "object" && !Array.isArray(v))
+        for (const k of Object.keys(v))
+          set.add(k);
+    };
+    for (const r of records.slice(0, 25)) {
+      if (isRootPath(path)) {
+        addKeys(r);
+        continue;
       }
+      const at = resolveSamplePath(r, path);
+      if (Array.isArray(at))
+        for (const item of at.slice(0, 25))
+          addKeys(item);
+      else if (at && typeof at === "object")
+        addKeys(at);
+      else if (!path.includes("."))
+        addKeys(r);
     }
-    if (config.scheduleType === "cron" && !config.cronExpression) {
-      errors.push("Cron expression is required");
+  }
+  return Array.from(set);
+}
+// src/catalog/workflow.ts
+var NodeStatus;
+((NodeStatus) => {
+  NodeStatus["Idle"] = "idle";
+  NodeStatus["Running"] = "running";
+  NodeStatus["Success"] = "success";
+  NodeStatus["Error"] = "error";
+  NodeStatus["Warning"] = "warning";
+  NodeStatus["Disabled"] = "disabled";
+})(NodeStatus ||= {});
+var EdgeType;
+((EdgeType) => {
+  EdgeType["Default"] = "default";
+  EdgeType["Conditional"] = "conditional";
+  EdgeType["Loop"] = "loop";
+  EdgeType["Error"] = "error";
+})(EdgeType ||= {});
+// src/rules/flattenNestedWorkflow.ts
+function workflowIsNested(workflow) {
+  const stack = [...workflow.steps];
+  while (stack.length > 0) {
+    const s = stack.pop();
+    if (s.branches && Object.keys(s.branches).length > 0)
+      return true;
+  }
+  return false;
+}
+function flattenNestedWorkflow(workflow) {
+  if (!workflowIsNested(workflow))
+    return workflow;
+  const flatSteps = [];
+  const flatConns = [...workflow.connections];
+  const groups = [];
+  const walk = (steps, parentIdForSubflow) => {
+    for (const step of steps) {
+      const { branches, ...rest } = step;
+      const flatStep = {
+        ...rest,
+        ...parentIdForSubflow ? { parentId: parentIdForSubflow } : {}
+      };
+      flatSteps.push(flatStep);
+      if (!branches)
+        continue;
+      if (branches.body && step.type === "group") {
+        const body = branches.body;
+        groups.push({
+          group: flatStep,
+          bodyStepIds: body.steps.map((s) => s.id),
+          bodyConnections: body.connections
+        });
+        for (const c of body.connections)
+          flatConns.push(c);
+        walk(body.steps, step.id);
+      }
+      for (const branchKey of Object.keys(branches)) {
+        if (branchKey === "body" && step.type === "group")
+          continue;
+        const sub = branches[branchKey];
+        if (!sub)
+          continue;
+        for (const c of sub.connections)
+          flatConns.push(c);
+        walk(sub.steps, parentIdForSubflow);
+      }
     }
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...ScheduleTriggerConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => {
-    if (config.scheduleType === "interval") {
-      return `Every ${config.interval} ${config.intervalUnit}`;
+  };
+  walk(workflow.steps, undefined);
+  for (const g of groups) {
+    if (g.bodyStepIds.length === 0)
+      continue;
+    const bodyIdSet = new Set(g.bodyStepIds);
+    const inDeg = new Map;
+    const outDeg = new Map;
+    for (const id of g.bodyStepIds) {
+      inDeg.set(id, 0);
+      outDeg.set(id, 0);
     }
-    return `Schedule: ${config.scheduleType}`;
-  }
-};
-
-// src/catalog/triggers/webhook-trigger/config.ts
-var WebhookTriggerConfig = {
-  defaults: {
-    method: "POST",
-    requireAuth: true
-  },
-  schema: {
-    webhookPath: { type: "string", required: false },
-    method: { type: "select", required: true, options: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
-    requireAuth: { type: "boolean", required: false }
-  },
-  validate: (config) => {
-    const errors = [];
-    if (!config.method) {
-      errors.push("HTTP method is required");
+    for (const c of g.bodyConnections) {
+      if (bodyIdSet.has(c.sourceStepId)) {
+        outDeg.set(c.sourceStepId, (outDeg.get(c.sourceStepId) ?? 0) + 1);
+      }
+      if (bodyIdSet.has(c.targetStepId)) {
+        inDeg.set(c.targetStepId, (inDeg.get(c.targetStepId) ?? 0) + 1);
+      }
     }
-    return { valid: errors.length === 0, errors };
-  },
-  merge: (userConfig) => {
-    return { ...WebhookTriggerConfig.defaults, ...userConfig };
-  },
-  getLabel: (config) => {
-    return `Webhook ${config.method}${config.webhookPath ? ` ${config.webhookPath}` : ""}`;
-  }
-};
-
-// src/rules/configContracts.ts
-var asValidator = (fn) => (config) => fn(config);
-var CONFIG_CONTRACTS = {
-  console_log: { schema: ConsoleLogConfig.schema, validate: asValidator(ConsoleLogConfig.validate) },
-  delay: { schema: DelayConfig.schema, validate: asValidator(DelayConfig.validate) },
-  http_request: { schema: HTTPRequestConfig.schema, validate: asValidator(HTTPRequestConfig.validate) },
-  email: { schema: EmailConfig.schema, validate: asValidator(EmailConfig.validate) },
-  google_chat: { schema: GoogleChatConfig.schema, validate: asValidator(GoogleChatConfig.validate) },
-  slack_message: { schema: SlackMessageConfig.schema, validate: asValidator(SlackMessageConfig.validate) },
-  teams_message: { schema: TeamsMessageConfig.schema, validate: asValidator(TeamsMessageConfig.validate) },
-  webhook_call: { schema: WebhookCallConfig.schema, validate: asValidator(WebhookCallConfig.validate) },
-  whatsapp_send: { schema: WhatsappSendConfig.schema, validate: asValidator(WhatsappSendConfig.validate) },
-  query: {
-    schema: BuildQueryContractSchema,
-    validate: (config) => {
-      const r = validateBuildQueryConfig(config);
-      const errors = (r.errors ?? []).filter((e) => e.severity !== "warning").map((e) => e.message);
-      return { valid: errors.length === 0, errors };
+    const roots = g.bodyStepIds.filter((id) => (inDeg.get(id) ?? 0) === 0);
+    const leaves = g.bodyStepIds.filter((id) => (outDeg.get(id) ?? 0) === 0);
+    for (const rootId of roots) {
+      flatConns.push({
+        id: `synth-inner-in-${g.group.id}-${rootId}`,
+        sourceStepId: g.group.id,
+        targetStepId: rootId,
+        sourcePort: "_inner_in"
+      });
     }
-  },
-  transform: { schema: TransformConfig.schema, validate: asValidator(TransformConfig.validate) },
-  aggregate: { schema: AggregateConfig.schema, validate: asValidator(AggregateConfig.validate) },
-  condition: { schema: ConditionConfig.schema, validate: asValidator(ConditionConfig.validate) },
-  for_each: { schema: ForEachConfig.schema, validate: asValidator(ForEachConfig.validate) },
-  manual_trigger: { schema: ManualTriggerConfig.schema, validate: asValidator(ManualTriggerConfig.validate) },
-  schedule_trigger: { schema: ScheduleTriggerConfig.schema, validate: asValidator(ScheduleTriggerConfig.validate) },
-  webhook_trigger: { schema: WebhookTriggerConfig.schema, validate: asValidator(WebhookTriggerConfig.validate) },
-  debug: { schema: DebugConfig.schema, validate: asValidator(DebugConfig.validate) },
-  variables: { schema: VariablesConfig.schema, validate: asValidator(VariablesConfig.validate) },
-  ai_agent: { schema: AiAgentConfig.schema, validate: asValidator(AiAgentConfig.validate) },
-  idp_extract: { schema: IdpExtractConfig.schema, validate: asValidator(IdpExtractConfig.validate) },
-  group: { schema: GroupConfig.schema, validate: asValidator(GroupConfig.validate) },
-  connector_trigger: { schema: ConnectorTriggerConfig.schema, validate: asValidator(ConnectorTriggerConfig.validate) },
-  csv_action: { schema: CsvActionConfig.schema, validate: asValidator(CsvActionConfig.validate) },
-  json_action: { schema: JsonActionConfig.schema, validate: asValidator(JsonActionConfig.validate) },
-  xml_action: { schema: XmlActionConfig.schema, validate: asValidator(XmlActionConfig.validate) },
-  excel_action: { schema: ExcelActionConfig.schema, validate: asValidator(ExcelActionConfig.validate) },
-  storage_action: { schema: StorageActionConfig.schema, validate: asValidator(StorageActionConfig.validate) },
-  s3_action: { schema: S3ActionConfig.schema, validate: asValidator(S3ActionConfig.validate) },
-  ftp_action: { schema: FtpActionConfig.schema, validate: asValidator(FtpActionConfig.validate) },
-  google_drive_action: { schema: GoogleDriveActionConfig.schema, validate: asValidator(GoogleDriveActionConfig.validate) },
-  dropbox_action: { schema: DropboxActionConfig.schema, validate: asValidator(DropboxActionConfig.validate) },
-  onedrive_action: { schema: OneDriveActionConfig.schema, validate: asValidator(OneDriveActionConfig.validate) }
-};
-function contractFor(actionId) {
-  return actionId ? CONFIG_CONTRACTS[actionId] : undefined;
-}
-function declaredKeys(actionId) {
-  const c = contractFor(actionId);
-  if (!c)
-    return [];
-  return Object.entries(c.schema).filter(([, f]) => f.type !== "none").map(([k]) => k);
+    for (const leafId of leaves) {
+      flatConns.push({
+        id: `synth-inner-out-${leafId}-${g.group.id}`,
+        sourceStepId: leafId,
+        targetStepId: g.group.id,
+        targetPort: "_inner_out"
+      });
+    }
+  }
+  return { ...workflow, steps: flatSteps, connections: flatConns };
 }
-function isEditorPrivateKey(key) {
-  return key.startsWith("_");
+
+// src/rules/flowShape.ts
+function transformStepToNode(step) {
+  const stepType = step.type;
+  const stepActionDefId = step.actionDefinitionId ?? "";
+  const nodeType = stepType === "trigger" ? "trigger" : stepType === "group" || stepActionDefId === "group" ? "group" : "action";
+  let nodeStatus = "idle" /* Idle */;
+  switch (step.status?.toLowerCase()) {
+    case "running":
+    case "executing":
+      nodeStatus = "running" /* Running */;
+      break;
+    case "completed":
+    case "success":
+      nodeStatus = "success" /* Success */;
+      break;
+    case "failed":
+    case "error":
+      nodeStatus = "error" /* Error */;
+      break;
+    case "pending":
+    case "waiting":
+      nodeStatus = "idle" /* Idle */;
+      break;
+    default:
+      nodeStatus = "idle" /* Idle */;
+  }
+  const position = step.position || { x: step.position_x || 0, y: step.position_y || 0 };
+  const posX = typeof position === "object" && position !== null && "x" in position ? position.x : step.position_x || 0;
+  const posY = typeof position === "object" && position !== null && "y" in position ? position.y : step.position_y || 0;
+  const config = step.config || {};
+  const configData = config.data || config || {};
+  const derivedFromName = step.name ? step.name.toLowerCase().replace(/\s+/g, "_") : undefined;
+  const resolvedActionDefinitionId = step.actionDefinitionId || config.connector_id || step.connector_id || derivedFromName || step.type;
+  const actionDef = getActionById(resolvedActionDefinitionId);
+  const node = {
+    id: step.id,
+    type: nodeType,
+    actionDefinitionId: resolvedActionDefinitionId,
+    actionDefinition: actionDef,
+    label: step.label || step.name,
+    description: step.description || config.description || actionDef?.description || "",
+    icon: actionDef?.icon ?? getIconForStepType(step.type),
+    position: {
+      x: posX,
+      y: posY
+    },
+    ...step.parentId ? { parentId: step.parentId } : {},
+    ...step.extent ? { extent: step.extent } : {},
+    ...step.disabled ? { disabled: true } : {},
+    ...step.dimensions && nodeType === "group" ? { dimensions: step.dimensions } : nodeType === "group" ? { dimensions: { width: 480, height: 240 } } : {},
+    config: {
+      ...configData,
+      timeout: step.timeout_seconds,
+      retryPolicy: step.retry_policy,
+      notes: step.notes,
+      tags: step.tags,
+      stepCount: step.step_count
+    },
+    ports: {
+      input: nodeType === "action" || nodeType === "group" ? [
+        {
+          id: `${step.id}-input`,
+          type: "input",
+          position: "top",
+          connected: false
+        }
+      ] : [],
+      output: (() => {
+        if (resolvedActionDefinitionId === "condition") {
+          return [
+            { id: `${step.id}_output_true`, type: "output", position: "bottom", label: "True", connected: false },
+            { id: `${step.id}_output_false`, type: "output", position: "bottom", label: "False", connected: false }
+          ];
+        }
+        if (resolvedActionDefinitionId === "for_each" || resolvedActionDefinitionId === "for-each") {
+          return [
+            { id: `${step.id}_output_each`, type: "output", position: "bottom", label: "Each", connected: false },
+            { id: `${step.id}_output_done`, type: "output", position: "bottom", label: "Done", connected: false }
+          ];
+        }
+        if (resolvedActionDefinitionId === "group") {
+          return [
+            { id: `${step.id}_output_0`, type: "output", position: "bottom", connected: false }
+          ];
+        }
+        return [
+          { id: `${step.id}-output`, type: "output", position: "bottom", connected: false }
+        ];
+      })()
+    },
+    configStatus: step.configStatus || undefined,
+    ...step.outputSchema ? { outputSchema: step.outputSchema } : {},
+    status: nodeStatus,
+    selected: false,
+    dragging: false,
+    isValid: step.configStatus ? step.configStatus === "valid" : true,
+    expanded: step.expanded,
+    minimized: false,
+    locked: false,
+    createdAt: step.created_at || new Date().toISOString(),
+    updatedAt: step.updated_at || new Date().toISOString()
+  };
+  return node;
 }
-var CONTRACT_TYPE_TO_FIELD_TYPE = {
-  string: "string" /* String */,
-  text: "string" /* String */,
-  select: "select" /* Select */,
-  json: "json" /* JSON */,
-  connection: "connection" /* Connection */,
-  number: "number" /* Number */,
-  boolean: "boolean" /* Boolean */,
-  array: "array" /* Array */,
-  object: "object" /* Object */,
-  url: "url" /* URL */,
-  expression: "expression" /* Expression */,
-  code: "code" /* Code */
-};
-function humanise(key) {
-  return key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+function transformConnectionToEdge(connection) {
+  const sourceStepId = connection.sourceStepId || connection.source_step_id;
+  const targetStepId = connection.targetStepId || connection.target_step_id;
+  const sourcePort = connection.sourcePort || connection.source_port || `${sourceStepId}-output`;
+  const targetPort = connection.targetPort || connection.target_port || `${targetStepId}-input`;
+  let edgeType = "default" /* Default */;
+  if (connection.type === "success" || connection.type === "failure") {
+    edgeType = "conditional" /* Conditional */;
+  }
+  return {
+    id: connection.id,
+    source: sourceStepId,
+    target: targetStepId,
+    sourcePort,
+    targetPort,
+    type: edgeType,
+    label: connection.label,
+    selected: false,
+    animated: false,
+    createdAt: new Date().toISOString()
+  };
 }
-function contractFieldsFor(definition) {
-  const declared = definition.inputSchema?.fields ?? [];
-  const contract = contractFor(definition.id);
-  if (!contract)
-    return declared;
-  const seen = new Set(declared.map((f) => f.key));
-  const derived = [];
-  for (const [key, field] of Object.entries(contract.schema)) {
-    if (seen.has(key) || field.type === "none")
-      continue;
-    derived.push({
-      key,
-      label: humanise(key),
-      type: CONTRACT_TYPE_TO_FIELD_TYPE[field.type] ?? "string" /* String */,
-      validation: { required: field.required === true },
-      ...typeof field.description === "string" && field.description ? { description: field.description } : {},
-      ...field.options ? { options: field.options.map((v) => ({ label: String(v), value: v })) } : {}
+function generateConnectionsFromSteps(steps) {
+  const connections = [];
+  const sortedSteps = [...steps].sort((a, b) => a.step_count - b.step_count);
+  for (let i = 0;i < sortedSteps.length - 1; i++) {
+    const sourceStep = sortedSteps[i];
+    const targetStep = sortedSteps[i + 1];
+    connections.push({
+      id: `${sourceStep.id}-${targetStep.id}`,
+      source_step_id: sourceStep.id,
+      target_step_id: targetStep.id,
+      source_port: `${sourceStep.id}-output`,
+      target_port: `${targetStep.id}-input`,
+      type: "default"
     });
   }
-  return [...declared, ...derived];
-}
-function selectsWithoutValues(actionId) {
-  const contract = contractFor(actionId);
-  if (!contract)
-    return [];
-  return Object.entries(contract.schema).filter(([, f]) => f.type === "select" && !(f.options && f.options.length > 0) && f.dynamic !== true).map(([key]) => key);
+  return connections;
 }
-function contractDrift(definition) {
-  const contract = contractFor(definition.id);
-  if (!contract)
-    return [];
-  const covers = (key) => {
-    if (key in contract.schema)
-      return true;
-    const root = key.split(".")[0];
-    const rootField = contract.schema[root];
-    return !!rootField && (rootField.type === "object" || rootField.type === "json");
+function getIconForStepType(type) {
+  const iconMap = {
+    trigger: "PlayOutline",
+    transform: "Transform",
+    action: "Application",
+    condition: "DecisionTree",
+    loop: "Repeat"
   };
-  return (definition.inputSchema?.fields ?? []).map((f) => f.key).filter((k) => !covers(k));
+  return iconMap[type] || "Application";
 }
-function contractVocabularyDrift(actionId) {
-  const c = contractFor(actionId);
-  if (!c)
-    return [];
-  const known = new Set([...Object.keys(CONTRACT_TYPE_TO_FIELD_TYPE), "none"]);
-  return Object.entries(c.schema).filter(([, f]) => !known.has(f.type)).map(([k, f]) => `${k}:${f.type}`);
+function transformFlowToWorkflow(flow) {
+  const flatWorkflow = flattenNestedWorkflow(flow.workflow);
+  const nodes = flatWorkflow.steps.map((step) => transformStepToNode(step));
+  let connections = flatWorkflow.connections;
+  if (connections === undefined || connections === null) {
+    connections = generateConnectionsFromSteps(flatWorkflow.steps);
+  } else {
+    connections = connections || [];
+  }
+  const edges = connections.map((conn, index) => {
+    if (!conn.id) {
+      conn.id = `edge-${conn.source_step_id}-${conn.target_step_id}-${index}`;
+    }
+    return transformConnectionToEdge(conn);
+  });
+  edges.forEach((edge) => {
+    const sourceNode = nodes.find((n) => n.id === edge.source);
+    const targetNode = nodes.find((n) => n.id === edge.target);
+    if (sourceNode) {
+      const port = sourceNode.ports.output.find((p) => p.id === edge.sourcePort);
+      if (port)
+        port.connected = true;
+    }
+    if (targetNode) {
+      const port = targetNode.ports.input.find((p) => p.id === edge.targetPort);
+      if (port)
+        port.connected = true;
+    }
+  });
+  return {
+    id: flow.workflow.id,
+    name: flow.workflow.name,
+    description: flow.workflow.description,
+    nodes,
+    edges,
+    workflowHistory: flow.workflowHistory || []
+  };
 }
-function contractDerivedKeys(definition) {
-  const own = new Set((definition.inputSchema?.fields ?? []).map((f) => f.key));
-  return new Set(contractFieldsFor(definition).map((f) => f.key).filter((k) => !own.has(k)));
+function validateFlowData(flow) {
+  if (!flow || typeof flow !== "object")
+    return false;
+  const f = flow;
+  return typeof f.id === "string" && typeof f.name === "string" && f.workflow !== undefined && typeof f.workflow === "object" && f.workflow !== null && Array.isArray(f.workflow.steps);
 }
-
 // src/rules/configSafety.ts
 var MAX_STEP_CONFIG_BYTES = 256 * 1024;
 var FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);