@foresthubai/workflow-core 0.4.3 → 0.4.5

package/src/node/NodeRegistry.ts

@@ -1,85 +1,88 @@
-import { ReadPinNodeDefinition, SerialReadNodeDefinition, RetrieverNodeDefinition, WebFetchNodeDefinition } from "./InputNode";
-import { AgentNodeDefinition } from "./AgentNode";
-import {
-  DelayNodeDefinition,
-  TickerNodeDefinition,
-  AlarmNodeDefinition,
-  OnFunctionCallNodeDefinition,
-  OnStartupNodeDefinition,
-  OnPinEdgeNodeDefinition,
-  OnSerialReceiveNodeDefinition,
-  OnThresholdNodeDefinition,
-} from "./TriggerNode";
-import { WebSearchToolNodeDefinition } from "./ToolNode";
-import { NodeType } from "./Node";
-import { NodeCategory } from "./constants";
-import { SerialWriteNodeDefinition, WritePinNodeDefinition } from "./OutputNode";
-import { IfNodeDefinition } from "./LogicNode";
-import { SetVariableNodeDefinition } from "./DataNode";
-import { MqttPublishNodeDefinition, OnMqttMessageNodeDefinition } from "./MqttNode";
-import { NodeDefinition } from "./NodeDefinition";
-
-/**
- * Central registry for all node definitions.
- */
-class NodeDefinitionRegistry {
-  private nodes: Map<NodeType, NodeDefinition> = new Map();
-  private initialized = false;
-
-  initialize() {
-    if (this.initialized) return;
-
-    // Register all nodes
-    this.register(ReadPinNodeDefinition);
-    this.register(SerialReadNodeDefinition);
-    this.register(WritePinNodeDefinition);
-    this.register(SerialWriteNodeDefinition);
-    this.register(AgentNodeDefinition);
-    this.register(IfNodeDefinition);
-    this.register(SetVariableNodeDefinition);
-    // Register trigger nodes
-    this.register(OnFunctionCallNodeDefinition);
-    this.register(DelayNodeDefinition);
-    this.register(TickerNodeDefinition);
-    this.register(AlarmNodeDefinition);
-    this.register(OnStartupNodeDefinition);
-    this.register(OnPinEdgeNodeDefinition);
-    this.register(OnSerialReceiveNodeDefinition);
-    this.register(OnThresholdNodeDefinition);
-    // Register tool nodes
-    this.register(WebSearchToolNodeDefinition);
-    // Register input tool nodes
-    this.register(RetrieverNodeDefinition);
-    this.register(WebFetchNodeDefinition);
-    // Register MQTT nodes
-    this.register(MqttPublishNodeDefinition);
-    this.register(OnMqttMessageNodeDefinition);
-
-    this.initialized = true;
-  }
-
-  private register(definition: NodeDefinition) {
-    this.nodes.set(definition.type, definition);
-  }
-
-  getAll(): NodeDefinition[] {
-    return Array.from(this.nodes.values());
-  }
-
-  getAllCategories(): NodeCategory[] {
-    const categories = new Set(this.getAll().map((node) => node.category));
-    return Array.from(categories).sort();
-  }
-
-  getByType(type: NodeType): NodeDefinition | undefined {
-    return this.nodes.get(type);
-  }
-
-  getByCategory(category: NodeCategory): NodeDefinition[] {
-    return this.getAll().filter((node) => node.category === category);
-  }
-}
-
-// Create and initialize the registry
-export const NodeRegistry = new NodeDefinitionRegistry();
-NodeRegistry.initialize();
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
+import { ReadPinNodeDefinition, SerialReadNodeDefinition, RetrieverNodeDefinition, WebFetchNodeDefinition } from "./InputNode";
+import { AgentNodeDefinition } from "./AgentNode";
+import {
+  DelayNodeDefinition,
+  TickerNodeDefinition,
+  AlarmNodeDefinition,
+  OnFunctionCallNodeDefinition,
+  OnStartupNodeDefinition,
+  OnPinEdgeNodeDefinition,
+  OnSerialReceiveNodeDefinition,
+  OnThresholdNodeDefinition,
+} from "./TriggerNode";
+import { WebSearchToolNodeDefinition } from "./ToolNode";
+import { NodeType } from "./Node";
+import { NodeCategory } from "./constants";
+import { SerialWriteNodeDefinition, WritePinNodeDefinition } from "./OutputNode";
+import { IfNodeDefinition } from "./LogicNode";
+import { SetVariableNodeDefinition } from "./DataNode";
+import { MqttPublishNodeDefinition, OnMqttMessageNodeDefinition } from "./MqttNode";
+import { NodeDefinition } from "./NodeDefinition";
+
+/**
+ * Central registry for all node definitions.
+ */
+class NodeDefinitionRegistry {
+  private nodes: Map<NodeType, NodeDefinition> = new Map();
+  private initialized = false;
+
+  initialize() {
+    if (this.initialized) return;
+
+    // Register all nodes
+    this.register(ReadPinNodeDefinition);
+    this.register(SerialReadNodeDefinition);
+    this.register(WritePinNodeDefinition);
+    this.register(SerialWriteNodeDefinition);
+    this.register(AgentNodeDefinition);
+    this.register(IfNodeDefinition);
+    this.register(SetVariableNodeDefinition);
+    // Register trigger nodes
+    this.register(OnFunctionCallNodeDefinition);
+    this.register(DelayNodeDefinition);
+    this.register(TickerNodeDefinition);
+    this.register(AlarmNodeDefinition);
+    this.register(OnStartupNodeDefinition);
+    this.register(OnPinEdgeNodeDefinition);
+    this.register(OnSerialReceiveNodeDefinition);
+    this.register(OnThresholdNodeDefinition);
+    // Register tool nodes
+    this.register(WebSearchToolNodeDefinition);
+    // Register input tool nodes
+    this.register(RetrieverNodeDefinition);
+    this.register(WebFetchNodeDefinition);
+    // Register MQTT nodes
+    this.register(MqttPublishNodeDefinition);
+    this.register(OnMqttMessageNodeDefinition);
+
+    this.initialized = true;
+  }
+
+  private register(definition: NodeDefinition) {
+    this.nodes.set(definition.type, definition);
+  }
+
+  getAll(): NodeDefinition[] {
+    return Array.from(this.nodes.values());
+  }
+
+  getAllCategories(): NodeCategory[] {
+    const categories = new Set(this.getAll().map((node) => node.category));
+    return Array.from(categories).sort();
+  }
+
+  getByType(type: NodeType): NodeDefinition | undefined {
+    return this.nodes.get(type);
+  }
+
+  getByCategory(category: NodeCategory): NodeDefinition[] {
+    return this.getAll().filter((node) => node.category === category);
+  }
+}
+
+// Create and initialize the registry
+export const NodeRegistry = new NodeDefinitionRegistry();
+NodeRegistry.initialize();

