machinaos 0.0.1

package/server/skills/scheduler-skill/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: scheduler-skill
+description: Schedule tasks and set timers. Use when user wants to schedule something, set a reminder, create a recurring task, or use cron expressions.
+metadata:
+  author: machina
+  version: "2.0"
+  category: automation
+---
+
+# Task Scheduling
+
+This skill provides context for scheduling tasks, setting timers, and creating recurring jobs.
+
+## How It Works
+
+This skill provides instructions and context. Scheduling is handled through workflow deployment:
+
+- **Cron Scheduler** trigger node - Recurring schedules using cron expressions
+- **Timer** trigger node - One-time delayed execution
+- **Workflow Trigger** node - Manual workflow execution
+
+## Capabilities
+
+When used with workflow triggers:
+- Create one-time timers
+- Set up recurring schedules with cron expressions
+- Deploy workflows that run on schedule
+
+## Cron Expression Format
+
+```
+* * * * *
+| | | | |
+| | | | +-- Day of week (0-7, Sun=0 or 7)
+| | | +---- Month (1-12)
+| | +------ Day of month (1-31)
+| +-------- Hour (0-23)
++---------- Minute (0-59)
+```
+
+### Common Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| `0 9 * * *` | Every day at 9:00 AM |
+| `0 9 * * 1-5` | Weekdays at 9:00 AM |
+| `*/15 * * * *` | Every 15 minutes |
+| `0 0 1 * *` | First day of each month |
+| `0 8,12,18 * * *` | At 8am, noon, and 6pm |
+
+## Example Interactions
+
+**User**: "Remind me in 30 minutes"
+- This requires setting up a Timer trigger workflow
+- Inform user: "I can help you create a scheduled workflow. Set up a Timer trigger node with 30 minute delay."
+
+**User**: "Send a daily report at 9am"
+- This requires a Cron Scheduler workflow
+- Inform user: "Create a workflow with Cron Scheduler trigger using expression '0 9 * * *'"
+
+**User**: "Check for updates every hour"
+- This requires a Cron Scheduler workflow
+- Inform user: "Create a workflow with Cron Scheduler trigger using expression '0 * * * *'"
+
+## Workflow-Based Scheduling
+
+In this system, scheduling is achieved through:
+
+1. **Trigger Nodes**: Cron Scheduler or Timer nodes start workflows
+2. **Workflow Deployment**: Deploy the workflow to activate the schedule
+3. **Cancel**: Undeploy the workflow to cancel the schedule
+
+## Best Practices
+
+1. Explain that schedules require workflow deployment
+2. Provide the cron expression for the user's request
+3. Confirm timezone considerations for time-sensitive tasks
+4. Help users understand workflow-based scheduling model
+
+## Limitations
+
+- This skill provides guidance only
+- Actual scheduling requires workflow creation and deployment
+- Cannot directly create/cancel schedules via chat commands

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

