@zerowidth/workbench-sdk 2.3.0 → 2.4.0

package/nodes/x-ai-grok-4-7/x-ai-grok-4-7.process.js

@@ -0,0 +1,139 @@
+export default async ({inputs, settings, config, nodeConfig}) => {
+    try {
+        // Get OpenRouter integration from engine
+        const openrouter = config.integrations?.openrouter;
+        if (!openrouter) {
+            throw new Error("OpenRouter integration not found");
+        }
+
+        let messages = inputs.messages;
+
+        if(typeof messages === 'string') {
+            messages = [{ role: 'user', content: messages }];
+        }
+
+        if(typeof messages === 'object' && !Array.isArray(messages)) {
+            messages = [messages];
+        }
+
+        if(inputs.system_prompt) {  
+            let systemPrompt = inputs.system_prompt;
+            if(typeof systemPrompt === 'string') {
+                systemPrompt = { role: 'system', content: systemPrompt };
+            }
+            messages = [systemPrompt, ...messages];
+        }
+
+        // Build parameters object from config inputs
+        const params = {};
+        const configInputs = [{"name":"messages","display_name":"Conversation","type":"conversation or message or string","description":"Array of chat messages that make up the conversation","required":true},{"name":"system_prompt","display_name":"System Message","type":"message or string","description":"System prompt to instruct the model","default":null},{"name":"tools","display_name":"Tools","type":"tool or array of tools","description":"Array of tools to use","default":null,"allow_multiple":true},{"name":"tool_choice","display_name":"Tool Choice","type":"string","description":"Tool selection control","default":null},{"name":"reasoning","display_name":"Reasoning","type":"boolean","description":"Enable reasoning mode","default":null},{"name":"response_format","display_name":"Response Format","type":"object","description":"Output format specification","default":null},{"name":"temperature","display_name":"Temperature","type":"number","description":"Controls randomness (0-2)","default":null},{"name":"top_p","display_name":"Top P","type":"number","description":"Controls diversity via nucleus sampling","default":null},{"name":"max_tokens","display_name":"Max Tokens","type":"number","description":"Maximum tokens to generate","default":null},{"name":"seed","display_name":"Seed","type":"number","description":"Deterministic outputs","default":null},{"name":"logprobs","display_name":"Logprobs","type":"boolean","description":"Return log probabilities of the output tokens","default":null},{"name":"top_logprobs","display_name":"Top Logprobs","type":"number","description":"Number of most likely tokens to return at each position (0-20). Requires logprobs to be enabled.","default":null}];
+        
+        for (const input of configInputs) {
+
+            if(input.name === 'messages') continue;
+
+            const value = inputs[input.name];
+            if (value !== null && value !== undefined) {
+                // Flatten tools array to handle both individual tools and arrays of tools
+                if (input.name === 'tools' && Array.isArray(value)) {
+                    params.tools = value.flat();
+                } else {
+                    params[input.name] = value;
+                }
+            }
+        }
+
+        
+
+        const response = await openrouter.chatCompletion({
+            model: "x-ai/grok-4.7",
+            messages: messages,
+            ...params
+        }, nodeConfig, config);
+
+        // Get the set of internal tool names (tools handled by engine plugins)
+        // If internal_tool_names is undefined, we're in backward-compatible mode (include all)
+        // If it's an empty array, there are no internal tools (include none from history)
+        const hasInternalToolTracking = config.internal_tool_names !== undefined;
+        const internalToolNames = new Set(config.internal_tool_names || []);
+
+        // Build conversation output: only include messages related to internal tools
+        let conversationMessages = [];
+
+        if (Array.isArray(messages) && messages.length > 0) {
+            // Work backwards from the end
+            for (let i = messages.length - 1; i >= 0; i--) {
+                const msg = messages[i];
+                if (!msg || typeof msg !== 'object') continue;
+
+                const isTool = msg.role === 'tool';
+                const hasToolCalls = msg.tool_calls && Array.isArray(msg.tool_calls) && msg.tool_calls.length > 0;
+
+                if (isTool) {
+                    // Only include tool result if it's for an internal tool
+                    const toolName = msg.name;
+                    if (!hasInternalToolTracking || internalToolNames.has(toolName)) {
+                        conversationMessages.unshift(msg);
+                    }
+                    // Skip external tool results
+                } else if (hasToolCalls) {
+                    // Filter to only internal tool calls
+                    const internalCalls = !hasInternalToolTracking
+                        ? msg.tool_calls
+                        : msg.tool_calls.filter(tc => internalToolNames.has(tc.function?.name));
+
+                    if (internalCalls.length > 0) {
+                        conversationMessages.unshift({
+                            ...msg,
+                            tool_calls: internalCalls
+                        });
+                    }
+                    // External tool calls from history are dropped
+                } else {
+                    // Stop when we hit a message that is not tool and has no tool_calls
+                    break;
+                }
+            }
+        }
+
+        // Append the final output message — always include all tool_calls on the response
+        // The internal/external split only applies to historical messages above, not the fresh response
+        const finalMessage = {
+            content: response.content,
+            role: response.role
+        };
+
+        if (response.tool_calls && Array.isArray(response.tool_calls) && response.tool_calls.length > 0) {
+            finalMessage.tool_calls = response.tool_calls;
+        }
+
+        if (response.images) {
+            finalMessage.images = response.images;
+        }
+        conversationMessages.push(finalMessage);
+
+        const conversation = conversationMessages;
+
+        return {
+            conversation: conversation,
+            message: {
+                content: response.content,
+                role: response.role,
+                tool_calls: response.tool_calls
+            },
+            content: response.content,
+            role: response.role,
+            tool_calls: response.tool_calls,
+            reasoning: response.reasoning,
+            refusal: response.refusal,
+            logprobs: response.logprobs,
+            finish_reason: response.finish_reason,
+            usage: response.usage,
+            cost_total: response.cost_total,
+            cost_itemized: response.cost_itemized
+        };
+    } catch (error) {
+        console.log('error', error);
+        throw new Error(`SpaceXAI: Grok 4.7 node error: ${error.message}`);
+    }
+};

