agent-control-plane 0.6.0 → 0.7.1

package/tools/bin/flow-session-lib.sh

@@ -0,0 +1,317 @@
+flow_provider_pool_state_get() {
+  local config_file="${1:?config file required}"
+  local pool_name="${2:?pool name required}"
+  local backend=""
+  local model=""
+  local state_root=""
+  local provider_key=""
+  local state_file=""
+  local attempts="0"
+  local next_attempt_epoch="0"
+  local next_attempt_at=""
+  local last_reason=""
+  local updated_at=""
+  local ready="yes"
+  local valid="yes"
+  local now_epoch=""
+  local safe_profile=""
+  local bypass_profile=""
+  local claude_model=""
+  local claude_permission_mode=""
+  local claude_effort=""
+  local claude_timeout_seconds=""
+  local claude_max_attempts=""
+  local claude_retry_backoff_seconds=""
+  local openclaw_model=""
+  local openclaw_thinking=""
+  local openclaw_timeout_seconds=""
+  local ollama_model=""
+  local ollama_base_url=""
+  local ollama_timeout_seconds=""
+  local pi_model=""
+  local pi_thinking=""
+  local pi_timeout_seconds=""
+  local opencode_model=""
+  local opencode_timeout_seconds=""
+  local kilo_model=""
+  local kilo_timeout_seconds=""
+
+  backend="$(flow_provider_pool_backend "${config_file}" "${pool_name}")"
+  safe_profile="$(flow_provider_pool_safe_profile "${config_file}" "${pool_name}")"
+  bypass_profile="$(flow_provider_pool_bypass_profile "${config_file}" "${pool_name}")"
+  claude_model="$(flow_provider_pool_claude_model "${config_file}" "${pool_name}")"
+  claude_permission_mode="$(flow_provider_pool_claude_permission_mode "${config_file}" "${pool_name}")"
+  claude_effort="$(flow_provider_pool_claude_effort "${config_file}" "${pool_name}")"
+  claude_timeout_seconds="$(flow_provider_pool_claude_timeout_seconds "${config_file}" "${pool_name}")"
+  claude_max_attempts="$(flow_provider_pool_claude_max_attempts "${config_file}" "${pool_name}")"
+  claude_retry_backoff_seconds="$(flow_provider_pool_claude_retry_backoff_seconds "${config_file}" "${pool_name}")"
+  openclaw_model="$(flow_provider_pool_openclaw_model "${config_file}" "${pool_name}")"
+  openclaw_thinking="$(flow_provider_pool_openclaw_thinking "${config_file}" "${pool_name}")"
+  openclaw_timeout_seconds="$(flow_provider_pool_openclaw_timeout_seconds "${config_file}" "${pool_name}")"
+  ollama_model="$(flow_provider_pool_ollama_model "${config_file}" "${pool_name}")"
+  ollama_base_url="$(flow_provider_pool_ollama_base_url "${config_file}" "${pool_name}")"
+  ollama_timeout_seconds="$(flow_provider_pool_ollama_timeout_seconds "${config_file}" "${pool_name}")"
+  pi_model="$(flow_provider_pool_pi_model "${config_file}" "${pool_name}")"
+  pi_thinking="$(flow_provider_pool_pi_thinking "${config_file}" "${pool_name}")"
+  pi_timeout_seconds="$(flow_provider_pool_pi_timeout_seconds "${config_file}" "${pool_name}")"
+  opencode_model="$(flow_provider_pool_opencode_model "${config_file}" "${pool_name}")"
+  opencode_timeout_seconds="$(flow_provider_pool_opencode_timeout_seconds "${config_file}" "${pool_name}")"
+  kilo_model="$(flow_provider_pool_kilo_model "${config_file}" "${pool_name}")"
+  kilo_timeout_seconds="$(flow_provider_pool_kilo_timeout_seconds "${config_file}" "${pool_name}")"
+  model="$(flow_provider_pool_model_identity "${config_file}" "${pool_name}")"
+
+  case "${backend}" in
+    codex)
+      [[ -n "${safe_profile}" && -n "${bypass_profile}" ]] || valid="no"
+      ;;
+    claude)
+      [[ -n "${claude_model}" && -n "${claude_permission_mode}" && -n "${claude_effort}" && -n "${claude_timeout_seconds}" && -n "${claude_max_attempts}" && -n "${claude_retry_backoff_seconds}" ]] || valid="no"
+      ;;
+    openclaw)
+      [[ -n "${openclaw_model}" && -n "${openclaw_thinking}" && -n "${openclaw_timeout_seconds}" ]] || valid="no"
+      ;;
+    ollama)
+      [[ -n "${ollama_model}" ]] || valid="no"
+      ;;
+    pi)
+      [[ -n "${pi_model}" ]] || valid="no"
+      ;;
+    opencode)
+      [[ -n "${opencode_model}" && -n "${opencode_timeout_seconds}" ]] || valid="no"
+      ;;
+    kilo)
+      [[ -n "${kilo_model}" && -n "${kilo_timeout_seconds}" ]] || valid="no"
+      ;;
+    *)
+      valid="no"
+      ;;
+  esac
+
+  if [[ "${valid}" == "yes" && -n "${model}" ]]; then
+    state_root="$(flow_resolve_state_root "${config_file}")"
+    provider_key="$(flow_sanitize_provider_key "${backend}-${model}")"
+    state_file="${state_root}/retries/providers/${provider_key}.env"
+
+    if [[ -f "${state_file}" ]]; then
+      set -a
+      # shellcheck source=/dev/null
+      source "${state_file}"
+      set +a
+      attempts="${ATTEMPTS:-0}"
+      next_attempt_epoch="${NEXT_ATTEMPT_EPOCH:-0}"
+      next_attempt_at="${NEXT_ATTEMPT_AT:-}"
+      last_reason="${LAST_REASON:-}"
+      updated_at="${UPDATED_AT:-}"
+    fi
+
+    now_epoch="$(date +%s)"
+    if [[ "${next_attempt_epoch}" =~ ^[0-9]+$ ]] && (( next_attempt_epoch > now_epoch )); then
+      ready="no"
+    fi
+  else
+    ready="no"
+  fi
+
+  printf 'POOL_NAME=%s\n' "${pool_name}"
+  printf 'VALID=%s\n' "${valid}"
+  printf 'BACKEND=%s\n' "${backend}"
+  printf 'MODEL=%s\n' "${model}"
+  printf 'PROVIDER_KEY=%s\n' "${provider_key}"
+  printf 'ATTEMPTS=%s\n' "${attempts}"
+  printf 'NEXT_ATTEMPT_EPOCH=%s\n' "${next_attempt_epoch}"
+  printf 'NEXT_ATTEMPT_AT=%s\n' "${next_attempt_at}"
+  printf 'READY=%s\n' "${ready}"
+  printf 'LAST_REASON=%s\n' "${last_reason}"
+  printf 'UPDATED_AT=%s\n' "${updated_at}"
+  printf 'SAFE_PROFILE=%s\n' "${safe_profile}"
+  printf 'BYPASS_PROFILE=%s\n' "${bypass_profile}"
+  printf 'CLAUDE_MODEL=%s\n' "${claude_model}"
+  printf 'CLAUDE_PERMISSION_MODE=%s\n' "${claude_permission_mode}"
+  printf 'CLAUDE_EFFORT=%s\n' "${claude_effort}"
+  printf 'CLAUDE_TIMEOUT_SECONDS=%s\n' "${claude_timeout_seconds}"
+  printf 'CLAUDE_MAX_ATTEMPTS=%s\n' "${claude_max_attempts}"
+  printf 'CLAUDE_RETRY_BACKOFF_SECONDS=%s\n' "${claude_retry_backoff_seconds}"
+  printf 'OPENCLAW_MODEL=%s\n' "${openclaw_model}"
+  printf 'OPENCLAW_THINKING=%s\n' "${openclaw_thinking}"
+  printf 'OPENCLAW_TIMEOUT_SECONDS=%s\n' "${openclaw_timeout_seconds}"
+  printf 'OLLAMA_MODEL=%s\n' "${ollama_model}"
+  printf 'OLLAMA_BASE_URL=%s\n' "${ollama_base_url}"
+  printf 'OLLAMA_TIMEOUT_SECONDS=%s\n' "${ollama_timeout_seconds}"
+  printf 'PI_MODEL=%s\n' "${pi_model}"
+  printf 'PI_THINKING=%s\n' "${pi_thinking}"
+  printf 'PI_TIMEOUT_SECONDS=%s\n' "${pi_timeout_seconds}"
+  printf 'OPENCODE_MODEL=%s\n' "${opencode_model}"
+  printf 'OPENCODE_TIMEOUT_SECONDS=%s\n' "${opencode_timeout_seconds}"
+  printf 'KILO_MODEL=%s\n' "${kilo_model}"
+  printf 'KILO_TIMEOUT_SECONDS=%s\n' "${kilo_timeout_seconds}"
+}
+
+flow_selected_provider_pool_env() {
+  local config_file="${1:-}"
+  local pool_name=""
+  local candidate=""
+  local candidate_valid=""
+  local candidate_ready=""
+  local candidate_next_epoch="0"
+  local exhausted_candidate=""
+  local exhausted_epoch=""
+
+  if [[ -z "${config_file}" ]]; then
+    config_file="$(resolve_flow_config_yaml "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")"
+  fi
+
+  if ! flow_provider_pools_enabled "${config_file}"; then
+    return 1
+  fi
+
+  while IFS= read -r pool_name; do
+    [[ -n "${pool_name}" ]] || continue
+    candidate="$(flow_provider_pool_state_get "${config_file}" "${pool_name}")"
+    candidate_valid="$(awk -F= '/^VALID=/{print $2}' <<<"${candidate}")"
+    [[ "${candidate_valid}" == "yes" ]] || continue
+
+    candidate_ready="$(awk -F= '/^READY=/{print $2}' <<<"${candidate}")"
+    if [[ "${candidate_ready}" == "yes" ]]; then
+      printf '%s\n' "${candidate}"
+      printf 'POOLS_EXHAUSTED=no\n'
+      printf 'SELECTION_REASON=ready\n'
+      return 0
+    fi
+
+    candidate_next_epoch="$(awk -F= '/^NEXT_ATTEMPT_EPOCH=/{print $2}' <<<"${candidate}")"
+    if [[ -z "${exhausted_candidate}" ]]; then
+      exhausted_candidate="${candidate}"
+      exhausted_epoch="${candidate_next_epoch}"
+      continue
+    fi
+
+    if [[ "${candidate_next_epoch}" =~ ^[0-9]+$ && "${exhausted_epoch}" =~ ^[0-9]+$ ]] && (( candidate_next_epoch < exhausted_epoch )); then
+      exhausted_candidate="${candidate}"
+      exhausted_epoch="${candidate_next_epoch}"
+    fi
+  done < <(flow_provider_pool_names "${config_file}")
+
+  [[ -n "${exhausted_candidate}" ]] || return 1
+
+  printf '%s\n' "${exhausted_candidate}"
+  printf 'POOLS_EXHAUSTED=yes\n'
+  printf 'SELECTION_REASON=all-cooldown\n'
+}
+
+flow_resolve_issue_session_prefix() {
+  local config_file="${1:-}"
+  local default_value=""
+  if [[ -z "${config_file}" ]]; then
+    config_file="$(resolve_flow_config_yaml "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")"
+  fi
+  default_value="$(flow_default_issue_session_prefix "${config_file}")"
+  flow_env_or_config "${config_file}" "ACP_ISSUE_SESSION_PREFIX F_LOSNING_ISSUE_SESSION_PREFIX" "session_naming.issue_prefix" "${default_value}"
+}
+
+flow_resolve_pr_session_prefix() {
+  local config_file="${1:-}"
+  local default_value=""
+  if [[ -z "${config_file}" ]]; then
+    config_file="$(resolve_flow_config_yaml "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")"
+  fi
+  default_value="$(flow_default_pr_session_prefix "${config_file}")"
+  flow_env_or_config "${config_file}" "ACP_PR_SESSION_PREFIX F_LOSNING_PR_SESSION_PREFIX" "session_naming.pr_prefix" "${default_value}"
+}
+
+flow_resolve_issue_branch_prefix() {
+  local config_file="${1:-}"
+  local default_value=""
+  if [[ -z "${config_file}" ]]; then
+    config_file="$(resolve_flow_config_yaml "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")"
+  fi
+  default_value="$(flow_default_issue_branch_prefix "${config_file}")"
+  flow_env_or_config "${config_file}" "ACP_ISSUE_BRANCH_PREFIX F_LOSNING_ISSUE_BRANCH_PREFIX" "session_naming.issue_branch_prefix" "${default_value}"
+}
+
+flow_resolve_pr_worktree_branch_prefix() {
+  local config_file="${1:-}"
+  local default_value=""
+  if [[ -z "${config_file}" ]]; then
+    config_file="$(resolve_flow_config_yaml "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")"
+  fi
+  default_value="$(flow_default_pr_worktree_branch_prefix "${config_file}")"
+  flow_env_or_config "${config_file}" "ACP_PR_WORKTREE_BRANCH_PREFIX F_LOSNING_PR_WORKTREE_BRANCH_PREFIX" "session_naming.pr_worktree_branch_prefix" "${default_value}"
+}
+
+flow_resolve_managed_pr_branch_globs() {
+  local config_file="${1:-}"
+  local default_value=""
+  if [[ -z "${config_file}" ]]; then
+    config_file="$(resolve_flow_config_yaml "${BASH_SOURCE[1]:-${BASH_SOURCE[0]}}")"
+  fi
+  default_value="$(flow_default_managed_pr_branch_globs "${config_file}")"
+  flow_env_or_config "${config_file}" "ACP_MANAGED_PR_BRANCH_GLOBS F_LOSNING_MANAGED_PR_BRANCH_GLOBS" "session_naming.managed_pr_branch_globs" "${default_value}"
+}
+
+flow_escape_regex() {
+  local raw_value="${1:-}"
+  python3 - "${raw_value}" <<'PY'
+import re
+import sys
+
+print(re.escape(sys.argv[1]))
+PY
+}
+
+flow_managed_pr_prefixes() {
+  local config_file="${1:-}"
+  local managed_globs=""
+  local branch_glob=""
+  local prefix=""
+
+  managed_globs="$(flow_resolve_managed_pr_branch_globs "${config_file}")"
+  for branch_glob in ${managed_globs}; do
+    prefix="${branch_glob%\*}"
+    [[ -n "${prefix}" ]] || continue
+    printf '%s\n' "${prefix}"
+  done
+}
+
+flow_managed_pr_prefixes_json() {
+  local config_file="${1:-}"
+  local prefixes=()
+  local prefix=""
+
+  while IFS= read -r prefix; do
+    [[ -n "${prefix}" ]] || continue
+    prefixes+=("${prefix}")
+  done < <(flow_managed_pr_prefixes "${config_file}")
+
+  python3 - "${prefixes[@]}" <<'PY'
+import json
+import sys
+
+print(json.dumps(sys.argv[1:]))
+PY
+}
+
+flow_managed_issue_branch_regex() {
+  local config_file="${1:-}"
+  local prefix=""
+  local normalized_prefix=""
+  local escaped_prefix=""
+  local joined=""
+
+  while IFS= read -r prefix; do
+    [[ -n "${prefix}" ]] || continue
+    normalized_prefix="${prefix%/}"
+    escaped_prefix="$(flow_escape_regex "${normalized_prefix}")"
+    if [[ -n "${joined}" ]]; then
+      joined="${joined}|${escaped_prefix}"
+    else
+      joined="${escaped_prefix}"
+    fi
+  done < <(flow_managed_pr_prefixes "${config_file}")
+
+  if [[ -z "${joined}" ]]; then
+    joined="$(flow_escape_regex "agent/$(flow_resolve_adapter_id "${config_file}")")"
+  fi
+
+  printf '^(?:%s)/issue-(?<id>[0-9]+)(?:-|$)\n' "${joined}"
+}
+

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

