Add input and output descriptions to math nodes

Co-authored-by: leocser632 <leocser632@gmail.com>

Author: cursoragent

apps/api/src/nodes/math/absolute-value-node.ts

@@ -16,8 +16,21 @@ export class AbsoluteValueNode extends ExecutableNode {
     icon: "absolute",
     inlinable: true,
     asTool: true,
-    inputs: [{ name: "value", type: "number", required: true }],
-    outputs: [{ name: "result", type: "number" }],
+    inputs: [
+      {
+        name: "value",
+        type: "number",
+        description: "The number to calculate the absolute value of",
+        required: true,
+      },
+    ],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The absolute value of the input number",
+      },
+    ],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/addition-node.ts

@@ -16,10 +16,26 @@ export class AdditionNode extends ExecutableNode {
     inlinable: true,
     asTool: true,
     inputs: [
-      { name: "a", type: "number", required: true },
-      { name: "b", type: "number", required: true },
+      {
+        name: "a",
+        type: "number",
+        description: "The first number to add",
+        required: true
+      },
+      {
+        name: "b",
+        type: "number",
+        description: "The second number to add",
+        required: true
+      },
+    ],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The sum of the two input numbers",
+      },
     ],
-    outputs: [{ name: "result", type: "number" }],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/avg-node.ts

@@ -26,7 +26,13 @@ export class AvgNode extends ExecutableNode {
         repeated: true,
       },
     ],
-    outputs: [{ name: "result", type: "number" }],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The average (mean) value of the input numbers",
+      },
+    ],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/division-node.ts

@@ -17,10 +17,26 @@ export class DivisionNode extends ExecutableNode {
     inlinable: true,
     asTool: true,
     inputs: [
-      { name: "a", type: "number", required: true },
-      { name: "b", type: "number", required: true },
+      {
+        name: "a",
+        type: "number",
+        description: "The dividend (number to be divided)",
+        required: true
+      },
+      {
+        name: "b",
+        type: "number",
+        description: "The divisor (number to divide by)",
+        required: true
+      },
+    ],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The quotient of a divided by b",
+      },
     ],
-    outputs: [{ name: "result", type: "number" }],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/exponentiation-node.ts

@@ -17,10 +17,26 @@ export class ExponentiationNode extends ExecutableNode {
     inlinable: true,
     asTool: true,
     inputs: [
-      { name: "base", type: "number", required: true },
-      { name: "exponent", type: "number", required: true },
+      {
+        name: "base",
+        type: "number",
+        description: "The base number to be raised to a power",
+        required: true
+      },
+      {
+        name: "exponent",
+        type: "number",
+        description: "The power to raise the base to",
+        required: true
+      },
+    ],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The result of base raised to the power of exponent",
+      },
     ],
-    outputs: [{ name: "result", type: "number" }],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/max-node.ts

@@ -26,7 +26,13 @@ export class MaxNode extends ExecutableNode {
         repeated: true,
       },
     ],
-    outputs: [{ name: "result", type: "number" }],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The maximum value from the input numbers",
+      },
+    ],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/median-node.ts

@@ -27,7 +27,13 @@ export class MedianNode extends ExecutableNode {
         repeated: true,
       },
     ],
-    outputs: [{ name: "result", type: "number" }],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The median value of the input numbers (middle value when sorted)",
+      },
+    ],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/min-node.ts

@@ -26,7 +26,13 @@ export class MinNode extends ExecutableNode {
         repeated: true,
       },
     ],
-    outputs: [{ name: "result", type: "number" }],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The minimum value from the input numbers",
+      },
+    ],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/modulo-node.ts

@@ -18,10 +18,26 @@ export class ModuloNode extends ExecutableNode {
     inlinable: true,
     asTool: true,
     inputs: [
-      { name: "a", type: "number", required: true },
-      { name: "b", type: "number", required: true },
+      {
+        name: "a", 
+        type: "number", 
+        description: "The dividend (number to be divided)",
+        required: true 
+      },
+      {
+        name: "b", 
+        type: "number", 
+        description: "The divisor (number to divide by)",
+        required: true 
+      },
+    ],
+    outputs: [
+      {
+        name: "result", 
+        type: "number",
+        description: "The remainder after dividing a by b",
+      },
     ],
-    outputs: [{ name: "result", type: "number" }],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {

apps/api/src/nodes/math/multiplication-node.ts

@@ -17,10 +17,26 @@ export class MultiplicationNode extends ExecutableNode {
     inlinable: true,
     asTool: true,
     inputs: [
-      { name: "a", type: "number", required: true },
-      { name: "b", type: "number", required: true },
+      {
+        name: "a",
+        type: "number",
+        description: "The first number to multiply",
+        required: true
+      },
+      {
+        name: "b",
+        type: "number",
+        description: "The second number to multiply",
+        required: true
+      },
+    ],
+    outputs: [
+      {
+        name: "result",
+        type: "number",
+        description: "The product of the two input numbers",
+      },
     ],
-    outputs: [{ name: "result", type: "number" }],
   };
 
   async execute(context: NodeContext): Promise<NodeExecution> {