machinaos 0.0.10 → 0.0.13

package/server/skills/coding_agent/javascript-skill/SKILL.md

@@ -0,0 +1,196 @@
+---
+name: javascript-skill
+description: Execute JavaScript code for calculations, data processing, and JSON manipulation. Full ES6+ support with Node.js runtime.
+allowed-tools: javascript_code
+metadata:
+  author: machina
+  version: "1.0"
+  category: code
+  icon: "📜"
+  color: "#F7DF1E"
+---
+
+# JavaScript Code Execution Tool
+
+Execute JavaScript code for calculations, data processing, and JSON manipulation.
+
+## How It Works
+
+This skill provides instructions for the **JavaScript Executor** tool node. Connect the **JavaScript Executor** node to Zeenie's `input-tools` handle to enable JavaScript code execution.
+
+## javascript_code Tool
+
+Execute JavaScript code and return results.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| code | string | Yes | JavaScript code to execute |
+
+### Available Features
+
+| Feature | Description |
+|---------|-------------|
+| ES6+ syntax | Arrow functions, destructuring, spread operator |
+| `JSON` | JSON.parse() and JSON.stringify() |
+| `Math` | Mathematical operations |
+| `Date` | Date and time manipulation |
+| `Array` methods | map, filter, reduce, sort, etc. |
+| `Object` methods | keys, values, entries, assign |
+| `String` methods | All standard string methods |
+
+### Built-in Variables
+
+| Variable | Description |
+|----------|-------------|
+| `input_data` | Data from connected workflow nodes (object) |
+| `output` | Set this to return a result |
+
+### Output Methods
+
+1. **Set `output` variable**: Returns structured data to the workflow
+2. **Use `console.log()`**: Captured as console output
+
+### Examples
+
+**Basic calculation:**
+```json
+{
+  "code": "const result = 25 * 4 + 10;\nconsole.log(`Result: ${result}`);\noutput = result;"
+}
+```
+
+**Array processing:**
+```json
+{
+  "code": "const numbers = input_data.numbers || [1, 2, 3, 4, 5];\nconst total = numbers.reduce((a, b) => a + b, 0);\nconst average = total / numbers.length;\nconsole.log(`Total: ${total}, Average: ${average}`);\noutput = { total, average };"
+}
+```
+
+**Filter array:**
+```json
+{
+  "code": "const numbers = input_data.numbers || [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];\nconst evens = numbers.filter(n => n % 2 === 0);\nconsole.log(`Even numbers: ${evens}`);\noutput = evens;"
+}
+```
+
+**Transform data:**
+```json
+{
+  "code": "const users = input_data.users || [{name: 'John', age: 30}, {name: 'Jane', age: 25}];\nconst names = users.map(u => u.name);\nconsole.log(`Names: ${names.join(', ')}`);\noutput = names;"
+}
+```
+
+**JSON manipulation:**
+```json
+{
+  "code": "const data = { name: 'John', age: 30, city: 'NYC' };\nconst json = JSON.stringify(data, null, 2);\nconsole.log(json);\noutput = data;"
+}
+```
+
+**Object operations:**
+```json
+{
+  "code": "const obj = { a: 1, b: 2, c: 3 };\nconst keys = Object.keys(obj);\nconst values = Object.values(obj);\nconst sum = values.reduce((a, b) => a + b, 0);\nconsole.log(`Sum of values: ${sum}`);\noutput = { keys, values, sum };"
+}
+```
+
+**Date operations:**
+```json
+{
+  "code": "const now = new Date();\nconst tomorrow = new Date(now.getTime() + 24 * 60 * 60 * 1000);\nconst formatted = tomorrow.toISOString().split('T')[0];\nconsole.log(`Tomorrow: ${formatted}`);\noutput = formatted;"
+}
+```
+
+**Sort array:**
+```json
+{
+  "code": "const items = input_data.items || ['banana', 'apple', 'cherry'];\nconst sorted = [...items].sort();\nconsole.log(`Sorted: ${sorted}`);\noutput = sorted;"
+}
+```
+
+**String processing:**
+```json
+{
+  "code": "const text = 'Hello World, Hello JavaScript';\nconst words = text.split(' ');\nconst unique = [...new Set(words)];\nconsole.log(`Unique words: ${unique}`);\noutput = unique;"
+}
+```
+
+**Destructuring and spread:**
+```json
+{
+  "code": "const { name, age } = input_data.user || { name: 'John', age: 30 };\nconst profile = { name, age, active: true };\nconst extended = { ...profile, role: 'admin' };\nconsole.log(JSON.stringify(extended));\noutput = extended;"
+}
+```
+
+### Response Format
+
+**Success:**
+```json
+{
+  "success": true,
+  "result": { "total": 15, "average": 3 },
+  "output": "Total: 15, Average: 3"
+}
+```
+
+**Error:**
+```json
+{
+  "error": "ReferenceError: undefinedVar is not defined"
+}
+```
+
+## Use Cases
+
+| Use Case | Approach |
+|----------|----------|
+| Array manipulation | Use map, filter, reduce |
+| JSON processing | Use JSON.parse, JSON.stringify |
+| Object operations | Use Object.keys, values, entries |
+| String processing | Use split, join, replace |
+| Math calculations | Use Math methods |
+| Date operations | Use Date object |
+| Data transformation | Use spread and destructuring |
+
+## Guidelines
+
+1. **Always set `output`**: This returns data to the workflow
+2. **Use `console.log()` for debugging**: Output is captured and returned
+3. **Use ES6+ features**: Arrow functions, destructuring, spread
+4. **Handle undefined**: Use `|| defaultValue` pattern
+5. **Keep code focused**: One task per execution
+6. **No network access**: Use http-skill for web requests
+7. **Timeout**: Default 30 seconds max execution time
+
+## Security Restrictions
+
+- No network/fetch operations
+- No file system access (no require('fs'))
+- No child processes
+- Limited execution time (30 seconds)
+- Sandboxed environment
+
+## Common Patterns
+
+**Default values:**
+```javascript
+const data = input_data.value || 'default';
+```
+
+**Null-safe access:**
+```javascript
+const name = input_data?.user?.name || 'Unknown';
+```
+
+**Array to object:**
+```javascript
+const arr = [{id: 1, name: 'A'}, {id: 2, name: 'B'}];
+const obj = Object.fromEntries(arr.map(x => [x.id, x.name]));
+```
+
+## Setup Requirements
+
+1. Connect the **JavaScript Executor** node to Zeenie's `input-tools` handle
+2. Node.js must be installed on the server

