agent-control-plane 0.6.0 → 0.7.1

package/README.md

@@ -1,4 +1,4 @@
-# agent-control-plane
+# agent-control-plane (ACP) v0.7.0
 
 <p>
   <a href="https://github.com/ducminhnguyen0319/agent-control-plane/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/ducminhnguyen0319/agent-control-plane/actions/workflows/ci.yml/badge.svg?branch=main"></a>
@@ -7,11 +7,21 @@
   <a href="./LICENSE"><img alt="license" src="https://img.shields.io/npm/l/agent-control-plane?style=flat-square"></a>
   <a href="https://github.com/sponsors/ducminhnguyen0319"><img alt="GitHub Sponsors" src="https://img.shields.io/badge/sponsor-GitHub%20Sponsors-ea4aaa?style=flat-square&logo=githubsponsors&logoColor=white"></a>
   <a href="https://socket.dev/npm/package/agent-control-plane"><img alt="Socket" src="https://img.shields.io/badge/Socket-79-f5a623?style=flat-square"></a>
+  <a href="./ROADMAP.md"><img alt="Roadmap Complete" src="https://img.shields.io/badge/ROADMAP-v0.7.0-success?style=flat-square"></a>
+  <a href="./CHANGELOG.md"><img alt="Changelog" src="https://img.shields.io/badge/CHANGELOG-v0.7.0-blue?style=flat-square"></a>
 </p>
 
-`agent-control-plane` (ACP) keeps your coding agents running reliably without
-you having to stare at them all day.
+**agent-control-plane (ACP)** keeps your coding agents running reliably without you having to stare at them all day.
 
+## ✅ ROADMAP UPDATE (v0.7.0) - New Features!
+
+- **Real-time Dashboard**: WebSocket updates (no more 5s polling!)
+- **Hardened Adapters**: All 6 backends now production-ready
+- **Native Windows Support**: Run as Windows Service (NSSM/sc.exe/PowerShell)
+- **Standardized Capabilities**: Worker capability detection across all backends
+- **Provider Failover**: Auto-switch when backend is rate-limited/degraded
+
+## ✅ ROADMAP COMPLETE (v0.6.0) - All 5 Sections Delivered!
 **✅ ROADMAP COMPLETE (v0.6.0)** - All planned features delivered!
 
 It is the operator layer for coding agents that need to keep running after the
@@ -140,12 +150,35 @@ familiar:
 - Your local machine should behave like a reliable operator box, not a pile of
   shell history that breaks after a reboot.
 
+## Screenshots
+
+### Light Mode
+![ACP Dashboard - Light Mode](docs/screenshots/dashboard-main.png)
+
+### Dark Mode  
+![ACP Dashboard - Dark Mode](docs/screenshots/dashboard-dark.png)
+
 ## Roadmap
 
 ACP is moving toward a true multi-backend control plane. The goal is one runtime
-and one dashboard for many coding-agent backends, across macOS, Linux, and Windows (WSL2)
-Windows.
+and one dashboard for many coding-agent backends, across macOS, Linux, Windows (WSL2),
+and **native Windows** (service model).
+
+### Windows Support
+
+ACP now supports running as a native Windows Service!
+
+- **Docs**: See [Windows Setup Guide](docs/WINDOWS_SETUP.md)
+- **Service managers**: NSSM (recommended), sc.exe, or PowerShell cmdlets
+- **Quick start**:
+  ```powershell
+  # Using NSSM (download from https://nssm.cc/download)
+  nssm install "ACP_Dashboard" "C:\Path\To\python.exe" "C:\Path\To\agent-control-plane\tools\dashboard\server.py"
+  nssm start "ACP_Dashboard"
+  ```
+- **PowerShell installer**: `tools/bin/install-windows-service.ps1`
 
