@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/types/graph/engine/events/GraphExecutionEventEmitter.d.cts

@@ -1,26 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionEventEmitter
- * @summary Observable implementation for graph execution events.
- * @description Implements Decaf's {@link Observable} interface so observers can subscribe to graph execution events. Observer failures are isolated and do not crash the workflow.
- */
-import type { Observable } from "@decaf-ts/core";
-import type { GraphExecutionObserver } from "./GraphExecutionObserver.d.cts";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Manages observer registration and event dispatch for the graph execution
- * engine.
- */
-export declare class GraphExecutionEventEmitter implements Observable<[GraphExecutionObserver], [GraphExecutionEvent]> {
-    private readonly observers;
-    /** Registers an observer and returns an unsubscribe function. */
-    observe(observer: GraphExecutionObserver): () => void;
-    /** Removes a previously-registered observer. */
-    unObserve(observer: GraphExecutionObserver): void;
-    /**
-     * Notifies all registered observers of a new event.
-     *
-     * Observer failures are caught and swallowed so that a misbehaving observer
-     * cannot crash the workflow execution.
-     */
-    updateObservers(event: GraphExecutionEvent): Promise<void>;
-}

package/lib/types/graph/engine/events/GraphExecutionEventEmitter.d.mts

@@ -1,26 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionEventEmitter
- * @summary Observable implementation for graph execution events.
- * @description Implements Decaf's {@link Observable} interface so observers can subscribe to graph execution events. Observer failures are isolated and do not crash the workflow.
- */
-import type { Observable } from "@decaf-ts/core";
-import type { GraphExecutionObserver } from "./GraphExecutionObserver.d.mts";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Manages observer registration and event dispatch for the graph execution
- * engine.
- */
-export declare class GraphExecutionEventEmitter implements Observable<[GraphExecutionObserver], [GraphExecutionEvent]> {
-    private readonly observers;
-    /** Registers an observer and returns an unsubscribe function. */
-    observe(observer: GraphExecutionObserver): () => void;
-    /** Removes a previously-registered observer. */
-    unObserve(observer: GraphExecutionObserver): void;
-    /**
-     * Notifies all registered observers of a new event.
-     *
-     * Observer failures are caught and swallowed so that a misbehaving observer
-     * cannot crash the workflow execution.
-     */
-    updateObservers(event: GraphExecutionEvent): Promise<void>;
-}

package/lib/types/graph/engine/events/GraphExecutionEventFactory.d.cts

@@ -1,25 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionEventFactory
- * @summary Factory for creating graph execution events with unique ids, sequence numbers, and timestamps.
- * @description Provides a stateful factory that produces monotonically-sequenced events for a single execution run.
- */
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Factory that enriches partial events with a unique id, an incrementing
- * sequence number, and a timestamp.
- */
-export declare class GraphExecutionEventFactory {
-    private sequence;
-    /**
-     * Creates a fully-populated event from the given base fields.
-     *
-     * @param base - All event fields except `id`, `sequence`, and `timestamp`.
-     * @returns A complete {@link GraphExecutionEvent}.
-     */
-    create(base: Omit<GraphExecutionEvent, "id" | "sequence" | "timestamp">): GraphExecutionEvent;
-    /**
-     * Generates a unique event id using `crypto.randomUUID` when available,
-     * falling back to a timestamp + random string.
-     */
-    private createEventId;
-}

package/lib/types/graph/engine/events/GraphExecutionEventFactory.d.mts