package/nodes/x-ai-grok-build-0-1/x-ai-grok-build-0-1.config.json

@@ -1,22 +1,19 @@
 {
-  "display_name": "xAI: Grok Build 0.1",
+  "display_name": "SpaceXAI: Grok Build 0.1",
   "tagline": "Generate text",
-  "description": "Grok Build 0.1 is xAI’s fast coding model trained specifically for agentic software engineering workflows. It supports text and image inputs with text output, and is optimized for interactive coding...",
+  "description": "Grok Build 0.1 is SpaceXAI’s fast coding model trained specifically for agentic software engineering workflows. It supports text and image inputs with text output, and is optimized for interactive coding...",
   "category": "llm",
   "provider": "x-ai",
   "accepts_plugins": true,
   "model_id": "x-ai/grok-build-0.1",
   "context_length": 256000,
   "supported_parameters": [
-    "frequency_penalty",
     "include_reasoning",
     "logprobs",
     "max_tokens",
-    "presence_penalty",
     "reasoning",
     "response_format",
     "seed",
-    "stop",
     "structured_outputs",
     "temperature",
     "tool_choice",
@@ -68,13 +65,6 @@
       "description": "Output format specification",
       "default": null
     },
-    {
-      "name": "stop",
-      "display_name": "Stop",
-      "type": "string or array",
-      "description": "Custom stop sequences",
-      "default": null
-    },
     {
       "name": "temperature",
       "display_name": "Temperature",
@@ -96,20 +86,6 @@
       "description": "Maximum tokens to generate",
       "default": null
     },
-    {
-      "name": "frequency_penalty",
-      "display_name": "Frequency Penalty",
-      "type": "number",
-      "description": "Reduces repetition (-2 to 2)",
-      "default": null
-    },
-    {
-      "name": "presence_penalty",
-      "display_name": "Presence Penalty",
-      "type": "number",
-      "description": "Encourages new topics (-2 to 2)",
-      "default": null
-    },
     {
       "name": "seed",
       "display_name": "Seed",

package/nodes/x-ai-grok-build-0-1/x-ai-grok-build-0-1.process.js

@@ -26,7 +26,7 @@ export default async ({inputs, settings, config, nodeConfig}) => {
 
         // Build parameters object from config inputs
         const params = {};
-        const configInputs = [{"name":"messages","display_name":"Conversation","type":"conversation or message or string","description":"Array of chat messages that make up the conversation","required":true},{"name":"system_prompt","display_name":"System Message","type":"message or string","description":"System prompt to instruct the model","default":null},{"name":"tools","display_name":"Tools","type":"tool or array of tools","description":"Array of tools to use","default":null,"allow_multiple":true},{"name":"tool_choice","display_name":"Tool Choice","type":"string","description":"Tool selection control","default":null},{"name":"reasoning","display_name":"Reasoning","type":"boolean","description":"Enable reasoning mode","default":null},{"name":"response_format","display_name":"Response Format","type":"object","description":"Output format specification","default":null},{"name":"stop","display_name":"Stop","type":"string or array","description":"Custom stop sequences","default":null},{"name":"temperature","display_name":"Temperature","type":"number","description":"Controls randomness (0-2)","default":null},{"name":"top_p","display_name":"Top P","type":"number","description":"Controls diversity via nucleus sampling","default":null},{"name":"max_tokens","display_name":"Max Tokens","type":"number","description":"Maximum tokens to generate","default":null},{"name":"frequency_penalty","display_name":"Frequency Penalty","type":"number","description":"Reduces repetition (-2 to 2)","default":null},{"name":"presence_penalty","display_name":"Presence Penalty","type":"number","description":"Encourages new topics (-2 to 2)","default":null},{"name":"seed","display_name":"Seed","type":"number","description":"Deterministic outputs","default":null},{"name":"logprobs","display_name":"Logprobs","type":"boolean","description":"Return log probabilities of the output tokens","default":null},{"name":"top_logprobs","display_name":"Top Logprobs","type":"number","description":"Number of most likely tokens to return at each position (0-20). Requires logprobs to be enabled.","default":null}];
+        const configInputs = [{"name":"messages","display_name":"Conversation","type":"conversation or message or string","description":"Array of chat messages that make up the conversation","required":true},{"name":"system_prompt","display_name":"System Message","type":"message or string","description":"System prompt to instruct the model","default":null},{"name":"tools","display_name":"Tools","type":"tool or array of tools","description":"Array of tools to use","default":null,"allow_multiple":true},{"name":"tool_choice","display_name":"Tool Choice","type":"string","description":"Tool selection control","default":null},{"name":"reasoning","display_name":"Reasoning","type":"boolean","description":"Enable reasoning mode","default":null},{"name":"response_format","display_name":"Response Format","type":"object","description":"Output format specification","default":null},{"name":"temperature","display_name":"Temperature","type":"number","description":"Controls randomness (0-2)","default":null},{"name":"top_p","display_name":"Top P","type":"number","description":"Controls diversity via nucleus sampling","default":null},{"name":"max_tokens","display_name":"Max Tokens","type":"number","description":"Maximum tokens to generate","default":null},{"name":"seed","display_name":"Seed","type":"number","description":"Deterministic outputs","default":null},{"name":"logprobs","display_name":"Logprobs","type":"boolean","description":"Return log probabilities of the output tokens","default":null},{"name":"top_logprobs","display_name":"Top Logprobs","type":"number","description":"Number of most likely tokens to return at each position (0-20). Requires logprobs to be enabled.","default":null}];
         
         for (const input of configInputs) {
 
@@ -134,6 +134,6 @@ export default async ({inputs, settings, config, nodeConfig}) => {
         };
     } catch (error) {
         console.log('error', error);
-        throw new Error(`xAI: Grok Build 0.1 node error: ${error.message}`);
+        throw new Error(`SpaceXAI: Grok Build 0.1 node error: ${error.message}`);
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerowidth/workbench-sdk",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "dependencies": {
     "adm-zip": "^0.5.16",
     "ajv": "^8.17.1",
@@ -16,11 +16,17 @@
     "url": "https://github.com/zerowidth-ai/workbench-sdk.git",
     "directory": "sdks/nodejs"
   },
-  "description": "Workbench SDK \u2014 execute Workbench-authored flows in production. Successor to the zv1 package; see https://zerowidth.ai for the design surface.",
+  "homepage": "https://github.com/zerowidth-ai/workbench-sdk#readme",
+  "bugs": "https://github.com/zerowidth-ai/workbench-sdk/issues",
+  "description": "Workbench SDK — execute Workbench-authored flows in production. Successor to the zv1 package; see https://zerowidth.ai for the design surface.",
   "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
   "files": [
     "src/",
     "nodes/",
+    "!nodes/**/*.tests.json",
     "types/",
     "LICENSE",
     "README.md"
@@ -35,6 +41,7 @@
     "dotenv": "^17.2.2"
   },
   "scripts": {
+    "test": "node tests/test.all-nodes.js",
     "test-nodes": "node tests/test.all-nodes.js",
     "test-flows": "node tests/test.flows.js",
     "test-flow": "node tests/test.flows.js",

package/src/integrations/openrouter.js

@@ -536,6 +536,11 @@ export default class OpenRouterIntegration {
         if (totalWeight > 0) {
             inputCost = totalCost * (inputWeight / totalWeight);
             outputCost = totalCost * (outputWeight / totalWeight);
+        } else if (promptTokens + completionTokens > 0) {
+            // Baked pricing has no usable rates (e.g. router models, whose price
+            // depends on the model they pick): apportion by token count instead
+            inputCost = totalCost * (promptTokens / (promptTokens + completionTokens));
+            outputCost = totalCost - inputCost;
         } else {
             // No token-weighted basis (e.g. rerank): attribute everything to one line
             inputCost = totalCost;
@@ -772,4 +777,112 @@ export default class OpenRouterIntegration {
             throw new Error(error.message);
         }
     }
-}
+
+    /**
+     * Ask typed questions about a state via OpenRouter's System One endpoint
+     * (/systemone) — the "decisions" output modality used by TypeSafe's Jev and
+     * other System One-compatible models (Upstage Solar Decide, Respan Span-01,
+     * Kev, ...). Not a chat endpoint: the request is { model, state, questions }
+     * and the response is { model, answers, usage }, one typed answer per
+     * question id (noul / choice / score).
+     *
+     * @param {Object} params - { model, state, questions }
+     *   `state` may be a string, object, or array. `questions` is a map of
+     *   question id -> { type: 'noul'|'choice'|'score', instructions, criteria? }.
+     * @param {Object} nodeConfig - node config (provides `pricing` for cost calc)
+     * @param {Object} engineConfig - engine config (for API call events)
+     * @returns {Promise<Object>} { answers, model, usage, cost_total, cost_itemized }
+     */
+    async systemOne(params, nodeConfig = null, engineConfig = null) {
+        const { model, state, questions } = params;
+
+        if (state === null || state === undefined) {
+            throw new Error('state is required for System One requests');
+        }
+        if (!questions || typeof questions !== 'object' || Array.isArray(questions) || Object.keys(questions).length === 0) {
+            throw new Error('questions must be a non-empty object mapping question ids to { type, instructions, criteria }');
+        }
+
+        const payload = { model, state, questions };
+
+        const url = `${this.client.baseURL}/systemone`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'HTTP-Referer': this.client._options?.defaultHeaders?.['HTTP-Referer'] || 'https://workbench.zerowidth.ai',
+            'X-Title': this.client._options?.defaultHeaders?.['X-Title'] || 'Workbench by ZeroWidth',
+            'Authorization': `Bearer ${this.client._options?.apiKey || ''}`
+        };
+
+        const apiCallStartTime = Date.now();
+
+        try {
+            const res = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(payload),
+                signal: engineConfig?.signal || this._engineConfig?.signal,
+            });
+
+            if (!res.ok) {
+                const errorBody = await res.json().catch(() => null);
+                const detail = errorBody?.error?.message || errorBody?.detail;
+                const errorMessage = typeof detail === 'string' ? detail : (detail ? JSON.stringify(detail) : `HTTP ${res.status}`);
+                throw new Error(`OpenRouter API Error (${res.status}): ${errorMessage}`);
+            }
+
+            const data = await res.json();
+
+            // System One usage is { input_tokens, output_tokens, cost }; normalize
+            // to the chat-style token names used across workbench.
+            const promptTokens = data.usage?.input_tokens || 0;
+            const completionTokens = data.usage?.output_tokens || 0;
+            const usage = {
+                prompt_tokens: promptTokens,
+                completion_tokens: completionTokens,
+                total_tokens: promptTokens + completionTokens
+            };
+
+            let costData = null;
+            if (nodeConfig) {
+                costData = this.buildCostData({ ...usage, cost: data.usage?.cost }, nodeConfig.pricing);
+            }
+
+            const result = {
+                answers: data.answers || {},
+                model: data.model || model,
+                usage,
+                ...(costData && {
+                    cost_total: costData.totalCost,
+                    cost_itemized: costData.itemizedCosts
+                }),
+            };
+
+            await emitAPICallEvent(engineConfig || this._engineConfig, {
+                timestamp: apiCallStartTime,
+                integration: 'openrouter',
+                nodeId: nodeConfig?.id || null,
+                nodeType: nodeConfig?.type || null,
+                request: { method: 'POST', url, headers, body: payload },
+                response: { status: res.status, statusText: res.statusText, body: result },
+                duration: Date.now() - apiCallStartTime,
+                error: null
+            });
+
+            return result;
+        } catch (error) {
+            await emitAPICallEvent(engineConfig || this._engineConfig, {
+                timestamp: apiCallStartTime,
+                integration: 'openrouter',
+                nodeId: nodeConfig?.id || null,
+                nodeType: nodeConfig?.type || null,
+                request: { method: 'POST', url, headers, body: payload },
+                response: { status: error.status || 0, statusText: 'Error', body: null },
+                duration: Date.now() - apiCallStartTime,
+                error: { message: error.message }
+            });
+
+            console.error('OpenRouter System One Error:', error.message);
+            throw new Error(error.message);
+        }
+    }
+}

