@foresthubai/workflow-core 0.3.0

package/dist/node/index.d.ts

@@ -0,0 +1,12 @@
+export type { NodeOutput, NodeType, NodeData, Node, NodeBase, } from "./Node";
+export { NodeCategory, NodeTag } from "./constants";
+export { NodeRegistry } from "./NodeRegistry";
+export type { NodeDefinition, Port, PortDefinitions } from "./NodeDefinition";
+export type { OutputParameter, StaticOutput, OutputList, OutputBinding, OutputDeclaration } from "../parameter";
+export { getPorts, getArguments, getNodeOutput, getNodeAvailableOutput, getOutputBinding, getInput, isNodeUsedAsTool } from "./methods";
+export type { ExternalInput } from "./methods";
+export type { FunctionCallNode, FunctionCallNodeType, FunctionNodeDefinition } from "./FunctionNode";
+export { buildFunctionNodeDef } from "./FunctionNode";
+export { serialize, deserialize } from "./serialization";
+export type { ApiNode } from "./serialization";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,GACT,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGhH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxI,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/node/index.js

@@ -0,0 +1,9 @@
+// Constants & registry
+export { NodeCategory, NodeTag } from "./constants";
+export { NodeRegistry } from "./NodeRegistry";
+// NodeMethods — read helpers over a NodeData
+export { getPorts, getArguments, getNodeOutput, getNodeAvailableOutput, getOutputBinding, getInput, isNodeUsedAsTool } from "./methods";
+export { buildFunctionNodeDef } from "./FunctionNode";
+// Serialization — domain Node <-> api
+export { serialize, deserialize } from "./serialization";
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AASA,uBAAuB;AACvB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,6CAA6C;AAC7C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAKxI,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/node/methods.d.ts

@@ -0,0 +1,73 @@
+import { NodeData, NodeOutput } from "./Node";
+import type { OutputBinding } from "../parameter";
+import { PortDefinitions } from "./NodeDefinition";
+import { Edge } from "../edge";
+/**
+ * Read-only helper: look up the current binding for a given output key on any node.
+ * All static-style bindings (including FunctionCall returns) live at `arguments[outputId]`.
+ * List output entries are OutputDeclarations, projected to an OutputBinding shape — only
+ * emit-mode entries are addressable by uid here; callers that need to inspect assign-mode
+ * entries should walk the declaration list directly via `arguments[out.id]`.
+ */
+export declare function getOutputBinding(node: NodeData, outputId: string): OutputBinding | undefined;
+/** Describes a hardware input a node needs before it can execute in debug mode. */
+export type ExternalInput = {
+    kind: "gpio";
+    pinReference: string | undefined;
+    dataType: "bool" | "int";
+} | {
+    kind: "serial";
+};
+/**
+ * Get ports for a node instance.
+ */
+export declare function getPorts(node: NodeData): PortDefinitions;
+/**
+ * Get a flat arguments record for any node instance. Used to feed parameter
+ * resolution (FromArgs<T> lambdas, activation rules). Output bindings live in
+ * the same record under their own (non-colliding) output ids — lambdas address
+ * parameters by parameter id and never hit them accidentally.
+ */
+export declare function getArguments(node: NodeData): Record<string, unknown>;
+/**
+ * Compute the outputs the node currently can produce (before binding decisions).
+ * For FunctionCall: derived from the per-instance functionInfo snapshot (decoupled from live function defs).
+ * For all others: derived from the registered NodeDefinition's outputs[] + the node's current arguments.
+ *
+ * List outputs: only emit-mode entries are surfaced. Assign-mode entries route to
+ * existing variables and don't create new output slots in scope — they're validated
+ * as bindings, not reported as available outputs.
+ */
+export declare function getNodeAvailableOutput(node: NodeData): Record<string, NodeOutput>;
+/**
+ * Compute the effective outputs the node emits to variable scope: available outputs
+ * filtered to active emit bindings only (inactive bindings and active assign bindings
+ * contribute nothing — assign routes to an existing variable, inactive is discarded).
+ * Emit bindings carry a user-chosen name that overrides the output's default name (the id).
+ *
+ * Binding lookup:
+ *  - Static outputs (incl. FunctionCall returns): `node.arguments[out.id]`
+ *  - List outputs: each entry is already a declaration; emit entries contribute
+ *    directly (no separate binding), assign entries contribute nothing
+ */
+export declare function getNodeOutput(node: NodeData): Record<string, NodeOutput>;
+/**
+ * Compute external input requirements for a node instance (debug mode).
+ * Returns the hardware I/O values the node will read during execution.
+ */
+export declare function getInput(node: NodeData): ExternalInput[];
+/**
+ * Determine whether a node is currently used as a tool input
+ * (i.e. its tool-input port has an incoming edge).
+ *
+ * Reads only the connectivity fields off each edge (`target`, `targetHandle`),
+ * so it takes the structural {@link Edge} rather than React Flow's `Edge` —
+ * keeping this (and its callers in serialization/diagnostics) headless. The
+ * editor's React Flow `Edge[]` is structurally assignable without an adapter.
+ *
+ * Editor-only connection rules (canPortAcceptEdge, getCompatibleNodeDefs,
+ * isValidConnection) live in workflow-builder's connectionRules — they operate
+ * on React Flow `Node`/`Edge` and have no place in the headless core.
+ */
+export declare function isNodeUsedAsTool(nodeId: string, nodeData: NodeData, edges: readonly Edge[]): boolean;
+//# sourceMappingURL=methods.d.ts.map

