agent-control-plane 0.1.0

package/tools/bin/project-launchd-bootstrap.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FLOW_SKILL_DIR="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+HOME_DIR="${ACP_PROJECT_RUNTIME_HOME_DIR:-${HOME:-}}"
+SOURCE_HOME="${ACP_PROJECT_RUNTIME_SOURCE_HOME:-$(cd "${FLOW_SKILL_DIR}/../../.." && pwd)}"
+RUNTIME_HOME="${ACP_PROJECT_RUNTIME_RUNTIME_HOME:-${HOME_DIR}/.agent-runtime/runtime-home}"
+PROFILE_REGISTRY_ROOT="${ACP_PROJECT_RUNTIME_PROFILE_REGISTRY_ROOT:-${ACP_PROFILE_REGISTRY_ROOT:-${HOME_DIR}/.agent-runtime/control-plane/profiles}}"
+PROFILE_ID="${ACP_PROJECT_RUNTIME_PROFILE_ID:-${ACP_PROJECT_ID:-${AGENT_PROJECT_ID:-}}}"
+ENV_FILE="${ACP_PROJECT_RUNTIME_ENV_FILE:-${PROFILE_REGISTRY_ROOT}/${PROFILE_ID}/runtime.env}"
+BASE_PATH="${ACP_PROJECT_RUNTIME_PATH:-/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin}"
+SYNC_SCRIPT="${ACP_PROJECT_RUNTIME_SYNC_SCRIPT:-${FLOW_SKILL_DIR}/tools/bin/sync-shared-agent-home.sh}"
+RUNTIME_HEARTBEAT_SCRIPT="${ACP_PROJECT_RUNTIME_HEARTBEAT_SCRIPT:-${RUNTIME_HOME}/skills/openclaw/agent-control-plane/tools/bin/heartbeat-safe-auto.sh}"
+ALWAYS_SYNC="${ACP_PROJECT_RUNTIME_ALWAYS_SYNC:-0}"
+
+if [[ -z "${HOME_DIR}" ]]; then
+  echo "project launchd bootstrap requires HOME or ACP_PROJECT_RUNTIME_HOME_DIR" >&2
+  exit 64
+fi
+
+if [[ -z "${PROFILE_ID}" ]]; then
+  echo "project launchd bootstrap requires ACP_PROJECT_RUNTIME_PROFILE_ID or ACP_PROJECT_ID" >&2
+  exit 64
+fi
+
+export HOME="${HOME_DIR}"
+export PATH="${BASE_PATH}"
+export ACP_PROFILE_REGISTRY_ROOT="${PROFILE_REGISTRY_ROOT}"
+export ACP_PROJECT_ID="${PROFILE_ID}"
+export AGENT_PROJECT_ID="${PROFILE_ID}"
+
+if [[ -f "${ENV_FILE}" ]]; then
+  set -a
+  # shellcheck source=/dev/null
+  source "${ENV_FILE}"
+  set +a
+fi
+
+if [[ ! -x "${SYNC_SCRIPT}" ]]; then
+  echo "project launchd bootstrap missing sync script: ${SYNC_SCRIPT}" >&2
+  exit 65
+fi
+
+if [[ "${ALWAYS_SYNC}" == "1" || ! -x "${RUNTIME_HEARTBEAT_SCRIPT}" ]]; then
+  bash "${SYNC_SCRIPT}" "${SOURCE_HOME}" "${RUNTIME_HOME}" >/dev/null
+fi
+
+if [[ ! -x "${RUNTIME_HEARTBEAT_SCRIPT}" ]]; then
+  echo "project launchd bootstrap missing runtime heartbeat: ${RUNTIME_HEARTBEAT_SCRIPT}" >&2
+  exit 66
+fi
+
+exec bash "${RUNTIME_HEARTBEAT_SCRIPT}"

package/tools/bin/project-remove.sh

