ops:home-agent

OPS:HOME AGENT — Homey Pro probe

Read-only probe for a Homey Pro hub. Given a scope, query the Homey local API (preferred) with cloud-API fallback, and return structured JSON.

Input

The calling skill provides:

• SCOPE: devices | flows | energy | presence | alarms | zones
• Credentials are resolved from the same sources as ops-home: preferences.json → env vars → Doppler (homey-pro) → keychain.

Phase 1 — Resolve credentials

PREFS_PATH="${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json"
_save_HOMEY_LOCAL_URL="${HOMEY_LOCAL_URL-}"
_save_HOMEY_LOCAL_TOKEN="${HOMEY_LOCAL_TOKEN-}"
_save_HOMEY_CLOUD_TOKEN="${HOMEY_CLOUD_TOKEN-}"
_save_HOMEY_ID="${HOMEY_ID-}"
HOMEY_LOCAL_URL=$(jq -r '.home_automation.homey_local_url // empty' "$PREFS_PATH" 2>/dev/null)
HOMEY_LOCAL_TOKEN=$(jq -r '.home_automation.homey_local_token // empty' "$PREFS_PATH" 2>/dev/null)
HOMEY_CLOUD_TOKEN=$(jq -r '.home_automation.homey_cloud_token // empty' "$PREFS_PATH" 2>/dev/null)
HOMEY_ID=$(jq -r '.home_automation.homey_id // empty' "$PREFS_PATH" 2>/dev/null)

[ -z "$HOMEY_LOCAL_URL" ] && HOMEY_LOCAL_URL="${_save_HOMEY_LOCAL_URL:-}"
[ -z "$HOMEY_LOCAL_TOKEN" ] && HOMEY_LOCAL_TOKEN="${_save_HOMEY_LOCAL_TOKEN:-}"
[ -z "$HOMEY_CLOUD_TOKEN" ] && HOMEY_CLOUD_TOKEN="${_save_HOMEY_CLOUD_TOKEN:-${HOMEY_ACCESS_TOKEN:-}}"
[ -z "$HOMEY_ID" ] && HOMEY_ID="${_save_HOMEY_ID:-}"

If neither local nor cloud credentials resolve, return:

{ "scope": "<scope>", "error": "no credentials", "fallback_attempted": false }

Phase 2 — Probe (try local, fall back to cloud)

probe() {
  local local_path="$1" cloud_path="$2"
  local resp http_code
  if [ -n "$HOMEY_LOCAL_URL" ] && [ -n "$HOMEY_LOCAL_TOKEN" ]; then
    http_code=$(curl -s -o /tmp/homey_resp -w "%{http_code}" \
      -H "Authorization: Bearer ${HOMEY_LOCAL_TOKEN}" \
      "${HOMEY_LOCAL_URL}/api/manager${local_path}" --max-time 5 2>/dev/null)
    if [ "$http_code" -ge 200 ] && [ "$http_code" -lt 300 ]; then
      cat /tmp/homey_resp
      echo "TRANSPORT=local" >&2
      return 0
    fi
  fi
  if [ -n "$HOMEY_CLOUD_TOKEN" ] && [ -n "$HOMEY_ID" ]; then
    curl -s -H "Authorization: Bearer ${HOMEY_CLOUD_TOKEN}" \
      "https://api.athom.com/v2/homey/${HOMEY_ID}${cloud_path}" --max-time 10
    echo "TRANSPORT=cloud" >&2
    return 0
  fi
  echo '{"error":"no transport"}'
  return 1
}