@zerowidth/workbench-sdk 2.0.0-alpha.0

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

@@ -0,0 +1,174 @@
+[
+  {
+    "description": "Merge consecutive user messages",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": "How are you?"},
+        {"role": "assistant", "content": "I'm doing well"},
+        {"role": "user", "content": "That's great!"}
+      ]
+    },
+    "expected": {
+      "original_count": 4,
+      "merged_count": 3,
+      "merges_performed": 1
+    }
+  },
+  {
+    "description": "Merge multiple consecutive messages",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": "How are you?"},
+        {"role": "user", "content": "I hope you're doing well"},
+        {"role": "assistant", "content": "I'm doing great"},
+        {"role": "assistant", "content": "Thank you for asking"},
+        {"role": "user", "content": "You're welcome"}
+      ]
+    },
+    "expected": {
+      "original_count": 6,
+      "merged_count": 3,
+      "merges_performed": 3
+    }
+  },
+  {
+    "description": "No consecutive messages to merge",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "assistant", "content": "Hi there"},
+        {"role": "user", "content": "How are you?"},
+        {"role": "assistant", "content": "I'm doing well"}
+      ]
+    },
+    "expected": {
+      "original_count": 4,
+      "merged_count": 4,
+      "merges_performed": 0
+    }
+  },
+  {
+    "description": "Merge with custom separator",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": "World"}
+      ],
+      "settings": {
+        "separator": " | "
+      }
+    },
+    "expected": {
+      "original_count": 2,
+      "merged_count": 1,
+      "merges_performed": 1
+    }
+  },
+  {
+    "description": "Merge multi-modal content with structure preserved",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": [{"type": "text", "text": "Hello"}]},
+        {"role": "user", "content": [{"type": "text", "text": "World"}]}
+      ],
+      "settings": {
+        "preserve_structure": true
+      }
+    },
+    "expected": {
+      "original_count": 2,
+      "merged_count": 1,
+      "merges_performed": 1
+    }
+  },
+  {
+    "description": "Merge multi-modal content flattened to text",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": [{"type": "text", "text": "Hello"}]},
+        {"role": "user", "content": [{"type": "text", "text": "World"}]}
+      ],
+      "settings": {
+        "preserve_structure": false
+      }
+    },
+    "expected": {
+      "original_count": 2,
+      "merged_count": 1,
+      "merges_performed": 1
+    }
+  },
+  {
+    "description": "Handle mixed content types",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": [{"type": "text", "text": "World"}]}
+      ]
+    },
+    "expected": {
+      "original_count": 2,
+      "merged_count": 1,
+      "merges_performed": 1
+    }
+  },
+  {
+    "description": "Handle empty message array",
+    "inputs": {
+      "messages": []
+    },
+    "expected": {
+      "original_count": 0,
+      "merged_count": 0,
+      "merges_performed": 0
+    }
+  },
+  {
+    "description": "Handle single message",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"}
+      ]
+    },
+    "expected": {
+      "original_count": 1,
+      "merged_count": 1,
+      "merges_performed": 0
+    }
+  },
+  {
+    "description": "Handle invalid messages gracefully - invalid messages break consecutive sequence",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        null,
+        {"role": "user", "content": "World"},
+        {"role": "assistant", "content": "Hi"}
+      ]
+    },
+    "expected": {
+      "original_count": 4,
+      "merged_count": 4,
+      "merges_performed": 0
+    }
+  },
+  {
+    "description": "Handle invalid messages with actual consecutive messages",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": "How are you?"},
+        null,
+        {"role": "assistant", "content": "I'm doing well"},
+        {"role": "assistant", "content": "Thank you"}
+      ]
+    },
+    "expected": {
+      "original_count": 5,
+      "merged_count": 3,
+      "merges_performed": 2
+    }
+  }
+]

package/nodes/message/message.config.json

