@zerowidth/workbench-sdk 2.0.0-alpha.0

package/nodes/get-messages-by-role/get-messages-by-role.process.js

@@ -0,0 +1,28 @@
+export default async ({inputs, settings, config}) => {
+    try {
+        const messages = inputs.messages;
+        const role = inputs.role;
+
+        if (!Array.isArray(messages)) {
+            throw new Error("Messages input must be an array");
+        }
+
+        if (typeof role !== 'string' || role.trim() === '') {
+            throw new Error("Role must be a non-empty string");
+        }
+
+        // Filter messages by role
+        const filteredMessages = messages.filter(message => {
+            return message && typeof message === 'object' && message.role === role;
+        });
+
+        return {
+            messages: filteredMessages,
+            count: filteredMessages.length
+        };
+
+    } catch (error) {
+        console.log('Get Messages by Role error:', error);
+        throw new Error(`Get Messages by Role error: ${error.message}`);
+    }
+};

package/nodes/get-messages-by-role/get-messages-by-role.tests.json

@@ -0,0 +1,87 @@
+[
+  {
+    "description": "Filter user messages from mixed array",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "assistant", "content": "Hi there"},
+        {"role": "user", "content": "How are you?"},
+        {"role": "system", "content": "System message"},
+        {"role": "assistant", "content": "I'm doing well"}
+      ],
+      "role": "user"
+    },
+    "expected": {
+      "count": 2
+    }
+  },
+  {
+    "description": "Filter assistant messages from mixed array",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "assistant", "content": "Hi there"},
+        {"role": "user", "content": "How are you?"},
+        {"role": "system", "content": "System message"},
+        {"role": "assistant", "content": "I'm doing well"}
+      ],
+      "role": "assistant"
+    },
+    "expected": {
+      "count": 2
+    }
+  },
+  {
+    "description": "Filter system messages from mixed array",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "assistant", "content": "Hi there"},
+        {"role": "user", "content": "How are you?"},
+        {"role": "system", "content": "System message"},
+        {"role": "assistant", "content": "I'm doing well"}
+      ],
+      "role": "system"
+    },
+    "expected": {
+      "count": 1
+    }
+  },
+  {
+    "description": "Filter non-existent role",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"role": "assistant", "content": "Hi there"}
+      ],
+      "role": "moderator"
+    },
+    "expected": {
+      "count": 0
+    }
+  },
+  {
+    "description": "Handle empty message array",
+    "inputs": {
+      "messages": [],
+      "role": "user"
+    },
+    "expected": {
+      "count": 0
+    }
+  },
+  {
+    "description": "Handle messages without role property",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Hello"},
+        {"content": "No role message"},
+        {"role": "assistant", "content": "Hi there"}
+      ],
+      "role": "user"
+    },
+    "expected": {
+      "count": 1
+    }
+  }
+]

package/nodes/get-messages-range/get-messages-range.config.json

@@ -0,0 +1,44 @@
+{
+  "display_name": "Get Messages Range",
+  "tagline": "Get message range",
+  "description": "Extract messages from a specific range (start index to end index).",
+  "icon": "arrows-horizontal",
+  "category": "messages",
+  "inputs": [
+    {
+      "name": "messages",
+      "display_name": "Messages",
+      "type": "conversation",
+      "description": "Array of message objects to extract from",
+      "required": true
+    },
+    {
+      "name": "start",
+      "display_name": "Start Index",
+      "type": "number",
+      "description": "Starting index (inclusive, 0-based)",
+      "required": true
+    },
+    {
+      "name": "end",
+      "display_name": "End Index",
+      "type": "number",
+      "description": "Ending index (exclusive, 0-based). Use -1 for end of array.",
+      "required": true
+    }
+  ],
+  "outputs": [
+    {
+      "name": "messages",
+      "display_name": "Messages",
+      "type": "conversation",
+      "description": "Array containing messages from the specified range"
+    },
+    {
+      "name": "count",
+      "display_name": "Count",
+      "type": "number",
+      "description": "Number of messages in the range"
+    }
+  ]
+}

package/nodes/get-messages-range/get-messages-range.process.js

@@ -0,0 +1,44 @@
+export default async ({inputs, settings, config}) => {
+    try {
+        const messages = inputs.messages;
+        let start = inputs.start;
+        let end = inputs.end;
+
+        if (!Array.isArray(messages)) {
+            throw new Error("Messages input must be an array");
+        }
+
+        if (typeof start !== 'number' || !Number.isInteger(start) || start < 0) {
+            throw new Error("Start index must be a non-negative integer");
+        }
+
+        if (typeof end !== 'number' || !Number.isInteger(end)) {
+            throw new Error("End index must be an integer");
+        }
+
+        // Handle -1 as end of array
+        if (end === -1) {
+            end = messages.length;
+        }
+
+        if (end < start) {
+            throw new Error("End index must be greater than or equal to start index");
+        }
+
+        // Clamp indices to array bounds
+        start = Math.max(0, Math.min(start, messages.length));
+        end = Math.max(start, Math.min(end, messages.length));
+
+        // Extract messages in range
+        const rangeMessages = messages.slice(start, end);
+
+        return {
+            messages: rangeMessages,
+            count: rangeMessages.length
+        };
+
+    } catch (error) {
+        console.log('Get Messages Range error:', error);
+        throw new Error(`Get Messages Range error: ${error.message}`);
+    }
+};

