@decaf-ts/integrations 0.3.8 → 0.3.10

package/lib/cjs/graph/engine/execution/GraphExecutionEngine.cjs

@@ -0,0 +1,413 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphExecutionEngine = void 0;
+const constants_js_1 = require("./../constants.cjs");
+const constants_js_2 = require("./../../shared/constants.cjs");
+const index_js_1 = require("./../errors/index.cjs");
+const GraphExecutionEventEmitter_js_1 = require("./../events/GraphExecutionEventEmitter.cjs");
+const GraphExecutionEventFactory_js_1 = require("./../events/GraphExecutionEventFactory.cjs");
+const GraphExecutionPlanner_js_1 = require("./../planning/GraphExecutionPlanner.cjs");
+const InMemoryGraphValueStoreAdapter_js_1 = require("./../store/InMemoryGraphValueStoreAdapter.cjs");
+const GraphValueStore_js_1 = require("./../store/GraphValueStore.cjs");
+const GraphPinningService_js_1 = require("./../pinning/GraphPinningService.cjs");
+const GraphPinningPolicy_js_1 = require("./../pinning/GraphPinningPolicy.cjs");
+const GraphPinningDependencyResolver_js_1 = require("./../pinning/GraphPinningDependencyResolver.cjs");
+const GraphExecutionContext_js_1 = require("./GraphExecutionContext.cjs");
+const GraphExecutionFrame_js_1 = require("./GraphExecutionFrame.cjs");
+const GraphExecutionResult_js_1 = require("./GraphExecutionResult.cjs");
+/**
+ * Reference graph execution engine.
+ *
+ * Executes a {@link GraphWorkflowDefinition} by:
+ * 1. Planning the workflow into topological layers.
+ * 2. Seeding workflow inputs into the value store.
+ * 3. Executing nodes layer-by-layer with configurable concurrency.
+ * 4. Routing values along edges.
+ * 5. Emitting structured events through Decaf's Observable pipeline.
+ * 6. Returning a complete {@link GraphExecutionResult}.
+ */
+class GraphExecutionEngine {
+    constructor(config) {
+        this.emitter = config.eventEmitter ?? new GraphExecutionEventEmitter_js_1.GraphExecutionEventEmitter();
+        this.planner = config.planner ?? new GraphExecutionPlanner_js_1.GraphExecutionPlanner();
+        this.valueStoreAdapter =
+            config.valueStoreAdapter ?? new InMemoryGraphValueStoreAdapter_js_1.InMemoryGraphValueStoreAdapter();
+        this.defaultOptions = config.defaultOptions ?? {};
+        this.codeSandboxEvaluator = config.codeSandboxEvaluator;
+        this.config = config;
+        config.onEngineCreated?.(this);
+    }
+    observe(observer) {
+        return this.emitter.observe(observer);
+    }
+    unObserve(observer) {
+        this.emitter.unObserve(observer);
+    }
+    async updateObservers(event) {
+        await this.emitter.updateObservers(event);
+    }
+    /**
+     * Executes a workflow with the given inputs and options.
+     */
+    async execute(workflow, inputs = {}, options = {}) {
+        const opts = this.mergeOptions(options);
+        const runId = opts.runId ?? this.generateRunId();
+        const path = opts.path ?? [];
+        const eventFactory = new GraphExecutionEventFactory_js_1.GraphExecutionEventFactory();
+        const valueStore = new GraphValueStore_js_1.GraphValueStore(this.valueStoreAdapter);
+        valueStore.seedWorkflowInputs(inputs);
+        const plan = this.planner.plan(workflow);
+        const frame = new GraphExecutionFrame_js_1.GraphExecutionFrame(runId, plan, valueStore, eventFactory);
+        const emitFn = async (partial) => {
+            await this.emitEvent(frame, {
+                type: partial.type ?? constants_js_2.GraphExecutionEventType.NODE_OUTPUT,
+                runId,
+                parentRunId: opts.parentRunId,
+                workflowId: workflow.name,
+                nodeId: partial.nodeId,
+                path: partial.path ?? path,
+                ...partial,
+            });
+        };
+        await this.emitEvent(frame, {
+            type: constants_js_2.GraphExecutionEventType.WORKFLOW_STARTED,
+            runId,
+            parentRunId: opts.parentRunId,
+            workflowId: workflow.name,
+            path,
+            status: constants_js_2.GraphExecutionStatus.RUNNING,
+            payload: { inputs },
+        });
+        await this.emitEvent(frame, {
+            type: constants_js_2.GraphExecutionEventType.WORKFLOW_PLANNED,
+            runId,
+            parentRunId: opts.parentRunId,
+            workflowId: workflow.name,
+            path,
+            status: constants_js_2.GraphExecutionStatus.PLANNING,
+            payload: { layers: plan.layers.length, nodes: plan.nodes.length },
+        });
+        try {
+            for (const layer of plan.layers) {
+                await this.executeLayer(frame, plan, layer.nodes, opts, emitFn);
+            }
+            const firstFailure = [...frame.nodeResults.values()].find((result) => result.status === constants_js_2.GraphExecutionStatus.FAILED);
+            if (firstFailure?.error) {
+                throw new index_js_1.GraphExecutionError(firstFailure.error.message, firstFailure.error.code ?? "GRAPH_EXECUTION_ERROR", firstFailure.error.details);
+            }
+            frame.finish();
+            await this.emitEvent(frame, {
+                type: constants_js_2.GraphExecutionEventType.WORKFLOW_COMPLETED,
+                runId,
+                parentRunId: opts.parentRunId,
+                workflowId: workflow.name,
+                path,
+                status: constants_js_2.GraphExecutionStatus.SUCCEEDED,
+                payload: { outputs: valueStore.getWorkflowValues() },
+            });
+            return (0, GraphExecutionResult_js_1.buildGraphExecutionResult)(frame, workflow, inputs, constants_js_2.GraphExecutionStatus.SUCCEEDED, opts.metadata);
+        }
+        catch (error) {
+            frame.finish();
+            const errorPayload = this.toErrorPayload(error);
+            await this.emitEvent(frame, {
+                type: constants_js_2.GraphExecutionEventType.WORKFLOW_FAILED,
+                runId,
+                parentRunId: opts.parentRunId,
+                workflowId: workflow.name,
+                path,
+                status: constants_js_2.GraphExecutionStatus.FAILED,
+                error: errorPayload,
+            });
+            return (0, GraphExecutionResult_js_1.buildGraphExecutionResult)(frame, workflow, inputs, constants_js_2.GraphExecutionStatus.FAILED, opts.metadata);
+        }
+    }
+    /**
+     * Pins a node and its upstream dependencies after a completed run.
+     *
+     * Delegates to {@link GraphPinningService}. The plan and result must come
+     * from a prior successful execution of the same workflow.
+     */
+    async pinNode(options) {
+        const service = this.createPinningService();
+        await service.pinNode(options);
+        await this.emitPinningEvent(options.nodeId, constants_js_2.GraphExecutionEventType.NODE_PINNED);
+    }
+    /**
+     * Unpins a node by its fingerprint.
+     */
+    async unpinNode(options) {
+        const service = this.createPinningService();
+        await service.unpinNode(options);
+        await this.emitPinningEvent(options.nodeId, constants_js_2.GraphExecutionEventType.NODE_UNPINNED);
+    }
+    /**
+     * Creates a {@link GraphPinningService} backed by this engine's value store
+     * adapter.
+     */
+    createPinningService() {
+        const store = new GraphValueStore_js_1.GraphValueStore(this.valueStoreAdapter);
+        return new GraphPinningService_js_1.GraphPinningService(store, new GraphPinningPolicy_js_1.GraphPinningPolicy(), new GraphPinningDependencyResolver_js_1.GraphPinningDependencyResolver());
+    }
+    /**
+     * Emits a pinning-related event to all observers.
+     */
+    async emitPinningEvent(nodeId, type) {
+        const factory = new GraphExecutionEventFactory_js_1.GraphExecutionEventFactory();
+        const event = factory.create({
+            id: "",
+            sequence: 0,
+            timestamp: new Date(),
+            runId: "pinning",
+            workflowId: "",
+            type,
+            nodeId,
+            path: [],
+        });
+        await this.emitter.updateObservers(event);
+    }
+    /**
+     * Executes a layer of nodes with the configured concurrency.
+     */
+    async executeLayer(frame, plan, nodes, opts, emitFn) {
+        const concurrency = Math.max(1, opts.concurrency ?? constants_js_1.GRAPH_DEFAULT_CONCURRENCY);
+        const queue = [...nodes];
+        while (queue.length > 0) {
+            const batch = queue.splice(0, concurrency);
+            await Promise.all(batch.map((node) => this.executeNode(frame, plan, node, opts, emitFn)));
+        }
+    }
+    /**
+     * Executes a single node.
+     */
+    async executeNode(frame, plan, planNode, opts, emitFn) {
+        const startedAt = new Date();
+        const nodePath = [...(opts.path ?? []), planNode.id];
+        await this.emitEvent(frame, {
+            type: constants_js_2.GraphExecutionEventType.NODE_STARTED,
+            runId: frame.runId,
+            workflowId: plan.workflowId,
+            nodeId: planNode.id,
+            path: nodePath,
+            status: constants_js_2.GraphExecutionStatus.RUNNING,
+        });
+        const inputs = this.resolveNodeInputs(frame, plan, planNode);
+        // Cache-hit: check for a pinned value before executing the node
+        if (opts.usePinnedValues) {
+            const cached = await this.tryPinnedValue(frame, plan, planNode, inputs);
+            if (cached) {
+                frame.valueStore.setNodeOutputs(planNode.id, cached.outputs);
+                this.routeOutgoingEdges(frame, plan, planNode, cached.outputs);
+                const finishedAt = new Date();
+                const result = {
+                    nodeId: planNode.id,
+                    status: constants_js_2.GraphExecutionStatus.CACHED,
+                    inputs,
+                    outputs: cached.outputs,
+                    startedAt,
+                    finishedAt,
+                    fromCache: true,
+                    pinned: true,
+                    events: [],
+                };
+                frame.recordNodeResult(result);
+                await this.emitEvent(frame, {
+                    type: constants_js_2.GraphExecutionEventType.NODE_CACHE_HIT,
+                    runId: frame.runId,
+                    workflowId: plan.workflowId,
+                    nodeId: planNode.id,
+                    path: nodePath,
+                    status: constants_js_2.GraphExecutionStatus.CACHED,
+                    payload: { outputs: cached.outputs },
+                });
+                await this.emitEvent(frame, {
+                    type: constants_js_2.GraphExecutionEventType.NODE_COMPLETED,
+                    runId: frame.runId,
+                    workflowId: plan.workflowId,
+                    nodeId: planNode.id,
+                    path: nodePath,
+                    status: constants_js_2.GraphExecutionStatus.SUCCEEDED,
+                    payload: { outputs: cached.outputs, fromCache: true },
+                });
+                return;
+            }
+        }
+        try {
+            const executor = this.config.registry.resolve(planNode.kind);
+            const context = new GraphExecutionContext_js_1.GraphExecutionContext(frame.runId, opts.parentRunId, plan.workflow, planNode.definition, nodePath, emitFn, opts.metadata);
+            const outputs = await executor.execute(inputs, context);
+            const resolvedOutputs = outputs ?? {};
+            frame.valueStore.setNodeOutputs(planNode.id, resolvedOutputs);
+            this.routeOutgoingEdges(frame, plan, planNode, resolvedOutputs);
+            const finishedAt = new Date();
+            const result = {
+                nodeId: planNode.id,
+                status: constants_js_2.GraphExecutionStatus.SUCCEEDED,
+                inputs,
+                outputs: resolvedOutputs,
+                startedAt,
+                finishedAt,
+                events: [],
+            };
+            frame.recordNodeResult(result);
+            await this.emitEvent(frame, {
+                type: constants_js_2.GraphExecutionEventType.NODE_COMPLETED,
+                runId: frame.runId,
+                workflowId: plan.workflowId,
+                nodeId: planNode.id,
+                path: nodePath,
+                status: constants_js_2.GraphExecutionStatus.SUCCEEDED,
+                payload: { outputs: resolvedOutputs },
+            });
+        }
+        catch (error) {
+            const finishedAt = new Date();
+            const errorPayload = this.toErrorPayload(error);
+            const result = {
+                nodeId: planNode.id,
+                status: constants_js_2.GraphExecutionStatus.FAILED,
+                inputs,
+                error: errorPayload,
+                startedAt,
+                finishedAt,
+                events: [],
+            };
+            frame.recordNodeResult(result);
+            await this.emitEvent(frame, {
+                type: constants_js_2.GraphExecutionEventType.NODE_FAILED,
+                runId: frame.runId,
+                workflowId: plan.workflowId,
+                nodeId: planNode.id,
+                path: nodePath,
+                status: constants_js_2.GraphExecutionStatus.FAILED,
+                error: errorPayload,
+            });
+            if (opts.failFast ?? true)
+                throw error;
+        }
+    }
+    /**
+     * Resolves a node's input values from incoming edges.
+     */
+    resolveNodeInputs(frame, plan, planNode) {
+        const inputs = {};
+        const incoming = plan.incomingByNode.get(planNode.id) ?? [];
+        for (const edge of incoming) {
+            inputs[edge.targetPort] = frame.valueStore.getPort(edge.sourceNodeId, edge.sourcePort);
+        }
+        return inputs;
+    }
+    /**
+     * Attempts to read a pinned value for the node. Returns the cached outputs
+     * when a valid pinned value exists, or `undefined` to proceed with normal
+     * execution.
+     */
+    async tryPinnedValue(frame, plan, planNode, inputs) {
+        const policy = new GraphPinningPolicy_js_1.GraphPinningPolicy();
+        if (!policy.shouldUsePinnedValue(planNode))
+            return undefined;
+        const service = this.createPinningService();
+        const depFingerprints = this.computeDependencyFingerprints(frame, plan, planNode.id);
+        return service.readPinnedValue(plan.workflow, planNode, inputs, depFingerprints);
+    }
+    /**
+     * Recursively computes fingerprints for all upstream dependencies of a node
+     * using the results already accumulated in the frame.
+     */
+    computeDependencyFingerprints(frame, plan, nodeId) {
+        const service = this.createPinningService();
+        const depResolver = new GraphPinningDependencyResolver_js_1.GraphPinningDependencyResolver();
+        const deps = depResolver.getDependencies(plan, nodeId);
+        const fingerprints = {};
+        for (const dep of deps) {
+            const node = plan.nodes.find((n) => n.id === dep);
+            if (node) {
+                const depResult = frame.nodeResults.get(dep);
+                const inputs = depResult?.inputs ?? {};
+                const nestedDeps = this.computeDependencyFingerprints(frame, plan, dep);
+                fingerprints[dep] = service.computeFingerprint(plan.workflow, node, inputs, nestedDeps);
+            }
+        }
+        return fingerprints;
+    }
+    /**
+     * Routes a node's outputs to downstream inputs and workflow outputs.
+     */
+    routeOutgoingEdges(frame, plan, planNode, outputs) {
+        const outgoing = plan.outgoingByNode.get(planNode.id) ?? [];
+        for (const edge of outgoing) {
+            const value = outputs[edge.sourcePort];
+            if (edge.targetNodeId === constants_js_1.GRAPH_WORKFLOW_BOUNDARY) {
+                frame.valueStore.setWorkflowOutput(edge.targetPort, value);
+            }
+            this.emitEvent(frame, {
+                type: constants_js_2.GraphExecutionEventType.EDGE_VALUE_ROUTED,
+                runId: frame.runId,
+                workflowId: plan.workflowId,
+                edgeId: edge.id,
+                nodeId: planNode.id,
+                path: [],
+                payload: { edge, value },
+            }).catch(() => {
+                // observer failures must not crash
+            });
+        }
+    }
+    /**
+     * Emits an event, records it in the frame, and dispatches to observers.
+     */
+    async emitEvent(frame, partial) {
+        const event = frame.eventFactory.create({
+            id: "",
+            sequence: 0,
+            timestamp: new Date(),
+            ...partial,
+        });
+        frame.appendEvent(event);
+        await this.emitter.updateObservers(event);
+    }
+    /**
+     * Merges default options with the given options.
+     */
+    mergeOptions(options) {
+        return {
+            concurrency: constants_js_1.GRAPH_DEFAULT_CONCURRENCY,
+            failFast: true,
+            validateInputs: true,
+            validateOutputs: true,
+            usePinnedValues: true,
+            writeThroughCache: false,
+            path: [],
+            metadata: {},
+            ...this.defaultOptions,
+            ...options,
+        };
+    }
+    /**
+     * Generates a unique run id.
+     */
+    generateRunId() {
+        return (globalThis.crypto?.randomUUID?.() ??
+            `graph-run-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    }
+    /**
+     * Converts an error into a serialized payload.
+     */
+    toErrorPayload(error) {
+        if (error instanceof Error) {
+            return {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+                code: error.graphCode ??
+                    (typeof error.code === "number"
+                        ? String(error.code)
+                        : error.code),
+            };
+        }
+        return { name: "UnknownError", message: String(error) };
+    }
+}
+exports.GraphExecutionEngine = GraphExecutionEngine;
+//# sourceMappingURL=GraphExecutionEngine.js.map
+//# sourceMappingURL=GraphExecutionEngine.cjs.map

package/lib/cjs/graph/engine/execution/GraphExecutionEngine.cjs.map

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

package/lib/cjs/graph/engine/execution/GraphExecutionFrame.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphExecutionFrame = void 0;
+/**
+ * Mutable state for a single graph execution run.
+ */
+class GraphExecutionFrame {
+    constructor(runId, plan, valueStore, eventFactory) {
+        this.nodeResults = new Map();
+        this.events = [];
+        this.runId = runId;
+        this.plan = plan;
+        this.valueStore = valueStore;
+        this.eventFactory = eventFactory;
+        this.startedAt = new Date();
+    }
+    /** Records a node execution result. */
+    recordNodeResult(result) {
+        this.nodeResults.set(result.nodeId, result);
+    }
+    /** Appends an event to the run's event log. */
+    appendEvent(event) {
+        this.events.push(event);
+    }
+    /** Marks the run as finished. */
+    finish() {
+        this.finishedAt = new Date();
+    }
+}
+exports.GraphExecutionFrame = GraphExecutionFrame;
+//# sourceMappingURL=GraphExecutionFrame.js.map
+//# sourceMappingURL=GraphExecutionFrame.cjs.map

package/lib/cjs/graph/engine/execution/GraphExecutionFrame.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/execution/GraphExecutionFrame.cjs","sourceRoot":"","sources":["graph/engine/execution/GraphExecutionFrame.js"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,mBAAmB;IAC5B,YAAY,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,uCAAuC;IACvC,gBAAgB,CAAC,MAAM;QACnB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,+CAA+C;IAC/C,WAAW,CAAC,KAAK;QACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,iCAAiC;IACjC,MAAM;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;CACJ;AAtBD,kDAsBC;AACD,+CAA+C"}

package/lib/cjs/graph/engine/execution/GraphExecutionResult.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGraphExecutionResult = buildGraphExecutionResult;
+/**
+ * Builds a {@link GraphExecutionResult} from a completed frame.
+ */
+function buildGraphExecutionResult(frame, workflow, inputs, status, metadata) {
+    const outputs = frame.valueStore.getWorkflowValues();
+    const nodeResults = {};
+    for (const [id, result] of frame.nodeResults) {
+        nodeResults[id] = result;
+    }
+    const events = [...frame.events];
+    const runId = frame.runId;
+    return {
+        runId,
+        workflowId: workflow.name,
+        status,
+        workflow,
+        inputs: { ...inputs },
+        outputs,
+        nodeResults,
+        events,
+        startedAt: frame.startedAt,
+        finishedAt: frame.finishedAt,
+        metadata,
+    };
+}
+//# sourceMappingURL=GraphExecutionResult.js.map
+//# sourceMappingURL=GraphExecutionResult.cjs.map

package/lib/cjs/graph/engine/execution/GraphExecutionResult.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/execution/GraphExecutionResult.cjs","sourceRoot":"","sources":["graph/engine/execution/GraphExecutionResult.js"],"names":[],"mappings":";;AAGA,8DAqBC;AAxBD;;GAEG;AACH,SAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;IAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;IACrD,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,WAAW,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,OAAO;QACH,KAAK;QACL,UAAU,EAAE,QAAQ,CAAC,IAAI;QACzB,MAAM;QACN,QAAQ;QACR,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;QACrB,OAAO;QACP,WAAW;QACX,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ;KACX,CAAC;AACN,CAAC;AACD,gDAAgD"}

package/lib/cjs/graph/engine/execution/GraphNodeExecutor.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GraphNodeExecutor.js.map
+//# sourceMappingURL=GraphNodeExecutor.cjs.map

package/lib/cjs/graph/engine/execution/GraphNodeExecutor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/execution/GraphNodeExecutor.cjs","sourceRoot":"","sources":["graph/engine/execution/GraphNodeExecutor.js"],"names":[],"mappings":";;AACA,6CAA6C"}

package/lib/cjs/graph/engine/execution/SwitchGraphNodeExecutor.cjs

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwitchGraphNodeExecutor = void 0;
+const GraphExecutionError_js_1 = require("./../errors/GraphExecutionError.cjs");
+const ConditionExpressionEvaluator_js_1 = require("./../loops/ConditionExpressionEvaluator.cjs");
+/**
+ * Reads the Switch metadata from the node definition's graph metadata.
+ */
+function readSwitchMetadata(context) {
+    const meta = context.node.graph?.metadata;
+    if (!meta)
+        return { cases: [], defaultPort: "default" };
+    const switchMeta = meta["switch"];
+    if (!switchMeta || !Array.isArray(switchMeta.cases)) {
+        return { cases: [], defaultPort: "default" };
+    }
+    return {
+        cases: switchMeta.cases,
+        defaultPort: switchMeta.defaultPort ?? "default",
+    };
+}
+/**
+ * Detects whether a condition is a `CodeCondition` (has `type: "code"`).
+ */
+function isCodeCondition(cond) {
+    return (typeof cond === "object" &&
+        cond !== null &&
+        "type" in cond &&
+        cond.type === "code");
+}
+/**
+ * Detects whether a condition is a `ConditionExpression` (has `op` field).
+ */
+function isConditionExpression(cond) {
+    return (typeof cond === "object" &&
+        cond !== null &&
+        "op" in cond &&
+        typeof cond.op === "string");
+}
+/**
+ * Executor for `core.flow.switch` nodes.
+ *
+ * Evaluates each case's condition in order and routes the input to the
+ * first matching case's output port. When no case matches, routes to the
+ * `default` output port.
+ *
+ * Condition evaluation:
+ * - `ConditionExpression` — evaluated via {@link ConditionExpressionEvaluator}.
+ * - `CodeCondition` — evaluated via the pluggable {@link CodeSandboxEvaluator}
+ *   from the engine's config. Throws `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`
+ *   when no evaluator is registered.
+ */
+class SwitchGraphNodeExecutor {
+    constructor(engine) {
+        this.engine = engine;
+        this.expressionEvaluator = new ConditionExpressionEvaluator_js_1.ConditionExpressionEvaluator();
+    }
+    async execute(input, context) {
+        const meta = readSwitchMetadata(context);
+        const inputValue = input["value"] ?? input;
+        for (const switchCase of meta.cases) {
+            const matches = await this.evaluateCondition(switchCase.condition, inputValue, input, context);
+            if (matches) {
+                return { [switchCase.outputPort]: inputValue };
+            }
+        }
+        const defaultPort = meta.defaultPort ?? "default";
+        return { [defaultPort]: inputValue };
+    }
+    /**
+     * Evaluates a single switch case condition.
+     */
+    async evaluateCondition(condition, inputValue, fullInput, context) {
+        if (isCodeCondition(condition)) {
+            return this.evaluateCodeCondition(condition, fullInput, context);
+        }
+        if (isConditionExpression(condition)) {
+            return this.expressionEvaluator.evaluate(condition, inputValue);
+        }
+        throw new GraphExecutionError_js_1.GraphExecutionError("Unknown switch case condition type — must be ConditionExpression (op) or CodeCondition (type: 'code')", "GRAPH_UNKNOWN_SWITCH_CONDITION", { condition });
+    }
+    /**
+     * Evaluates a code condition via the pluggable sandbox evaluator.
+     */
+    async evaluateCodeCondition(condition, input, context) {
+        const evaluator = this.engine?.codeSandboxEvaluator;
+        if (!evaluator) {
+            throw new GraphExecutionError_js_1.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 result = await evaluator.evaluate({
+            code: condition.code,
+            language: condition.language,
+            input,
+        });
+        return !!result;
+    }
+}
+exports.SwitchGraphNodeExecutor = SwitchGraphNodeExecutor;
+//# sourceMappingURL=SwitchGraphNodeExecutor.js.map
+//# sourceMappingURL=SwitchGraphNodeExecutor.cjs.map

package/lib/cjs/graph/engine/execution/SwitchGraphNodeExecutor.cjs.map

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

package/lib/cjs/graph/engine/execution/index.cjs

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/graph/execution
+ * @summary Graph execution context and executor interface.
+ * @description Re-exports the graph execution context and node executor interface.
+ */
+__exportStar(require("./GraphExecutionContext.cjs"), exports);
+__exportStar(require("./GraphNodeExecutor.cjs"), exports);
+__exportStar(require("./GraphExecutionResult.cjs"), exports);
+__exportStar(require("./GraphExecutionFrame.cjs"), exports);
+__exportStar(require("./GraphExecutionEngine.cjs"), exports);
+__exportStar(require("./CodeSandboxEvaluator.cjs"), exports);
+__exportStar(require("./SwitchGraphNodeExecutor.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/graph/engine/execution/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/execution/index.cjs","sourceRoot":"","sources":["graph/engine/execution/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,6DAA2C;AAC3C,yDAAuC;AACvC,4DAA0C;AAC1C,2DAAyC;AACzC,4DAA0C;AAC1C,4DAA0C;AAC1C,+DAA6C;AAC7C,iCAAiC"}