@decaf-ts/integrations 0.10.4 → 0.10.8

package/lib/cjs/graph/nodes/loops/foreach.cjs

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphForeachLoopNode = void 0;
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+        return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/loops/foreach
+ * @summary Foreach loop node declaration.
+ * @description Shared declaration for the `core.loop.foreach` system node
+ * kind (decorator id `graph-foreach-loop-node`), ported from the for-angular
+ * demo app so the loop kinds become shared canvas nodes. The class's own
+ * `static execute` is the only implementation of the kind, derived by
+ * `GraphBuiltInRegistrations`, and reaches engine services through
+ * `GraphExecutionContext.engine`. The loop-body workflow is demo/app-side
+ * content and is not part of the shared declaration — the shared class
+ * carries the port/metadata shape only.
+ */
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const ui_decorators_1 = require("@decaf-ts/ui-decorators");
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const base_js_1 = require("./../base.cjs");
+const graph_2 = require("@decaf-ts/ui-decorators/graph");
+const GraphExecutionError_js_1 = require("./../../engine/errors/GraphExecutionError.cjs");
+const GraphInputError_js_1 = require("./../../engine/errors/GraphInputError.cjs");
+const GraphLoopLimitError_js_1 = require("./../../engine/errors/GraphLoopLimitError.cjs");
+const loop_metadata_js_1 = require("./loop-metadata.cjs");
+const constants_js_1 = require("./../../engine/constants.cjs");
+const GraphBreakSignal_js_1 = require("./../../engine/errors/GraphBreakSignal.cjs");
+let GraphForeachLoopNode = class GraphForeachLoopNode extends base_js_1.GraphNode {
+    static async execute(request, context) {
+        const metadata = (0, loop_metadata_js_1.extractLoopMetadata)(context, "foreach");
+        const input = request.inputs;
+        const items = input.items;
+        const maxIterations = metadata.maxIterations ?? constants_js_1.GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS;
+        if (!Array.isArray(items)) {
+            throw new GraphInputError_js_1.GraphInputError("foreach input 'items' must be an array");
+        }
+        const engine = context.engine;
+        if (!engine) {
+            throw new GraphExecutionError_js_1.GraphExecutionError("foreach node requires engine access", "GRAPH_ENGINE_NOT_AVAILABLE");
+        }
+        const sliceRaw = Number(input.slice ?? metadata.slice ?? 1);
+        const slice = Number.isFinite(sliceRaw) && sliceRaw > 0 ? Math.floor(sliceRaw) : 1;
+        const iterations = slice > 1 ? Math.ceil(items.length / slice) : items.length;
+        if (iterations > maxIterations) {
+            throw new GraphLoopLimitError_js_1.GraphLoopLimitError(`foreach exceeded max iterations (${iterations} > ${maxIterations})`);
+        }
+        const itemPort = metadata.itemPort ?? "item";
+        const resultPort = metadata.resultPort ?? "result";
+        const statePort = metadata.statePort ?? "state";
+        const bodyWorkflow = metadata.body;
+        const results = [];
+        let state = input.state;
+        let broken = false;
+        await context.emit({ type: graph_2.GraphExecutionEventType.LOOP_STARTED });
+        for (let i = 0; i < iterations; i++) {
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_ITERATION_STARTED,
+                iteration: i,
+            });
+            const sliceItems = slice > 1 ? items.slice(i * slice, i * slice + slice) : items[i];
+            const childInputs = {
+                [itemPort]: sliceItems,
+                index: i,
+            };
+            if (slice > 1)
+                childInputs["slice"] = sliceItems;
+            if (state !== undefined)
+                childInputs[statePort] = state;
+            try {
+                const childResult = await engine.execute(bodyWorkflow, childInputs, {
+                    parentRunId: context.runId,
+                    path: [...context.path, `iteration:${i}`],
+                    metadata: { item: sliceItems, index: i, slice },
+                });
+                results.push(childResult.outputs[resultPort]);
+                if (childResult.outputs[statePort] !== undefined) {
+                    state = childResult.outputs[statePort];
+                }
+            }
+            catch (err) {
+                if (err instanceof GraphBreakSignal_js_1.GraphBreakSignal) {
+                    const carried = err.details
+                        ?.value;
+                    if (carried !== undefined)
+                        results.push(carried);
+                    broken = true;
+                    await context.emit({
+                        type: graph_2.GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                        iteration: i,
+                        metadata: { broken: true },
+                    });
+                    break;
+                }
+                throw err;
+            }
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                iteration: i,
+            });
+        }
+        await context.emit({
+            type: graph_2.GraphExecutionEventType.LOOP_COMPLETED,
+            metadata: { broken },
+        });
+        const output = {
+            results,
+            completed: results,
+            iterations: results.length,
+            broken,
+        };
+        if (state !== undefined)
+            output[statePort] = state;
+        return output;
+    }
+};
+exports.GraphForeachLoopNode = GraphForeachLoopNode;
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, ui_decorators_1.uielement)("textarea", {
+        label: "Items",
+        placeholder: "Array to iterate over",
+    }),
+    (0, graph_1.input)({ handle: "items" }),
+    __metadata("design:type", Array)
+], GraphForeachLoopNode.prototype, "items", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, ui_decorators_1.uielement)("input", {
+        label: "Slice size",
+        placeholder: "Items per iteration (default 1)",
+    }),
+    (0, graph_1.input)({ handle: "slice" }),
+    __metadata("design:type", Number)
+], GraphForeachLoopNode.prototype, "slice", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, graph_1.output)({ handle: "item" }),
+    __metadata("design:type", Object)
+], GraphForeachLoopNode.prototype, "item", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, graph_1.connection)({
+        handle: "loop",
+        connectionRules: { allowSelf: true, maxConnections: 1 },
+    }),
+    __metadata("design:type", Object)
+], GraphForeachLoopNode.prototype, "loop", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, graph_1.output)({ handle: "completed" }),
+    __metadata("design:type", Array)
+], GraphForeachLoopNode.prototype, "completed", void 0);
+exports.GraphForeachLoopNode = GraphForeachLoopNode = __decorate([
+    (0, graph_1.node)("graph-foreach-loop-node", {
+        kind: "core.loop.foreach",
+        category: "Loop",
+        color: "#eab308",
+        icon: "ti-repeat",
+        width: 120,
+        height: 140,
+        labels: ["loop", "iteration", "foreach"],
+        metadata: {
+            title: "Foreach loop",
+            description: "Iterates over an array input and executes the body once per item (or per slice of items).",
+            loop: {
+                maxIterations: 100,
+                itemPort: "item",
+                resultPort: "result",
+                slice: 1,
+            },
+        },
+    }),
+    (0, decorator_validation_1.model)()
+], GraphForeachLoopNode);
+//# sourceMappingURL=foreach.js.map
+//# sourceMappingURL=foreach.cjs.map

