@decaf-ts/integrations 0.10.4 → 0.10.8

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

@@ -0,0 +1,23 @@
+import type { NodeMetadataChange, SwitchNodeMetadata } from "@decaf-ts/ui-decorators/graph";
+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 SwitchFlowNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    value: unknown;
+    default: unknown;
+    /**
+     * 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
+     * `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.
+     *
+     * @param meta - The switch metadata patch (`metadata.switch`), carrying
+     *   the cases and the optional default-port configuration.
+     * @returns The computed {@link NodeMetadataChange}: reordered ports
+     *   (case outputs inserted before the optional default), the grown size,
+     *   and the `switchMetadata` data patch.
+     */
+    static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
+}

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

@@ -0,0 +1,23 @@
+import type { NodeMetadataChange, SwitchNodeMetadata } from "@decaf-ts/ui-decorators/graph";
+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 SwitchFlowNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    value: unknown;
+    default: unknown;
+    /**
+     * 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
+     * `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.
+     *
+     * @param meta - The switch metadata patch (`metadata.switch`), carrying
+     *   the cases and the optional default-port configuration.
+     * @returns The computed {@link NodeMetadataChange}: reordered ports
+     *   (case outputs inserted before the optional default), the grown size,
+     *   and the `switchMetadata` data patch.
+     */
+    static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
+}

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

@@ -0,0 +1,93 @@
+/**
+ * @module integrations/graph/nodes
+ * @summary Shared node kind declarations (DECAF-32 §22.2, DECAF-50 Phase A).
+ * @description Canonical `@node`-decorated classes for the ALFRED-5 node kind
+ * taxonomy, laid out one node per file under `nodes/<category>/<node>.ts`:
+ * triggers (§22.2.1), flow-control and utility nodes (§22.2.2–22.2.3), the
+ * Agent node (§21.3), the three loop kinds (`core.loop.foreach/while/until`,
+ * §5.9), and the workflow input-value boundary node. Shared non-node support
+ * (the base class and manifests) lives in sibling files under the same tree;
+ * category styles remain in `@decaf-ts/ui-decorators` (`graph/category-styles`).
+ * Consumers (for-angular, ALFRED, etc.) import these declarations
+ * to populate node palettes, registries, and reference snapshots.
+ */
+export * from "./base.d.cts";
+export * from "./flow-control/break.d.cts";
+export * from "./flow-control/error-boundary.d.cts";
+export * from "./flow-control/human-approval.d.cts";
+export * from "./flow-control/if.d.cts";
+export * from "./flow-control/parallel.d.cts";
+export * from "./flow-control/switch.d.cts";
+export * from "./utility/code.d.cts";
+export * from "./utility/delay.d.cts";
+export * from "./utility/log.d.cts";
+export * from "./utility/map.d.cts";
+export * from "./utility/merge.d.cts";
+export * from "./utility/return.d.cts";
+export * from "./utility/utility-log.d.cts";
+export * from "./triggers/chat.d.cts";
+export * from "./triggers/event.d.cts";
+export * from "./triggers/form.d.cts";
+export * from "./triggers/manual.d.cts";
+export * from "./triggers/schedule.d.cts";
+export * from "./triggers/webhook.d.cts";
+export * from "./agents/agent.d.cts";
+export * from "./loops/foreach.d.cts";
+export * from "./loops/until.d.cts";
+export * from "./loops/while.d.cts";
+export * from "./boundary/input-value.d.cts";
+export * from "./manifests.d.cts";
+import type { GraphNodeClass } from "./base.d.cts";
+import { BreakFlowNode } from "./flow-control/break.d.cts";
+import { ErrorBoundaryFlowNode } from "./flow-control/error-boundary.d.cts";
+import { HumanApprovalFlowNode } from "./flow-control/human-approval.d.cts";
+import { IfFlowNode } from "./flow-control/if.d.cts";
+import { ParallelFlowNode } from "./flow-control/parallel.d.cts";
+import { SwitchFlowNode } from "./flow-control/switch.d.cts";
+import { CodeNode } from "./utility/code.d.cts";
+import { DelayFlowNode } from "./utility/delay.d.cts";
+import { LogFlowNode } from "./utility/log.d.cts";
+import { MapNode } from "./utility/map.d.cts";
+import { MergeFlowNode } from "./utility/merge.d.cts";
+import { ReturnFlowNode } from "./utility/return.d.cts";
+import { UtilityLogNode } from "./utility/utility-log.d.cts";
+import { ChatTriggerNode } from "./triggers/chat.d.cts";
+import { EventTriggerNode } from "./triggers/event.d.cts";
+import { FormTriggerNode } from "./triggers/form.d.cts";
+import { ManualTriggerNode } from "./triggers/manual.d.cts";
+import { ScheduleTriggerNode } from "./triggers/schedule.d.cts";
+import { WebhookTriggerNode } from "./triggers/webhook.d.cts";
+import { GraphForeachLoopNode } from "./loops/foreach.d.cts";
+import { GraphUntilLoopNode } from "./loops/until.d.cts";
+import { GraphWhileLoopNode } from "./loops/while.d.cts";
+import { GraphInputValueNode } from "./boundary/input-value.d.cts";
+/**
+ * All built-in trigger node constructors.
+ */
+export declare const GRAPH_TRIGGER_NODES: readonly [typeof ManualTriggerNode, typeof WebhookTriggerNode, typeof ScheduleTriggerNode, typeof EventTriggerNode, typeof FormTriggerNode, typeof ChatTriggerNode];
+/**
+ * All built-in flow-control node constructors (branching/routing/looping/
+ * termination semantics).
+ */
+export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof LogFlowNode, typeof BreakFlowNode];
+/**
+ * All built-in utility node constructors (side-effect/data-transformation
+ * semantics — no branching).
+ */
+export declare const GRAPH_UTILITY_NODES: readonly [typeof CodeNode, typeof MapNode, typeof UtilityLogNode];
+/**
+ * All built-in loop node constructors (shared declarations of the
+ * `core.loop.*` system kinds).
+ */
+export declare const GRAPH_LOOP_NODES: readonly [typeof GraphForeachLoopNode, typeof GraphWhileLoopNode, typeof GraphUntilLoopNode];
+/**
+ * All built-in boundary node constructors.
+ */
+export declare const GRAPH_BOUNDARY_NODES: readonly [typeof GraphInputValueNode];
+/**
+ * Kind→class map for every built-in node kind the backend executes
+ * (DECAF-50 §4.26 R2-1). The catalogue derives each registration's
+ * manifest and executor from the class, so this is the single authority for
+ * built-in node behaviour.
+ */
+export declare const GRAPH_BUILT_IN_NODE_CLASSES_BY_KIND: Record<string, GraphNodeClass>;

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

