agent-control-plane 0.7.0 → 0.8.0

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

package/tools/bin/opencode-adapter.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+# opencode-adapter.sh
+# Adapter implementation for OpenCode (Crush)
+
+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="opencode"
+ADAPTER_NAME="OpenCode (Crush)"
+ADAPTER_TYPE="cloud-api"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${OPENCODE_MODEL:-anthropic/claude-sonnet-4-20250514}"
+
+# OpenCode 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 crush >/dev/null 2>&1; then
+    echo "ERROR: crush CLI not found in PATH"
+    return 1
+  fi
+  
+  # Verify crush can actually run (version check)
+  if ! crush --version >/dev/null 2>&1; then
+    echo "ERROR: crush CLI cannot run (check installation)"
+    return 1
+  fi
+  
+  local version
+  version="$(crush --version 2>/dev/null || true)"
+  if [[ -z "$version" ]]; then
+    echo "WARN: Could not detect crush version"
+  else
+    echo "INFO: Crush version: $version"
+  fi
+  
+  # Verify model is specified
+  if [[ -z "${ADAPTER_MODEL}" ]]; then
+    echo "WARN: No model specified for OpenCode adapter"
+  fi
+  
+  echo "OK: OpenCode 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="${OPENCODE_TIMEOUT_SECONDS:-900}"
+  
+  echo "OpenCode adapter: Running session ${session} with model ${ADAPTER_MODEL}"
+  
+  cd "${worktree}" || return 1
+  
+  prompt="$(cat "${prompt_file}")"
+  
+  if ! timeout "${timeout_seconds}" crush --model "${ADAPTER_MODEL}" "${prompt}" 2>&1; then
+    echo "ERROR: OpenCode run failed"
+    return 1
+  fi
+  
+  return 0
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  adapter_info
+  echo "---"
+  adapter_health_check
+fi

package/tools/bin/pi-adapter.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# pi-adapter.sh
+# Adapter implementation for Pi CLI (OpenRouter)
+
+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="pi"
+ADAPTER_NAME="Pi Coding Agent"
+ADAPTER_TYPE="cloud-api"
+ADAPTER_VERSION="1.0.0"
+ADAPTER_MODEL="${PI_MODEL:-openrouter/qwen/qwen3.5-plus:free}"
+
+# Pi 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 pi >/dev/null 2>&1; then
+    echo "ERROR: pi CLI not found in PATH"
+    return 1
+  fi
+  
+  if [[ -z "${OPENROUTER_API_KEY:-}" ]]; then
+    echo "ERROR: OPENROUTER_API_KEY is required for Pi adapter"
+    return 1
+  fi
+  
+  # Test API connectivity with a simple model list call
+  if ! pi models 2>/dev/null | grep -q "."; then
+    echo "ERROR: Pi CLI cannot connect to OpenRouter API (check OPENROUTER_API_KEY)"
+    return 1
+  fi
+  
+  # Verify configured model is available
+  if [[ -n "${ADAPTER_MODEL}" ]] && ! pi models 2>/dev/null | grep -q "${ADAPTER_MODEL}"; then
+    echo "WARN: Configured model ${ADAPTER_MODEL} not found in available models"
+  fi
+  
+  echo "OK: Pi 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="${PI_TIMEOUT_SECONDS:-900}"
+  
+  echo "Pi adapter: Running session ${session}"
+  
+  cd "${worktree}" || return 1
+  
+  prompt="$(cat "${prompt_file}")"
+  
+  if ! timeout "${timeout_seconds}" pi --model "${ADAPTER_MODEL}" "${prompt}" 2>&1; then
+    echo "ERROR: Pi run failed"
+    return 1
+  fi
+  
+  return 0
+}
+
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  adapter_info
+  echo "---"
+  adapter_health_check
+fi