package/lib/cjs/graph/nodes/loops/foreach.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/nodes/loops/foreach.cjs","sourceRoot":"","sources":["graph/nodes/loops/foreach.js"],"names":[],"mappings":"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"}

package/lib/cjs/graph/nodes/loops/loop-metadata.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractLoopMetadata = extractLoopMetadata;
+const GraphInputError_js_1 = require("./../../engine/errors/GraphInputError.cjs");
+/**
+ * Extracts the loop metadata for the executing loop node.
+ *
+ * @param context - The run-scoped execution context for the loop node.
+ * @param label - The loop kind label used in error messages.
+ * @returns The effective loop metadata (body, limits, ports, condition).
+ * @throws {GraphInputError} when the node carries no loop body configuration.
+ */
+function extractLoopMetadata(context, label) {
+    const instance = context.node;
+    const parameters = (instance.parameters ?? {});
+    const loop = instance.loop;
+    const fallback = context.metadata?.["loop"];
+    if (!loop?.body && !fallback?.["body"]) {
+        throw new GraphInputError_js_1.GraphInputError(`${label} node is missing loop configuration (instance.loop.body)`);
+    }
+    const body = (loop?.body ?? fallback?.["body"]);
+    const number = (key) => {
+        const raw = parameters[key] ??
+            loop?.[key] ??
+            fallback?.[key];
+        const value = Number(raw);
+        return raw !== undefined && Number.isFinite(value) ? value : undefined;
+    };
+    const string = (key) => {
+        const raw = parameters[key] ?? fallback?.[key];
+        return typeof raw === "string" ? raw : undefined;
+    };
+    return {
+        body,
+        maxIterations: number("maxIterations"),
+        timeoutMs: number("timeoutMs"),
+        concurrency: number("concurrency"),
+        condition: (parameters["condition"] ?? fallback?.["condition"]),
+        inputPort: string("inputPort"),
+        outputPort: string("outputPort"),
+        itemPort: string("itemPort"),
+        resultPort: string("resultPort"),
+        statePort: string("statePort"),
+        slice: number("slice"),
+    };
+}
+//# sourceMappingURL=loop-metadata.js.map
+//# sourceMappingURL=loop-metadata.cjs.map

