@decaf-ts/integrations 0.10.5 → 0.10.8

package/lib/esm/graph/nodes/flow-control/switch.js

@@ -0,0 +1,181 @@
+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/flow-control/switch
+ * @summary Switch flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Switch — multi-branch. Routes the input to one of the case
+ * output ports or `default` based on matching conditions. Each case defines
+ * a `SwitchCaseCondition` (graphical or code mode) and a dedicated output
+ * port. Cases are stored in `metadata.switch.cases` and the renderer creates
+ * dynamic output ports from them (DECAF-32 §22.2.2).
+ *
+ * The node grows in height as cases are added. Each case gets its own
+ * output port on the right side, labeled with the case label.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { input, node, output, } from "@decaf-ts/ui-decorators/graph";
+import { PortDirection, graphNodeSizeOf, } from "@decaf-ts/ui-decorators/graph";
+import { graphDefinitionOf } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+import { GraphExecutionError } from "./../../engine/errors/GraphExecutionError.js";
+import { ConditionExpressionEvaluator } from "./../../engine/loops/ConditionExpressionEvaluator.js";
+function readSwitchMetadata(context) {
+    const parameters = (context.node.parameters ?? {});
+    const metadata = context.node.metadata;
+    const raw = parameters["switch"] ?? metadata?.["switch"];
+    const switchMeta = raw;
+    if (!switchMeta || !Array.isArray(switchMeta.cases)) {
+        return { cases: [], defaultPort: "default", hasDefault: false };
+    }
+    return {
+        cases: switchMeta.cases,
+        defaultPort: switchMeta.defaultPort ?? "default",
+        hasDefault: switchMeta.hasDefault === true,
+    };
+}
+function isCodeCondition(cond) {
+    return (typeof cond === "object" && cond !== null && "type" in cond && cond.type === "code");
+}
+function isConditionExpression(cond) {
+    return (typeof cond === "object" && cond !== null && "op" in cond && typeof cond.op === "string");
+}
+async function evaluateSwitchCondition(condition, inputValue, fullInput, context) {
+    if (isCodeCondition(condition)) {
+        const evaluator = context.engine?.codeSandboxEvaluator;
+        if (!evaluator) {
+            throw new GraphExecutionError("Code conditions require a CodeSandboxEvaluator to be registered in GraphExecutionEngineConfig.codeSandboxEvaluator", "GRAPH_CODE_SANDBOX_NOT_CONFIGURED", { code: condition.code });
+        }
+        await context.log("Evaluating code condition", {
+            language: condition.language ?? "javascript",
+        });
+        const md = context.metadata;
+        const result = await evaluator.evaluate({
+            code: condition.code,
+            language: condition.language,
+            input: fullInput,
+            vars: md?.vars ?? undefined,
+            item: md?.item,
+            index: md?.index,
+            nodes: md?.nodes ??
+                undefined,
+            logger: context.logger,
+        });
+        return !!result;
+    }
+    if (isConditionExpression(condition)) {
+        return new ConditionExpressionEvaluator().evaluate(condition, inputValue);
+    }
+    throw new GraphExecutionError("Unknown switch case condition type — must be ConditionExpression (op) or CodeCondition (type: 'code')", "GRAPH_UNKNOWN_SWITCH_CONDITION", { condition });
+}
+let SwitchFlowNode = class SwitchFlowNode extends GraphNode {
+    static async execute(request, context) {
+        const meta = readSwitchMetadata(context);
+        const input = request.inputs;
+        const inputValue = input["value"] ?? input;
+        for (const switchCase of meta.cases) {
+            const matches = await evaluateSwitchCondition(switchCase.condition, inputValue, input, context);
+            if (matches) {
+                return { [switchCase.outputPort]: inputValue };
+            }
+        }
+        if (meta.hasDefault !== true) {
+            throw new GraphExecutionError("No switch case matched and default port is not enabled", "GRAPH_SWITCH_NO_MATCH", { cases: meta.cases.map((c) => c.id) });
+        }
+        const defaultPort = meta.defaultPort ?? "default";
+        return { [defaultPort]: inputValue };
+    }
+    /**
+     * Computes the node's ports, size, and data patch from the given switch
+     * metadata. Each case gets its own output port on the right side; the
+     * `default` port always renders **last** (DECAF-32 §21 port-ordering rule,
+     * DECAF-34 §6.2). When `hasDefault` is `false`, the `default` output port
+     * is omitted entirely. The node grows in height as cases are added.
+     *
+     * @param meta - The switch metadata patch (`metadata.switch`), carrying
+     *   the cases and the optional default-port configuration.
+     * @returns The computed {@link NodeMetadataChange}: reordered ports
+     *   (case outputs inserted before the optional default), the grown size,
+     *   and the `switchMetadata` data patch.
+     */
+    static applyMetadata(meta) {
+        const definition = graphDefinitionOf(this);
+        const defaultPortName = meta.defaultPort ?? "default";
+        const hasDefault = meta.hasDefault === true;
+        // Base ports excluding any port that collides with a case output port.
+        const basePorts = definition.ports.filter((p) => !meta.cases.some((c) => c.outputPort === p.property));
+        // Separate the default output port so it can be placed last (or omitted).
+        const nonDefaultPorts = basePorts.filter((p) => p.property !== defaultPortName);
+        const defaultPort = basePorts.find((p) => p.property === defaultPortName);
+        const casePorts = meta.cases.map((c) => ({
+            property: c.outputPort,
+            name: c.label,
+            direction: PortDirection.OUTPUT,
+            label: c.label,
+            required: false,
+            hidden: false,
+            path: c.outputPort,
+        }));
+        // Port order: inputs/non-default outputs first, case outputs next, default last.
+        const ports = [...nonDefaultPorts, ...casePorts];
+        if (hasDefault && defaultPort) {
+            ports.push(defaultPort);
+        }
+        const caseCount = meta.cases.length;
+        return {
+            ports,
+            size: graphNodeSizeOf(definition, { cases: caseCount }),
+            dataPatch: { switchMetadata: meta },
+        };
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", { label: "Input value", placeholder: "Value to switch on" }),
+    input({ handle: "value" }),
+    __metadata("design:type", Object)
+], SwitchFlowNode.prototype, "value", void 0);
+__decorate([
+    required(),
+    uielement("input", { label: "Default", placeholder: "Default output when no case matches" }),
+    output({ handle: "default" }),
+    __metadata("design:type", Object)
+], SwitchFlowNode.prototype, "default", void 0);
+SwitchFlowNode = __decorate([
+    node("core.flow.switch", {
+        kind: "core.flow.switch",
+        category: "Flow Control",
+        color: "#f59e0b",
+        icon: "ti-arrows-shuffle",
+        width: 120,
+        height: 140,
+        sizeRules: [
+            {
+                type: "parameterCount",
+                parameter: "cases",
+                dimension: "height",
+                perItem: 24,
+            },
+        ],
+        labels: ["flow", "switch", "multi-branch"],
+        metadata: {
+            title: "Switch",
+            description: "Multi-branch switch. Routes the input to the first matching case output, or the default output.",
+            switch: {
+                cases: [],
+                defaultPort: "default",
+                hasDefault: false,
+            },
+        },
+    }),
+    model()
+], SwitchFlowNode);
+export { SwitchFlowNode };
+//# sourceMappingURL=switch.js.map

