@decaf-ts/integrations 0.10.8 → 0.12.0

package/lib/types/graph/nodes/manifests.d.mts

@@ -1,62 +0,0 @@
-/**
- * @module integrations/graph/nodes/manifests
- * @summary Built-in node manifests (DECAF-50 §4.12).
- * @description The catalogue-published JSON manifests for every node kind
- * the backend ships. Loop manifests are hand-authored (their loop-body
- * shapes are structural); the rest are compiled from the shared
- * `@node`-decorated classes via `graphNodeManifest`, so the served shape is
- * identical to what the Angular palette consumes. Aggregated in
- * `GRAPH_BUILT_IN_NODE_MANIFESTS` and indexed by kind in
- * `GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND`.
- */
-import type { GraphNodeManifest } from "@decaf-ts/ui-decorators/graph";
-/** Manifest for the `core.loop.foreach` node: runs the loop body once per item (or slice) of the input array. */
-export declare const FOREACH_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the `core.loop.while` node: repeats the loop body while the condition holds. */
-export declare const WHILE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the `core.loop.until` node: repeats the loop body until the condition holds. */
-export declare const UNTIL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the `core.flow.switch` node: routes execution by switch-case conditions (cases live under `parameters["switch"]`). */
-export declare const SWITCH_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the manual-trigger node (starts a run on demand). */
-export declare const MANUAL_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the webhook-trigger node (starts a run from an inbound webhook). */
-export declare const WEBHOOK_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the schedule-trigger node (starts a run on a schedule). */
-export declare const SCHEDULE_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the event-trigger node (starts a run on an observed event). */
-export declare const EVENT_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the form-trigger node (starts a run from a form submission). */
-export declare const FORM_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the chat-trigger node (starts a run from a chat message). */
-export declare const CHAT_TRIGGER_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the if node (conditional branch on a boolean condition). */
-export declare const IF_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the parallel node (runs branches concurrently). */
-export declare const PARALLEL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the merge node (joins parallel branches). */
-export declare const MERGE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the map node (transforms each input item). */
-export declare const MAP_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the delay node (pauses execution for a duration). */
-export declare const DELAY_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the error-boundary node (isolates branch failures). */
-export declare const ERROR_BOUNDARY_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the human-approval node (waits for an approval decision). */
-export declare const HUMAN_APPROVAL_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the return node (terminates the workflow with output values). */
-export declare const RETURN_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the code node (executes user code). */
-export declare const CODE_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the log node (logs its input). */
-export declare const LOG_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the utility-log node (log-shaped utility sink). */
-export declare const UTILITY_LOG_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the break node (exits the enclosing loop). */
-export declare const BREAK_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** Manifest for the agent node (delegates work to an agent). */
-export declare const AGENT_GRAPH_NODE_MANIFEST: GraphNodeManifest;
-/** All built-in node manifests, in catalogue display order. */
-export declare const GRAPH_BUILT_IN_NODE_MANIFESTS: GraphNodeManifest[];
-/** Built-in manifests indexed by node `kind` — the source for built-in catalogue registrations. */
-export declare const GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND: Record<string, GraphNodeManifest>;

package/lib/types/graph/nodes/triggers/chat.d.cts

@@ -1,8 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class ChatTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    message: string;
-    sessionId: string;
-    userId: string;
-}

package/lib/types/graph/nodes/triggers/chat.d.mts

@@ -1,8 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class ChatTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    message: string;
-    sessionId: string;
-    userId: string;
-}

package/lib/types/graph/nodes/triggers/event.d.cts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class EventTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/event.d.mts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class EventTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/form.d.cts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class FormTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/form.d.mts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class FormTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/manual.d.cts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class ManualTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/manual.d.mts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class ManualTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/schedule.d.cts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class ScheduleTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/schedule.d.mts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class ScheduleTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/webhook.d.cts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class WebhookTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/triggers/webhook.d.mts

@@ -1,6 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class WebhookTriggerNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    payload: unknown;
-}

package/lib/types/graph/nodes/utility/code.d.cts

