machinaos 0.0.1

package/docs-MachinaOs/nodes/android.mdx

@@ -0,0 +1,411 @@
+---
+title: Android Nodes
+description: 17 nodes for Android device automation
+---
+
+# Android Nodes
+
+Control and monitor Android devices with 17 specialized nodes.
+
+## Connection Setup
+
+### Android Device Setup
+
+Configure how MachinaOs connects to your device.
+
+<ParamField path="connection_type" type="select" required>
+  Connection method: Local ADB Device or Remote WebSocket
+</ParamField>
+
+**Local ADB:**
+<ParamField path="device_id" type="select">
+  Select from connected devices
+</ParamField>
+
+<ParamField path="auto_forward" type="boolean" default="true">
+  Automatically setup port forwarding
+</ParamField>
+
+<ParamField path="port" type="number" default="8888">
+  Port for ADB forwarding
+</ParamField>
+
+**Remote WebSocket:**
+<ParamField path="websocket_url" type="string">
+  Relay server URL (configured in .env)
+</ParamField>
+
+---
+
+## System Monitoring (4 nodes)
+
+### Battery Monitor
+
+Monitor battery status and health.
+
+**Actions:** get_status
+
+**Output:**
+```json
+{
+  "level": 85,
+  "is_charging": true,
+  "status": "charging",
+  "plugged": "ac",
+  "temperature": 28.5,
+  "health": "good",
+  "technology": "Li-ion"
+}
+```
+
+### Network Monitor
+
+Check network connectivity.
+
+**Actions:** get_status
+
+**Output:**
+```json
+{
+  "is_connected": true,
+  "type": "wifi",
+  "wifi_ssid": "MyNetwork",
+  "is_internet_available": true,
+  "ip_address": "192.168.1.100",
+  "signal_strength": -45
+}
+```
+
+### System Info
+
+Get device information.
+
+**Actions:** get_info
+
+**Output:**
+```json
+{
+  "device_model": "Pixel 7",
+  "manufacturer": "Google",
+  "android_version": "14",
+  "api_level": 34,
+  "total_memory": 8192,
+  "available_memory": 4096,
+  "total_storage": 128000,
+  "available_storage": 64000
+}
+```
+
+### Location
+
+Get GPS location.
+
+**Actions:** get_location
+
+**Output:**
+```json
+{
+  "latitude": 37.7749,
+  "longitude": -122.4194,
+  "accuracy": 10.5,
+  "altitude": 15.2,
+  "provider": "gps",
+  "timestamp": "2024-01-15T10:30:00Z"
+}
+```
+
+---
+
+## App Management (2 nodes)
+
+### App Launcher
+
+Launch applications by package name.
+
+<ParamField path="package_name" type="string" required>
+  App package name (e.g., com.spotify.music)
+</ParamField>
+
+**Output:**
+```json
+{
+  "success": true,
+  "package": "com.spotify.music",
+  "message": "App launched"
+}
+```
+
+**Common Package Names:**
+| App | Package |
+|-----|---------|
+| Chrome | com.android.chrome |
+| YouTube | com.google.android.youtube |
+| Spotify | com.spotify.music |
+| WhatsApp | com.whatsapp |
+| Gmail | com.google.android.gm |
+
+### App List
+
+Get installed applications.
+
+**Output:**
+```json
+{
+  "apps": [
+    {
+      "name": "Chrome",
+      "package": "com.android.chrome",
+      "version": "120.0.6099.230"
+    }
+  ],
+  "count": 150
+}
+```
+
+---
+
+## Automation (6 nodes)
+
+### WiFi Automation
+
+Control WiFi settings.
+
+**Actions:** enable, disable, get_status, scan
+
+**Output (scan):**
+```json
+{
+  "networks": [
+    {
+      "ssid": "MyNetwork",
+      "bssid": "00:11:22:33:44:55",
+      "signal": -45,
+      "security": "WPA2"
+    }
+  ]
+}
+```
+
+### Bluetooth Automation
+
+Control Bluetooth settings.
+
+**Actions:** enable, disable, get_status, get_paired_devices
+
+**Output (paired devices):**
+```json
+{
+  "devices": [
+    {
+      "name": "AirPods Pro",
+      "address": "AA:BB:CC:DD:EE:FF",
+      "type": "audio"
+    }
+  ]
+}
+```
+
+### Audio Automation
+
+Control volume and audio.
+
+**Actions:** get_volume, set_volume, mute, unmute
+
+<ParamField path="volume_level" type="slider">
+  Volume level 0-100 (for set_volume)
+</ParamField>
+
+<ParamField path="stream_type" type="select" default="media">
+  Stream: media, ringtone, notification, alarm
+</ParamField>
+
+### Device State Automation
+
+Control device states.
+
+**Actions:** get_state, set_airplane_mode, set_power_save
+
+<ParamField path="enabled" type="boolean">
+  Enable or disable the feature
+</ParamField>
+
+### Screen Control Automation
+
+Control display settings.
+
+**Actions:** get_brightness, set_brightness, wake_screen, set_timeout
+
+<ParamField path="brightness" type="slider">
+  Brightness level 0-255
+</ParamField>
+
+<ParamField path="auto_brightness" type="boolean">
+  Enable automatic brightness
+</ParamField>
+
+### Airplane Mode Control
+
+Toggle airplane mode.
+
+**Actions:** get_status, enable, disable
+
+---
+
+## Sensors (2 nodes)
+
+### Motion Detection
+
+Access motion sensors.
+
+**Actions:** get_accelerometer, get_gyroscope, detect_shake
+
+**Output (accelerometer):**
+```json
+{
+  "x": 0.15,
+  "y": 9.78,
+  "z": 0.23,
+  "timestamp": "2024-01-15T10:30:00Z"
+}
+```
+
+### Environmental Sensors
+
+Access environmental sensors.
+
+**Actions:** get_light, get_pressure, get_temperature, get_humidity
+
+**Output:**
+```json
+{
+  "light": 350,
+  "pressure": 1013.25,
+  "temperature": 22.5,
+  "humidity": 45
+}
+```
+
+<Info>
+Not all devices have all sensors. Output will indicate unavailable sensors.
+</Info>
+
+---
+
+## Media (2 nodes)
+
+### Camera Control
+
+Control camera functions.
+
+**Actions:** get_info, take_photo
+
+<ParamField path="camera_id" type="select" default="back">
+  Camera to use: back, front
+</ParamField>
+
+**Output (get_info):**
+```json
+{
+  "cameras": [
+    {
+      "id": "0",
+      "facing": "back",
+      "megapixels": 50
+    },
+    {
+      "id": "1",
+      "facing": "front",
+      "megapixels": 12
+    }
+  ]
+}
+```
+
+### Media Control
+
+Control media playback.
+
+**Actions:** play, pause, next, previous, get_volume, set_volume
+
+---
+
+## Example Workflows
+
+### Battery Alert
+
+```
+[Cron (hourly)] --> [Battery Monitor] --> [Python] --> [WhatsApp Send]
+```
+
+**Python:**
+```python
+level = input_data.get("level", 100)
+if level < 20:
+    output = {"alert": True, "msg": f"Battery: {level}%"}
+else:
+    output = {"alert": False}
+```
+
+### WiFi Toggle via Webhook
+
+```
+[Webhook Trigger] --> [WiFi Automation]
+```
+
+**Webhook path:** `/wifi`
+**WiFi Action:** `{{webhookTrigger.body.action}}`
+
+```bash
+curl -X POST http://localhost:3010/webhook/wifi \
+  -d '{"action": "enable"}'
+```
+
+### Morning Routine
+
+```
+[Cron (7:00 AM)] --> [WiFi Enable] --> [App Launcher (News)]
+                          |
+                          v
+                    [Audio: Vol 50%]
+```
+
+---
+
+## Troubleshooting
+
+<Accordion title="Device not detected">
+  ```bash
+  # Check ADB connection
+  adb devices
+
+  # Restart ADB
+  adb kill-server
+  adb start-server
+  ```
+</Accordion>
+
+<Accordion title="Permission denied">
+  Some features require:
+  - USB debugging enabled
+  - Developer options enabled
+  - Specific app permissions
+</Accordion>
+
+<Accordion title="Remote relay issues">
+  - Verify relay URL in .env
+  - Check API key is valid
+  - Ensure companion app is running
+</Accordion>
+
+---
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Android Tutorial" icon="mobile" href="/tutorials/android-automation">
+    Step-by-step guide
+  </Card>
+  <Card title="Webhooks" icon="webhook" href="/nodes/webhooks">
+    Trigger Android actions via HTTP
+  </Card>
+</CardGroup>

