sensorium-mcp 2.17.25 → 2.17.27

package/scripts/install-supervisor.ps1

@@ -0,0 +1,67 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Build and install the sensorium-supervisor Go binary.
+.DESCRIPTION
+    Compiles the Go supervisor and places it in ~/.remote-copilot-mcp/bin/.
+    Requires Go 1.22+ installed and on PATH.
+.PARAMETER Force
+    Rebuild even if the binary already exists.
+#>
+param(
+    [switch]$Force
+)
+
+$ErrorActionPreference = "Stop"
+
+$DataDir = Join-Path $env:USERPROFILE ".remote-copilot-mcp"
+$BinDir  = Join-Path $DataDir "bin"
+$Binary  = Join-Path $BinDir "sensorium-supervisor.exe"
+
+# Find the supervisor source directory (relative to this script)
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$SupervisorDir = Join-Path (Split-Path -Parent $ScriptDir) "supervisor"
+
+if (-not (Test-Path (Join-Path $SupervisorDir "go.mod"))) {
+    Write-Error "Cannot find supervisor source at $SupervisorDir"
+    exit 1
+}
+
+# Check if Go is available
+$goExe = Get-Command go -ErrorAction SilentlyContinue
+if (-not $goExe) {
+    Write-Host "Go is not installed. Install from https://go.dev/dl/ (requires Go 1.22+)" -ForegroundColor Red
+    exit 1
+}
+
+# Check version
+$goVersion = (go version) -replace 'go version go', '' -replace ' .*', ''
+Write-Host "Found Go $goVersion"
+
+# Skip build if binary exists and is newer than source (unless -Force)
+if (-not $Force -and (Test-Path $Binary)) {
+    $binaryTime = (Get-Item $Binary).LastWriteTime
+    $sourceFiles = Get-ChildItem $SupervisorDir -Filter "*.go"
+    $newestSource = ($sourceFiles | Sort-Object LastWriteTime -Descending | Select-Object -First 1).LastWriteTime
+    if ($binaryTime -gt $newestSource) {
+        Write-Host "sensorium-supervisor is up to date ($Binary)"
+        exit 0
+    }
+}
+
+# Ensure bin directory exists
+New-Item -ItemType Directory -Path $BinDir -Force | Out-Null
+
+Write-Host "Building sensorium-supervisor..."
+Push-Location $SupervisorDir
+try {
+    go build -o $Binary .
+    if ($LASTEXITCODE -ne 0) {
+        Write-Error "Go build failed"
+        exit 1
+    }
+} finally {
+    Pop-Location
+}
+
+Write-Host "Installed: $Binary" -ForegroundColor Green

package/scripts/install-supervisor.sh

@@ -0,0 +1,43 @@
+#!/bin/sh
+# Build and install the sensorium-supervisor Go binary.
+# Requires Go 1.22+ installed and on PATH.
+set -e
+
+FORCE="${1:-}"
+DATA_DIR="$HOME/.remote-copilot-mcp"
+BIN_DIR="$DATA_DIR/bin"
+BINARY="$BIN_DIR/sensorium-supervisor"
+
+# Find supervisor source relative to this script
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SUPERVISOR_DIR="$(dirname "$SCRIPT_DIR")/supervisor"
+
+if [ ! -f "$SUPERVISOR_DIR/go.mod" ]; then
+    echo "ERROR: Cannot find supervisor source at $SUPERVISOR_DIR" >&2
+    exit 1
+fi
+
+# Check Go is available
+if ! command -v go >/dev/null 2>&1; then
+    echo "ERROR: Go is not installed. Install from https://go.dev/dl/ (requires Go 1.22+)" >&2
+    exit 1
+fi
+
+echo "Found $(go version)"
+
+# Skip if binary is newer than source (unless --force)
+if [ "$FORCE" != "--force" ] && [ -f "$BINARY" ]; then
+    NEWEST_SRC=$(find "$SUPERVISOR_DIR" -name '*.go' -newer "$BINARY" 2>/dev/null | head -1)
+    if [ -z "$NEWEST_SRC" ]; then
+        echo "sensorium-supervisor is up to date ($BINARY)"
+        exit 0
+    fi
+fi
+
+mkdir -p "$BIN_DIR"
+
+echo "Building sensorium-supervisor..."
+cd "$SUPERVISOR_DIR"
+go build -o "$BINARY" .
+
+echo "Installed: $BINARY"