@@ -1,25 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionEventFactory
- * @summary Factory for creating graph execution events with unique ids, sequence numbers, and timestamps.
- * @description Provides a stateful factory that produces monotonically-sequenced events for a single execution run.
- */
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Factory that enriches partial events with a unique id, an incrementing
- * sequence number, and a timestamp.
- */
-export declare class GraphExecutionEventFactory {
-    private sequence;
-    /**
-     * Creates a fully-populated event from the given base fields.
-     *
-     * @param base - All event fields except `id`, `sequence`, and `timestamp`.
-     * @returns A complete {@link GraphExecutionEvent}.
-     */
-    create(base: Omit<GraphExecutionEvent, "id" | "sequence" | "timestamp">): GraphExecutionEvent;
-    /**
-     * Generates a unique event id using `crypto.randomUUID` when available,
-     * falling back to a timestamp + random string.
-     */
-    private createEventId;
-}

package/lib/types/graph/engine/events/GraphExecutionObserver.d.cts

@@ -1,17 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionObserver
- * @summary Observer interface for graph execution events.
- * @description Extends Decaf's {@link Observer} so graph events flow through the standard Observable/Observer pipeline.
- */
-import type { Observer } from "@decaf-ts/core";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Observer that receives {@link GraphExecutionEvent} instances from the
- * graph execution engine.
- */
-export interface GraphExecutionObserver extends Observer<[GraphExecutionEvent]> {
-    /**
-     * Called by the engine when a new graph execution event is emitted.
-     */
-    refresh(event: GraphExecutionEvent): Promise<void>;
-}

package/lib/types/graph/engine/events/GraphExecutionObserver.d.mts

@@ -1,17 +0,0 @@
-/**
- * @module integrations/graph/events/GraphExecutionObserver
- * @summary Observer interface for graph execution events.
- * @description Extends Decaf's {@link Observer} so graph events flow through the standard Observable/Observer pipeline.
- */
-import type { Observer } from "@decaf-ts/core";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Observer that receives {@link GraphExecutionEvent} instances from the
- * graph execution engine.
- */
-export interface GraphExecutionObserver extends Observer<[GraphExecutionEvent]> {
-    /**
-     * Called by the engine when a new graph execution event is emitted.
-     */
-    refresh(event: GraphExecutionEvent): Promise<void>;
-}

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

@@ -1,8 +0,0 @@
-/**
- * @module integrations/graph/events
- * @summary Graph execution event pipeline.
- * @description Re-exports the observer interface, event emitter, and event factory.
- */
-export * from "./GraphExecutionObserver.d.cts";
-export * from "./GraphExecutionEventEmitter.d.cts";
-export * from "./GraphExecutionEventFactory.d.cts";

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

@@ -1,8 +0,0 @@
-/**
- * @module integrations/graph/events
- * @summary Graph execution event pipeline.
- * @description Re-exports the observer interface, event emitter, and event factory.
- */
-export * from "./GraphExecutionObserver.d.mts";
-export * from "./GraphExecutionEventEmitter.d.mts";
-export * from "./GraphExecutionEventFactory.d.mts";

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

@@ -1,22 +0,0 @@
-/**
- * @module integrations/graph/execution/BreakGraphNodeExecutor
- * @summary Executor for the Break flow-control node.
- * @description Throws a {@link GraphBreakSignal} that the enclosing loop
- * executor catches to terminate the loop early. The optional `value` input is
- * carried on the signal so the loop can append it as the last partial result.
- */
-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.flow.break` nodes.
- *
- * Reads the optional `value` input port and throws a {@link GraphBreakSignal}
- * carrying it. The enclosing loop executor (`core.loop.foreach`,
- * `core.loop.while`, `core.loop.until`) catches the signal, stops iterating,
- * and returns the results collected so far (plus the carried value as the
- * final partial result).
- */
-export declare class BreakGraphNodeExecutor implements GraphNodeExecutor {
-    execute(request: GraphNodeExecutionRequest, _context: GraphExecutionContext): Promise<GraphExecutionValues>;
-}

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

@@ -1,22 +0,0 @@
-/**
- * @module integrations/graph/execution/BreakGraphNodeExecutor
- * @summary Executor for the Break flow-control node.
- * @description Throws a {@link GraphBreakSignal} that the enclosing loop
- * executor catches to terminate the loop early. The optional `value` input is
- * carried on the signal so the loop can append it as the last partial result.
- */
-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.flow.break` nodes.
- *
- * Reads the optional `value` input port and throws a {@link GraphBreakSignal}
- * carrying it. The enclosing loop executor (`core.loop.foreach`,
- * `core.loop.while`, `core.loop.until`) catches the signal, stops iterating,
- * and returns the results collected so far (plus the carried value as the
- * final partial result).
- */
-export declare class BreakGraphNodeExecutor implements GraphNodeExecutor {
-    execute(request: GraphNodeExecutionRequest, _context: GraphExecutionContext): Promise<GraphExecutionValues>;
-}

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

