machinaos 0.0.1 → 0.0.6

package/server/whatsapp-rpc/.dockerignore

@@ -1,30 +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/
+# 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

@@ -1,44 +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"]
+# 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

@@ -1,17 +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"]
+# 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

@@ -1,139 +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+
+# 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

@@ -1,95 +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();
+#!/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();