@decaf-ts/integrations 0.3.11 → 0.4.0

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

@@ -11,4 +11,5 @@ export * from "./GraphExecutionEngine.d.cts";
 export * from "./CodeSandboxEvaluator.d.cts";
 export * from "./SwitchGraphNodeExecutor.d.cts";
 export * from "./CodeGraphNodeExecutor.d.cts";
+export * from "./LogGraphNodeExecutor.d.cts";
 export * from "./IsolatedVmCodeSandboxEvaluator.d.cts";

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

@@ -11,4 +11,5 @@ export * from "./GraphExecutionEngine.d.mts";
 export * from "./CodeSandboxEvaluator.d.mts";
 export * from "./SwitchGraphNodeExecutor.d.mts";
 export * from "./CodeGraphNodeExecutor.d.mts";
+export * from "./LogGraphNodeExecutor.d.mts";
 export * from "./IsolatedVmCodeSandboxEvaluator.d.mts";

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

@@ -32,6 +32,7 @@ export * from "./execution/GraphExecutionEngine.d.cts";
 export * from "./execution/CodeSandboxEvaluator.d.cts";
 export * from "./execution/SwitchGraphNodeExecutor.d.cts";
 export * from "./execution/CodeGraphNodeExecutor.d.cts";
+export * from "./execution/LogGraphNodeExecutor.d.cts";
 export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.cts";
 export * from "./registry/GraphNodeExecutorRegistry.d.cts";
 export * from "./registry/GraphNodeExecutorResolver.d.cts";

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

@@ -32,6 +32,7 @@ export * from "./execution/GraphExecutionEngine.d.mts";
 export * from "./execution/CodeSandboxEvaluator.d.mts";
 export * from "./execution/SwitchGraphNodeExecutor.d.mts";
 export * from "./execution/CodeGraphNodeExecutor.d.mts";
+export * from "./execution/LogGraphNodeExecutor.d.mts";
 export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.mts";
 export * from "./registry/GraphNodeExecutorRegistry.d.mts";
 export * from "./registry/GraphNodeExecutorResolver.d.mts";

package/lib/types/graph/shared/nodes/flow-control.d.cts

@@ -38,7 +38,9 @@ export declare class SwitchFlowNode extends GraphNode {
     /**
      * Computes the node's ports, size, and data patch from the given switch
      * metadata. Each case gets its own output port on the right side; the
-     * node grows in height as cases are added.
+     * `default` port always renders **last** (DECAF-32 §21 port-ordering rule,
+     * DECAF-34 §6.2). When `hasDefault` is `false`, the `default` output port
+     * is omitted entirely. The node grows in height as cases are added.
      */
     static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
 }
@@ -103,11 +105,35 @@ export declare class ReturnFlowNode extends Model {
  * sandbox context exposes `$input`, `$vars`, `$item`, `$index`, `$node`, and
  * `$output` as data variables. TypeScript is supported via transpilation.
  */
+/**
+ * Input schema for the Code node. The `@input` on `CodeFlowNode.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"`.
+ */
+export declare class CodeInputSchema extends Model {
+    language: string;
+    code: string;
+    data?: unknown;
+}
 export declare class CodeFlowNode extends Model {
-    input: unknown;
+    input: CodeInputSchema;
     result: unknown;
 }
+/**
+ * Log — logs the input value and forwards it unchanged on the `logged`
+ * output port. Useful for debugging, audit trails, and discard/side-effect
+ * branches in a workflow.
+ */
+export declare class LogFlowNode extends Model {
+    value: unknown;
+    logged: unknown;
+}
 /**
  * All built-in flow-control node constructors.
  */
-export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof MapFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof CodeFlowNode];
+export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof MapFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof CodeFlowNode, typeof LogFlowNode];

package/lib/types/graph/shared/nodes/flow-control.d.mts