package/nodes/absolute/absolute.tests.json

@@ -1,38 +0,0 @@
-[
-  {
-    "description": "Positive number",
-    "inputs": {
-      "number": 5.7
-    },
-    "expected": {
-      "result": 5.7
-    }
-  },
-  {
-    "description": "Negative number",
-    "inputs": {
-      "number": -3.2
-    },
-    "expected": {
-      "result": 3.2
-    }
-  },
-  {
-    "description": "Zero",
-    "inputs": {
-      "number": 0
-    },
-    "expected": {
-      "result": 0
-    }
-  },
-  {
-    "description": "Large negative",
-    "inputs": {
-      "number": -999999
-    },
-    "expected": {
-      "result": 999999
-    }
-  }
-] 

package/nodes/absolute-value/absolute-value.tests.json

@@ -1,17 +0,0 @@
-[
-  {
-    "description": "Absolute-value of a positive number",
-    "inputs": { "input": 5 },
-    "expected": { "output": 5 }
-  },
-  {
-    "description": "Absolute-value of a negative number",
-    "inputs": { "input": -5 },
-    "expected": { "output": 5 }
-  },
-  {
-    "description": "Absolute-value of zero",
-    "inputs": { "input": 0 },
-    "expected": { "output": 0 }
-  }
-]