package/scripts/start-supervisor.ps1

@@ -0,0 +1,46 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Launch sensorium-supervisor. Builds automatically if needed.
+.DESCRIPTION
+    Replaces update-watcher.ps1. Builds the Go supervisor if it doesn't exist,
+    then runs it. All environment variables (MCP_HTTP_PORT, TELEGRAM_TOKEN, etc.)
+    are passed through to the supervisor process.
+.PARAMETER Mode
+    Watcher mode: production or development. Maps to WATCHER_MODE env var.
+.PARAMETER Build
+    Force rebuild of the supervisor binary before starting.
+#>
+param(
+    [ValidateSet("production", "development")]
+    [string]$Mode = "production",
+    [switch]$Build
+)
+
+$ErrorActionPreference = "Stop"
+
+$DataDir = Join-Path $env:USERPROFILE ".remote-copilot-mcp"
+$BinDir  = Join-Path $DataDir "bin"
+$Binary  = Join-Path $BinDir "sensorium-supervisor.exe"
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Build if missing or requested
+if ($Build -or -not (Test-Path $Binary)) {
+    $installScript = Join-Path $ScriptDir "install-supervisor.ps1"
+    if ($Build) {
+        & $installScript -Force
+    } else {
+        & $installScript
+    }
+    if ($LASTEXITCODE -ne 0) { exit 1 }
+}
+
+# Set WATCHER_MODE if not already set
+if (-not $env:WATCHER_MODE) {
+    $env:WATCHER_MODE = $Mode
+}
+
+# Launch supervisor
+Write-Host "Starting sensorium-supervisor ($Mode mode)..."
+& $Binary
+exit $LASTEXITCODE

package/scripts/start-supervisor.sh

@@ -0,0 +1,20 @@
+#!/bin/sh
+# Launch sensorium-supervisor. Builds automatically if needed.
+# Replaces update-watcher.ps1 on Unix systems.
+set -e
+
+MODE="${1:-production}"
+DATA_DIR="$HOME/.remote-copilot-mcp"
+BIN_DIR="$DATA_DIR/bin"
+BINARY="$BIN_DIR/sensorium-supervisor"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Build if missing
+if [ ! -f "$BINARY" ]; then
+    "$SCRIPT_DIR/install-supervisor.sh"
+fi
+
+export WATCHER_MODE="${WATCHER_MODE:-$MODE}"
+
+echo "Starting sensorium-supervisor ($WATCHER_MODE mode)..."
+exec "$BINARY"

package/supervisor/config.go

