@decaf-ts/integrations 0.10.4 → 0.10.8

package/lib/esm/graph/nodes/agents/agent.js

@@ -0,0 +1,109 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/agents/agent
+ * @summary Production Agent node declaration.
+ * @description The Agent node is the primary AI agent entrypoint. It is a
+ * rectangular node with `@connection()` ports for its structural
+ * dependencies: `model` (the LLM), `memory` (the memory store), and
+ * `workspace` (the workspace/context). Connections are rendered on the
+ * bottom side of the node (DECAF-32 §21.3). Each connection category has a
+ * distinct color defined in the category style registry.
+ *
+ * The single `prompt` input accepts placeholder expressions (§22.4) such as
+ * `{{ $input.brief }}` or `{{ $node["Research"].output.summary }}` that are
+ * resolved at execution time by the placeholder compiler.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { connection, input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+/**
+ * Agent node — an AI agent that orchestrates a model, memory, and workspace.
+ *
+ * The agent has:
+ * - `@input` port on the **left**: `prompt` (the task prompt; supports
+ *   placeholder expressions like `{{ $input.something }}` per §22.4).
+ * - `@output` ports on the **right**: `response` (the agent's output), `actions`
+ *   (any actions the agent decided to take).
+ * - `@connection` ports on the **bottom**: `model` (LLM), `memory` (memory
+ *   store), `workspace` (workspace/context). Each connection has a distinct
+ *   category color.
+ *
+ * The node is rectangular (not rounded) to visually distinguish it from
+ * regular processing nodes. The `color` and `icon` are omitted from `@node()`
+ * so they are resolved from the `"Agent"` category style.
+ */
+let AgentNode = class AgentNode extends GraphNode {
+    static execute(request) {
+        return {
+            response: `[Agent response] ${String(request.inputs["prompt"] ?? "")}`,
+            actions: [],
+        };
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Prompt",
+        placeholder: 'Enter task prompt. Supports placeholders like {{ $input.brief }} or {{ $node["Research"].output.summary }}',
+    }),
+    input({ handle: "prompt" }),
+    __metadata("design:type", String)
+], AgentNode.prototype, "prompt", void 0);
+__decorate([
+    required(),
+    uielement("textarea", { label: "Response", placeholder: "Agent response" }),
+    output({ handle: "response" }),
+    __metadata("design:type", String)
+], AgentNode.prototype, "response", void 0);
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Actions",
+        placeholder: "Actions taken by the agent",
+    }),
+    output({ handle: "actions" }),
+    __metadata("design:type", Array)
+], AgentNode.prototype, "actions", void 0);
+__decorate([
+    connection({ category: "model", handle: "model" }),
+    __metadata("design:type", Object)
+], AgentNode.prototype, "model", void 0);
+__decorate([
+    connection({ category: "memory", handle: "memory" }),
+    __metadata("design:type", Object)
+], AgentNode.prototype, "memory", void 0);
+__decorate([
+    connection({ category: "workspace", handle: "workspace" }),
+    __metadata("design:type", Object)
+], AgentNode.prototype, "workspace", void 0);
+AgentNode = __decorate([
+    node("core.agent", {
+        kind: "core.agent",
+        category: "Agent",
+        // color and icon omitted — resolved from the "Agent" category style
+        width: 140,
+        height: 120,
+        labels: ["agent", "ai", "orchestrator"],
+        metadata: {
+            title: "Agent",
+            description: "AI agent that orchestrates a model, memory, and workspace to complete a task.",
+            shape: "rectangle",
+        },
+    }),
+    model()
+], AgentNode);
+export { AgentNode };
+/**
+ * All built-in agent node constructors.
+ */
+export const GRAPH_AGENT_NODES = [AgentNode];
+//# sourceMappingURL=agent.js.map

