@decaf-ts/integrations 0.10.4 → 0.10.8

package/lib/types/graph/engine/execution/CodeGraphNodeExecutor.d.mts

@@ -1,65 +0,0 @@
-/**
- * @module integrations/graph/execution/CodeGraphNodeExecutor
- * @summary Executor for the Code flow-control node (DECAF-32 §22.4, DECAF-34 §7.5).
- * @description Executes user-authored JS/TS in a restricted sandbox via the
- * pluggable {@link CodeSandboxEvaluator}. The sandbox enforces the Code Node
- * restrictions: no imports, no requires, pure functions only (no system API
- * access). The executor reads the code from the node's `code` input port
- * (spliced from {@link CodeInputSchema}), the timeout from the node's graph
- * metadata, resolves the sandbox context from the node's input values and
- * execution context, invokes the evaluator, and returns the result on the
- * `result` output port.
- */
-import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
-import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
-import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
-/**
- * Executor for `core.flow.code` nodes.
- *
- * The Code Node runs user-authored JS/TS in a restricted sandbox. The engine
- * does not implement the sandbox directly (§22.4); instead it delegates to the
- * pluggable {@link CodeSandboxEvaluator} registered on the engine config. When
- * no evaluator is registered, the executor throws
- * `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`.
- *
- * The code is read from the `code` input port (spliced from
- * {@link CodeInputSchema}). The language is hardcoded to `"javascript"` for
- * now (the `language` field on `CodeInputSchema` has no `@input` so it is not
- * a port and not wired). The timeout is read from `graph.metadata.timeoutMs`.
- *
- * The sandbox context exposes:
- * - `$input` — the full input values object (all resolved port values).
- * - `$vars` — workflow variables (sourced from `context.metadata.vars`).
- * - `$item` / `$index` — current loop item and index.
- * - `$node` — outputs of upstream nodes.
- * - `$output` — the current draft output.
- *
- * The evaluator's return value is forwarded verbatim on the `result` output
- * port.
- */
-export declare class CodeGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine?;
-    /**
-     * @param engine - The graph execution engine (or any object exposing the
-     *   optional `codeSandboxEvaluator`). This mirrors the pattern used by
-     * {@link SwitchGraphNodeExecutor} for code conditions.
-     */
-    constructor(engine?: {
-        codeSandboxEvaluator?: CodeSandboxEvaluator;
-    } | undefined);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    /**
-     * Builds the {@link CodeSandboxContext} from the executor input and the
-     * graph execution context.
-     *
-     * The `$input` value is the full input values object so the code can access
-     * every resolved port value (including `code` itself via `$input.code`).
-     *
-     * The `$vars`, `$item`, `$index`, `$node`, and `$output` values are sourced
-     * from `context.metadata` — the engine (or a wrapping loop executor) may
-     * populate these when the Code node runs inside a loop body or a workflow
-     * with variables.
-     */
-    private buildSandboxContext;
-}

package/lib/types/graph/engine/execution/LogGraphNodeExecutor.d.cts

@@ -1,25 +0,0 @@
-import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.cts";
-import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
-/**
- * Executor for `core.utility.log` / `core.flow.log` nodes.
- *
- * Reads the `value` input port, logs it through `context.logger` at the
- * configured level, and returns it unchanged on the `logged` output port.
- */
-export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
-    /**
-     * Logs the `value` input through the run's `ctx.logger` and forwards it
-     * unchanged on the `logged` output port.
-     *
-     * The level is read from the node's UI config (`node.props.level`, see
-     * {@link logLevelOf}) and defaults to `info`. The emitted log line carries
-     * the DECAF-48 run attributes and streams over `graph.run.log` through the
-     * shared `ctx.logger` path (DECAF-48 Req-1).
-     *
-     * @param request - The node execution request (expects the `value` input).
-     * @param context - The run-scoped execution context exposing `ctx.logger`.
-     * @returns The node's output values keyed by port name (the `logged` port).
-     */
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-}

package/lib/types/graph/engine/execution/LogGraphNodeExecutor.d.mts

