1#!/usr/bin/env bash
2# verify-environment.sh
3# Verifies the local environment for creating a hosted Foundry agent with `azd ai`.
4# Runs all the read-only checks in one pass and prints a single concise summary,
5# so the agent does not have to run (and reason over) each azd command separately.
6#
7# Usage:
8#   ./verify-environment.sh
9#
10# Output: human-readable summary lines, each prefixed with [OK], [WARN], or [ACTION].
11# Exit code: 0 if no blocking actions, 1 if at least one [ACTION] is required.
12 
13set -uo pipefail
14 
15ACTION_REQUIRED=0
16 
17note_ok()     { echo "[OK] $1"; }
18note_warn()   { echo "[WARN] $1"; }
19note_action() { echo "[ACTION] $1"; ACTION_REQUIRED=1; }
20 
21# Refresh PATH to pick up recently-installed tools (e.g. azd installed in same session)
22if [ -f /etc/environment ]; then
23  # shellcheck disable=SC1091
24  . /etc/environment 2>/dev/null || true
25fi
26hash -r 2>/dev/null || true
27 
28# 1. azd present + version
29if ! command -v azd >/dev/null 2>&1; then
30  note_action "Azure Developer CLI (azd) is not installed. Install it from https://aka.ms/azd-install, then re-run."
31  echo ""
32  echo "Summary: azd missing -- cannot continue."
33  exit 1
34fi
35 
36AZD_VERSION="$(azd version --output json 2>/dev/null | python3 -c 'import json,sys; print(json.load(sys.stdin).get("azd",{}).get("version","unknown"))' 2>/dev/null || echo unknown)"
37note_ok "azd installed (version ${AZD_VERSION})."
38 
39# 2. Required extensions
40EXT_JSON="$(azd extension list --output json 2>/dev/null || echo '[]')"
41for ext in azure.ai.agents azure.ai.projects; do
42  if printf '%s' "$EXT_JSON" | grep -q "$ext"; then
43    note_ok "Extension '$ext' is installed."
44  else
45    note_action "Extension '$ext' is missing. Run: azd extension install $ext"
46  fi
47done
48 
49# 3. Auth status
50if azd auth login --check-status >/dev/null 2>&1; then
51  note_ok "Logged in to azd."
52else
53  note_action "Not logged in. Ask the user to run 'azd auth login' (it opens a browser; never run it for them)."
54fi
55 
56# 4. Foundry project endpoint (optional at this stage)
57# Short-circuit when there's no azd project in cwd: `azd ai project show` / `agent show`
58# would just return nothing after a ~3s subprocess each.
59if [ ! -f "azure.yaml" ]; then
60  note_warn "No Foundry project endpoint set yet. A new project will be created at provision/deploy time, or supply an existing project resource ID."
61  note_ok "No agent deployed yet. Proceed with create."
62else
63  PROJECT_JSON="$(azd ai project show --output json 2>/dev/null || echo '')"
64  ENDPOINT=""
65  if [ -n "$PROJECT_JSON" ]; then
66    ENDPOINT="$(printf '%s' "$PROJECT_JSON" | python3 -c 'import json,sys
67try:
68    d=json.load(sys.stdin)
69except Exception:
70    print(""); raise SystemExit
71if isinstance(d,dict):
72    for k in ("endpoint","projectEndpoint","aiProjectEndpoint"):
73        if d.get(k):
74            print(d[k]); break
75' 2>/dev/null)"
76  fi
77  if [ -n "$ENDPOINT" ]; then
78    note_ok "Foundry project endpoint configured: ${ENDPOINT}"
79  else
80    note_warn "No Foundry project endpoint set yet. A new project will be created at provision/deploy time, or supply an existing project resource ID."
81  fi
82 
83  # 5. Agent deployment status
84  AGENT_JSON="$(azd ai agent show --output json 2>/dev/null || echo '')"
85  if [ -n "$AGENT_JSON" ]; then
86    STATUS="$(printf '%s' "$AGENT_JSON" | python3 -c 'import json,sys
87try:
88    d=json.load(sys.stdin)
89except Exception:
90    print("unknown"); raise SystemExit
91print(d.get("status","unknown") if isinstance(d,dict) else "unknown")' 2>/dev/null)"
92    case "$STATUS" in
93      active|deployed) note_ok "An agent is already deployed (status: ${STATUS}). Skip to deploy.md to redeploy, or tools to add a tool." ;;
94      not_deployed)    note_ok "No agent deployed yet (status: not_deployed). Proceed with create." ;;
95      *)               note_warn "Agent status: ${STATUS}." ;;
96    esac
97  else
98    note_ok "No agent deployed yet. Proceed with create."
99  fi
100fi
101 
102echo ""
103if [ "$ACTION_REQUIRED" -eq 1 ]; then
104  echo "Summary: action required -- resolve the [ACTION] items above before continuing."
105  exit 1
106else
107  echo "Summary: environment ready for 'azd ai' hosted-agent creation."
108  exit 0
109fi
110