@@ -0,0 +1,155 @@
+#!/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"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  project-remove.sh --profile-id <id> [options]
+
+Remove one installed profile from agent-control-plane. This stops the profile's
+runtime first, then deletes the installed profile directory and ACP-managed
+runtime roots. Repo/worktree/retained paths are only deleted when they look
+like ACP-managed temp paths or when --purge-paths is supplied.
+
+Options:
+  --profile-id <id>      Profile id to remove
+  --purge-paths          Also delete repo/worktree/retained/workspace paths
+  --skip-stop            Skip project-runtimectl stop before deletion
+  --help                 Show this help
+EOF
+}
+
+profile_id_override=""
+purge_paths="0"
+skip_stop="0"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --profile-id) profile_id_override="${2:-}"; shift 2 ;;
+    --purge-paths) purge_paths="1"; shift ;;
+    --skip-stop) skip_stop="1"; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown argument: $1" >&2; usage >&2; exit 64 ;;
+  esac
+done
+
+if [[ -z "${profile_id_override}" ]]; then
+  usage >&2
+  exit 64
+fi
+
+export ACP_PROJECT_ID="${profile_id_override}"
+export AGENT_PROJECT_ID="${profile_id_override}"
+
+FLOW_SKILL_DIR="$(resolve_flow_skill_dir "${BASH_SOURCE[0]}")"
+CONFIG_YAML="$(resolve_flow_config_yaml "${BASH_SOURCE[0]}")"
+if [[ ! -f "${CONFIG_YAML}" ]]; then
+  printf 'profile not installed: %s\n' "${profile_id_override}" >&2
+  exit 66
+fi
+PROFILE_ID="$(flow_resolve_adapter_id "${CONFIG_YAML}")"
+PROFILE_REGISTRY_ROOT="$(resolve_flow_profile_registry_root)"
+PROFILE_DIR="$(dirname "${CONFIG_YAML}")"
+REPO_ROOT="$(flow_resolve_repo_root "${CONFIG_YAML}")"
+AGENT_ROOT="$(flow_resolve_agent_root "${CONFIG_YAML}")"
+RUNS_ROOT="$(flow_resolve_runs_root "${CONFIG_YAML}")"
+STATE_ROOT="$(flow_resolve_state_root "${CONFIG_YAML}")"
+HISTORY_ROOT="$(flow_resolve_history_root "${CONFIG_YAML}")"
+WORKTREE_ROOT="$(flow_resolve_worktree_root "${CONFIG_YAML}")"
+RETAINED_REPO_ROOT="$(flow_resolve_retained_repo_root "${CONFIG_YAML}")"
+VSCODE_WORKSPACE_FILE="$(flow_resolve_vscode_workspace_file "${CONFIG_YAML}")"
+PROJECT_RUNTIMECTL="${ACP_PROJECT_REMOVE_RUNTIMECTL_SCRIPT:-${FLOW_SKILL_DIR}/tools/bin/project-runtimectl.sh}"
+PROJECT_LAUNCHD_UNINSTALL="${ACP_PROJECT_REMOVE_LAUNCHD_UNINSTALL_SCRIPT:-${FLOW_SKILL_DIR}/tools/bin/uninstall-project-launchd.sh}"
+
+managed_tmp_prefix="/tmp/agent-control-plane-${PROFILE_ID}"
+managed_runtime_prefix="${HOME}/.agent-runtime"
+
+path_exists() {
+  local path="${1:-}"
+  [[ -n "${path}" && -e "${path}" ]]
+}
+
+path_is_managed() {
+  local path="${1:-}"
+  [[ -n "${path}" ]] || return 1
+  case "${path}" in
+    "${managed_tmp_prefix}"|"${managed_tmp_prefix}/"*|\
+    "${managed_runtime_prefix}"|"${managed_runtime_prefix}/"*)
+      return 0
+      ;;
+  esac
+  return 1
+}
+
+remove_path_if_present() {
+  local path="${1:-}"
+  [[ -n "${path}" ]] || return 0
+  if [[ -L "${path}" || -f "${path}" ]]; then
+    rm -f "${path}"
+  elif [[ -d "${path}" ]]; then
+    rm -rf "${path}"
+  fi
+}
+
+removed_paths=""
+skipped_paths=""
+
+record_removed() {
+  local path="${1:-}"
+  [[ -n "${path}" ]] || return 0
+  removed_paths="${removed_paths}${removed_paths:+$'\n'}${path}"
+}
+
+record_skipped() {
+  local path="${1:-}"
+  [[ -n "${path}" ]] || return 0
+  skipped_paths="${skipped_paths}${skipped_paths:+$'\n'}${path}"
+}
+
+delete_owned_path() {
+  local path="${1:-}"
+  path_exists "${path}" || return 0
+  remove_path_if_present "${path}"
+  record_removed "${path}"
+}
+
+delete_optional_path() {
+  local path="${1:-}"
+  path_exists "${path}" || return 0
+  if [[ "${purge_paths}" == "1" ]] || path_is_managed "${path}"; then
+    remove_path_if_present "${path}"
+    record_removed "${path}"
+  else
+    record_skipped "${path}"
+  fi
+}
+
+if [[ "${skip_stop}" != "1" ]]; then
+  bash "${PROJECT_RUNTIMECTL}" stop --profile-id "${PROFILE_ID}" >/dev/null
+fi
+
+if [[ -x "${PROJECT_LAUNCHD_UNINSTALL}" ]]; then
+  bash "${PROJECT_LAUNCHD_UNINSTALL}" --profile-id "${PROFILE_ID}" >/dev/null 2>&1 || true
+fi
+
+delete_owned_path "${RUNS_ROOT}"
+delete_owned_path "${STATE_ROOT}"
+delete_owned_path "${HISTORY_ROOT}"
+delete_owned_path "${AGENT_ROOT}"
+delete_optional_path "${WORKTREE_ROOT}"
+delete_optional_path "${RETAINED_REPO_ROOT}"
+delete_optional_path "${VSCODE_WORKSPACE_FILE}"
+delete_optional_path "${REPO_ROOT}"
+delete_owned_path "${PROFILE_DIR}"
+
+printf 'PROJECT_REMOVE_STATUS=ok\n'
+printf 'PROFILE_ID=%s\n' "${PROFILE_ID}"
+printf 'PROFILE_REGISTRY_ROOT=%s\n' "${PROFILE_REGISTRY_ROOT}"
+printf 'PURGE_PATHS=%s\n' "${purge_paths}"
+printf 'SKIP_STOP=%s\n' "${skip_stop}"
+printf 'REMOVED_PATHS=%s\n' "$(printf '%s\n' "${removed_paths}" | awk 'NF {printf "%s%s", sep, $0; sep=","} END {print ""}')"
+printf 'SKIPPED_PATHS=%s\n' "$(printf '%s\n' "${skipped_paths}" | awk 'NF {printf "%s%s", sep, $0; sep=","} END {print ""}')"