package/server/skills/coding_agent/python-skill/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: python-skill
+description: Execute Python code for calculations, data processing, and automation. Access to math, json, datetime, collections, and more.
+allowed-tools: python_code
+metadata:
+  author: machina
+  version: "1.0"
+  category: code
+  icon: "🐍"
+  color: "#3776AB"
+---
+
+# Python Code Execution Tool
+
+Execute Python code for calculations, data processing, and automation tasks.
+
+## How It Works
+
+This skill provides instructions for the **Python Executor** tool node. Connect the **Python Executor** node to Zeenie's `input-tools` handle to enable Python code execution.
+
+## python_code Tool
+
+Execute Python code and return results.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| code | string | Yes | Python code to execute |
+
+### Available Libraries
+
+| Library | Description |
+|---------|-------------|
+| `math` | Mathematical functions (sqrt, pow, sin, cos, etc.) |
+| `json` | JSON encoding/decoding |
+| `datetime` | Date and time manipulation |
+| `timedelta` | Time duration calculations |
+| `re` | Regular expressions |
+| `random` | Random number generation |
+| `Counter` | Count hashable objects |
+| `defaultdict` | Dictionary with default values |
+
+### Built-in Variables
+
+| Variable | Description |
+|----------|-------------|
+| `input_data` | Data from connected workflow nodes (dict) |
+| `output` | Set this to return a result |
+
+### Output Methods
+
+1. **Set `output` variable**: Returns structured data to the workflow
+2. **Use `print()`**: Captured as console output
+
+### Examples
+
+**Basic calculation:**
+```json
+{
+  "code": "result = 25 * 4 + 10\nprint(f'Result: {result}')\noutput = result"
+}
+```
+
+**Calculate tip:**
+```json
+{
+  "code": "bill = 85.50\ntip_percent = 15\ntip = bill * (tip_percent / 100)\ntotal = bill + tip\nprint(f'Tip: ${tip:.2f}')\nprint(f'Total: ${total:.2f}')\noutput = {'tip': tip, 'total': total}"
+}
+```
+
+**Generate random numbers:**
+```json
+{
+  "code": "import random\nnumbers = [random.randint(1, 100) for _ in range(5)]\nprint(f'Random numbers: {numbers}')\noutput = numbers"
+}
+```
+
+**Date calculations:**
+```json
+{
+  "code": "from datetime import datetime, timedelta\ntoday = datetime.now()\nfuture = today + timedelta(days=30)\nresult = future.strftime('%Y-%m-%d')\nprint(f'30 days from now: {result}')\noutput = result"
+}
+```
+
+**Process data:**
+```json
+{
+  "code": "data = input_data.get('numbers', [1, 2, 3, 4, 5])\ntotal = sum(data)\naverage = total / len(data)\nprint(f'Total: {total}, Average: {average}')\noutput = {'total': total, 'average': average}"
+}
+```
+
+**Parse JSON:**
+```json
+{
+  "code": "import json\njson_str = '{\"name\": \"John\", \"age\": 30}'\ndata = json.loads(json_str)\nprint(f'Name: {data[\"name\"]}')\noutput = data"
+}
+```
+
+**Count items:**
+```json
+{
+  "code": "from collections import Counter\nitems = ['apple', 'banana', 'apple', 'cherry', 'banana', 'apple']\ncounts = dict(Counter(items))\nprint(f'Counts: {counts}')\noutput = counts"
+}
+```
+
+**Text processing:**
+```json
+{
+  "code": "import re\ntext = 'Contact: john@example.com or jane@test.org'\nemails = re.findall(r'\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b', text)\nprint(f'Found emails: {emails}')\noutput = emails"
+}
+```
+
+### Response Format
+
+**Success:**
+```json
+{
+  "success": true,
+  "result": {"tip": 12.825, "total": 98.325},
+  "output": "Tip: $12.83\nTotal: $98.33"
+}
+```
+
+**Error:**
+```json
+{
+  "error": "name 'undefined_var' is not defined"
+}
+```
+
+## Use Cases
+
+| Use Case | Approach |
+|----------|----------|
+| Math calculations | Use `math` library functions |
+| Date/time operations | Use `datetime` and `timedelta` |
+| Data analysis | Use list comprehensions, sum, len |
+| Random generation | Use `random` library |
+| Text parsing | Use `re` regular expressions |
+| JSON manipulation | Use `json.loads()` and `json.dumps()` |
+| Counting | Use `Counter` from collections |
+
+## Guidelines
+
+1. **Always set `output`**: This returns data to the workflow
+2. **Use `print()` for debugging**: Output is captured and returned
+3. **Keep code focused**: One task per execution
+4. **Handle errors**: Use try/except for robust code
+5. **No network access**: Use http-skill for web requests
+6. **No file system access**: Restricted to safe operations
+7. **Timeout**: Default 30 seconds max execution time
+
+## Security Restrictions
+
+- No network/socket operations
+- No file system access outside designated areas
+- No subprocess/shell commands
+- Limited execution time (30 seconds)
+- Sandboxed environment
+
+## Setup Requirements
+
+1. Connect the **Python Executor** node to Zeenie's `input-tools` handle
+2. Python must be installed on the server

