machinaos 0.0.1

package/server/whatsapp-rpc/.dockerignore

@@ -0,0 +1,30 @@
+# Git
+.git
+.gitignore
+
+# Build artifacts
+bin/
+*.exe
+
+# Data (mounted as volume)
+data/
+
+# Node modules
+node_modules/
+
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+
+# IDE
+.vscode/
+.idea/
+
+# Docs
+*.md
+!README.md
+
+# Plans
+.claude/

package/server/whatsapp-rpc/Dockerfile

@@ -0,0 +1,44 @@
+# Build stage
+FROM golang:1.24-alpine AS builder
+
+WORKDIR /app
+
+# Install build dependencies
+RUN apk add --no-cache git
+
+# Copy go mod files
+COPY go.mod go.sum ./
+RUN go mod download
+
+# Copy source code
+COPY src/go/ ./src/go/
+
+# Build binary
+RUN CGO_ENABLED=0 GOOS=linux go build -o whatsapp-rpc-server ./src/go/cmd/server
+
+# Runtime stage
+FROM alpine:latest
+
+WORKDIR /app
+
+# Install ca-certificates for HTTPS
+RUN apk add --no-cache ca-certificates tzdata
+
+# Create data directories
+RUN mkdir -p /app/data/qr /app/configs
+
+# Copy binary from builder
+COPY --from=builder /app/whatsapp-rpc-server .
+
+# Copy config if exists
+COPY configs/config.yaml ./configs/
+
+# Expose WebSocket port
+EXPOSE 9400
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD wget --no-verbose --tries=1 --spider http://localhost:9400/health || exit 1
+
+# Run server
+CMD ["./whatsapp-rpc-server"]

package/server/whatsapp-rpc/Dockerfile.web

@@ -0,0 +1,17 @@
+# Python Web UI
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install dependencies
+COPY web/requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy web app
+COPY web/ ./
+
+# Expose port
+EXPOSE 5000
+
+# Run Flask app
+CMD ["python", "app.py"]

package/server/whatsapp-rpc/README.md