@@ -38,7 +38,9 @@ export declare class SwitchFlowNode extends GraphNode {
     /**
      * Computes the node's ports, size, and data patch from the given switch
      * metadata. Each case gets its own output port on the right side; the
-     * node grows in height as cases are added.
+     * `default` port always renders **last** (DECAF-32 §21 port-ordering rule,
+     * DECAF-34 §6.2). When `hasDefault` is `false`, the `default` output port
+     * is omitted entirely. The node grows in height as cases are added.
      */
     static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
 }
@@ -103,11 +105,35 @@ export declare class ReturnFlowNode extends Model {
  * sandbox context exposes `$input`, `$vars`, `$item`, `$index`, `$node`, and
  * `$output` as data variables. TypeScript is supported via transpilation.
  */
+/**
+ * Input schema for the Code node. The `@input` on `CodeFlowNode.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"`.
+ */
+export declare class CodeInputSchema extends Model {
+    language: string;
+    code: string;
+    data?: unknown;
+}
 export declare class CodeFlowNode extends Model {
-    input: unknown;
+    input: CodeInputSchema;
     result: unknown;
 }
+/**
+ * Log — logs the input value and forwards it unchanged on the `logged`
+ * output port. Useful for debugging, audit trails, and discard/side-effect
+ * branches in a workflow.
+ */
+export declare class LogFlowNode extends Model {
+    value: unknown;
+    logged: unknown;
+}
 /**
  * All built-in flow-control node constructors.
  */
-export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof MapFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof CodeFlowNode];
+export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof MapFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof CodeFlowNode, typeof LogFlowNode];

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

@@ -102,10 +102,16 @@ export interface SwitchCase {
 }
 /**
  * Metadata for a Switch node, stored in `metadata.switch`.
+ *
+ * When `hasDefault` is `false` (the default), the `default` output port is
+ * hidden and the executor throws a `GraphExecutionError` when no case
+ * matches. When `hasDefault` is `true`, the `default` output port is visible
+ * and receives the input when no case matches (DECAF-34 §6.2).
  */
 export interface SwitchNodeMetadata {
     cases: SwitchCase[];
     defaultPort?: string;
+    hasDefault?: boolean;
 }
 /**
  * The result of applying a metadata change to a node. Each concrete node

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

@@ -102,10 +102,16 @@ export interface SwitchCase {
 }
 /**
  * Metadata for a Switch node, stored in `metadata.switch`.
+ *
+ * When `hasDefault` is `false` (the default), the `default` output port is
+ * hidden and the executor throws a `GraphExecutionError` when no case
+ * matches. When `hasDefault` is `true`, the `default` output port is visible
+ * and receives the input when no case matches (DECAF-34 §6.2).
  */
 export interface SwitchNodeMetadata {
     cases: SwitchCase[];
     defaultPort?: string;
+    hasDefault?: boolean;
 }
 /**
  * The result of applying a metadata change to a node. Each concrete node

package/lib/types/index.d.cts

@@ -6,6 +6,6 @@
 export * from "./utils.d.cts";
 export * from "./namespaces/index.d.cts";
 export declare const VERSION: string;
-export declare const COMMIT = "857014d";
-export declare const FULL_VERSION = "0.3.10-857014d";
+export declare const COMMIT = "2b2b991";
+export declare const FULL_VERSION = "0.3.12-2b2b991";
 export declare const PACKAGE_NAME: string;

package/lib/types/index.d.mts

@@ -6,6 +6,6 @@
 export * from "./utils.d.mts";
 export * from "./namespaces/index.d.mts";
 export declare const VERSION: string;
-export declare const COMMIT = "857014d";
-export declare const FULL_VERSION = "0.3.10-857014d";
+export declare const COMMIT = "2b2b991";
+export declare const FULL_VERSION = "0.3.12-2b2b991";
 export declare const PACKAGE_NAME: string;

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

@@ -1,62 +1,31 @@
-/**
- * @module integrations/nest/graph/GraphExecutionController
- * @summary NestJS controller bridging the graph execution engine to REST + SSE.
- * @description Exposes three endpoints:
- * - `POST /graph/execute` — triggers {@link GraphExecutionEngine.execute}, persists the result via a Decaf repository, and returns `{ runId, status, outputs }`.
- * - `GET /graph/events` — SSE endpoint streaming {@link GraphExecutionEvent}s as `[modelName, operation, id, payload]` tuples (compatible with for-http's `ServerEventConnector`).
- * - `GET /graph/results/:runId` — retrieves a persisted {@link GraphExecutionResultModel} from the repository.
- *
- * This is the production pattern: for-nest hosts the engine, for-angular consumes events over the network via SSE and fetches persisted results via REST.
- */
 import { MessageEvent } from "@nestjs/common";
 import { Observable } from "rxjs";
 import { GraphExecutionEngine, type GraphExecutionValues } from "../../graph/index.d.cts";
 import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-import { type GraphExecutionResultRepositoryInstance } from "./GraphExecutionResultRepository.d.cts";
