machinaos 0.0.12 → 0.0.13

package/server/skills/android_agent/app-launcher-skill/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: app-launcher-skill
+description: Launch Android applications by package name. Open any installed app programmatically.
+allowed-tools: app_launcher
+metadata:
+  author: machina
+  version: "1.0"
+  category: android
+  icon: "🚀"
+  color: "#8B5CF6"
+---
+
+# App Launcher Tool
+
+Launch applications on Android device.
+
+## How It Works
+
+This skill provides instructions for the **App Launcher** tool node. Connect the **App Launcher** node to Zeenie's `input-tools` handle to enable app launching.
+
+## app_launcher Tool
+
+Launch an installed application by package name.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| action | string | Yes | `"launch"` |
+| parameters | object | Yes | Contains `package_name` |
+
+### Parameters
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| package_name | string | Yes | Android package name of the app |
+
+### Example
+
+**Launch an app:**
+```json
+{
+  "action": "launch",
+  "parameters": {
+    "package_name": "com.whatsapp"
+  }
+}
+```
+
+### Common Package Names
+
+| App | Package Name |
+|-----|--------------|
+| WhatsApp | `com.whatsapp` |
+| Chrome | `com.android.chrome` |
+| Gmail | `com.google.android.gm` |
+| YouTube | `com.google.android.youtube` |
+| Maps | `com.google.android.apps.maps` |
+| Camera | `com.android.camera2` |
+| Phone | `com.android.dialer` |
+| Messages | `com.google.android.apps.messaging` |
+| Settings | `com.android.settings` |
+| Play Store | `com.android.vending` |
+| Spotify | `com.spotify.music` |
+| Netflix | `com.netflix.mediaclient` |
+| Twitter/X | `com.twitter.android` |
+| Instagram | `com.instagram.android` |
+| Telegram | `org.telegram.messenger` |
+
+### Response Format
+
+**Success:**
+```json
+{
+  "success": true,
+  "service": "app_launcher",
+  "action": "launch",
+  "data": {
+    "message": "App launched successfully",
+    "package_name": "com.whatsapp"
+  }
+}
+```
+
+**Error:**
+```json
+{
+  "error": "App not installed: com.example.notinstalled",
+  "service": "app_launcher",
+  "action": "launch"
+}
+```
+
+## Use Cases
+
+| Use Case | Description |
+|----------|-------------|
+| Quick launch | Open apps on command |
+| Automation | Start apps as part of workflow |
+| Shortcuts | Voice-controlled app opening |
+| Workflows | Chain app launches with other actions |
+
+## Common Workflows
+
+### Open app and send message
+
+1. Launch WhatsApp
+2. User manually selects contact
+3. (Alternative: use whatsapp_send for automated messaging)
+
+### Daily routine
+
+1. Launch news app in morning
+2. Launch email app
+3. Launch calendar
+
+## Finding Package Names
+
+To find an app's package name:
+
+1. Use the **App List** tool to list installed apps
+2. Look for the app name in the list
+3. Use the returned package_name
+
+### Example workflow:
+
+```
+1. app_list.status -> get list of apps
+2. Find desired app in results
+3. app_launcher.launch with package_name
+```
+
+## Setup Requirements
+
+1. Connect the **App Launcher** node to Zeenie's `input-tools` handle
+2. Android device must be paired
+3. App must be installed on the device