@@ -0,0 +1,140 @@
+package main
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"strconv"
+	"time"
+)
+
+// Config holds all supervisor configuration, sourced from environment variables
+// with sensible defaults matching the TypeScript watcher-service.ts CONFIG object.
+type Config struct {
+	// Watcher
+	Mode              string
+	PollAtHour        int
+	PollInterval      time.Duration
+	GracePeriod       time.Duration
+	MinUptime         time.Duration
+	MCPStartCommand   string
+	DataDir           string
+	MCPHttpPort       int
+	MCPHttpSecret     string
+	TelegramToken     string
+	TelegramChatID    string
+	HealthFailThresh  int
+
+	// Keeper defaults
+	KeeperBaseBackoff        time.Duration
+	KeeperMaxBackoff         time.Duration
+	KeeperHealthCheckInterval time.Duration
+	KeeperMaxRetries         int
+	KeeperCooldown           time.Duration
+	KeeperReadyPollInterval  time.Duration
+	KeeperReadyTimeout       time.Duration
+	FastExitThreshold        time.Duration
+	FastExitMaxCount         int
+	FastExitBaseCooldown     time.Duration
+	FastExitMaxCooldown      time.Duration
+	StuckThreshold           time.Duration
+
+	// Derived paths
+	Paths Paths
+}
+
+// Paths holds all filesystem paths derived from DataDir.
+type Paths struct {
+	MaintenanceFlag string
+	VersionFile     string
+	LastActivity    string
+	ServerPID       string
+	WatcherLock     string
+	WatcherLog      string
+	PIDsDir         string
+	HeartbeatsDir   string
+}
+
+func LoadConfig() Config {
+	dataDir := filepath.Join(homeDir(), ".remote-copilot-mcp")
+
+	mode := envOr("WATCHER_MODE", "development")
+	graceDef := "300"
+	if mode == "development" {
+		graceDef = "10"
+	}
+
+	c := Config{
+		Mode:              mode,
+		PollAtHour:        envInt("WATCHER_POLL_HOUR", 4),
+		PollInterval:      time.Duration(envInt("WATCHER_POLL_INTERVAL", 60)) * time.Second,
+		GracePeriod:       time.Duration(envInt("WATCHER_GRACE_PERIOD", safeAtoi(graceDef))) * time.Second,
+		MinUptime:         600 * time.Second,
+		MCPStartCommand:   envOr("MCP_START_COMMAND", "npx -y sensorium-mcp@latest"),
+		DataDir:           dataDir,
+		MCPHttpPort:       envInt("MCP_HTTP_PORT", 0),
+		MCPHttpSecret:     os.Getenv("MCP_HTTP_SECRET"),
+		TelegramToken:     os.Getenv("TELEGRAM_TOKEN"),
+		TelegramChatID:    os.Getenv("TELEGRAM_CHAT_ID"),
+		HealthFailThresh:  3,
+
+		KeeperBaseBackoff:        5 * time.Second,
+		KeeperMaxBackoff:         5 * time.Minute,
+		KeeperHealthCheckInterval: 2 * time.Minute,
+		KeeperMaxRetries:         5,
+		KeeperCooldown:           5 * time.Minute,
+		KeeperReadyPollInterval:  3 * time.Second,
+		KeeperReadyTimeout:       2 * time.Minute,
+		FastExitThreshold:        60 * time.Second,
+		FastExitMaxCount:         3,
+		FastExitBaseCooldown:     10 * time.Minute,
+		FastExitMaxCooldown:      4 * time.Hour,
+		StuckThreshold:           10 * time.Minute,
+
+		Paths: Paths{
+			MaintenanceFlag: filepath.Join(dataDir, "maintenance.flag"),
+			VersionFile:     filepath.Join(dataDir, "current-version.txt"),
+			LastActivity:    filepath.Join(dataDir, "last-activity.txt"),
+			ServerPID:       filepath.Join(dataDir, "server.pid"),
+			WatcherLock:     filepath.Join(dataDir, "watcher.lock"),
+			WatcherLog:      filepath.Join(dataDir, "watcher.log"),
+			PIDsDir:         filepath.Join(dataDir, "pids"),
+			HeartbeatsDir:   filepath.Join(dataDir, "heartbeats"),
+		},
+	}
+
+	return c
+}
+
+func homeDir() string {
+	h, err := os.UserHomeDir()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "FATAL: cannot determine home directory: %v\n", err)
+		os.Exit(1)
+	}
+	return h
+}
+
+func envOr(key, fallback string) string {
+	if v := os.Getenv(key); v != "" {
+		return v
+	}
+	return fallback
+}
+
+func envInt(key string, fallback int) int {
+	s := os.Getenv(key)
+	if s == "" {
+		return fallback
+	}
+	v, err := strconv.Atoi(s)
+	if err != nil {
+		return fallback
+	}
+	return v
+}
+
+func safeAtoi(s string) int {
+	v, _ := strconv.Atoi(s)
+	return v
+}

package/supervisor/go.mod

@@ -0,0 +1,3 @@
+module github.com/andriyshevchenko/sensorium-supervisor
+
+go 1.22