-/**
- * NestJS injection token for the graph execution result repository.
- */
-export declare const GRAPH_RESULT_REPOSITORY = "GRAPH_RESULT_REPOSITORY";
-/**
- * Payload for the `POST /graph/execute` endpoint.
- */
+import { DecafRequestContext } from "@decaf-ts/for-nest";
+import { GraphResultService } from "./GraphResultService.d.cts";
+import { GraphWorkflowService } from "./GraphWorkflowService.d.cts";
 export interface GraphExecutePayload {
     workflow: GraphWorkflowDefinition;
     inputs: GraphExecutionValues;
 }
-/**
- * Response shape for the `POST /graph/execute` endpoint.
- */
 export interface GraphExecuteResponse {
     runId: string;
     status: string;
     outputs: Record<string, unknown>;
 }
-/**
- * NestJS controller that hosts the graph execution engine server-side,
- * streams events via SSE, and persists results for later retrieval.
- */
 export declare class GraphExecutionController {
     private readonly engine;
-    private readonly resultRepository;
+    private readonly resultService;
+    private readonly workflowService;
+    private readonly requestContext?;
     private readonly eventSubject;
-    constructor(engine: GraphExecutionEngine, resultRepository: GraphExecutionResultRepositoryInstance);
-    /**
-     * Triggers graph execution server-side, persists the result, and returns
-     * a summary containing the `runId`, `status`, and `outputs`.
-     */
+    constructor(engine: GraphExecutionEngine, resultService: GraphResultService, workflowService: GraphWorkflowService, requestContext?: DecafRequestContext | undefined);
     execute(body: GraphExecutePayload): Promise<GraphExecuteResponse>;
-    /**
-     * SSE endpoint that streams graph execution events.
-     *
-     * Events are serialized as `[modelName, operation, id, payload]` to match
-     * the format expected by for-http's `ServerEventConnector`.
-     */
     events(): Observable<MessageEvent>;
-    /**
-     * Retrieves a persisted graph execution result by its `runId`.
-     *
-     * @throws {NotFoundException} when no result is stored for the given `runId`.
-     */
     getResult(runId: string): Promise<unknown>;
+    saveWorkflow(id: string, snapshot: Record<string, unknown>): Promise<{
+        workflowId: string;
+        savedAt: string;
+    }>;
 }

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

@@ -1,62 +1,31 @@
-/**
- * @module integrations/nest/graph/GraphExecutionController
- * @summary NestJS controller bridging the graph execution engine to REST + SSE.
- * @description Exposes three endpoints:
- * - `POST /graph/execute` — triggers {@link GraphExecutionEngine.execute}, persists the result via a Decaf repository, and returns `{ runId, status, outputs }`.
- * - `GET /graph/events` — SSE endpoint streaming {@link GraphExecutionEvent}s as `[modelName, operation, id, payload]` tuples (compatible with for-http's `ServerEventConnector`).
- * - `GET /graph/results/:runId` — retrieves a persisted {@link GraphExecutionResultModel} from the repository.
- *
- * This is the production pattern: for-nest hosts the engine, for-angular consumes events over the network via SSE and fetches persisted results via REST.
- */
 import { MessageEvent } from "@nestjs/common";
 import { Observable } from "rxjs";
 import { GraphExecutionEngine, type GraphExecutionValues } from "../../graph/index.d.mts";
 import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-import { type GraphExecutionResultRepositoryInstance } from "./GraphExecutionResultRepository.d.mts";