@@ -0,0 +1,93 @@
+/**
+ * @module integrations/graph/nodes
+ * @summary Shared node kind declarations (DECAF-32 §22.2, DECAF-50 Phase A).
+ * @description Canonical `@node`-decorated classes for the ALFRED-5 node kind
+ * taxonomy, laid out one node per file under `nodes/<category>/<node>.ts`:
+ * triggers (§22.2.1), flow-control and utility nodes (§22.2.2–22.2.3), the
+ * Agent node (§21.3), the three loop kinds (`core.loop.foreach/while/until`,
+ * §5.9), and the workflow input-value boundary node. Shared non-node support
+ * (the base class and manifests) lives in sibling files under the same tree;
+ * category styles remain in `@decaf-ts/ui-decorators` (`graph/category-styles`).
+ * Consumers (for-angular, ALFRED, etc.) import these declarations
+ * to populate node palettes, registries, and reference snapshots.
+ */
+export * from "./base.d.mts";
+export * from "./flow-control/break.d.mts";
+export * from "./flow-control/error-boundary.d.mts";
+export * from "./flow-control/human-approval.d.mts";
+export * from "./flow-control/if.d.mts";
+export * from "./flow-control/parallel.d.mts";
+export * from "./flow-control/switch.d.mts";
+export * from "./utility/code.d.mts";
+export * from "./utility/delay.d.mts";
+export * from "./utility/log.d.mts";
+export * from "./utility/map.d.mts";
+export * from "./utility/merge.d.mts";
+export * from "./utility/return.d.mts";
+export * from "./utility/utility-log.d.mts";
+export * from "./triggers/chat.d.mts";
+export * from "./triggers/event.d.mts";
+export * from "./triggers/form.d.mts";
+export * from "./triggers/manual.d.mts";
+export * from "./triggers/schedule.d.mts";
+export * from "./triggers/webhook.d.mts";
+export * from "./agents/agent.d.mts";
+export * from "./loops/foreach.d.mts";
+export * from "./loops/until.d.mts";
+export * from "./loops/while.d.mts";
+export * from "./boundary/input-value.d.mts";
+export * from "./manifests.d.mts";
+import type { GraphNodeClass } from "./base.d.mts";
+import { BreakFlowNode } from "./flow-control/break.d.mts";
+import { ErrorBoundaryFlowNode } from "./flow-control/error-boundary.d.mts";
+import { HumanApprovalFlowNode } from "./flow-control/human-approval.d.mts";
+import { IfFlowNode } from "./flow-control/if.d.mts";
+import { ParallelFlowNode } from "./flow-control/parallel.d.mts";
+import { SwitchFlowNode } from "./flow-control/switch.d.mts";
+import { CodeNode } from "./utility/code.d.mts";
+import { DelayFlowNode } from "./utility/delay.d.mts";
+import { LogFlowNode } from "./utility/log.d.mts";
+import { MapNode } from "./utility/map.d.mts";
+import { MergeFlowNode } from "./utility/merge.d.mts";
+import { ReturnFlowNode } from "./utility/return.d.mts";
+import { UtilityLogNode } from "./utility/utility-log.d.mts";
+import { ChatTriggerNode } from "./triggers/chat.d.mts";
+import { EventTriggerNode } from "./triggers/event.d.mts";
+import { FormTriggerNode } from "./triggers/form.d.mts";
+import { ManualTriggerNode } from "./triggers/manual.d.mts";
+import { ScheduleTriggerNode } from "./triggers/schedule.d.mts";
+import { WebhookTriggerNode } from "./triggers/webhook.d.mts";
+import { GraphForeachLoopNode } from "./loops/foreach.d.mts";
+import { GraphUntilLoopNode } from "./loops/until.d.mts";
+import { GraphWhileLoopNode } from "./loops/while.d.mts";
+import { GraphInputValueNode } from "./boundary/input-value.d.mts";
+/**
+ * All built-in trigger node constructors.
+ */
+export declare const GRAPH_TRIGGER_NODES: readonly [typeof ManualTriggerNode, typeof WebhookTriggerNode, typeof ScheduleTriggerNode, typeof EventTriggerNode, typeof FormTriggerNode, typeof ChatTriggerNode];
+/**
+ * All built-in flow-control node constructors (branching/routing/looping/
+ * termination semantics).
+ */
+export declare const GRAPH_FLOW_CONTROL_NODES: readonly [typeof IfFlowNode, typeof SwitchFlowNode, typeof ParallelFlowNode, typeof MergeFlowNode, typeof DelayFlowNode, typeof ErrorBoundaryFlowNode, typeof HumanApprovalFlowNode, typeof ReturnFlowNode, typeof LogFlowNode, typeof BreakFlowNode];
+/**
+ * All built-in utility node constructors (side-effect/data-transformation
+ * semantics — no branching).
+ */
+export declare const GRAPH_UTILITY_NODES: readonly [typeof CodeNode, typeof MapNode, typeof UtilityLogNode];
+/**
+ * All built-in loop node constructors (shared declarations of the
+ * `core.loop.*` system kinds).
+ */
+export declare const GRAPH_LOOP_NODES: readonly [typeof GraphForeachLoopNode, typeof GraphWhileLoopNode, typeof GraphUntilLoopNode];
+/**
+ * All built-in boundary node constructors.
+ */
+export declare const GRAPH_BOUNDARY_NODES: readonly [typeof GraphInputValueNode];
+/**
+ * Kind→class map for every built-in node kind the backend executes
+ * (DECAF-50 §4.26 R2-1). The catalogue derives each registration's
+ * manifest and executor from the class, so this is the single authority for
+ * built-in node behaviour.
+ */
+export declare const GRAPH_BUILT_IN_NODE_CLASSES_BY_KIND: Record<string, GraphNodeClass>;