@@ -0,0 +1,57 @@
+{
+  "display_name": "Message",
+  "tagline": "Create a message",
+  "description": "Manually create a single message.",
+  "icon": "fa-comment",
+  "category": "messages",
+  "custom_render_height": 200,
+  "is_constant": true,
+  "is_resizable": true,
+  "inputs": [
+    {
+      "name": "role",
+      "display_name": "Role",
+      "type": "string",
+      "description": "Optional way to override the role setting of this message."
+    },
+    {
+      "name": "content",
+      "display_name": "Content",
+      "type": "array of content or string",
+      "description": "Optional way to override the content setting of this message."
+    },
+    {
+      "name": "variables",
+      "display_name": "Variables",
+      "type": "object",
+      "allow_multiple": true,
+      "description": "Connect key-value pairs to inject into any matched {{key}} in the text content."
+    }
+  ],
+  "outputs": [
+    {
+      "name": "message",
+      "display_name": "Message",
+      "type": "message",
+      "description": "The message object."
+    }
+  ],
+  "settings": [
+    {
+      "name": "role",
+      "display_name": "Role",
+      "type": "string",
+      "description": "The role of the message.",
+      "required": true
+    },
+    {
+      "name": "content",
+      "display_name": "Content",
+      "type": "array of content or string",
+      "description": "The content of the message, can be made of text, images, or other types.",
+      "required": true
+    }
+  ],
+  "timeout": 3000,
+  "retry_limit": 3
+}

package/nodes/message/message.process.js

@@ -0,0 +1,40 @@
+/**
+ * Process function for the Message node.
+ * Outputs a message object, either from the input or from the settings.
+ */
+export default async ({inputs, settings, config}) => {
+
+  // If an input value is provided, use it; otherwise use the value from settings
+  let message = {
+    role: inputs.role !== undefined ? inputs.role : settings.role,
+    content: inputs.content !== undefined ? inputs.content : settings.content
+  }
+
+  if(typeof message.content === 'string') {
+    message.content = [{ type: 'text', text: message.content }];
+  }
+
+  if(!inputs.variables) {
+    inputs.variables = [];
+  }
+  
+  // 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
+  let textContentIndex = message.content.findIndex(item => item.type === 'text');
+  if(textContentIndex !== -1) {
+    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));
+      if(variable) {
+        return variable[p1];
+      }
+      return match;
+    });
+  }
+  
+  // Return the string value
+  return {
+    message: message  
+  };
+}; 

package/nodes/message-bus/message-bus.config.json

@@ -0,0 +1,103 @@
+{
+  "display_name": "Message Bus",
+  "tagline": "Combine message sources",
+  "description": "Combine messages from multiple sources into a single message array. Supports daisy-chaining and flexible input handling.",
+  "icon": "bus",
+  "category": "messages",
+  "inputs": [
+    {
+      "name": "input_1",
+      "display_name": "Input 1",
+      "type": "message or conversation or string",
+      "description": "First message source",
+      "required": false
+    },
+    {
+      "name": "input_2",
+      "display_name": "Input 2",
+      "type": "message or conversation or string",
+      "description": "Second message source",
+      "required": false
+    },
+    {
+      "name": "input_3",
+      "display_name": "Input 3",
+      "type": "message or conversation or string",
+      "description": "Third message source",
+      "required": false
+    },
+    {
+      "name": "input_4",
+      "display_name": "Input 4",
+      "type": "message or conversation or string",
+      "description": "Fourth message source",
+      "required": false
+    },
+    {
+      "name": "input_5",
+      "display_name": "Input 5",
+      "type": "message or conversation or string",
+      "description": "Fifth message source",
+      "required": false
+    },
+    {
+      "name": "input_6",
+      "display_name": "Input 6",
+      "type": "message or conversation or string",
+      "description": "Sixth message source",
+      "required": false
+    },
+    {
+      "name": "input_7",
+      "display_name": "Input 7",
+      "type": "message or conversation or string",
+      "description": "Seventh message source",
+      "required": false
+    },
+    {
+      "name": "input_8",
+      "display_name": "Input 8",
+      "type": "message or conversation or string",
+      "description": "Eighth message source",
+      "required": false
+    }
+  ],
+  "outputs": [
+    {
+      "name": "messages",
+      "display_name": "Messages",
+      "type": "conversation",
+      "description": "Combined array of all messages from all inputs"
+    },
+    {
+      "name": "message_count",
+      "display_name": "Message Count",
+      "type": "number",
+      "description": "Total number of messages in the output"
+    },
+    {
+      "name": "inputs_used",
+      "display_name": "Inputs Used",
+      "type": "number",
+      "description": "Number of non-empty inputs that contributed messages"
+    }
+  ],
+  "settings": [
+    {
+      "name": "preserve_order",
+      "display_name": "Preserve Order",
+      "type": "boolean",
+      "description": "Whether to maintain the order of inputs when combining messages",
+      "default": true,
+      "required": true
+    },
+    {
+      "name": "filter_empty",
+      "display_name": "Filter Empty",
+      "type": "boolean",
+      "description": "Whether to filter out empty or invalid messages",
+      "default": true,
+      "required": true
+    }
+  ]
+}