-/**
- * NestJS injection token for the graph execution result repository.
- */
-export declare const GRAPH_RESULT_REPOSITORY = "GRAPH_RESULT_REPOSITORY";
-/**
- * Payload for the `POST /graph/execute` endpoint.
- */
+import { DecafRequestContext } from "@decaf-ts/for-nest";
+import { GraphResultService } from "./GraphResultService.d.mts";
+import { GraphWorkflowService } from "./GraphWorkflowService.d.mts";
 export interface GraphExecutePayload {
     workflow: GraphWorkflowDefinition;
     inputs: GraphExecutionValues;
 }
-/**
- * Response shape for the `POST /graph/execute` endpoint.
- */
 export interface GraphExecuteResponse {
     runId: string;
     status: string;
     outputs: Record<string, unknown>;
 }
-/**
- * NestJS controller that hosts the graph execution engine server-side,
- * streams events via SSE, and persists results for later retrieval.
- */
 export declare class GraphExecutionController {
     private readonly engine;
-    private readonly resultRepository;
+    private readonly resultService;
+    private readonly workflowService;
+    private readonly requestContext?;
     private readonly eventSubject;
-    constructor(engine: GraphExecutionEngine, resultRepository: GraphExecutionResultRepositoryInstance);
-    /**
-     * Triggers graph execution server-side, persists the result, and returns
-     * a summary containing the `runId`, `status`, and `outputs`.
-     */
+    constructor(engine: GraphExecutionEngine, resultService: GraphResultService, workflowService: GraphWorkflowService, requestContext?: DecafRequestContext | undefined);
     execute(body: GraphExecutePayload): Promise<GraphExecuteResponse>;
-    /**
-     * SSE endpoint that streams graph execution events.
-     *
-     * Events are serialized as `[modelName, operation, id, payload]` to match
-     * the format expected by for-http's `ServerEventConnector`.
-     */
     events(): Observable<MessageEvent>;
-    /**
-     * Retrieves a persisted graph execution result by its `runId`.
-     *
-     * @throws {NotFoundException} when no result is stored for the given `runId`.
-     */
     getResult(runId: string): Promise<unknown>;
+    saveWorkflow(id: string, snapshot: Record<string, unknown>): Promise<{
+        workflowId: string;
+        savedAt: string;
+    }>;
 }

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

@@ -1,39 +1,19 @@
-/**
- * @module integrations/nest/graph/GraphExecutionModule
- * @summary NestJS DynamicModule hosting the graph execution engine.
- * @description Wires the {@link GraphExecutionEngine}, a demo executor registry, a RamAdapter-backed result repository, and the {@link GraphExecutionController} into a single NestJS module. Use `GraphExecutionModule.forRoot()` to register it in the application.
- */
 import { DynamicModule } from "@nestjs/common";
-/**
- * Options for {@link GraphExecutionModule.forRoot}.
- */
 export interface GraphExecutionModuleOptions {
     /**
-     * User identifier passed to the RamAdapter. Defaults to `"graph-engine"`.
+     * 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.
      */
-    adapterUser?: string;
+    initAdapter?: boolean;
     /**
-     * When `true`, calls `RamAdapter.decoration()` and
-     * `Adapter.setCurrent(RamFlavour)` during module initialisation. Defaults to
-     * `true`. Set to `false` when the host application has already configured a
-     * RamAdapter.
+     * Adapter user identifier passed to `RamAdapter` when `initAdapter` is
+     * `true`. Ignored when `initAdapter` is `false`.
+     * Defaults to `"graph-engine"`.
      */
-    initAdapter?: boolean;
+    adapterUser?: string;
 }
