@decaf-ts/integrations 0.8.0 → 0.9.0

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

@@ -1,120 +0,0 @@
-/**
- * @module integrations/graph/shared/constants
- * @summary Frontend-safe graph constants and enums.
- * @description Constants and enumerations that are safe to import from a
- * frontend bundle (no engine runtime dependency). Alongside the existing
- * execution-status and event-type enums (rendered as status badges and event
- * timelines), this module carries the DECAF-48 visual-state contract: the
- * frontend-safe {@link GraphVisualState} enum, the `graph.run.log` /
- * `graph.run.state` SSE topic constants, the run-log attribute keys
- * ({@link GraphLogAttribute}), and the `NODE_STATE_CHANGED` /
- * `EDGE_STATE_CHANGED` / `GRAPH_RUN_LOG` event types. The frontend must not
- * pull in the execution engine.
- */
-/**
- * Execution status for a workflow or individual node.
- */
-export declare enum GraphExecutionStatus {
-    PENDING = "pending",
-    PLANNING = "planning",
-    RUNNING = "running",
-    SUCCEEDED = "succeeded",
-    FAILED = "failed",
-    SKIPPED = "skipped",
-    CANCELLED = "cancelled",
-    CACHED = "cached"
-}
-/**
- * Visual execution state for a node or edge on the workflow canvas.
- *
- * Frontend-safe (DECAF-48 §4.4): a superset of {@link GraphExecutionStatus}
- * normalised for rendering. `BLOCKED` is derived from the plan and execution
- * events (waiting on upstream dependencies), not emitted as an engine status.
- * `SKIPPED` is the post-failure "unexecuted/disabled" visual state.
- */
-export declare enum GraphVisualState {
-    IDLE = "idle",
-    RUNNING = "running",
-    BLOCKED = "blocked",
-    SUCCEEDED = "succeeded",
-    FAILED = "failed",
-    SKIPPED = "skipped"
-}
-/**
- * Namespace root for graph run SSE topics (DECAF-48 §4.2). A subscription
- * filters on these granular topics before `observer.next(...)`.
- */
-export declare const GRAPH_RUN_TOPIC = "graph.run";
-/**
- * SSE sub-topic streaming per-node log lines during a run.
- */
-export declare const GRAPH_RUN_LOG_TOPIC = "graph.run.log";
-/**
- * SSE sub-topic streaming node/edge execution-state updates during a run.
- */
-export declare const GRAPH_RUN_STATE_TOPIC = "graph.run.state";
-/**
- * Logger custom-attribute keys attached to every run log line via
- * DECAF-9 `logger.for({...})` (DECAF-48 §4.3). Rendered as discrete columns
- * (not buried in the message string).
- */
-export declare enum GraphLogAttribute {
-    NODE_ID = "nodeId",
-    WORKFLOW_ID = "workflowId",
-    RUN_ID = "runId",
-    USER = "user"
-}
-/**
- * Namespace topic helper for a graph execution event.
- *
- * Log-carrier events resolve to `graph.run.log`; node/edge execution-state
- * events resolve to `graph.run.state`; everything else stays under the shared
- * `graph.run` topic and is only delivered to subscribers that match it.
- *
- * @param eventType - The graph execution event type to scope to a topic.
- * @returns The SSE topic constant for the given event type.
- */
-export declare function graphRunTopicOf(eventType: GraphExecutionEventType): string;
-/**
- * Event types emitted through the graph execution observer pipeline.
- *
- * DECAF-48 extends this set with the visual-state and run-log event types the
- * engine emits on the existing Observable: {@link GraphExecutionEventType.NODE_STATE_CHANGED},
- * {@link GraphExecutionEventType.EDGE_STATE_CHANGED} and
- * {@link GraphExecutionEventType.GRAPH_RUN_LOG}.
- */
-export declare enum GraphExecutionEventType {
-    WORKFLOW_STARTED = "workflow.started",
-    WORKFLOW_PLANNED = "workflow.planned",
-    WORKFLOW_COMPLETED = "workflow.completed",
-    WORKFLOW_FAILED = "workflow.failed",
-    WORKFLOW_CANCELLED = "workflow.cancelled",
-    NODE_QUEUED = "node.queued",
-    NODE_STARTED = "node.started",
-    NODE_OUTPUT = "node.output",
-    NODE_COMPLETED = "node.completed",
-    NODE_FAILED = "node.failed",
-    NODE_SKIPPED = "node.skipped",
-    NODE_CACHE_HIT = "node.cacheHit",
-    NODE_PINNED = "node.pinned",
-    NODE_UNPINNED = "node.unpinned",
-    /** Node execution-state transition carrying a `GraphNodeStateChangedPayload` (DECAF-48 §4.4). */
-    NODE_STATE_CHANGED = "node.stateChanged",
-    EDGE_VALUE_ROUTED = "edge.valueRouted",
-    /** Edge execution-state transition carrying a `GraphEdgeStateChangedPayload` (DECAF-48 §4.4). */
-    EDGE_STATE_CHANGED = "edge.stateChanged",
-    /** Structured run log line carrying a `GraphRunLogEntry` (DECAF-48 §4.3). */
-    GRAPH_RUN_LOG = "graph.run.log",
-    LOOP_STARTED = "loop.started",
-    LOOP_ITERATION_STARTED = "loop.iteration.started",
-    LOOP_ITERATION_COMPLETED = "loop.iteration.completed",
-    LOOP_CONDITION_EVALUATED = "loop.condition.evaluated",
-    LOOP_COMPLETED = "loop.completed",
-    LOOP_LIMIT_REACHED = "loop.limitReached",
-    VALIDATION_STARTED = "validation.started",
-    VALIDATION_FAILED = "validation.failed",
-    VALIDATION_COMPLETED = "validation.completed",
-    STORE_READ = "store.read",
-    STORE_WRITE = "store.write",
-    STORE_DELETE = "store.delete"
-}

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