+### Windows
 ### Backend Status
 
 | Backend | Status | Notes |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-control-plane",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Help a repo keep GitHub-driven coding agents running reliably without constant human babysitting",
   "homepage": "https://github.com/ducminhnguyen0319/agent-control-plane",
   "bugs": {
@@ -57,6 +57,9 @@
     "tools/bin/github-*.sh",
     "tools/bin/profile-*.sh",
     "tools/bin/test-smoke.sh",
+    "tools/bin/*-adapter.sh",
+    "tools/bin/adapter-*.sh",
+    "tools/bin/run-with-adapter.sh",
     "tools/dashboard/",
     "tools/templates/issue-prompt-template.md",
     "tools/templates/pr-fix-template.md",
@@ -69,8 +72,7 @@
     "tools/vendor/codex-quota-manager/scripts"
   ],
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "access": "public"
   },
   "engines": {
     "node": ">=18"

package/tools/bin/adapter-capabilities.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+# adapter-capabilities.sh
+# Standardized capability reporting for all ACP backend adapters
+# Source this after adapter-interface.sh
+
+set -euo pipefail
+
+# Default capabilities (override in adapter)
+ADAPTER_CAP_CONTEXT_WINDOW=0
+ADAPTER_CAP_STREAMING=false
+ADAPTER_CAP_TOOLS_SUPPORT=false
+ADAPTER_CAP_LOCAL_MODEL=false
+ADAPTER_CAP_CLOUD_API=false
+ADAPTER_CAP_RESIDENT_MODE=false
+ADAPTER_CAP_JSON_OUTPUT=false
+ADAPTER_CAP_MAX_TIMEOUT=3600
+
+# Print adapter capabilities as key=value pairs
+adapter_capabilities() {
+  cat <<EOF
+id=${ADAPTER_ID}
+name=${ADAPTER_NAME}
+type=${ADAPTER_TYPE}
+version=${ADAPTER_VERSION}
+model=${ADAPTER_MODEL:-}
+base_url=${ADAPTER_BASE_URL:-}
+context_window=${ADAPTER_CAP_CONTEXT_WINDOW}
+streaming=${ADAPTER_CAP_STREAMING}
+tools_support=${ADAPTER_CAP_TOOLS_SUPPORT}
+local_model=${ADAPTER_CAP_LOCAL_MODEL}
+cloud_api=${ADAPTER_CAP_CLOUD_API}
+resident_mode=${ADAPTER_CAP_RESIDENT_MODE}
+json_output=${ADAPTER_CAP_JSON_OUTPUT}
+max_timeout=${ADAPTER_CAP_MAX_TIMEOUT}
+EOF
+}
+
+# Check if adapter supports a specific capability
+# Usage: adapter_supports CAPABILITY_NAME
+adapter_supports() {
+  local cap="$(echo "$1" | tr '[:lower:]' '[:upper:]')"
+  local value
+  case "$cap" in
+    STREAMING) value="${ADAPTER_CAP_STREAMING}" ;;
+    TOOLS) value="${ADAPTER_CAP_TOOLS_SUPPORT}" ;;
+    LOCAL) value="${ADAPTER_CAP_LOCAL_MODEL}" ;;
+    CLOUD) value="${ADAPTER_CAP_CLOUD_API}" ;;
+    RESIDENT) value="${ADAPTER_CAP_RESIDENT_MODE}" ;;
+    JSON) value="${ADAPTER_CAP_JSON_OUTPUT}" ;;
+    *) 
+      echo "UNKNOWN_CAPABILITY: $1"
+      return 1
+      ;;
+  esac
+  [[ "$value" == "true" ]] && return 0
+  return 1
+}
+
+# Validate adapter implements required functions
+adapter_validate_interface() {
+  local errors=0
+  for func in adapter_info adapter_health_check adapter_run adapter_status; do
+    if ! declare -f "$func" >/dev/null 2>&1; then
+      echo "ERROR: $func() not implemented in ${ADAPTER_ID} adapter"
+      errors=$((errors + 1))
+    fi
+  done
+  [[ $errors -eq 0 ]] && return 0
+  return 1
+}
+
+# Enhanced health check that also reports capabilities
+adapter_health_check_with_capabilities() {
+  local health_output
+  if ! health_output="$(adapter_health_check 2>&1)"; then
+    echo "UNHEALTHY"
+    echo "$health_output"
+    return 1
+  fi
+  echo "HEALTHY"
+  echo "$health_output"
+  adapter_capabilities
+  return 0
+}