package/nodes/message-bus/message-bus.process.js

@@ -0,0 +1,69 @@
+export default async ({inputs, settings, config}) => {
+    try {
+        const preserveOrder = settings.preserve_order !== false;
+        const filterEmpty = settings.filter_empty !== false;
+
+        // Helper function to extract messages from input
+        const extractMessages = (input) => {
+            if (!input) return [];
+            
+            if (Array.isArray(input)) {
+                return input;
+            } else if (typeof input === 'object' && input.role) {
+                return [input];
+            } else if (typeof input === 'string') {
+                // Convert string to user message
+                return [{
+                    role: 'user',
+                    content: input
+                }];
+            } else {
+                return [];
+            }
+        };
+
+        // Helper function to filter empty messages
+        const filterMessages = (messages) => {
+            if (!filterEmpty) return messages;
+            
+            return messages.filter(message => {
+                if (!message) return false;
+                if (typeof message !== 'object') return false;
+                if (!message.role) return false;
+                if (message.content === undefined || message.content === null) return false;
+                if (typeof message.content === 'string' && message.content.trim() === '') return false;
+                if (Array.isArray(message.content) && message.content.length === 0) return false;
+                return true;
+            });
+        };
+
+        const allMessages = [];
+        let inputsUsed = 0;
+
+        // Process inputs in order (input_1 through input_8)
+        const inputKeys = ['input_1', 'input_2', 'input_3', 'input_4', 'input_5', 'input_6', 'input_7', 'input_8'];
+        
+        for (const inputKey of inputKeys) {
+            const input = inputs[inputKey];
+            const messages = extractMessages(input);
+            
+            if (messages.length > 0) {
+                const filteredMessages = filterMessages(messages);
+                if (filteredMessages.length > 0) {
+                    allMessages.push(...filteredMessages);
+                    inputsUsed++;
+                }
+            }
+        }
+
+        return {
+            messages: allMessages,
+            message_count: allMessages.length,
+            inputs_used: inputsUsed
+        };
+
+    } catch (error) {
+        console.log('Message Bus error:', error);
+        throw new Error(`Message Bus error: ${error.message}`);
+    }
+};

package/nodes/message-bus/message-bus.tests.json

