@solidxai/core 0.1.13-beta.2 → 0.1.13-beta.21

package/dist/services/workflow/nodes/for-each.node.js

@@ -13,27 +13,101 @@ let ForEachNode = class ForEachNode {
     async execute(context) {
         const configuration = context.node.configuration ?? {};
         const items = context.expression.interpolate(configuration.items ?? [], context);
+        const concurrencyLimit = this.resolveConcurrencyLimit(context.expression.interpolate(configuration.concurrencyLimit ?? 1, context));
+        const aggregateOutputs = Boolean(context.expression.interpolate(configuration.aggregateOutputs ?? false, context));
         if (!Array.isArray(items)) {
             throw new common_1.BadRequestException('forEach requires configuration.items array.');
         }
         const childNodes = context.node.tasks ?? [];
-        for (let index = 0; index < items.length; index++) {
+        const iterationsByIndex = {};
+        const iterationsByKey = {};
+        const shouldAggregateByKey = aggregateOutputs && configuration.outputKey !== undefined && configuration.outputKey !== null;
+        await this.runIterations(items, concurrencyLimit, async (item, index) => {
             const inheritedOutputs = context.outputs ?? {};
             const iterationOutputs = { ...inheritedOutputs };
-            await context.runNodes(childNodes, {
-                item: items[index],
+            const parentLoops = context.loops ?? [];
+            const currentLoop = {
+                item,
                 index,
+                nodeId: context.node.id,
+                stepExecutionKey: context.stepExecution.stepExecutionKey,
+            };
+            const loopContext = {
+                item,
+                index,
+                parent: parentLoops[parentLoops.length - 1],
+                parents: [...parentLoops].reverse(),
+                loops: [...parentLoops, currentLoop],
+            };
+            const outputKey = shouldAggregateByKey
+                ? String(context.expression.interpolate(configuration.outputKey, {
+                    ...context,
+                    ...loopContext,
+                    outputs: iterationOutputs,
+                }))
+                : undefined;
+            const childOutputs = await context.runNodes(childNodes, {
+                ...loopContext,
                 outputs: iterationOutputs,
             });
-        }
+            if (aggregateOutputs) {
+                const iterationResult = {
+                    item,
+                    index,
+                    outputs: childOutputs,
+                };
+                iterationsByIndex[index] = iterationResult;
+                if (outputKey !== undefined) {
+                    iterationsByKey[outputKey] = iterationResult;
+                }
+            }
+        });
         return {
             output: {
                 count: items.length,
                 childNodeIds: childNodes.map((childNode) => childNode.id),
-                iterationOutputsStoredOnSteps: true,
+                concurrencyLimit,
+                iterationOutputsStoredOnSteps: !aggregateOutputs,
+                ...(aggregateOutputs
+                    ? {
+                        iterations: {
+                            byIndex: iterationsByIndex,
+                            ...(shouldAggregateByKey
+                                ? {
+                                    byKey: iterationsByKey,
+                                }
+                                : {}),
+                        },
+                    }
+                    : {}),
             },
         };
     }
+    resolveConcurrencyLimit(value) {
+        const parsed = Number(value === '' || value === null || value === undefined ? 1 : value);
+        if (!Number.isFinite(parsed) || parsed < 0) {
+            throw new common_1.BadRequestException('forEach configuration.concurrencyLimit must be 0 or a positive number.');
+        }
+        return Math.floor(parsed);
+    }
+    async runIterations(items, concurrencyLimit, handler) {
+        if (concurrencyLimit === 1 || items.length <= 1) {
+            for (let index = 0; index < items.length; index++) {
+                await handler(items[index], index);
+            }
+            return;
+        }
+        const limit = concurrencyLimit === 0 ? items.length : concurrencyLimit;
+        let nextIndex = 0;
+        const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+            while (nextIndex < items.length) {
+                const index = nextIndex;
+                nextIndex += 1;
+                await handler(items[index], index);
+            }
+        });
+        await Promise.all(workers);
+    }
 };
 exports.ForEachNode = ForEachNode;
 exports.ForEachNode = ForEachNode = __decorate([
@@ -47,6 +121,8 @@ exports.ForEachNode = ForEachNode = __decorate([
         authoring: {
             defaultConfiguration: {
                 items: '',
+                concurrencyLimit: 1,
+                aggregateOutputs: false,
             },
             configurationFields: [
                 {
@@ -63,6 +139,32 @@ exports.ForEachNode = ForEachNode = __decorate([
                         },
                     },
                 },
+                {
+                    key: 'concurrencyLimit',
+                    label: 'Concurrency Limit',
+                    description: 'Maximum number of loop iterations to run at once. Use 1 for sequential execution and 0 for unlimited concurrency.',
+                    valueType: 'number',
+                    defaultValue: 1,
+                    expressionAllowed: true,
+                    group: 'General',
+                },
+                {
+                    key: 'aggregateOutputs',
+                    label: 'Aggregate Outputs',
+                    description: 'Adds per-iteration child outputs to this forEach node output for downstream expressions.',
+                    valueType: 'boolean',
+                    defaultValue: false,
+                    expressionAllowed: true,
+                    group: 'General',
+                },
+                {
+                    key: 'outputKey',
+                    label: 'Output Key',
+                    description: 'Optional expression used as the per-iteration key when aggregate outputs is enabled.',
+                    valueType: 'string',
+                    expressionAllowed: true,
+                    group: 'General',
+                },
             ],
             childSlots: [
                 {
@@ -73,6 +175,13 @@ exports.ForEachNode = ForEachNode = __decorate([
                     layout: 'sequential',
                     required: true,
                 },
+                {
+                    key: 'errors',
+                    label: 'Errors',
+                    description: 'Nodes that run sequentially if this loop fails.',
+                    kind: 'sequence',
+                    layout: 'sequential',
+                },
             ],
             supportsDescription: true,
             supportsName: true,

package/dist/services/workflow/nodes/for-each.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"for-each.node.js","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/for-each.node.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAqD;AACrD,2GAA4F;AA6DrF,IAAM,WAAW,GAAjB,MAAM,WAAW;IACtB,KAAK,CAAC,OAAO,CACX,OAAqC;QAErC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAEjF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,4BAAmB,CAAC,6CAA6C,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAE5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAG,EAAE,GAAG,gBAAgB,EAAE,CAAC;YAEjD,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE;gBACjC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;gBAClB,KAAK;gBACL,OAAO,EAAE,gBAAgB;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM,EAAE;gBACN,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;gBAGzD,6BAA6B,EAAE,IAAI;aACpC;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAlCY,kCAAW;sBAAX,WAAW;IAtDvB,IAAA,uDAAoB,EAAC;QACpB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;QAC3B,SAAS,EAAE;YACT,oBAAoB,EAAE;gBACpB,KAAK,EAAE,EAAE;aACV;YACD,mBAAmB,EAAE;gBACnB;oBACE,GAAG,EAAE,OAAO;oBACZ,KAAK,EAAE,OAAO;oBACd,WAAW,EAAE,4DAA4D;oBACzE,SAAS,EAAE,QAAQ;oBACnB,QAAQ,EAAE,IAAI;oBACd,iBAAiB,EAAE,IAAI;oBACvB,KAAK,EAAE,SAAS;oBAChB,QAAQ,EAAE;wBACR,MAAM,EAAE;4BACN,KAAK,EAAE,MAAM;yBACd;qBACF;iBACF;aACF;YACD,UAAU,EAAE;gBACV;oBACE,GAAG,EAAE,OAAO;oBACZ,KAAK,EAAE,WAAW;oBAClB,WAAW,EAAE,oCAAoC;oBACjD,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,YAAY;oBACpB,QAAQ,EAAE,IAAI;iBACf;aACF;YACD,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,IAAI;SACnB;QACD,aAAa,EAAE;YACb,OAAO,EAAE,mEAAmE;SAC7E;QACD,EAAE,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,SAAS;YACpB,mBAAmB,EAAE,SAAS;YAC9B,eAAe,EAAE,SAAS;YAC1B,SAAS,EAAE,IAAI;YACf,WAAW,EAAE;gBACX,UAAU,EAAE,CAAC,SAAS,CAAC;aACxB;SACF;KACF,CAAC;GACW,WAAW,CAkCvB","sourcesContent":["import { BadRequestException } from '@nestjs/common';\nimport { WorkflowNodeProvider } from '../../../decorators/workflow-node-provider.decorator';\nimport { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';\nimport {\n  WorkflowNodeExecutionContext,\n  WorkflowNodeHandlerResult,\n} from '../../../types/workflow-dsl.types';\n\n@WorkflowNodeProvider({\n  type: 'forEach',\n  kind: 'control',\n  category: 'control-flow',\n  label: 'For Each',\n  description: 'Runs child nodes once for every item in an array.',\n  tags: ['loop', 'iteration'],\n  authoring: {\n    defaultConfiguration: {\n      items: '',\n    },\n    configurationFields: [\n      {\n        key: 'items',\n        label: 'Items',\n        description: 'Array or expression resolving to an array to iterate over.',\n        valueType: 'string',\n        required: true,\n        expressionAllowed: true,\n        group: 'General',\n        uiSchema: {\n          layout: {\n            width: 'full',\n          },\n        },\n      },\n    ],\n    childSlots: [\n      {\n        key: 'tasks',\n        label: 'Loop Body',\n        description: 'Nodes that run once for each item.',\n        kind: 'sequence',\n        layout: 'sequential',\n        required: true,\n      },\n    ],\n    supportsDescription: true,\n    supportsName: true,\n  },\n  documentation: {\n    summary: 'Iterates over an array and runs the loop body once for each item.',\n  },\n  ui: {\n    icon: 'si-refresh',\n    iconColor: '#7c3aed',\n    iconBackgroundColor: '#f3e8ff',\n    iconBorderColor: '#d8b4fe',\n    modalSize: 'lg',\n    layoutHints: {\n      groupOrder: ['General'],\n    },\n  },\n})\nexport class ForEachNode implements WorkflowNodeHandler {\n  async execute(\n    context: WorkflowNodeExecutionContext,\n  ): Promise<WorkflowNodeHandlerResult> {\n    const configuration = context.node.configuration ?? {};\n    const items = context.expression.interpolate(configuration.items ?? [], context);\n\n    if (!Array.isArray(items)) {\n      throw new BadRequestException('forEach requires configuration.items array.');\n    }\n\n    const childNodes = context.node.tasks ?? [];\n\n    for (let index = 0; index < items.length; index++) {\n      const inheritedOutputs = context.outputs ?? {};\n      const iterationOutputs = { ...inheritedOutputs };\n\n      await context.runNodes(childNodes, {\n        item: items[index],\n        index,\n        outputs: iterationOutputs,\n      });\n    }\n\n    return {\n      output: {\n        count: items.length,\n        childNodeIds: childNodes.map((childNode) => childNode.id),\n        // Keep the control-node output intentionally small. Per-iteration\n        // outputs are already stored on the child workflowStepExecution rows.\n        iterationOutputsStoredOnSteps: true,\n      },\n    };\n  }\n}\n"]}
+{"version":3,"file":"for-each.node.js","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/for-each.node.ts"],"names":[],"mappings":"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","sourcesContent":["import { BadRequestException } from '@nestjs/common';\nimport { WorkflowNodeProvider } from '../../../decorators/workflow-node-provider.decorator';\nimport { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';\nimport {\n  WorkflowNodeExecutionContext,\n  WorkflowNodeHandlerResult,\n} from '../../../types/workflow-dsl.types';\n\n@WorkflowNodeProvider({\n  type: 'forEach',\n  kind: 'control',\n  category: 'control-flow',\n  label: 'For Each',\n  description: 'Runs child nodes once for every item in an array.',\n  tags: ['loop', 'iteration'],\n  authoring: {\n    defaultConfiguration: {\n      items: '',\n      concurrencyLimit: 1,\n      aggregateOutputs: false,\n    },\n    configurationFields: [\n      {\n        key: 'items',\n        label: 'Items',\n        description: 'Array or expression resolving to an array to iterate over.',\n        valueType: 'string',\n        required: true,\n        expressionAllowed: true,\n        group: 'General',\n        uiSchema: {\n          layout: {\n            width: 'full',\n          },\n        },\n      },\n      {\n        key: 'concurrencyLimit',\n        label: 'Concurrency Limit',\n        description:\n          'Maximum number of loop iterations to run at once. Use 1 for sequential execution and 0 for unlimited concurrency.',\n        valueType: 'number',\n        defaultValue: 1,\n        expressionAllowed: true,\n        group: 'General',\n      },\n      {\n        key: 'aggregateOutputs',\n        label: 'Aggregate Outputs',\n        description:\n          'Adds per-iteration child outputs to this forEach node output for downstream expressions.',\n        valueType: 'boolean',\n        defaultValue: false,\n        expressionAllowed: true,\n        group: 'General',\n      },\n      {\n        key: 'outputKey',\n        label: 'Output Key',\n        description:\n          'Optional expression used as the per-iteration key when aggregate outputs is enabled.',\n        valueType: 'string',\n        expressionAllowed: true,\n        group: 'General',\n      },\n    ],\n    childSlots: [\n      {\n        key: 'tasks',\n        label: 'Loop Body',\n        description: 'Nodes that run once for each item.',\n        kind: 'sequence',\n        layout: 'sequential',\n        required: true,\n      },\n      {\n        key: 'errors',\n        label: 'Errors',\n        description: 'Nodes that run sequentially if this loop fails.',\n        kind: 'sequence',\n        layout: 'sequential',\n      },\n    ],\n    supportsDescription: true,\n    supportsName: true,\n  },\n  documentation: {\n    summary: 'Iterates over an array and runs the loop body once for each item.',\n  },\n  ui: {\n    icon: 'si-refresh',\n    iconColor: '#7c3aed',\n    iconBackgroundColor: '#f3e8ff',\n    iconBorderColor: '#d8b4fe',\n    modalSize: 'lg',\n    layoutHints: {\n      groupOrder: ['General'],\n    },\n  },\n})\nexport class ForEachNode implements WorkflowNodeHandler {\n  async execute(\n    context: WorkflowNodeExecutionContext,\n  ): Promise<WorkflowNodeHandlerResult> {\n    const configuration = context.node.configuration ?? {};\n    const items = context.expression.interpolate(configuration.items ?? [], context);\n    const concurrencyLimit = this.resolveConcurrencyLimit(\n      context.expression.interpolate(configuration.concurrencyLimit ?? 1, context),\n    );\n    const aggregateOutputs = Boolean(\n      context.expression.interpolate(configuration.aggregateOutputs ?? false, context),\n    );\n\n    if (!Array.isArray(items)) {\n      throw new BadRequestException('forEach requires configuration.items array.');\n    }\n\n    const childNodes = context.node.tasks ?? [];\n    const iterationsByIndex: Record<number, any> = {};\n    const iterationsByKey: Record<string, any> = {};\n    const shouldAggregateByKey =\n      aggregateOutputs && configuration.outputKey !== undefined && configuration.outputKey !== null;\n\n    await this.runIterations(items, concurrencyLimit, async (item, index) => {\n      const inheritedOutputs = context.outputs ?? {};\n      const iterationOutputs = { ...inheritedOutputs };\n      const parentLoops = context.loops ?? [];\n      const currentLoop = {\n        item,\n        index,\n        nodeId: context.node.id,\n        stepExecutionKey: context.stepExecution.stepExecutionKey,\n      };\n      const loopContext = {\n        item,\n        index,\n        parent: parentLoops[parentLoops.length - 1],\n        parents: [...parentLoops].reverse(),\n        loops: [...parentLoops, currentLoop],\n      };\n      const outputKey = shouldAggregateByKey\n        ? String(context.expression.interpolate(configuration.outputKey, {\n            ...context,\n            ...loopContext,\n            outputs: iterationOutputs,\n          }))\n        : undefined;\n\n      const childOutputs = await context.runNodes(childNodes, {\n        ...loopContext,\n        outputs: iterationOutputs,\n      });\n\n      if (aggregateOutputs) {\n        const iterationResult = {\n          item,\n          index,\n          outputs: childOutputs,\n        };\n\n        iterationsByIndex[index] = iterationResult;\n        if (outputKey !== undefined) {\n          iterationsByKey[outputKey] = iterationResult;\n        }\n      }\n    });\n\n    return {\n      output: {\n        count: items.length,\n        childNodeIds: childNodes.map((childNode) => childNode.id),\n        concurrencyLimit,\n        // Keep the control-node output intentionally small. Per-iteration\n        // outputs are already stored on the child workflowStepExecution rows.\n        iterationOutputsStoredOnSteps: !aggregateOutputs,\n        ...(aggregateOutputs\n          ? {\n              iterations: {\n                byIndex: iterationsByIndex,\n                ...(shouldAggregateByKey\n                  ? {\n                      byKey: iterationsByKey,\n                    }\n                  : {}),\n              },\n            }\n          : {}),\n      },\n    };\n  }\n\n  private resolveConcurrencyLimit(value: any): number {\n    const parsed = Number(value === '' || value === null || value === undefined ? 1 : value);\n    if (!Number.isFinite(parsed) || parsed < 0) {\n      throw new BadRequestException(\n        'forEach configuration.concurrencyLimit must be 0 or a positive number.',\n      );\n    }\n\n    return Math.floor(parsed);\n  }\n\n  private async runIterations<T>(\n    items: T[],\n    concurrencyLimit: number,\n    handler: (item: T, index: number) => Promise<void>,\n  ): Promise<void> {\n    if (concurrencyLimit === 1 || items.length <= 1) {\n      for (let index = 0; index < items.length; index++) {\n        await handler(items[index], index);\n      }\n      return;\n    }\n\n    const limit = concurrencyLimit === 0 ? items.length : concurrencyLimit;\n    let nextIndex = 0;\n\n    const workers = Array.from(\n      { length: Math.min(limit, items.length) },\n      async () => {\n        while (nextIndex < items.length) {\n          const index = nextIndex;\n          nextIndex += 1;\n          await handler(items[index], index);\n        }\n      },\n    );\n\n    await Promise.all(workers);\n  }\n}\n"]}

package/dist/services/workflow/nodes/if.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"if.node.d.ts","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/if.node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mCAAmC,CAAC;AAE3C,qBAwDa,MAAO,YAAW,mBAAmB;IAC1C,OAAO,CACX,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC;CA0BtC"}
+{"version":3,"file":"if.node.d.ts","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/if.node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mCAAmC,CAAC;AAE3C,qBA+Da,MAAO,YAAW,mBAAmB;IAC1C,OAAO,CACX,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC;CA0BtC"}

package/dist/services/workflow/nodes/if.node.js

@@ -71,6 +71,13 @@ exports.IfNode = IfNode = __decorate([
                     description: 'Nodes that run when the condition evaluates to false.',
                     kind: 'sequence',
                 },
+                {
+                    key: 'errors',
+                    label: 'Errors',
+                    description: 'Nodes that run sequentially if the selected branch fails.',
+                    kind: 'sequence',
+                    layout: 'sequential',
+                },
             ],
             supportsDescription: true,
             supportsName: true,

package/dist/services/workflow/nodes/if.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"if.node.js","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/if.node.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2GAA4F;AA+DrF,IAAM,MAAM,GAAZ,MAAM,MAAM;IACjB,KAAK,CAAC,OAAO,CACX,OAAqC;QAErC,MAAM,SAAS,GACb,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS;YACrC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzE,MAAM,aAAa,GAAG,OAAO;YAC3B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;YACzB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAE5B,MAAM,OAAO,CAAC,OAAO,CAAC;YACpB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,mBAAmB;YAC9B,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,YAAY,OAAO,CAAC,IAAI,CAAC,EAAE,kBAAkB,OAAO,GAAG;YAChE,OAAO,EAAE,EAAE,SAAS,EAAE;SACvB,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAEtC,OAAO;YACL,MAAM,EAAE;gBACN,OAAO;gBACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;aAClC;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA7BY,wBAAM;iBAAN,MAAM;IAxDlB,IAAA,uDAAoB,EAAC;QACpB,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,8DAA8D;QAC3E,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QAChC,SAAS,EAAE;YACT,oBAAoB,EAAE;gBACpB,SAAS,EAAE,qCAAqC;aACjD;YACD,mBAAmB,EAAE;gBACnB;oBACE,GAAG,EAAE,WAAW;oBAChB,KAAK,EAAE,WAAW;oBAClB,WAAW,EAAE,iEAAiE;oBAC9E,SAAS,EAAE,YAAY;oBACvB,QAAQ,EAAE,IAAI;oBACd,iBAAiB,EAAE,IAAI;oBACvB,UAAU,EAAE,UAAU;oBACtB,KAAK,EAAE,SAAS;iBACjB;aACF;YACD,UAAU,EAAE;gBACV;oBACE,GAAG,EAAE,MAAM;oBACX,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,sDAAsD;oBACnE,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,IAAI;iBACf;gBACD;oBACE,GAAG,EAAE,MAAM;oBACX,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,uDAAuD;oBACpE,IAAI,EAAE,UAAU;iBACjB;aACF;YACD,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,IAAI;SACnB;QACD,aAAa,EAAE;YACb,OAAO,EACL,6OAA6O;SAChP;QACD,EAAE,EAAE;YACF,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;YACpB,mBAAmB,EAAE,SAAS;YAC9B,eAAe,EAAE,SAAS;YAC1B,SAAS,EAAE,IAAI;YACf,WAAW,EAAE;gBACX,UAAU,EAAE,CAAC,SAAS,CAAC;aACxB;SACF;KACF,CAAC;GACW,MAAM,CA6BlB","sourcesContent":["import { WorkflowNodeProvider } from '../../../decorators/workflow-node-provider.decorator';\nimport { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';\nimport {\n  WorkflowNodeExecutionContext,\n  WorkflowNodeHandlerResult,\n} from '../../../types/workflow-dsl.types';\n\n@WorkflowNodeProvider({\n  type: 'if',\n  kind: 'control',\n  category: 'control-flow',\n  label: 'If',\n  description: 'Runs then or else child nodes based on a boolean expression.',\n  tags: ['branching', 'condition'],\n  authoring: {\n    defaultConfiguration: {\n      condition: '{{ input.shouldContinue === true }}',\n    },\n    configurationFields: [\n      {\n        key: 'condition',\n        label: 'Condition',\n        description: 'Boolean expression evaluated by the workflow expression engine.',\n        valueType: 'expression',\n        required: true,\n        expressionAllowed: true,\n        widgetHint: 'textarea',\n        group: 'General',\n      },\n    ],\n    childSlots: [\n      {\n        key: 'then',\n        label: 'Then',\n        description: 'Nodes that run when the condition evaluates to true.',\n        kind: 'sequence',\n        required: true,\n      },\n      {\n        key: 'else',\n        label: 'Else',\n        description: 'Nodes that run when the condition evaluates to false.',\n        kind: 'sequence',\n      },\n    ],\n    supportsDescription: true,\n    supportsName: true,\n  },\n  documentation: {\n    summary:\n      'Conditionally branches workflow execution into then or else node sequences. The node evaluates a boolean expression and executes either the then or else child sequence. Sequence order inside each branch remains implicit by array order.',\n  },\n  ui: {\n    icon: 'si-code',\n    iconColor: '#4f46e5',\n    iconBackgroundColor: '#eef2ff',\n    iconBorderColor: '#c7d2fe',\n    modalSize: 'lg',\n    layoutHints: {\n      groupOrder: ['General'],\n    },\n  },\n})\nexport class IfNode implements WorkflowNodeHandler {\n  async execute(\n    context: WorkflowNodeExecutionContext,\n  ): Promise<WorkflowNodeHandlerResult> {\n    const condition =\n      context.node.configuration?.condition ??\n      context.node.configuration?.expression;\n    const matched = context.expression.evaluateCondition(condition, context);\n    const selectedNodes = matched\n      ? context.node.then ?? []\n      : context.node.else ?? [];\n\n    await context.emitLog({\n      level: 'info',\n      eventType: 'node.if.evaluated',\n      source: 'if',\n      message: `If node \"${context.node.id}\" evaluated to ${matched}.`,\n      context: { condition },\n    });\n\n    await context.runNodes(selectedNodes);\n\n    return {\n      output: {\n        matched,\n        branch: matched ? 'then' : 'else',\n      },\n    };\n  }\n}\n"]}
+{"version":3,"file":"if.node.js","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/if.node.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2GAA4F;AAsErF,IAAM,MAAM,GAAZ,MAAM,MAAM;IACjB,KAAK,CAAC,OAAO,CACX,OAAqC;QAErC,MAAM,SAAS,GACb,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS;YACrC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzE,MAAM,aAAa,GAAG,OAAO;YAC3B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;YACzB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAE5B,MAAM,OAAO,CAAC,OAAO,CAAC;YACpB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,mBAAmB;YAC9B,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,YAAY,OAAO,CAAC,IAAI,CAAC,EAAE,kBAAkB,OAAO,GAAG;YAChE,OAAO,EAAE,EAAE,SAAS,EAAE;SACvB,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAEtC,OAAO;YACL,MAAM,EAAE;gBACN,OAAO;gBACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;aAClC;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA7BY,wBAAM;iBAAN,MAAM;IA/DlB,IAAA,uDAAoB,EAAC;QACpB,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,8DAA8D;QAC3E,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QAChC,SAAS,EAAE;YACT,oBAAoB,EAAE;gBACpB,SAAS,EAAE,qCAAqC;aACjD;YACD,mBAAmB,EAAE;gBACnB;oBACE,GAAG,EAAE,WAAW;oBAChB,KAAK,EAAE,WAAW;oBAClB,WAAW,EAAE,iEAAiE;oBAC9E,SAAS,EAAE,YAAY;oBACvB,QAAQ,EAAE,IAAI;oBACd,iBAAiB,EAAE,IAAI;oBACvB,UAAU,EAAE,UAAU;oBACtB,KAAK,EAAE,SAAS;iBACjB;aACF;YACD,UAAU,EAAE;gBACV;oBACE,GAAG,EAAE,MAAM;oBACX,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,sDAAsD;oBACnE,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,IAAI;iBACf;gBACD;oBACE,GAAG,EAAE,MAAM;oBACX,KAAK,EAAE,MAAM;oBACb,WAAW,EAAE,uDAAuD;oBACpE,IAAI,EAAE,UAAU;iBACjB;gBACD;oBACE,GAAG,EAAE,QAAQ;oBACb,KAAK,EAAE,QAAQ;oBACf,WAAW,EAAE,2DAA2D;oBACxE,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,YAAY;iBACrB;aACF;YACD,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,IAAI;SACnB;QACD,aAAa,EAAE;YACb,OAAO,EACL,6OAA6O;SAChP;QACD,EAAE,EAAE;YACF,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;YACpB,mBAAmB,EAAE,SAAS;YAC9B,eAAe,EAAE,SAAS;YAC1B,SAAS,EAAE,IAAI;YACf,WAAW,EAAE;gBACX,UAAU,EAAE,CAAC,SAAS,CAAC;aACxB;SACF;KACF,CAAC;GACW,MAAM,CA6BlB","sourcesContent":["import { WorkflowNodeProvider } from '../../../decorators/workflow-node-provider.decorator';\nimport { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';\nimport {\n  WorkflowNodeExecutionContext,\n  WorkflowNodeHandlerResult,\n} from '../../../types/workflow-dsl.types';\n\n@WorkflowNodeProvider({\n  type: 'if',\n  kind: 'control',\n  category: 'control-flow',\n  label: 'If',\n  description: 'Runs then or else child nodes based on a boolean expression.',\n  tags: ['branching', 'condition'],\n  authoring: {\n    defaultConfiguration: {\n      condition: '{{ input.shouldContinue === true }}',\n    },\n    configurationFields: [\n      {\n        key: 'condition',\n        label: 'Condition',\n        description: 'Boolean expression evaluated by the workflow expression engine.',\n        valueType: 'expression',\n        required: true,\n        expressionAllowed: true,\n        widgetHint: 'textarea',\n        group: 'General',\n      },\n    ],\n    childSlots: [\n      {\n        key: 'then',\n        label: 'Then',\n        description: 'Nodes that run when the condition evaluates to true.',\n        kind: 'sequence',\n        required: true,\n      },\n      {\n        key: 'else',\n        label: 'Else',\n        description: 'Nodes that run when the condition evaluates to false.',\n        kind: 'sequence',\n      },\n      {\n        key: 'errors',\n        label: 'Errors',\n        description: 'Nodes that run sequentially if the selected branch fails.',\n        kind: 'sequence',\n        layout: 'sequential',\n      },\n    ],\n    supportsDescription: true,\n    supportsName: true,\n  },\n  documentation: {\n    summary:\n      'Conditionally branches workflow execution into then or else node sequences. The node evaluates a boolean expression and executes either the then or else child sequence. Sequence order inside each branch remains implicit by array order.',\n  },\n  ui: {\n    icon: 'si-code',\n    iconColor: '#4f46e5',\n    iconBackgroundColor: '#eef2ff',\n    iconBorderColor: '#c7d2fe',\n    modalSize: 'lg',\n    layoutHints: {\n      groupOrder: ['General'],\n    },\n  },\n})\nexport class IfNode implements WorkflowNodeHandler {\n  async execute(\n    context: WorkflowNodeExecutionContext,\n  ): Promise<WorkflowNodeHandlerResult> {\n    const condition =\n      context.node.configuration?.condition ??\n      context.node.configuration?.expression;\n    const matched = context.expression.evaluateCondition(condition, context);\n    const selectedNodes = matched\n      ? context.node.then ?? []\n      : context.node.else ?? [];\n\n    await context.emitLog({\n      level: 'info',\n      eventType: 'node.if.evaluated',\n      source: 'if',\n      message: `If node \"${context.node.id}\" evaluated to ${matched}.`,\n      context: { condition },\n    });\n\n    await context.runNodes(selectedNodes);\n\n    return {\n      output: {\n        matched,\n        branch: matched ? 'then' : 'else',\n      },\n    };\n  }\n}\n"]}

package/dist/services/workflow/nodes/log-write.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-write.node.d.ts","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/log-write.node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mCAAmC,CAAC;AAE3C,qBAqMa,YAAa,YAAW,mBAAmB;IAChD,OAAO,CACX,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC;CAwBtC"}
+{"version":3,"file":"log-write.node.d.ts","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/log-write.node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mCAAmC,CAAC;AAE3C,qBAuMa,YAAa,YAAW,mBAAmB;IAChD,OAAO,CACX,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC;CAwBtC"}

package/dist/services/workflow/nodes/log-write.node.js

@@ -186,6 +186,7 @@ exports.LogWriteNode = LogWriteNode = __decorate([
                     description: 'The resolved log level.',
                     valueType: 'string',
                     path: 'level',
+                    includeInRuntimeContext: false,
                 },
                 {
                     key: 'message',
@@ -193,6 +194,7 @@ exports.LogWriteNode = LogWriteNode = __decorate([
                     description: 'The rendered log message.',
                     valueType: 'string',
                     path: 'message',
+                    includeInRuntimeContext: false,
                 },
             ],
             supportsExpressions: true,

package/dist/services/workflow/nodes/log-write.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-write.node.js","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/log-write.node.ts"],"names":[],"mappings":"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","sourcesContent":["import { WorkflowNodeProvider } from '../../../decorators/workflow-node-provider.decorator';\nimport { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';\nimport {\n  WorkflowNodeExecutionContext,\n  WorkflowNodeHandlerResult,\n} from '../../../types/workflow-dsl.types';\n\n@WorkflowNodeProvider({\n  type: 'log.write',\n  kind: 'task',\n  version: '1.0.0',\n  category: 'core',\n  subcategory: 'observability',\n  label: 'Write Log',\n  description: 'Writes an execution log entry and returns the rendered message.',\n  tags: ['log', 'debug', 'observability'],\n  aliases: ['log'],\n  configSchema: {\n    type: 'object',\n    required: ['message'],\n    properties: {\n      level: {\n        type: 'string',\n        enum: ['debug', 'info', 'warn', 'error'],\n        default: 'info',\n      },\n      message: {\n        type: 'string',\n      },\n      context: {\n        type: 'object',\n        default: {},\n      },\n      metadata: {\n        type: 'object',\n        default: {},\n      },\n    },\n  },\n  uiSchema: {\n    'ui:order': ['level', 'message', 'context', 'metadata'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      level: { type: 'string' },\n      message: { type: 'string' },\n    },\n  },\n  examples: [\n    {\n      key: 'simple-message',\n      label: 'Simple log message',\n      description: 'Write a simple interpolated log line.',\n      language: 'yaml',\n      snippet:\n        'message: \"Hello {{ input.name }}\"\\nlevel: info\\n',\n      configurationOnly: true,\n    },\n  ],\n  metrics: [\n    {\n      key: 'workflow.node.log.count',\n      label: 'Log writes',\n      description: 'Counts how many times the log node executes.',\n      type: 'counter',\n      tags: ['log', 'workflow'],\n    },\n  ],\n  definitions: [\n    {\n      key: 'log-levels',\n      label: 'Supported log levels',\n      content:\n        'The node supports debug, info, warn, and error. The chosen level is stored alongside the log message.',\n    },\n  ],\n  authoring: {\n    defaultConfiguration: {\n      level: 'info',\n      context: {},\n      metadata: {},\n    },\n    configurationLayout: {\n      type: 'tabs',\n      tabs: [\n        {\n          key: 'message',\n          label: 'Message',\n          groups: ['Message'],\n        },\n        {\n          key: 'context',\n          label: 'Context',\n          fields: ['context'],\n        },\n        {\n          key: 'metadata',\n          label: 'Metadata',\n          fields: ['metadata'],\n        },\n      ],\n    },\n    configurationFields: [\n      {\n        key: 'level',\n        label: 'Level',\n        description: 'The severity used for the emitted workflow log entry.',\n        valueType: 'string',\n        defaultValue: 'info',\n        enumValues: ['debug', 'info', 'warn', 'error'],\n        group: 'Message',\n      },\n      {\n        key: 'message',\n        label: 'Message',\n        description: 'The text to log. Expressions are allowed.',\n        valueType: 'string',\n        required: true,\n        expressionAllowed: true,\n        group: 'Message',\n      },\n      {\n        key: 'context',\n        label: 'Context',\n        description: 'Optional structured context attached to the log entry.',\n        valueType: 'object',\n        expressionAllowed: true,\n        group: 'Advanced',\n        widgetHint: 'yaml-editor',\n        uiSchema: {\n          layout: {\n            width: 'full',\n          },\n          editor: {\n            height: 'min(420px, calc(90vh - 330px))',\n          },\n        },\n      },\n      {\n        key: 'metadata',\n        label: 'Metadata',\n        description: 'Optional metadata attached to the log entry.',\n        valueType: 'object',\n        expressionAllowed: true,\n        group: 'Advanced',\n        widgetHint: 'yaml-editor',\n        uiSchema: {\n          layout: {\n            width: 'full',\n          },\n          editor: {\n            height: 'min(420px, calc(90vh - 330px))',\n          },\n        },\n      },\n    ],\n    outputs: [\n      {\n        key: 'level',\n        label: 'Level',\n        description: 'The resolved log level.',\n        valueType: 'string',\n        path: 'level',\n      },\n      {\n        key: 'message',\n        label: 'Message',\n        description: 'The rendered log message.',\n        valueType: 'string',\n        path: 'message',\n      },\n    ],\n    supportsExpressions: true,\n    supportsDisableToggle: true,\n    supportsName: true,\n    supportsDescription: true,\n    searchableText: ['log', 'message', 'debug', 'observability'],\n  },\n  runtime: {\n    emitsLogs: true,\n    emitsArtifacts: false,\n    deterministicOutputs: true,\n    executionMode: 'task',\n    successStatuses: ['success'],\n  },\n  documentation: {\n    summary:\n      'Use this node for debug messages, execution breadcrumbs, and quick expression verification.',\n  },\n  ui: {\n    icon: 'si-file',\n    iconColor: '#0284c7',\n    iconBackgroundColor: '#e0f2fe',\n    iconBorderColor: '#bae6fd',\n    defaultEditorMode: 'schema',\n    modalSize: 'xl',\n    layoutHints: {\n      preferredPanel: 'flow',\n      groupOrder: ['Message', 'Advanced'],\n      stickySummary: true,\n    },\n  },\n})\nexport class LogWriteNode implements WorkflowNodeHandler {\n  async execute(\n    context: WorkflowNodeExecutionContext,\n  ): Promise<WorkflowNodeHandlerResult> {\n    const configuration = context.expression.interpolate(\n      context.node.configuration ?? {},\n      context,\n    );\n    const level = configuration.level ?? 'info';\n    const message = configuration.message ?? context.node.name ?? context.node.id;\n\n    await context.emitLog({\n      level,\n      message,\n      eventType: 'node.log',\n      source: 'log.write',\n      context: configuration.context,\n      metadata: configuration.metadata,\n    });\n\n    return {\n      output: {\n        level,\n        message,\n      },\n    };\n  }\n}\n"]}
+{"version":3,"file":"log-write.node.js","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/log-write.node.ts"],"names":[],"mappings":"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","sourcesContent":["import { WorkflowNodeProvider } from '../../../decorators/workflow-node-provider.decorator';\nimport { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';\nimport {\n  WorkflowNodeExecutionContext,\n  WorkflowNodeHandlerResult,\n} from '../../../types/workflow-dsl.types';\n\n@WorkflowNodeProvider({\n  type: 'log.write',\n  kind: 'task',\n  version: '1.0.0',\n  category: 'core',\n  subcategory: 'observability',\n  label: 'Write Log',\n  description: 'Writes an execution log entry and returns the rendered message.',\n  tags: ['log', 'debug', 'observability'],\n  aliases: ['log'],\n  configSchema: {\n    type: 'object',\n    required: ['message'],\n    properties: {\n      level: {\n        type: 'string',\n        enum: ['debug', 'info', 'warn', 'error'],\n        default: 'info',\n      },\n      message: {\n        type: 'string',\n      },\n      context: {\n        type: 'object',\n        default: {},\n      },\n      metadata: {\n        type: 'object',\n        default: {},\n      },\n    },\n  },\n  uiSchema: {\n    'ui:order': ['level', 'message', 'context', 'metadata'],\n  },\n  outputSchema: {\n    type: 'object',\n    properties: {\n      level: { type: 'string' },\n      message: { type: 'string' },\n    },\n  },\n  examples: [\n    {\n      key: 'simple-message',\n      label: 'Simple log message',\n      description: 'Write a simple interpolated log line.',\n      language: 'yaml',\n      snippet:\n        'message: \"Hello {{ input.name }}\"\\nlevel: info\\n',\n      configurationOnly: true,\n    },\n  ],\n  metrics: [\n    {\n      key: 'workflow.node.log.count',\n      label: 'Log writes',\n      description: 'Counts how many times the log node executes.',\n      type: 'counter',\n      tags: ['log', 'workflow'],\n    },\n  ],\n  definitions: [\n    {\n      key: 'log-levels',\n      label: 'Supported log levels',\n      content:\n        'The node supports debug, info, warn, and error. The chosen level is stored alongside the log message.',\n    },\n  ],\n  authoring: {\n    defaultConfiguration: {\n      level: 'info',\n      context: {},\n      metadata: {},\n    },\n    configurationLayout: {\n      type: 'tabs',\n      tabs: [\n        {\n          key: 'message',\n          label: 'Message',\n          groups: ['Message'],\n        },\n        {\n          key: 'context',\n          label: 'Context',\n          fields: ['context'],\n        },\n        {\n          key: 'metadata',\n          label: 'Metadata',\n          fields: ['metadata'],\n        },\n      ],\n    },\n    configurationFields: [\n      {\n        key: 'level',\n        label: 'Level',\n        description: 'The severity used for the emitted workflow log entry.',\n        valueType: 'string',\n        defaultValue: 'info',\n        enumValues: ['debug', 'info', 'warn', 'error'],\n        group: 'Message',\n      },\n      {\n        key: 'message',\n        label: 'Message',\n        description: 'The text to log. Expressions are allowed.',\n        valueType: 'string',\n        required: true,\n        expressionAllowed: true,\n        group: 'Message',\n      },\n      {\n        key: 'context',\n        label: 'Context',\n        description: 'Optional structured context attached to the log entry.',\n        valueType: 'object',\n        expressionAllowed: true,\n        group: 'Advanced',\n        widgetHint: 'yaml-editor',\n        uiSchema: {\n          layout: {\n            width: 'full',\n          },\n          editor: {\n            height: 'min(420px, calc(90vh - 330px))',\n          },\n        },\n      },\n      {\n        key: 'metadata',\n        label: 'Metadata',\n        description: 'Optional metadata attached to the log entry.',\n        valueType: 'object',\n        expressionAllowed: true,\n        group: 'Advanced',\n        widgetHint: 'yaml-editor',\n        uiSchema: {\n          layout: {\n            width: 'full',\n          },\n          editor: {\n            height: 'min(420px, calc(90vh - 330px))',\n          },\n        },\n      },\n    ],\n    outputs: [\n      {\n        key: 'level',\n        label: 'Level',\n        description: 'The resolved log level.',\n        valueType: 'string',\n        path: 'level',\n        includeInRuntimeContext: false,\n      },\n      {\n        key: 'message',\n        label: 'Message',\n        description: 'The rendered log message.',\n        valueType: 'string',\n        path: 'message',\n        includeInRuntimeContext: false,\n      },\n    ],\n    supportsExpressions: true,\n    supportsDisableToggle: true,\n    supportsName: true,\n    supportsDescription: true,\n    searchableText: ['log', 'message', 'debug', 'observability'],\n  },\n  runtime: {\n    emitsLogs: true,\n    emitsArtifacts: false,\n    deterministicOutputs: true,\n    executionMode: 'task',\n    successStatuses: ['success'],\n  },\n  documentation: {\n    summary:\n      'Use this node for debug messages, execution breadcrumbs, and quick expression verification.',\n  },\n  ui: {\n    icon: 'si-file',\n    iconColor: '#0284c7',\n    iconBackgroundColor: '#e0f2fe',\n    iconBorderColor: '#bae6fd',\n    defaultEditorMode: 'schema',\n    modalSize: 'xl',\n    layoutHints: {\n      preferredPanel: 'flow',\n      groupOrder: ['Message', 'Advanced'],\n      stickySummary: true,\n    },\n  },\n})\nexport class LogWriteNode implements WorkflowNodeHandler {\n  async execute(\n    context: WorkflowNodeExecutionContext,\n  ): Promise<WorkflowNodeHandlerResult> {\n    const configuration = context.expression.interpolate(\n      context.node.configuration ?? {},\n      context,\n    );\n    const level = configuration.level ?? 'info';\n    const message = configuration.message ?? context.node.name ?? context.node.id;\n\n    await context.emitLog({\n      level,\n      message,\n      eventType: 'node.log',\n      source: 'log.write',\n      context: configuration.context,\n      metadata: configuration.metadata,\n    });\n\n    return {\n      output: {\n        level,\n        message,\n      },\n    };\n  }\n}\n"]}

package/dist/services/workflow/nodes/loop-until.node.d.ts

@@ -0,0 +1,12 @@
+import { WorkflowNodeHandler } from '../../../interfaces/workflow-node-handler.interface';
+import { WorkflowNodeExecutionContext, WorkflowNodeHandlerResult } from '../../../types/workflow-dsl.types';
+export declare class LoopUntilNode implements WorkflowNodeHandler {
+    execute(context: WorkflowNodeExecutionContext): Promise<WorkflowNodeHandlerResult>;
+    private resolveCheckFrequency;
+    private hasReachedGuardrail;
+    private optionalPositiveInteger;
+    private parseDurationMs;
+    private resolveBoolean;
+    private delay;
+}
+//# sourceMappingURL=loop-until.node.d.ts.map

package/dist/services/workflow/nodes/loop-until.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-until.node.d.ts","sourceRoot":"","sources":["../../../../src/services/workflow/nodes/loop-until.node.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mCAAmC,CAAC;AAS3C,qBAqHa,aAAc,YAAW,mBAAmB;IACjD,OAAO,CACX,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC;IA4FrC,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,eAAe;IAkDvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/services/workflow/nodes/loop-until.node.js

@@ -0,0 +1,281 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoopUntilNode = void 0;
+const common_1 = require("@nestjs/common");
+const workflow_node_provider_decorator_1 = require("../../../decorators/workflow-node-provider.decorator");
+let LoopUntilNode = class LoopUntilNode {
+    async execute(context) {
+        const configuration = context.node.configuration ?? {};
+        const condition = configuration.condition ?? configuration.expression;
+        if (!condition) {
+            throw new common_1.BadRequestException('loopUntil requires configuration.condition.');
+        }
+        const checkFrequency = this.resolveCheckFrequency(context.expression.interpolate(configuration.checkFrequency ?? {}, context));
+        const childNodes = context.node.tasks ?? [];
+        const startedAt = Date.now();
+        let iterationCount = 0;
+        let conditionMatched = false;
+        let maxReached = false;
+        let latestChildOutputs = {};
+        while (true) {
+            iterationCount += 1;
+            context.outputs[context.node.id] = {
+                iterationCount,
+                conditionMatched: false,
+                maxReached: false,
+            };
+            const iterationOutputs = {
+                ...(context.outputs ?? {}),
+            };
+            latestChildOutputs = await context.runNodes(childNodes, {
+                outputs: iterationOutputs,
+            });
+            Object.assign(context.outputs, iterationOutputs);
+            conditionMatched = context.expression.evaluateCondition(condition, {
+                ...context,
+                outputs: context.outputs,
+            });
+            context.outputs[context.node.id] = {
+                iterationCount,
+                conditionMatched,
+                maxReached: false,
+                latestOutputs: latestChildOutputs,
+            };
+            await context.emitLog({
+                level: 'info',
+                eventType: 'node.loopUntil.evaluated',
+                source: 'loopUntil',
+                message: `LoopUntil node "${context.node.id}" iteration ${iterationCount} evaluated to ${conditionMatched}.`,
+                context: {
+                    condition,
+                    iterationCount,
+                    conditionMatched,
+                },
+            });
+            if (conditionMatched) {
+                break;
+            }
+            maxReached = this.hasReachedGuardrail(iterationCount, startedAt, checkFrequency);
+            if (maxReached) {
+                if (checkFrequency.failOnMaxReached) {
+                    throw new common_1.BadRequestException(`loopUntil "${context.node.id}" reached its maximum check frequency guardrail before the condition matched.`);
+                }
+                break;
+            }
+            if (checkFrequency.intervalMs > 0) {
+                await this.delay(checkFrequency.intervalMs);
+            }
+        }
+        return {
+            output: {
+                iterationCount,
+                conditionMatched,
+                maxReached,
+                latestOutputs: latestChildOutputs,
+            },
+        };
+    }
+    resolveCheckFrequency(value) {
+        const checkFrequency = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+        const maxIterations = this.optionalPositiveInteger(checkFrequency.maxIterations, 'checkFrequency.maxIterations');
+        const maxDurationMs = checkFrequency.maxDuration === undefined ||
+            checkFrequency.maxDuration === null ||
+            checkFrequency.maxDuration === ''
+            ? undefined
+            : this.parseDurationMs(checkFrequency.maxDuration, 'checkFrequency.maxDuration');
+        return {
+            intervalMs: this.parseDurationMs(checkFrequency.interval ?? 'PT1M', 'checkFrequency.interval'),
+            maxIterations,
+            maxDurationMs,
+            failOnMaxReached: this.resolveBoolean(checkFrequency.failOnMaxReached),
+        };
+    }
+    hasReachedGuardrail(iterationCount, startedAt, checkFrequency) {
+        return ((checkFrequency.maxIterations !== undefined &&
+            iterationCount >= checkFrequency.maxIterations) ||
+            (checkFrequency.maxDurationMs !== undefined &&
+                Date.now() - startedAt >= checkFrequency.maxDurationMs));
+    }
+    optionalPositiveInteger(value, label) {
+        if (value === undefined || value === null || value === '') {
+            return undefined;
+        }
+        const parsed = Number(value);
+        if (!Number.isFinite(parsed) || parsed < 1) {
+            throw new common_1.BadRequestException(`${label} must be a positive integer.`);
+        }
+        return Math.floor(parsed);
+    }
+    parseDurationMs(value, label) {
+        if (typeof value === 'number') {
+            if (!Number.isFinite(value) || value < 0) {
+                throw new common_1.BadRequestException(`${label} must be a non-negative duration.`);
+            }
+            return value;
+        }
+        const raw = String(value ?? '').trim();
+        if (!raw) {
+            return 0;
+        }
+        if (/^\d+$/.test(raw)) {
+            return Number(raw);
+        }
+        const isoMatch = raw.match(/^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/i);
+        if (isoMatch) {
+            const [, days, hours, minutes, seconds] = isoMatch;
+            return (Number(days ?? 0) * 24 * 60 * 60 * 1000 +
+                Number(hours ?? 0) * 60 * 60 * 1000 +
+                Number(minutes ?? 0) * 60 * 1000 +
+                Number(seconds ?? 0) * 1000);
+        }
+        const unitMatch = raw.match(/^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/i);
+        if (unitMatch) {
+            const amount = Number(unitMatch[1]);
+            const unit = unitMatch[2].toLowerCase();
+            const multiplier = unit === 'ms'
+                ? 1
+                : unit === 's'
+                    ? 1000
+                    : unit === 'm'
+                        ? 60 * 1000
+                        : unit === 'h'
+                            ? 60 * 60 * 1000
+                            : 24 * 60 * 60 * 1000;
+            return amount * multiplier;
+        }
+        throw new common_1.BadRequestException(`${label} must be milliseconds, 1s/1m style, or ISO-8601 duration.`);
+    }
+    resolveBoolean(value) {
+        if (value === true || value === 'true') {
+            return true;
+        }
+        return false;
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+};
+exports.LoopUntilNode = LoopUntilNode;
+exports.LoopUntilNode = LoopUntilNode = __decorate([
+    (0, workflow_node_provider_decorator_1.WorkflowNodeProvider)({
+        type: 'loopUntil',
+        kind: 'control',
+        category: 'control-flow',
+        label: 'Loop Until',
+        description: 'Runs child nodes repeatedly until a condition evaluates true.',
+        tags: ['loop', 'iteration', 'condition', 'polling'],
+        authoring: {
+            defaultConfiguration: {
+                condition: '{{ outputs.checkStatus.ready == true }}',
+                checkFrequency: {
+                    interval: 'PT1M',
+                    failOnMaxReached: false,
+                },
+            },
+            configurationLayout: {
+                type: 'tabs',
+                tabs: [
+                    {
+                        key: 'condition',
+                        label: 'Condition',
+                        groups: ['Condition'],
+                    },
+                    {
+                        key: 'guardrails',
+                        label: 'Guardrails',
+                        groups: ['Guardrails'],
+                    },
+                ],
+            },
+            configurationFields: [
+                {
+                    key: 'condition',
+                    label: 'Condition',
+                    description: 'Boolean expression evaluated after each loop iteration. It can read outputs from the latest child-node run.',
+                    valueType: 'expression',
+                    required: true,
+                    expressionAllowed: true,
+                    widgetHint: 'textarea',
+                    group: 'Condition',
+                    uiSchema: {
+                        layout: {
+                            width: 'full',
+                        },
+                    },
+                },
+                {
+                    key: 'checkFrequency',
+                    label: 'Check Frequency',
+                    description: 'Optional loop guardrails: interval, maxIterations, maxDuration, and failOnMaxReached.',
+                    valueType: 'object',
+                    expressionAllowed: true,
+                    widgetHint: 'yaml-editor',
+                    group: 'Guardrails',
+                    uiSchema: {
+                        layout: {
+                            width: 'full',
+                        },
+                        editor: {
+                            height: 'min(320px, calc(90vh - 360px))',
+                        },
+                    },
+                },
+            ],
+            childSlots: [
+                {
+                    key: 'tasks',
+                    label: 'Loop Body',
+                    description: 'Nodes that run before the condition is evaluated.',
+                    kind: 'sequence',
+                    layout: 'sequential',
+                    required: true,
+                },
+                {
+                    key: 'errors',
+                    label: 'Errors',
+                    description: 'Nodes that run sequentially if this loop fails.',
+                    kind: 'sequence',
+                    layout: 'sequential',
+                },
+            ],
+            outputs: [
+                {
+                    key: 'iterationCount',
+                    label: 'Iteration Count',
+                    description: 'Number of loop body iterations that ran.',
+                    valueType: 'number',
+                    path: 'iterationCount',
+                },
+                {
+                    key: 'conditionMatched',
+                    label: 'Condition Matched',
+                    description: 'Whether the loop stopped because the condition evaluated true.',
+                    valueType: 'boolean',
+                    path: 'conditionMatched',
+                },
+            ],
+            supportsDescription: true,
+            supportsName: true,
+        },
+        documentation: {
+            summary: 'Runs the loop body, evaluates the condition, and repeats after the configured interval until the condition is true or a guardrail is reached.',
+        },
+        ui: {
+            icon: 'si-repeat',
+            iconColor: '#0f766e',
+            iconBackgroundColor: '#ccfbf1',
+            iconBorderColor: '#99f6e4',
+            modalSize: 'lg',
+            layoutHints: {
+                groupOrder: ['Condition', 'Guardrails'],
+            },
+        },
+    })
+], LoopUntilNode);
+//# sourceMappingURL=loop-until.node.js.map