package/lib/esm/graph/nodes/agents/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/agents/agent.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAMpC;;;;;;;;;;;;;;;GAeG;AAgBI,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,SAAS;IACtC,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO;YACL,QAAQ,EAAE,oBAAoB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE;YACtE,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;CAsCF,CAAA;AA3BC;IAPC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,4GAA4G;KAC/G,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;;yCACZ;AAOhB;IAHC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;;2CACb;AAQlB;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,4BAA4B;KAC1C,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;;0CACV;AAKpB;IADC,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;wCACnC;AAGhB;IADC,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;;yCACpC;AAGjB;IADC,UAAU,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;;4CACvC;AA3CT,SAAS;IAfrB,IAAI,CAAC,YAAY,EAAE;QAClB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,OAAO;QACjB,oEAAoE;QACpE,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC;QACvC,QAAQ,EAAE;YACR,KAAK,EAAE,OAAO;YACd,WAAW,EACT,+EAA+E;YACjF,KAAK,EAAE,WAAW;SACnB;KACF,CAAC;IACD,KAAK,EAAE;GACK,SAAS,CA4CrB;;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,CAAU,CAAC"}

package/lib/esm/graph/nodes/base.js

@@ -0,0 +1,56 @@
+/**
+ * @module integrations/graph/nodes/base
+ * @summary Base class for backend graph node declarations.
+ * @description `GraphNode` is the single authoritative backend representation of
+ * a built-in node kind (DECAF-50 §4.26 R2-1): the `@node`-decorated class
+ * carries both the published manifest metadata and the executable behaviour via
+ * `execute`. The catalogue derives each kind's executor from the class, so there
+ * is exactly one authority per node kind.
+ */
+import { Model } from "@decaf-ts/decorator-validation";
+import { GraphExecutionError } from "./../engine/errors/GraphExecutionError.js";
+/**
+ * Base class for the built-in backend node kinds.
+ *
+ * Extends `Model` so the `@node`/`@uielement` decorators and the manifest
+ * compiler keep working unchanged. Concrete kinds override `execute`; the default
+ * throws so a kind that forgets to implement behaviour fails fast rather than
+ * silently producing no output.
+ */
+export class GraphNode extends Model {
+    /**
+     * Executes the node's behaviour against the request inputs and run context.
+     *
+     * @param _request - The node execution request (inputs, parameters,
+     * credentials, metadata).
+     * @param _context - The run-scoped execution context.
+     * @returns The node's output values keyed by port name.
+     * @throws {GraphExecutionError} when the kind does not implement `execute`.
+     */
+    static execute(
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _request, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _context) {
+        throw new GraphExecutionError(`Graph node kind '${this.name}' does not implement execute`, "GRAPH_NODE_EXECUTE_NOT_IMPLEMENTED", { kind: this.name });
+    }
+    /**
+     * Applies a metadata patch to this node class, returning the resulting
+     * ports, size, and data patches.
+     *
+     * The default implementation returns `null` (no changes). Concrete node
+     * kinds that support dynamic metadata override this to compute their own
+     * ports and size from the metadata — the caller (renderer) simply relays
+     * the result to the diagram model.
+     *
+     * @param _meta - The metadata patch (node-kind-specific, e.g.
+     *   `SwitchNodeMetadata`).
+     * @returns The computed change, or `null` when the node kind does not
+     *   support dynamic metadata.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static applyMetadata(_meta) {
+        return null;
+    }
+}
+//# sourceMappingURL=base.js.map

package/lib/esm/graph/nodes/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/graph/nodes/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAOvD,OAAO,EAAE,mBAAmB,EAAE,kDAA6C;AAgB3E;;;;;;;GAOG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC;;;;;;;;OAQG;IAEH,MAAM,CAAC,OAAO;IACZ,6DAA6D;IAC7D,QAAmC;IACnC,6DAA6D;IAC7D,QAA+B;QAE/B,MAAM,IAAI,mBAAmB,CAC3B,oBAAoB,IAAI,CAAC,IAAI,8BAA8B,EAC3D,oCAAoC,EACpC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CACpB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,6DAA6D;IAC7D,MAAM,CAAC,aAAa,CAAC,KAAc;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/esm/graph/nodes/boundary/input-value.js

@@ -0,0 +1,50 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/boundary/input-value
+ * @summary Workflow input value boundary node declaration.
+ * @description Shared canvas node representing a workflow input value
+ * (decorator id `graph-input-value-node`), moved from the for-angular
+ * boundary nodes so both sides share the declaration. Reusable value node
+ * whose single `value` output may feed multiple targets.
+ */
+import { model } from "@decaf-ts/decorator-validation";
+import { output, node } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+let GraphInputValueNode = class GraphInputValueNode extends GraphNode {
+    static execute(request) {
+        return { value: request.inputs["value"] ?? null };
+    }
+};
+__decorate([
+    output({
+        handle: "value",
+        connectionRules: {
+            allowMultiple: true,
+        },
+    }),
+    __metadata("design:type", Object)
+], GraphInputValueNode.prototype, "value", void 0);
+GraphInputValueNode = __decorate([
+    node("graph-input-value-node", {
+        kind: "value",
+        category: "Boundary",
+        color: "#0f766e",
+        icon: "ti-circle-plus",
+        labels: ["workflow", "input", "value"],
+        metadata: {
+            title: "Workflow input value",
+            description: "Reusable canvas value node representing a workflow input.",
+        },
+    }),
+    model()
+], GraphInputValueNode);
+export { GraphInputValueNode };
+//# sourceMappingURL=input-value.js.map

package/lib/esm/graph/nodes/boundary/input-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-value.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/boundary/input-value.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAkB7B,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,SAAS;IAChD,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IACpD,CAAC;CASF,CAAA;AADC;IANC,MAAM,CAAC;QACN,MAAM,EAAE,OAAO;QACf,eAAe,EAAE;YACf,aAAa,EAAE,IAAI;SACpB;KACF,CAAC;;kDACc;AAXL,mBAAmB;IAZ/B,IAAI,CAAC,wBAAwB,EAAE;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;QACtC,QAAQ,EAAE;YACR,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,2DAA2D;SACzE;KACF,CAAC;IACD,KAAK,EAAE;GACK,mBAAmB,CAY/B"}

package/lib/esm/graph/nodes/flow-control/break.js

@@ -0,0 +1,62 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/flow-control/break
+ * @summary Break flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Break — breaks out of the enclosing loop (foreach/while/until).
+ * When executed inside a loop body, the loop terminates early and the loop's
+ * `completed`/`state` output carries the results collected so far. The Break
+ * node's static `execute` throws a `GraphBreakSignal` that the enclosing loop
+ * node class catches.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+import { GraphBreakSignal } from "./../../engine/errors/GraphBreakSignal.js";
+let BreakFlowNode = class BreakFlowNode extends GraphNode {
+    static execute(request, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _context) {
+        throw new GraphBreakSignal(request.inputs["value"]);
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Value",
+        placeholder: "Value to forward (collected as the last partial result)",
+    }),
+    input({ handle: "value" }),
+    __metadata("design:type", Object)
+], BreakFlowNode.prototype, "value", void 0);
+__decorate([
+    required(),
+    output({ handle: "broken" }),
+    __metadata("design:type", Object)
+], BreakFlowNode.prototype, "broken", void 0);
+BreakFlowNode = __decorate([
+    node("core.flow.break", {
+        kind: "core.flow.break",
+        category: "Flow Control",
+        color: "#f59e0b",
+        icon: "ti-square-arrow-right",
+        width: 96,
+        height: 96,
+        labels: ["flow", "break", "loop", "control"],
+        metadata: {
+            title: "Break",
+            description: "Breaks out of the enclosing loop. The loop terminates early and returns the results collected so far.",
+        },
+    }),
+    model()
+], BreakFlowNode);
+export { BreakFlowNode };
+//# sourceMappingURL=break.js.map