package/nodes/add/add.tests.json

@@ -1,41 +0,0 @@
-[
-  {
-    "description": "Add positive numbers",
-    "inputs": {
-      "a": 5,
-      "b": 3
-    },
-    "expected": {
-      "result": 8
-    }
-  },
-  {
-    "description": "Add negative numbers",
-    "inputs": {
-      "a": -2,
-      "b": -4
-    },
-    "expected": {
-      "result": -6
-    }
-  },
-  {
-    "description": "Add decimals",
-    "inputs": {
-      "a": 1.5,
-      "b": 2.7
-    },
-    "expected": {
-      "result": 4.2
-    }
-  },
-  {
-    "description": "Handle missing inputs",
-    "inputs": {
-      "a": 5
-    },
-    "expected": {
-      "result": 5
-    }
-  }
-] 

package/nodes/airtable-create-record/airtable-create-record.tests.json

@@ -1,50 +0,0 @@
-[
-  {
-    "description": "Create record with Name field",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "fields": {
-        "Name": "Test Record from CI"
-      }
-    },
-    "expected": {
-      "record": "object",
-      "id": "string",
-      "fields": "object",
-      "created_time": "string"
-    }
-  },
-  {
-    "description": "Create record with all fields",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "fields": {
-        "Name": "Full Test Record",
-        "Status": "Active",
-        "Count": 42
-      }
-    },
-    "expected": {
-      "record": "object",
-      "id": "string",
-      "fields": "object"
-    }
-  },
-  {
-    "description": "Create with typecast enabled",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "fields": {
-        "Name": "Typecast Test",
-        "Count": "99"
-      },
-      "typecast": true
-    },
-    "expected": {
-      "id": "string"
-    }
-  }
-]

