@ivannxbt/ai-config 0.1.0

package/.agents/skills/microsoft-foundry/models/deploy-model/TEST_PROMPTS.md

@@ -0,0 +1,78 @@
+# Deploy Model — Test Prompts
+
+Test prompts for the unified `deploy-model` skill with router, preset, customize, and capacity sub-skills.
+
+## Preset Mode (Quick Deploy)
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 1 | Deploy gpt-4o | Preset — confirm project, deploy with defaults |
+| 2 | Set up o3-mini for me | Preset — pick latest version automatically |
+| 3 | I need a text-embedding-ada-002 deployment | Preset — non-chat model |
+| 4 | Deploy gpt-4o to the best region | Preset — region scan, no capacity target |
+
+## Customize Mode (Guided Flow)
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 5 | Deploy gpt-4o with custom settings | Customize — walk through version → SKU → capacity → RAI |
+| 6 | I want to choose the version and SKU for my o3-mini deployment | Customize — explicit keywords |
+| 7 | Set up a PTU deployment for gpt-4o | Customize — PTU requires SKU selection |
+| 8 | Deploy gpt-4o with a specific content filter | Customize — RAI policy flow |
+
+## Capacity Discovery
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 9 | Where can I deploy gpt-4o? | Capacity — show regions, no deploy |
+| 10 | Which regions have o3-mini available? | Capacity — run script, show table |
+| 11 | Check if I have enough quota for gpt-4o with 500K TPM | Capacity — high target, some regions may not qualify |
+
+## Chained (Capacity → Deploy)
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 12 | Find me the best region and project to deploy gpt-4o with 10K capacity | Capacity → Preset |
+| 13 | Deploy o3-mini with 200K TPM to whatever region has it | Capacity → Preset |
+| 14 | I want to deploy gpt-4o with 50K capacity and choose my own settings | Capacity → Customize |
+
+## Negative / Edge Cases
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 15 | Deploy unicorn-model-9000 | Fail gracefully — model doesn't exist |
+| 16 | Deploy gpt-4o with 999999K TPM | Capacity shows no region qualifies |
+| 17 | Deploy gpt-4o (with az login expired) | Auth error caught early |
+| 18 | Delete my gpt-4o deployment | Should NOT trigger deploy-model |
+| 19 | List my current deployments | Should NOT trigger deploy-model |
+| 20 | Deploy gpt-4o to mars-region-1 | Fail gracefully — invalid region |
+
+## Project Selection
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 21 | Deploy gpt-4o (with PROJECT_RESOURCE_ID set) | Show current project, confirm before deploying |
+| 22 | Deploy gpt-4o (no PROJECT_RESOURCE_ID) | Ask user to pick a project |
+| 23 | Deploy gpt-4o to project my-special-project | Use named project directly |
+
+## Ambiguous / Routing Stress
+
+| # | Prompt | Expected |
+|---|--------|----------|
+| 24 | Help me with model deployment | Preset (default) — vague, no keywords |
+| 25 | I need gpt-4o deployed fast with good capacity | Preset — "fast" + vague capacity |
+| 26 | Can you configure a deployment? | Customize — "configure" keyword, should ask which model |
+| 27 | What's the best way to deploy gpt-4o with 100K? | Capacity → Preset |
+
+## Automated Test Results (2026-02-09)
+
+All 18 tests passed. Deployments created during testing were cleaned up.
+
+| Category | Tests | Result |
+|----------|-------|--------|
+| Preset | 3/3 | ✅ |
+| Customize | 2/2 | ✅ |
+| Capacity | 3/3 | ✅ |
+| Chained | 1/1 | ✅ |
+| Negative | 5/5 | ✅ |
+| Ambiguous | 4/4 | ✅ |