package/nodes/get-messages-range/get-messages-range.tests.json

@@ -0,0 +1,104 @@
+[
+  {
+    "description": "Get messages from index 1 to 3",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Message 0"},
+        {"role": "assistant", "content": "Message 1"},
+        {"role": "user", "content": "Message 2"},
+        {"role": "assistant", "content": "Message 3"},
+        {"role": "user", "content": "Message 4"}
+      ],
+      "start": 1,
+      "end": 3
+    },
+    "expected": {
+      "count": 2
+    }
+  },
+  {
+    "description": "Get messages from index 0 to end using -1",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Message 0"},
+        {"role": "assistant", "content": "Message 1"},
+        {"role": "user", "content": "Message 2"}
+      ],
+      "start": 0,
+      "end": -1
+    },
+    "expected": {
+      "count": 3
+    }
+  },
+  {
+    "description": "Get messages from index 2 to end using -1",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Message 0"},
+        {"role": "assistant", "content": "Message 1"},
+        {"role": "user", "content": "Message 2"},
+        {"role": "assistant", "content": "Message 3"}
+      ],
+      "start": 2,
+      "end": -1
+    },
+    "expected": {
+      "count": 2
+    }
+  },
+  {
+    "description": "Get single message at index 1",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Message 0"},
+        {"role": "assistant", "content": "Message 1"},
+        {"role": "user", "content": "Message 2"}
+      ],
+      "start": 1,
+      "end": 2
+    },
+    "expected": {
+      "count": 1
+    }
+  },
+  {
+    "description": "Handle start index beyond array length",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Message 0"},
+        {"role": "assistant", "content": "Message 1"}
+      ],
+      "start": 5,
+      "end": 10
+    },
+    "expected": {
+      "count": 0
+    }
+  },
+  {
+    "description": "Handle end index beyond array length",
+    "inputs": {
+      "messages": [
+        {"role": "user", "content": "Message 0"},
+        {"role": "assistant", "content": "Message 1"}
+      ],
+      "start": 0,
+      "end": 10
+    },
+    "expected": {
+      "count": 2
+    }
+  },
+  {
+    "description": "Handle empty message array",
+    "inputs": {
+      "messages": [],
+      "start": 0,
+      "end": 1
+    },
+    "expected": {
+      "count": 0
+    }
+  }
+]

package/nodes/get-object-property/get-object-property.config.json

@@ -0,0 +1,54 @@
+{
+  "display_name": "Get Object Property",
+  "tagline": "Get object property",
+  "description": "Extract a specific property value from an object by key name.",
+  "icon": "fa-key",
+  "category": "data",
+  "inputs": [
+    {
+      "name": "object",
+      "display_name": "Object",
+      "type": "object",
+      "description": "The object to extract the property from",
+      "required": true
+    },
+    {
+      "name": "key",
+      "display_name": "Key",
+      "type": "string",
+      "description": "The name of the property to extract",
+      "required": true
+    }
+  ],
+  "outputs": [
+    {
+      "name": "value",
+      "display_name": "Value",
+      "type": "any",
+      "description": "The value of the specified property"
+    },
+    {
+      "name": "exists",
+      "display_name": "Exists",
+      "type": "boolean",
+      "description": "Whether the property exists in the object"
+    },
+    {
+      "name": "key",
+      "display_name": "Key",
+      "type": "string",
+      "description": "The key that was accessed"
+    }
+  ],
+  "settings": [
+    {
+      "name": "default_value",
+      "display_name": "Default Value",
+      "type": "any",
+      "description": "Value to return if the property doesn't exist",
+      "default": null
+    }
+  ],
+  "timeout": 3000,
+  "retry_limit": 3
+}

package/nodes/get-object-property/get-object-property.process.js

@@ -0,0 +1,35 @@
+/**
+ * Process function for the Get Object Property node.
+ * Extracts a specific property value from an object by key name.
+ */
+export default async ({inputs, settings, config}) => {
+  const { object, key } = inputs;
+  const { default_value } = settings;
+  
+  // Validate inputs
+  if (!object || typeof object !== 'object') {
+    return {
+      value: default_value,
+      exists: false,
+      key: key || ''
+    };
+  }
+  
+  if (!key || typeof key !== 'string') {
+    return {
+      value: default_value,
+      exists: false,
+      key: key || ''
+    };
+  }
+  
+  // Check if property exists
+  const exists = key in object;
+  const value = exists ? object[key] : default_value;
+  
+  return {
+    value: value,
+    exists: exists,
+    key: key
+  };
+};

package/nodes/get-object-property/get-object-property.tests.json