package/server/skills/social_agent/whatsapp-db-skill/SKILL.md

@@ -0,0 +1,284 @@
+---
+name: whatsapp-db-skill
+description: Query WhatsApp database for contacts, groups, and chat history. Look up contact info, search groups, retrieve messages.
+allowed-tools: whatsapp_db
+metadata:
+  author: machina
+  version: "1.0"
+  category: messaging
+  icon: "🗃️"
+  color: "#25D366"
+---
+
+# WhatsApp Database Tool
+
+Query WhatsApp database for contacts, groups, and message history.
+
+## How It Works
+
+This skill provides instructions for the **WhatsApp DB** tool node. Connect the **WhatsApp DB** node to Zeenie's `input-tools` handle to enable database queries.
+
+## whatsapp_db Tool
+
+Query contacts, groups, and chat history.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| operation | string | Yes | Operation type (see below) |
+| chat_type | string | For chat_history | `"individual"` or `"group"` |
+| phone | string | Varies | Phone number (for chat_history individual, get_contact_info) |
+| group_id | string | Varies | Group JID (for chat_history group, get_group_info) |
+| query | string | No | Search query (for search_groups, list_contacts) |
+| limit | int | No | Max results (varies by operation) |
+| offset | int | No | Pagination offset (for chat_history) |
+| message_filter | string | No | `"all"` or `"text_only"` (for chat_history) |
+| group_filter | string | No | `"all"` or `"contact"` (for group chat_history) |
+| sender_phone | string | No | Filter by sender (when group_filter="contact") |
+| phones | string | For check_contacts | Comma-separated phone numbers |
+| participant_limit | int | No | Max participants (for get_group_info, 1-100) |
+
+### Operations
+
+| Operation | Description | Required Fields |
+|-----------|-------------|-----------------|
+| `list_contacts` | List contacts with saved names | query (optional), limit |
+| `get_contact_info` | Get full contact details | phone |
+| `search_groups` | Search groups by name | query, limit |
+| `get_group_info` | Get group details with participants | group_id |
+| `chat_history` | Retrieve message history | chat_type, phone/group_id |
+| `check_contacts` | Check WhatsApp registration | phones |
+
+### Limits
+
+| Operation | Default | Max |
+|-----------|---------|-----|
+| chat_history | 50 | 500 |
+| search_groups | 20 | 50 |
+| list_contacts | 50 | 100 |
+| get_group_info participants | 50 | 100 |
+
+**Important:** Always use small limits and specific queries to avoid context overflow.
+
+## Operation Examples
+
+### list_contacts
+
+Find contacts by name.
+
+```json
+{
+  "operation": "list_contacts",
+  "query": "mom",
+  "limit": 10
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "operation": "list_contacts",
+  "contacts": [
+    {"phone": "919876543210", "name": "Mom", "jid": "919876543210@s.whatsapp.net"}
+  ],
+  "total": 1
+}
+```
+
+### get_contact_info
+
+Get full contact details for sending/replying.
+
+```json
+{
+  "operation": "get_contact_info",
+  "phone": "919876543210"
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "operation": "get_contact_info",
+  "phone": "919876543210",
+  "name": "Mom",
+  "jid": "919876543210@s.whatsapp.net",
+  "profile_picture": "https://..."
+}
+```
+
+### search_groups
+
+Search groups by name.
+
+```json
+{
+  "operation": "search_groups",
+  "query": "family",
+  "limit": 10
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "operation": "search_groups",
+  "groups": [
+    {"group_id": "120363123456789@g.us", "name": "Family Group", "participant_count": 5}
+  ],
+  "total": 1
+}
+```
+
+### get_group_info
+
+Get group details with participant list.
+
+```json
+{
+  "operation": "get_group_info",
+  "group_id": "120363123456789@g.us",
+  "participant_limit": 20
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "operation": "get_group_info",
+  "name": "Family Group",
+  "jid": "120363123456789@g.us",
+  "participants": [
+    {"phone": "919876543210", "name": "Mom", "is_admin": true},
+    {"phone": "919876543211", "name": "Dad", "is_admin": false}
+  ],
+  "total_participants": 5
+}
+```
+
+### chat_history (Individual)
+
+Get messages from an individual chat.
+
+```json
+{
+  "operation": "chat_history",
+  "chat_type": "individual",
+  "phone": "919876543210",
+  "limit": 20
+}
+```
+
+### chat_history (Group)
+
+Get messages from a group chat.
+
+```json
+{
+  "operation": "chat_history",
+  "chat_type": "group",
+  "group_id": "120363123456789@g.us",
+  "message_filter": "text_only",
+  "limit": 50
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "operation": "chat_history",
+  "messages": [
+    {
+      "index": 1,
+      "message_id": "ABC123",
+      "sender": "919876543210@s.whatsapp.net",
+      "sender_name": "Mom",
+      "text": "Hello!",
+      "timestamp": "2025-01-30T12:00:00",
+      "is_from_me": false
+    }
+  ],
+  "total": 50,
+  "has_more": true
+}
+```
+
+### check_contacts
+
+Check if phone numbers have WhatsApp.
+
+```json
+{
+  "operation": "check_contacts",
+  "phones": "1234567890,0987654321"
+}
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "operation": "check_contacts",
+  "results": [
+    {"phone": "1234567890", "registered": true, "jid": "1234567890@s.whatsapp.net"},
+    {"phone": "0987654321", "registered": false}
+  ]
+}
+```
+
+## Common Workflows
+
+### Find and message someone by name
+
+1. Use `list_contacts` with query to find the person
+2. Get their phone number from the result
+3. Use `whatsapp_send` tool with the phone number
+
+### Get recent messages from a contact
+
+1. Use `chat_history` with chat_type="individual"
+2. Set appropriate limit for desired history depth
+
+### Find and message a group
+
+1. Use `search_groups` to find the group by name
+2. Get the group_id from the result
+3. Use `whatsapp_send` tool with recipient_type="group"
+
+### See who's in a group
+
+1. Use `get_group_info` with the group_id
+2. Set participant_limit to control output size
+
+## Guidelines
+
+1. **Phone numbers**: Always use without + prefix, just digits
+2. **Group IDs**: JID format ending in `@g.us`
+3. **Limits**: Use small limits to avoid context overflow
+4. **Queries**: Be specific to narrow results
+5. **Pagination**: Use offset to page through chat_history
+
+## Error Responses
+
+```json
+{
+  "error": "Phone number is required for chat_type='individual'"
+}
+```
+
+```json
+{
+  "error": "group_id is required for get_group_info"
+}
+```
+
+## Setup Requirements
+
+1. Connect the **WhatsApp DB** node to Zeenie's `input-tools` handle
+2. Ensure WhatsApp is connected (green status indicator in Credentials)