package/server/skills/android_agent/app-list-skill/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: app-list-skill
+description: Get list of installed Android applications with package names, versions, and metadata.
+allowed-tools: app_list
+metadata:
+  author: machina
+  version: "1.0"
+  category: android
+  icon: "📱"
+  color: "#06B6D4"
+---
+
+# App List Tool
+
+Get list of installed applications on Android device.
+
+## How It Works
+
+This skill provides instructions for the **App List** tool node. Connect the **App List** node to Zeenie's `input-tools` handle to enable app listing.
+
+## app_list Tool
+
+Get list of installed applications.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| action | string | Yes | `"status"` - Get installed apps |
+
+### Example
+
+**Get installed apps:**
+```json
+{
+  "action": "status"
+}
+```
+
+### Response Format
+
+```json
+{
+  "success": true,
+  "service": "app_list",
+  "action": "status",
+  "data": {
+    "apps": [
+      {
+        "name": "WhatsApp",
+        "package_name": "com.whatsapp",
+        "version": "2.24.1.5",
+        "version_code": 2241005,
+        "system_app": false,
+        "enabled": true
+      },
+      {
+        "name": "Chrome",
+        "package_name": "com.android.chrome",
+        "version": "121.0.6167.101",
+        "version_code": 616710100,
+        "system_app": false,
+        "enabled": true
+      },
+      {
+        "name": "Settings",
+        "package_name": "com.android.settings",
+        "version": "14",
+        "version_code": 34,
+        "system_app": true,
+        "enabled": true
+      }
+    ],
+    "total_apps": 85,
+    "user_apps": 42,
+    "system_apps": 43
+  }
+}
+```
+
+### Response Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| name | string | Display name of the app |
+| package_name | string | Android package identifier |
+| version | string | Version string |
+| version_code | int | Version code number |
+| system_app | boolean | True if pre-installed system app |
+| enabled | boolean | True if app is enabled |
+
+### Summary Fields
+
+| Field | Description |
+|-------|-------------|
+| total_apps | Total number of apps |
+| user_apps | User-installed apps count |
+| system_apps | Pre-installed system apps count |
+
+## Use Cases
+
+| Use Case | Description |
+|----------|-------------|
+| Find apps | Discover what's installed |
+| Get package names | Find package name for app_launcher |
+| Version check | Verify app versions |
+| Inventory | Audit installed applications |
+
+## Common Workflows
+
+### Find and launch app
+
+1. Get app list with `app_list.status`
+2. Search for desired app by name
+3. Use package_name with `app_launcher.launch`
+
+### Check if app is installed
+
+1. Get app list
+2. Search for specific package_name
+3. Report if found or not
+
+### App version audit
+
+1. Get app list
+2. Check versions against known values
+3. Report outdated apps
+
+## Filtering Results
+
+The tool returns all apps. To find specific apps:
+
+1. Get full list
+2. Filter by name or package_name
+3. Check system_app to separate user/system apps
+
+### Example: Find messaging apps
+
+```
+1. Get app list
+2. Filter where name contains "message" or "chat"
+3. Return matching apps
+```
+
+## Setup Requirements
+
+1. Connect the **App List** node to Zeenie's `input-tools` handle
+2. Android device must be paired

