machinaos 0.0.10 → 0.0.13

package/server/skills/web_agent/http-request-skill/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: http-request-skill
+description: Make HTTP requests to external APIs and web services. Supports GET, POST, PUT, DELETE, PATCH methods with headers and JSON body.
+allowed-tools: http_request
+metadata:
+  author: machina
+  version: "1.0"
+  category: integration
+  icon: "🌐"
+  color: "#EF4444"
+---
+
+# HTTP Request Tool
+
+Make HTTP requests to external APIs and web services.
+
+## How It Works
+
+This skill provides instructions for the **HTTP Request** tool node. Connect the **HTTP Request** node to Zeenie's `input-tools` handle to enable API calls.
+
+## http_request Tool
+
+Make an HTTP request to any URL.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| url | string | Yes | Full URL to request (e.g., `https://api.example.com/data`) |
+| method | string | No | HTTP method: `GET`, `POST`, `PUT`, `DELETE`, `PATCH` (default: `GET`) |
+| body | object | No | Request body as JSON object (for POST/PUT/PATCH) |
+
+### Node Parameters
+
+Additional options can be configured on the node:
+
+| Parameter | Description |
+|-----------|-------------|
+| headers | Custom headers as JSON (e.g., `{"Authorization": "Bearer token"}`) |
+| base_url | Base URL prepended to the url parameter |
+
+### Response Format
+
+```json
+{
+  "status": 200,
+  "data": { "key": "value" },
+  "url": "https://api.example.com/data",
+  "method": "GET"
+}
+```
+
+### Examples
+
+**GET request (fetch data):**
+```json
+{
+  "url": "https://api.example.com/users/123",
+  "method": "GET"
+}
+```
+
+**POST request (create resource):**
+```json
+{
+  "url": "https://api.example.com/users",
+  "method": "POST",
+  "body": {
+    "name": "John Doe",
+    "email": "john@example.com"
+  }
+}
+```
+
+**PUT request (update resource):**
+```json
+{
+  "url": "https://api.example.com/users/123",
+  "method": "PUT",
+  "body": {
+    "name": "John Updated"
+  }
+}
+```
+
+**DELETE request:**
+```json
+{
+  "url": "https://api.example.com/users/123",
+  "method": "DELETE"
+}
+```
+
+**PATCH request (partial update):**
+```json
+{
+  "url": "https://api.example.com/users/123",
+  "method": "PATCH",
+  "body": {
+    "status": "active"
+  }
+}
+```
+
+### Real-World Examples
+
+**Get Bitcoin price:**
+```json
+{
+  "url": "https://api.coindesk.com/v1/bpi/currentprice.json",
+  "method": "GET"
+}
+```
+
+**Get weather:**
+```json
+{
+  "url": "https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_KEY",
+  "method": "GET"
+}
+```
+
+**Post to webhook:**
+```json
+{
+  "url": "https://hooks.slack.com/services/xxx",
+  "method": "POST",
+  "body": {
+    "text": "Hello from MachinaOS!"
+  }
+}
+```
+
+**Check website status:**
+```json
+{
+  "url": "https://example.com",
+  "method": "GET"
+}
+```
+
+### Error Responses
+
+**Timeout:**
+```json
+{
+  "error": "Request timed out"
+}
+```
+
+**Connection failed:**
+```json
+{
+  "error": "Connection failed: Unable to reach host"
+}
+```
+
+**HTTP error:**
+```json
+{
+  "status": 404,
+  "data": "Not Found",
+  "url": "https://api.example.com/missing",
+  "method": "GET"
+}
+```
+
+## HTTP Status Codes
+
+| Status | Meaning | Action |
+|--------|---------|--------|
+| 200-299 | Success | Process the response data |
+| 400 | Bad Request | Check request parameters |
+| 401 | Unauthorized | Check API key/authentication |
+| 403 | Forbidden | Insufficient permissions |
+| 404 | Not Found | Check URL path |
+| 429 | Too Many Requests | Rate limited, wait and retry |
+| 500-599 | Server Error | External service issue |
+
+## Use Cases
+
+| Use Case | Method | Description |
+|----------|--------|-------------|
+| Fetch data | GET | Retrieve resources |
+| Create resource | POST | Add new data |
+| Update resource | PUT/PATCH | Modify existing data |
+| Delete resource | DELETE | Remove data |
+| Health check | GET | Verify service availability |
+| Webhook trigger | POST | Send events to services |
+
+## Guidelines
+
+1. **URLs**: Must be fully qualified with protocol (https://)
+2. **Authentication**: Use node headers for API keys/tokens
+3. **Timeout**: Default 30 seconds
+4. **JSON body**: Automatically serialized for POST/PUT/PATCH
+5. **Response**: JSON responses are automatically parsed
+
+## Security Notes
+
+1. Never expose API keys in responses to users
+2. Validate URLs before making requests
+3. Avoid internal/private network addresses (localhost, 192.168.x.x)
+4. Respect rate limits of external services
+5. Don't store sensitive data from API responses
+
+## Setup Requirements
+
+1. Connect the **HTTP Request** node to Zeenie's `input-tools` handle
+2. Configure authentication headers on the node if needed
+3. Ensure network access to target APIs

package/server/skills/android/skill/SKILL.md

@@ -1,84 +0,0 @@
----
-name: android-skill
-description: Control Android devices - battery, wifi, bluetooth, apps, location, camera, and sensors. Use when user wants to interact with their Android phone or tablet.
-metadata:
-  author: machina
-  version: "2.0"
-  category: device
-  icon: "📱"
-  color: "#3DDC84"
----
-
-# Android Device Control
-
-This skill provides context for monitoring and controlling Android devices.
-
-## How It Works
-
-This skill provides instructions and context. To execute Android actions, connect the **Android Toolkit** node to the Zeenie's `input-tools` handle, then connect Android service nodes to the toolkit:
-
-```
-[Battery Monitor] --+
-                    |
-[WiFi Automation] --+--> [Android Toolkit] --> [Zeenie]
-                    |
-[Location]       ---+
-```
-
-## Available Android Service Nodes
-
-Connect these to the Android Toolkit:
-
-| Node | Capabilities |
-|------|-------------|
-| **Battery Monitor** | Battery level, charging status, health, temperature |
-| **WiFi Automation** | Enable/disable WiFi, scan networks, get status |
-| **Bluetooth Automation** | Enable/disable Bluetooth, paired devices |
-| **App Launcher** | Launch applications by package name |
-| **App List** | List installed applications |
-| **Location** | Get current GPS coordinates |
-| **Audio Automation** | Volume control, mute/unmute |
-| **Screen Control** | Brightness, wake/sleep screen |
-| **Camera Control** | Camera info, capture photos |
-| **Motion Detection** | Accelerometer, gyroscope data |
-| **Environmental Sensors** | Temperature, humidity, pressure |
-
-## Example Interactions
-
-**User**: "What's my phone's battery level?"
-- Use the Battery Monitor service with action "status"
-
-**User**: "Turn off WiFi"
-- Use the WiFi Automation service with action "disable"
-
-**User**: "What apps are installed?"
-- Use the App List service with action "list"
-
-**User**: "Open Chrome"
-- Use the App Launcher service with action "launch", package_name "com.android.chrome"
-
-**User**: "Where is my phone?"
-- Use the Location service with action "current"
-
-**User**: "Set volume to 50%"
-- Use the Audio Automation service with action "set_volume", volume 50
-
-## Device Connection
-
-Before using Android tools, ensure:
-1. Device is connected via ADB (USB) or remote WebSocket
-2. Android Device Setup node shows connected status (green indicator)
-3. Required permissions are granted on the device
-
-## Error Handling
-
-- If device is not connected, inform user to check connection
-- If permission is denied, suggest enabling it in device settings
-- If action fails, provide the error message and suggest alternatives
-
-## Setup Requirements
-
-1. Connect this skill to Zeenie's `input-skill` handle
-2. Add **Android Toolkit** node and connect to Zeenie's `input-tools` handle
-3. Connect desired Android service nodes to the Android Toolkit
-4. Ensure Android device is paired (green status indicator)

package/server/skills/assistant/code-skill/SKILL.md

@@ -1,176 +0,0 @@
----
-name: code-skill
-description: Execute Python or JavaScript code for calculations, data processing, and automation. Use when user needs to run code, do calculations, or process data.
-allowed-tools: python_code javascript_code
-metadata:
-  author: machina
-  version: "3.0"
-  category: code
-  icon: "💻"
-  color: "#F59E0B"
----
-
-# Code Execution
-
-This skill enables you to execute Python and JavaScript code for various tasks using the `python_code` and `javascript_code` tools.
-
-## Tool: python_code
-
-Execute Python code for calculations, data processing, and automation.
-
-### Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `code` | string | Yes | Python code to execute. Set `output` variable with result. Use `print()` for console output. |
-
-### Available Libraries
-- Standard library: `math`, `json`, `datetime`, `timedelta`, `re`, `random`
-- Collections: `Counter`, `defaultdict`
-- All built-in functions
-
-### Variables Available
-- `input_data` - Data from connected workflow nodes (dict)
-- `output` - Set this variable to return a result
-
-### Returns
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `success` | boolean | Whether execution succeeded |
-| `result` | any | Value of `output` variable if set |
-| `output` | string | Captured print() statements |
-| `error` | string | Error message if execution failed |
-
-### Example Usage
-```python
-# Calculate with data
-data = input_data.get("numbers", [1, 2, 3])
-total = sum(data)
-average = total / len(data)
-print(f"Total: {total}, Average: {average}")
-output = {"total": total, "average": average}
-```
-
----
-
-## Tool: javascript_code
-
-Execute JavaScript code for calculations, data processing, and JSON manipulation.
-
-### Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `code` | string | Yes | JavaScript code to execute. Set `output` variable with result. Use `console.log()` for output. |
-
-### Variables Available
-- `input_data` - Data from connected workflow nodes (object)
-- `output` - Set this variable to return a result
-
-### Returns
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `success` | boolean | Whether execution succeeded |
-| `result` | any | Value of `output` variable if set |
-| `output` | string | Captured console.log() statements |
-| `error` | string | Error message if execution failed |
-
-### Example Usage
-```javascript
-// Process JSON data
-const data = input_data.numbers || [1, 2, 3];
-const total = data.reduce((a, b) => a + b, 0);
-const average = total / data.length;
-console.log(`Total: ${total}, Average: ${average}`);
-output = { total, average };
-```
-
----
-
-## Examples
-
-### Calculate a tip (Python)
-**User**: "Calculate 15% tip on $85.50"
-
-**Tool Call** (python_code):
-```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 (Python)
-**User**: "Generate 5 random numbers between 1 and 100"
-
-**Tool Call** (python_code):
-```json
-{
-  "code": "import random\nnumbers = [random.randint(1, 100) for _ in range(5)]\nprint(f\"Random numbers: {numbers}\")\noutput = numbers"
-}
-```
-
-### Process JSON data (JavaScript)
-**User**: "Sum all the values in this object"
-
-**Tool Call** (javascript_code):
-```json
-{
-  "code": "const values = Object.values(input_data);\nconst sum = values.reduce((a, b) => a + b, 0);\nconsole.log(`Sum: ${sum}`);\noutput = sum;"
-}
-```
-
-### Date calculations (Python)
-**User**: "What date is 30 days from now?"
-
-**Tool Call** (python_code):
-```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"
-}
-```
-
-### Array manipulation (JavaScript)
-**User**: "Filter this array to only even numbers"
-
-**Tool Call** (javascript_code):
-```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;"
-}
-```
-
----
-
-## When to Use Each Tool
-
-| Use Case | Recommended Tool |
-|----------|------------------|
-| Math calculations | `python_code` |
-| Date/time operations | `python_code` |
-| Data analysis | `python_code` |
-| Random number generation | `python_code` |
-| JSON manipulation | `javascript_code` |
-| Array operations | Either |
-| String processing | Either |
-
----
-
-## Security Guidelines
-
-1. **No file system access** outside designated directories
-2. **No network requests** from code (use http-skill instead)
-3. **No system commands** or shell access
-4. **Limited execution time** (timeout configurable, default 30 seconds)
-5. **No sensitive data** in code outputs
-
-## Best Practices
-
-1. Keep code simple and focused on one task
-2. Use descriptive variable names
-3. Always set the `output` variable with your result
-4. Use `print()` / `console.log()` for debugging
-5. Handle potential errors gracefully
-6. Prefer Python for math, dates, and data processing
-7. Prefer JavaScript for JSON manipulation

package/server/skills/assistant/http-skill/SKILL.md

@@ -1,163 +0,0 @@
----
-name: http-skill
-description: Make HTTP requests to external APIs and web services. Use when user needs to fetch data from URLs, call APIs, or interact with web services.
-allowed-tools: http-request
-metadata:
-  author: machina
-  version: "2.0"
-  category: integration
-  icon: "🌐"
-  color: "#EF4444"
----
-
-# HTTP Requests
-
-This skill enables you to make HTTP requests to external APIs and web services.
-
-## Capabilities
-
-- Make GET, POST, PUT, DELETE, PATCH requests
-- Send JSON payloads in request body
-- Set custom headers (authentication, content-type, etc.)
-- Handle API responses (JSON and text)
-
-## Tool Reference
-
-### http-request
-
-Make an HTTP request to a URL.
-
-**Parameters:**
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `url` | string | Yes | - | Full URL to request (e.g., `https://api.example.com/data`) |
-| `method` | string | No | `GET` | HTTP method: `GET`, `POST`, `PUT`, `DELETE`, `PATCH` |
-| `body` | object | No | null | Request body as JSON object (for POST/PUT/PATCH) |
-| `headers` | object | No | null | Custom headers as key-value pairs |
-
-**Returns:**
-| Field | Type | Description |
-|-------|------|-------------|
-| `status` | number | HTTP status code (200, 404, 500, etc.) |
-| `data` | any | Response body (parsed JSON or text) |
-| `headers` | object | Response headers |
-| `url` | string | Final URL (may differ if redirected) |
-| `method` | string | HTTP method used |
-
-## Common Use Cases
-
-### Fetching Data (GET)
-```json
-{
-  "url": "https://api.example.com/users/123",
-  "method": "GET"
-}
-```
-
-### Creating Resources (POST)
-```json
-{
-  "url": "https://api.example.com/users",
-  "method": "POST",
-  "body": {"name": "John", "email": "john@example.com"},
-  "headers": {"Content-Type": "application/json"}
-}
-```
-
-### Updating Resources (PUT/PATCH)
-```json
-{
-  "url": "https://api.example.com/users/123",
-  "method": "PUT",
-  "body": {"name": "John Updated"}
-}
-```
-
-### Deleting Resources (DELETE)
-```json
-{
-  "url": "https://api.example.com/users/123",
-  "method": "DELETE"
-}
-```
-
-### With Authentication
-```json
-{
-  "url": "https://api.example.com/protected",
-  "method": "GET",
-  "headers": {
-    "Authorization": "Bearer your-api-token",
-    "X-API-Key": "your-api-key"
-  }
-}
-```
-
-## Examples
-
-**User**: "Get the current Bitcoin price"
-**Action**: Use http-request with:
-```json
-{
-  "url": "https://api.coindesk.com/v1/bpi/currentprice.json",
-  "method": "GET"
-}
-```
-
-**User**: "Post this data to my webhook"
-**Action**: Use http-request with:
-```json
-{
-  "url": "https://webhook.example.com/endpoint",
-  "method": "POST",
-  "body": {"event": "user_action", "data": "..."},
-  "headers": {"Content-Type": "application/json"}
-}
-```
-
-**User**: "Check if example.com is up"
-**Action**: Use http-request with:
-```json
-{
-  "url": "https://example.com",
-  "method": "GET"
-}
-```
-Then check if status is 200.
-
-**User**: "Get weather for New York"
-**Action**: Use http-request with:
-```json
-{
-  "url": "https://api.openweathermap.org/data/2.5/weather?q=New York&appid=YOUR_KEY",
-  "method": "GET"
-}
-```
-
-## Security Guidelines
-
-1. **Never expose API keys** in responses to the user
-2. **Validate URLs** - only request from trusted domains
-3. **Don't make requests** to internal/private networks (localhost, 192.168.x.x, 10.x.x.x)
-4. **Respect rate limits** of external services
-5. **Handle errors gracefully** and inform the user clearly
-6. **Don't store sensitive data** from API responses
-
-## Error Handling
-
-Common HTTP status codes and what they mean:
-
-| Status | Meaning | Action |
-|--------|---------|--------|
-| 200-299 | Success | Process the response data |
-| 400 | Bad Request | Check request parameters |
-| 401 | Unauthorized | Check API key/authentication |
-| 403 | Forbidden | Access denied, may need different permissions |
-| 404 | Not Found | Check URL path |
-| 429 | Too Many Requests | Rate limited, wait before retrying |
-| 500-599 | Server Error | External service issue, try again later |
-
-When an error occurs, inform the user about:
-- What was attempted
-- What went wrong (status code and message)
-- Suggested next steps