package/lib/esm/graph/nodes/flow-control/break.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"break.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/flow-control/break.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAMpC,OAAO,EAAE,gBAAgB,EAAE,kDAA6C;AAiBjE,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,SAAS;IAC1C,MAAM,CAAC,OAAO,CACZ,OAAkC;IAClC,6DAA6D;IAC7D,QAA+B;QAE/B,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;CAaF,CAAA;AALC;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,yDAAyD;KACvE,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;4CACX;AAIhB;IAFC,QAAQ,EAAE;IACV,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;;6CACZ;AAnBN,aAAa;IAfzB,IAAI,CAAC,iBAAiB,EAAE;QACvB,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;QAC5C,QAAQ,EAAE;YACR,KAAK,EAAE,OAAO;YACd,WAAW,EACT,uGAAuG;SAC1G;KACF,CAAC;IACD,KAAK,EAAE;GACK,aAAa,CAoBzB"}

package/lib/esm/graph/nodes/flow-control/error-boundary.js

@@ -0,0 +1,63 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/flow-control/error-boundary
+ * @summary Error-boundary flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Error boundary — try/catch/finally workflow behaviour.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+let ErrorBoundaryFlowNode = class ErrorBoundaryFlowNode extends GraphNode {
+    static execute(request) {
+        return { result: request.inputs["value"] ?? request.inputs };
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Input value",
+        placeholder: "Value to guard",
+    }),
+    input({ handle: "value" }),
+    __metadata("design:type", Object)
+], ErrorBoundaryFlowNode.prototype, "value", void 0);
+__decorate([
+    required(),
+    uielement("input", { label: "Result", placeholder: "Output on success" }),
+    output({ handle: "result" }),
+    __metadata("design:type", Object)
+], ErrorBoundaryFlowNode.prototype, "result", void 0);
+__decorate([
+    required(),
+    uielement("input", { label: "Error", placeholder: "Output on failure" }),
+    output({ handle: "error" }),
+    __metadata("design:type", Object)
+], ErrorBoundaryFlowNode.prototype, "error", void 0);
+ErrorBoundaryFlowNode = __decorate([
+    node("core.flow.errorBoundary", {
+        kind: "core.flow.errorBoundary",
+        category: "Flow Control",
+        color: "#f59e0b",
+        icon: "ti-shield-check",
+        width: 96,
+        height: 96,
+        labels: ["flow", "error", "try-catch"],
+        metadata: {
+            title: "Error boundary",
+            description: "Wraps the input in a try/catch/finally. Emits the result on success, or the error on failure.",
+            finally: false,
+        },
+    }),
+    model()
+], ErrorBoundaryFlowNode);
+export { ErrorBoundaryFlowNode };
+//# sourceMappingURL=error-boundary.js.map

