machinaos 0.0.1

package/scripts/stop.js

@@ -0,0 +1,325 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform stop script for MachinaOS services.
+ * Works on: Windows, macOS, Linux, WSL, Git Bash
+ *
+ * Uses Node.js native APIs where possible, with platform-specific
+ * fallbacks for process management (no cross-platform alternative exists).
+ */
+import { execSync } from 'child_process';
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+
+// ============================================================================
+// Platform Detection
+// ============================================================================
+const isWindows = process.platform === 'win32';
+const isGitBash = isWindows && (process.env.MSYSTEM || process.env.SHELL?.includes('bash'));
+const isMac = process.platform === 'darwin';
+
+// Git Bash on Windows uses Unix commands
+const useUnixCommands = !isWindows || isGitBash;
+
+function getPlatformName() {
+  if (isGitBash) return 'Git Bash';
+  if (isWindows) return 'Windows';
+  if (isMac) return 'macOS';
+  return 'Linux';
+}
+
+// ============================================================================
+// Utilities
+// ============================================================================
+
+/** Execute command silently, return output or empty string */
+function exec(cmd, options = {}) {
+  try {
+    return execSync(cmd, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: options.timeout || 10000,
+      cwd: ROOT,
+      ...options
+    }).trim();
+  } catch {
+    return '';
+  }
+}
+
+/** Cross-platform sleep using Atomics (efficient, no busy wait) */
+function sleep(ms) {
+  try {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+  } catch {
+    // Fallback for older Node.js
+    const end = Date.now() + ms;
+    while (Date.now() < end) { /* spin */ }
+  }
+}
+
+/** Load config from .env file */
+function loadConfig() {
+  const envPath = existsSync(resolve(ROOT, '.env'))
+    ? resolve(ROOT, '.env')
+    : resolve(ROOT, '.env.template');
+
+  const env = {};
+  if (existsSync(envPath)) {
+    for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
+      const match = line.match(/^([^#=]+)=(.*)$/);
+      if (match) {
+        env[match[1].trim()] = match[2].trim().replace(/^["']|["']$/g, '');
+      }
+    }
+  }
+
+  return {
+    ports: [
+      parseInt(env.VITE_CLIENT_PORT) || 3000,
+      parseInt(env.PYTHON_BACKEND_PORT) || 3010,
+      parseInt(env.WHATSAPP_RPC_PORT) || 9400
+    ],
+    temporalEnabled: env.TEMPORAL_ENABLED?.toLowerCase() === 'true'
+  };
+}
+
+// ============================================================================
+// Process Management (platform-specific - no cross-platform alternative)
+// ============================================================================
+
+/** Get PIDs listening on a port */
+function getPidsOnPort(port) {
+  const pids = new Set();
+
+  if (useUnixCommands) {
+    // lsof (macOS/Linux/Git Bash)
+    const lsofOutput = exec(`lsof -ti:${port} -sTCP:LISTEN 2>/dev/null`);
+    for (const pid of lsofOutput.split('\n')) {
+      if (pid.trim() && /^\d+$/.test(pid.trim())) {
+        pids.add(pid.trim());
+      }
+    }
+    // ss fallback (Linux)
+    if (pids.size === 0 && !isMac && !isGitBash) {
+      const ssOutput = exec(`ss -tlnp 2>/dev/null | grep :${port}`);
+      for (const match of ssOutput.matchAll(/pid=(\d+)/g)) {
+        pids.add(match[1]);
+      }
+    }
+  } else {
+    // netstat (Windows native)
+    const output = exec(`netstat -ano | findstr :${port} | findstr LISTENING`);
+    for (const line of output.split('\n')) {
+      const parts = line.trim().split(/\s+/);
+      const pid = parts[parts.length - 1];
+      if (pid && /^\d+$/.test(pid) && pid !== '0') {
+        pids.add(pid);
+      }
+    }
+  }
+
+  return Array.from(pids);
+}
+
+/** Get child PIDs recursively */
+function getChildPids(parentPid) {
+  const children = new Set();
+
+  if (useUnixCommands) {
+    const output = exec(`pgrep -P ${parentPid} 2>/dev/null`);
+    for (const pid of output.split('\n')) {
+      if (pid.trim() && /^\d+$/.test(pid.trim())) {
+        children.add(pid.trim());
+        for (const grandchild of getChildPids(pid.trim())) {
+          children.add(grandchild);
+        }
+      }
+    }
+  } else {
+    const output = exec(`wmic process where (ParentProcessId=${parentPid}) get ProcessId 2>nul`);
+    for (const line of output.split('\n')) {
+      const pid = line.trim();
+      if (pid && /^\d+$/.test(pid)) {
+        children.add(pid);
+        for (const grandchild of getChildPids(pid)) {
+          children.add(grandchild);
+        }
+      }
+    }
+  }
+
+  return Array.from(children);
+}
+
+/** Check if process is running */
+function isRunning(pid) {
+  if (useUnixCommands) {
+    return exec(`kill -0 ${pid} 2>&1 && echo running`).includes('running');
+  } else {
+    return exec(`tasklist /FI "PID eq ${pid}" 2>nul`).includes(pid);
+  }
+}
+
+/** Kill a single process */
+function killPid(pid) {
+  if (useUnixCommands) {
+    exec(`kill -15 ${pid} 2>/dev/null`);
+    sleep(100);
+    exec(`kill -9 ${pid} 2>/dev/null`);
+  } else {
+    exec(`taskkill /PID ${pid} 2>nul`);
+    exec(`taskkill /PID ${pid} /F 2>nul`);
+  }
+}
+
+/** Kill all processes on a port */
+function killPort(port) {
+  const pids = getPidsOnPort(port);
+  if (pids.length === 0) {
+    return { killed: [], portFree: true };
+  }
+
+  // Collect all PIDs including children
+  const allPids = new Set(pids);
+  for (const pid of pids) {
+    for (const child of getChildPids(pid)) {
+      allPids.add(child);
+    }
+  }
+
+  // Kill all
+  for (const pid of allPids) {
+    killPid(pid);
+  }
+
+  sleep(500);
+
+  // Verify
+  const killed = [];
+  for (const pid of allPids) {
+    if (!isRunning(pid)) {
+      killed.push(pid);
+    }
+  }
+
+  // Retry stubborn ones
+  const stillRunning = Array.from(allPids).filter(pid => isRunning(pid));
+  if (stillRunning.length > 0) {
+    for (const pid of stillRunning) {
+      if (useUnixCommands) {
+        exec(`kill -9 ${pid} 2>/dev/null`);
+      } else {
+        exec(`taskkill /PID ${pid} /F 2>nul`);
+      }
+    }
+    sleep(500);
+    for (const pid of stillRunning) {
+      if (!isRunning(pid)) {
+        killed.push(pid);
+      }
+    }
+  }
+
+  return {
+    killed,
+    portFree: getPidsOnPort(port).length === 0
+  };
+}
+
+/** Kill processes by command pattern */
+function killByPattern(pattern, debug = false) {
+  const killed = [];
+
+  if (useUnixCommands) {
+    const output = exec(`pgrep -f "${pattern}" 2>/dev/null`);
+    if (debug && output) console.log(`  [DEBUG] pgrep output: ${output}`);
+    for (const pid of output.split('\n')) {
+      if (pid.trim() && /^\d+$/.test(pid.trim())) {
+        exec(`kill -9 ${pid.trim()} 2>/dev/null`);
+        killed.push(pid.trim());
+      }
+    }
+  } else {
+    // Use tasklist with image name filter first for Python processes
+    if (pattern.includes('uvicorn') || pattern.includes('python')) {
+      const pythonPids = exec(`wmic process where "name='python.exe'" get ProcessId,CommandLine 2>nul`);
+      if (debug && pythonPids) console.log(`  [DEBUG] Python processes:\n${pythonPids}`);
+
+      for (const line of pythonPids.split('\n')) {
+        if (line.toLowerCase().includes(pattern.toLowerCase().replace('.*', ''))) {
+          const pidMatch = line.match(/(\d+)\s*$/);
+          if (pidMatch) {
+            const pid = pidMatch[1];
+            exec(`taskkill /PID ${pid} /F 2>nul`);
+            killed.push(pid);
+          }
+        }
+      }
+    }
+
+    // Also try the original pattern match
+    const output = exec(`wmic process where "CommandLine like '%${pattern.replace('.*', '%')}%'" get ProcessId 2>nul`);
+    if (debug && output) console.log(`  [DEBUG] wmic pattern output: ${output}`);
+    for (const line of output.split('\n')) {
+      const pid = line.trim();
+      if (pid && /^\d+$/.test(pid) && !killed.includes(pid)) {
+        exec(`taskkill /PID ${pid} /F 2>nul`);
+        killed.push(pid);
+      }
+    }
+  }
+
+  return killed;
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+const config = loadConfig();
+
+console.log('Stopping MachinaOS services...\n');
+console.log(`Platform: ${getPlatformName()}`);
+console.log(`Ports: ${config.ports.join(', ')}`);
+console.log(`Temporal: ${config.temporalEnabled ? 'enabled' : 'disabled'}\n`);
+
+let allStopped = true;
+
+// Stop services on ports
+for (const port of config.ports) {
+  const result = killPort(port);
+  const status = result.portFree ? '[OK]' : '[!!]';
+  const message = result.portFree
+    ? (result.killed.length > 0 ? `Killed ${result.killed.length} process(es)` : 'Free')
+    : 'Warning: Port still in use';
+
+  console.log(`${status} Port ${port}: ${message}`);
+  if (result.killed.length > 0) {
+    console.log(`    PIDs: ${result.killed.join(', ')}`);
+  }
+  if (!result.portFree) {
+    allStopped = false;
+  }
+}
+
+// Kill Temporal workers if enabled (must include project path)
+if (config.temporalEnabled) {
+  const temporalPids = killByPattern(`${ROOT}.*temporal`);
+  if (temporalPids.length > 0) {
+    console.log(`[OK] Temporal: Killed ${temporalPids.length} process(es)`);
+    console.log(`    PIDs: ${temporalPids.join(', ')}`);
+  }
+}
+
+console.log('');
+if (allStopped) {
+  console.log('All services stopped.');
+} else {
+  console.log('Warning: Some ports may still be in use.');
+  console.log('Try running the script again or manually kill the processes.');
+  process.exit(1);
+}

package/server/.dockerignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.env
+.env.*
+!.env.template
+venv/
+ENV/
+.venv/
+.pytest_cache/
+.mypy_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Data (will be mounted as volume)
+data/
+*.db
+*.sqlite
+
+# Logs
+*.log
+logs/
+
+# Git
+.git/
+.gitignore
+
+# Documentation
+*.md
+!README.md
+
+# Tests
+tests/
+test_*.py
+
+# WhatsApp RPC (separate build)
+whatsapp-rpc/

package/server/Dockerfile

@@ -0,0 +1,45 @@
+# Python FastAPI Backend
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Install aiohttp for WebSocket client (Android relay)
+RUN pip install --no-cache-dir aiohttp>=3.9.0
+
+# Copy application code
+COPY . .
+
+# Create data directory for SQLite database
+RUN mkdir -p /app/data
+
+# Compile Python files to optimized bytecode for faster imports
+# Keep .py files since Python imports require them or __pycache__/*.pyc
+# -O: optimize (remove assert statements)
+# -q: quiet mode
+# -f: force rebuild
+RUN python -O -m compileall -q -f .
+
+# Default port (overridden by environment)
+ENV PORT=3010
+
+# Expose default port (actual port set via environment)
+EXPOSE 3010
+
+# Health check using shell for variable expansion
+HEALTHCHECK --interval=30s --timeout=10s --start-period=30s --retries=3 \
+    CMD sh -c "curl -f http://localhost:\${PORT}/health || exit 1"
+
+# Run the application
+CMD ["python", "-m", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "3010"]

package/server/constants.py

@@ -0,0 +1,249 @@
+"""Centralized constants for node types and categories.
+
+This module provides a single source of truth for all node type definitions,
+eliminating duplicate string arrays across the codebase.
+"""
+
+from typing import FrozenSet
+
+# =============================================================================
+# AI NODE TYPES
+# =============================================================================
+
+AI_CHAT_MODEL_TYPES: FrozenSet[str] = frozenset([
+    'openaiChatModel',
+    'anthropicChatModel',
+    'geminiChatModel',
+    'openrouterChatModel',
+    'groqChatModel',
+    'cerebrasChatModel',
+])
+
+AI_AGENT_TYPES: FrozenSet[str] = frozenset([
+    'aiAgent',
+    'chatAgent',
+])
+
+AI_MEMORY_TYPES: FrozenSet[str] = frozenset([
+    'simpleMemory',
+])
+
+# Tool node types (connect to AI Agent's input-tools handle)
+AI_TOOL_TYPES: FrozenSet[str] = frozenset([
+    'calculatorTool',
+    'currentTimeTool',
+    'webSearchTool',
+    'androidTool',
+])
+
+# Skill node types (connect to Chat Agent's input-skill handle)
+# Skills provide SKILL.md context/instructions, not executed as workflow nodes
+SKILL_NODE_TYPES: FrozenSet[str] = frozenset([
+    'assistantPersonality',
+    'whatsappSkill',
+    'memorySkill',
+    'mapsSkill',
+    'httpSkill',
+    'schedulerSkill',
+    'androidSkill',
+    'codeSkill',
+    'customSkill',
+])
+
+# Toolkit node types (aggregate sub-nodes, n8n Sub-Node pattern)
+# Sub-nodes connected to toolkits should not execute independently -
+# they only execute when called via the toolkit's tool interface
+TOOLKIT_NODE_TYPES: FrozenSet[str] = frozenset([
+    'androidTool',  # Aggregates Android service nodes (batteryMonitor, location, etc.)
+])
+
+# All AI-related node types (for API key injection)
+AI_MODEL_TYPES: FrozenSet[str] = AI_AGENT_TYPES | AI_CHAT_MODEL_TYPES
+
+# =============================================================================
+# CONFIG NODE TYPES (excluded from workflow execution)
+# =============================================================================
+
+# Config nodes provide configuration to other nodes via special handles
+# (input-memory, input-tools, input-model, input-skill).
+# They don't execute independently - they're used by their parent nodes.
+CONFIG_NODE_TYPES: FrozenSet[str] = (
+    AI_MEMORY_TYPES |    # Memory nodes (connect to input-memory)
+    AI_TOOL_TYPES |      # Tool nodes (connect to AI Agent's input-tools)
+    AI_CHAT_MODEL_TYPES |  # Model config nodes (connect to input-model)
+    SKILL_NODE_TYPES     # Skill nodes (connect to Chat Agent's input-skill)
+)
+
+# =============================================================================
+# GOOGLE MAPS NODE TYPES
+# =============================================================================
+
+GOOGLE_MAPS_TYPES: FrozenSet[str] = frozenset([
+    'createMap',
+    'addLocations',
+    'showNearbyPlaces',
+])
+
+# =============================================================================
+# ANDROID NODE TYPES
+# =============================================================================
+
+# System monitoring nodes
+ANDROID_MONITORING_TYPES: FrozenSet[str] = frozenset([
+    'batteryMonitor',
+    'networkMonitor',
+    'systemInfo',
+    'location',
+])
+
+# App management nodes
+ANDROID_APP_TYPES: FrozenSet[str] = frozenset([
+    'appLauncher',
+    'appList',
+])
+
+# Device automation nodes
+ANDROID_AUTOMATION_TYPES: FrozenSet[str] = frozenset([
+    'wifiAutomation',
+    'bluetoothAutomation',
+    'audioAutomation',
+    'deviceStateAutomation',
+    'screenControlAutomation',
+    'airplaneModeControl',
+])
+
+# Sensor nodes
+ANDROID_SENSOR_TYPES: FrozenSet[str] = frozenset([
+    'motionDetection',
+    'environmentalSensors',
+])
+
+# Media nodes
+ANDROID_MEDIA_TYPES: FrozenSet[str] = frozenset([
+    'cameraControl',
+    'mediaControl',
+])
+
+# All Android service node types (combined)
+ANDROID_SERVICE_NODE_TYPES: FrozenSet[str] = (
+    ANDROID_MONITORING_TYPES |
+    ANDROID_APP_TYPES |
+    ANDROID_AUTOMATION_TYPES |
+    ANDROID_SENSOR_TYPES |
+    ANDROID_MEDIA_TYPES
+)
+
+# Android device setup (separate from services)
+ANDROID_SETUP_TYPES: FrozenSet[str] = frozenset([
+    'androidDeviceSetup',
+])
+
+# =============================================================================
+# WHATSAPP NODE TYPES
+# =============================================================================
+
+WHATSAPP_TYPES: FrozenSet[str] = frozenset([
+    'whatsappSend',
+    'whatsappConnect',
+    'whatsappReceive',
+])
+
+# =============================================================================
+# CHAT NODE TYPES
+# =============================================================================
+
+CHAT_TYPES: FrozenSet[str] = frozenset([
+    'chatSend',
+    'chatHistory',
+])
+
+# =============================================================================
+# UTILITY NODE TYPES
+# =============================================================================
+
+CODE_EXECUTOR_TYPES: FrozenSet[str] = frozenset([
+    'pythonExecutor',
+    'javascriptExecutor',
+])
+
+HTTP_TYPES: FrozenSet[str] = frozenset([
+    'httpRequest',
+    'webhookResponse',
+])
+
+TEXT_TYPES: FrozenSet[str] = frozenset([
+    'textGenerator',
+    'fileHandler',
+])
+
+# =============================================================================
+# WORKFLOW CONTROL NODE TYPES
+# =============================================================================
+
+WORKFLOW_CONTROL_TYPES: FrozenSet[str] = frozenset([
+    'start',
+    'cronScheduler',
+])
+
+# =============================================================================
+# TRIGGER NODE TYPES (handled by event_waiter)
+# =============================================================================
+
+# Event-driven triggers that wait for external events
+EVENT_TRIGGER_TYPES: FrozenSet[str] = frozenset([
+    'webhookTrigger',
+    'whatsappReceive',
+    'workflowTrigger',
+    'chatTrigger',
+])
+
+# Legacy alias for backwards compatibility
+TRIGGER_TYPES: FrozenSet[str] = EVENT_TRIGGER_TYPES
+
+# =============================================================================
+# ALL TRIGGER NODE TYPES (starting points for workflow graphs)
+# =============================================================================
+
+# Combined set of all trigger node types that can start a workflow
+# These nodes have no input handles and serve as entry points
+WORKFLOW_TRIGGER_TYPES: FrozenSet[str] = frozenset([
+    # Manual start
+    'start',
+    # Scheduled triggers
+    'cronScheduler',
+    # Event-driven triggers
+    'webhookTrigger',
+    'whatsappReceive',
+    'workflowTrigger',
+    'chatTrigger',
+])
+
+# =============================================================================
+# AI PROVIDER DETECTION
+# =============================================================================
+
+def detect_ai_provider(node_type: str, parameters: dict = None) -> str:
+    """Detect AI provider from node type or parameters.
+
+    Args:
+        node_type: The node type string
+        parameters: Optional parameters dict (used for aiAgent/chatAgent)
+
+    Returns:
+        Provider string: 'openai', 'anthropic', 'gemini', 'openrouter', 'groq', or 'cerebras'
+    """
+    # AI Agent types get provider from parameters
+    if node_type in AI_AGENT_TYPES:
+        return (parameters or {}).get('provider', 'openai')
+    elif 'cerebras' in node_type.lower():
+        return 'cerebras'
+    elif 'groq' in node_type.lower():
+        return 'groq'
+    elif 'openrouter' in node_type.lower():
+        return 'openrouter'
+    elif 'anthropic' in node_type.lower():
+        return 'anthropic'
+    elif 'gemini' in node_type.lower():
+        return 'gemini'
+    else:
+        return 'openai'

package/server/core/__init__.py

@@ -0,0 +1 @@
+# Core framework components