package/tools/bin/adapter-interface.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# adapter-interface.sh
+# Standard interface for ACP backend adapters
+# All adapters must implement these functions:
+#
+#   adapter_info()        - Print adapter metadata (id, name, type, version)
+#   adapter_health_check() - Check if backend is available (exit 0 = healthy)
+#   adapter_run()          - Execute a task (params: MODE SESSION WORKTREE PROMPT_FILE)
+#   adapter_status()       - Get run status (params: RUNS_ROOT SESSION)
+#
+# Usage: source this file in adapter implementations
+
+set -euo pipefail
+
+# Default adapter metadata (override in adapter script)
+ADAPTER_ID="${ADAPTER_ID:-unknown}"
+ADAPTER_NAME="${ADAPTER_NAME:-Unknown Adapter}"
+ADAPTER_TYPE="${ADAPTER_TYPE:-unknown}"  # coding, local-model, cloud-api
+ADAPTER_VERSION="${ADAPTER_VERSION:-0.0.1}"
+
+# Print adapter metadata as key=value pairs
+adapter_info() {
+  cat <<EOF
+id=${ADAPTER_ID}
+name=${ADAPTER_NAME}
+type=${ADAPTER_TYPE}
+version=${ADAPTER_VERSION}
+model=${ADAPTER_MODEL:-}
+base_url=${ADAPTER_BASE_URL:-}
+EOF
+}
+
+# Default health check (override in adapter)
+# Returns: 0 = healthy, 1 = unhealthy
+adapter_health_check() {
+  echo "WARN: adapter_health_check() not implemented for ${ADAPTER_ID}"
+  return 0
+}
+
+# Default run function (MUST override in adapter)
+adapter_run() {
+  echo "ERROR: adapter_run() not implemented for ${ADAPTER_ID}"
+  return 1
+}
+
+# Default status function (override in adapter if needed)
+adapter_status() {
+  local runs_root="${1:?usage: adapter_status RUNS_ROOT SESSION}"
+  local session="${2:?usage: adapter_status RUNS_ROOT SESSION}"
+  local run_dir="${runs_root}/${session}"
+  
+  if [[ ! -d "$run_dir" ]]; then
+    echo "NOT_FOUND"
+    return 1
+  fi
+  
+  if [[ -f "$run_dir/result.env" ]]; then
+    source "$run_dir/result.env"
+    echo "${OUTCOME:-UNKNOWN}"
+    return 0
+  fi
+  
+  if [[ -f "$run_dir/runner.env" ]]; then
+    source "$run_dir/runner.env"
+    echo "${RUNNER_STATE:-RUNNING}"
+    return 0
+  fi
+  
+  echo "RUNNING"
+  return 0
+}
+
+# Load adapter implementation
+# Usage: adapter_load IMPLEMENTATION_SCRIPT
+adapter_load() {
+  local impl="${1:?usage: adapter_load IMPLEMENTATION_SCRIPT}"
+  if [[ ! -f "$impl" ]]; then
+    echo "ERROR: Adapter implementation not found: $impl"
+    return 1
+  fi
+  source "$impl"
+}
+
+# Validate adapter implements required functions
+adapter_validate() {
+  local missing=()
+  type adapter_info >/dev/null 2>&1 || missing+=("adapter_info")
+  type adapter_health_check >/dev/null 2>&1 || missing+=("adapter_health_check")
+  type adapter_run >/dev/null 2>&1 || missing+=("adapter_run")
+  
+  if [[ ${#missing[@]} -gt 0 ]]; then
+    echo "ERROR: Adapter ${ADAPTER_ID} missing required functions: ${missing[*]}"
+    return 1
+  fi
+  
+  return 0
+}

package/tools/bin/claude-adapter.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# claude-adapter.sh
+# Adapter implementation for Claude CLI
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/adapter-interface.sh"
+source "${SCRIPT_DIR}/adapter-capabilities.sh"
+
+ADAPTER_ID="claude"
+ADAPTER_NAME="Claude CLI"
+ADAPTER_TYPE="cloud-api"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${CLAUDE_MODEL:-sonnet}"
+
+# Claude capabilities
+ADAPTER_CAP_CLOUD_API=true
+ADAPTER_CAP_STREAMING=true
+ADAPTER_CAP_JSON_OUTPUT=true
+ADAPTER_CAP_MAX_TIMEOUT=900
+
+adapter_info() {
+  cat <<EOF
+id=${ADAPTER_ID}
+name=${ADAPTER_NAME}
+type=${ADAPTER_TYPE}
+version=${ADAPTER_VERSION}
+model=${ADAPTER_MODEL}
+EOF
+}
+
+adapter_health_check() {
+  if ! command -v claude >/dev/null 2>&1; then
+    echo "ERROR: claude CLI not found in PATH"
+    return 1
+  fi
+  echo "OK: Claude adapter healthy"
+  return 0
+}
+
+adapter_run() {
+  local mode="${1:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  local session="${2:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  local worktree="${3:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  local prompt_file="${4:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  
+  local permission_mode="${CLAUDE_PERMISSION_MODE:-acceptEdits}"
+  local timeout_seconds="${CLAUDE_TIMEOUT_SECONDS:-900}"
+  
+  echo "Claude adapter: Running session ${session}"
+  
+  cd "${worktree}" || return 1
+  
+  prompt="$(cat "${prompt_file}")"
+  
+  if ! timeout "${timeout_seconds}" claude \
+    --permission-mode "${permission_mode}" \
+    --model "${ADAPTER_MODEL}" \
+    --print \
+    "${prompt}" 2>&1; then
+    echo "ERROR: Claude run failed"
+    return 1
+  fi
+  
+  return 0
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  adapter_info
+  echo "---"
+  adapter_health_check
+fi

package/tools/bin/codex-adapter.sh

@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+# codex-adapter.sh
+# Adapter implementation for Codex (Claude CLI)
+# Implements: adapter-interface.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/adapter-interface.sh"
+source "${SCRIPT_DIR}/adapter-capabilities.sh"
+
+# Codex adapter metadata
+ADAPTER_ID="codex"
+ADAPTER_NAME="Codex (Claude CLI)"
+ADAPTER_TYPE="cloud-api"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${CODEX_MODEL:-sonnet}"
+ADAPTER_BASE_URL=""
+
+# Codex capabilities
+ADAPTER_CAP_CLOUD_API=true
+ADAPTER_CAP_STREAMING=true
+ADAPTER_CAP_JSON_OUTPUT=true
+ADAPTER_CAP_MAX_TIMEOUT=900
+
+# Print adapter info
+adapter_info() {
+  cat <<EOF
+id=${ADAPTER_ID}
+name=${ADAPTER_NAME}
+type=${ADAPTER_TYPE}
+version=${ADAPTER_VERSION}
+model=${ADAPTER_MODEL}
+base_url=${ADAPTER_BASE_URL}
+EOF
+}
+
+# Health check: verify claude CLI is available
+adapter_health_check() {
+  if ! command -v claude >/dev/null 2>&1; then
+    echo "ERROR: claude CLI not found in PATH"
+    return 1
+  fi
+  
+  # Check if API key is set
+  if [[ -z "${ANTHROPIC_API_KEY:-}" && -z "${OPENROUTER_API_KEY:-}" ]]; then
+    echo "WARN: No ANTHROPIC_API_KEY or OPENROUTER_API_KEY found"
+    # Don't fail - user might use OAuth
+  fi
+  
+  echo "OK: Codex adapter healthy (claude CLI available)"
+  return 0
+}
+
+# Run a task using codex (claude CLI)
+adapter_run() {
+  local mode="${1:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  local session="${2:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  local worktree="${3:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  local prompt_file="${4:?usage: adapter_run MODE SESSION WORKTREE PROMPT_FILE}"
+  
+  local permission_mode="${CLAUDE_PERMISSION_MODE:-acceptEdits}"
+  local timeout_seconds="${CLAUDE_TIMEOUT_SECONDS:-900}"
+  local max_attempts="${CLAUDE_MAX_ATTEMPTS:-3}"
+  
+  echo "Codex adapter: Running session ${session} with model ${ADAPTER_MODEL}"
+  
+  # Read the prompt
+  local prompt
+  prompt="$(cat "${prompt_file}")"
+  
+  # Change to worktree
+  cd "${worktree}" || return 1
+  
+  # Run claude with the prompt
+  if ! timeout "${timeout_seconds}" claude \
+    --permission-mode "${permission_mode}" \
+    --model "${ADAPTER_MODEL}" \
+    --print \
+    "${prompt}" 2>&1; then
+    echo "ERROR: Codex run failed or timed out after ${timeout_seconds}s"
+    return 1
+  fi
+  
+  echo "Codex adapter: Session ${session} completed"
+  return 0
+}
+
+# Status check
+adapter_status() {
+  local runs_root="${1:?usage: adapter_status RUNS_ROOT SESSION}"
+  local session="${2:?usage: adapter_status RUNS_ROOT SESSION}"
+  local run_dir="${runs_root}/${session}"
+  
+  if [[ ! -d "$run_dir" ]]; then
+    echo "NOT_FOUND"
+    return 1
+  fi
+  
+  # Check for result file
+  if [[ -f "$run_dir/result.env" ]]; then
+    source "$run_dir/result.env"
+    echo "${OUTCOME:-UNKNOWN}"
+    return 0
+  fi
+  
+  # Check if claude process is running
+  if pgrep -f "claude.*${session}" >/dev/null 2>&1; then
+    echo "RUNNING"
+    return 0
+  fi
+  
+  echo "UNKNOWN"
+  return 0
+}
+
+# Self-register: validate this adapter implements required functions
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  # Running directly - print info
+  adapter_info
+  echo "---"
+  adapter_health_check
+fi