@@ -1,21 +0,0 @@
-/**
- * @module integrations/graph/shared
- * @summary Frontend-safe graph declarations.
- * @description Subpath export for frontend bundles. Re-exports the node kind
- * declarations, shared types, and shared constants — no engine runtime
- * dependency. Also re-exports `Metadata` from `@decaf-ts/ui-decorators` so
- * consumers get the `Metadata.nodes()` / `Metadata.workflows()` accessors
- * (attached via the graph overrides side-effect import).
- *
- * Importing anything from this module triggers the `ui-decorators/graph`
- * overrides side-effect, which attaches `nodes()` / `workflows()` to the
- * `Metadata` class.
- */
-import "@decaf-ts/ui-decorators/graph";
-export { Metadata } from "@decaf-ts/decoration";
-export * from "./constants.d.cts";
-export * from "./types.d.cts";
-export * from "./GraphExecutionStateMapper.d.cts";
-export * from "./nodes/index.d.cts";
-export { GRAPH_VISUAL_STATE_STYLES, graphVisualStyleOf, } from "@decaf-ts/ui-decorators/graph";
-export type { GraphNodeIoMetadata, GraphNodeIoViewMode, GraphVisualStyle, } from "@decaf-ts/ui-decorators/graph";

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

@@ -1,21 +0,0 @@
-/**
- * @module integrations/graph/shared
- * @summary Frontend-safe graph declarations.
- * @description Subpath export for frontend bundles. Re-exports the node kind
- * declarations, shared types, and shared constants — no engine runtime
- * dependency. Also re-exports `Metadata` from `@decaf-ts/ui-decorators` so
- * consumers get the `Metadata.nodes()` / `Metadata.workflows()` accessors
- * (attached via the graph overrides side-effect import).
- *
- * Importing anything from this module triggers the `ui-decorators/graph`
- * overrides side-effect, which attaches `nodes()` / `workflows()` to the
- * `Metadata` class.
- */
-import "@decaf-ts/ui-decorators/graph";
-export { Metadata } from "@decaf-ts/decoration";
-export * from "./constants.d.mts";
-export * from "./types.d.mts";
-export * from "./GraphExecutionStateMapper.d.mts";
-export * from "./nodes/index.d.mts";
-export { GRAPH_VISUAL_STATE_STYLES, graphVisualStyleOf, } from "@decaf-ts/ui-decorators/graph";
-export type { GraphNodeIoMetadata, GraphNodeIoViewMode, GraphVisualStyle, } from "@decaf-ts/ui-decorators/graph";

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