@@ -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.cts";
-import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
-import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
-/**
- * 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/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/CodeSandboxEvaluator.d.cts

@@ -1,76 +0,0 @@
-/**
- * @module integrations/graph/execution/CodeSandboxEvaluator
- * @summary Pluggable contract for evaluating code-based conditions (DECAF-32 §22.4).
- * @description The engine does NOT implement the VM sandbox directly (§22.4).
- * Downstream projects (e.g. ALFRED) register a `CodeSandboxEvaluator` via the
- * `GraphExecutionEngineConfig.codeSandboxEvaluator` field. When absent, code
- * conditions throw a `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` error.
- *
- * The sandbox must follow the same restrictions as the Code Node (§22.4):
- * - No system API access (`require`, `process`, `fs`, `child_process`, etc.)
- * - Placeholder syntax for workflow data references (`{{ $input.foo }}`,
- *   `{{ $node["Name"].output }}`, `{{ $vars.bar }}`, etc.)
- * - Static code validation (e.g. `acorn`-based) before execution
- * - The code must return a boolean value (for conditions) or any value
- *   (for Code Node transforms)
- */
-/**
- * Context passed to the code sandbox evaluator.
- */
-export interface CodeSandboxContext {
-    /** The raw code string authored by the user. */
-    code: string;
-    /** The programming language (defaults to `"javascript"`). */
-    language?: "javascript" | "typescript";
-    /** The current input values, accessible as `$input` in placeholders. */
-    input: Record<string, unknown>;
-    /** Workflow variables, accessible as `$vars` in placeholders. */
-    vars?: Record<string, unknown>;
-    /** Current loop item (if inside a foreach), accessible as `$item`. */
-    item?: unknown;
-    /** Current loop index (if inside a foreach), accessible as `$index`. */
-    index?: number;
-    /** Outputs of upstream nodes, accessible as `$node["Name"].output`. */
-    nodes?: Record<string, Record<string, unknown>>;
-    /**
-     * Optional logger that receives `console.log/warn/debug/error` calls from
-     * inside the sandbox. When provided, a `console` object is injected into
-     * the isolate whose methods forward to this logger.
-     */
-    logger?: SandboxLogger;
-}
-/**
- * Minimal logger interface the sandbox can call without importing the full
- * Decaf logging package (keeps the interface frontend-safe). Mirrors the
- * methods on `@decaf-ts/logging`'s `Logger`.
- */
-export interface SandboxLogger {
-    benchmark(msg: string, meta?: unknown): void;
-    fatal(msg: string, meta?: unknown): void;
-    critical(msg: string, meta?: unknown): void;
-    silly(msg: string, meta?: unknown): void;
-    verbose(msg: string, meta?: unknown): void;
-    info(msg: string, meta?: unknown): void;
-    debug(msg: string, meta?: unknown): void;
-    error(msg: string, meta?: unknown): void;
-    warn(msg: string, meta?: unknown): void;
-    trace(msg: string, meta?: unknown): void;
-}
-/**
- * Pluggable evaluator for code-based conditions and Code Node transforms.
- *
- * Implementations MUST enforce the Code Node restrictions (§22.4):
- * no system API access, static validation, placeholder resolution.
- */
-export interface CodeSandboxEvaluator {
-    /**
-     * Evaluates the given code in a restricted sandbox and returns the result.
-     *
-     * For conditions, the code is expected to return a boolean.
-     * For Code Node transforms, the code may return any value.
-     *
-     * @param ctx - The sandbox context containing code, input, and references.
-     * @returns The result of evaluating the code.
-     */
-    evaluate(ctx: CodeSandboxContext): Promise<unknown> | unknown;
-}

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