-/**
- * NestJS module that hosts the graph execution engine server-side.
- *
- * Provides:
- * - {@link GraphExecutionEngine} — singleton engine with a demo executor registry.
- * - `GRAPH_RESULT_REPOSITORY` — Decaf repository for {@link GraphExecutionResultModel} backed by RamAdapter.
- * - {@link GraphExecutionController} — REST + SSE controller.
- */
 export declare class GraphExecutionModule {
-    /**
-     * Creates a configured {@link DynamicModule} for the graph execution backend.
-     *
-     * @param options - Module configuration options.
-     * @returns A NestJS `DynamicModule` ready for import.
-     */
     static forRoot(options?: GraphExecutionModuleOptions): DynamicModule;
 }

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

@@ -1,39 +1,19 @@
-/**
- * @module integrations/nest/graph/GraphExecutionModule
- * @summary NestJS DynamicModule hosting the graph execution engine.
- * @description Wires the {@link GraphExecutionEngine}, a demo executor registry, a RamAdapter-backed result repository, and the {@link GraphExecutionController} into a single NestJS module. Use `GraphExecutionModule.forRoot()` to register it in the application.
- */
 import { DynamicModule } from "@nestjs/common";
-/**
- * Options for {@link GraphExecutionModule.forRoot}.
- */
 export interface GraphExecutionModuleOptions {
     /**
-     * User identifier passed to the RamAdapter. Defaults to `"graph-engine"`.
+     * 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.
      */
-    adapterUser?: string;
+    initAdapter?: boolean;
     /**
-     * When `true`, calls `RamAdapter.decoration()` and
-     * `Adapter.setCurrent(RamFlavour)` during module initialisation. Defaults to
-     * `true`. Set to `false` when the host application has already configured a
-     * RamAdapter.
+     * Adapter user identifier passed to `RamAdapter` when `initAdapter` is
+     * `true`. Ignored when `initAdapter` is `false`.
+     * Defaults to `"graph-engine"`.
      */
-    initAdapter?: boolean;
+    adapterUser?: string;
 }
-/**
- * NestJS module that hosts the graph execution engine server-side.
- *
- * Provides:
- * - {@link GraphExecutionEngine} — singleton engine with a demo executor registry.
- * - `GRAPH_RESULT_REPOSITORY` — Decaf repository for {@link GraphExecutionResultModel} backed by RamAdapter.
- * - {@link GraphExecutionController} — REST + SSE controller.
- */
 export declare class GraphExecutionModule {
-    /**
-     * Creates a configured {@link DynamicModule} for the graph execution backend.
-     *
-     * @param options - Module configuration options.
-     * @returns A NestJS `DynamicModule` ready for import.
-     */
     static forRoot(options?: GraphExecutionModuleOptions): DynamicModule;
 }

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

@@ -1,46 +1,12 @@
-/**
- * @module integrations/nest/graph/GraphExecutionResultModel
- * @summary Decaf model for persisting graph execution results.
- * @description Serializes a {@link GraphExecutionResult} for storage in a Decaf persistence adapter (e.g. RamAdapter). Stores the run id, workflow id, status, inputs, outputs, per-node results, and timing information so clients can retrieve a completed run's full state via `GET /graph/results/:runId`.
- */
 import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
-/**
- * Persisted representation of a completed graph execution run.
- *
- * Stored in the `graph_execution_result` table and keyed by `runId`.
- */
 export declare class GraphExecutionResultModel extends Model {
-    /**
-     * Unique identifier for this execution run. Acts as the primary key.
-     */
     runId: string;
-    /**
-     * Identifier of the workflow that was executed.
-     */
     workflowId: string;
-    /**
-     * Final status of the run (e.g. `succeeded`, `failed`).
-     */
     status: string;
-    /**
-     * Inputs supplied to the workflow at execution time.
-     */
     inputs: Record<string, unknown>;
-    /**
-     * Outputs produced by the workflow.
-     */
     outputs: Record<string, unknown>;
-    /**
-     * Per-node execution results keyed by node id.
-     */
     nodeResults: Record<string, unknown>;
-    /**
-     * Timestamp marking when the run started.
-     */
     startedAt: Date;
-    /**
-     * Timestamp marking when the run finished.
-     */
     finishedAt?: Date;
     constructor(arg?: ModelArg<GraphExecutionResultModel>);
 }

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