package/tools/bin/project-runtime-supervisor.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage:
+  project-runtime-supervisor.sh --bootstrap-script <path> --pid-file <path> [--delay-seconds <n>] [--interval-seconds <n>]
+
+Keep invoking a project bootstrap script in a long-lived loop and expose the
+supervisor pid through a pid file for `project-runtimectl`.
+EOF
+}
+
+bootstrap_script=""
+pid_file=""
+delay_seconds="0"
+interval_seconds="15"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --bootstrap-script) bootstrap_script="${2:-}"; shift 2 ;;
+    --pid-file) pid_file="${2:-}"; shift 2 ;;
+    --delay-seconds) delay_seconds="${2:-}"; shift 2 ;;
+    --interval-seconds) interval_seconds="${2:-}"; shift 2 ;;
+    --help|-h) usage; exit 0 ;;
+    *) echo "Unknown argument: $1" >&2; usage >&2; exit 64 ;;
+  esac
+done
+
+if [[ -z "${bootstrap_script}" || -z "${pid_file}" ]]; then
+  usage >&2
+  exit 64
+fi
+
+case "${delay_seconds}" in
+  ''|*[!0-9]*) echo "--delay-seconds must be numeric" >&2; exit 64 ;;
+esac
+
+case "${interval_seconds}" in
+  ''|*[!0-9]*) echo "--interval-seconds must be numeric" >&2; exit 64 ;;
+esac
+
+mkdir -p "$(dirname "${pid_file}")"
+printf '%s\n' "$$" >"${pid_file}"
+trap 'rm -f "${pid_file}"' EXIT
+trap '' HUP
+
+first_pass="1"
+while true; do
+  if [[ "${first_pass}" == "1" && "${delay_seconds}" != "0" ]]; then
+    sleep "${delay_seconds}"
+  fi
+  first_pass="0"
+  "${bootstrap_script}" >/dev/null 2>&1 || true
+  sleep "${interval_seconds}"
+done