@@ -0,0 +1,139 @@
+# WhatsApp RPC
+
+WebSocket JSON-RPC 2.0 API for WhatsApp.
+
+<img width="1280" height="676" alt="image" src="https://github.com/user-attachments/assets/ddc7324a-8c4d-4557-ac6f-cb091a8ce31f" />
+
+## Architecture
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   Your App      │     │    Web UI       │     │  Python Client  │
+│  (Any Language) │     │   (Flask)       │     │    Library      │
+└────────┬────────┘     └────────┬────────┘     └────────┬────────┘
+         │                       │                       │
+         │      WebSocket        │      HTTP             │
+         │      JSON-RPC 2.0     │      :5000            │
+         │                       │                       │
+         └───────────┬───────────┴───────────────────────┘
+                     │
+                     ▼
+         ┌───────────────────────┐
+         │   Go WebSocket API    │
+         │       :9400           │
+         │  ┌─────────────────┐  │
+         │  │  RPC Handler    │  │
+         │  │  Rate Limiter   │  │
+         │  │  Event Emitter  │  │
+         │  └────────┬────────┘  │
+         └───────────┼───────────┘
+                     │
+                     ▼
+         ┌───────────────────────┐
+         │   WhatsApp Service    │
+         │  ┌─────────────────┐  │
+         │  │   whatsmeow     │  │
+         │  │   (Go Library)  │  │
+         │  └────────┬────────┘  │
+         └───────────┼───────────┘
+                     │
+                     ▼
+         ┌───────────────────────┐
+         │   WhatsApp Servers    │
+         └───────────────────────┘
+
+Data Storage:
+┌─────────────────────────────────┐
+│  data/                          │
+│  ├── whatsapp.db   (SQLite)     │
+│  ├── qr/*.png      (QR codes)   │
+│  └── groups.json   (Group cache)│
+└─────────────────────────────────┘
+```
+
+## Setup
+
+### Native
+```bash
+npm start           # Start API + Web UI
+npm stop            # Stop all
+npm run restart     # Restart all
+npm run status      # Check if running
+npm run api         # Start API only
+npm run web         # Start Web UI only
+npm run build       # Build Go binary
+npm run clean       # Full cleanup (bin, data, node_modules)
+```
+
+All commands auto-install dependencies if missing.
+
+### Docker
+```bash
+docker-compose up -d      # Start
+docker-compose down       # Stop
+docker-compose logs -f    # View logs
+```
+
+## Endpoints
+
+| Port | Service |
+|------|---------|
+| 9400 | WebSocket API - `ws://localhost:9400/ws/rpc` |
+| 5000 | Web UI - `http://localhost:5000` |
+
+## API
+
+Connect via WebSocket and send JSON-RPC 2.0 requests:
+
+```json
+{"jsonrpc": "2.0", "id": 1, "method": "send", "params": {"phone": "1234567890", "type": "text", "message": "Hello"}}
+```
+
+### Methods
+
+| Method | Params | Description |
+|--------|--------|-------------|
+| `status` | - | Connection status |
+| `start` | - | Start WhatsApp |
+| `stop` | - | Stop WhatsApp |
+| `restart` | - | Full reset (logout, delete DB, new QR) |
+| `qr` | - | Get QR code (base64 PNG) |
+| `send` | `phone/group_id`, `type`, `message/media_data` | Send message |
+| `media` | `message_id` | Download received media |
+| `groups` | - | List all groups |
+| `group_info` | `group_id` | Get group details |
+| `contact_check` | `phones[]` | Check if numbers are on WhatsApp |
+
+Full schema: [schema.json](schema.json)
+
+## Events
+
+Server pushes events as JSON-RPC notifications (no `id`):
+
+```json
+{"jsonrpc": "2.0", "method": "event.message_received", "params": {...}}
+```
+
+Events: `connected`, `disconnected`, `qr_code`, `message_received`, `message_sent`
+
+## Data Files
+
+- `data/whatsapp.db` - SQLite database (session, contacts)
+- `data/qr/*.png` - QR code images
+- `data/groups.json` - Auto-generated on connection (indexed group data)
+
+## Structure
+
+```
+src/go/          # Go backend
+src/python/      # Python client library
+web/             # Flask web UI
+scripts/         # CLI tools
+configs/         # YAML config
+```
+
+## Requirements
+
+- Go 1.21+
+- Python 3.8+
+- Node.js 16+

package/server/whatsapp-rpc/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import chalk from 'chalk';
+import { execa } from 'execa';
+import killPort from 'kill-port';
+import { Socket } from 'net';
+import { execSync, spawn } from 'child_process';
+import { existsSync, statSync, unlinkSync, readdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const API_PORT = 9400, WEB_PORT = 5000;
+const BIN = process.platform === 'win32' ? 'whatsapp-rpc.exe' : 'whatsapp-rpc';
+
+const log = (m, c = 'blue') => console.log(chalk[c](m));
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+
+const portUp = port => new Promise(r => {
+  const s = new Socket();
+  s.setTimeout(2000);
+  s.on('connect', () => { s.destroy(); r(true); });
+  s.on('timeout', () => { s.destroy(); r(false); });
+  s.on('error', () => r(false));
+  s.connect(port, '127.0.0.1');
+});
+
+const wait = async (port, ms = 10000) => {
+  const t = Date.now();
+  while (Date.now() - t < ms) { if (await portUp(port)) return true; await sleep(500); }
+  return false;
+};
+
+const kill = async (port, name) => {
+  try { await killPort(port); log(`${name} stopped`, 'green'); }
+  catch { log(`${name} not running`, 'yellow'); }
+};
+
+const py = () => {
+  try { execSync('python --version', { stdio: 'ignore' }); return 'python'; }
+  catch { try { execSync('python3 --version', { stdio: 'ignore' }); return 'python3'; } catch { return null; } }
+};
+
+async function api() {
+  if (await portUp(API_PORT)) { log(`API already on ${API_PORT}`, 'yellow'); return; }
+  const bin = join(__dirname, BIN);
+  if (!existsSync(bin)) { log('Building...', 'yellow'); await build(); }
+  spawn(bin, [], { cwd: __dirname, detached: true, stdio: 'ignore' }).unref();
+  if (await wait(API_PORT)) log(`API: ws://localhost:${API_PORT}/ws/rpc`, 'green');
+  else log('API failed to start', 'red');
+}
+
+async function web() {
+  if (await portUp(WEB_PORT)) { log(`Web already on ${WEB_PORT}`, 'yellow'); return; }
+  const p = py(); if (!p) { log('Python not found', 'red'); return; }
+  if (!await portUp(API_PORT)) log('Warning: API not running', 'yellow');
+  spawn(p, ['app.py'], { cwd: join(__dirname, 'web'), detached: true, stdio: 'ignore' }).unref();
+  if (await wait(WEB_PORT)) log(`Web: http://localhost:${WEB_PORT}`, 'green');
+  else log('Web failed to start', 'red');
+}
+
+async function start() { await api(); await sleep(1000); await web(); }
+async function stop() { await kill(API_PORT, 'API'); await kill(WEB_PORT, 'Web'); }
+
+async function status() {
+  const a = await portUp(API_PORT), w = await portUp(WEB_PORT);
+  log(`API (${API_PORT}): ${a ? 'UP' : 'DOWN'}`, a ? 'green' : 'red');
+  log(`Web (${WEB_PORT}): ${w ? 'UP' : 'DOWN'}`, w ? 'green' : 'red');
+}
+
+async function build() {
+  const bin = join(__dirname, BIN);
+  if (existsSync(bin)) unlinkSync(bin);
+  await execa('go', ['build', '-o', BIN, '.'], { cwd: __dirname, stdio: 'inherit' });
+  log(`Built: ${BIN} (${(statSync(bin).size / 1024 / 1024).toFixed(1)}MB)`, 'green');
+}
+
+async function clean() {
+  const bin = join(__dirname, BIN);
+  if (existsSync(bin)) { unlinkSync(bin); log(`Removed ${BIN}`, 'green'); }
+  readdirSync(__dirname).filter(f => f.startsWith('qr_') && f.endsWith('.png')).forEach(f => {
+    unlinkSync(join(__dirname, f)); log(`Removed ${f}`, 'green');
+  });
+}
+
+program.name('wa').version('1.0.0');
+program.command('start').description('Start all').action(start);
+program.command('stop').description('Stop all').action(stop);
+program.command('restart').description('Restart all').action(async () => { await stop(); await sleep(1000); await start(); });
+program.command('status').description('Status').action(status);
+program.command('api').description('Start API only').action(api);
+program.command('web').description('Start Web only').action(web);
+program.command('build').description('Build binary').action(build);
+program.command('clean').description('Clean artifacts').action(clean);
+program.parse();

package/server/whatsapp-rpc/configs/config.yaml

@@ -0,0 +1,7 @@
+environment: "development"
+log_level: 4
+server:
+  port: 9400
+  host: "0.0.0.0"
+database:
+  path: "data/whatsapp.db"

package/server/whatsapp-rpc/docker-compose.yml

@@ -0,0 +1,35 @@
+services:
+  api:
+    build: .
+    container_name: whatsapp-rpc-api
+    ports:
+      - "9400:9400"
+    volumes:
+      - ./data:/app/data
+      - ./configs:/app/configs
+    environment:
+      - WA_SERVER_PORT=9400
+      - WA_DATABASE_PATH=data/whatsapp.db
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:9400/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+
+  web:
+    build:
+      context: .
+      dockerfile: Dockerfile.web
+    container_name: whatsapp-rpc-web
+    ports:
+      - "5000:5000"
+    environment:
+      - GO_WS_RPC_URL=ws://api:9400/ws/rpc
+    depends_on:
+      api:
+        condition: service_healthy
+    restart: unless-stopped
+
+volumes:
+  data: