@decaf-ts/integrations 0.10.5 → 0.11.0

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

@@ -1,63 +0,0 @@
-import type { CodeSandboxEvaluator, CodeSandboxContext } from "./CodeSandboxEvaluator.d.cts";
-/**
- * `isolated-vm`-backed {@link CodeSandboxEvaluator} (ALFRED-5 §7.18).
- *
- * This evaluator provides a truly isolated V8 sandbox — the code runs in a
- * separate isolate with its own heap, separate from the host process. The
- * sandbox context exposes only the data variables (`$input`, `$vars`, `$item`,
- * `$index`, `$node`, `$output`); no host globals are available.
- *
- * Execution pipeline:
- * 1. **Transpile** — TypeScript code is transpiled to JavaScript via
- *    `typescript.transpileModule` (ALFRED-5 §7.4).
- * 2. **Validate** — the JavaScript code is parsed with `acorn` and walked with
- *    `acorn-walk` to reject imports, exports, blocked identifiers, `eval()`,
- *    and `new Function()` (ALFRED-5 §7.11).
- * 3. **Isolate** — a new `isolated-vm` `Isolate` is created with a memory
- *    limit. A context is created and the data variables are copied into the
- *    isolate's heap via `ExternalCopy`.
- * 4. **Compile & run** — the wrapped code is compiled and executed with a
- *    timeout. The result is copied back to the host heap.
- * 5. **Dispose** — the isolate is always disposed in a `finally` block.
- *
- * The user code is wrapped in a strict-mode async function:
- *
- * ```js
- * "use strict";
- * async function __userFunction($input, $vars, $item, $index, $node, $output) {
- *   <user code>
- * }
- * __userFunction($input, $vars, $item, $index, $node, $output);
- * ```
- *
- * When the code has no `return` statement it is treated as a single expression
- * and wrapped in `return (...)`.
- */
-export declare class IsolatedVmCodeSandboxEvaluator implements CodeSandboxEvaluator {
-    private readonly defaultTimeoutMs;
-    private readonly defaultMemoryMb;
-    /**
-     * @param defaultTimeoutMs - Default execution timeout in milliseconds.
-     * @param defaultMemoryMb - Default isolate memory limit in MB.
-     */
-    constructor(defaultTimeoutMs?: number, defaultMemoryMb?: number);
-    evaluate(ctx: CodeSandboxContext): Promise<unknown>;
-    /**
-     * Injects a `console` object into the isolate whose methods forward to the
-     * Context logger (bound to `runId`).
-     *
-     * Every standard `console.*` method is supported:
-     * `log`, `info`, `warn`, `error`, `debug`, `trace`, `dir`, `dirxml`,
-     * `table`, `group`, `groupCollapsed`, `groupEnd`, `time`, `timeEnd`,
-     * `timeLog`, `assert`, `count`, `countReset`, `clear`.
-     *
-     * Arguments are serialised inside the isolate (via `JSON.stringify` with a
-     * safe fallback) before being passed across the isolate boundary, because
-     * `isolated-vm` cannot copy arbitrary host objects.
-     *
-     * @param jail - The isolate's global object.
-     * @param logger - The Context logger that receives the forwarded calls.
-     * @param context - The isolate context (for running the init script).
-     */
-    private injectConsole;
-}

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

@@ -1,63 +0,0 @@
-import type { CodeSandboxEvaluator, CodeSandboxContext } from "./CodeSandboxEvaluator.d.mts";
-/**
- * `isolated-vm`-backed {@link CodeSandboxEvaluator} (ALFRED-5 §7.18).
- *
- * This evaluator provides a truly isolated V8 sandbox — the code runs in a
- * separate isolate with its own heap, separate from the host process. The
- * sandbox context exposes only the data variables (`$input`, `$vars`, `$item`,
- * `$index`, `$node`, `$output`); no host globals are available.
- *
- * Execution pipeline:
- * 1. **Transpile** — TypeScript code is transpiled to JavaScript via
- *    `typescript.transpileModule` (ALFRED-5 §7.4).
- * 2. **Validate** — the JavaScript code is parsed with `acorn` and walked with
- *    `acorn-walk` to reject imports, exports, blocked identifiers, `eval()`,
- *    and `new Function()` (ALFRED-5 §7.11).
- * 3. **Isolate** — a new `isolated-vm` `Isolate` is created with a memory
- *    limit. A context is created and the data variables are copied into the
- *    isolate's heap via `ExternalCopy`.
- * 4. **Compile & run** — the wrapped code is compiled and executed with a
- *    timeout. The result is copied back to the host heap.
- * 5. **Dispose** — the isolate is always disposed in a `finally` block.
- *
- * The user code is wrapped in a strict-mode async function:
- *
- * ```js
- * "use strict";
- * async function __userFunction($input, $vars, $item, $index, $node, $output) {
- *   <user code>
- * }
- * __userFunction($input, $vars, $item, $index, $node, $output);
- * ```
- *
- * When the code has no `return` statement it is treated as a single expression
- * and wrapped in `return (...)`.
- */
-export declare class IsolatedVmCodeSandboxEvaluator implements CodeSandboxEvaluator {
-    private readonly defaultTimeoutMs;
-    private readonly defaultMemoryMb;
-    /**
-     * @param defaultTimeoutMs - Default execution timeout in milliseconds.
-     * @param defaultMemoryMb - Default isolate memory limit in MB.
-     */
-    constructor(defaultTimeoutMs?: number, defaultMemoryMb?: number);
-    evaluate(ctx: CodeSandboxContext): Promise<unknown>;
-    /**
-     * Injects a `console` object into the isolate whose methods forward to the
-     * Context logger (bound to `runId`).
-     *
-     * Every standard `console.*` method is supported:
-     * `log`, `info`, `warn`, `error`, `debug`, `trace`, `dir`, `dirxml`,
-     * `table`, `group`, `groupCollapsed`, `groupEnd`, `time`, `timeEnd`,
-     * `timeLog`, `assert`, `count`, `countReset`, `clear`.
-     *
-     * Arguments are serialised inside the isolate (via `JSON.stringify` with a
-     * safe fallback) before being passed across the isolate boundary, because
-     * `isolated-vm` cannot copy arbitrary host objects.
-     *
-     * @param jail - The isolate's global object.
-     * @param logger - The Context logger that receives the forwarded calls.
-     * @param context - The isolate context (for running the init script).
-     */
-    private injectConsole;
-}

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/execution/index.d.cts

@@ -1,16 +0,0 @@
-/**
- * @module integrations/graph/execution
- * @summary Graph execution context and executor interface.
- * @description Re-exports the graph execution context and node executor interface.
- */
-export * from "./GraphExecutionContext.d.cts";
-export * from "./GraphNodeExecutor.d.cts";
-export * from "./GraphExecutionResult.d.cts";
-export * from "./GraphExecutionFrame.d.cts";
-export * from "./GraphExecutionEngine.d.cts";
-export * from "./CodeSandboxEvaluator.d.cts";
-export * from "./SwitchGraphNodeExecutor.d.cts";
-export * from "./CodeGraphNodeExecutor.d.cts";
-export * from "./LogGraphNodeExecutor.d.cts";
-export * from "./BreakGraphNodeExecutor.d.cts";
-export * from "./IsolatedVmCodeSandboxEvaluator.d.cts";

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

@@ -1,16 +0,0 @@
-/**
- * @module integrations/graph/execution
- * @summary Graph execution context and executor interface.
- * @description Re-exports the graph execution context and node executor interface.
- */
-export * from "./GraphExecutionContext.d.mts";
-export * from "./GraphNodeExecutor.d.mts";
-export * from "./GraphExecutionResult.d.mts";
-export * from "./GraphExecutionFrame.d.mts";
-export * from "./GraphExecutionEngine.d.mts";
-export * from "./CodeSandboxEvaluator.d.mts";
-export * from "./SwitchGraphNodeExecutor.d.mts";
-export * from "./CodeGraphNodeExecutor.d.mts";
-export * from "./LogGraphNodeExecutor.d.mts";
-export * from "./BreakGraphNodeExecutor.d.mts";
-export * from "./IsolatedVmCodeSandboxEvaluator.d.mts";

package/lib/types/graph/engine/index.d.cts

@@ -1,63 +0,0 @@
-/**
- * @module integrations/graph/engine
- * @summary Graph execution engine (backend-only).
- * @description Reference interpreter for Decaf graph workflows. Executes
- * workflows declared with `@decaf-ts/ui-decorators/graph`, emits events
- * through Decaf's Observable pipeline, supports structured loops, configurable
- * value stores, and pinnable/cacheable nodes. Frontend-safe shared
- * declarations live in `@decaf-ts/ui-decorators/graph`.
- */
-export * from "./constants.d.cts";
-export * from "./types.d.cts";
-export * from "./decorators.d.cts";
-export * from "./errors/GraphExecutionError.d.cts";
-export * from "./errors/GraphCycleError.d.cts";
-export * from "./errors/GraphInputError.d.cts";
-export * from "./errors/GraphLoopLimitError.d.cts";
-export * from "./errors/GraphPinningError.d.cts";
-export * from "./errors/GraphPortError.d.cts";
-export * from "./errors/GraphStoreError.d.cts";
-export * from "./errors/GraphTopologyError.d.cts";
-export * from "./errors/GraphBreakSignal.d.cts";
-export * from "./errors/GraphRunCancelledError.d.cts";
-export * from "./events/GraphExecutionObserver.d.cts";
-export * from "./events/GraphExecutionEventEmitter.d.cts";
-export * from "./events/GraphExecutionEventFactory.d.cts";
-export * from "./execution/GraphExecutionContext.d.cts";
-export * from "./execution/GraphNodeExecutor.d.cts";
-export * from "./execution/GraphExecutionFrame.d.cts";
-export * from "./execution/GraphExecutionResult.d.cts";
-export * from "./execution/GraphExecutionEngine.d.cts";
-export * from "./execution/CodeSandboxEvaluator.d.cts";
-export * from "./execution/SwitchGraphNodeExecutor.d.cts";
-export * from "./execution/CodeGraphNodeExecutor.d.cts";
-export * from "./execution/LogGraphNodeExecutor.d.cts";
-export * from "./execution/BreakGraphNodeExecutor.d.cts";
-export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.cts";
-export * from "./registry/GraphNodeExecutorRegistry.d.cts";
-export * from "./registry/GraphNodeExecutorResolver.d.cts";
-export * from "./catalog/index.d.cts";
-export * from "./store/GraphValueKey.d.cts";
-export * from "./store/GraphCachedValue.d.cts";
-export * from "./store/GraphValueStoreAdapter.d.cts";
-export * from "./store/InMemoryGraphValueStoreAdapter.d.cts";
-export * from "./store/GraphValueStore.d.cts";
-export * from "./planning/GraphExecutionPlanNode.d.cts";
-export * from "./planning/GraphExecutionPlanEdge.d.cts";
-export * from "./planning/GraphExecutionPlanLayer.d.cts";
-export * from "./planning/GraphExecutionPlan.d.cts";
-export * from "./planning/GraphExecutionPlanner.d.cts";
-export * from "./planning/GraphTopology.d.cts";
-export * from "./validation/index.d.cts";
-export * from "./loops/GraphConditionEvaluator.d.cts";
-export * from "./loops/ConditionExpressionEvaluator.d.cts";
-export * from "./loops/GraphLoopExecutionContext.d.cts";
-export * from "./loops/ForeachGraphNodeExecutor.d.cts";
-export * from "./loops/WhileGraphNodeExecutor.d.cts";
-export * from "./loops/UntilGraphNodeExecutor.d.cts";
-export * from "./pinning/GraphPinningMetadata.d.cts";
-export * from "./pinning/GraphPinningPolicy.d.cts";
-export * from "./pinning/GraphPinningDependencyResolver.d.cts";
-export * from "./pinning/GraphPinningService.d.cts";
-export * from "./runs/index.d.cts";
-export * from "./snapshots/GraphExecutionSnapshotMapper.d.cts";