@@ -1,46 +1,12 @@
-/**
- * @module integrations/nest/graph/GraphExecutionResultModel
- * @summary Decaf model for persisting graph execution results.
- * @description Serializes a {@link GraphExecutionResult} for storage in a Decaf persistence adapter (e.g. RamAdapter). Stores the run id, workflow id, status, inputs, outputs, per-node results, and timing information so clients can retrieve a completed run's full state via `GET /graph/results/:runId`.
- */
 import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
-/**
- * Persisted representation of a completed graph execution run.
- *
- * Stored in the `graph_execution_result` table and keyed by `runId`.
- */
 export declare class GraphExecutionResultModel extends Model {
-    /**
-     * Unique identifier for this execution run. Acts as the primary key.
-     */
     runId: string;
-    /**
-     * Identifier of the workflow that was executed.
-     */
     workflowId: string;
-    /**
-     * Final status of the run (e.g. `succeeded`, `failed`).
-     */
     status: string;
-    /**
-     * Inputs supplied to the workflow at execution time.
-     */
     inputs: Record<string, unknown>;
-    /**
-     * Outputs produced by the workflow.
-     */
     outputs: Record<string, unknown>;
-    /**
-     * Per-node execution results keyed by node id.
-     */
     nodeResults: Record<string, unknown>;
-    /**
-     * Timestamp marking when the run started.
-     */
     startedAt: Date;
-    /**
-     * Timestamp marking when the run finished.
-     */
     finishedAt?: Date;
     constructor(arg?: ModelArg<GraphExecutionResultModel>);
 }

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

@@ -3,9 +3,10 @@
  * @summary Factory that builds a populated {@link GraphNodeExecutorRegistry}.
  * @description Creates a registry pre-loaded with the demo executors used by
  * the graph execution backend's sample workflows. The executors cover the
