@triclaps/cli 0.0.6 → 0.0.8

package/docker/hermes-agent-runner/hermes-compat.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "adapter": {
+    "path": "adapters/hermes_claps_adapter.py",
+    "requiredSymbols": [
+      "clarify_request_started",
+      "clarify_request_resolved"
+    ]
+  },
+  "hermes": {
+    "minPythonVersion": "3.11"
+  }
+}

package/docker/hermes-agent-runner/hermes-source.env

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+# Centralized source-build knobs for the minimal Hermes cloud runner.
+# Build args can still override any of these values.
+
+: "${HERMES_GIT_OWNER:=NousResearch}"
+: "${HERMES_GIT_REPO:=Hermes-Agent}"
+: "${HERMES_GIT_REF:=main}"
+: "${HERMES_SOURCE_ARCHIVE_URL:=}"
+
+# Minimal extras needed by the CLAPS Hermes runner.
+# - modal/daytona: preserve runtime delegation backends expected by Hermes
+# - messaging: enable outbound messaging tools and gateway-backed integrations
+# - pty: keep terminal tool behavior aligned with the upstream Linux runtime
+: "${HERMES_PYTHON_EXTRAS:=modal,daytona,messaging,pty}"
+
+# Extra wheels not covered by Hermes core deps but required by our default toolsets.
+# - Pillow: vision tool auto-resize / image re-encoding path
+: "${HERMES_PYPI_EXTRA_PACKAGES:=Pillow}"

package/docker/hermes-agent-runner/install-hermes-source.sh