package/lib/types/graph/engine/index.d.mts

@@ -1,63 +0,0 @@
-/**
- * @module integrations/graph/engine
- * @summary Graph execution engine (backend-only).
- * @description Reference interpreter for Decaf graph workflows. Executes
- * workflows declared with `@decaf-ts/ui-decorators/graph`, emits events
- * through Decaf's Observable pipeline, supports structured loops, configurable
- * value stores, and pinnable/cacheable nodes. Frontend-safe shared
- * declarations live in `@decaf-ts/ui-decorators/graph`.
- */
-export * from "./constants.d.mts";
-export * from "./types.d.mts";
-export * from "./decorators.d.mts";
-export * from "./errors/GraphExecutionError.d.mts";
-export * from "./errors/GraphCycleError.d.mts";
-export * from "./errors/GraphInputError.d.mts";
-export * from "./errors/GraphLoopLimitError.d.mts";
-export * from "./errors/GraphPinningError.d.mts";
-export * from "./errors/GraphPortError.d.mts";
-export * from "./errors/GraphStoreError.d.mts";
-export * from "./errors/GraphTopologyError.d.mts";
-export * from "./errors/GraphBreakSignal.d.mts";
-export * from "./errors/GraphRunCancelledError.d.mts";
-export * from "./events/GraphExecutionObserver.d.mts";
-export * from "./events/GraphExecutionEventEmitter.d.mts";
-export * from "./events/GraphExecutionEventFactory.d.mts";
-export * from "./execution/GraphExecutionContext.d.mts";
-export * from "./execution/GraphNodeExecutor.d.mts";
-export * from "./execution/GraphExecutionFrame.d.mts";
-export * from "./execution/GraphExecutionResult.d.mts";
-export * from "./execution/GraphExecutionEngine.d.mts";
-export * from "./execution/CodeSandboxEvaluator.d.mts";
-export * from "./execution/SwitchGraphNodeExecutor.d.mts";
-export * from "./execution/CodeGraphNodeExecutor.d.mts";
-export * from "./execution/LogGraphNodeExecutor.d.mts";
-export * from "./execution/BreakGraphNodeExecutor.d.mts";
-export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.mts";
-export * from "./registry/GraphNodeExecutorRegistry.d.mts";
-export * from "./registry/GraphNodeExecutorResolver.d.mts";
-export * from "./catalog/index.d.mts";
-export * from "./store/GraphValueKey.d.mts";
-export * from "./store/GraphCachedValue.d.mts";
-export * from "./store/GraphValueStoreAdapter.d.mts";
-export * from "./store/InMemoryGraphValueStoreAdapter.d.mts";
-export * from "./store/GraphValueStore.d.mts";
-export * from "./planning/GraphExecutionPlanNode.d.mts";
-export * from "./planning/GraphExecutionPlanEdge.d.mts";
-export * from "./planning/GraphExecutionPlanLayer.d.mts";
-export * from "./planning/GraphExecutionPlan.d.mts";
-export * from "./planning/GraphExecutionPlanner.d.mts";
-export * from "./planning/GraphTopology.d.mts";
-export * from "./validation/index.d.mts";
-export * from "./loops/GraphConditionEvaluator.d.mts";
-export * from "./loops/ConditionExpressionEvaluator.d.mts";
-export * from "./loops/GraphLoopExecutionContext.d.mts";
-export * from "./loops/ForeachGraphNodeExecutor.d.mts";
-export * from "./loops/WhileGraphNodeExecutor.d.mts";
-export * from "./loops/UntilGraphNodeExecutor.d.mts";
-export * from "./pinning/GraphPinningMetadata.d.mts";
-export * from "./pinning/GraphPinningPolicy.d.mts";
-export * from "./pinning/GraphPinningDependencyResolver.d.mts";
-export * from "./pinning/GraphPinningService.d.mts";
-export * from "./runs/index.d.mts";
-export * from "./snapshots/GraphExecutionSnapshotMapper.d.mts";

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