package/lib/types/graph/nodes/loops/foreach.d.cts

@@ -0,0 +1,11 @@
+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 GraphForeachLoopNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    items: unknown[];
+    slice: number;
+    item: unknown;
+    loop: unknown;
+    completed: unknown[];
+}

package/lib/types/graph/nodes/loops/foreach.d.mts

@@ -0,0 +1,11 @@
+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 GraphForeachLoopNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    items: unknown[];
+    slice: number;
+    item: unknown;
+    loop: unknown;
+    completed: unknown[];
+}

package/lib/types/graph/nodes/loops/loop-metadata.d.cts

@@ -0,0 +1,20 @@
+/**
+ * @module integrations/graph/nodes/loops/loop-metadata
+ * @summary Shared loop-metadata extraction for backend loop node classes.
+ * @description Reads a loop node's effective {@link GraphLoopMetadata} from the
+ * canonical node instance (`parameters` plus the `loop` configuration) with the
+ * execution metadata `loop` bag as the legacy fallback. Shared by the
+ * `core.loop.foreach` / `core.loop.while` / `core.loop.until` node classes so
+ * their `execute` methods read loop configuration identically.
+ */
+import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.cts";
+import type { GraphLoopMetadata } from "../../engine/types.d.cts";
+/**
+ * Extracts the loop metadata for the executing loop node.
+ *
+ * @param context - The run-scoped execution context for the loop node.
+ * @param label - The loop kind label used in error messages.
+ * @returns The effective loop metadata (body, limits, ports, condition).
+ * @throws {GraphInputError} when the node carries no loop body configuration.
+ */
+export declare function extractLoopMetadata(context: GraphExecutionContext, label: string): GraphLoopMetadata;