@@ -0,0 +1,283 @@
+---
+name: whatsapp-skill
+description: Send WhatsApp messages, query contacts/groups, retrieve chat history. Look up contact info by name or phone for sending/replying.
+metadata:
+  author: machina
+  version: "3.0"
+  category: messaging
+---
+
+# WhatsApp Messaging Skill
+
+This skill provides context for WhatsApp messaging capabilities.
+
+## How It Works
+
+This skill provides instructions and context. To execute WhatsApp actions, connect the appropriate **tool nodes** to the Chat Agent's `input-tools` handle:
+
+- **WhatsApp Send** node - Send messages to contacts or groups
+- **WhatsApp DB** node - Query contacts, groups, and chat history
+
+## whatsapp_send Tool
+
+Send messages to 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 | "text", "image", "video", "audio", "document", "sticker", "location", "contact" |
+| 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 |
+
+### Examples
+
+**Send text message:**
+```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 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"
+}
+```
+
+### 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"
+  }
+}
+```
+
+## whatsapp_db Tool
+
+Query WhatsApp database - contacts, groups, messages.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| operation | string | Yes | "chat_history", "search_groups", "get_group_info", "get_contact_info", "list_contacts", "check_contacts" |
+| 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 |
+| message_filter | string | No | For chat_history: "all" or "text_only" |
+| group_filter | string | No | For chat_history (group): "all" or "contact" |
+| sender_phone | string | No | For chat_history with group_filter="contact" |
+| limit | int | No | Max results. chat_history: 1-500 (default 50), search_groups: 1-50 (default 20), list_contacts: 1-100 (default 50) |
+| offset | int | No | For chat_history: pagination offset |
+| query | string | No | Search query for search_groups, list_contacts. Use specific queries to narrow results |
+| phones | string | For check_contacts | Comma-separated phone numbers |
+| participant_limit | int | No | For get_group_info: max participants (1-100, default 50) |
+
+**Important:** Always use small limits and specific queries to avoid context overflow errors.
+
+### Operations
+
+#### list_contacts
+List contacts with saved names. Useful for finding someone by name.
+
+```json
+{
+  "operation": "list_contacts",
+  "query": "mom",
+  "limit": 10
+}
+```
+
+#### get_contact_info
+Get full contact info for sending/replying.
+
+```json
+{
+  "operation": "get_contact_info",
+  "phone": "919876543210"
+}
+```
+
+#### search_groups
+Search groups by name. Use specific query to narrow results.
+
+```json
+{
+  "operation": "search_groups",
+  "query": "family",
+  "limit": 10
+}
+```
+
+#### get_group_info
+Get group details with participant names. Large groups may have many participants.
+
+```json
+{
+  "operation": "get_group_info",
+  "group_id": "120363123456789@g.us",
+  "participant_limit": 20
+}
+```
+
+#### chat_history
+Retrieve message history.
+
+```json
+{
+  "operation": "chat_history",
+  "chat_type": "individual",
+  "phone": "1234567890",
+  "limit": 20
+}
+```
+
+```json
+{
+  "operation": "chat_history",
+  "chat_type": "group",
+  "group_id": "123456789012345678@g.us",
+  "message_filter": "text_only",
+  "limit": 50
+}
+```
+
+#### check_contacts
+Check WhatsApp registration status.
+
+```json
+{
+  "operation": "check_contacts",
+  "phones": "1234567890,0987654321"
+}
+```
+
+### Response Formats
+
+**list_contacts response:**
+```json
+{
+  "success": true,
+  "operation": "list_contacts",
+  "contacts": [
+    {"phone": "919876543210", "name": "Mom", "jid": "919876543210@s.whatsapp.net"}
+  ],
+  "total": 1
+}
+```
+
+**chat_history response:**
+```json
+{
+  "success": true,
+  "operation": "chat_history",
+  "messages": [
+    {
+      "index": 1,
+      "message_id": "ABC123",
+      "sender": "919876543210@s.whatsapp.net",
+      "text": "Hello!",
+      "timestamp": "2025-01-30T12:00:00",
+      "is_from_me": false
+    }
+  ],
+  "total": 50,
+  "has_more": true
+}
+```
+
+**get_group_info response:**
+```json
+{
+  "success": true,
+  "operation": "get_group_info",
+  "name": "Family Group",
+  "jid": "123456789@g.us",
+  "participants": [
+    {"phone": "919876543210", "name": "Mom", "is_admin": true},
+    {"phone": "919876543211", "name": "Dad", "is_admin": false}
+  ]
+}
+```
+
+## Common Workflows
+
+### Send message to 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` with the phone number
+
+### Reply to someone in a group
+
+1. Use `get_group_info` to get participant names and phones
+2. Use `whatsapp_send` with recipient_type="phone" and the person's phone
+
+### Find and message a group
+
+1. Use `search_groups` to find the group by name
+2. Use `whatsapp_send` with recipient_type="group" and the group_id
+
+## Guidelines
+
+1. **Phone numbers**: Always use without + prefix, just digits (e.g., 919876543210)
+2. **Groups**: Use JID format ending in @g.us
+3. **Contact lookup**: Use list_contacts first if you only have a name
+4. **Media URLs**: Must be publicly accessible URLs
+5. **Pagination**: Use offset with limit to page through chat history
+
+## Setup Requirements
+
+1. Connect this skill to Chat Agent's `input-skill` handle
+2. Connect WhatsApp tool nodes to Chat Agent's `input-tools` handle
+3. Ensure WhatsApp is connected (green status indicator)