package/lib/cjs/graph/nodes/loops/loop-metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/nodes/loops/loop-metadata.cjs","sourceRoot":"","sources":["graph/nodes/loops/loop-metadata.js"],"names":[],"mappings":";;AASA,kDAiCC;AA1CD,iFAA2E;AAC3E;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,OAAO,EAAE,KAAK;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9B,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,oCAAe,CAAC,GAAG,KAAK,0DAA0D,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;YACvB,IAAI,EAAE,CAAC,GAAG,CAAC;YACX,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,CAAC;IACF,OAAO;QACH,IAAI;QACJ,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;QAClC,SAAS,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;QAC/D,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAC9B,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;KACzB,CAAC;AACN,CAAC;AACD,yCAAyC"}

package/lib/cjs/graph/nodes/loops/until.cjs

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphUntilLoopNode = void 0;
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+        return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/loops/until
+ * @summary Until loop node declaration.
+ * @description Shared declaration for the `core.loop.until` system node kind
+ * (decorator id `graph-until-loop-node`), ported from the for-angular demo
+ * app so the loop kinds become shared canvas nodes. The class's own
+ * `static execute` is the only implementation of the kind, derived by
+ * `GraphBuiltInRegistrations`, and reaches engine services through
+ * `GraphExecutionContext.engine`. The loop-body workflow is demo/app-side
+ * content and is not part of the shared declaration — the shared class
+ * carries the port/metadata shape only.
+ */
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const ui_decorators_1 = require("@decaf-ts/ui-decorators");
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const base_js_1 = require("./../base.cjs");
+const graph_2 = require("@decaf-ts/ui-decorators/graph");
+const GraphExecutionError_js_1 = require("./../../engine/errors/GraphExecutionError.cjs");
+const GraphInputError_js_1 = require("./../../engine/errors/GraphInputError.cjs");
+const GraphLoopLimitError_js_1 = require("./../../engine/errors/GraphLoopLimitError.cjs");
+const loop_metadata_js_1 = require("./loop-metadata.cjs");
+const constants_js_1 = require("./../../engine/constants.cjs");
+const GraphConditionEvaluator_js_1 = require("./../../engine/loops/GraphConditionEvaluator.cjs");
+let GraphUntilLoopNode = class GraphUntilLoopNode extends base_js_1.GraphNode {
+    static async execute(request, context) {
+        const metadata = (0, loop_metadata_js_1.extractLoopMetadata)(context, "until");
+        const input = request.inputs;
+        const maxIterations = metadata.maxIterations ?? constants_js_1.GRAPH_DEFAULT_MAX_LOOP_ITERATIONS;
+        const condition = metadata.condition;
+        if (!condition) {
+            throw new GraphInputError_js_1.GraphInputError("until node is missing a condition");
+        }
+        const statePort = metadata.statePort ?? "state";
+        const bodyWorkflow = metadata.body;
+        const engine = context.engine;
+        if (!engine) {
+            throw new GraphExecutionError_js_1.GraphExecutionError("until node requires engine access", "GRAPH_ENGINE_NOT_AVAILABLE");
+        }
+        let state = input.state;
+        let iteration = 0;
+        await context.emit({ type: graph_2.GraphExecutionEventType.LOOP_STARTED });
+        let shouldStop = false;
+        do {
+            if (iteration >= maxIterations) {
+                await context.emit({
+                    type: graph_2.GraphExecutionEventType.LOOP_LIMIT_REACHED,
+                    iteration,
+                });
+                throw new GraphLoopLimitError_js_1.GraphLoopLimitError(`until loop exceeded max iterations (${maxIterations})`);
+            }
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_ITERATION_STARTED,
+                iteration,
+            });
+            const childResult = await engine.execute(bodyWorkflow, { [statePort]: state, iteration }, {
+                parentRunId: context.runId,
+                path: [...context.path, `iteration:${iteration}`],
+            });
+            state = childResult.outputs[statePort];
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                iteration,
+            });
+            const conditionResult = new GraphConditionEvaluator_js_1.GraphConditionEvaluator().evaluate(condition, state);
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_CONDITION_EVALUATED,
+                iteration,
+                payload: { result: conditionResult },
+            });
+            iteration++;
+            shouldStop = conditionResult;
+        } while (!shouldStop);
+        await context.emit({ type: graph_2.GraphExecutionEventType.LOOP_COMPLETED });
+        return { [statePort]: state, iterations: iteration };
+    }
+};
+exports.GraphUntilLoopNode = GraphUntilLoopNode;
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, ui_decorators_1.uielement)("input", { label: "State", placeholder: "Initial state" }),
+    (0, graph_1.input)({ handle: "state" }),
+    __metadata("design:type", Object)
+], GraphUntilLoopNode.prototype, "state", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, ui_decorators_1.uielement)("input", {
+        label: "Final state",
+        placeholder: "Final state after loop",
+    }),
+    (0, graph_1.output)({ handle: "state" }),
+    __metadata("design:type", Object)
+], GraphUntilLoopNode.prototype, "stateOut", void 0);
+exports.GraphUntilLoopNode = GraphUntilLoopNode = __decorate([
+    (0, graph_1.node)("graph-until-loop-node", {
+        kind: "core.loop.until",
+        category: "Loop",
+        color: "#eab308",
+        icon: "ti-player-stop",
+        width: 96,
+        height: 96,
+        labels: ["loop", "conditional", "until"],
+        metadata: {
+            title: "Until loop",
+            description: "Repeats the body until the condition is true (post-condition, runs at least once).",
+            loop: {
+                maxIterations: 50,
+                statePort: "state",
+                condition: {
+                    type: "greaterThanOrEqual",
+                    left: "iteration",
+                    right: 2,
+                },
+            },
+        },
+    }),
+    (0, decorator_validation_1.model)()
+], GraphUntilLoopNode);
+//# sourceMappingURL=until.js.map
+//# sourceMappingURL=until.cjs.map