package/nodes/airtable-delete-record/airtable-delete-record.tests.json

@@ -1,23 +0,0 @@
-[
-  {
-    "description": "Delete existing record",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "record_id": "${AIRTABLE_TEST_RECORD_TO_DELETE}"
-    },
-    "expected": {
-      "deleted": true,
-      "record_id": "string"
-    }
-  },
-  {
-    "description": "Error on invalid record ID",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "record_id": "recINVALIDXXXXXX"
-    },
-    "expectedError": "Airtable API error"
-  }
-]

package/nodes/airtable-get-record/airtable-get-record.tests.json

@@ -1,25 +0,0 @@
-[
-  {
-    "description": "Get record by ID",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "record_id": "${AIRTABLE_TEST_RECORD_ID}"
-    },
-    "expected": {
-      "record": "object",
-      "id": "string",
-      "fields": "object",
-      "created_time": "string"
-    }
-  },
-  {
-    "description": "Error on invalid record ID",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "record_id": "recINVALIDXXXXXX"
-    },
-    "expectedError": "Airtable API error"
-  }
-]

package/nodes/airtable-list-records/airtable-list-records.tests.json

@@ -1,46 +0,0 @@
-[
-  {
-    "description": "List all records from test table",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}"
-    },
-    "expected": {
-      "records": "array"
-    }
-  },
-  {
-    "description": "Filter records by Status field",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "filter_formula": "{Status} = 'Active'"
-    },
-    "expected": {
-      "records": "array"
-    }
-  },
-  {
-    "description": "Sort records by Name ascending",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "sort_field": "Name",
-      "sort_direction": "asc"
-    },
-    "expected": {
-      "records": "array"
-    }
-  },
-  {
-    "description": "Limit results with max_records",
-    "inputs": {
-      "base_id": "${AIRTABLE_TEST_BASE_ID}",
-      "table_name": "${AIRTABLE_TEST_TABLE_NAME}",
-      "max_records": 1
-    },
-    "expected": {
-      "records": "array"
-    }
-  }
-]