package/.agents/skills/microsoft-foundry/models/deploy-model/capacity/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: capacity
+description: "Discovers available Azure OpenAI model capacity across regions and projects. Analyzes quota limits, compares availability, and recommends optimal deployment locations based on capacity requirements. USE FOR: find capacity, check quota, where can I deploy, capacity discovery, best region for capacity, multi-project capacity search, quota analysis, model availability, region comparison, check TPM availability. DO NOT USE FOR: actual deployment (hand off to preset or customize after discovery), quota increase requests (direct user to Azure Portal), listing existing deployments."
+license: MIT
+metadata:
+  author: Microsoft
+  version: "1.0.0"
+---
+
+# Capacity Discovery
+
+Finds available Azure OpenAI model capacity across all accessible regions and projects. Recommends the best deployment location based on capacity requirements.
+
+## Quick Reference
+
+| Property | Description |
+|----------|-------------|
+| **Purpose** | Find where you can deploy a model with sufficient capacity |
+| **Scope** | All regions and projects the user has access to |
+| **Output** | Ranked table of regions/projects with available capacity |
+| **Action** | Read-only analysis — does NOT deploy. Hands off to preset or customize |
+| **Authentication** | Azure CLI (`az login`) |
+
+## When to Use This Skill
+
+- ✅ User asks "where can I deploy gpt-4o?"
+- ✅ User specifies a capacity target: "find a region with 10K TPM for gpt-4o"
+- ✅ User wants to compare availability: "which regions have gpt-4o available?"
+- ✅ User got a quota error and needs to find an alternative location
+- ✅ User asks "best region and project for deploying model X"
+
+**After discovery → hand off to [preset](../preset/SKILL.md) or [customize](../customize/SKILL.md) for actual deployment.**
+
+## Scripts
+
+Pre-built scripts handle the complex REST API calls and data processing. Use these instead of constructing commands manually.
+
+| Script | Purpose | Usage |
+|--------|---------|-------|
+| `scripts/discover_and_rank.ps1` | Full discovery: capacity + projects + ranking | Primary script for capacity discovery |
+| `scripts/discover_and_rank.sh` | Same as above (bash) | Primary script for capacity discovery |
+| `scripts/query_capacity.ps1` | Raw capacity query (no project matching) | Quick capacity check or version listing |
+| `scripts/query_capacity.sh` | Same as above (bash) | Quick capacity check or version listing |
+
+## Workflow
+
+### Phase 1: Validate Prerequisites
+
+```bash
+az account show --query "{Subscription:name, SubscriptionId:id}" --output table
+```
+
+### Phase 2: Identify Model and Version
+
+Extract model name from user prompt. If version is unknown, query available versions:
+
+```powershell
+.\scripts\query_capacity.ps1 -ModelName <model-name>
+```
+```bash
+./scripts/query_capacity.sh <model-name>
+```
+
+This lists available versions. Use the latest version unless user specifies otherwise.
+
+### Phase 3: Run Discovery
+
+Run the full discovery script with model name, version, and minimum capacity target:
+
+```powershell
+.\scripts\discover_and_rank.ps1 -ModelName <model-name> -ModelVersion <version> -MinCapacity <target>
+```
+```bash
+./scripts/discover_and_rank.sh <model-name> <version> <min-capacity>
+```
+
+> 💡 The script automatically queries capacity across ALL regions, cross-references with the user's existing projects, and outputs a ranked table sorted by: meets target → project count → available capacity.
+
+### Phase 3.5: Validate Subscription Quota
+
+After discovery identifies candidate regions, validate that the user's subscription actually has available quota in each region. Model capacity (from Phase 3) shows what the platform can support, but subscription quota limits what this specific user can deploy.
+
+```powershell
+# For each candidate region from discovery results:
+$usageData = az cognitiveservices usage list --location <region> --subscription $SUBSCRIPTION_ID -o json 2>$null | ConvertFrom-Json
+
+# Check quota for each SKU the model supports
+# Quota names follow pattern: OpenAI.<SKU>.<model-name>
+$usageEntry = $usageData | Where-Object { $_.name.value -eq "OpenAI.<SKU>.<model-name>" }
+
+if ($usageEntry) {
+  $quotaAvailable = $usageEntry.limit - $usageEntry.currentValue
+} else {
+  $quotaAvailable = 0  # No quota allocated
+}
+```
+```bash
+# For each candidate region from discovery results:
+usage_json=$(az cognitiveservices usage list --location <region> --subscription "$SUBSCRIPTION_ID" -o json 2>/dev/null)
+
+# Extract quota for specific SKU+model
+quota_available=$(echo "$usage_json" | jq -r --arg name "OpenAI.<SKU>.<model-name>" \
+  '.[] | select(.name.value == $name) | .limit - .currentValue')
+```
+
+**Annotate discovery results:**
+
+Add a "Quota Available" column to the ranked output from Phase 3:
+
+| Region | Available Capacity | Meets Target | Projects | Quota Available |
+|--------|-------------------|--------------|----------|-----------------|
+| eastus2 | 120K TPM | ✅ | 3 | ✅ 80K |
+| westus3 | 90K TPM | ✅ | 1 | ❌ 0 (at limit) |
+| swedencentral | 100K TPM | ✅ | 0 | ✅ 100K |
+
+Regions/SKUs where `quotaAvailable = 0` should be marked with ❌ in the results. If no region has available quota, hand off to the [quota skill](../../../quota/quota.md) for increase requests and troubleshooting.
+
+### Phase 4: Present Results and Hand Off
+
+After the script outputs the ranked table (now annotated with quota info), present it to the user and ask:
+
+1. 🚀 **Quick deploy** to top recommendation with defaults → route to [preset](../preset/SKILL.md)
+2. ⚙️ **Custom deploy** with version/SKU/capacity/RAI selection → route to [customize](../customize/SKILL.md)
+3. 📊 **Check another model** or capacity target → re-run Phase 2
+4. ❌ Cancel
+
+### Phase 5: Confirm Project Before Deploying
+
+Before handing off to preset or customize, **always confirm the target project** with the user. See the [Project Selection](../SKILL.md#project-selection-all-modes) rules in the parent router.
+
+If the discovery table shows a sample project for the chosen region, suggest it as the default. Otherwise, query projects in that region and let the user pick.
+
+## Error Handling
+
+| Error | Cause | Resolution |
+|-------|-------|------------|
+| "No capacity found" | Model not available or all at quota | Hand off to [quota skill](../../../quota/quota.md) for increase requests and troubleshooting |
+| Script auth error | `az login` expired | Re-run `az login` |
+| Empty version list | Model not in region catalog | Try a different region: `./scripts/query_capacity.sh <model> "" eastus` |
+| "No projects found" | No AI Services resources | Guide to `project/create` skill or Azure Portal |
+
+## Related Skills
+
+- **[preset](../preset/SKILL.md)** — Quick deployment after capacity discovery
+- **[customize](../customize/SKILL.md)** — Custom deployment after capacity discovery
+- **[quota](../../../quota/quota.md)** — For quota viewing, increase requests, and troubleshooting quota errors, defer to this skill instead of duplicating guidance

package/.agents/skills/microsoft-foundry/models/deploy-model/capacity/scripts/discover_and_rank.ps1

@@ -0,0 +1,113 @@
+<#
+.SYNOPSIS
+    Discovers available capacity for an Azure OpenAI model across all regions,
+    cross-references with existing projects and subscription quota, and outputs a ranked table.
+.PARAMETER ModelName
+    The model name (e.g., "gpt-4o", "o3-mini")
+.PARAMETER ModelVersion
+    The model version (e.g., "2025-01-31")
+.PARAMETER MinCapacity
+    Minimum required capacity in K TPM units (default: 0, shows all)
+.EXAMPLE
+    .\discover_and_rank.ps1 -ModelName o3-mini -ModelVersion 2025-01-31 -MinCapacity 200
+#>
+param(
+    [Parameter(Mandatory)][string]$ModelName,
+    [Parameter(Mandatory)][string]$ModelVersion,
+    [int]$MinCapacity = 0
+)
+
+$ErrorActionPreference = "Stop"
+
+$subId = az account show --query id -o tsv
+
+# Query model capacity across all regions
+$capRaw = az rest --method GET `
+    --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/modelCapacities" `
+    --url-parameters api-version=2024-10-01 modelFormat=OpenAI modelName=$ModelName modelVersion=$ModelVersion `
+    2>$null | Out-String | ConvertFrom-Json
+
+# Query all AI Foundry projects (AIProject kind)
+$projRaw = az rest --method GET `
+    --url "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/accounts" `
+    --url-parameters api-version=2024-10-01 `
+    --query "value[?kind=='AIProject'].{Name:name, Location:location}" `
+    2>$null | Out-String | ConvertFrom-Json
+
+# Build capacity map (GlobalStandard only, pick max per region)
+$capMap = @{}
+foreach ($item in $capRaw.value) {
+    $sku = $item.properties.skuName
+    $avail = [int]$item.properties.availableCapacity
+    $region = $item.location
+    if ($sku -eq "GlobalStandard" -and $avail -gt 0) {
+        if (-not $capMap[$region] -or $avail -gt $capMap[$region]) {
+            $capMap[$region] = $avail
+        }
+    }
+}
+
+# Build project map
+$projMap = @{}
+$projSample = @{}
+foreach ($p in $projRaw) {
+    $loc = $p.Location
+    if (-not $projMap[$loc]) { $projMap[$loc] = 0 }
+    $projMap[$loc]++
+    if (-not $projSample[$loc]) { $projSample[$loc] = $p.Name }
+}
+
+# Check subscription quota per region
+$quotaMap = @{}
+$checkedRegions = @{}
+foreach ($region in $capMap.Keys) {
+    if ($checkedRegions[$region]) { continue }
+    $checkedRegions[$region] = $true
+    try {
+        $usageData = az cognitiveservices usage list --location $region --subscription $subId -o json 2>$null | Out-String | ConvertFrom-Json
+        $usageEntry = $usageData | Where-Object { $_.name.value -eq "OpenAI.GlobalStandard.$ModelName" }
+        if ($usageEntry) {
+            $quotaMap[$region] = [int]$usageEntry.limit - [int]$usageEntry.currentValue
+        } else {
+            $quotaMap[$region] = 0
+        }
+    } catch {
+        $quotaMap[$region] = -1  # Unable to check
+    }
+}
+
+# Combine and rank
+$results = foreach ($region in $capMap.Keys) {
+    $avail = $capMap[$region]
+    $meets = $avail -ge $MinCapacity
+    $quota = if ($quotaMap[$region]) { $quotaMap[$region] } else { 0 }
+    $quotaDisplay = if ($quota -eq -1) { "?" } elseif ($quota -gt 0) { "${quota}K" } else { "0" }
+    $quotaOk = $quota -gt 0 -or $quota -eq -1
+    [PSCustomObject]@{
+        Region         = $region
+        AvailableTPM   = "${avail}K"
+        AvailableRaw   = $avail
+        MeetsTarget    = if ($meets) { "YES" } else { "no" }
+        Projects       = if ($projMap[$region]) { $projMap[$region] } else { 0 }
+        SampleProject  = if ($projSample[$region]) { $projSample[$region] } else { "(none)" }
+        QuotaAvailable = $quotaDisplay
+        QuotaOk        = $quotaOk
+    }
+}
+
+$results = $results | Sort-Object @{Expression={$_.MeetsTarget -eq "YES"}; Descending=$true},
+                                   @{Expression={$_.QuotaOk}; Descending=$true},
+                                   @{Expression={$_.Projects}; Descending=$true},
+                                   @{Expression={$_.AvailableRaw}; Descending=$true}
+
+# Output summary
+$total = ($results | Measure-Object).Count
+$matching = ($results | Where-Object { $_.MeetsTarget -eq "YES" } | Measure-Object).Count
+$withQuota = ($results | Where-Object { $_.MeetsTarget -eq "YES" -and $_.QuotaOk } | Measure-Object).Count
+$withProjects = ($results | Where-Object { $_.MeetsTarget -eq "YES" -and $_.Projects -gt 0 } | Measure-Object).Count
+
+Write-Host "Model: $ModelName v$ModelVersion | SKU: GlobalStandard | Min Capacity: ${MinCapacity}K TPM"
+Write-Host "Regions with capacity: $total | Meets target: $matching | With quota: $withQuota | With projects: $withProjects"
+Write-Host ""
+
+$results | Select-Object Region, AvailableTPM, MeetsTarget, QuotaAvailable, Projects, SampleProject | Format-Table -AutoSize

package/.agents/skills/microsoft-foundry/models/deploy-model/capacity/scripts/discover_and_rank.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+# discover_and_rank.sh
+# Discovers available capacity for an Azure OpenAI model across all regions,
+# cross-references with existing projects and subscription quota, and outputs a ranked table.
+#
+# Usage: ./discover_and_rank.sh <model-name> <model-version> [min-capacity]
+# Example: ./discover_and_rank.sh o3-mini 2025-01-31 200
+#
+# Output: Ranked table of regions with capacity, quota, project counts, and match status
+
+set -euo pipefail
+
+MODEL_NAME="${1:?Usage: $0 <model-name> <model-version> [min-capacity]}"
+MODEL_VERSION="${2:?Usage: $0 <model-name> <model-version> [min-capacity]}"
+MIN_CAPACITY="${3:-0}"
+
+SUB_ID=$(az account show --query id -o tsv)
+
+# Query model capacity across all regions (GlobalStandard SKU)
+CAPACITY_JSON=$(az rest --method GET \
+  --url "https://management.azure.com/subscriptions/${SUB_ID}/providers/Microsoft.CognitiveServices/modelCapacities" \
+  --url-parameters api-version=2024-10-01 modelFormat=OpenAI modelName="$MODEL_NAME" modelVersion="$MODEL_VERSION" \
+  2>/dev/null)
+
+# Query all AI Services projects
+PROJECTS_JSON=$(az rest --method GET \
+  --url "https://management.azure.com/subscriptions/${SUB_ID}/providers/Microsoft.CognitiveServices/accounts" \
+  --url-parameters api-version=2024-10-01 \
+  --query "value[?kind=='AIServices'].{name:name, location:location}" \
+  2>/dev/null)
+
+# Get unique regions from capacity results for quota checking
+REGIONS=$(echo "$CAPACITY_JSON" | jq -r '.value[] | select(.properties.skuName=="GlobalStandard" and .properties.availableCapacity > 0) | .location' | sort -u)
+
+# Build quota map: check subscription quota per region
+declare -A QUOTA_MAP
+for region in $REGIONS; do
+  usage_json=$(az cognitiveservices usage list --location "$region" --subscription "$SUB_ID" -o json 2>/dev/null || echo "[]")
+  quota_avail=$(echo "$usage_json" | jq -r --arg name "OpenAI.GlobalStandard.$MODEL_NAME" \
+    '[.[] | select(.name.value == $name)] | if length > 0 then .[0].limit - .[0].currentValue else 0 end')
+  QUOTA_MAP[$region]="${quota_avail:-0}"
+done
+
+# Export quota map as JSON for Python
+QUOTA_JSON="{"
+first=true
+for region in "${!QUOTA_MAP[@]}"; do
+  if [ "$first" = true ]; then first=false; else QUOTA_JSON+=","; fi
+  QUOTA_JSON+="\"$region\":${QUOTA_MAP[$region]}"
+done
+QUOTA_JSON+="}"
+
+# Combine, rank, and output using inline Python (available on all Azure CLI installs)
+python3 -c "
+import json, sys
+
+capacity = json.loads('''${CAPACITY_JSON}''')
+projects = json.loads('''${PROJECTS_JSON}''')
+quota = json.loads('''${QUOTA_JSON}''')
+min_cap = int('${MIN_CAPACITY}')
+
+# Build capacity map (GlobalStandard only)
+cap_map = {}
+for item in capacity.get('value', []):
+    props = item.get('properties', {})
+    if props.get('skuName') == 'GlobalStandard' and props.get('availableCapacity', 0) > 0:
+        region = item.get('location', '')
+        cap_map[region] = max(cap_map.get(region, 0), props['availableCapacity'])
+
+# Build project count map
+proj_map = {}
+proj_sample = {}
+for p in (projects if isinstance(projects, list) else []):
+    loc = p.get('location', '')
+    proj_map[loc] = proj_map.get(loc, 0) + 1
+    if loc not in proj_sample:
+        proj_sample[loc] = p.get('name', '')
+
+# Combine and rank
+results = []
+for region, cap in cap_map.items():
+    meets = cap >= min_cap
+    q = quota.get(region, 0)
+    quota_ok = q > 0
+    results.append({
+        'region': region,
+        'available': cap,
+        'meets': meets,
+        'projects': proj_map.get(region, 0),
+        'sample': proj_sample.get(region, '(none)'),
+        'quota': q,
+        'quota_ok': quota_ok
+    })
+
+# Sort: meets target first, then quota available, then by project count, then by capacity
+results.sort(key=lambda x: (-x['meets'], -x['quota_ok'], -x['projects'], -x['available']))
+
+# Output
+total = len(results)
+matching = sum(1 for r in results if r['meets'])
+with_quota = sum(1 for r in results if r['meets'] and r['quota_ok'])
+with_projects = sum(1 for r in results if r['meets'] and r['projects'] > 0)
+
+print(f'Model: {\"${MODEL_NAME}\"} v{\"${MODEL_VERSION}\"} | SKU: GlobalStandard | Min Capacity: {min_cap}K TPM')
+print(f'Regions with capacity: {total} | Meets target: {matching} | With quota: {with_quota} | With projects: {with_projects}')
+print()
+print(f'{\"Region\":<22} {\"Available\":<12} {\"Meets Target\":<14} {\"Quota\":<12} {\"Projects\":<10} {\"Sample Project\"}')
+print('-' * 100)
+for r in results:
+    mark = 'YES' if r['meets'] else 'no'
+    q_display = f'{r[\"quota\"]}K' if r['quota'] > 0 else '0 (none)'
+    print(f'{r[\"region\"]:<22} {r[\"available\"]}K{\"\":.<10} {mark:<14} {q_display:<12} {r[\"projects\"]:<10} {r[\"sample\"]}')
+"

package/.agents/skills/microsoft-foundry/models/deploy-model/capacity/scripts/query_capacity.ps1

@@ -0,0 +1,80 @@
+<#
+.SYNOPSIS
+    Queries available capacity for an Azure OpenAI model and validates if a target is achievable.
+.PARAMETER ModelName
+    The model name (e.g., "gpt-4o", "o3-mini")
+.PARAMETER ModelVersion
+    The model version (e.g., "2025-01-31"). If omitted, lists available versions.
+.PARAMETER Region
+    Optional. Check capacity in a specific region only.
+.PARAMETER SKU
+    SKU to check (default: GlobalStandard)
+.EXAMPLE
+    .\query_capacity.ps1 -ModelName o3-mini
+    .\query_capacity.ps1 -ModelName o3-mini -ModelVersion 2025-01-31 -Region eastus2
+#>
+param(
+    [Parameter(Mandatory)][string]$ModelName,
+    [string]$ModelVersion,
+    [string]$Region,
+    [string]$SKU = "GlobalStandard"
+)
+
+$ErrorActionPreference = "Stop"
+
+$subId = az account show --query id -o tsv
+
+# If no version provided, list available versions first
+if (-not $ModelVersion) {
+    Write-Host "Available versions for $ModelName`:"
+    $loc = if ($Region) { $Region } else { "eastus" }
+    az cognitiveservices model list --location $loc `
+        --query "[?model.name=='$ModelName'].{Version:model.version, Format:model.format}" `
+        --output table 2>$null
+    return
+}
+
+# Build URL parameters
+$urlParams = @("api-version=2024-10-01", "modelFormat=OpenAI", "modelName=$ModelName", "modelVersion=$ModelVersion")
+
+if ($Region) {
+    $url = "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/locations/$Region/modelCapacities"
+} else {
+    $url = "https://management.azure.com/subscriptions/$subId/providers/Microsoft.CognitiveServices/modelCapacities"
+}
+
+$raw = az rest --method GET --url $url --url-parameters @urlParams 2>$null | Out-String | ConvertFrom-Json
+
+# Filter by SKU
+$filtered = $raw.value | Where-Object { $_.properties.skuName -eq $SKU -and $_.properties.availableCapacity -gt 0 }
+
+if (-not $filtered) {
+    Write-Host "No capacity found for $ModelName v$ModelVersion ($SKU)" -ForegroundColor Red
+    Write-Host "Try a different SKU or version."
+    return
+}
+
+Write-Host "Capacity: $ModelName v$ModelVersion ($SKU)"
+Write-Host ""
+$filtered | ForEach-Object {
+    # Check subscription quota for this region
+    $quotaDisplay = "?"
+    try {
+        $usageData = az cognitiveservices usage list --location $_.location --subscription $subId -o json 2>$null | Out-String | ConvertFrom-Json
+        $usageEntry = $usageData | Where-Object { $_.name.value -eq "OpenAI.$SKU.$ModelName" }
+        if ($usageEntry) {
+            $quotaAvail = [int]$usageEntry.limit - [int]$usageEntry.currentValue
+            $quotaDisplay = if ($quotaAvail -gt 0) { "${quotaAvail}K" } else { "0 (at limit)" }
+        } else {
+            $quotaDisplay = "0 (none)"
+        }
+    } catch {
+        $quotaDisplay = "?"
+    }
+    [PSCustomObject]@{
+        Region    = $_.location
+        SKU       = $_.properties.skuName
+        Available = "$($_.properties.availableCapacity)K TPM"
+        Quota     = $quotaDisplay
+    }
+} | Sort-Object { [int]($_.Available -replace '[^\d]','') } -Descending | Format-Table -AutoSize