@@ -1,44 +0,0 @@
-/**
- * @module integrations/graph/nodes/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 } from "@decaf-ts/decorator-validation";
-import "./category-styles";
-/**
- * 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.
- */
-export declare class AgentNode extends Model {
-    prompt: string;
-    response: string;
-    actions: unknown[];
-    model: unknown;
-    memory: unknown;
-    workspace: unknown;
-}
-/**
- * All built-in agent node constructors.
- */
-export declare const GRAPH_AGENT_NODES: readonly [typeof AgentNode];

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

@@ -1,44 +0,0 @@
-/**
- * @module integrations/graph/nodes/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 } from "@decaf-ts/decorator-validation";
-import "./category-styles";
-/**
- * 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.
- */
-export declare class AgentNode extends Model {
-    prompt: string;
-    response: string;
-    actions: unknown[];
-    model: unknown;
-    memory: unknown;
-    workspace: unknown;
-}
-/**
- * All built-in agent node constructors.
- */
-export declare const GRAPH_AGENT_NODES: readonly [typeof AgentNode];

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

@@ -1,28 +0,0 @@
-/**
- * @module integrations/graph/nodes/base
- * @summary Base class for graph node declarations.
- * @description `GraphNode` extends {@link Model} with an overridable
- * `applyMetadata` static method. Concrete node kinds that support dynamic
- * metadata changes (e.g. `SwitchFlowNode` adding case output ports) override
- * this method to compute their own ports, size, and data patches — the node
- * is exclusively responsible for itself in every way.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-import type { NodeMetadataChange } from "../types.d.cts";
-export declare class GraphNode extends Model {
-    /**
-     * 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.
-     */
-    static applyMetadata(_meta: unknown): NodeMetadataChange | null;
-}

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

@@ -1,28 +0,0 @@
-/**
- * @module integrations/graph/nodes/base
- * @summary Base class for graph node declarations.
- * @description `GraphNode` extends {@link Model} with an overridable
- * `applyMetadata` static method. Concrete node kinds that support dynamic
- * metadata changes (e.g. `SwitchFlowNode` adding case output ports) override
- * this method to compute their own ports, size, and data patches — the node
- * is exclusively responsible for itself in every way.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-import type { NodeMetadataChange } from "../types.d.mts";
-export declare class GraphNode extends Model {
-    /**
-     * 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.
-     */
-    static applyMetadata(_meta: unknown): NodeMetadataChange | null;
-}

package/lib/types/graph/shared/nodes/category-styles.d.cts

@@ -1,8 +0,0 @@
-/**
- * Registers all built-in category styles. Called once at module init.
- *
- * Categories define the default visual style for nodes and connection ports.
- * A node's explicit `color` / `icon` (on `@node()`) overrides the category
- * style; when omitted, the category style is used.
- */
-export declare function registerBuiltinCategoryStyles(): void;

package/lib/types/graph/shared/nodes/category-styles.d.mts

@@ -1,8 +0,0 @@
-/**
- * Registers all built-in category styles. Called once at module init.
- *
- * Categories define the default visual style for nodes and connection ports.
- * A node's explicit `color` / `icon` (on `@node()`) overrides the category
- * style; when omitted, the category style is used.
- */
-export declare function registerBuiltinCategoryStyles(): void;

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

