@decaf-ts/integrations 0.10.5 → 0.11.0

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

@@ -1,19 +0,0 @@
-/**
- * @module integrations/graph/validation
- * @summary Graph validation utilities.
- * @description Re-exports the legacy definition/port/value validators plus
- * the DECAF-50 §4.8 nine-stage document validation gate, structured issues,
- * resolved-workflow types, and the normative validation error hierarchy.
- */
-export * from "./GraphDefinitionValidator.d.cts";
-export * from "./GraphPortSchemaResolver.d.cts";
-export * from "./GraphValueValidator.d.cts";
-export * from "./GraphValidationIssue.d.cts";
-export * from "./GraphValidationErrors.d.cts";
-export * from "./GraphResolvedWorkflow.d.cts";
-export * from "./GraphNodeInstanceValidator.d.cts";
-export * from "./GraphParameterValidator.d.cts";
-export * from "./GraphEdgeInstanceValidator.d.cts";
-export * from "./GraphConnectionPolicyValidator.d.cts";
-export * from "./GraphCredentialReferenceValidator.d.cts";
-export * from "./GraphWorkflowDocumentValidator.d.cts";

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

@@ -1,19 +0,0 @@
-/**
- * @module integrations/graph/validation
- * @summary Graph validation utilities.
- * @description Re-exports the legacy definition/port/value validators plus
- * the DECAF-50 §4.8 nine-stage document validation gate, structured issues,
- * resolved-workflow types, and the normative validation error hierarchy.
- */
-export * from "./GraphDefinitionValidator.d.mts";
-export * from "./GraphPortSchemaResolver.d.mts";
-export * from "./GraphValueValidator.d.mts";
-export * from "./GraphValidationIssue.d.mts";
-export * from "./GraphValidationErrors.d.mts";
-export * from "./GraphResolvedWorkflow.d.mts";
-export * from "./GraphNodeInstanceValidator.d.mts";
-export * from "./GraphParameterValidator.d.mts";
-export * from "./GraphEdgeInstanceValidator.d.mts";
-export * from "./GraphConnectionPolicyValidator.d.mts";
-export * from "./GraphCredentialReferenceValidator.d.mts";
-export * from "./GraphWorkflowDocumentValidator.d.mts";

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

@@ -1,12 +0,0 @@
-/**
- * @module integrations/graph
- * @summary Decaf Graph Execution Engine (backend convenience export).
- * @description Re-exports `./engine` (all engine modules). Backend consumers
- * import from `@decaf-ts/integrations/graph` and get a single unified surface.
- *
- * Frontend-safe shared declarations (node kinds, types, constants) live in
- * `@decaf-ts/ui-decorators/graph` — frontend bundles MUST import from there
- * to avoid pulling in the execution engine.
- */
-import "./log/LogParameters";
-export * from "./engine/index.d.cts";

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

@@ -1,12 +0,0 @@
-/**
- * @module integrations/graph
- * @summary Decaf Graph Execution Engine (backend convenience export).
- * @description Re-exports `./engine` (all engine modules). Backend consumers
- * import from `@decaf-ts/integrations/graph` and get a single unified surface.
- *
- * Frontend-safe shared declarations (node kinds, types, constants) live in
- * `@decaf-ts/ui-decorators/graph` — frontend bundles MUST import from there
- * to avoid pulling in the execution engine.
- */
-import "./log/LogParameters";
-export * from "./engine/index.d.mts";

package/lib/types/graph/log/GraphRunLogger.d.cts

@@ -1,76 +0,0 @@
-import type { Logger, LogMeta, StringLike } from "@decaf-ts/logging";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Signature of the context's event emitter used to forward log entries onto
- * the existing graph execution Observable.
- */
-export type GraphLogForwardFn = (event: Partial<GraphExecutionEvent>) => Promise<void>;
-/**
- * Options for constructing a {@link GraphRunLogger}.
- */
-export interface GraphRunLoggerOptions {
-    runId: string;
-    workflowId: string;
-    nodeId: string;
-    user?: string | null;
-    /**
-     * Callback that forwards a structured log entry to the graph execution
-     * Observable (emits a `GRAPH_RUN_LOG` event). Errors are swallowed.
-     */
-    forward: GraphLogForwardFn;
-}
-/**
- * Logger used by graph node executors (`ctx.logger`).
- *
- * Wraps the shared MiniLogger pipeline so the DECAF-48 attributes render as
- * discrete custom attributes in the formatted output, and forwards each
- * structured entry through {@link GraphRunLoggerOptions.forward} so the SSE
- * log channel (`graph.run.log`) receives the level/message/attributes/
- * timestamp payload.
- */
-export declare class GraphRunLogger implements Logger {
-    private readonly inner;
-    private readonly baseOptions;
-    constructor(options: GraphRunLoggerOptions);
-    /**
-     * Produces the `Partial<LoggingConfig>` carrying the DECAF-48 attributes
-     * so the LogParameter descriptors render them (DECAF-9 §4.6).
-     */
-    private attributeConfig;
-    /** Emits a structured log entry synchronously (forward is fire-and-forget). */
-    private emit;
-    /** @inheritdoc */
-    benchmark(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    fatal(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    critical(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    silly(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    trace(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    verbose(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    info(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    error(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    warn(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    debug(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, code: number, meta?: LogMeta): void;
-    /** @inheritdoc */
-    setConfig(): void;
-    /** @inheritdoc */
-    for(_method?: string | ((...args: any[]) => any) | {
-        new (...args: any[]): any;
-    } | object | Partial<any>, _config?: Partial<any>, ..._args: any[]): this;
-    /** @inheritdoc */
-    clear(): this;
-    /** @inheritdoc */
-    get root(): string[];
-}

package/lib/types/graph/log/GraphRunLogger.d.mts

@@ -1,76 +0,0 @@
-import type { Logger, LogMeta, StringLike } from "@decaf-ts/logging";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Signature of the context's event emitter used to forward log entries onto
- * the existing graph execution Observable.
- */
-export type GraphLogForwardFn = (event: Partial<GraphExecutionEvent>) => Promise<void>;
-/**
- * Options for constructing a {@link GraphRunLogger}.
- */
-export interface GraphRunLoggerOptions {
-    runId: string;
-    workflowId: string;
-    nodeId: string;
-    user?: string | null;
-    /**
-     * Callback that forwards a structured log entry to the graph execution
-     * Observable (emits a `GRAPH_RUN_LOG` event). Errors are swallowed.
-     */
-    forward: GraphLogForwardFn;
-}
-/**
- * Logger used by graph node executors (`ctx.logger`).
- *
- * Wraps the shared MiniLogger pipeline so the DECAF-48 attributes render as
- * discrete custom attributes in the formatted output, and forwards each
- * structured entry through {@link GraphRunLoggerOptions.forward} so the SSE
- * log channel (`graph.run.log`) receives the level/message/attributes/
- * timestamp payload.
- */
-export declare class GraphRunLogger implements Logger {
-    private readonly inner;
-    private readonly baseOptions;
-    constructor(options: GraphRunLoggerOptions);
-    /**
-     * Produces the `Partial<LoggingConfig>` carrying the DECAF-48 attributes
-     * so the LogParameter descriptors render them (DECAF-9 §4.6).
-     */
-    private attributeConfig;
-    /** Emits a structured log entry synchronously (forward is fire-and-forget). */
-    private emit;
-    /** @inheritdoc */
-    benchmark(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    fatal(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    critical(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    silly(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    trace(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    verbose(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    info(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    error(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    warn(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    debug(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, code: number, meta?: LogMeta): void;
-    /** @inheritdoc */
-    setConfig(): void;
-    /** @inheritdoc */
-    for(_method?: string | ((...args: any[]) => any) | {
-        new (...args: any[]): any;
-    } | object | Partial<any>, _config?: Partial<any>, ..._args: any[]): this;
-    /** @inheritdoc */
-    clear(): this;
-    /** @inheritdoc */
-    get root(): string[];
-}

package/lib/types/graph/log/LogParameters.d.cts

@@ -1,7 +0,0 @@
-/**
- * Registers the four DECAF-48 run attributes as log parameter descriptors
- * (nodeId / workflowId / runId / user). Rendered only when keyed with a
- * non-null value so one-shot module imports from other packages never leak
- * empty columns.
- */
-export declare function registerGraphRunLogParameters(): void;

package/lib/types/graph/log/LogParameters.d.mts

@@ -1,7 +0,0 @@
-/**
- * Registers the four DECAF-48 run attributes as log parameter descriptors
- * (nodeId / workflowId / runId / user). Rendered only when keyed with a
- * non-null value so one-shot module imports from other packages never leak
- * empty columns.
- */
-export declare function registerGraphRunLogParameters(): void;

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;
-    }>;
-}

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

@@ -1,83 +0,0 @@
-/**
- * @module integrations/nest/graph/GraphExecutionModule
- * @summary NestJS graph backend module wiring (DECAF-50 §4.10–§4.16).
- * @description The dynamic module assembling the graph backend: the
- * {@link GraphExecutionEngine}, the trusted {@link GraphNodeCatalogue} with
- * built-in registrations, the run lifecycle services and stores, and the
- * HTTP/SSE controllers (catalogue, workflows, runs, legacy execution) — each
- * configurable with authentication enforcement and backend-enforced
- * resource limits via {@link GraphExecutionModuleOptions}.
- */
-import { DynamicModule } from "@nestjs/common";
-import { type GraphCredentialAuthorizer } from "../../graph/index.d.cts";
-import { type GraphExecutionControllerOptions } from "./GraphExecutionController.d.cts";
-import { type GraphCatalogueControllerOptions } from "./GraphNodeCatalogueController.d.cts";
-import { type GraphRunControllerOptions } from "./GraphRunController.d.cts";
-import { type GraphWorkflowServiceOptions } from "./GraphWorkflowService.d.cts";
-import { type GraphWorkflowControllerOptions } from "./GraphWorkflowController.d.cts";
-/**
- * Options for {@link GraphExecutionModule.forRoot}: adapter bootstrapping
- * plus per-API (catalogue, workflows, runs) authentication and limit
- * configuration.
- */
-export interface GraphExecutionModuleOptions {
-    /**
-     * When `true`, the module bootstraps a default RamAdapter for standalone
-     * development. When `false`, the host application is expected to have
-     * already configured a Decaf adapter via `DecafModule.forRoot(...)`.
-     * Defaults to `true` for backwards compatibility.
-     */
-    initAdapter?: boolean;
-    /**
-     * Adapter user identifier passed to `RamAdapter` when `initAdapter` is
-     * `true`. Ignored when `initAdapter` is `false`.
-     * Defaults to `"graph-engine"`.
-     */
-    adapterUser?: string;
-    /**
-     * Options for the node catalogue HTTP API (DECAF-50 §4.13): authentication
-     * enforcement and backend-enforced rate limits for the expensive
-     * `resolve`/`methods` operations.
-     */
-    catalogue?: GraphCatalogueControllerOptions;
-    /**
-     * Options for the canonical workflow persistence HTTP API (DECAF-50 §4.10):
-     * authentication enforcement and backend-enforced document resource limits.
-     */
-    workflows?: GraphWorkflowControllerOptions & GraphWorkflowServiceOptions;
-    /**
-     * Options for the asynchronous run lifecycle API (DECAF-50 §4.14–§4.15):
-     * authentication enforcement and backend-enforced run resource limits.
-     */
-    runs?: GraphRunControllerOptions;
-    /**
-     * Options for the legacy synchronous execution surface (SAA-595): the
-     * deprecated global SSE stream is disabled unless explicitly enabled.
-     */
-    execution?: GraphExecutionControllerOptions;
-    /**
-     * Production hosts MUST wire a {@link GraphCredentialAuthorizer} backed by
-     * their credential store (DECAF-50 §4.8 stage 8). Without it, stage-8
-     * credential checks are shape/type-only: a reference that is
-     * well-formed and type-matched is accepted without verifying that the
-     * credential exists or that the run is authorized to use it (SAA-595 F8).
-     */
-    credentialAuthorizer?: GraphCredentialAuthorizer;
-}
-/**
- * NestJS module wiring the graph execution stack (DECAF-50 §4.13–§4.16): the
- * engine, catalogue, workflow persistence, run lifecycle/SSE controllers,
- * and their services. Configure via {@link GraphExecutionModule.forRoot}.
- */
-export declare class GraphExecutionModule {
-    /**
-     * Creates the dynamic module. Boots a default RamAdapter for standalone
-     * development unless `initAdapter` is `false`. Wires the optional
-     * {@link GraphCredentialAuthorizer} into the engine's stage-8 validator
-     * (SAA-595 F8), and applies the workflow options to the
-     * {@link GraphWorkflowService} singleton via its {@link
-     * GraphWorkflowService.configure} method, since `@service` constructor
-     * injection does not forward provider options reliably.
-     */
-    static forRoot(options?: GraphExecutionModuleOptions): DynamicModule;
-}

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

@@ -1,83 +0,0 @@
-/**
- * @module integrations/nest/graph/GraphExecutionModule
- * @summary NestJS graph backend module wiring (DECAF-50 §4.10–§4.16).
- * @description The dynamic module assembling the graph backend: the
- * {@link GraphExecutionEngine}, the trusted {@link GraphNodeCatalogue} with
- * built-in registrations, the run lifecycle services and stores, and the
- * HTTP/SSE controllers (catalogue, workflows, runs, legacy execution) — each
- * configurable with authentication enforcement and backend-enforced
- * resource limits via {@link GraphExecutionModuleOptions}.
- */
-import { DynamicModule } from "@nestjs/common";
-import { type GraphCredentialAuthorizer } from "../../graph/index.d.mts";
-import { type GraphExecutionControllerOptions } from "./GraphExecutionController.d.mts";
-import { type GraphCatalogueControllerOptions } from "./GraphNodeCatalogueController.d.mts";
-import { type GraphRunControllerOptions } from "./GraphRunController.d.mts";
-import { type GraphWorkflowServiceOptions } from "./GraphWorkflowService.d.mts";
-import { type GraphWorkflowControllerOptions } from "./GraphWorkflowController.d.mts";
-/**
- * Options for {@link GraphExecutionModule.forRoot}: adapter bootstrapping
- * plus per-API (catalogue, workflows, runs) authentication and limit
- * configuration.
- */
-export interface GraphExecutionModuleOptions {
-    /**
-     * When `true`, the module bootstraps a default RamAdapter for standalone
-     * development. When `false`, the host application is expected to have
-     * already configured a Decaf adapter via `DecafModule.forRoot(...)`.
-     * Defaults to `true` for backwards compatibility.
-     */
-    initAdapter?: boolean;
-    /**
-     * Adapter user identifier passed to `RamAdapter` when `initAdapter` is
-     * `true`. Ignored when `initAdapter` is `false`.
-     * Defaults to `"graph-engine"`.
-     */
-    adapterUser?: string;
-    /**
-     * Options for the node catalogue HTTP API (DECAF-50 §4.13): authentication
-     * enforcement and backend-enforced rate limits for the expensive
-     * `resolve`/`methods` operations.
-     */
-    catalogue?: GraphCatalogueControllerOptions;
-    /**
-     * Options for the canonical workflow persistence HTTP API (DECAF-50 §4.10):
-     * authentication enforcement and backend-enforced document resource limits.
-     */
-    workflows?: GraphWorkflowControllerOptions & GraphWorkflowServiceOptions;
-    /**
-     * Options for the asynchronous run lifecycle API (DECAF-50 §4.14–§4.15):
-     * authentication enforcement and backend-enforced run resource limits.
-     */
-    runs?: GraphRunControllerOptions;
-    /**
-     * Options for the legacy synchronous execution surface (SAA-595): the
-     * deprecated global SSE stream is disabled unless explicitly enabled.
-     */
-    execution?: GraphExecutionControllerOptions;
-    /**
-     * Production hosts MUST wire a {@link GraphCredentialAuthorizer} backed by
-     * their credential store (DECAF-50 §4.8 stage 8). Without it, stage-8
-     * credential checks are shape/type-only: a reference that is
-     * well-formed and type-matched is accepted without verifying that the
-     * credential exists or that the run is authorized to use it (SAA-595 F8).
-     */
-    credentialAuthorizer?: GraphCredentialAuthorizer;
-}
-/**
- * NestJS module wiring the graph execution stack (DECAF-50 §4.13–§4.16): the
- * engine, catalogue, workflow persistence, run lifecycle/SSE controllers,
- * and their services. Configure via {@link GraphExecutionModule.forRoot}.
- */
-export declare class GraphExecutionModule {
-    /**
-     * Creates the dynamic module. Boots a default RamAdapter for standalone
-     * development unless `initAdapter` is `false`. Wires the optional
-     * {@link GraphCredentialAuthorizer} into the engine's stage-8 validator
-     * (SAA-595 F8), and applies the workflow options to the
-     * {@link GraphWorkflowService} singleton via its {@link
-     * GraphWorkflowService.configure} method, since `@service` constructor
-     * injection does not forward provider options reliably.
-     */
-    static forRoot(options?: GraphExecutionModuleOptions): DynamicModule;
-}

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

@@ -1,24 +0,0 @@
-import { BaseModel } from "@decaf-ts/core";
-/**
- * Persisted terminal snapshot of one graph run (written by
- * {@link GraphResultService} after the deprecated synchronous execute
- * endpoint completes). Keyed by `runId`; the optional `owner` column (added
- * by SAA-595 F1) records the run's owning user so result reads can be
- * ownership-gated at the route layer.
- */
-export declare class GraphExecutionResultModel extends BaseModel {
-    runId: string;
-    workflowId: string;
-    /**
-     * Owning user of the run this result belongs to (SAA-595 F1); absent for
-     * legacy/anonymous results, which carry no enforceable ownership.
-     */
-    owner?: string;
-    status: string;
-    inputs: Record<string, unknown>;
-    outputs: Record<string, unknown>;
-    nodeResults: Record<string, unknown>;
-    startedAt: Date;
-    finishedAt?: Date;
-    constructor(arg?: Partial<GraphExecutionResultModel>);
-}