@@ -0,0 +1,198 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+config_file="${1:-/opt/claps/hermes-source.env}"
+install_root="${2:-/opt/hermes}"
+
+if [[ ! -f "${config_file}" ]]; then
+  echo "[hermes-source] Missing config file: ${config_file}" >&2
+  exit 1
+fi
+
+# shellcheck disable=SC1090
+source "${config_file}"
+
+trim_csv_entry() {
+  local value="${1:-}"
+  value="${value#"${value%%[![:space:]]*}"}"
+  value="${value%"${value##*[![:space:]]}"}"
+  printf '%s' "${value}"
+}
+
+archive_url="${HERMES_SOURCE_ARCHIVE_URL:-}"
+if [[ -z "${archive_url}" ]]; then
+  archive_url="https://github.com/${HERMES_GIT_OWNER}/${HERMES_GIT_REPO}/archive/${HERMES_GIT_REF}.tar.gz"
+fi
+
+workdir="$(mktemp -d)"
+trap 'rm -rf "${workdir}"' EXIT
+
+echo "[hermes-source] Fetching ${archive_url}" >&2
+curl -fsSL "${archive_url}" | tar -xz --strip-components=1 -C "${workdir}"
+
+mkdir -p "${install_root}"
+cp -a "${workdir}/." "${install_root}/"
+
+python_bin="$(command -v python3)"
+
+ensure_uv_available() {
+  if command -v uv >/dev/null 2>&1; then
+    return 0
+  fi
+
+  if [[ "${CLAPS_HERMES_INSTALLER_AUTO_BOOTSTRAP_UV:-0}" != "1" ]]; then
+    return 1
+  fi
+
+  echo "[hermes-source] Bootstrapping uv via pip (CLAPS_HERMES_INSTALLER_AUTO_BOOTSTRAP_UV=1)" >&2
+  "${python_bin}" -m pip install --no-cache-dir "uv>=0.7,<1"
+
+  if command -v uv >/dev/null 2>&1; then
+    return 0
+  fi
+
+  local user_bin
+  user_bin="$("${python_bin}" -m site --user-base 2>/dev/null)/bin"
+  if [[ -x "${user_bin}/uv" ]]; then
+    export PATH="${user_bin}:${PATH}"
+    return 0
+  fi
+
+  return 1
+}
+
+if ensure_uv_available; then
+  installer_backend="uv"
+else
+  installer_backend="pip"
+  echo "[hermes-source] uv not available; falling back to python -m venv + pip (slower)." >&2
+fi
+
+# Hermes requires Python >=3.11. Detect current python3 and decide how to build the venv.
+HERMES_MIN_PYTHON_VERSION="${HERMES_MIN_PYTHON_VERSION:-3.11}"
+
+python_version="$("${python_bin}" -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")' 2>/dev/null || echo "0.0")"
+python_too_old=0
+if ! "${python_bin}" -c "import sys; req=tuple(int(x) for x in '${HERMES_MIN_PYTHON_VERSION}'.split('.')); sys.exit(0 if sys.version_info[:2] >= req else 1)" 2>/dev/null; then
+  python_too_old=1
+fi
+
+if [[ "${python_too_old}" == "1" ]]; then
+  if [[ "${installer_backend}" == "uv" ]]; then
+    echo "[hermes-source] python3 on PATH is ${python_version} (< ${HERMES_MIN_PYTHON_VERSION}); asking uv to auto-resolve a compatible interpreter." >&2
+    venv_python_arg="${HERMES_MIN_PYTHON_VERSION}"
+    # Force uv to use its python-build-standalone distribution rather than any
+    # too-old system interpreter it might still see; this also gives consistent
+    # ABI tags so prebuilt wheels (cbor2, pydantic-core, etc.) match.
+    uv_python_pref="--python-preference=only-managed"
+  else
+    echo "[hermes-source] ERROR: python3 on PATH is ${python_version} but Hermes requires >=${HERMES_MIN_PYTHON_VERSION}." >&2
+    echo "[hermes-source] Install Python ${HERMES_MIN_PYTHON_VERSION}+ (e.g. via brew/conda) or install uv (https://docs.astral.sh/uv/) so the installer can auto-provision a compatible interpreter." >&2
+    exit 1
+  fi
+else
+  venv_python_arg="${python_bin}"
+  uv_python_pref=""
+fi
+
+if [[ "${installer_backend}" == "uv" ]]; then
+  if [[ -n "${uv_python_pref}" ]]; then
+    uv venv "${install_root}/.venv" --python "${venv_python_arg}" "${uv_python_pref}"
+  else
+    uv venv "${install_root}/.venv" --python "${venv_python_arg}"
+  fi
+else
+  "${python_bin}" -m venv "${install_root}/.venv"
+  "${install_root}/.venv/bin/pip" install --no-cache-dir --upgrade pip
+fi
+
+extras_spec=""
+IFS=',' read -r -a hermes_extras <<<"${HERMES_PYTHON_EXTRAS:-}"
+normalized_extras=()
+for extra in "${hermes_extras[@]}"; do
+  trimmed_extra="$(trim_csv_entry "${extra}")"
+  if [[ -n "${trimmed_extra}" ]]; then
+    normalized_extras+=("${trimmed_extra}")
+  fi
+done
+
+if [[ ${#normalized_extras[@]} -gt 0 ]]; then
+  extras_spec="["
+  for extra in "${normalized_extras[@]}"; do
+    if [[ "${extras_spec}" != "[" ]]; then
+      extras_spec+=","
+    fi
+    extras_spec+="${extra}"
+  done
+  extras_spec+="]"
+fi
+
+if [[ "${installer_backend}" == "uv" ]]; then
+  uv pip install --python "${install_root}/.venv/bin/python" "${install_root}${extras_spec}"
+else
+  "${install_root}/.venv/bin/pip" install --no-cache-dir "${install_root}${extras_spec}"
+fi
+
+extra_packages=()
+IFS=',' read -r -a pypi_packages <<<"${HERMES_PYPI_EXTRA_PACKAGES:-}"
+for package in "${pypi_packages[@]}"; do
+  trimmed_package="$(trim_csv_entry "${package}")"
+  if [[ -n "${trimmed_package}" ]]; then
+    extra_packages+=("${trimmed_package}")
+  fi
+done
+
+if [[ ${#extra_packages[@]} -gt 0 ]]; then
+  if [[ "${installer_backend}" == "uv" ]]; then
+    uv pip install --python "${install_root}/.venv/bin/python" "${extra_packages[@]}"
+  else
+    "${install_root}/.venv/bin/pip" install --no-cache-dir "${extra_packages[@]}"
+  fi
+fi
+
+# Optional: install Hermes' npm-side deps (agent-browser, camofox-browser).
+# These power the browser tool. Cloud images skip this stage to keep size down.
+node_install_mode="none"
+if [[ -f "${install_root}/package.json" && "${CLAPS_HERMES_INSTALLER_SKIP_NODE:-0}" != "1" ]]; then
+  if command -v pnpm >/dev/null 2>&1; then
+    echo "[hermes-source] Installing Hermes npm deps via pnpm" >&2
+    (cd "${install_root}" && pnpm install --prod --silent --no-frozen-lockfile)
+    node_install_mode="pnpm"
+  elif command -v npm >/dev/null 2>&1; then
+    echo "[hermes-source] Installing Hermes npm deps via npm" >&2
+    (cd "${install_root}" && npm install --omit=dev --silent --no-audit --no-fund)
+    node_install_mode="npm"
+  else
+    echo "[hermes-source] No pnpm/npm on PATH; skipping browser tool install. Install pnpm/npm and re-run with --repair to enable browser tools." >&2
+  fi
+fi
+
+# Cleanup directories that are not used at runtime. Preserve node_modules
+# only when we just installed it; otherwise wipe whatever shipped in the tarball.
+keep_node_modules=0
+if [[ "${node_install_mode}" != "none" ]]; then
+  keep_node_modules=1
+fi
+
+cleanup_targets=(
+  "${install_root}/.playwright"
+  "${install_root}/optional-skills"
+  "${install_root}/tests"
+  "${install_root}/tui_gateway"
+  "${install_root}/ui-tui"
+  "${install_root}/web"
+  "${install_root}/website"
+)
+if [[ "${keep_node_modules}" -eq 0 ]]; then
+  cleanup_targets+=("${install_root}/node_modules")
+fi
+rm -rf "${cleanup_targets[@]}"
+
+# Marker for the TS layer to know what we installed.
+cat >"${install_root}/.install-state.json" <<JSON
+{
+  "pythonBackend": "${installer_backend}",
+  "nodeInstallMode": "${node_install_mode}"
+}
+JSON