@zerowidth/workbench-sdk 2.0.0-alpha.0

package/nodes/switch/switch.tests.json

@@ -0,0 +1,85 @@
+[
+  {
+    "description": "Basic case matching",
+    "inputs": {
+      "value": "apple",
+      "cases": ["banana", "apple", "orange"],
+      "outputs": ["yellow", "red", "orange"]
+    },
+    "expected": {
+      "result": "red",
+      "case_index": 1,
+      "matched": true,
+      "case_1": true
+    }
+  },
+  {
+    "description": "No match with default",
+    "inputs": {
+      "value": "grape",
+      "cases": ["banana", "apple", "orange"],
+      "outputs": ["yellow", "red", "orange"],
+      "default_output": "purple"
+    },
+    "expected": {
+      "result": "purple",
+      "case_index": -1,
+      "matched": false
+    }
+  },
+  {
+    "description": "Numeric case matching",
+    "inputs": {
+      "value": 42,
+      "cases": [10, 42, 100],
+      "outputs": ["small", "medium", "large"]
+    },
+    "expected": {
+      "result": "medium",
+      "case_index": 1,
+      "matched": true,
+      "case_1": true
+    }
+  },
+  {
+    "description": "String/number equality",
+    "inputs": {
+      "value": "42",
+      "cases": [10, 42, 100],
+      "outputs": ["small", "medium", "large"]
+    },
+    "expected": {
+      "result": "medium",
+      "case_index": 1,
+      "matched": true,
+      "case_1": true
+    }
+  },
+  {
+    "description": "Missing outputs array",
+    "inputs": {
+      "value": "apple",
+      "cases": ["banana", "apple", "orange"]
+    },
+    "expected": {
+      "result": "apple",
+      "case_index": 1,
+      "matched": true,
+      "case_1": true
+    }
+  },
+  {
+    "description": "Output index out of bounds",
+    "inputs": {
+      "value": "orange",
+      "cases": ["banana", "apple", "orange"],
+      "outputs": ["yellow", "red"]
+    },
+    "expected": {
+      "result": "orange",
+      "case_index": 2,
+      "matched": true,
+      "case_2": true
+    }
+  }
+] 

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