@@ -1,25 +0,0 @@
-import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
-import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
-/**
- * Executor for `core.utility.log` / `core.flow.log` nodes.
- *
- * Reads the `value` input port, logs it through `context.logger` at the
- * configured level, and returns it unchanged on the `logged` output port.
- */
-export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
-    /**
-     * Logs the `value` input through the run's `ctx.logger` and forwards it
-     * unchanged on the `logged` output port.
-     *
-     * The level is read from the node's UI config (`node.props.level`, see
-     * {@link logLevelOf}) and defaults to `info`. The emitted log line carries
-     * the DECAF-48 run attributes and streams over `graph.run.log` through the
-     * shared `ctx.logger` path (DECAF-48 Req-1).
-     *
-     * @param request - The node execution request (expects the `value` input).
-     * @param context - The run-scoped execution context exposing `ctx.logger`.
-     * @returns The node's output values keyed by port name (the `logged` port).
-     */
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-}

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.cts

@@ -1,43 +0,0 @@
-/**
- * @module integrations/graph/execution/SwitchGraphNodeExecutor
- * @summary Executor for the Switch flow-control node (DECAF-32 §22.2.2).
- * @description Evaluates each case's condition against the node's input and
- * routes the input to the first matching case's output port. Falls back to
- * the `default` output when no case matches. Supports both
- * {@link ConditionExpression} (graphical mode) and {@link CodeCondition}
- * (code mode via the pluggable {@link CodeSandboxEvaluator}).
- */
-import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.cts";
-import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
-import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
-/**
- * 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:
- * - If `hasDefault` is `true`, routes to the `default` output port.
- * - If `hasDefault` is `false` (the default), throws `GRAPH_SWITCH_NO_MATCH`.
- *
- * 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.
- */
-export declare class SwitchGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine?;
-    private readonly expressionEvaluator;
-    constructor(engine?: {
-        codeSandboxEvaluator?: CodeSandboxEvaluator;
-    } | undefined);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    /**
-     * Evaluates a single switch case condition.
-     */
-    private evaluateCondition;
-    /**
-     * Evaluates a code condition via the pluggable sandbox evaluator.
-     */
-    private evaluateCodeCondition;
-}

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.mts

@@ -1,43 +0,0 @@
-/**
- * @module integrations/graph/execution/SwitchGraphNodeExecutor
- * @summary Executor for the Switch flow-control node (DECAF-32 §22.2.2).
- * @description Evaluates each case's condition against the node's input and
- * routes the input to the first matching case's output port. Falls back to
- * the `default` output when no case matches. Supports both
- * {@link ConditionExpression} (graphical mode) and {@link CodeCondition}
- * (code mode via the pluggable {@link CodeSandboxEvaluator}).
- */
-import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
-import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
-import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
-/**
- * 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:
- * - If `hasDefault` is `true`, routes to the `default` output port.
- * - If `hasDefault` is `false` (the default), throws `GRAPH_SWITCH_NO_MATCH`.
- *
- * 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.
- */
-export declare class SwitchGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine?;
-    private readonly expressionEvaluator;
-    constructor(engine?: {
-        codeSandboxEvaluator?: CodeSandboxEvaluator;
-    } | undefined);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    /**
-     * Evaluates a single switch case condition.
-     */
-    private evaluateCondition;
-    /**
-     * Evaluates a code condition via the pluggable sandbox evaluator.
-     */
-    private evaluateCodeCondition;
-}

package/lib/types/graph/engine/loops/ForeachGraphNodeExecutor.d.cts

@@ -1,35 +0,0 @@
-/**
- * @module integrations/graph/loops/ForeachGraphNodeExecutor
- * @summary Foreach loop node executor.
- * @description Executes a body workflow once per item (or per slice of items)
- * in the input array, collecting results in order. Supports a configurable
- * `slice` size and cooperative early termination via `core.flow.break` nodes
- * (which throw a {@link GraphBreakSignal}).
- */
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
-import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
-import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
-/**
- * Executor for `core.loop.foreach` nodes.
- *
- * Expects input:
- * - `items`: array of values to iterate over
- * - `slice?`: optional slice size (overrides `metadata.loop.slice`); default `1`
- * - `state?`: optional initial state
- *
- * Produces output:
- * - `results`: array of body outputs (in item order). When `slice > 1`, one
- *   entry per slice (the body receives a slice array on the item port).
- * - `completed`: alias for `results` — the flow after the loop ends (the
- *   collected results array).
- * - `iterations`: number of iterations executed
- * - `broken`: `true` when the loop was terminated early by a Break node
- * - `state?`: final state
- */
-export declare class ForeachGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine;
-    constructor(engine: GraphExecutionEngine);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    private extractMetadata;
-}