@@ -1,76 +0,0 @@
-/**
- * @module integrations/graph/execution/CodeSandboxEvaluator
- * @summary Pluggable contract for evaluating code-based conditions (DECAF-32 §22.4).
- * @description The engine does NOT implement the VM sandbox directly (§22.4).
- * Downstream projects (e.g. ALFRED) register a `CodeSandboxEvaluator` via the
- * `GraphExecutionEngineConfig.codeSandboxEvaluator` field. When absent, code
- * conditions throw a `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` error.
- *
- * The sandbox must follow the same restrictions as the Code Node (§22.4):
- * - No system API access (`require`, `process`, `fs`, `child_process`, etc.)
- * - Placeholder syntax for workflow data references (`{{ $input.foo }}`,
- *   `{{ $node["Name"].output }}`, `{{ $vars.bar }}`, etc.)
- * - Static code validation (e.g. `acorn`-based) before execution
- * - The code must return a boolean value (for conditions) or any value
- *   (for Code Node transforms)
- */
-/**
- * Context passed to the code sandbox evaluator.
- */
-export interface CodeSandboxContext {
-    /** The raw code string authored by the user. */
-    code: string;
-    /** The programming language (defaults to `"javascript"`). */
-    language?: "javascript" | "typescript";
-    /** The current input values, accessible as `$input` in placeholders. */
-    input: Record<string, unknown>;
-    /** Workflow variables, accessible as `$vars` in placeholders. */
-    vars?: Record<string, unknown>;
-    /** Current loop item (if inside a foreach), accessible as `$item`. */
-    item?: unknown;
-    /** Current loop index (if inside a foreach), accessible as `$index`. */
-    index?: number;
-    /** Outputs of upstream nodes, accessible as `$node["Name"].output`. */
-    nodes?: Record<string, Record<string, unknown>>;
-    /**
-     * Optional logger that receives `console.log/warn/debug/error` calls from
-     * inside the sandbox. When provided, a `console` object is injected into
-     * the isolate whose methods forward to this logger.
-     */
-    logger?: SandboxLogger;
-}
-/**
- * Minimal logger interface the sandbox can call without importing the full
- * Decaf logging package (keeps the interface frontend-safe). Mirrors the
- * methods on `@decaf-ts/logging`'s `Logger`.
- */
-export interface SandboxLogger {
-    benchmark(msg: string, meta?: unknown): void;
-    fatal(msg: string, meta?: unknown): void;
-    critical(msg: string, meta?: unknown): void;
-    silly(msg: string, meta?: unknown): void;
-    verbose(msg: string, meta?: unknown): void;
-    info(msg: string, meta?: unknown): void;
-    debug(msg: string, meta?: unknown): void;
-    error(msg: string, meta?: unknown): void;
-    warn(msg: string, meta?: unknown): void;
-    trace(msg: string, meta?: unknown): void;
-}
-/**
- * Pluggable evaluator for code-based conditions and Code Node transforms.
- *
- * Implementations MUST enforce the Code Node restrictions (§22.4):
- * no system API access, static validation, placeholder resolution.
- */
-export interface CodeSandboxEvaluator {
-    /**
-     * Evaluates the given code in a restricted sandbox and returns the result.
-     *
-     * For conditions, the code is expected to return a boolean.
-     * For Code Node transforms, the code may return any value.
-     *
-     * @param ctx - The sandbox context containing code, input, and references.
-     * @returns The result of evaluating the code.
-     */
-    evaluate(ctx: CodeSandboxContext): Promise<unknown> | unknown;
-}

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