package/server/skills/android_agent/audio-skill/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: audio-skill
+description: Control Android audio - get/set volume, mute/unmute for media, ringtone, notification, and call volumes.
+allowed-tools: audio_automation
+metadata:
+  author: machina
+  version: "1.0"
+  category: android
+  icon: "🔊"
+  color: "#F97316"
+---
+
+# Audio Automation Tool
+
+Control audio and volume on Android device.
+
+## How It Works
+
+This skill provides instructions for the **Audio Automation** tool node. Connect the **Audio Automation** node to Zeenie's `input-tools` handle to enable audio control.
+
+## audio_automation Tool
+
+Control audio settings and volume levels.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| action | string | Yes | Action to perform (see below) |
+| parameters | object | No | Additional parameters for set actions |
+
+### Actions
+
+| Action | Description |
+|--------|-------------|
+| `status` | Get current volume levels and audio state |
+| `set_volume` | Set volume for a stream |
+| `mute` | Mute audio |
+| `unmute` | Unmute audio |
+
+### Volume Streams
+
+| Stream | Description |
+|--------|-------------|
+| `media` | Music, videos, games |
+| `ring` | Ringtone volume |
+| `notification` | Notification sounds |
+| `alarm` | Alarm volume |
+| `voice_call` | Call volume |
+| `system` | System sounds (clicks, etc.) |
+
+### Examples
+
+**Get audio status:**
+```json
+{
+  "action": "status"
+}
+```
+
+**Set media volume:**
+```json
+{
+  "action": "set_volume",
+  "parameters": {
+    "stream": "media",
+    "level": 50
+  }
+}
+```
+
+**Mute all audio:**
+```json
+{
+  "action": "mute"
+}
+```
+
+**Unmute:**
+```json
+{
+  "action": "unmute"
+}
+```
+
+### Response Formats
+
+**Status response:**
+```json
+{
+  "success": true,
+  "service": "audio_automation",
+  "action": "status",
+  "data": {
+    "media_volume": 75,
+    "ring_volume": 100,
+    "notification_volume": 80,
+    "alarm_volume": 100,
+    "voice_call_volume": 50,
+    "system_volume": 50,
+    "muted": false,
+    "ringer_mode": "normal"
+  }
+}
+```
+
+**Set volume response:**
+```json
+{
+  "success": true,
+  "service": "audio_automation",
+  "action": "set_volume",
+  "data": {
+    "stream": "media",
+    "previous_level": 100,
+    "new_level": 50
+  }
+}
+```
+
+### Ringer Modes
+
+| Mode | Description |
+|------|-------------|
+| `normal` | All sounds enabled |
+| `vibrate` | Vibrate only |
+| `silent` | No sounds or vibration |
+
+## Use Cases
+
+| Use Case | Action | Description |
+|----------|--------|-------------|
+| Check volume | status | Get current levels |
+| Lower volume | set_volume | Reduce for quiet time |
+| Silent mode | mute | Mute all audio |
+| Restore sound | unmute | Re-enable audio |
+| Night mode | set_volume | Lower ring/notification |
+
+## Common Workflows
+
+### Meeting mode
+
+1. Mute device
+2. Attend meeting
+3. Unmute when done
+
+### Night routine
+
+1. Set ring volume to 20
+2. Set notification volume to 0
+3. Keep alarm at 100
+
+### Media playback
+
+1. Check current media volume
+2. Set to desired level
+3. Play media
+
+## Volume Level Range
+
+- All volumes are 0-100 (percentage)
+- 0 = muted/off
+- 100 = maximum
+
+## Setup Requirements
+
+1. Connect the **Audio Automation** node to Zeenie's `input-tools` handle
+2. Android device must be paired
+3. Volume control permission required

package/server/skills/android_agent/battery-skill/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: battery-skill
+description: Monitor Android device battery status, level, charging state, temperature, and health.
+allowed-tools: battery_monitor
+metadata:
+  author: machina
+  version: "1.0"
+  category: android
+  icon: "🔋"
+  color: "#22C55E"
+---
+
+# Battery Monitor Tool
+
+Monitor Android device battery status and information.
+
+## How It Works
+
+This skill provides instructions for the **Battery Monitor** tool node. Connect the **Battery Monitor** node to Zeenie's `input-tools` handle to enable battery monitoring.
+
+## battery Tool
+
+Get battery status and information from the Android device.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| action | string | Yes | `"status"` - Get current battery information |
+
+### Actions
+
+| Action | Description |
+|--------|-------------|
+| `status` | Get current battery level, charging state, health, temperature |
+
+### Example
+
+**Get battery status:**
+```json
+{
+  "action": "status"
+}
+```
+
+### Response Format
+
+```json
+{
+  "success": true,
+  "service": "battery",
+  "action": "status",
+  "data": {
+    "level": 85,
+    "status": "charging",
+    "health": "good",
+    "temperature": 28.5,
+    "voltage": 4200,
+    "plugged": "ac",
+    "technology": "Li-ion"
+  }
+}
+```
+
+### Response Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| level | int | Battery percentage (0-100) |
+| status | string | `"charging"`, `"discharging"`, `"full"`, `"not_charging"` |
+| health | string | `"good"`, `"overheat"`, `"dead"`, `"cold"` |
+| temperature | float | Temperature in Celsius |
+| voltage | int | Voltage in millivolts |
+| plugged | string | `"ac"`, `"usb"`, `"wireless"`, `"none"` |
+| technology | string | Battery technology (e.g., "Li-ion") |
+
+### Error Response
+
+```json
+{
+  "error": "Failed to get battery status",
+  "service": "battery",
+  "action": "status"
+}
+```
+
+## Use Cases
+
+| Use Case | Description |
+|----------|-------------|
+| Low battery alert | Trigger actions when battery is low |
+| Charging monitor | Detect when device starts/stops charging |
+| Health check | Monitor battery health over time |
+| Temperature warning | Alert on overheating |
+
+## Common Workflows
+
+### Low battery notification
+
+1. Check battery status
+2. If level < 20%, send notification
+3. Optionally enable power saving
+
+### Charging complete alert
+
+1. Periodically check battery status
+2. When status = "full", send notification
+3. Optionally suggest unplugging
+
+## Setup Requirements
+
+1. Connect the **Battery Monitor** node to Zeenie's `input-tools` handle
+2. Android device must be paired (green status indicator)
+3. Battery monitoring permission required on device