package/tools/bin/render-flow-config.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "${SCRIPT_DIR}/flow-config-lib.sh"
+
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+PROFILE_REGISTRY_ROOT="$(resolve_flow_profile_registry_root)"
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+# Do NOT export execution env for the current profile here — render-flow-config
+# is meant to render the SELECTED profile's config (via CONFIG_YAML), and exporting
+# the ambient profile's vars into the shell causes config_or_env to silently override
+# per-profile YAML with defaults from the current resident worker's own config.
+# Also, ambient env vars from the shell are cleared below so they don't leak into
+# profile-smoke or other callers.
+for _clean in ACP_CODING_WORKER ACP_OPENCLAW_MODEL ACP_CLAUDE_MODEL \
+  ACP_CLAUDE_TIMEOUT_SECONDS ACP_CLAUDE_MAX_ATTEMPTS ACP_CLAUDE_RETRY_BACKOFF_SECONDS \
+  ACP_OPENCLAW_THINKING ACP_OPENCLAW_TIMEOUT_SECONDS \
+  CODING_WORKER; do
+  unset "${_clean}" 2>/dev/null || true
+done
+unset _clean
+AVAILABLE_PROFILES="$(flow_list_profile_ids "${FLOW_SKILL_DIR}" | paste -sd, -)"
+INSTALLED_PROFILES="$(flow_list_installed_profile_ids | paste -sd, -)"
+PROFILE_ID="$(flow_resolve_adapter_id "${CONFIG_YAML}")"
+PROFILE_SELECTION_MODE="$(flow_profile_selection_mode "${FLOW_SKILL_DIR}")"
+PROFILE_SELECTION_HINT="$(flow_profile_selection_hint "${FLOW_SKILL_DIR}")"
+PROFILE_NOTES="$(flow_resolve_profile_notes_file "${CONFIG_YAML}")"
+
+config_or_env() {
+  local env_names="${1:?env names required}"
+  local config_key="${2:-}"
+  local env_name=""
+  local value=""
+
+  for env_name in ${env_names}; do
+    value="${!env_name:-}"
+    if [[ -n "${value}" ]]; then
+      printf '%s\n' "${value}"
+      return 0
+    fi
+  done
+
+  if [[ -n "${config_key}" && -f "${CONFIG_YAML}" ]]; then
+    flow_config_get "${CONFIG_YAML}" "${config_key}"
+    return 0
+  fi
+
+  printf '\n'
+}
+
+printf 'FLOW_SKILL_DIR=%s\n' "${FLOW_SKILL_DIR}"
+printf 'PROFILE_REGISTRY_ROOT=%s\n' "${PROFILE_REGISTRY_ROOT}"
+printf 'CONFIG_YAML=%s\n' "${CONFIG_YAML}"
+printf 'PROFILE_ID=%s\n' "${PROFILE_ID}"
+printf 'PROFILE_SELECTION_MODE=%s\n' "${PROFILE_SELECTION_MODE}"
+if [[ -n "${PROFILE_SELECTION_HINT}" ]]; then
+  printf 'PROFILE_SELECTION_HINT=%s\n' "${PROFILE_SELECTION_HINT}"
+fi
+printf 'AVAILABLE_PROFILES=%s\n' "${AVAILABLE_PROFILES}"
+printf 'INSTALLED_PROFILES=%s\n' "${INSTALLED_PROFILES}"
+printf 'PROFILE_NOTES=%s\n' "${PROFILE_NOTES}"
+if [[ -f "${PROFILE_NOTES}" ]]; then
+  printf 'PROFILE_NOTES_EXISTS=yes\n'
+else
+  printf 'PROFILE_NOTES_EXISTS=no\n'
+fi
+printf 'EFFECTIVE_REPO_ROOT=%s\n' "$(config_or_env 'ACP_REPO_ROOT' repo.root)"
+printf 'EFFECTIVE_AGENT_REPO_ROOT=%s\n' "$(config_or_env 'ACP_AGENT_REPO_ROOT' runtime.agent_repo_root)"
+printf 'EFFECTIVE_WORKTREE_ROOT=%s\n' "$(config_or_env 'ACP_WORKTREE_ROOT' runtime.worktree_root)"
+printf 'EFFECTIVE_RUNS_ROOT=%s\n' "$(config_or_env 'ACP_RUNS_ROOT' runtime.runs_root)"
+printf 'EFFECTIVE_STATE_ROOT=%s\n' "$(config_or_env 'ACP_STATE_ROOT' runtime.state_root)"
+printf 'EFFECTIVE_RETAINED_REPO_ROOT=%s\n' "$(config_or_env 'ACP_RETAINED_REPO_ROOT' runtime.retained_repo_root)"
+printf 'EFFECTIVE_VSCODE_WORKSPACE_FILE=%s\n' "$(config_or_env 'ACP_VSCODE_WORKSPACE_FILE' runtime.vscode_workspace_file)"
+printf 'EFFECTIVE_CODING_WORKER=%s\n' "$(config_or_env 'ACP_CODING_WORKER' execution.coding_worker)"
+printf 'EFFECTIVE_PROVIDER_QUOTA_COOLDOWNS=%s\n' "$(config_or_env 'ACP_PROVIDER_QUOTA_COOLDOWNS' execution.provider_quota.cooldowns)"
+printf 'EFFECTIVE_PROVIDER_POOL_ORDER=%s\n' "$(config_or_env 'ACP_PROVIDER_POOL_ORDER' execution.provider_pool_order)"
+printf 'EFFECTIVE_PROVIDER_POOL_NAME=%s\n' "$(config_or_env 'ACP_ACTIVE_PROVIDER_POOL_NAME')"
+printf 'EFFECTIVE_PROVIDER_POOL_BACKEND=%s\n' "$(config_or_env 'ACP_ACTIVE_PROVIDER_BACKEND')"
+printf 'EFFECTIVE_PROVIDER_POOL_MODEL=%s\n' "$(config_or_env 'ACP_ACTIVE_PROVIDER_MODEL')"
+printf 'EFFECTIVE_PROVIDER_POOL_KEY=%s\n' "$(config_or_env 'ACP_ACTIVE_PROVIDER_KEY')"
+printf 'EFFECTIVE_PROVIDER_POOLS_EXHAUSTED=%s\n' "$(config_or_env 'ACP_PROVIDER_POOLS_EXHAUSTED')"
+printf 'EFFECTIVE_PROVIDER_POOL_SELECTION_REASON=%s\n' "$(config_or_env 'ACP_PROVIDER_POOL_SELECTION_REASON')"
+printf 'EFFECTIVE_PROVIDER_POOL_NEXT_ATTEMPT_EPOCH=%s\n' "$(config_or_env 'ACP_PROVIDER_POOL_NEXT_ATTEMPT_EPOCH')"
+printf 'EFFECTIVE_PROVIDER_POOL_NEXT_ATTEMPT_AT=%s\n' "$(config_or_env 'ACP_PROVIDER_POOL_NEXT_ATTEMPT_AT')"
+printf 'EFFECTIVE_PROVIDER_POOL_LAST_REASON=%s\n' "$(config_or_env 'ACP_PROVIDER_POOL_LAST_REASON')"
+printf 'EFFECTIVE_CODEX_PROFILE_SAFE=%s\n' "$(config_or_env 'ACP_CODEX_PROFILE_SAFE' execution.safe_profile)"
+printf 'EFFECTIVE_CODEX_PROFILE_BYPASS=%s\n' "$(config_or_env 'ACP_CODEX_PROFILE_BYPASS' execution.bypass_profile)"
+printf 'EFFECTIVE_CLAUDE_MODEL=%s\n' "$(config_or_env 'ACP_CLAUDE_MODEL' execution.claude.model)"
+printf 'EFFECTIVE_CLAUDE_PERMISSION_MODE=%s\n' "$(config_or_env 'ACP_CLAUDE_PERMISSION_MODE' execution.claude.permission_mode)"
+printf 'EFFECTIVE_CLAUDE_EFFORT=%s\n' "$(config_or_env 'ACP_CLAUDE_EFFORT' execution.claude.effort)"
+printf 'EFFECTIVE_CLAUDE_TIMEOUT_SECONDS=%s\n' "$(config_or_env 'ACP_CLAUDE_TIMEOUT_SECONDS' execution.claude.timeout_seconds)"
+printf 'EFFECTIVE_CLAUDE_MAX_ATTEMPTS=%s\n' "$(config_or_env 'ACP_CLAUDE_MAX_ATTEMPTS' execution.claude.max_attempts)"
+printf 'EFFECTIVE_CLAUDE_RETRY_BACKOFF_SECONDS=%s\n' "$(config_or_env 'ACP_CLAUDE_RETRY_BACKOFF_SECONDS' execution.claude.retry_backoff_seconds)"
+printf 'EFFECTIVE_OPENCLAW_MODEL=%s\n' "$(config_or_env 'ACP_OPENCLAW_MODEL' execution.openclaw.model)"
+printf 'EFFECTIVE_OPENCLAW_THINKING=%s\n' "$(config_or_env 'ACP_OPENCLAW_THINKING' execution.openclaw.thinking)"
+printf 'EFFECTIVE_OPENCLAW_TIMEOUT_SECONDS=%s\n' "$(config_or_env 'ACP_OPENCLAW_TIMEOUT_SECONDS' execution.openclaw.timeout_seconds)"

package/tools/bin/run-with-adapter.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# run-with-adapter.sh
+# Generic runner that uses the adapter interface
+# Usage: run-with-adapter.sh ADAPTER_SCRIPT MODE SESSION WORKTREE PROMPT_FILE
+
+set -euo pipefail
+
+ADAPTER_SCRIPT="${1:?usage: run-with-adapter.sh ADAPTER_SCRIPT MODE SESSION WORKTREE PROMPT_FILE}"
+MODE="${2:?usage: run-with-adapter.sh ADAPTER_SCRIPT MODE SESSION WORKTREE PROMPT_FILE}"
+SESSION="${3:?usage: run-with-adapter.sh ADAPTER_SCRIPT MODE SESSION WORKTREE PROMPT_FILE}"
+WORKTREE="${4:?usage: run-with-adapter.sh ADAPTER_SCRIPT MODE SESSION WORKTREE PROMPT_FILE}"
+PROMPT_FILE="${5:?usage: run-with-adapter.sh ADAPTER_SCRIPT MODE SESSION WORKTREE PROMPT_FILE}"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Load adapter interface
+source "${SCRIPT_DIR}/adapter-interface.sh"
+
+# Load adapter implementation
+adapter_load "${ADAPTER_SCRIPT}"
+
+# Validate adapter
+if ! adapter_validate; then
+  echo "ERROR: Adapter validation failed"
+  exit 1
+fi
+
+# Print adapter info
+echo "=== Using Adapter ==="
+adapter_info
+echo "===================="
+
+# Run the task
+adapter_run "${MODE}" "${SESSION}" "${WORKTREE}" "${PROMPT_FILE}"

package/tools/bin/sync-shared-agent-home.sh

@@ -78,6 +78,29 @@ sync_skill_copies() {
   if [[ -n "${TARGET_FLOW_COMPAT_ALIAS}" ]]; then
     sync_tree_into_target "${FLOW_SKILL_SOURCE}" "${TARGET_FLOW_COMPAT_ALIAS}"
   fi
+
+  # Explicitly ensure profile-smoke.sh is synced to runtime home
+  local profile_smoke_source="${FLOW_SKILL_SOURCE}/tools/bin/profile-smoke.sh"
+  local profile_smoke_target="${FLOW_SKILL_TARGET}/tools/bin/profile-smoke.sh"
+  if [[ -f "${profile_smoke_source}" ]]; then
+    mkdir -p "$(dirname "${profile_smoke_target}")"
+    cp "${profile_smoke_source}" "${profile_smoke_target}"
+    chmod +x "${profile_smoke_target}"
+  fi
+
+  # Ensure test scripts are synced for regression coverage
+  for test_script in \
+    "${FLOW_SKILL_SOURCE}/tools/bin/kick-scheduler-wrapper.sh" \
+    "${FLOW_SKILL_SOURCE}/tools/tests/test-kick-scheduler-wrapper.sh" \
+    "${FLOW_SKILL_SOURCE}/tools/tests/test-runtime-operator-smoke.sh" \
+    "${FLOW_SKILL_SOURCE}/tools/tests/test-package-tarball-surface.sh"; do
+    if [[ -f "${test_script}" ]]; then
+      target_script="${FLOW_SKILL_TARGET}${test_script#${FLOW_SKILL_SOURCE}}"
+      mkdir -p "$(dirname "${target_script}")"
+      cp "${test_script}" "${target_script}"
+      chmod +x "${target_script}"
+    fi
+  done
 }
 
 refresh_legacy_profile_templates() {