package/src/node/OutputNode.ts

@@ -1,87 +1,90 @@
-import { NodeBase } from "./Node";
-import type { Expression } from "../api";
-import { NodeCategory, NodeTag } from "./constants";
-import { NodeDefinition } from "./NodeDefinition";
-
-export interface WritePinNode extends NodeBase {
-  type: "WritePin";
-  arguments: {
-    pinReference: string | undefined;
-    signalType: "digital" | "analog";
-    value: Expression;
-  };
-}
-
-export interface SerialWriteNode extends NodeBase {
-  type: "SerialWrite";
-  arguments: {
-    portReference: string | undefined;
-    value: Expression; // Expression for the value to write
-  };
-}
-
-export type OutputNodeType = "WritePin" | "SerialWrite";
-export type OutputNode = WritePinNode | SerialWriteNode;
-
-// Node Definitions
-
-export const WritePinNodeDefinition: NodeDefinition = {
-  type: "WritePin",
-  label: "Write Pin",
-  category: NodeCategory.Output,
-  tags: [NodeTag.Pin],
-  description: "Write data to a pin",
-  parameters: [
-    {
-      id: "pinReference",
-      label: "Pin",
-      description: "IO pin to write to",
-      type: "channelSelect",
-      channelType: (args) => ((args as WritePinNode["arguments"]).signalType === "digital" ? ["GPIOOUT"] : ["PWM", "DAC"]),
-    },
-    {
-      id: "signalType",
-      label: "Signal Type",
-      description: "Type of signal",
-      type: "selection",
-      default: "digital",
-      options: [
-        { value: "digital", label: "Digital" },
-        { value: "analog", label: "Analog" },
-      ],
-    },
-    {
-      id: "value",
-      label: "Value",
-      description: "What value to write to the pin",
-      type: "expression",
-      expressionType: (args) => ((args as WritePinNode["arguments"]).signalType === "digital" ? "bool" : "int"),
-      default: { expression: "", references: [], dataType: "bool" },
-    },
-  ],
-};
-
-export const SerialWriteNodeDefinition: NodeDefinition = {
-  type: "SerialWrite",
-  label: "Serial Write",
-  category: NodeCategory.Output,
-  tags: [NodeTag.Serial],
-  description: "Write string to serial port",
-  parameters: [
-    {
-      id: "portReference",
-      label: "Port",
-      description: "Serial port to write to",
-      type: "channelSelect",
-      channelType: ["UART"],
-    },
-    {
-      id: "value",
-      label: "Value",
-      description: "Expression for the value to write",
-      type: "expression",
-      expressionType: "string",
-      default: { expression: "", references: [], dataType: "string" },
-    },
-  ],
-};
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
+import { NodeBase } from "./Node";
+import type { Expression } from "../api";
+import { NodeCategory, NodeTag } from "./constants";
+import { NodeDefinition } from "./NodeDefinition";
+
+export interface WritePinNode extends NodeBase {
+  type: "WritePin";
+  arguments: {
+    pinReference: string | undefined;
+    signalType: "digital" | "analog";
+    value: Expression;
+  };
+}
+
+export interface SerialWriteNode extends NodeBase {
+  type: "SerialWrite";
+  arguments: {
+    portReference: string | undefined;
+    value: Expression; // Expression for the value to write
+  };
+}
+
+export type OutputNodeType = "WritePin" | "SerialWrite";
+export type OutputNode = WritePinNode | SerialWriteNode;
+
+// Node Definitions
+
+export const WritePinNodeDefinition: NodeDefinition = {
+  type: "WritePin",
+  label: "Write Pin",
+  category: NodeCategory.Output,
+  tags: [NodeTag.Pin],
+  description: "Write data to a pin",
+  parameters: [
+    {
+      id: "pinReference",
+      label: "Pin",
+      description: "IO pin to write to",
+      type: "channelSelect",
+      channelType: (args) => ((args as WritePinNode["arguments"]).signalType === "digital" ? ["GPIOOUT"] : ["PWM", "DAC"]),
+    },
+    {
+      id: "signalType",
+      label: "Signal Type",
+      description: "Type of signal",
+      type: "selection",
+      default: "digital",
+      options: [
+        { value: "digital", label: "Digital" },
+        { value: "analog", label: "Analog" },
+      ],
+    },
+    {
+      id: "value",
+      label: "Value",
+      description: "What value to write to the pin",
+      type: "expression",
+      expressionType: (args) => ((args as WritePinNode["arguments"]).signalType === "digital" ? "bool" : "int"),
+      default: { expression: "", references: [], dataType: "bool" },
+    },
+  ],
+};
+
+export const SerialWriteNodeDefinition: NodeDefinition = {
+  type: "SerialWrite",
+  label: "Serial Write",
+  category: NodeCategory.Output,
+  tags: [NodeTag.Serial],
+  description: "Write string to serial port",
+  parameters: [
+    {
+      id: "portReference",
+      label: "Port",
+      description: "Serial port or log channel to write to",
+      type: "channelSelect",
+      channelType: ["UART", "LOG"],
+    },
+    {
+      id: "value",
+      label: "Value",
+      description: "Expression for the value to write",
+      type: "expression",
+      expressionType: "string",
+      default: { expression: "", references: [], dataType: "string" },
+    },
+  ],
+};