- * publishing-workflow node tags, the flow-control kinds, the agent kind, and
- * the loop kinds. Additional executors can be registered on the returned
- * registry before it is handed to the {@link GraphExecutionEngine}.
+ * flow-control kinds (including Code, Log, and Switch with code conditions),
+ * the agent kind, and the loop kinds. Additional executors can be registered
+ * on the returned registry before it is handed to the
+ * {@link GraphExecutionEngine}.
  */
 import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor, IsolatedVmCodeSandboxEvaluator } from "../../graph/index.d.cts";
 /**
@@ -18,12 +19,11 @@ import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor
  *
  * Registered kinds:
  * - `math.add`, `math.multiply` — arithmetic demo executors.
- * - `graph-intake-workflow`, `graph-planning-pipeline`, `graph-draft-node`,
- *   `graph-review-node`, `graph-publish-workflow` — publishing workflow demo.
- * - `core.flow.*` — flow-control kinds (map, delay, return, merge, if, switch,
- *   parallel, errorBoundary, humanApproval). The `core.flow.code` kind is
- *   registered in `onEngineCreated` via the real {@link CodeGraphNodeExecutor}
- *   because it needs the engine's `codeSandboxEvaluator`.
+ * - `core.flow.*` — flow-control kinds (map, delay, return, merge, if,
+ *   parallel, errorBoundary, humanApproval). The `core.flow.code`,
+ *   `core.flow.log`, and `core.flow.switch` kinds are registered in
+ *   `onEngineCreated` via their real executors because Code and Switch
+ *   need the engine's `codeSandboxEvaluator`.
  * - `core.agent` — agent node.
  * - `core.loop.foreach`, `core.loop.while`, `core.loop.until` — loop executors
  *   (registered after the engine is created via `onEngineCreated`).

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

@@ -3,9 +3,10 @@
  * @summary Factory that builds a populated {@link GraphNodeExecutorRegistry}.
  * @description Creates a registry pre-loaded with the demo executors used by
  * the graph execution backend's sample workflows. The executors cover the
- * publishing-workflow node tags, the flow-control kinds, the agent kind, and
- * the loop kinds. Additional executors can be registered on the returned
- * registry before it is handed to the {@link GraphExecutionEngine}.
+ * flow-control kinds (including Code, Log, and Switch with code conditions),
+ * the agent kind, and the loop kinds. Additional executors can be registered
+ * on the returned registry before it is handed to the
+ * {@link GraphExecutionEngine}.
  */
 import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor, IsolatedVmCodeSandboxEvaluator } from "../../graph/index.d.mts";
 /**
@@ -18,12 +19,11 @@ import { GraphNodeExecutorRegistry, GraphExecutionEngine, type GraphNodeExecutor
  *
  * Registered kinds:
  * - `math.add`, `math.multiply` — arithmetic demo executors.
- * - `graph-intake-workflow`, `graph-planning-pipeline`, `graph-draft-node`,
- *   `graph-review-node`, `graph-publish-workflow` — publishing workflow demo.
- * - `core.flow.*` — flow-control kinds (map, delay, return, merge, if, switch,
- *   parallel, errorBoundary, humanApproval). The `core.flow.code` kind is
- *   registered in `onEngineCreated` via the real {@link CodeGraphNodeExecutor}
- *   because it needs the engine's `codeSandboxEvaluator`.
+ * - `core.flow.*` — flow-control kinds (map, delay, return, merge, if,
+ *   parallel, errorBoundary, humanApproval). The `core.flow.code`,
+ *   `core.flow.log`, and `core.flow.switch` kinds are registered in
+ *   `onEngineCreated` via their real executors because Code and Switch
+ *   need the engine's `codeSandboxEvaluator`.
  * - `core.agent` — agent node.
  * - `core.loop.foreach`, `core.loop.while`, `core.loop.until` — loop executors
  *   (registered after the engine is created via `onEngineCreated`).

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

@@ -0,0 +1,8 @@
+import { ModelService, type Context, type MaybeContextualArg } from "@decaf-ts/core";
+import { GraphExecutionResultModel } from "./GraphExecutionResultModel.d.cts";
+import type { GraphExecutionResult } from "../../graph/index.d.cts";
+export declare class GraphResultService extends ModelService<GraphExecutionResultModel> {
+    constructor();
+    saveResult(result: GraphExecutionResult, ...args: MaybeContextualArg<Context>): Promise<GraphExecutionResultModel>;
+    findByRunId(runId: string, ...args: MaybeContextualArg<Context>): Promise<GraphExecutionResultModel | null>;
+}

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

@@ -0,0 +1,8 @@
+import { ModelService, type Context, type MaybeContextualArg } from "@decaf-ts/core";
+import { GraphExecutionResultModel } from "./GraphExecutionResultModel.d.mts";
+import type { GraphExecutionResult } from "../../graph/index.d.mts";
+export declare class GraphResultService extends ModelService<GraphExecutionResultModel> {
+    constructor();
+    saveResult(result: GraphExecutionResult, ...args: MaybeContextualArg<Context>): Promise<GraphExecutionResultModel>;
+    findByRunId(runId: string, ...args: MaybeContextualArg<Context>): Promise<GraphExecutionResultModel | null>;
+}

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

@@ -0,0 +1,7 @@
+import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
+export declare class GraphWorkflowModel extends Model {
+    workflowId: string;
+    snapshot: Record<string, unknown>;
+    updatedAt: Date;
+    constructor(arg?: ModelArg<GraphWorkflowModel>);
+}

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

@@ -0,0 +1,7 @@
+import { Model, type ModelArg } from "@decaf-ts/decorator-validation";
+export declare class GraphWorkflowModel extends Model {
+    workflowId: string;
+    snapshot: Record<string, unknown>;
+    updatedAt: Date;
+    constructor(arg?: ModelArg<GraphWorkflowModel>);
+}

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

@@ -0,0 +1,7 @@
+import { ModelService, type Context, type MaybeContextualArg } from "@decaf-ts/core";
+import { GraphWorkflowModel } from "./GraphWorkflowModel.d.cts";
+export declare class GraphWorkflowService extends ModelService<GraphWorkflowModel> {
+    constructor();
+    saveSnapshot(workflowId: string, snapshot: Record<string, unknown>, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowModel>;
+    loadSnapshot(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowModel | null>;
+}