package/docs-MachinaOs/nodes/overview.mdx

@@ -0,0 +1,181 @@
+---
+title: Node Overview
+description: Understanding MachinaOs nodes and how they connect
+---
+
+# Node Overview
+
+MachinaOs uses a visual node-based system for building workflows. Each node performs a specific function and passes data to connected nodes.
+
+## Node Categories
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| [AI Models](/nodes/ai-models) | 3 | Chat models from OpenAI, Anthropic, Google |
+| [AI Agents](/nodes/ai-agent) | 2 | Intelligent agents with memory |
+| [WhatsApp](/nodes/whatsapp) | 3 | Messaging automation |
+| [Android](/nodes/android) | 17 | Device control and monitoring |
+| [Webhooks](/nodes/webhooks) | 3 | HTTP requests and webhook handling |
+| [Schedulers](/nodes/schedulers) | 3 | Triggers and timing |
+
+## Node Shapes
+
+Different shapes indicate different node types:
+
+| Shape | Type | Description |
+|-------|------|-------------|
+| Diamond | Trigger | Starts a workflow (no input handle) |
+| Square | Action | Performs operations |
+| Circle | Config | Provides configuration to other nodes |
+
+## Handles
+
+Handles are connection points on nodes:
+
+### Input Handles (Left Side)
+- **Main Input** - Receives data from upstream nodes
+- **Config Inputs** - Diamond shapes for memory, model, etc.
+
+### Output Handles (Right Side)
+- **Main Output** - Sends data to downstream nodes
+
+## Data Flow
+
+Data flows from left to right through connections:
+
+```
+[Trigger] --> [Process] --> [Action] --> [Response]
+```
+
+### Template Variables
+
+Access upstream data using template syntax:
+
+```
+{{nodeName.fieldName}}
+```
+
+**Examples:**
+```
+{{webhookTrigger.body}}           // Webhook request body
+{{openaiChatModel.response}}      // AI model response
+{{batteryMonitor.level}}          // Battery percentage
+{{whatsappReceive.text}}          // Message content
+```
+
+### Nested Fields
+
+Access nested objects with dot notation:
+
+```
+{{whatsappReceive.group_info.sender_name}}
+{{webhookTrigger.body.user.email}}
+```
+
+## Node Configuration
+
+### Opening Parameters
+1. **Click** the node to select it
+2. **Click gear icon** or **double-click** to open parameter panel
+
+### Parameter Types
+
+| Type | Description |
+|------|-------------|
+| Text | String input |
+| Number | Numeric input |
+| Boolean | Toggle on/off |
+| Options | Dropdown selection |
+| Slider | Range selection |
+| Code | Multi-line code editor |
+| JSON | JSON object input |
+
+### Dynamic Options
+
+Some parameters load options from the backend:
+- Device lists (Android)
+- AI models (based on API key)
+- Groups and contacts (WhatsApp)
+
+## Node States
+
+During execution, nodes show their state:
+
+| State | Indicator | Description |
+|-------|-----------|-------------|
+| Idle | Default | Not running |
+| Waiting | Cyan | Trigger waiting for event |
+| Running | Purple glow | Currently executing |
+| Completed | Green | Finished successfully |
+| Error | Red | Failed with error |
+
+## Special Node Types
+
+### Trigger Nodes
+- No input handle
+- Start workflow execution
+- Wait for external events
+
+**Examples:** Webhook Trigger, WhatsApp Receive, Cron Scheduler
+
+### Config Nodes
+- Connect to special config handles (diamonds)
+- Provide settings to parent nodes
+- Don't execute independently
+
+**Examples:** Simple Memory, AI Models
+
+## Renaming Nodes
+
+Give nodes meaningful names:
+1. Press **F2** with node selected
+2. Or **double-click** the node label
+3. Or **right-click** > Rename
+
+## Copying Nodes
+
+1. Select node(s)
+2. Press **Ctrl+C** to copy
+3. Press **Ctrl+V** to paste
+
+## Deleting Nodes
+
+1. Select node(s)
+2. Press **Delete** or **Backspace**
+
+## Best Practices
+
+<Tip>
+Name your nodes descriptively. "Process Order" is better than "AI Agent 1".
+</Tip>
+
+<Tip>
+Test individual nodes with the **Run** button before deploying full workflows.
+</Tip>
+
+<Warning>
+Config nodes (Memory, Models) connect to diamond handles, not main inputs.
+</Warning>
+
+## Node Reference
+
+<CardGroup cols={2}>
+  <Card title="AI Models" icon="brain" href="/nodes/ai-models">
+    OpenAI, Claude, Gemini
+  </Card>
+  <Card title="AI Agents" icon="robot" href="/nodes/ai-agent">
+    Agent with memory and tools
+  </Card>
+  <Card title="WhatsApp" icon="whatsapp" href="/nodes/whatsapp">
+    Send and receive messages
+  </Card>
+  <Card title="Android" icon="mobile" href="/nodes/android">
+    17 device control nodes
+  </Card>
+  <Card title="Webhooks" icon="webhook" href="/nodes/webhooks">
+    HTTP and webhook handling
+  </Card>
+  <Card title="Schedulers" icon="clock" href="/nodes/schedulers">
+    Triggers and timers
+  </Card>
+</CardGroup>