@@ -1,36 +0,0 @@
-/**
- * @module integrations/graph/loops/ConditionExpressionEvaluator
- * @summary Evaluator for the ALFRED-5 `ConditionExpression` DSL (DECAF-32 §22.3).
- * @description Evaluates declarative, serializable condition expressions with
- * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
- * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
- */
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates a {@link ConditionExpression} against the given state.
- *
- * `ExprValue` resolution:
- * - `{ const: x }` → the literal value `x`.
- * - `{ path: "a.b" }` → dotted-path lookup into `state`.
- * - `{ step: "nodeId", path: "out" }` → cross-node reference; in v1 the state
- *   is expected to contain a `nodes` map keyed by node id (reserved for future
- *   multi-step evaluation; falls back to `state` lookup when absent).
- */
-export declare class ConditionExpressionEvaluator {
-    /**
-     * Evaluates a condition expression to a boolean.
-     *
-     * @param expr - The condition expression.
-     * @param state - The current evaluation state (loop state or execution values).
-     * @returns `true` when the expression evaluates to a truthy/positive result.
-     */
-    evaluate(expr: ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves an {@link ExprValue} against the current state.
-     */
-    private resolveValue;
-    /**
-     * Resolves a dotted path into a target object.
-     */
-    private resolvePath;
-}

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

@@ -1,36 +0,0 @@
-/**
- * @module integrations/graph/loops/ConditionExpressionEvaluator
- * @summary Evaluator for the ALFRED-5 `ConditionExpression` DSL (DECAF-32 §22.3).
- * @description Evaluates declarative, serializable condition expressions with
- * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
- * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
- */
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates a {@link ConditionExpression} against the given state.
- *
- * `ExprValue` resolution:
- * - `{ const: x }` → the literal value `x`.
- * - `{ path: "a.b" }` → dotted-path lookup into `state`.
- * - `{ step: "nodeId", path: "out" }` → cross-node reference; in v1 the state
- *   is expected to contain a `nodes` map keyed by node id (reserved for future
- *   multi-step evaluation; falls back to `state` lookup when absent).
- */
-export declare class ConditionExpressionEvaluator {
-    /**
-     * Evaluates a condition expression to a boolean.
-     *
-     * @param expr - The condition expression.
-     * @param state - The current evaluation state (loop state or execution values).
-     * @returns `true` when the expression evaluates to a truthy/positive result.
-     */
-    evaluate(expr: ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves an {@link ExprValue} against the current state.
-     */
-    private resolveValue;
-    /**
-     * Resolves a dotted path into a target object.
-     */
-    private resolvePath;
-}

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/GraphConditionEvaluator.d.cts

@@ -1,40 +0,0 @@
-/**
- * @module integrations/graph/loops/GraphConditionEvaluator
- * @summary Evaluator for built-in loop condition types and the `ConditionExpression` DSL.
- * @description Supports safe, built-in condition types only. Does NOT evaluate arbitrary JavaScript expressions.
- * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
- * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
- */
-import type { GraphConditionDefinition } from "../types.d.cts";
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates loop conditions using built-in comparison types or the
- * `ConditionExpression` DSL.
- */
-export declare class GraphConditionEvaluator {
-    private readonly expressionEvaluator;
-    /**
-     * Evaluates a condition against the given state.
-     *
-     * When the condition object carries an `op` field, it is treated as a
-     * `ConditionExpression` (§22.3) and dispatched to the
-     * {@link ConditionExpressionEvaluator}. Otherwise the built-in `type`-based
-     * switch is used.
-     *
-     * @param condition - The condition definition.
-     * @param state - The current loop state.
-     * @returns `true` when the condition passes.
-     */
-    evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves a value that may be a dotted path into the state object.
-     */
-    private resolveValue;
-    /**
-     * Detects whether a condition object is a `ConditionExpression` (§22.3) by
-     * checking for the presence of an `op` field. When true, the object is
-     * treated as a `ConditionExpression` and dispatched to the
-     * {@link ConditionExpressionEvaluator}.
-     */
-    private isConditionExpression;
-}