package/lib/esm/graph/nodes/flow-control/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/flow-control/error-boundary.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAsB7B,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,SAAS;IAClD,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/D,CAAC;CAmBF,CAAA;AAXC;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,gBAAgB;KAC9B,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;oDACX;AAKhB;IAHC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACzE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;;qDACZ;AAKjB;IAHC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACxE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;oDACZ;AArBL,qBAAqB;IAhBjC,IAAI,CAAC,yBAAyB,EAAE;QAC/B,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;QACtC,QAAQ,EAAE;YACR,KAAK,EAAE,gBAAgB;YACvB,WAAW,EACT,+FAA+F;YACjG,OAAO,EAAE,KAAK;SACf;KACF,CAAC;IACD,KAAK,EAAE;GACK,qBAAqB,CAsBjC"}

package/lib/esm/graph/nodes/flow-control/human-approval.js

@@ -0,0 +1,71 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/flow-control/human-approval
+ * @summary Human-approval flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Human approval — suspends execution until a human approves
+ * or rejects.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+let HumanApprovalFlowNode = class HumanApprovalFlowNode extends GraphNode {
+    static execute(request) {
+        return { approved: request.inputs["value"] ?? request.inputs };
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Input value",
+        placeholder: "Value pending approval",
+    }),
+    input({ handle: "value" }),
+    __metadata("design:type", Object)
+], HumanApprovalFlowNode.prototype, "value", void 0);
+__decorate([
+    required(),
+    uielement("input", {
+        label: "Approved",
+        placeholder: "Output when approved",
+    }),
+    output({ handle: "approved" }),
+    __metadata("design:type", Object)
+], HumanApprovalFlowNode.prototype, "approved", void 0);
+__decorate([
+    required(),
+    uielement("input", {
+        label: "Rejected",
+        placeholder: "Output when rejected",
+    }),
+    output({ handle: "rejected" }),
+    __metadata("design:type", Object)
+], HumanApprovalFlowNode.prototype, "rejected", void 0);
+HumanApprovalFlowNode = __decorate([
+    node("core.flow.humanApproval", {
+        kind: "core.flow.humanApproval",
+        category: "Flow Control",
+        color: "#f59e0b",
+        icon: "ti-user-check",
+        width: 96,
+        height: 96,
+        labels: ["flow", "approval", "suspend"],
+        metadata: {
+            title: "Human approval",
+            description: "Suspends execution until a human approves or rejects. Emits the approved value or a rejection.",
+            approvers: [],
+            timeoutMs: 86400000,
+        },
+    }),
+    model()
+], HumanApprovalFlowNode);
+export { HumanApprovalFlowNode };
+//# sourceMappingURL=human-approval.js.map

