agent-control-plane 0.7.0 → 0.8.0

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

package/tools/bin/flow-runtime-doctor.sh

@@ -86,9 +86,47 @@ printf 'RUNTIME_COMPAT_SKILL_DIR=%s\n' "${RUNTIME_COMPAT_SKILL_DIR}"
 printf 'RUNTIME_COMPAT_EXISTS=%s\n' "${runtime_compat_exists}"
 printf 'WORKFLOW_CATALOG=%s\n' "${CATALOG_FILE}"
 printf 'WORKFLOW_CATALOG_EXISTS=%s\n' "${catalog_exists}"
+# Check timeout command (needed for scheduler cross-platform)
+if command -v timeout &>/dev/null; then
+  printf 'TIMEOUT_CMD=%s\n' "timeout"
+elif command -v gtimeout &>/dev/null; then
+  printf 'TIMEOUT_CMD=%s\n' "gtimeout (from coreutils)"
+else
+  printf 'TIMEOUT_CMD=%s\n' "missing (install coreutils for timeout command)"
+fi
 printf 'DOCTOR_STATUS=%s\n' "${status}"
 
+# Provide clear next steps based on state
+printf '\n=== NEXT STEPS ===\n'
+if [[ "${status}" == "ok" ]]; then
+  printf '✓ All checks passed! No action required.\n'
+  printf 'Run ACP: bash %s/tools/bin/setup.sh --profile-id <id>\n' "${FLOW_SKILL_DIR}"
+elif [[ "${status}" == "needs-sync" ]]; then
+  printf 'Status: NEEDS-SYNC\n'
+  printf 'Run sync to fix issues:\n'
+  printf '  bash %q %q %q\n' "${SYNC_SCRIPT}" "${SHARED_AGENT_HOME}" "${RUNTIME_HOME}"
+  printf '\nOr run setup with resume:\n'
+  printf '  bash %s/tools/bin/setup.sh --resume\n' "${FLOW_SKILL_DIR}"
+  if [[ -n "${PROFILE_SELECTION_HINT}" ]]; then
+    printf '\nProfile selection hint: %s\n' "${PROFILE_SELECTION_HINT}"
+  fi
+else
+  printf 'Status: %s\n' "${status}"
+  printf 'Check the output above for details.\n'
+fi
+
+# Cross-platform tips
+if [[ "${TIMEOUT_CMD}" == *"missing"* ]]; then
+  printf '\n⚠ Cross-Platform Tip: Install coreutils for timeout command:\n'
+  if [[ "$(uname -s)" == "Darwin" ]]; then
+    printf '  macOS: brew install coreutils\n'
+  else
+    printf '  Linux: sudo apt-get install coreutils (usually pre-installed)\n'
+  fi
+fi
+
 if [[ -n "${PROFILE_SELECTION_HINT}" ]]; then
+  printf '\n=== PROFILE SELECTION ===\n'
   printf 'PROFILE_SELECTION_NEXT_STEP=ACP_PROJECT_ID=<id> bash %s/tools/bin/render-flow-config.sh\n' "${FLOW_SKILL_DIR}"
 fi
 
@@ -99,3 +137,32 @@ if [[ "${status}" != "ok" ]]; then
   printf '  bash %q %q %q\n' "${SYNC_SCRIPT}" "${SHARED_AGENT_HOME}" "${RUNTIME_HOME}"
   printf '\nOr run: bash %s/tools/bin/setup.sh --resume\n' "${FLOW_SKILL_DIR}"
 fi
+
+# Cross-Platform Dependencies Check
+printf '\n=== CROSS-PLATFORM DEPENDENCIES ===\n'
+for cmd in rsync git python3 jq curl; do
+  if command -v "$cmd" &>/dev/null; then
+    printf '✓ %s: available\n' "$cmd"
+  else
+    printf '✗ %s: MISSING\n' "$cmd"
+    case "$cmd" in
+      rsync)
+        if [[ "$(uname -s)" == "Darwin" ]]; then
+          printf '  macOS: brew install rsync\n'
+        else
+          printf '  Linux: sudo apt-get install rsync\n'
+        fi
+        ;;
+      python3)
+        printf '  Install Python 3 from https://python.org\n'
+        ;;
+      jq|curl)
+        if [[ "$(uname -s)" == "Darwin" ]]; then
+          printf '  macOS: brew install %s\n' "$cmd"
+        else
+          printf '  Linux: sudo apt-get install %s\n' "$cmd"
+        fi
+        ;;
+    esac
+  fi
+done

