machinaos 0.0.12 → 0.0.13

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)

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

@@ -0,0 +1,180 @@
+---
+name: whatsapp-send-skill
+description: Send WhatsApp messages to contacts or groups. Supports text, images, videos, audio, documents, stickers, locations, and contacts.
+allowed-tools: whatsapp_send
+metadata:
+  author: machina
+  version: "1.0"
+  category: messaging
+  icon: "📤"
+  color: "#25D366"
+---
+
+# WhatsApp Send Tool
+
+Send messages to WhatsApp contacts or groups.
+
+## How It Works
+
+This skill provides instructions for the **WhatsApp Send** tool node. Connect the **WhatsApp Send** node to Zeenie's `input-tools` handle to enable message sending.
+
+## whatsapp_send Tool
+
+Send messages to individual contacts or groups.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| recipient_type | string | Yes | `"phone"` for individual or `"group"` for group chat |
+| phone | string | If phone | Phone number without + prefix (e.g., `1234567890`) |
+| group_id | string | If group | Group JID (e.g., `123456789@g.us`) |
+| message_type | string | Yes | Message type (see below) |
+| message | string | If text | Text message content |
+| media_url | string | If media | URL for image/video/audio/document/sticker |
+| caption | string | No | Caption for media messages |
+| latitude | float | If location | Latitude coordinate |
+| longitude | float | If location | Longitude coordinate |
+| location_name | string | No | Display name for location |
+| address | string | No | Address text for location |
+| contact_name | string | If contact | Contact display name |
+| vcard | string | If contact | vCard 3.0 format string |
+
+### Message Types
+
+| Type | Required Fields | Description |
+|------|-----------------|-------------|
+| `text` | message | Plain text message |
+| `image` | media_url | Image file (JPG, PNG, GIF) |
+| `video` | media_url | Video file (MP4) |
+| `audio` | media_url | Audio file (MP3, OGG, WAV) |
+| `document` | media_url | Any file type |
+| `sticker` | media_url | Sticker image (WebP) |
+| `location` | latitude, longitude | GPS coordinates |
+| `contact` | contact_name, vcard | Contact card |
+
+### Examples
+
+**Send text message to contact:**
+```json
+{
+  "recipient_type": "phone",
+  "phone": "1234567890",
+  "message_type": "text",
+  "message": "Hello! How are you?"
+}
+```
+
+**Send image with caption:**
+```json
+{
+  "recipient_type": "phone",
+  "phone": "1234567890",
+  "message_type": "image",
+  "media_url": "https://example.com/photo.jpg",
+  "caption": "Check out this photo!"
+}
+```
+
+**Send to group:**
+```json
+{
+  "recipient_type": "group",
+  "group_id": "123456789012345678@g.us",
+  "message_type": "text",
+  "message": "Hello everyone!"
+}
+```
+
+**Send video:**
+```json
+{
+  "recipient_type": "phone",
+  "phone": "1234567890",
+  "message_type": "video",
+  "media_url": "https://example.com/video.mp4",
+  "caption": "Check this video"
+}
+```
+
+**Send document:**
+```json
+{
+  "recipient_type": "phone",
+  "phone": "1234567890",
+  "message_type": "document",
+  "media_url": "https://example.com/report.pdf",
+  "caption": "Here's the report"
+}
+```
+
+**Send location:**
+```json
+{
+  "recipient_type": "phone",
+  "phone": "1234567890",
+  "message_type": "location",
+  "latitude": 37.7749,
+  "longitude": -122.4194,
+  "location_name": "San Francisco",
+  "address": "San Francisco, CA, USA"
+}
+```
+
+**Send contact card:**
+```json
+{
+  "recipient_type": "phone",
+  "phone": "1234567890",
+  "message_type": "contact",
+  "contact_name": "John Doe",
+  "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+1234567890\nEND:VCARD"
+}
+```
+
+### Response Format
+
+```json
+{
+  "success": true,
+  "recipient": "1234567890",
+  "recipient_type": "phone",
+  "message_type": "text",
+  "details": {
+    "status": "sent",
+    "preview": "Hello! How are you?",
+    "timestamp": "2025-01-30T12:00:00"
+  }
+}
+```
+
+### Error Response
+
+```json
+{
+  "error": "Phone number is required for recipient_type='phone'"
+}
+```
+
+## Guidelines
+
+1. **Phone numbers**: Always use without + prefix, just digits (e.g., `919876543210`)
+2. **Group IDs**: Use JID format ending in `@g.us` (e.g., `123456789@g.us`)
+3. **Media URLs**: Must be publicly accessible URLs (https://)
+4. **vCard format**: Use vCard 3.0 specification for contact cards
+5. **Message length**: Text messages can be up to 4096 characters
+6. **Media size**: Check WhatsApp limits for media file sizes
+
+## Common Use Cases
+
+- Send automated notifications to contacts
+- Forward messages to groups
+- Share media files
+- Send location information
+- Share contact information
+
+## Setup Requirements
+
+1. Connect the **WhatsApp Send** node to Zeenie's `input-tools` handle
+2. Ensure WhatsApp is connected (green status indicator in Credentials)
+3. The recipient must have WhatsApp installed