package/lib/types/graph/engine/loops/ForeachGraphNodeExecutor.d.mts

@@ -1,35 +0,0 @@
-/**
- * @module integrations/graph/loops/ForeachGraphNodeExecutor
- * @summary Foreach loop node executor.
- * @description Executes a body workflow once per item (or per slice of items)
- * in the input array, collecting results in order. Supports a configurable
- * `slice` size and cooperative early termination via `core.flow.break` nodes
- * (which throw a {@link GraphBreakSignal}).
- */
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
-import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
-import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
-/**
- * Executor for `core.loop.foreach` nodes.
- *
- * Expects input:
- * - `items`: array of values to iterate over
- * - `slice?`: optional slice size (overrides `metadata.loop.slice`); default `1`
- * - `state?`: optional initial state
- *
- * Produces output:
- * - `results`: array of body outputs (in item order). When `slice > 1`, one
- *   entry per slice (the body receives a slice array on the item port).
- * - `completed`: alias for `results` — the flow after the loop ends (the
- *   collected results array).
- * - `iterations`: number of iterations executed
- * - `broken`: `true` when the loop was terminated early by a Break node
- * - `state?`: final state
- */
-export declare class ForeachGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine;
-    constructor(engine: GraphExecutionEngine);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    private extractMetadata;
-}

package/lib/types/graph/engine/loops/UntilGraphNodeExecutor.d.cts

@@ -1,22 +0,0 @@
-/**
- * @module integrations/graph/loops/UntilGraphNodeExecutor
- * @summary Until loop node executor.
- * @description Executes a body workflow at least once and repeats until a condition is true.
- */
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
-import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
-import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
-/**
- * Executor for `core.loop.until` nodes.
- *
- * Executes the body at least once, then checks the condition. Repeats until
- * the condition evaluates to true.
- */
-export declare class UntilGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine;
-    private readonly evaluator;
-    constructor(engine: GraphExecutionEngine);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    private extractMetadata;
-}

package/lib/types/graph/engine/loops/UntilGraphNodeExecutor.d.mts

@@ -1,22 +0,0 @@
-/**
- * @module integrations/graph/loops/UntilGraphNodeExecutor
- * @summary Until loop node executor.
- * @description Executes a body workflow at least once and repeats until a condition is true.
- */
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
-import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
-import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
-/**
- * Executor for `core.loop.until` nodes.
- *
- * Executes the body at least once, then checks the condition. Repeats until
- * the condition evaluates to true.
- */
-export declare class UntilGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine;
-    private readonly evaluator;
-    constructor(engine: GraphExecutionEngine);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    private extractMetadata;
-}

package/lib/types/graph/engine/loops/WhileGraphNodeExecutor.d.cts

@@ -1,26 +0,0 @@
-/**
- * @module integrations/graph/loops/WhileGraphNodeExecutor
- * @summary While loop node executor.
- * @description Executes a body workflow repeatedly while a condition is true, enforcing a maximum iteration limit.
- */
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
-import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
-import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
-/**
- * Executor for `core.loop.while` nodes.
- *
- * Expects input:
- * - `state`: initial state
- *
- * Produces output:
- * - `state`: final state
- * - `iterations`: number of iterations executed
- */
-export declare class WhileGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine;
-    private readonly evaluator;
-    constructor(engine: GraphExecutionEngine);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    private extractMetadata;
-}

package/lib/types/graph/engine/loops/WhileGraphNodeExecutor.d.mts

@@ -1,26 +0,0 @@
-/**
- * @module integrations/graph/loops/WhileGraphNodeExecutor
- * @summary While loop node executor.
- * @description Executes a body workflow repeatedly while a condition is true, enforcing a maximum iteration limit.
- */
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
-import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
-import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
-/**
- * Executor for `core.loop.while` nodes.
- *
- * Expects input:
- * - `state`: initial state
- *
- * Produces output:
- * - `state`: final state
- * - `iterations`: number of iterations executed
- */
-export declare class WhileGraphNodeExecutor implements GraphNodeExecutor {
-    private readonly engine;
-    private readonly evaluator;
-    constructor(engine: GraphExecutionEngine);
-    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    private extractMetadata;
-}