package/tools/bin/openclaw-adapter.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# openclaw-adapter.sh
+# Adapter implementation for OpenClaw.
+
+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="openclaw"
+ADAPTER_NAME="OpenClaw"
+ADAPTER_TYPE="cloud-api"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${OPENCLAW_MODEL:-openrouter/qwen/qwen3.5-plus:free}"
+
+# OpenClaw capabilities
+ADAPTER_CAP_CLOUD_API=true
+ADAPTER_CAP_STREAMING=true
+ADAPTER_CAP_JSON_OUTPUT=true
+ADAPTER_CAP_RESIDENT_MODE=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 openclaw >/dev/null 2>&1; then
+    echo "ERROR: openclaw CLI not found in PATH"
+    return 1
+  fi
+  echo "OK: OpenClaw 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 timeout_seconds="${OPENCLAW_TIMEOUT_SECONDS:-900}"
+  
+  echo "OpenClaw adapter: Running session ${session}"
+  
+  cd "${worktree}" || return 1
+  
+  prompt="$(cat "${prompt_file}")"
+  
+  if ! timeout "${timeout_seconds}" openclaw --model "${ADAPTER_MODEL}" "${prompt}" 2>&1; then
+    echo "ERROR: OpenClaw run failed"
+    return 1
+  fi
+  
+  return 0
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  adapter_info
+  echo "---"
+  adapter_health_check
+fi