@@ -0,0 +1,150 @@
+[
+  {
+    "description": "Combine messages from multiple inputs",
+    "inputs": {
+      "input_1": [{"role": "user", "content": "Hello"}],
+      "input_2": [{"role": "assistant", "content": "Hi there"}],
+      "input_3": [{"role": "user", "content": "How are you?"}]
+    },
+    "expected": {
+      "message_count": 3,
+      "inputs_used": 3
+    }
+  },
+  {
+    "description": "Handle single messages and arrays",
+    "inputs": {
+      "input_1": {"role": "user", "content": "Hello"},
+      "input_2": [{"role": "assistant", "content": "Hi"}, {"role": "user", "content": "How are you?"}],
+      "input_3": {"role": "assistant", "content": "I'm doing well"}
+    },
+    "expected": {
+      "message_count": 4,
+      "inputs_used": 3
+    }
+  },
+  {
+    "description": "Handle empty inputs gracefully",
+    "inputs": {
+      "input_1": [{"role": "user", "content": "Hello"}],
+      "input_2": null,
+      "input_3": [],
+      "input_4": [{"role": "assistant", "content": "Hi there"}]
+    },
+    "expected": {
+      "message_count": 2,
+      "inputs_used": 2
+    }
+  },
+  {
+    "description": "Use only some inputs",
+    "inputs": {
+      "input_1": [{"role": "user", "content": "Hello"}],
+      "input_5": [{"role": "assistant", "content": "Hi"}],
+      "input_8": [{"role": "user", "content": "How are you?"}]
+    },
+    "expected": {
+      "message_count": 3,
+      "inputs_used": 3
+    }
+  },
+  {
+    "description": "Filter empty messages when filter_empty is true",
+    "inputs": {
+      "input_1": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": ""},
+        {"role": "assistant", "content": "Hi"}
+      ],
+      "input_2": [
+        {"role": "user", "content": "How are you?"},
+        null,
+        {"role": "assistant", "content": "I'm doing well"}
+      ]
+    },
+    "settings": {
+      "filter_empty": true
+    },
+    "expected": {
+      "message_count": 4,
+      "inputs_used": 2
+    }
+  },
+  {
+    "description": "Don't filter empty messages when filter_empty is false",
+    "inputs": {
+      "input_1": [
+        {"role": "user", "content": "Hello"},
+        {"role": "user", "content": ""},
+        {"role": "assistant", "content": "Hi"}
+      ]
+    },
+    "settings": {
+      "filter_empty": false
+    },
+    "expected": {
+      "message_count": 3,
+      "inputs_used": 1
+    }
+  },
+  {
+    "description": "Handle all empty inputs",
+    "inputs": {
+      "input_1": null,
+      "input_2": [],
+      "input_3": null
+    },
+    "expected": {
+      "message_count": 0,
+      "inputs_used": 0
+    }
+  },
+  {
+    "description": "Daisy-chain simulation - first bus",
+    "inputs": {
+      "input_1": [{"role": "system", "content": "You are helpful"}],
+      "input_2": [{"role": "user", "content": "Hello"}]
+    },
+    "expected": {
+      "message_count": 2,
+      "inputs_used": 2
+    }
+  },
+  {
+    "description": "Daisy-chain simulation - second bus",
+    "inputs": {
+      "input_1": [{"role": "assistant", "content": "Hi there"}],
+      "input_2": [{"role": "user", "content": "How are you?"}],
+      "input_3": [{"role": "assistant", "content": "I'm doing well"}]
+    },
+    "expected": {
+      "message_count": 3,
+      "inputs_used": 3
+    }
+  },
+  {
+    "description": "Complex multi-modal content",
+    "inputs": {
+      "input_1": [{"role": "user", "content": "Hello"}],
+      "input_2": [{"role": "user", "content": [{"type": "text", "text": "How are you?"}, {"type": "image_url", "image_url": {"url": "https://example.com/image.png"}}]}],
+      "input_3": [{"role": "assistant", "content": "I'm doing well, thanks for the image!"}]
+    },
+    "expected": {
+      "message_count": 3,
+      "inputs_used": 3
+    }
+  },
+  {
+    "description": "Handle string inputs by converting to user messages",
+    "inputs": {
+      "input_1": "Hello, this is a string input",
+      "input_2": [{"role": "assistant", "content": "I'll respond to that"}],
+      "input_3": "Another string input",
+      "input_4": {"role": "system", "content": "You are helpful"}
+    },
+    "expected": {
+      "message_count": 4,
+      "inputs_used": 4
+    }
+  }
+]

package/nodes/message-role-swap/message-role-swap.config.json

@@ -0,0 +1,26 @@
+{
+  "display_name": "Message Role Swap",
+  "tagline": "Swap message roles",
+  "description": "Swap message roles between assistant and user in a messages array, returning a new array with swapped roles",
+  "icon": "swap-horizontal",
+  "category": "messages",
+  "is_plugin": false,
+  "inputs": [
+    {
+      "name": "messages",
+      "display_name": "Messages",
+      "type": "conversation",
+      "description": "Array of message objects to swap roles",
+      "required": true
+    }
+  ],
+  "outputs": [
+    {
+      "name": "messages",
+      "display_name": "Messages",
+      "type": "conversation",
+      "description": "Array of messages with swapped roles (assistant ↔ user)"
+    }
+  ],
+  "settings": []
+}

package/nodes/message-role-swap/message-role-swap.process.js

@@ -0,0 +1,39 @@
+export default async ({inputs, settings, config, nodeConfig}) => {
+  try {
+    const messages = inputs.messages;
+
+    if (!Array.isArray(messages)) {
+      throw new Error("Messages input must be an array");
+    }
+
+    const swappedMessages = [];
+
+    for (const message of messages) {
+      if (!message || typeof message !== 'object') {
+        // Keep non-object messages as-is
+        swappedMessages.push(message);
+        continue;
+      }
+
+      // Create a copy of the message to avoid mutating the original
+      const swappedMessage = { ...message };
+
+      // Swap roles: assistant ↔ user
+      if (message.role === 'assistant') {
+        swappedMessage.role = 'user';
+      } else if (message.role === 'user') {
+        swappedMessage.role = 'assistant';
+      }
+      // Leave other roles (system, tool, developer) unchanged
+
+      swappedMessages.push(swappedMessage);
+    }
+
+    return {
+      messages: swappedMessages
+    };
+
+  } catch (error) {
+    throw new Error(`Message Role Swap error: ${error.message}`);
+  }
+};