package/lib/cjs/graph/nodes/loops/until.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/nodes/loops/until.cjs","sourceRoot":"","sources":["graph/nodes/loops/until.js"],"names":[],"mappings":"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"}

package/lib/cjs/graph/nodes/loops/while.cjs

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphWhileLoopNode = void 0;
+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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+        return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/loops/while
+ * @summary While loop node declaration.
+ * @description Shared declaration for the `core.loop.while` system node kind
+ * (decorator id `graph-while-loop-node`), ported from the for-angular demo
+ * app so the loop kinds become shared canvas nodes. The class's own
+ * `static execute` is the only implementation of the kind, derived by
+ * `GraphBuiltInRegistrations`, and reaches engine services through
+ * `GraphExecutionContext.engine`. The loop-body workflow is demo/app-side
+ * content and is not part of the shared declaration — the shared class
+ * carries the port/metadata shape only.
+ */
+const decorator_validation_1 = require("@decaf-ts/decorator-validation");
+const ui_decorators_1 = require("@decaf-ts/ui-decorators");
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const base_js_1 = require("./../base.cjs");
+const graph_2 = require("@decaf-ts/ui-decorators/graph");
+const GraphExecutionError_js_1 = require("./../../engine/errors/GraphExecutionError.cjs");
+const GraphInputError_js_1 = require("./../../engine/errors/GraphInputError.cjs");
+const GraphLoopLimitError_js_1 = require("./../../engine/errors/GraphLoopLimitError.cjs");
+const loop_metadata_js_1 = require("./loop-metadata.cjs");
+const constants_js_1 = require("./../../engine/constants.cjs");
+const GraphConditionEvaluator_js_1 = require("./../../engine/loops/GraphConditionEvaluator.cjs");
+let GraphWhileLoopNode = class GraphWhileLoopNode extends base_js_1.GraphNode {
+    static async execute(request, context) {
+        const metadata = (0, loop_metadata_js_1.extractLoopMetadata)(context, "while");
+        const input = request.inputs;
+        const maxIterations = metadata.maxIterations ?? constants_js_1.GRAPH_DEFAULT_MAX_LOOP_ITERATIONS;
+        const condition = metadata.condition;
+        if (!condition) {
+            throw new GraphInputError_js_1.GraphInputError("while node is missing a condition");
+        }
+        const statePort = metadata.statePort ?? "state";
+        const bodyWorkflow = metadata.body;
+        const engine = context.engine;
+        if (!engine) {
+            throw new GraphExecutionError_js_1.GraphExecutionError("while node requires engine access", "GRAPH_ENGINE_NOT_AVAILABLE");
+        }
+        let state = input.state;
+        let iteration = 0;
+        await context.emit({ type: graph_2.GraphExecutionEventType.LOOP_STARTED });
+        while (new GraphConditionEvaluator_js_1.GraphConditionEvaluator().evaluate(condition, state)) {
+            if (iteration >= maxIterations) {
+                await context.emit({
+                    type: graph_2.GraphExecutionEventType.LOOP_LIMIT_REACHED,
+                    iteration,
+                });
+                throw new GraphLoopLimitError_js_1.GraphLoopLimitError(`while loop exceeded max iterations (${maxIterations})`);
+            }
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_CONDITION_EVALUATED,
+                iteration,
+                payload: { result: true },
+            });
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_ITERATION_STARTED,
+                iteration,
+            });
+            const childResult = await engine.execute(bodyWorkflow, { [statePort]: state, iteration }, {
+                parentRunId: context.runId,
+                path: [...context.path, `iteration:${iteration}`],
+            });
+            state = childResult.outputs[statePort];
+            await context.emit({
+                type: graph_2.GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                iteration,
+            });
+            iteration++;
+        }
+        await context.emit({ type: graph_2.GraphExecutionEventType.LOOP_COMPLETED });
+        return { [statePort]: state, iterations: iteration };
+    }
+};
+exports.GraphWhileLoopNode = GraphWhileLoopNode;
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, ui_decorators_1.uielement)("input", { label: "State", placeholder: "Initial state" }),
+    (0, graph_1.input)({ handle: "state" }),
+    __metadata("design:type", Object)
+], GraphWhileLoopNode.prototype, "state", void 0);
+__decorate([
+    (0, decorator_validation_1.required)(),
+    (0, ui_decorators_1.uielement)("input", {
+        label: "Final state",
+        placeholder: "Final state after loop",
+    }),
+    (0, graph_1.output)({ handle: "state" }),
+    __metadata("design:type", Object)
+], GraphWhileLoopNode.prototype, "stateOut", void 0);
+exports.GraphWhileLoopNode = GraphWhileLoopNode = __decorate([
+    (0, graph_1.node)("graph-while-loop-node", {
+        kind: "core.loop.while",
+        category: "Loop",
+        color: "#eab308",
+        icon: "ti-arrows-loop",
+        width: 96,
+        height: 96,
+        labels: ["loop", "conditional", "while"],
+        metadata: {
+            title: "While loop",
+            description: "Repeats the body while the condition is true (pre-condition).",
+            loop: {
+                maxIterations: 50,
+                statePort: "state",
+                condition: {
+                    type: "lessThan",
+                    left: "iteration",
+                    right: 3,
+                },
+            },
+        },
+    }),
+    (0, decorator_validation_1.model)()
+], GraphWhileLoopNode);
+//# sourceMappingURL=while.js.map
+//# sourceMappingURL=while.cjs.map

package/lib/cjs/graph/nodes/loops/while.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/nodes/loops/while.cjs","sourceRoot":"","sources":["graph/nodes/loops/while.js"],"names":[],"mappings":"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"}