@@ -1,36 +0,0 @@
-/**
- * @module integrations/graph/nodes/utility/code
- * @summary Code utility node declaration (ALFRED-5 §7, DECAF-32 §22.4).
- * @description Code — sandboxed JS/TS code execution. The class's own
- * `static execute` is the only implementation of the kind, derived by
- * `GraphBuiltInRegistrations`, and reaches the pluggable `CodeSandboxEvaluator`
- * through `GraphExecutionContext.engine`.
- * The default `IsolatedVmCodeSandboxEvaluator` (backed by `isolated-vm`)
- * enforces the Code Node restrictions: no imports, no requires, pure
- * functions only. The sandbox context exposes `$input`, `$vars`, `$item`,
- * `$index`, `$node`, and `$output` as data variables. TypeScript is
- * supported via transpilation.
- *
- * The `@input` on `CodeNode.input` is a schema group — the nested
- * model's `@input` ports are spliced into the parent unprefixed. `code` has
- * `@input` + `@uielement("code-editor")`, so it appears as a port AND in the
- * CRUD modal (the only visible field). `data` has `@input` + `@hidden()` but
- * no `@uielement`, so it is a canvas-only port (for edge connections from
- * workflow input badges) but never appears in the CRUD modal. `language` has
- * no `@input` and no `@uielement`, so it is neither a port nor rendered — it
- * defaults to `"javascript"`.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class CodeInputSchema extends Model {
-    language: string;
-    code: string;
-    data?: unknown;
-}
-export declare class CodeNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    input: CodeInputSchema;
-    result: unknown;
-}

package/lib/types/graph/nodes/utility/code.d.mts

@@ -1,36 +0,0 @@
-/**
- * @module integrations/graph/nodes/utility/code
- * @summary Code utility node declaration (ALFRED-5 §7, DECAF-32 §22.4).
- * @description Code — sandboxed JS/TS code execution. The class's own
- * `static execute` is the only implementation of the kind, derived by
- * `GraphBuiltInRegistrations`, and reaches the pluggable `CodeSandboxEvaluator`
- * through `GraphExecutionContext.engine`.
- * The default `IsolatedVmCodeSandboxEvaluator` (backed by `isolated-vm`)
- * enforces the Code Node restrictions: no imports, no requires, pure
- * functions only. The sandbox context exposes `$input`, `$vars`, `$item`,
- * `$index`, `$node`, and `$output` as data variables. TypeScript is
- * supported via transpilation.
- *
- * The `@input` on `CodeNode.input` is a schema group — the nested
- * model's `@input` ports are spliced into the parent unprefixed. `code` has
- * `@input` + `@uielement("code-editor")`, so it appears as a port AND in the
- * CRUD modal (the only visible field). `data` has `@input` + `@hidden()` but
- * no `@uielement`, so it is a canvas-only port (for edge connections from
- * workflow input badges) but never appears in the CRUD modal. `language` has
- * no `@input` and no `@uielement`, so it is neither a port nor rendered — it
- * defaults to `"javascript"`.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class CodeInputSchema extends Model {
-    language: string;
-    code: string;
-    data?: unknown;
-}
-export declare class CodeNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
-    input: CodeInputSchema;
-    result: unknown;
-}

package/lib/types/graph/nodes/utility/delay.d.cts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class DelayFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    value: unknown;
-    valueOut: unknown;
-}

package/lib/types/graph/nodes/utility/delay.d.mts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class DelayFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    value: unknown;
-    valueOut: unknown;
-}

package/lib/types/graph/nodes/utility/log.d.cts

@@ -1,8 +0,0 @@
-import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-import { GraphNode } from "../base.d.cts";
-export declare class LogFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): GraphExecutionValues;
-    value: unknown;
-    logged: unknown;
-}

package/lib/types/graph/nodes/utility/log.d.mts

@@ -1,8 +0,0 @@
-import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-import { GraphNode } from "../base.d.mts";
-export declare class LogFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): GraphExecutionValues;
-    value: unknown;
-    logged: unknown;
-}

package/lib/types/graph/nodes/utility/map.d.cts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class MapNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    value: unknown;
-    result: unknown;
-}

package/lib/types/graph/nodes/utility/map.d.mts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class MapNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    value: unknown;
-    result: unknown;
-}

package/lib/types/graph/nodes/utility/merge.d.cts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class MergeFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    values: unknown[];
-    merged: unknown;
-}

package/lib/types/graph/nodes/utility/merge.d.mts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class MergeFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    values: unknown[];
-    merged: unknown;
-}

package/lib/types/graph/nodes/utility/return.d.cts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-export declare class ReturnFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    value: unknown;
-    result: unknown;
-}

package/lib/types/graph/nodes/utility/return.d.mts

@@ -1,7 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-export declare class ReturnFlowNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    value: unknown;
-    result: unknown;
-}

package/lib/types/graph/nodes/utility/utility-log.d.cts

@@ -1,10 +0,0 @@
-import type { LogNodeLevel } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-import { GraphNode } from "../base.d.cts";
-export declare class UtilityLogNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): GraphExecutionValues;
-    value: unknown;
-    level: LogNodeLevel;
-    logged: unknown;
-}

package/lib/types/graph/nodes/utility/utility-log.d.mts

@@ -1,10 +0,0 @@
-import type { LogNodeLevel } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-import { GraphNode } from "../base.d.mts";
-export declare class UtilityLogNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): GraphExecutionValues;
-    value: unknown;
-    level: LogNodeLevel;
-    logged: unknown;
-}

package/lib/types/nest/graph/GraphExecutionController.d.cts

@@ -1,110 +0,0 @@
-/**
- * @module integrations/nest/graph/GraphExecutionController
- * @summary Legacy synchronous graph execution surface (SAA-595).
- * @description The deprecated `POST /graph/execute` endpoint, the deprecated
- * global `SSE /graph/events` stream, plus the run-result read and workflow
- * persistence endpoints. All execution now flows through
- * {@link GraphRunService}; only canonical documents are accepted (inline
- * node/definition/executor/ports/component fields are rejected at the
- * boundary) and the global stream is disabled unless explicitly enabled.
- */
-import { MessageEvent } from "@nestjs/common";
-import { Observable } from "rxjs";
-import { GraphExecutionEngine, GraphRunService, type GraphExecutionValues } from "../../graph/index.d.cts";
-import { type GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import { DecafRequestContext } from "@decaf-ts/for-nest";
-import { GraphResultService } from "./GraphResultService.d.cts";
-import { GraphWorkflowService } from "./GraphWorkflowService.d.cts";
-/** DI token for {@link GraphExecutionControllerOptions}. */
-export declare const GRAPH_EXECUTION_OPTIONS = "GRAPH_EXECUTION_OPTIONS";
-/**
- * Options for the legacy execution surface (SAA-595): the deprecated global
- * SSE stream is disabled unless explicitly enabled, and when enabled every
- * emitted event is ownership-gated against the connected caller.
- */
-export interface GraphExecutionControllerOptions {
-    /**
-     * Whether the deprecated global `GET /graph/events` SSE stream is exposed
-     * at all. Defaults to `false`: the run-scoped, replayable
-     * `GET /graph/runs/{runId}/events` transport is the canonical stream
-     * (DECAF-50 §4.15). When `true`, each connected caller only receives
-     * events for runs they own.
-     */
-    enableGlobalEventStream?: boolean;
-}
-/**
- * Execution payloads accept a canonical {@link GraphWorkflowDocument} only
- * (DECAF-50 §4.16 cutover): client payloads carrying legacy definitions,
- * snapshots, or inline node/definition/executor/ports/component fields are
- * rejected at the boundary.
- */
-export interface GraphExecutePayload {
-    workflow: GraphWorkflowDocument;
-    inputs: GraphExecutionValues;
-}
-/** Response of the (deprecated) synchronous execute endpoint: run id, terminal status, and output values. */
-export interface GraphExecuteResponse {
-    runId: string;
-    status: string;
-    outputs: Record<string, unknown>;
-}
-/**
- * Legacy synchronous graph execution surface (DECAF-50 §4.14/§4.18): the
- * `POST /graph/execute` endpoint (deprecated in favour of the run lifecycle
- * at `POST /graph/runs`), the legacy `PUT /graph/:id/execute` alias, and the
- * deprecated global SSE event stream. All execution now flows through
- * {@link GraphRunService}; only canonical documents are accepted.
- */
-export declare class GraphExecutionController {
-    private readonly engine;
-    private readonly resultService;
-    private readonly workflowService;
-    private readonly runService;
-    private readonly requestContext?;
-    private readonly options;
-    private readonly eventSubject;
-    constructor(engine: GraphExecutionEngine, resultService: GraphResultService, workflowService: GraphWorkflowService, runService: GraphRunService, requestContext?: DecafRequestContext | undefined, options?: GraphExecutionControllerOptions);
-    /**
-     * @deprecated DECAF-50 §4.14/§4.18 cutover: the synchronous execution
-     * endpoint is deprecated in favour of the asynchronous run lifecycle
-     * (`POST /graph/runs`). It is kept, not removed, within this
-     * specification. Only canonical {@link GraphWorkflowDocument} payloads are
-     * accepted; legacy definition/snapshot payloads and inline
-     * node/definition/executor/ports/component fields are rejected (§4.16).
-     */
-    execute(body: GraphExecutePayload): Promise<GraphExecuteResponse>;
-    /**
-     * DECAF-50 §4.16 cutover: only a canonical {@link GraphWorkflowDocument}
-     * is accepted. Payloads resembling legacy decorated definitions, snapshot
-     * wrappers, or any other non-canonical shape are rejected with a Decaf
-     * {@link ValidationError} before the engine or planner sees them.
-     */
-    private requireCanonicalDocument;
-    /**
-     * @deprecated DECAF-50 §4.15 cutover (SAA-595 F2): the global `/graph/events`
-     * stream is disabled by default — the run-scoped, authorized, replayable
-     * `GET /graph/runs/{runId}/events` transport is the canonical stream. Hosts
-     * with a residual transition need may re-enable it explicitly via
-     * {@link GraphExecutionControllerOptions.enableGlobalEventStream}; every
-     * event is then ownership-gated at emit: a connected caller only ever
-     * receives events for runs they own.
-     */
-    events(): Observable<MessageEvent>;
-    /** Encodes one engine event in the global stream's wire format: a `["graph", type, runId, envelope]` SSE message tuple. */
-    private messageOf;
-    /** Strict ownership gate for the global stream: only run owners see their runs' events. */
-    private callerOwnsRun;
-    /**
-     * Reads a persisted execution result by run id (DECAF-50 §4.18). Gated
-     * through the centralized run ownership check first (SAA-595 F1): a
-     * cross-user or anonymous caller gets `403` for a run owned by another
-     * user before any result data is read.
-     */
-    getResult(runId: string): Promise<unknown>;
-    /** Concurrency-bucket key for the per-caller run cap: the owner, else the request IP, else a shared anonymous bucket. */
-    private concurrencyKeyOf;
-    saveWorkflow(id: string, snapshot: Record<string, unknown>): Promise<{
-        workflowId: string;
-        savedAt: string;
-    }>;
-}

package/lib/types/nest/graph/GraphExecutionController.d.mts

@@ -1,110 +0,0 @@
-/**
- * @module integrations/nest/graph/GraphExecutionController
- * @summary Legacy synchronous graph execution surface (SAA-595).
- * @description The deprecated `POST /graph/execute` endpoint, the deprecated
- * global `SSE /graph/events` stream, plus the run-result read and workflow
- * persistence endpoints. All execution now flows through
- * {@link GraphRunService}; only canonical documents are accepted (inline
- * node/definition/executor/ports/component fields are rejected at the
- * boundary) and the global stream is disabled unless explicitly enabled.
- */
-import { MessageEvent } from "@nestjs/common";
-import { Observable } from "rxjs";
-import { GraphExecutionEngine, GraphRunService, type GraphExecutionValues } from "../../graph/index.d.mts";
-import { type GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import { DecafRequestContext } from "@decaf-ts/for-nest";
-import { GraphResultService } from "./GraphResultService.d.mts";
-import { GraphWorkflowService } from "./GraphWorkflowService.d.mts";
-/** DI token for {@link GraphExecutionControllerOptions}. */
-export declare const GRAPH_EXECUTION_OPTIONS = "GRAPH_EXECUTION_OPTIONS";
-/**
- * Options for the legacy execution surface (SAA-595): the deprecated global
- * SSE stream is disabled unless explicitly enabled, and when enabled every
- * emitted event is ownership-gated against the connected caller.
- */
-export interface GraphExecutionControllerOptions {
-    /**
-     * Whether the deprecated global `GET /graph/events` SSE stream is exposed
-     * at all. Defaults to `false`: the run-scoped, replayable
-     * `GET /graph/runs/{runId}/events` transport is the canonical stream
-     * (DECAF-50 §4.15). When `true`, each connected caller only receives
-     * events for runs they own.
-     */
-    enableGlobalEventStream?: boolean;
-}
-/**
- * Execution payloads accept a canonical {@link GraphWorkflowDocument} only
- * (DECAF-50 §4.16 cutover): client payloads carrying legacy definitions,
- * snapshots, or inline node/definition/executor/ports/component fields are
- * rejected at the boundary.
- */
-export interface GraphExecutePayload {
-    workflow: GraphWorkflowDocument;
-    inputs: GraphExecutionValues;
-}
-/** Response of the (deprecated) synchronous execute endpoint: run id, terminal status, and output values. */
-export interface GraphExecuteResponse {
-    runId: string;
-    status: string;
-    outputs: Record<string, unknown>;
-}
-/**
- * Legacy synchronous graph execution surface (DECAF-50 §4.14/§4.18): the
- * `POST /graph/execute` endpoint (deprecated in favour of the run lifecycle
- * at `POST /graph/runs`), the legacy `PUT /graph/:id/execute` alias, and the
- * deprecated global SSE event stream. All execution now flows through
- * {@link GraphRunService}; only canonical documents are accepted.
- */
-export declare class GraphExecutionController {
-    private readonly engine;
-    private readonly resultService;
-    private readonly workflowService;
-    private readonly runService;
-    private readonly requestContext?;
-    private readonly options;
-    private readonly eventSubject;
-    constructor(engine: GraphExecutionEngine, resultService: GraphResultService, workflowService: GraphWorkflowService, runService: GraphRunService, requestContext?: DecafRequestContext | undefined, options?: GraphExecutionControllerOptions);
-    /**
-     * @deprecated DECAF-50 §4.14/§4.18 cutover: the synchronous execution
-     * endpoint is deprecated in favour of the asynchronous run lifecycle
-     * (`POST /graph/runs`). It is kept, not removed, within this
-     * specification. Only canonical {@link GraphWorkflowDocument} payloads are
-     * accepted; legacy definition/snapshot payloads and inline
-     * node/definition/executor/ports/component fields are rejected (§4.16).
-     */
-    execute(body: GraphExecutePayload): Promise<GraphExecuteResponse>;
-    /**
-     * DECAF-50 §4.16 cutover: only a canonical {@link GraphWorkflowDocument}
-     * is accepted. Payloads resembling legacy decorated definitions, snapshot
-     * wrappers, or any other non-canonical shape are rejected with a Decaf
-     * {@link ValidationError} before the engine or planner sees them.
-     */
-    private requireCanonicalDocument;
-    /**
-     * @deprecated DECAF-50 §4.15 cutover (SAA-595 F2): the global `/graph/events`
-     * stream is disabled by default — the run-scoped, authorized, replayable
-     * `GET /graph/runs/{runId}/events` transport is the canonical stream. Hosts
-     * with a residual transition need may re-enable it explicitly via
-     * {@link GraphExecutionControllerOptions.enableGlobalEventStream}; every
-     * event is then ownership-gated at emit: a connected caller only ever
-     * receives events for runs they own.
-     */
-    events(): Observable<MessageEvent>;
-    /** Encodes one engine event in the global stream's wire format: a `["graph", type, runId, envelope]` SSE message tuple. */
-    private messageOf;
-    /** Strict ownership gate for the global stream: only run owners see their runs' events. */
-    private callerOwnsRun;
-    /**
-     * Reads a persisted execution result by run id (DECAF-50 §4.18). Gated
-     * through the centralized run ownership check first (SAA-595 F1): a
-     * cross-user or anonymous caller gets `403` for a run owned by another
-     * user before any result data is read.
-     */
-    getResult(runId: string): Promise<unknown>;
-    /** Concurrency-bucket key for the per-caller run cap: the owner, else the request IP, else a shared anonymous bucket. */
-    private concurrencyKeyOf;
-    saveWorkflow(id: string, snapshot: Record<string, unknown>): Promise<{
-        workflowId: string;
-        savedAt: string;
-    }>;
-}