1<#
2.SYNOPSIS
3    Verifies the local environment for creating a hosted Foundry agent with `azd ai`.
4.DESCRIPTION
5    Runs all the read-only checks in one pass and prints a single concise summary,
6    so the agent does not have to run (and reason over) each azd command separately.
7 
8    Output lines are prefixed with [OK], [WARN], or [ACTION].
9    Exit code is 0 when no blocking actions remain, 1 when at least one [ACTION] is required.
10.EXAMPLE
11    ./verify-environment.ps1
12#>
13 
14$ErrorActionPreference = "Stop"
15$actionRequired = $false
16 
17function Note-Ok     { param([string]$m) Write-Output "[OK] $m" }
18function Note-Warn   { param([string]$m) Write-Output "[WARN] $m" }
19function Note-Action { param([string]$m) Write-Output "[ACTION] $m"; $script:actionRequired = $true }
20 
21function Get-AzdJson {
22    param([string[]]$AzdArgs)
23    try {
24        $raw = & azd @AzdArgs 2>$null
25        if (-not $raw) { return $null }
26        return ($raw | ConvertFrom-Json -ErrorAction Stop)
27    } catch {
28        return $null
29    }
30}
31 
32# Refresh PATH to pick up recently-installed tools (e.g. azd installed in same session)
33$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
34 
35# 1. azd present + version
36# Check PATH first, then probe common install locations (winget, MSI, chocolatey)
37if (-not (Get-Command azd -ErrorAction SilentlyContinue)) {
38    $azdFallbackPaths = @(
39        "$env:LOCALAPPDATA\Programs\Azure Dev CLI"
40        "$env:ProgramFiles\Azure Dev CLI"
41        "${env:ProgramFiles(x86)}\Azure Dev CLI"
42        "$env:USERPROFILE\.azd\bin"
43    )
44    $found = $false
45    foreach ($dir in $azdFallbackPaths) {
46        if (Test-Path "$dir\azd.exe") {
47            $env:Path = "$dir;$env:Path"
48            Note-Warn "azd found at '$dir' but was not on PATH. Added automatically for this session."
49            $found = $true
50            break
51        }
52    }
53    if (-not $found) {
54        Note-Action "Azure Developer CLI (azd) is not installed. Install it from https://aka.ms/azd-install, then re-run."
55        Write-Output ""
56        Write-Output "Summary: azd missing -- cannot continue."
57        exit 1
58    }
59}
60 
61$verJson = Get-AzdJson @("version", "--output", "json")
62$azdVersion = if ($verJson -and $verJson.azd -and $verJson.azd.version) { $verJson.azd.version } else { "unknown" }
63Note-Ok "azd installed (version $azdVersion)."
64 
65# 2. Required extensions
66$extRaw = (& azd extension list --output json 2>$null) -join "`n"
67foreach ($ext in @("azure.ai.agents", "azure.ai.projects")) {
68    if ($extRaw -match [regex]::Escape($ext)) {
69        Note-Ok "Extension '$ext' is installed."
70    } else {
71        Note-Action "Extension '$ext' is missing. Run: azd extension install $ext"
72    }
73}
74 
75# 3. Auth status
76& azd auth login --check-status *> $null
77if ($LASTEXITCODE -eq 0) {
78    Note-Ok "Logged in to azd."
79} else {
80    Note-Action "Not logged in. Ask the user to run 'azd auth login' (it opens a browser; never run it for them)."
81}
82 
83# 4. Foundry project endpoint (optional at this stage)
84# Short-circuit when there's no azd project in cwd: `azd ai project show` / `agent show`
85# would just return nothing after a ~3s subprocess each.
86if (-not (Test-Path "azure.yaml")) {
87    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."
88    Note-Ok "No agent deployed yet. Proceed with create."
89} else {
90    $projectJson = Get-AzdJson @("ai", "project", "show", "--output", "json")
91    $endpoint = $null
92    if ($projectJson) {
93        foreach ($k in @("endpoint", "projectEndpoint", "aiProjectEndpoint")) {
94            if ($projectJson.PSObject.Properties.Name -contains $k -and $projectJson.$k) {
95                $endpoint = $projectJson.$k
96                break
97            }
98        }
99    }
100    if ($endpoint) {
101        Note-Ok "Foundry project endpoint configured: $endpoint"
102    } else {
103        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."
104    }
105 
106    # 5. Agent deployment status
107    $agentJson = Get-AzdJson @("ai", "agent", "show", "--output", "json")
108    if ($agentJson) {
109        $status = if ($agentJson.PSObject.Properties.Name -contains "status" -and $agentJson.status) { $agentJson.status } else { "unknown" }
110        switch ($status) {
111            { $_ -in @("active", "deployed") } { Note-Ok "An agent is already deployed (status: $status). Skip to deploy.md to redeploy, or tools to add a tool." }
112            "not_deployed"                     { Note-Ok "No agent deployed yet (status: not_deployed). Proceed with create." }
113            default                            { Note-Warn "Agent status: $status." }
114        }
115    } else {
116        Note-Ok "No agent deployed yet. Proceed with create."
117    }
118}
119 
120Write-Output ""
121if ($actionRequired) {
122    Write-Output "Summary: action required -- resolve the [ACTION] items above before continuing."
123    exit 1
124} else {
125    Write-Output "Summary: environment ready for 'azd ai' hosted-agent creation."
126    exit 0
127}
128