package/lib/types/graph/nodes/loops/loop-metadata.d.mts

@@ -0,0 +1,20 @@
+/**
+ * @module integrations/graph/nodes/loops/loop-metadata
+ * @summary Shared loop-metadata extraction for backend loop node classes.
+ * @description Reads a loop node's effective {@link GraphLoopMetadata} from the
+ * canonical node instance (`parameters` plus the `loop` configuration) with the
+ * execution metadata `loop` bag as the legacy fallback. Shared by the
+ * `core.loop.foreach` / `core.loop.while` / `core.loop.until` node classes so
+ * their `execute` methods read loop configuration identically.
+ */
+import type { GraphExecutionContext } from "../../engine/execution/GraphExecutionContext.d.mts";
+import type { GraphLoopMetadata } from "../../engine/types.d.mts";
+/**
+ * Extracts the loop metadata for the executing loop node.
+ *
+ * @param context - The run-scoped execution context for the loop node.
+ * @param label - The loop kind label used in error messages.
+ * @returns The effective loop metadata (body, limits, ports, condition).
+ * @throws {GraphInputError} when the node carries no loop body configuration.
+ */
+export declare function extractLoopMetadata(context: GraphExecutionContext, label: string): GraphLoopMetadata;

package/lib/types/graph/nodes/loops/until.d.cts

@@ -0,0 +1,8 @@
+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 GraphUntilLoopNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    state: unknown;
+    stateOut: unknown;
+}

package/lib/types/graph/nodes/loops/until.d.mts

@@ -0,0 +1,8 @@
+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 GraphUntilLoopNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    state: unknown;
+    stateOut: unknown;
+}

package/lib/types/graph/nodes/loops/while.d.cts

@@ -0,0 +1,8 @@
+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 GraphWhileLoopNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    state: unknown;
+    stateOut: unknown;
+}

package/lib/types/graph/nodes/loops/while.d.mts

@@ -0,0 +1,8 @@
+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 GraphWhileLoopNode extends GraphNode {
+    static execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    state: unknown;
+    stateOut: unknown;
+}

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

@@ -0,0 +1,62 @@
+/**
+ * @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/manifests.d.mts

@@ -0,0 +1,62 @@
+/**
+ * @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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,36 @@
+/**
+ * @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;
+}