package/tools/bin/heartbeat-safe-auto.sh

@@ -75,8 +75,167 @@ QUOTA_LOCK_DIR="${STATE_ROOT}/quota-preflight.lock"
 QUOTA_PID_FILE="${QUOTA_LOCK_DIR}/pid"
 python_bin="$(flow_resolve_python_bin || true)"
 
+# Stale lock detection and cleanup
+cleanup_stale_locks() {
+  local lock_dir pid_file pid max_age_seconds=${1:-1800}  # default 30 minutes
+  local lock_dirs=(
+    "${STATE_ROOT}/heartbeat-loop.lock"
+    "${STATE_ROOT}/quota-preflight.lock"
+  )
+  
+  for lock_dir in "${lock_dirs[@]}"; do
+    pid_file="${lock_dir}/pid"
+    if [[ -f "$pid_file" ]]; then
+      pid=$(cat "$pid_file" 2>/dev/null | tr -d '[:space:]')
+      if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+        # Process is still running, check if parent is init (orphan)
+        local ppid
+        ppid=$(ps -p "$pid" -o ppid= 2>/dev/null | tr -d '[:space:]')
+        if [[ "$ppid" == "1" ]]; then
+          log_event "stale_lock_detected" "type" "orphan" "pid" "$pid" "lock_dir" "$lock_dir"
+          echo "Warning: Removing orphan lock (PID $pid, lock: $lock_dir)"
+          rm -rf "$lock_dir"
+        fi
+      else
+        # Process not running, check lock age
+        local lock_age
+        lock_age=$(($(date +%s) - $(stat -f %m "$pid_file" 2>/dev/null || stat -c %Y "$pid_file" 2>/dev/null || echo "0")))
+        if [[ $lock_age -gt $max_age_seconds ]]; then
+          log_event "stale_lock_detected" "type" "timeout" "pid" "$pid" "age_seconds" "$lock_age" "lock_dir" "$lock_dir"
+          echo "Warning: Removing stale lock (PID $pid, age: ${lock_age}s, lock: $lock_dir)"
+          rm -rf "$lock_dir"
+        fi
+      fi
+    fi
+  done
+}
+
+# Structured logging for scheduler observability
+LOG_FILE="${STATE_ROOT}/scheduler-events.jsonl"
+mkdir -p "$(dirname "${LOG_FILE}")"
+
+log_event() {
+  local event_type="$1"
+  shift
+  local timestamp
+  timestamp="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+  local extra_fields=""
+  while [[ $# -gt 0 ]]; do
+    extra_fields="${extra_fields}, \"$1\": \"$2\""
+    shift 2
+  done
+  echo "{\"timestamp\": \"${timestamp}\", \"event\": \"${event_type}\", \"pid\": ${$}${extra_fields}}" >> "${LOG_FILE}"
+}
+
+# Health check: monitor system resources
+check_system_resources() {
+  local cpu_usage mem_usage disk_usage
+  local warn=0
+  
+  # CPU usage (1-min load average / number of cores)
+  if command -v nproc >/dev/null 2>&1 && command -v awk >/dev/null 2>&1; then
+    local load_1min disk_avail disk_total
+    load_1min=$(cat /proc/loadavg 2>/dev/null | awk '{print $1}' || echo "0")
+    local cores
+    cores=$(nproc 2>/dev/null || echo "1")
+    cpu_usage=$(echo "$load_1min $cores" | awk '{printf "%.0f", ($1/$2)*100}' 2>/dev/null || echo "0")
+  fi
+  
+  # Memory usage
+  if command -v free >/dev/null 2>&1; then
+    mem_usage=$(free | awk '/Mem:/ {printf "%.0f", ($3/$2)*100}' 2>/dev/null || echo "0")
+  elif [[ -f /proc/meminfo ]]; then
+    local mem_total mem_available
+    mem_total=$(grep MemTotal /proc/meminfo 2>/dev/null | awk '{print $2}' || echo "1")
+    mem_available=$(grep MemAvailable /proc/meminfo 2>/dev/null | awk '{print $2}' || echo "0")
+    mem_usage=$(echo "$mem_total $mem_available" | awk '{printf "%.0f", (($1-$2)/$1)*100}' 2>/dev/null || echo "0")
+  fi
+  
+  # Disk usage for STATE_ROOT
+  disk_usage=$(df "${STATE_ROOT}" 2>/dev/null | awk 'NR==2 {gsub(/%/,"",$5); print $5}' || echo "0")
+  
+  # Log resource status
+  log_event "system_resources" "cpu_pct" "${cpu_usage:-0}" "mem_pct" "${mem_usage:-0}" "disk_pct" "${disk_usage:-0}"
+  
+  # Warnings
+  if [[ "${cpu_usage:-0}" -gt 80 ]]; then
+    log_event "resource_warning" "type" "cpu" "value" "${cpu_usage}"
+    warn=1
+  fi
+  if [[ "${mem_usage:-0}" -gt 90 ]]; then
+    log_event "resource_warning" "type" "memory" "value" "${mem_usage}"
+    warn=1
+  fi
+  if [[ "${disk_usage:-0}" -gt 90 ]]; then
+    log_event "resource_warning" "type" "disk" "value" "${disk_usage}"
+    warn=1
+  fi
+  
+  return $warn
+}
+
+# Collect scheduler metrics for observability
+collect_metrics() {
+  local active_sessions=0
+  local queued_issues=0
+  local completed_today=0
+  local failed_today=0
+  
+  # Count active tmux sessions for this repo
+  if command -v tmux >/dev/null 2>&1; then
+    active_sessions=$(tmux ls 2>/dev/null | grep -c "agent-" || echo "0")
+  fi
+  
+  # Count queued issues (issues with agent-keep-open label but no active session)
+  if command -v gh >/dev/null 2>&1 && [[ -n "${REPO_SLUG:-}" ]]; then
+    queued_issues=$(gh issue list --repo "${REPO_SLUG}" --label "agent-keep-open" --state open --json number 2>/dev/null | grep -c '"number"' || echo "0")
+  fi
+  
+  # Count completed/failed sessions from history (last 24h)
+  if [[ -d "${HISTORY_ROOT}" ]]; then
+    completed_today=$(find "${HISTORY_ROOT}" -name "*.json" -mtime 0 2>/dev/null | xargs grep -l '"status": "completed"' 2>/dev/null | wc -l || echo "0")
+    failed_today=$(find "${HISTORY_ROOT}" -name "*.json" -mtime 0 2>/dev/null | xargs grep -l '"status": "failed"' 2>/dev/null | wc -l || echo "0")
+  fi
+  
+  # Log metrics
+  log_event "scheduler_metrics" \
+    "active_sessions" "$active_sessions" \
+    "queued_issues" "$queued_issues" \
+    "completed_today" "$completed_today" \
+    "failed_today" "$failed_today"
+}
+
+# Error tracking for scheduler observability
+ERROR_LOG="${STATE_ROOT}/scheduler-errors.jsonl"
+error_count=0
+
+track_error() {
+  local error_type="$1"
+  local error_msg="$2"
+  local timestamp
+  timestamp="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+  
+  ((error_count++))
+  
+  # Log to JSONL
+  echo "{\"timestamp\": \"${timestamp}\", \"type\": \"${error_type}\", \"message\": \"${error_msg}\", \"pid\": ${$}}" >> "${ERROR_LOG}"
+  
+  # Also log as event
+  log_event "scheduler_error" "type" "${error_type}" "message" "${error_msg}"
+  
+  # Alert if too many errors
+  if [[ $error_count -gt 10 ]]; then
+    log_event "error_threshold_exceeded" "count" "$error_count"
+    echo "Warning: High error count detected ($error_count errors)" >&2
+  fi
+}
+
 mkdir -p "${AGENT_ROOT}" "${RUNS_ROOT}" "${STATE_ROOT}" "${HISTORY_ROOT}" "${WORKTREE_ROOT}" "${MEMORY_DIR}"
 
+cleanup_stale_locks 1800  # Clean locks older than 30 minutes
+collect_metrics
+log_event "heartbeat_start" "repo_slug" "${REPO_SLUG}"
+
 if [[ -z "${python_bin}" || ! -x "${python_bin}" ]]; then
   echo "unable to resolve a runnable python interpreter for heartbeat-safe-auto.sh" >&2
   exit 1
@@ -605,6 +764,7 @@ write_shared_loop_status "running" ""
       --heavy-deferred-message "E2E-heavy issues remain queued until the single e2e slot is free."; then
   write_shared_loop_status "idle" "0"
   printf '[%s] shared heartbeat loop end status=0\n' "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+  log_event "heartbeat_complete" "status" "0"
 else
   loop_status=$?
   write_shared_loop_status "idle" "${loop_status}"
@@ -612,6 +772,7 @@ else
     printf 'HEARTBEAT_LOOP_TIMEOUT=yes\n'
   fi
   printf '[%s] shared heartbeat loop end status=%s\n' "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" "${loop_status}"
+  log_event "heartbeat_complete" "status" "${loop_status}"
   exit "${loop_status}"
 fi
 

package/tools/bin/kilo-adapter.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+# kilo-adapter.sh
+# Adapter implementation for Kilo Code
+
+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="kilo"
+ADAPTER_NAME="Kilo Code"
+ADAPTER_TYPE="cloud-api"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${KILO_MODEL:-anthropic/claude-sonnet-4-20250514}"
+
+# Kilo 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 kilo >/dev/null 2>&1; then
+    echo "ERROR: kilo CLI not found in PATH"
+    return 1
+  fi
+  
+  # Verify kilo can actually run (version check)
+  if ! kilo --version >/dev/null 2>&1; then
+    echo "ERROR: kilo CLI cannot run (check installation)"
+    return 1
+  fi
+  
+  local version
+  version="$(kilo --version 2>/dev/null || true)"
+  if [[ -z "$version" ]]; then
+    echo "WARN: Could not detect kilo version"
+  else
+    echo "INFO: Kilo version: $version"
+  fi
+  
+  # Verify model is specified
+  if [[ -z "${ADAPTER_MODEL}" ]]; then
+    echo "WARN: No model specified for Kilo adapter"
+  fi
+  
+  echo "OK: Kilo adapter healthy (model: ${ADAPTER_MODEL})"
+  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}"
+  
+  # Validate prompt file
+  if [[ ! -f "${prompt_file}" ]]; then
+    echo "ERROR: Prompt file not found: ${prompt_file}"
+    return 1
+  fi
+  if [[ ! -s "${prompt_file}" ]]; then
+    echo "ERROR: Prompt file is empty: ${prompt_file}"
+    return 1
+  fi
+  
+  local timeout_seconds="${KILO_TIMEOUT_SECONDS:-900}"
+  
+  echo "Kilo adapter: Running session ${session} with model ${ADAPTER_MODEL}"
+  
+  cd "${worktree}" || return 1
+  
+  prompt="$(cat "${prompt_file}")"
+  
+  # Run kilo and capture output
+  local output
+  if ! output="$(timeout "${timeout_seconds}" kilo --model "${ADAPTER_MODEL}" "${prompt}" 2>&1)"; then
+    echo "ERROR: Kilo run failed or timed out after ${timeout_seconds}s"
+    return 1
+  fi
+  
+  # Validate JSON stream output (kilo outputs JSON events)
+  if ! echo "$output" | python3 -c "import sys, json; [json.loads(line) for line in sys.stdin if line.strip()]" 2>/dev/null; then
+    echo "WARN: Kilo output is not valid JSON stream"
+  else
+    echo "INFO: Kilo output validated as JSON stream"
+  fi
+  
+  echo "Kilo adapter: Session ${session} completed"
+  return 0
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  adapter_info
+  echo "---"
+  adapter_health_check
+fi

package/tools/bin/ollama-adapter.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+# ollama-adapter.sh
+# Adapter implementation for Ollama local models
+# 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"
+
+# Ollama adapter metadata
+ADAPTER_ID="ollama"
+ADAPTER_NAME="Ollama Local Models"
+ADAPTER_TYPE="local-model"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${OLLAMA_MODEL:-qwen2.5-coder:7b}"
+ADAPTER_BASE_URL="${OLLAMA_BASE_URL:-http://localhost:11434}"
+
+# Ollama capabilities
+ADAPTER_CAP_LOCAL_MODEL=true
+ADAPTER_CAP_STREAMING=true
+ADAPTER_CAP_TOOLS_SUPPORT=true
+ADAPTER_CAP_CONTEXT_WINDOW=32768  # Default, will be detected dynamically
+ADAPTER_CAP_MAX_TIMEOUT=3600
+
+# 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 ollama is running and model is available
+adapter_health_check() {
+  # Check if ollama is running
+  if ! curl -sf "${ADAPTER_BASE_URL}/api/tags" >/dev/null 2>&1; then
+    echo "ERROR: Ollama not reachable at ${ADAPTER_BASE_URL}"
+    return 1
+  fi
+  
+  # Check if model is available (try to pull if not)
+  if ! ollama list 2>/dev/null | grep -q "${ADAPTER_MODEL}"; then
+    echo "WARN: Model ${ADAPTER_MODEL} not found locally. Attempting pull..."
+    if ! ollama pull "${ADAPTER_MODEL}" 2>&1; then
+      echo "ERROR: Failed to pull model ${ADAPTER_MODEL}"
+      return 1
+    fi
+  fi
+  
+  # Detect context window and update capability dynamically
+  local context_window
+  # Ollama API returns context_length inside model_info with architecture prefix
+  # e.g., qwen2.context_length, llama.context_length, etc.
+  if command -v jq &>/dev/null; then
+    context_window="$(curl -sf "${ADAPTER_BASE_URL}/api/show" -d "{\"name\":\"${ADAPTER_MODEL}\"}" 2>/dev/null | jq -r '.model_info // {} | to_entries[] | select(.key | endswith("context_length")) | .value' 2>/dev/null | head -1 || true)"
+  else
+    # Fallback: use grep for common patterns
+    context_window="$(curl -sf "${ADAPTER_BASE_URL}/api/show" -d "{\"name\":\"${ADAPTER_MODEL}\"}" 2>/dev/null | grep -o '"[a-z]*\.context_length":[0-9]*' | head -1 | grep -o '[0-9]*$' || true)"
+  fi
+  if [[ -n "$context_window" ]]; then
+    ADAPTER_CAP_CONTEXT_WINDOW="$context_window"
+    echo "INFO: Detected context window: $context_window tokens"
+  else
+    echo "WARN: Could not detect context window from Ollama API"
+  fi
+  
+  echo "OK: Ollama healthy, model ${ADAPTER_MODEL} available"
+  return 0
+}
+
+# Run a task using ollama
+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}"
+  
+  # Validate prompt file
+  if [[ ! -f "${prompt_file}" ]]; then
+    echo "ERROR: Prompt file not found: ${prompt_file}"
+    return 1
+  fi
+  if [[ ! -s "${prompt_file}" ]]; then
+    echo "ERROR: Prompt file is empty: ${prompt_file}"
+    return 1
+  fi
+  
+  local timeout_seconds="${OLLAMA_TIMEOUT_SECONDS:-900}"
+  
+  echo "Ollama adapter: Running session ${session} with model ${ADAPTER_MODEL}"
+  
+  # Read the prompt
+  local prompt
+  prompt="$(cat "${prompt_file}")"
+  
+  # Run ollama with the prompt
+  # Use perl for timeout on macOS (which lacks GNU timeout)
+  if command -v timeout >/dev/null 2>&1; then
+    if ! timeout "${timeout_seconds}" ollama run "${ADAPTER_MODEL}" "${prompt}" 2>&1; then
+      echo "ERROR: Ollama run failed or timed out after ${timeout_seconds}s"
+      return 1
+    fi
+  elif command -v perl >/dev/null 2>&1; then
+    if ! perl -e "alarm ${timeout_seconds}; exec @ARGV" ollama run "${ADAPTER_MODEL}" "${prompt}" 2>&1; then
+      echo "ERROR: Ollama run failed or timed out after ${timeout_seconds}s"
+      return 1
+    fi
+  else
+    # No timeout available, run without timeout
+    if ! ollama run "${ADAPTER_MODEL}" "${prompt}" 2>&1; then
+      echo "ERROR: Ollama run failed"
+      return 1
+    fi
+  fi
+  
+  echo "Ollama adapter: Session ${session} completed"
+  return 0
+}
+
+# Status check (override default)
+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 ollama process is running
+  if pgrep -f "ollama run ${ADAPTER_MODEL}" >/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