package/lib/esm/graph/nodes/flow-control/switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/flow-control/switch.ts"],"names":[],"mappings":"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"}

package/lib/esm/graph/nodes/index.js

@@ -0,0 +1,144 @@
+/**
+ * @module integrations/graph/nodes
+ * @summary Shared node kind declarations (DECAF-32 §22.2, DECAF-50 Phase A).
+ * @description Canonical `@node`-decorated classes for the ALFRED-5 node kind
+ * taxonomy, laid out one node per file under `nodes/<category>/<node>.ts`:
+ * triggers (§22.2.1), flow-control and utility nodes (§22.2.2–22.2.3), the
+ * Agent node (§21.3), the three loop kinds (`core.loop.foreach/while/until`,
+ * §5.9), and the workflow input-value boundary node. Shared non-node support
+ * (the base class and manifests) lives in sibling files under the same tree;
+ * category styles remain in `@decaf-ts/ui-decorators` (`graph/category-styles`).
+ * Consumers (for-angular, ALFRED, etc.) import these declarations
+ * to populate node palettes, registries, and reference snapshots.
+ */
+export * from "./base.js";
+export * from "./flow-control/break.js";
+export * from "./flow-control/error-boundary.js";
+export * from "./flow-control/human-approval.js";
+export * from "./flow-control/if.js";
+export * from "./flow-control/parallel.js";
+export * from "./flow-control/switch.js";
+export * from "./utility/code.js";
+export * from "./utility/delay.js";
+export * from "./utility/log.js";
+export * from "./utility/map.js";
+export * from "./utility/merge.js";
+export * from "./utility/return.js";
+export * from "./utility/utility-log.js";
+export * from "./triggers/chat.js";
+export * from "./triggers/event.js";
+export * from "./triggers/form.js";
+export * from "./triggers/manual.js";
+export * from "./triggers/schedule.js";
+export * from "./triggers/webhook.js";
+export * from "./agents/agent.js";
+export * from "./loops/foreach.js";
+export * from "./loops/until.js";
+export * from "./loops/while.js";
+import { AgentNode } from "./agents/agent.js";
+export * from "./boundary/input-value.js";
+export * from "./manifests.js";
+import { BreakFlowNode } from "./flow-control/break.js";
+import { ErrorBoundaryFlowNode } from "./flow-control/error-boundary.js";
+import { HumanApprovalFlowNode } from "./flow-control/human-approval.js";
+import { IfFlowNode } from "./flow-control/if.js";
+import { ParallelFlowNode } from "./flow-control/parallel.js";
+import { SwitchFlowNode } from "./flow-control/switch.js";
+import { CodeNode } from "./utility/code.js";
+import { DelayFlowNode } from "./utility/delay.js";
+import { LogFlowNode } from "./utility/log.js";
+import { MapNode } from "./utility/map.js";
+import { MergeFlowNode } from "./utility/merge.js";
+import { ReturnFlowNode } from "./utility/return.js";
+import { UtilityLogNode } from "./utility/utility-log.js";
+import { ChatTriggerNode } from "./triggers/chat.js";
+import { EventTriggerNode } from "./triggers/event.js";
+import { FormTriggerNode } from "./triggers/form.js";
+import { ManualTriggerNode } from "./triggers/manual.js";
+import { ScheduleTriggerNode } from "./triggers/schedule.js";
+import { WebhookTriggerNode } from "./triggers/webhook.js";
+import { GraphForeachLoopNode } from "./loops/foreach.js";
+import { GraphUntilLoopNode } from "./loops/until.js";
+import { GraphWhileLoopNode } from "./loops/while.js";
+import { GraphInputValueNode } from "./boundary/input-value.js";
+/**
+ * All built-in trigger node constructors.
+ */
+export const GRAPH_TRIGGER_NODES = [
+    ManualTriggerNode,
+    WebhookTriggerNode,
+    ScheduleTriggerNode,
+    EventTriggerNode,
+    FormTriggerNode,
+    ChatTriggerNode,
+];
+/**
+ * All built-in flow-control node constructors (branching/routing/looping/
+ * termination semantics).
+ */
+export const GRAPH_FLOW_CONTROL_NODES = [
+    IfFlowNode,
+    SwitchFlowNode,
+    ParallelFlowNode,
+    MergeFlowNode,
+    DelayFlowNode,
+    ErrorBoundaryFlowNode,
+    HumanApprovalFlowNode,
+    ReturnFlowNode,
+    LogFlowNode,
+    BreakFlowNode,
+];
+/**
+ * All built-in utility node constructors (side-effect/data-transformation
+ * semantics — no branching).
+ */
+export const GRAPH_UTILITY_NODES = [
+    CodeNode,
+    MapNode,
+    UtilityLogNode,
+];
+/**
+ * All built-in loop node constructors (shared declarations of the
+ * `core.loop.*` system kinds).
+ */
+export const GRAPH_LOOP_NODES = [
+    GraphForeachLoopNode,
+    GraphWhileLoopNode,
+    GraphUntilLoopNode,
+];
+/**
+ * All built-in boundary node constructors.
+ */
+export const GRAPH_BOUNDARY_NODES = [GraphInputValueNode];
+/**
+ * Kind→class map for every built-in node kind the backend executes
+ * (DECAF-50 §4.26 R2-1). The catalogue derives each registration's
+ * manifest and executor from the class, so this is the single authority for
+ * built-in node behaviour.
+ */
+export const GRAPH_BUILT_IN_NODE_CLASSES_BY_KIND = {
+    "core.trigger.manual": ManualTriggerNode,
+    "core.trigger.webhook": WebhookTriggerNode,
+    "core.trigger.schedule": ScheduleTriggerNode,
+    "core.trigger.event": EventTriggerNode,
+    "core.trigger.form": FormTriggerNode,
+    "core.trigger.chat": ChatTriggerNode,
+    "core.flow.if": IfFlowNode,
+    "core.flow.switch": SwitchFlowNode,
+    "core.flow.parallel": ParallelFlowNode,
+    "core.flow.merge": MergeFlowNode,
+    "core.utility.map": MapNode,
+    "core.flow.delay": DelayFlowNode,
+    "core.flow.errorBoundary": ErrorBoundaryFlowNode,
+    "core.flow.humanApproval": HumanApprovalFlowNode,
+    "core.flow.return": ReturnFlowNode,
+    "core.utility.code": CodeNode,
+    "core.flow.log": LogFlowNode,
+    "core.utility.log": UtilityLogNode,
+    "core.flow.break": BreakFlowNode,
+    "core.agent": AgentNode,
+    "core.loop.foreach": GraphForeachLoopNode,
+    "core.loop.while": GraphWhileLoopNode,
+    "core.loop.until": GraphUntilLoopNode,
+};
+//# sourceMappingURL=index.js.map