package/dist/node/methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../src/node/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAO/B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAoB5F;AAMD,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE9H;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,CAmFxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA8BjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAsCxE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,EAAE,CAexD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,OAAO,CAKpG"}

package/dist/node/methods.js

@@ -0,0 +1,261 @@
+import { resolveStaticOutputDataType } from "../parameter";
+import { NodeRegistry } from "./NodeRegistry";
+/** Read a static output's binding from a node's arguments bag, keyed by the output id. */
+function getStaticBinding(args, outputId) {
+    return args[outputId];
+}
+/**
+ * Read-only helper: look up the current binding for a given output key on any node.
+ * All static-style bindings (including FunctionCall returns) live at `arguments[outputId]`.
+ * List output entries are OutputDeclarations, projected to an OutputBinding shape — only
+ * emit-mode entries are addressable by uid here; callers that need to inspect assign-mode
+ * entries should walk the declaration list directly via `arguments[out.id]`.
+ */
+export function getOutputBinding(node, outputId) {
+    const args = node.arguments;
+    if (node.type === "FunctionCall") {
+        return getStaticBinding(args, outputId);
+    }
+    const def = NodeRegistry.getByType(node.type);
+    if (!def?.outputs)
+        return undefined;
+    for (const out of def.outputs) {
+        if (out.type === "static") {
+            if (out.id === outputId)
+                return getStaticBinding(args, out.id);
+        }
+        else {
+            const entries = args[out.id];
+            const entry = entries?.find((e) => e.mode === "emit" && e.uid === outputId);
+            if (entry && entry.mode === "emit")
+                return { active: true, mode: "emit", name: entry.name };
+        }
+    }
+    return undefined;
+}
+/**
+ * Get ports for a node instance.
+ */
+export function getPorts(node) {
+    switch (node.type) {
+        case "ReadPin":
+            return {
+                input: [
+                    { id: "ctrl", type: "control" },
+                    { id: "tool", type: "tool", label: "As Tool" },
+                ],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "SerialRead":
+        case "WritePin":
+        case "SerialWrite":
+        case "MqttPublish":
+            return {
+                input: [{ id: "ctrl", type: "control" }],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "FunctionCall":
+            return {
+                input: [
+                    { id: "ctrl", type: "control" },
+                    { id: "tool", type: "tool", label: "As Tool" },
+                ],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "Agent":
+            return {
+                input: [
+                    { id: "ctrl", type: "control" },
+                    { id: "tool", type: "tool", label: "As Tool" },
+                ],
+                output: [
+                    { id: "ctrl", type: "control" },
+                    { id: "tools", type: "tool" },
+                ],
+            };
+        case "SetVariable":
+            return {
+                input: [{ id: "ctrl", type: "control" }],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "If":
+            return {
+                input: [{ id: "ctrl", type: "control" }],
+                output: [
+                    { id: "true", type: "control", label: "True" },
+                    { id: "false", type: "control", label: "False" },
+                ],
+            };
+        case "Delay":
+            return {
+                input: [{ id: "ctrl", type: "control" }],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "OnFunctionCall":
+        case "Ticker":
+        case "Alarm":
+        case "OnStartup":
+        case "OnPinEdge":
+        case "OnSerialReceive":
+        case "OnThreshold":
+        case "OnMqttMessage":
+            return {
+                input: [],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "Retriever":
+            return {
+                input: [
+                    { id: "ctrl", type: "control" },
+                    { id: "tool", type: "tool", label: "As Tool" },
+                ],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "WebFetch":
+            return {
+                input: [{ id: "ctrl", type: "control" }],
+                output: [{ id: "ctrl", type: "control" }],
+            };
+        case "WebSearchTool":
+            return { input: [{ id: "tool", type: "tool", label: "As Tool" }], output: [] };
+    }
+}
+/**
+ * Get a flat arguments record for any node instance. Used to feed parameter
+ * resolution (FromArgs<T> lambdas, activation rules). Output bindings live in
+ * the same record under their own (non-colliding) output ids — lambdas address
+ * parameters by parameter id and never hit them accidentally.
+ */
+export function getArguments(node) {
+    return node.arguments;
+}
+/**
+ * Compute the outputs the node currently can produce (before binding decisions).
+ * For FunctionCall: derived from the per-instance functionInfo snapshot (decoupled from live function defs).
+ * For all others: derived from the registered NodeDefinition's outputs[] + the node's current arguments.
+ *
+ * List outputs: only emit-mode entries are surfaced. Assign-mode entries route to
+ * existing variables and don't create new output slots in scope — they're validated
+ * as bindings, not reported as available outputs.
+ */
+export function getNodeAvailableOutput(node) {
+    const result = {};
+    if (node.type === "FunctionCall") {
+        for (const ret of node.functionInfo.returns) {
+            result[ret.uid] = { name: ret.name, dataType: ret.dataType };
+        }
+        return result;
+    }
+    const def = NodeRegistry.getByType(node.type);
+    if (!def?.outputs)
+        return result;
+    const args = node.arguments;
+    for (const out of def.outputs) {
+        if (out.type === "static") {
+            result[out.id] = {
+                name: out.id,
+                dataType: resolveStaticOutputDataType(out, node.arguments),
+            };
+        }
+        else {
+            const entries = args[out.id] ?? [];
+            for (const entry of entries) {
+                if (entry.mode === "emit") {
+                    result[entry.uid] = { name: entry.name, dataType: entry.dataType };
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Compute the effective outputs the node emits to variable scope: available outputs
+ * filtered to active emit bindings only (inactive bindings and active assign bindings
+ * contribute nothing — assign routes to an existing variable, inactive is discarded).
+ * Emit bindings carry a user-chosen name that overrides the output's default name (the id).
+ *
+ * Binding lookup:
+ *  - Static outputs (incl. FunctionCall returns): `node.arguments[out.id]`
+ *  - List outputs: each entry is already a declaration; emit entries contribute
+ *    directly (no separate binding), assign entries contribute nothing
+ */
+export function getNodeOutput(node) {
+    const result = {};
+    const args = node.arguments;
+    const applyStaticBinding = (key, defaultName, dataType, binding) => {
+        // No binding = treat as default emit (the seeded shape). Otherwise honor active+mode.
+        if (!binding) {
+            result[key] = { name: defaultName, dataType };
+            return;
+        }
+        if (!binding.active)
+            return;
+        if (binding.mode !== "emit")
+            return;
+        result[key] = { name: binding.name, dataType };
+    };
+    if (node.type === "FunctionCall") {
+        for (const ret of node.functionInfo.returns) {
+            applyStaticBinding(ret.uid, ret.name, ret.dataType, getStaticBinding(args, ret.uid));
+        }
+        return result;
+    }
+    const def = NodeRegistry.getByType(node.type);
+    if (!def?.outputs)
+        return result;
+    for (const out of def.outputs) {
+        if (out.type === "static") {
+            applyStaticBinding(out.id, out.id, resolveStaticOutputDataType(out, node.arguments), getStaticBinding(args, out.id));
+        }
+        else {
+            const entries = args[out.id] ?? [];
+            for (const entry of entries) {
+                if (entry.mode === "emit") {
+                    result[entry.uid] = { name: entry.name, dataType: entry.dataType };
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Compute external input requirements for a node instance (debug mode).
+ * Returns the hardware I/O values the node will read during execution.
+ */
+export function getInput(node) {
+    switch (node.type) {
+        case "ReadPin":
+            return [
+                { kind: "gpio", pinReference: node.arguments.pinReference, dataType: node.arguments.signalType === "digital" ? "bool" : "int" },
+            ];
+        case "SerialRead":
+            return [{ kind: "serial" }];
+        case "OnPinEdge":
+            return [{ kind: "gpio", pinReference: node.arguments.pinReference, dataType: "bool" }];
+        case "OnSerialReceive":
+            return [{ kind: "serial" }];
+        default:
+            return [];
+    }
+}
+/**
+ * Determine whether a node is currently used as a tool input
+ * (i.e. its tool-input port has an incoming edge).
+ *
+ * Reads only the connectivity fields off each edge (`target`, `targetHandle`),
+ * so it takes the structural {@link Edge} rather than React Flow's `Edge` —
+ * keeping this (and its callers in serialization/diagnostics) headless. The
+ * editor's React Flow `Edge[]` is structurally assignable without an adapter.
+ *
+ * Editor-only connection rules (canPortAcceptEdge, getCompatibleNodeDefs,
+ * isValidConnection) live in workflow-builder's connectionRules — they operate
+ * on React Flow `Node`/`Edge` and have no place in the headless core.
+ */
+export function isNodeUsedAsTool(nodeId, nodeData, edges) {
+    const ports = getPorts(nodeData);
+    const toolInputs = ports.input.filter((p) => p.type === "tool");
+    if (toolInputs.length === 0)
+        return false;
+    return edges.some((e) => e.target === nodeId && toolInputs.some((p) => p.id === e.targetHandle));
+}
+//# sourceMappingURL=methods.js.map

package/dist/node/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/node/methods.ts"],"names":[],"mappings":"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"}

package/dist/node/serialization.d.ts

@@ -0,0 +1,25 @@
+import type { Schemas } from "../api";
+import type { Node } from "./Node";
+import type { FunctionInfo } from "../function";
+export type ApiNode = Schemas["Node"];
+/**
+ * Resolve a function's signature snapshot by id. A `FunctionCall` on the wire stores
+ * only `functionId`; deserialize rebuilds the in-memory `functionInfo` snapshot
+ * (which core's variable helpers + staleness read) from the workflow's function
+ * table via this. Unknown id (e.g. a call to a since-deleted function) → a minimal
+ * stub so the node still round-trips and surfaces as deleted.
+ */
+export type ResolveFunctionInfo = (functionId: string) => FunctionInfo | undefined;
+/**
+ * Serialize a domain Node to the strict API format (Schemas["Node"]).
+ * Strips hidden parameters (those whose activationRules are not met). The
+ * `isToolInput` flag is threaded into activation evaluation so rules like
+ * `isControlFlow` / `isToolInput` resolve correctly per-instance.
+ */
+export declare function serialize(node: Node, isToolInput: boolean): ApiNode;
+/**
+ * Convert a strict API Node to a domain Node (NodeData + position). `resolveFunctionInfo`
+ * is required only for `FunctionCall` nodes — see {@link ResolveFunctionInfo}.
+ */
+export declare function deserialize(apiNode: ApiNode, resolveFunctionInfo?: ResolveFunctionInfo): Node;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/node/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/node/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAY,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAmBnE;AA8PD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAE7F"}