@@ -0,0 +1,101 @@
+[
+  {
+    "description": "Get existing property from object",
+    "inputs": {
+      "object": {"name": "John", "age": 30, "city": "New York"},
+      "key": "name"
+    },
+    "expected": {
+      "value": "John",
+      "exists": true,
+      "key": "name"
+    }
+  },
+  {
+    "description": "Get non-existing property with default value",
+    "inputs": {
+      "object": {"name": "John", "age": 30},
+      "key": "email"
+    },
+    "settings": {
+      "default_value": "unknown@example.com"
+    },
+    "expected": {
+      "value": "unknown@example.com",
+      "exists": false,
+      "key": "email"
+    }
+  },
+  {
+    "description": "Get nested object property",
+    "inputs": {
+      "object": {"user": {"profile": {"name": "Jane"}}, "id": 123},
+      "key": "user"
+    },
+    "expected": {
+      "value": {"profile": {"name": "Jane"}},
+      "exists": true,
+      "key": "user"
+    }
+  },
+  {
+    "description": "Get property from empty object",
+    "inputs": {
+      "object": {},
+      "key": "any_key"
+    },
+    "expected": {
+      "value": null,
+      "exists": false,
+      "key": "any_key"
+    }
+  },
+  {
+    "description": "Handle null object input",
+    "inputs": {
+      "object": null,
+      "key": "test"
+    },
+    "expected": {
+      "value": null,
+      "exists": false,
+      "key": "test"
+    }
+  },
+  {
+    "description": "Handle non-string key",
+    "inputs": {
+      "object": {"name": "John"},
+      "key": 123
+    },
+    "expected": {
+      "value": null,
+      "exists": false,
+      "key": 123
+    }
+  },
+  {
+    "description": "Get property with special characters in key",
+    "inputs": {
+      "object": {"user-name": "John", "user@email": "john@example.com"},
+      "key": "user-name"
+    },
+    "expected": {
+      "value": "John",
+      "exists": true,
+      "key": "user-name"
+    }
+  },
+  {
+    "description": "Get property with array value",
+    "inputs": {
+      "object": {"tags": ["javascript", "nodejs"], "count": 2},
+      "key": "tags"
+    },
+    "expected": {
+      "value": ["javascript", "nodejs"],
+      "exists": true,
+      "key": "tags"
+    }
+  }
+]

package/nodes/github-create-issue/github-create-issue.config.json

@@ -0,0 +1,72 @@
+{
+  "display_name": "GitHub Create Issue",
+  "tagline": "Create GitHub issue",
+  "description": "Create a new issue in a GitHub repository.",
+  "icon": "github",
+  "category": "third-party",
+  "is_plugin": true,
+  "inputs": [
+    {
+      "name": "owner",
+      "display_name": "Owner",
+      "type": "string",
+      "description": "Repository owner (user or organization)",
+      "required": true
+    },
+    {
+      "name": "repo",
+      "display_name": "Repository",
+      "type": "string",
+      "description": "Repository name",
+      "required": true
+    },
+    {
+      "name": "title",
+      "display_name": "Title",
+      "type": "string",
+      "description": "Issue title",
+      "required": true
+    },
+    {
+      "name": "body",
+      "display_name": "Body",
+      "type": "string",
+      "description": "Issue body (supports GitHub markdown)",
+      "required": false
+    },
+    {
+      "name": "labels",
+      "display_name": "Labels",
+      "type": "array",
+      "description": "Array of label names to apply",
+      "required": false
+    },
+    {
+      "name": "assignees",
+      "display_name": "Assignees",
+      "type": "array",
+      "description": "Array of GitHub usernames to assign",
+      "required": false
+    }
+  ],
+  "outputs": [
+    {
+      "name": "issue",
+      "display_name": "Issue",
+      "type": "object",
+      "description": "The created issue object"
+    },
+    {
+      "name": "number",
+      "display_name": "Number",
+      "type": "number",
+      "description": "Issue number"
+    },
+    {
+      "name": "url",
+      "display_name": "URL",
+      "type": "string",
+      "description": "Issue URL on GitHub"
+    }
+  ]
+}

package/nodes/github-create-issue/github-create-issue.process.js

@@ -0,0 +1,22 @@
+export default async ({ inputs, settings, config }) => {
+  const github = config.integrations?.github;
+  if (!github) {
+    throw new Error("GitHub integration not configured. Add your GitHub PAT to config.keys.github");
+  }
+
+  if (!inputs.owner) throw new Error("owner is required");
+  if (!inputs.repo) throw new Error("repo is required");
+  if (!inputs.title) throw new Error("title is required");
+
+  const issue = await github.createIssue(inputs.owner, inputs.repo, inputs.title, {
+    body: inputs.body || undefined,
+    labels: inputs.labels || undefined,
+    assignees: inputs.assignees || undefined,
+  });
+
+  return {
+    issue,
+    number: issue.number,
+    url: issue.html_url,
+  };
+};

package/nodes/github-create-issue/github-create-issue.tests.json

@@ -0,0 +1,15 @@
+[
+  {
+    "description": "Create issue with title and body",
+    "inputs": {
+      "owner": "${GITHUB_TEST_OWNER}",
+      "repo": "${GITHUB_TEST_REPO}",
+      "title": "Test Issue from zv1",
+      "body": "This is a test issue created by the zv1 engine."
+    },
+    "expected": {
+      "number": "number",
+      "url": "string"
+    }
+  }
+]