@zerowidth/workbench-sdk 2.1.3 → 2.2.0

package/nodes/json-to-xml/json-to-xml.config.json

@@ -8,8 +8,8 @@
     {
       "name": "json",
       "display_name": "JSON",
-      "type": "object",
-      "description": "The JSON object to convert to XML",
+      "type": "object or array of objects",
+      "description": "The JSON object, or array of objects, to convert to XML",
       "required": true
     },
     {

package/nodes/json-to-yaml/json-to-yaml.config.json

@@ -8,8 +8,8 @@
     {
       "name": "json",
       "display_name": "JSON",
-      "type": "object",
-      "description": "The JSON object to convert to YAML",
+      "type": "object or array of objects",
+      "description": "The JSON object, or array of objects, to convert to YAML",
       "required": true
     },
     {

package/nodes/json-to-yaml/json-to-yaml.tests.json

@@ -97,5 +97,14 @@
     "expected": {
       "yaml": "null"
     }
+  },
+  {
+    "description": "Top-level array of objects",
+    "inputs": {
+      "json": [{"name": "Alice"}, {"name": "Bob"}]
+    },
+    "expected": {
+      "yaml": "- name: Alice\n- name: Bob"
+    }
   }
 ]

package/nodes/message/message.config.json

@@ -23,7 +23,7 @@
     {
       "name": "variables",
       "display_name": "Variables",
-      "type": "object",
+      "type": "object or array of objects",
       "allow_multiple": true,
       "description": "Connect key-value pairs to inject into any matched {{key}} in the text content."
     }

package/nodes/message/message.process.js

@@ -2,6 +2,23 @@
  * Process function for the Message node.
  * Outputs a message object, either from the input or from the settings.
  */