package/src/node/ToolNode.ts

@@ -1,32 +1,35 @@
-import { NodeBase } from "./Node";
-import { NodeCategory } from "./constants";
-import { NodeDefinition } from "./NodeDefinition";
-
-// Web Search Tool - provides web search capability to agents
-export interface WebSearchToolNode extends NodeBase {
-  type: "WebSearchTool";
-  arguments: {
-    maxResults?: number;
-  };
-}
-
-export type ToolNodeType = "WebSearchTool";
-export type ToolNode = WebSearchToolNode;
-
-// Node Definitions
-
-export const WebSearchToolNodeDefinition: NodeDefinition = {
-  type: "WebSearchTool",
-  label: "Web Search",
-  category: NodeCategory.Tool,
-  description: "Provides web search capability to connected agents",
-  parameters: [
-    {
-      id: "maxResults",
-      label: "Max Results",
-      description: "Maximum number of search results to return per call (capped at 20)",
-      type: "int",
-      optional: true,
-    },
-  ],
-};
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
+import { NodeBase } from "./Node";
+import { NodeCategory } from "./constants";
+import { NodeDefinition } from "./NodeDefinition";
+
+// Web Search Tool - provides web search capability to agents
+export interface WebSearchToolNode extends NodeBase {
+  type: "WebSearchTool";
+  arguments: {
+    maxResults?: number;
+  };
+}
+
+export type ToolNodeType = "WebSearchTool";
+export type ToolNode = WebSearchToolNode;
+
+// Node Definitions
+
+export const WebSearchToolNodeDefinition: NodeDefinition = {
+  type: "WebSearchTool",
+  label: "Web Search",
+  category: NodeCategory.Tool,
+  description: "Provides web search capability to connected agents",
+  parameters: [
+    {
+      id: "maxResults",
+      label: "Max Results",
+      description: "Maximum number of search results to return per call (capped at 20)",
+      type: "int",
+      optional: true,
+    },
+  ],
+};