package/lib/esm/graph/nodes/flow-control/human-approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-approval.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/flow-control/human-approval.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAuB7B,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,SAAS;IAClD,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IACjE,CAAC;CAyBF,CAAA;AAjBC;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,wBAAwB;KACtC,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;oDACX;AAQhB;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,sBAAsB;KACpC,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;;uDACZ;AAQnB;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,sBAAsB;KACpC,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;;uDACZ;AA3BR,qBAAqB;IAjBjC,IAAI,CAAC,yBAAyB,EAAE;QAC/B,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC;QACvC,QAAQ,EAAE;YACR,KAAK,EAAE,gBAAgB;YACvB,WAAW,EACT,gGAAgG;YAClG,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,QAAQ;SACpB;KACF,CAAC;IACD,KAAK,EAAE;GACK,qBAAqB,CA4BjC"}

package/lib/esm/graph/nodes/flow-control/if.js

@@ -0,0 +1,73 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/flow-control/if
+ * @summary If flow-control node declaration (DECAF-32 §22.2.2).
+ * @description If — conditional branch. Evaluates a `ConditionExpression`
+ * (§22.3) and routes the input to the `then` or `else` output. A graph-level
+ * macro: the engine's planner recognises it as an ordinary executable node
+ * (§5.7) but it has no built-in executor — downstream projects register
+ * custom executors or compile it into composition APIs (§22.2.2).
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+let IfFlowNode = class IfFlowNode extends GraphNode {
+    static execute(request) {
+        return { then: request.inputs["value"] ?? request.inputs };
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Input value",
+        placeholder: "Value to evaluate",
+    }),
+    input({ handle: "value" }),
+    __metadata("design:type", Object)
+], IfFlowNode.prototype, "value", void 0);
+__decorate([
+    required(),
+    uielement("input", {
+        label: "Then",
+        placeholder: "Output when condition is true",
+    }),
+    output({ handle: "then" }),
+    __metadata("design:type", Object)
+], IfFlowNode.prototype, "then", void 0);
+__decorate([
+    required(),
+    uielement("input", {
+        label: "Else",
+        placeholder: "Output when condition is false",
+    }),
+    output({ handle: "else" }),
+    __metadata("design:type", Object)
+], IfFlowNode.prototype, "else", void 0);
+IfFlowNode = __decorate([
+    node("core.flow.if", {
+        kind: "core.flow.if",
+        category: "Flow Control",
+        color: "#f59e0b",
+        icon: "ti-arrows-split-2",
+        width: 96,
+        height: 96,
+        labels: ["flow", "conditional", "branch"],
+        metadata: {
+            title: "If",
+            description: "Conditional branch. Evaluates the configured condition and routes the input to the matching output.",
+            condition: { op: "eq", left: { const: true }, right: { const: true } },
+        },
+    }),
+    model()
+], IfFlowNode);
+export { IfFlowNode };
+//# sourceMappingURL=if.js.map