+/**
+ * Render a variable value for injection into message text.
+ * Strings pass through untouched; everything else is JSON encoded so that
+ * nested objects and arrays read as data instead of "[object Object]".
+ */
+const renderVariable = (value) => {
+  if (value === null || value === undefined) return "";
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    // Circular structures (or anything else JSON can't encode) fall back to
+    // the default coercion rather than failing the whole message.
+    return String(value);
+  }
+};
+
 export default async ({inputs, settings, config}) => {
 
   // If an input value is provided, use it; otherwise use the value from settings
@@ -17,6 +34,12 @@ export default async ({inputs, settings, config}) => {
   if(!inputs.variables) {
     inputs.variables = [];
   }
+
+  // A single connection can deliver an array of key-value objects, so flatten
+  // one level before looking keys up.
+  const variables = (Array.isArray(inputs.variables) ? inputs.variables : [inputs.variables])
+    .flatMap(entry => Array.isArray(entry) ? entry : [entry])
+    .filter(entry => entry !== null && typeof entry === "object");
   
   // if we have variables and text content, we need to replace the text content with the variables
   // do we have a text content item and what index is it
@@ -25,9 +48,9 @@ export default async ({inputs, settings, config}) => {
     message.content[textContentIndex].text = message.content[textContentIndex].text.replace(/\{\{(.*?)\}\}/g, (match, p1) => {
       
       // look for a variable with the key p1
-      let variable = inputs.variables.find(variable => Object.keys(variable).find(key => key === p1));
+      let variable = variables.find(variable => Object.keys(variable).find(key => key === p1));
       if(variable) {
-        return variable[p1];
+        return renderVariable(variable[p1]);
       }
       return match;
     });

package/nodes/message/message.tests.json

@@ -0,0 +1,85 @@
+[
+  {
+    "description": "String variable is injected as-is",
+    "inputs": {
+      "variables": [
+        {
+          "name": "Ada"
+        }
+      ]
+    },
+    "settings": {
+      "role": "user",
+      "content": "Hello {{name}}!"
+    },
+    "expected": {
+      "message": {
+        "role": "user",
+        "content": [
+          {
+            "type": "text",
+            "text": "Hello Ada!"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "description": "Nested object variable is JSON stringified, not [object Object]",
+    "inputs": {
+      "variables": [
+        {
+          "order": {
+            "id": 7,
+            "paid": true
+          }
+        }
+      ]
+    },
+    "settings": {
+      "role": "user",
+      "content": "Order: {{order}}"
+    },
+    "expected": {
+      "message": {
+        "role": "user",
+        "content": [
+          {
+            "type": "text",
+            "text": "Order: {\n  \"id\": 7,\n  \"paid\": true\n}"
+          }
+        ]
+      }
+    }
+  },
+  {
+    "description": "Array of objects delivered as a single connection is flattened",
+    "inputs": {
+      "variables": [
+        [
+          {
+            "first": "Ada"
+          },
+          {
+            "last": "Lovelace"
+          }
+        ]
+      ]
+    },
+    "settings": {
+      "role": "user",
+      "content": "{{first}} {{last}}"
+    },
+    "expected": {
+      "message": {
+        "role": "user",
+        "content": [
+          {
+            "type": "text",
+            "text": "Ada Lovelace"
+          }
+        ]
+      }
+    }
+  }
+]

package/nodes/object-merge/object-merge.config.json

@@ -8,8 +8,8 @@
     {
       "name": "objects",
       "display_name": "Objects",
-      "type": "object",
-      "description": "Objects to merge (later objects override earlier ones)",
+      "type": "object or array of objects",
+      "description": "Objects to merge, individually or as arrays of objects (later objects override earlier ones)",
       "required": true,
       "allow_multiple": true
     },

package/nodes/object-merge/object-merge.process.js

@@ -2,8 +2,12 @@ export default async ({ inputs, settings, config }) => {
   const objects = inputs.objects;
   const arrayMode = inputs.array_mode ?? "replace";
 
-  // Normalize to array
-  const objectList = Array.isArray(objects) ? objects : [objects];
+  // Normalize to a flat array. A single connection can deliver an array of
+  // objects, and a multi-connection input can deliver arrays alongside plain
+  // objects, so flatten one level before filtering.
+  const objectList = (Array.isArray(objects) ? objects : [objects]).flatMap(
+    (entry) => (Array.isArray(entry) ? entry : [entry])
+  );
 
   // Filter out non-objects
   const validObjects = objectList.filter(

package/nodes/object-merge/object-merge.tests.json

@@ -142,5 +142,17 @@
     "expected": {
       "merged": {"level1": {"level2": {"level3": {"a": 1, "b": 2, "c": 3}}}}
     }
+  },
+  {
+    "description": "Array of objects delivered as a single connection is flattened",
+    "inputs": {
+      "objects": [
+        [{"a": 1}, {"b": 2}],
+        {"c": 3}
+      ]
+    },
+    "expected": {
+      "merged": {"a": 1, "b": 2, "c": 3}
+    }
   }
 ]

package/nodes/string-template/string-template.config.json

@@ -14,8 +14,8 @@
     {
       "name": "variables",
       "display_name": "Variables",
-      "description": "Object containing variable values",
-      "type": "object",
+      "description": "Object containing variable values, or an array of such objects to merge",
+      "type": "object or array of objects",
       "required": true
     }
   ],

package/nodes/string-template/string-template.process.js

@@ -1,15 +1,43 @@
+/**
+ * Render a variable value for injection into the template.
+ * Strings pass through untouched; everything else is JSON encoded so that
+ * nested objects and arrays read as data instead of "[object Object]".
+ */
+const renderVariable = (value) => {
+  if (value === null || value === undefined) return "";
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    // Circular structures (or anything else JSON can't encode) fall back to
+    // the default coercion rather than failing the whole template.
+    return String(value);
+  }
+};
+
 export default async ({inputs, settings, config}) => {
 
   const template = String(inputs.template || "");
-  const variables = inputs.variables || {};
+
+  // The input may arrive as a single object, or as an array of objects when
+  // it's fed from an "array of objects" output. Merge arrays into one lookup.
+  const raw = inputs.variables || {};
+  const variables = Array.isArray(raw)
+    ? raw.reduce((acc, entry) => {
+        if (Array.isArray(entry)) return Object.assign(acc, ...entry.filter(e => e && typeof e === "object"));
+        if (entry && typeof entry === "object") return Object.assign(acc, entry);
+        return acc;
+      }, {})
+    : raw;
+
   const keepMissing = settings.keep_missing || false;
-  
+
   const text = template.replace(/\{([^}]+)\}/g, (match, key) => {
     if (key in variables) {
-      return String(variables[key]);
+      return renderVariable(variables[key]);
     }
     return keepMissing ? match : "";
   });
-  
+
   return { text };
-}; 
+};

package/nodes/string-template/string-template.tests.json

@@ -59,5 +59,57 @@
     "expected": {
       "text": "Hello World! "
     }
+  },
+  {
+    "description": "Object variable is JSON stringified, not [object Object]",
+    "inputs": {
+      "template": "Config: {config}",
+      "variables": {"config": {"host": "localhost", "port": 8080}}
+    },
+    "settings": {
+      "keep_missing": false
+    },
+    "expected": {
+      "text": "Config: {\n  \"host\": \"localhost\",\n  \"port\": 8080\n}"
+    }
+  },
+  {
+    "description": "Array variable is JSON stringified",
+    "inputs": {
+      "template": "Items: {items}",
+      "variables": {"items": [1, 2]}
+    },
+    "settings": {
+      "keep_missing": false
+    },
+    "expected": {
+      "text": "Items: [\n  1,\n  2\n]"
+    }
+  },
+  {
+    "description": "Array of objects input is merged into one lookup",
+    "inputs": {
+      "template": "{greeting} {name}!",
+      "variables": [{"greeting": "Hello"}, {"name": "World"}]
+    },
+    "settings": {
+      "keep_missing": false
+    },
+    "expected": {
+      "text": "Hello World!"
+    }
+  },
+  {
+    "description": "Null variable renders as empty string",
+    "inputs": {
+      "template": "Value: {value}.",
+      "variables": {"value": null}
+    },
+    "settings": {
+      "keep_missing": false
+    },
+    "expected": {
+      "text": "Value: ."
+    }
   }
 ] 

package/nodes/system-prompt/system-prompt.config.json

@@ -13,7 +13,7 @@
     {
       "name": "variables",
       "display_name": "Variables",
-      "type": "object",
+      "type": "object or array of objects",
       "allow_multiple": true,
       "description": "Connect key-value pairs to inject into any matched {{key}} in the text content."
     },

package/nodes/system-prompt/system-prompt.process.js

@@ -2,12 +2,35 @@
  * Process function for the System Prompt node.
  * Outputs a message object, containing the prompt text and system role and text
  */
+/**
+ * Render a variable value for injection into prompt text.
+ * Strings pass through untouched; everything else is JSON encoded so that
+ * nested objects and arrays read as data instead of "[object Object]".
+ */
+const renderVariable = (value) => {
+  if (value === null || value === undefined) return "";
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    // Circular structures (or anything else JSON can't encode) fall back to
+    // the default coercion rather than failing the whole prompt.
+    return String(value);
+  }
+};
+
 export default async ({inputs, settings, config}) => {
   // Initialize variables array if not provided
   if(!inputs.variables) {
     inputs.variables = [];
   }
 
+  // A single connection can deliver an array of key-value objects, so flatten
+  // one level before looking keys up.
+  const variables = (Array.isArray(inputs.variables) ? inputs.variables : [inputs.variables])
+    .flatMap(entry => Array.isArray(entry) ? entry : [entry])
+    .filter(entry => entry !== null && typeof entry === "object");
+
   // Get the base content from settings
   let baseContent = settings.content || "";
 
@@ -47,9 +70,9 @@ export default async ({inputs, settings, config}) => {
   // Process variables
   message.content[0].text = message.content[0].text.replace(/\{\{(.*?)\}\}/g, (match, p1) => {
     // look for a variable with the key p1
-    let variable = inputs.variables.find(variable => Object.keys(variable).find(key => key === p1));
+    let variable = variables.find(variable => Object.keys(variable).find(key => key === p1));
     if(variable) {
-      return variable[p1];
+      return renderVariable(variable[p1]);
     }
     return match;
   });

package/nodes/system-prompt/system-prompt.tests.json

@@ -0,0 +1,113 @@
+[
+  {
+    "description": "String variable is injected as-is",
+    "inputs": {
+      "variables": [
+        {
+          "name": "Ada"
+        }
+      ]
+    },
+    "settings": {
+      "content": "Hello {{name}}!"
+    },
+    "expected": {
+      "message": {
+        "role": "system",
+        "content": [
+          {
+            "type": "text",
+            "text": "Hello Ada!"
+          }
+        ]
+      },
+      "prompt": "Hello Ada!"
+    }
+  },
+  {
+    "description": "Nested object variable is JSON stringified, not [object Object]",
+    "inputs": {
+      "variables": [
+        {
+          "profile": {
+            "name": "Ada",
+            "langs": [
+              "js",
+              "py"
+            ]
+          }
+        }
+      ]
+    },
+    "settings": {
+      "content": "Profile: {{profile}}"
+    },
+    "expected": {
+      "message": {
+        "role": "system",
+        "content": [
+          {
+            "type": "text",
+            "text": "Profile: {\n  \"name\": \"Ada\",\n  \"langs\": [\n    \"js\",\n    \"py\"\n  ]\n}"
+          }
+        ]
+      },
+      "prompt": "Profile: {\n  \"name\": \"Ada\",\n  \"langs\": [\n    \"js\",\n    \"py\"\n  ]\n}"
+    }
+  },
+  {
+    "description": "Array of objects delivered as a single connection is flattened",
+    "inputs": {
+      "variables": [
+        [
+          {
+            "first": "Ada"
+          },
+          {
+            "last": "Lovelace"
+          }
+        ]
+      ]
+    },
+    "settings": {
+      "content": "{{first}} {{last}}"
+    },
+    "expected": {
+      "message": {
+        "role": "system",
+        "content": [
+          {
+            "type": "text",
+            "text": "Ada Lovelace"
+          }
+        ]
+      },
+      "prompt": "Ada Lovelace"
+    }
+  },
+  {
+    "description": "Unmatched placeholder is left intact",
+    "inputs": {
+      "variables": [
+        {
+          "name": "Ada"
+        }
+      ]
+    },
+    "settings": {
+      "content": "Hello {{missing}}!"
+    },
+    "expected": {
+      "message": {
+        "role": "system",
+        "content": [
+          {
+            "type": "text",
+            "text": "Hello {{missing}}!"
+          }
+        ]
+      },
+      "prompt": "Hello {{missing}}!"
+    }
+  }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerowidth/workbench-sdk",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "dependencies": {
     "adm-zip": "^0.5.16",
     "ajv": "^8.17.1",