@@ -1,74 +0,0 @@
-/**
- * @module integrations/graph/execution/GraphExecutionContext
- * @summary Decaf Context for graph node execution (DECAF-50 §4.9).
- * @description Extends Decaf's {@link Context} so node executors receive the
- * same contextual plumbing as task handlers. The context carries the
- * canonical workflow document, the executing node's canonical instance, and
- * its effective resolved manifest — never a raw node definition. Executors
- * use the context to emit progress, log messages, and report state through
- * the engine's observer pipeline. Each context also exposes a run-scoped
- * `ctx.logger` (DECAF-48 §4.3) bound to the executing node's `runId` /
- * `workflowId` / `nodeId` / `user`, so every log line streams over
- * `graph.run.log` with the DECAF-9 custom attributes.
- */
-import { Context } from "@decaf-ts/core";
-import type { GraphNodeInstance, GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { Logger } from "@decaf-ts/logging";
-import type { GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-import type { GraphRunId } from "../types.d.cts";
-/**
- * Context passed to every graph node executor.
- *
- * The engine creates a `GraphExecutionContext` per node execution and passes
- * it to the executor alongside the node's inputs/parameters. The executor
- * uses `context.progress(...)` and `context.log(...)` to report intermediate
- * state, and `context.logger` to emit structured run log lines (DECAF-48
- * §4.3).
- */
-export declare class GraphExecutionContext extends Context {
-    readonly runId: GraphRunId;
-    readonly parentRunId: GraphRunId | undefined;
-    readonly workflowId: string;
-    readonly document: GraphWorkflowDocument;
-    readonly node: GraphNodeInstance;
-    readonly manifest: GraphResolvedNodeManifest;
-    readonly path: string[];
-    private readonly emitFn;
-    readonly metadata: Record<string, unknown>;
-    private readonly runLogger?;
-    /**
-     * @param runId - Unique identifier for the current execution run.
-     * @param parentRunId - Run id of the parent execution (for nested loop bodies).
-     * @param workflowId - The canonical workflow document id.
-     * @param document - The canonical workflow document being executed.
-     * @param node - The canonical node instance being executed.
-     * @param manifest - The effective (dynamics-expanded) manifest for the node.
-     * @param path - Dotted path from the workflow root to this node.
-     * @param emitFn - Callback invoked when an event is emitted from this context.
-     * @param metadata - Free-form metadata attached to this context.
-     */
-    constructor(runId: GraphRunId, parentRunId: GraphRunId | undefined, workflowId: string, document: GraphWorkflowDocument, node: GraphNodeInstance, manifest: GraphResolvedNodeManifest, path: string[], emitFn: (event: Partial<GraphExecutionEvent>) => Promise<void>, metadata?: Record<string, unknown>);
-    /**
-     * The decaf-ts {@link Logger} bound to this node's run context. Every log
-     * line carries the DECAF-48 attributes (`nodeId` / `workflowId` / `runId` /
-     * `user`) and is forwarded onto the existing graph execution Observable as
-     * a `GRAPH_RUN_LOG` event (streamed over the `graph.run.log` SSE channel).
-     */
-    get logger(): Logger;
-    /**
-     * Emits a partial graph execution event. The engine fills in runId,
-     * parentRunId, workflowId, nodeId, and path automatically.
-     */
-    emit(event: Partial<GraphExecutionEvent>): Promise<void>;
-    /**
-     * Emits a `NODE_OUTPUT` event with the given payload, useful for reporting
-     * intermediate progress from within a node executor.
-     */
-    progress(payload: unknown): Promise<void>;
-    /**
-     * Emits a `NODE_OUTPUT` event with a structured `{ message, payload }` shape
-     * so executors can log human-readable messages.
-     */
-    log(message: string, payload?: unknown): Promise<void>;
-}

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

@@ -1,74 +0,0 @@
-/**
- * @module integrations/graph/execution/GraphExecutionContext
- * @summary Decaf Context for graph node execution (DECAF-50 §4.9).
- * @description Extends Decaf's {@link Context} so node executors receive the
- * same contextual plumbing as task handlers. The context carries the
- * canonical workflow document, the executing node's canonical instance, and
- * its effective resolved manifest — never a raw node definition. Executors
- * use the context to emit progress, log messages, and report state through
- * the engine's observer pipeline. Each context also exposes a run-scoped
- * `ctx.logger` (DECAF-48 §4.3) bound to the executing node's `runId` /
- * `workflowId` / `nodeId` / `user`, so every log line streams over
- * `graph.run.log` with the DECAF-9 custom attributes.
- */
-import { Context } from "@decaf-ts/core";
-import type { GraphNodeInstance, GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { Logger } from "@decaf-ts/logging";
-import type { GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-import type { GraphRunId } from "../types.d.mts";
-/**
- * Context passed to every graph node executor.
- *
- * The engine creates a `GraphExecutionContext` per node execution and passes
- * it to the executor alongside the node's inputs/parameters. The executor
- * uses `context.progress(...)` and `context.log(...)` to report intermediate
- * state, and `context.logger` to emit structured run log lines (DECAF-48
- * §4.3).
- */
-export declare class GraphExecutionContext extends Context {
-    readonly runId: GraphRunId;
-    readonly parentRunId: GraphRunId | undefined;
-    readonly workflowId: string;
-    readonly document: GraphWorkflowDocument;
-    readonly node: GraphNodeInstance;
-    readonly manifest: GraphResolvedNodeManifest;
-    readonly path: string[];
-    private readonly emitFn;
-    readonly metadata: Record<string, unknown>;
-    private readonly runLogger?;
-    /**
-     * @param runId - Unique identifier for the current execution run.
-     * @param parentRunId - Run id of the parent execution (for nested loop bodies).
-     * @param workflowId - The canonical workflow document id.
-     * @param document - The canonical workflow document being executed.
-     * @param node - The canonical node instance being executed.
-     * @param manifest - The effective (dynamics-expanded) manifest for the node.
-     * @param path - Dotted path from the workflow root to this node.
-     * @param emitFn - Callback invoked when an event is emitted from this context.
-     * @param metadata - Free-form metadata attached to this context.
-     */
-    constructor(runId: GraphRunId, parentRunId: GraphRunId | undefined, workflowId: string, document: GraphWorkflowDocument, node: GraphNodeInstance, manifest: GraphResolvedNodeManifest, path: string[], emitFn: (event: Partial<GraphExecutionEvent>) => Promise<void>, metadata?: Record<string, unknown>);
-    /**
-     * The decaf-ts {@link Logger} bound to this node's run context. Every log
-     * line carries the DECAF-48 attributes (`nodeId` / `workflowId` / `runId` /
-     * `user`) and is forwarded onto the existing graph execution Observable as
-     * a `GRAPH_RUN_LOG` event (streamed over the `graph.run.log` SSE channel).
-     */
-    get logger(): Logger;
-    /**
-     * Emits a partial graph execution event. The engine fills in runId,
-     * parentRunId, workflowId, nodeId, and path automatically.
-     */
-    emit(event: Partial<GraphExecutionEvent>): Promise<void>;
-    /**
-     * Emits a `NODE_OUTPUT` event with the given payload, useful for reporting
-     * intermediate progress from within a node executor.
-     */
-    progress(payload: unknown): Promise<void>;
-    /**
-     * Emits a `NODE_OUTPUT` event with a structured `{ message, payload }` shape
-     * so executors can log human-readable messages.
-     */
-    log(message: string, payload?: unknown): Promise<void>;
-}