@@ -1,163 +0,0 @@
-/**
- * @module integrations/graph/nodes/flow-control
- * @summary Production flow-control node kind declarations (DECAF-32 §22.2.2).
- * @description Canonical `@node`-decorated classes for the ALFRED-5
- * flow-control kinds, plus the DECAF-48 `core.utility.log` Log node. These
- * are graph-level macros: the engine's planner recognises them as ordinary
- * executable nodes (§5.7) but they have no built-in executors — downstream
- * projects (e.g. ALFRED) register custom executors or compile them into
- * Mastra composition APIs (§22.2.2). The `core.utility.log` node is the one
- * exception: its {@link LogGraphNodeExecutor} is built in and logs the input
- * through the run's `ctx.logger` (DECAF-48 §4.3).
- *
- * The three loop kinds (`core.loop.foreach/while/until`) already have built-in
- * executors (§5.9) and are NOT redeclared here.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-import type { LogNodeLevel, NodeMetadataChange, SwitchNodeMetadata } from "../types.d.cts";
-import { GraphNode } from "./base.d.cts";
-/**
- * If — conditional branch. Evaluates a `ConditionExpression` (§22.3) and
- * routes the input to the `then` or `else` output.
- */
-export declare class IfFlowNode extends Model {
-    value: unknown;
-    then: unknown;
-    else: unknown;
-}
-/**
- * Switch — multi-branch. Routes the input to one of the case output ports
- * or `default` based on matching conditions. Each case defines a
- * {@link SwitchCaseCondition} (graphical or code mode) and a dedicated
- * output port. Cases are stored in `metadata.switch.cases` and the
- * renderer creates dynamic output ports from them (DECAF-32 §22.2.2).
- *
- * The node grows in height as cases are added. Each case gets its own
- * output port on the right side, labeled with the case label.
- */
-export declare class SwitchFlowNode extends GraphNode {
-    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.
-     */
-    static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
-}
-/**
- * Parallel — splits execution into concurrent branches.
- */
-export declare class ParallelFlowNode extends Model {
-    value: unknown;
-    branches: unknown[];
-}
-/**
- * Merge — normalises branch/parallel outputs into a single output.
- */
-export declare class MergeFlowNode extends Model {
-    values: unknown[];
-    merged: unknown;
-}
-/**
- * Map — transforms the current input into a new output object.
- */
-export declare class MapFlowNode extends Model {
-    value: unknown;
-    result: unknown;
-}
-/**
- * Delay — pauses execution for a configured duration.
- */
-export declare class DelayFlowNode extends Model {
-    value: unknown;
-    valueOut: unknown;
-}
-/**
- * Error boundary — try/catch/finally workflow behaviour.
- */
-export declare class ErrorBoundaryFlowNode extends Model {
-    value: unknown;
-    result: unknown;
-    error: unknown;
-}
-/**
- * Human approval — suspends execution until a human approves or rejects.
- */
-export declare class HumanApprovalFlowNode extends Model {
-    value: unknown;
-    approved: unknown;
-    rejected: unknown;
-}
-/**
- * Return — defines and normalises the final workflow output.
- */
-export declare class ReturnFlowNode extends Model {
-    value: unknown;
-    result: unknown;
-}
-/**
- * Code — sandboxed JS/TS code execution (ALFRED-5 §7, DECAF-32 §22.4).
- *
- * The engine's {@link CodeGraphNodeExecutor} delegates to the pluggable
- * {@link CodeSandboxEvaluator}. 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.
- */
-/**
- * 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: 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;
-}
-/**
- * Utility Log — logs the input value through the run's `ctx.logger` at a
- * configurable level and forwards it unchanged on the `logged` output port
- * (DECAF-48 §4.3).
- */
-export declare class UtilityLogNode extends Model {
-    value: unknown;
-    level: LogNodeLevel;
-    logged: unknown;
-}
-/**
- * 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 executor throws a {@link GraphBreakSignal} that the enclosing
- * loop executor catches.
- */
-export declare class BreakFlowNode extends Model {
-    value: unknown;
-    broken: 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, typeof LogFlowNode, typeof UtilityLogNode, typeof BreakFlowNode];

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