@@ -0,0 +1,54 @@
+{
+  "display_name": "System Prompt",
+  "tagline": "Set system instructions",
+  "description": "Draft a text-based system prompt for an LLM, with configurable variables.",
+  "icon": "fa-comment",
+  "category": "messages",
+  "custom_render_height": 450,
+  "width": 450,
+  "is_constant": true,
+  "is_resizable": true,
+  "has_expanded_view": true,
+  "inputs": [
+    {
+      "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."
+    },
+    {
+      "name": "chain",
+      "display_name": "Chain",
+      "type": "string or message",
+      "description": "Connect another system prompt to chain them together. The content from this input will be prepended to the current prompt.",
+      "required": false
+    }
+  ],
+  "outputs": [
+    {
+      "name": "message",
+      "display_name": "System Message",
+      "type": "message",
+      "primary": true,
+      "description": "The message object, containing the prompt text and system role."
+    },
+    {
+      "name": "prompt",
+      "display_name": "Content",
+      "type": "string",
+      "description": "The prompt text after variables have been injected, without the system role."
+    }
+  ],
+  "settings": [
+    {
+      "name": "content",
+      "display_name": "Content",
+      "type": "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/system-prompt/system-prompt.process.js

@@ -0,0 +1,62 @@
+/**
+ * Process function for the System Prompt node.
+ * Outputs a message object, containing the prompt text and system role and text
+ */
+export default async ({inputs, settings, config}) => {
+  // Initialize variables array if not provided
+  if(!inputs.variables) {
+    inputs.variables = [];
+  }
+
+  // Get the base content from settings
+  let baseContent = settings.content || "";
+
+  // Handle chain input if provided
+  let chainedContent = "";
+  if (inputs.chain) {
+    if (typeof inputs.chain === "string") {
+      chainedContent = inputs.chain;
+    } else if (typeof inputs.chain === "object" && inputs.chain.content) {
+      // Handle message object format
+      if (Array.isArray(inputs.chain.content)) {
+        // Extract text content from array format
+        chainedContent = inputs.chain.content
+          .filter(item => item.type === "text")
+          .map(item => item.text)
+          .join("\n");
+      } else if (typeof inputs.chain.content === "string") {
+        chainedContent = inputs.chain.content;
+      }
+    }
+  }
+
+  // Combine chained content with base content
+  let fullContent = chainedContent ? `${chainedContent}\n\n${baseContent}` : baseContent;
+
+  // Create message object
+  let message = {
+    role: "system",
+    content: [
+      {
+        type: "text",
+        text: fullContent
+      }
+    ]
+  };
+
+  // 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));
+    if(variable) {
+      return variable[p1];
+    }
+    return match;
+  });
+  
+  // Return the message and string prompt
+  return {
+    message: message,
+    prompt: message.content[0].text
+  };
+}; 

package/nodes/temperature/temperature.config.json

@@ -0,0 +1,46 @@
+{
+  "display_name": "Temperature",
+  "tagline": "Set AI temperature",
+  "description": "A temperature slider useful for controlling randomness in model outputs. Lower values (0.0-0.3) produce very deterministic outputs ideal for factual content, code, or documentation. Medium values (0.4-0.7) balance creativity and coherence for general conversation and controlled creative writing. Higher values (0.8-1.0) introduce more randomness for brainstorming, poetry, and ideation. Values above 1.0 become very random and may be incoherent, suitable only for experimental purposes.",
+  "icon": "thermometer",
+  "category": "ai",
+  "custom_render_height": 42,
+  "is_constant": true,
+  "inputs": [
+    {
+      "name": "value",
+      "display_name": "Value",
+      "type": "number",
+      "description": "Optional value to override the default temperature value.",
+      "required": false
+    }
+  ],
+  "outputs": [
+    {
+      "name": "value",
+      "primary": true,
+      "display_name": "Value",
+      "type": "number",
+      "description": "The temperature value (0-1 by default, or 0-2 if experimental mode is enabled). Lower values (0.0-0.3) are very deterministic, ideal for factual or technical outputs. Medium values (0.4-0.7) balance creativity and coherence. Higher values (0.8-1.0) are highly creative for brainstorming or ideation. Values above 1.0 can become incoherent."
+    }
+  ],
+  "settings": [
+    {
+      "name": "value",
+      "display_name": "Temperature",
+      "type": "number",
+      "description": "The temperature value to output. Controls randomness in model outputs: 0.0-0.3 for very deterministic outputs (factual, technical, code), 0.4-0.7 for balanced creativity (general conversation, controlled creative writing), 0.8-1.0 for high creativity (brainstorming, poetry, ideation), and above 1.0 for experimental use (may be incoherent).",
+      "default": 1
+    },
+    {
+      "name": "allow_experimental",
+      "display_name": "Allow Experimental",
+      "type": "boolean",
+      "description": "If enabled, allows temperature values above 1.0 (up to 2.0). Values above 1.0 can become very random and incoherent, suitable only for experimental purposes.",
+      "default": false
+    }
+  ],
+  "timeout": 3000,
+  "retry_limit": 3
+}
+

package/nodes/temperature/temperature.process.js

@@ -0,0 +1,16 @@
+export default async ({inputs, settings, config}) => {
+
+  
+  // Use input value if provided, otherwise use the setting value
+  let value = (inputs.value !== undefined && inputs.value !== null) ? Number(inputs.value) : Number(settings.value);
+  
+  // Hard-code min to 0, max based on allow_experimental setting
+  const min = 0;
+  const max = settings.allow_experimental ? 2 : 1;
+  
+  // Clamp value to valid range
+  value = Math.max(min, Math.min(max, value));
+
+  return { value };
+};
+

package/nodes/temperature/temperature.tests.json

@@ -0,0 +1,47 @@
+[
+  {
+    "description": "Default value when no input is provided",
+    "inputs": {},
+    "expected": { "value": 1 }
+  },
+  {
+    "description": "Override default value with input",
+    "inputs": { "value": 0.7 },
+    "expected": { "value": 0.7 }
+  },
+  {
+    "description": "Value is clamped to maximum (1) when allow_experimental is false",
+    "inputs": { "value": 1.5 },
+    "settings": { "allow_experimental": false },
+    "expected": { "value": 1 }
+  },
+  {
+    "description": "Value is clamped to maximum (2) when allow_experimental is true",
+    "inputs": { "value": 3 },
+    "settings": { "allow_experimental": true },
+    "expected": { "value": 2 }
+  },
+  {
+    "description": "Value is clamped to minimum (0)",
+    "inputs": { "value": -0.5 },
+    "expected": { "value": 0 }
+  },
+  {
+    "description": "Custom settings are respected",
+    "inputs": {},
+    "settings": { "value": 0.5 },
+    "expected": { "value": 0.5 }
+  },
+  {
+    "description": "Values above 1 are allowed when allow_experimental is true",
+    "inputs": { "value": 1.5 },
+    "settings": { "allow_experimental": true },
+    "expected": { "value": 1.5 }
+  },
+  {
+    "description": "String input is converted to number",
+    "inputs": { "value": "0.8" },
+    "expected": { "value": 0.8 }
+  }
+]
+

package/nodes/text-scratch-pad/text-scratch-pad.config.json

@@ -0,0 +1,63 @@
+{
+  "display_name": "Text Scratch Pad",
+  "tagline": "Accumulate text",
+  "description": "Accumulate text input over multiple executions. Each new input gets concatenated to the existing content with an optional delimiter.",
+  "icon": "edit",
+  "category": "text",
+  "is_plugin": true,
+  "inputs": [
+    {
+      "name": "text",
+      "display_name": "Text",
+      "type": "string",
+      "description": "Text to append to the scratch pad. Each execution adds this to the accumulated content.",
+      "required": true,
+      "allow_multiple": true,
+      "refires": true
+    },
+    {
+      "name": "delimiter",
+      "display_name": "Delimiter",
+      "type": "string",
+      "description": "Optional delimiter to insert between text additions (e.g., '\\n', ' - ', ', ')",
+      "required": false
+    },
+    {
+      "name": "clear",
+      "display_name": "Clear",
+      "type": "boolean",
+      "description": "Set to true to clear the scratch pad and start fresh",
+      "required": false
+    }
+  ],
+  "outputs": [
+    {
+      "name": "content",
+      "display_name": "Content",
+      "type": "string",
+      "description": "The accumulated text content"
+    },
+    {
+      "name": "length",
+      "display_name": "Length",
+      "type": "number",
+      "description": "Number of characters in the accumulated content"
+    }
+  ],
+  "settings": [
+    {
+      "name": "initial_content",
+      "display_name": "Initial Content",
+      "type": "string",
+      "description": "Starting content for the scratch pad",
+      "default": ""
+    },
+    {
+      "name": "default_delimiter",
+      "display_name": "Default Delimiter",
+      "type": "string",
+      "description": "Default delimiter to use between text additions",
+      "default": "\n"
+    }
+  ]
+}

package/nodes/text-scratch-pad/text-scratch-pad.process.js

@@ -0,0 +1,40 @@
+export default async ({inputs, settings, config, nodeConfig}) => {
+  try {
+    const text = inputs.text;
+    const delimiter = inputs.delimiter || settings.default_delimiter || '\n';
+    const clear = inputs.clear || false;
+    
+    // Get current accumulated content from settings
+    let currentContent = settings.accumulated_content || settings.initial_content || '';
+    
+    // Clear if requested
+    if (clear) {
+      currentContent = '';
+    }
+    
+    // Add new text if provided
+    if (text !== undefined && text !== null && text !== '') {
+      if (currentContent === '') {
+        // First addition, no delimiter needed
+        currentContent = String(text);
+      } else {
+        // Subsequent additions, use delimiter
+        currentContent = currentContent + delimiter + String(text);
+      }
+    }
+    
+    // Update settings to persist the accumulated content
+    const outputs = {
+      content: currentContent,
+      length: currentContent.length,
+      __updated_settings: {
+        accumulated_content: currentContent
+      }
+    };
+    
+    return outputs;
+    
+  } catch (error) {
+    throw new Error(`Text Scratch Pad error: ${error.message}`);
+  }
+};

package/nodes/text-scratch-pad/text-scratch-pad.tests.json

@@ -0,0 +1,131 @@
+[
+  {
+    "inputs": {
+      "text": "Hello world"
+    },
+    "settings": {
+      "initial_content": "",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "Hello world",
+      "length": 11
+    },
+    "description": "First text addition"
+  },
+  {
+    "inputs": {
+      "text": "This is line 2"
+    },
+    "settings": {
+      "accumulated_content": "Hello world",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "Hello world\nThis is line 2",
+      "length": 26
+    },
+    "description": "Second text addition with default delimiter"
+  },
+  {
+    "inputs": {
+      "text": "Another item",
+      "delimiter": " | "
+    },
+    "settings": {
+      "accumulated_content": "Item 1",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "Item 1 | Another item",
+      "length": 21
+    },
+    "description": "Custom delimiter"
+  },
+  {
+    "inputs": {
+      "text": "New content",
+      "clear": true
+    },
+    "settings": {
+      "accumulated_content": "Old content that should be cleared",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "New content",
+      "length": 11
+    },
+    "description": "Clear scratch pad"
+  },
+  {
+    "inputs": {
+      "text": ""
+    },
+    "settings": {
+      "accumulated_content": "Existing content",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "Existing content",
+      "length": 16
+    },
+    "description": "Empty text input"
+  },
+  {
+    "inputs": {
+      "text": null
+    },
+    "settings": {
+      "accumulated_content": "Existing content",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "Existing content",
+      "length": 16
+    },
+    "description": "Null text input"
+  },
+  {
+    "inputs": {
+      "text": "Third item",
+      "delimiter": ", "
+    },
+    "settings": {
+      "accumulated_content": "First item, Second item",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "First item, Second item, Third item",
+      "length": 35
+    },
+    "description": "Multiple additions with comma delimiter"
+  },
+  {
+    "inputs": {
+      "clear": true
+    },
+    "settings": {
+      "accumulated_content": "Content to be cleared",
+      "default_delimiter": "\n"
+    },
+    "expected": {
+      "content": "",
+      "length": 0
+    },
+    "description": "Clear without new text"
+  },
+  {
+    "inputs": {
+      "text": "Additional text"
+    },
+    "settings": {
+      "initial_content": "Starting text",
+      "default_delimiter": " - "
+    },
+    "expected": {
+      "content": "Starting text - Additional text",
+      "length": 31
+    },
+    "description": "Initial content from settings"
+  }
+]

package/nodes/text-to-conversation/text-to-conversation.config.json

@@ -0,0 +1,46 @@
+{
+  "display_name": "Text to Conversation",
+  "tagline": "Convert text to chat",
+  "description": "Parses a text transcript back into a conversation message array. Recognizes role labels like 'User:', 'Assistant:', 'System:'.",
+  "icon": "chat-text",
+  "category": "messages",
+  "inputs": [
+    {
+      "name": "text",
+      "display_name": "Text",
+      "type": "string",
+      "description": "The text transcript to parse",
+      "required": true
+    },
+    {
+      "name": "separator",
+      "display_name": "Separator",
+      "type": "string",
+      "description": "Pattern that separates messages (regex supported)",
+      "required": false,
+      "default": "\\n\\n"
+    },
+    {
+      "name": "default_role",
+      "display_name": "Default Role",
+      "type": "string",
+      "description": "Role to use when no label is detected",
+      "required": false,
+      "default": "user"
+    }
+  ],
+  "outputs": [
+    {
+      "name": "messages",
+      "display_name": "Messages",
+      "type": "conversation",
+      "description": "The parsed conversation message array"
+    },
+    {
+      "name": "message_count",
+      "display_name": "Message Count",
+      "type": "number",
+      "description": "Number of messages parsed"
+    }
+  ]
+}

package/nodes/text-to-conversation/text-to-conversation.process.js

@@ -0,0 +1,50 @@
+export default async ({ inputs, settings, config }) => {
+  const text = inputs.text;
+  const separator = inputs.separator ?? "\\n\\n";
+  const defaultRole = inputs.default_role ?? "user";
+
+  if (typeof text !== "string" || text.trim() === "") {
+    return { messages: [], message_count: 0 };
+  }
+
+  // Split by separator
+  const separatorRegex = new RegExp(separator);
+  const chunks = text.split(separatorRegex).filter((chunk) => chunk.trim() !== "");
+
+  // Role detection pattern - matches "Role:" or "ROLE:" at start of text
+  const rolePattern = /^(user|assistant|system|human|ai|bot):\s*/i;
+
+  const messages = [];
+
+  for (const chunk of chunks) {
+    const trimmed = chunk.trim();
+    if (!trimmed) continue;
+
+    const match = trimmed.match(rolePattern);
+
+    let role = defaultRole;
+    let content = trimmed;
+
+    if (match) {
+      const detectedRole = match[1].toLowerCase();
+      // Normalize role names
+      if (detectedRole === "human") {
+        role = "user";
+      } else if (detectedRole === "ai" || detectedRole === "bot") {
+        role = "assistant";
+      } else {
+        role = detectedRole;
+      }
+      content = trimmed.slice(match[0].length).trim();
+    }
+
+    if (content) {
+      messages.push({ role, content });
+    }
+  }
+
+  return {
+    messages,
+    message_count: messages.length,
+  };
+};