package/lib/esm/graph/nodes/flow-control/if.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"if.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/flow-control/if.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAsB7B,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,SAAS;IACvC,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAC7D,CAAC;CAyBF,CAAA;AAjBC;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,mBAAmB;KACjC,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;yCACX;AAQhB;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,+BAA+B;KAC7C,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;;wCACZ;AAQf;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,gCAAgC;KAC9C,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;;wCACZ;AA3BJ,UAAU;IAhBtB,IAAI,CAAC,cAAc,EAAE;QACpB,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC;QACzC,QAAQ,EAAE;YACR,KAAK,EAAE,IAAI;YACX,WAAW,EACT,qGAAqG;YACvG,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;SACvE;KACF,CAAC;IACD,KAAK,EAAE;GACK,UAAU,CA4BtB"}

package/lib/esm/graph/nodes/flow-control/parallel.js

@@ -0,0 +1,60 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * @module integrations/graph/nodes/flow-control/parallel
+ * @summary Parallel flow-control node declaration (DECAF-32 §22.2.2).
+ * @description Parallel — splits execution into concurrent branches.
+ */
+import { model, required } from "@decaf-ts/decorator-validation";
+import { uielement } from "@decaf-ts/ui-decorators";
+import { input, node, output } from "@decaf-ts/ui-decorators/graph";
+import { GraphNode } from "./../base.js";
+let ParallelFlowNode = class ParallelFlowNode extends GraphNode {
+    static execute(request) {
+        return { branches: [request.inputs["value"] ?? request.inputs] };
+    }
+};
+__decorate([
+    required(),
+    uielement("textarea", {
+        label: "Input value",
+        placeholder: "Value to fan out",
+    }),
+    input({ handle: "value" }),
+    __metadata("design:type", Object)
+], ParallelFlowNode.prototype, "value", void 0);
+__decorate([
+    required(),
+    uielement("input", {
+        label: "Branches",
+        placeholder: "Collected branch outputs",
+    }),
+    output({ handle: "branches" }),
+    __metadata("design:type", Array)
+], ParallelFlowNode.prototype, "branches", void 0);
+ParallelFlowNode = __decorate([
+    node("core.flow.parallel", {
+        kind: "core.flow.parallel",
+        category: "Flow Control",
+        color: "#f59e0b",
+        icon: "ti-arrows-vertical",
+        width: 96,
+        height: 96,
+        labels: ["flow", "parallel", "concurrent"],
+        metadata: {
+            title: "Parallel",
+            description: "Splits execution into concurrent branches. All branches run in parallel and outputs are collected.",
+            branchCount: 2,
+        },
+    }),
+    model()
+], ParallelFlowNode);
+export { ParallelFlowNode };
+//# sourceMappingURL=parallel.js.map

package/lib/esm/graph/nodes/flow-control/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/flow-control/parallel.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,qBAAgB;AAsB7B,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,SAAS;IAC7C,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACnE,CAAC;CAiBF,CAAA;AATC;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,kBAAkB;KAChC,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;+CACX;AAQhB;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,0BAA0B;KACxC,CAAC;IACD,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;;kDACV;AAnBV,gBAAgB;IAhB5B,IAAI,CAAC,oBAAoB,EAAE;QAC1B,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC;QAC1C,QAAQ,EAAE;YACR,KAAK,EAAE,UAAU;YACjB,WAAW,EACT,oGAAoG;YACtG,WAAW,EAAE,CAAC;SACf;KACF,CAAC;IACD,KAAK,EAAE;GACK,gBAAgB,CAoB5B"}