package/server/skills/android_agent/bluetooth-skill/SKILL.md

@@ -0,0 +1,151 @@
+---
+name: bluetooth-skill
+description: Control Android Bluetooth - enable, disable, get status, and list paired devices.
+allowed-tools: bluetooth_automation
+metadata:
+  author: machina
+  version: "1.0"
+  category: android
+  icon: "📱"
+  color: "#0EA5E9"
+---
+
+# Bluetooth Automation Tool
+
+Control Bluetooth on Android devices.
+
+## How It Works
+
+This skill provides instructions for the **Bluetooth Automation** tool node. Connect the **Bluetooth Automation** node to Zeenie's `input-tools` handle to enable Bluetooth control.
+
+## bluetooth_automation Tool
+
+Control Bluetooth settings and get device information.
+
+### Schema Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| action | string | Yes | Action to perform (see below) |
+
+### Actions
+
+| Action | Description |
+|--------|-------------|
+| `status` | Get Bluetooth status and paired devices |
+| `enable` | Turn Bluetooth on |
+| `disable` | Turn Bluetooth off |
+
+### Examples
+
+**Get Bluetooth status:**
+```json
+{
+  "action": "status"
+}
+```
+
+**Enable Bluetooth:**
+```json
+{
+  "action": "enable"
+}
+```
+
+**Disable Bluetooth:**
+```json
+{
+  "action": "disable"
+}
+```
+
+### Response Formats
+
+**Status response:**
+```json
+{
+  "success": true,
+  "service": "bluetooth_automation",
+  "action": "status",
+  "data": {
+    "enabled": true,
+    "discovering": false,
+    "name": "My Phone",
+    "address": "AA:BB:CC:DD:EE:FF",
+    "paired_devices": [
+      {
+        "name": "AirPods Pro",
+        "address": "11:22:33:44:55:66",
+        "type": "audio",
+        "bonded": true
+      },
+      {
+        "name": "Car Stereo",
+        "address": "77:88:99:AA:BB:CC",
+        "type": "audio",
+        "bonded": true
+      }
+    ]
+  }
+}
+```
+
+**Enable/Disable response:**
+```json
+{
+  "success": true,
+  "service": "bluetooth_automation",
+  "action": "enable",
+  "data": {
+    "message": "Bluetooth enabled successfully"
+  }
+}
+```
+
+### Response Fields
+
+| Field | Description |
+|-------|-------------|
+| enabled | Bluetooth radio is on |
+| discovering | Scanning for new devices |
+| name | Device Bluetooth name |
+| address | Device Bluetooth MAC address |
+| paired_devices | List of bonded devices |
+
+### Paired Device Fields
+
+| Field | Description |
+|-------|-------------|
+| name | Device name |
+| address | Device MAC address |
+| type | Device type (audio, computer, phone, etc.) |
+| bonded | Currently paired |
+
+## Use Cases
+
+| Use Case | Action | Description |
+|----------|--------|-------------|
+| Check Bluetooth | status | See if BT is on and paired devices |
+| Toggle Bluetooth | enable/disable | Control BT radio |
+| List devices | status | Get paired device list |
+| Battery saving | disable | Turn off when not needed |
+
+## Common Workflows
+
+### Connect to car
+
+1. Check Bluetooth status
+2. If not enabled, enable it
+3. Car should auto-connect if paired
+
+### Battery saving mode
+
+1. Check Bluetooth status
+2. If no audio playing and no connected devices
+3. Disable Bluetooth to save battery
+
+## Setup Requirements
+
+1. Connect the **Bluetooth Automation** node to Zeenie's `input-tools` handle
+2. Android device must be paired
+3. Bluetooth permission required on device