@@ -1,163 +0,0 @@
-/**
- * @module integrations/graph/nodes/flow-control
- * @summary Production flow-control node kind declarations (DECAF-32 §22.2.2).
- * @description Canonical `@node`-decorated classes for the ALFRED-5
- * flow-control kinds, plus the DECAF-48 `core.utility.log` Log node. These
- * are graph-level macros: the engine's planner recognises them as ordinary
- * executable nodes (§5.7) but they have no built-in executors — downstream
- * projects (e.g. ALFRED) register custom executors or compile them into
- * Mastra composition APIs (§22.2.2). The `core.utility.log` node is the one
- * exception: its {@link LogGraphNodeExecutor} is built in and logs the input
- * through the run's `ctx.logger` (DECAF-48 §4.3).
- *
- * The three loop kinds (`core.loop.foreach/while/until`) already have built-in
- * executors (§5.9) and are NOT redeclared here.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-import type { LogNodeLevel, NodeMetadataChange, SwitchNodeMetadata } from "../types.d.mts";
-import { GraphNode } from "./base.d.mts";
-/**
- * If — conditional branch. Evaluates a `ConditionExpression` (§22.3) and
- * routes the input to the `then` or `else` output.
- */
-export declare class IfFlowNode extends Model {
-    value: unknown;
-    then: unknown;
-    else: unknown;
-}
-/**
- * Switch — multi-branch. Routes the input to one of the case output ports
- * or `default` based on matching conditions. Each case defines a
- * {@link SwitchCaseCondition} (graphical or code mode) and a dedicated
- * output port. Cases are stored in `metadata.switch.cases` and the
- * renderer creates dynamic output ports from them (DECAF-32 §22.2.2).
- *
- * The node grows in height as cases are added. Each case gets its own
- * output port on the right side, labeled with the case label.
- */
-export declare class SwitchFlowNode extends GraphNode {
-    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.
-     */
-    static applyMetadata(meta: SwitchNodeMetadata): NodeMetadataChange;
-}
-/**
- * Parallel — splits execution into concurrent branches.
- */
-export declare class ParallelFlowNode extends Model {
-    value: unknown;
-    branches: unknown[];
-}
-/**
- * Merge — normalises branch/parallel outputs into a single output.
- */
-export declare class MergeFlowNode extends Model {
-    values: unknown[];
-    merged: unknown;
-}
-/**
- * Map — transforms the current input into a new output object.
- */
-export declare class MapFlowNode extends Model {
-    value: unknown;
-    result: unknown;
-}
-/**
- * Delay — pauses execution for a configured duration.
- */
-export declare class DelayFlowNode extends Model {
-    value: unknown;
-    valueOut: unknown;
-}
-/**
- * Error boundary — try/catch/finally workflow behaviour.
- */
-export declare class ErrorBoundaryFlowNode extends Model {
-    value: unknown;
-    result: unknown;
-    error: unknown;
-}
-/**
- * Human approval — suspends execution until a human approves or rejects.
- */
-export declare class HumanApprovalFlowNode extends Model {
-    value: unknown;
-    approved: unknown;
-    rejected: unknown;
-}
-/**
- * Return — defines and normalises the final workflow output.
- */
-export declare class ReturnFlowNode extends Model {
-    value: unknown;
-    result: unknown;
-}
-/**
- * Code — sandboxed JS/TS code execution (ALFRED-5 §7, DECAF-32 §22.4).
- *
- * The engine's {@link CodeGraphNodeExecutor} delegates to the pluggable
- * {@link CodeSandboxEvaluator}. 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.
- */
-/**
- * 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: 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;
-}
-/**
- * Utility Log — logs the input value through the run's `ctx.logger` at a
- * configurable level and forwards it unchanged on the `logged` output port
- * (DECAF-48 §4.3).
- */
-export declare class UtilityLogNode extends Model {
-    value: unknown;
-    level: LogNodeLevel;
-    logged: unknown;
-}
-/**
- * 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 executor throws a {@link GraphBreakSignal} that the enclosing
- * loop executor catches.
- */
-export declare class BreakFlowNode extends Model {
-    value: unknown;
-    broken: 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, typeof LogFlowNode, typeof UtilityLogNode, typeof BreakFlowNode];

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

@@ -1,17 +0,0 @@
-/**
- * @module integrations/graph/nodes
- * @summary Production node kind declarations (DECAF-32 §22.2).
- * @description Canonical `@node`-decorated classes for the ALFRED-5 node kind
- * taxonomy. These are the framework's built-in node definitions — triggers
- * (§22.2.1), flow-control/utility nodes (§22.2.2–22.2.3), and the Agent node
- * (§21.3). The three loop kinds (`core.loop.foreach/while/until`) already have
- * built-in executors (§5.9) and are not redeclared here.
- *
- * Consumers (for-angular, ALFRED, etc.) import these declarations to populate
- * node palettes, registries, and reference snapshots.
- */
-export * from "./base.d.cts";
-export * from "./category-styles.d.cts";
-export * from "./triggers.d.cts";
-export * from "./flow-control.d.cts";
-export * from "./agent.d.cts";