package/lib/esm/graph/nodes/index.js.map

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

package/lib/esm/graph/nodes/loops/foreach.js

@@ -0,0 +1,180 @@
+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.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { connection, input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+import { GraphExecutionEventType } from "@decaf-ts/ui-decorators/graph";
+import { GraphExecutionError } from "./../../engine/errors/GraphExecutionError.js";
+import { GraphInputError } from "./../../engine/errors/GraphInputError.js";
+import { GraphLoopLimitError } from "./../../engine/errors/GraphLoopLimitError.js";
+import { extractLoopMetadata } from "./loop-metadata.js";
+import { GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS } from "./../../engine/constants.js";
+import { GraphBreakSignal } from "./../../engine/errors/GraphBreakSignal.js";
+let GraphForeachLoopNode = class GraphForeachLoopNode extends GraphNode {
+    static async execute(request, context) {
+        const metadata = extractLoopMetadata(context, "foreach");
+        const input = request.inputs;
+        const items = input.items;
+        const maxIterations = metadata.maxIterations ?? GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS;
+        if (!Array.isArray(items)) {
+            throw new GraphInputError("foreach input 'items' must be an array");
+        }
+        const engine = context.engine;
+        if (!engine) {
+            throw new 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(`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: GraphExecutionEventType.LOOP_STARTED });
+        for (let i = 0; i < iterations; i++) {
+            await context.emit({
+                type: 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) {
+                    const carried = err.details
+                        ?.value;
+                    if (carried !== undefined)
+                        results.push(carried);
+                    broken = true;
+                    await context.emit({
+                        type: GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                        iteration: i,
+                        metadata: { broken: true },
+                    });
+                    break;
+                }
+                throw err;
+            }
+            await context.emit({
+                type: GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                iteration: i,
+            });
+        }
+        await context.emit({
+            type: GraphExecutionEventType.LOOP_COMPLETED,
+            metadata: { broken },
+        });
+        const output = {
+            results,
+            completed: results,
+            iterations: results.length,
+            broken,
+        };
+        if (state !== undefined)
+            output[statePort] = state;
+        return output;
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Items",
+        placeholder: "Array to iterate over",
+    }),
+    input({ handle: "items" }),
+    __metadata("design:type", Array)
+], GraphForeachLoopNode.prototype, "items", void 0);
+__decorate([
+    required(),
+    uielement("input", {
+        label: "Slice size",
+        placeholder: "Items per iteration (default 1)",
+    }),
+    input({ handle: "slice" }),
+    __metadata("design:type", Number)
+], GraphForeachLoopNode.prototype, "slice", void 0);
+__decorate([
+    required(),
+    output({ handle: "item" }),
+    __metadata("design:type", Object)
+], GraphForeachLoopNode.prototype, "item", void 0);
+__decorate([
+    required(),
+    connection({
+        handle: "loop",
+        connectionRules: { allowSelf: true, maxConnections: 1 },
+    }),
+    __metadata("design:type", Object)
+], GraphForeachLoopNode.prototype, "loop", void 0);
+__decorate([
+    required(),
+    output({ handle: "completed" }),
+    __metadata("design:type", Array)
+], GraphForeachLoopNode.prototype, "completed", void 0);
+GraphForeachLoopNode = __decorate([
+    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,
+            },
+        },
+    }),
+    model()
+], GraphForeachLoopNode);
+export { GraphForeachLoopNode };
+//# sourceMappingURL=foreach.js.map

package/lib/esm/graph/nodes/loops/foreach.js.map

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

package/lib/esm/graph/nodes/loops/loop-metadata.js

@@ -0,0 +1,44 @@
+import { GraphInputError } from "./../../engine/errors/GraphInputError.js";
+/**
+ * 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.
+ */
+export 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(`${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

package/lib/esm/graph/nodes/loops/loop-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-metadata.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/loops/loop-metadata.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,iDAA4C;AAEtE;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA8B,EAC9B,KAAa;IAEb,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9B,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;IAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAI,OAAO,CAAC,QAAgD,EAAE,CAC1E,MAAM,CACgC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,eAAe,CACvB,GAAG,KAAK,0DAA0D,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,CAAC,MAAM,CAAC,CAA8B,CAAC;IAC7E,MAAM,MAAM,GAAG,CAAC,GAAW,EAAsB,EAAE;QACjD,MAAM,GAAG,GACP,UAAU,CAAC,GAAG,CAAC;YACf,IAAI,EAAE,CAAC,GAAoD,CAAC;YAC5D,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QAClB,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;IACzE,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAsB,EAAE;QACjD,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;IACnD,CAAC,CAAC;IACF,OAAO;QACL,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,CAEjD;QACb,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;KACvB,CAAC;AACJ,CAAC"}