package/.agents/skills/microsoft-foundry/models/deploy-model/capacity/scripts/query_capacity.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+# query_capacity.sh
+# Queries available capacity for an Azure OpenAI model.
+#
+# Usage:
+#   ./query_capacity.sh <model-name> [model-version] [region] [sku]
+# Examples:
+#   ./query_capacity.sh o3-mini                          # List versions
+#   ./query_capacity.sh o3-mini 2025-01-31               # All regions
+#   ./query_capacity.sh o3-mini 2025-01-31 eastus2       # Specific region
+#   ./query_capacity.sh o3-mini 2025-01-31 "" Standard   # Different SKU
+
+set -euo pipefail
+
+MODEL_NAME="${1:?Usage: $0 <model-name> [model-version] [region] [sku]}"
+MODEL_VERSION="${2:-}"
+REGION="${3:-}"
+SKU="${4:-GlobalStandard}"
+
+SUB_ID=$(az account show --query id -o tsv)
+
+# If no version, list available versions
+if [ -z "$MODEL_VERSION" ]; then
+    LOC="${REGION:-eastus}"
+    echo "Available versions for $MODEL_NAME:"
+    az cognitiveservices model list --location "$LOC" \
+        --query "[?model.name=='$MODEL_NAME'].{Version:model.version, Format:model.format}" \
+        --output table 2>/dev/null
+    exit 0
+fi
+
+# Build URL
+if [ -n "$REGION" ]; then
+    URL="https://management.azure.com/subscriptions/${SUB_ID}/providers/Microsoft.CognitiveServices/locations/${REGION}/modelCapacities"
+else
+    URL="https://management.azure.com/subscriptions/${SUB_ID}/providers/Microsoft.CognitiveServices/modelCapacities"
+fi
+
+# Query capacity
+CAPACITY_RESULT=$(az rest --method GET --url "$URL" \
+    --url-parameters api-version=2024-10-01 modelFormat=OpenAI modelName="$MODEL_NAME" modelVersion="$MODEL_VERSION" \
+    2>/dev/null)
+
+# Get regions with capacity
+REGIONS_WITH_CAP=$(echo "$CAPACITY_RESULT" | jq -r ".value[] | select(.properties.skuName==\"$SKU\" and .properties.availableCapacity > 0) | .location" 2>/dev/null | sort -u)
+
+if [ -z "$REGIONS_WITH_CAP" ]; then
+    echo "No capacity found for $MODEL_NAME v$MODEL_VERSION ($SKU)"
+    echo "Try a different SKU or version."
+    exit 0
+fi
+
+echo "Capacity: $MODEL_NAME v$MODEL_VERSION ($SKU)"
+echo ""
+printf "%-22s %-12s %-15s %s\n" "Region" "Available" "Quota" "SKU"
+printf -- '-%.0s' {1..60}; echo ""
+
+for region in $REGIONS_WITH_CAP; do
+    avail=$(echo "$CAPACITY_RESULT" | jq -r ".value[] | select(.location==\"$region\" and .properties.skuName==\"$SKU\") | .properties.availableCapacity" 2>/dev/null | head -1)
+
+    # Check subscription quota
+    usage_json=$(az cognitiveservices usage list --location "$region" --subscription "$SUB_ID" -o json 2>/dev/null || echo "[]")
+    quota_avail=$(echo "$usage_json" | jq -r --arg name "OpenAI.$SKU.$MODEL_NAME" \
+        '[.[] | select(.name.value == $name)] | if length > 0 then .[0].limit - .[0].currentValue else 0 end' 2>/dev/null || echo "?")
+
+    if [ "$quota_avail" = "0" ]; then
+        quota_display="0 (none)"
+    elif [ "$quota_avail" = "?" ]; then
+        quota_display="?"
+    else
+        quota_display="${quota_avail}K"
+    fi
+
+    printf "%-22s %-12s %-15s %s\n" "$region" "${avail}K TPM" "$quota_display" "$SKU"
+done