add kiota compatible openApi docs

tools/DownloadOpenApiDocKiotaCompat.ps1

@@ -0,0 +1,76 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+#
+# Kiota-compatible variant of DownloadOpenApiDoc.ps1.
+#
+# Instead of the PowerShell conversion profile, this slices the Kiota base
+# document (fileName=openapi, which has OpenApiConvertSettings.EnableDiscriminatorValue = true
+# and preserves AnyOf/OneOf + discriminators) and applies no PowerShell styling (style=Plain),
+# producing per-module OpenAPI docs suitable for Kiota SDK generation.
+[CmdletBinding()]
+Param(
+    [string] $ModuleName,
+    [string] $ModuleRegex,
+    [string] $OpenApiDocOutput,
+    [string] $GraphVersion,
+    [switch] $ForceRefresh,
+    [int] $RequestCount = 1
+)
+
+if (-not (Test-Path $OpenApiDocOutput)) {
+    New-Item -Path $OpenApiDocOutput -Type Directory
+}
+
+$OpenApiBaseUrl = "https://graph-devx-api.microsoft.com"
+$OpenApiServiceUrl = ("$OpenApiBaseUrl/`$openapi?tags={0}&title=$ModuleName&openapiversion=3&style=Plain&fileName=openapi&graphVersion=$GraphVersion" -f $ModuleRegex)
+if ($ForceRefresh.IsPresent) {
+    $OpenApiServiceUrl = "$OpenApiServiceUrl&forceRefresh=true"
+}
+Write-Debug "[$RequestCount] Downloading Kiota-compatible OpenAPI doc for '$ModuleName' module: $OpenApiServiceUrl"
+$Retries = 3
+$Delay = 3
+$Retrycount = 0
+$Completed = $false
+while (-not $Completed) {
+    try {
+        Invoke-WebRequest $OpenApiServiceUrl -OutFile "$OpenApiDocOutput\$ModuleName.yml"
+        $Completed = $true
+    }
+    catch {
+        $Exception = $_.Exception
+        switch ($Exception.Response.StatusCode.value__) {
+            { @(429, 503, 504) -contains $_ } {
+                if ($Retrycount -ge $Retries) {
+                    Write-Warning "Request to $OpenApiServiceUrl failed the maximum number of $Retrycount times."
+                    throw
+                }
+                else {
+                    [ref]$RetryAfterHeader = $null
+                    if ($Exception.Response.Headers.TryGetValues("Retry-After", $RetryAfterHeader)) {
+                        # Use Retry-After response header
+                        $DelayInSeconds = $RetryAfterHeader.Value
+                    }
+                    else {
+                        # Use exponential backoff
+                        $mPow = [math]::Pow(2, $Retrycount)
+                        $DelayInSeconds = $mPow * $Delay
+                    }
+
+                    Write-Warning "Request to $OpenApiServiceUrl failed. Retrying in $DelayInSeconds seconds."
+                    Start-Sleep $DelayInSeconds
+                    $Retrycount++
+                }
+            }
+            404 {
+                Write-Warning "Request to $OpenApiServiceUrl returned 404. Download will be skipped."
+                $Completed = $true
+            }
+            default {
+                # Get HTTP error message from DevX api, Re-throw error to be handled Upstream
+                $ErrorMessage = $Exception.Message
+                Write-Warning "[$RequestCount] Request for $ModuleName failed with error message: $ErrorMessage"
+                throw
+            }
+        }
+    }
+}

tools/UpdateOpenApiKiotaCompat.ps1

@@ -0,0 +1,73 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+#
+# Kiota-compatible variant of UpdateOpenApi.ps1.
+#
+# Uses the same per-module regex mapping (config\ModulesMapping.jsonc) to slice the
+# Kiota base OpenAPI document (fileName=openapi, style=Plain) into per-module docs that
+# preserve discriminators/AnyOf/OneOf and are suitable for Kiota SDK generation.
+#
+# The output is written to a separate folder (default: .\openApiDocs_KiotaCompat) so the
+# existing PowerShell OpenAPI flow (.\openApiDocs) remains untouched. The PowerShell-specific
+# post-processing (TweakOpenApi.ps1) is intentionally NOT run.
+[CmdletBinding()]
+Param(
+    [string] $ModuleMappingConfigPath = (Join-Path $PSScriptRoot "..\config\ModulesMapping.jsonc"),
+    [string] $OpenApiDocOutput = (Join-Path $PSScriptRoot "..\openApiDocs_KiotaCompat"),
+    [switch] $BetaGraphVersion,
+    [switch] $SkipForceRefresh
+)
+
+$ErrorActionPreference = 'Stop'
+$LASTEXITCODE = $null
+if ($PSEdition -ne 'Core') {
+    Write-Error 'This script requires PowerShell Core to execute.'
+}
+
+if (!(Get-Module powershell-yaml -ListAvailable)) {
+    # Install Powershell-yaml
+    Install-Module powershell-yaml -Force
+}
+
+$GraphVersion = "v1.0"
+if ($BetaGraphVersion) {
+    $GraphVersion = "beta"
+}
+
+$OpenApiDocOutput = Join-Path $OpenApiDocOutput $GraphVersion
+
+# Load PS Scripts
+$DownloadOpenApiDocPS1 = Join-Path $PSScriptRoot ".\DownloadOpenApiDocKiotaCompat.ps1" -Resolve
+
+if (-not (Test-Path $ModuleMappingConfigPath)) {
+    Write-Error "Module mapping file not be found: $ModuleMappingConfigPath."
+}
+$v1Excludes = @("WindowsUpdates")
+$betaExcludes = @("DeviceManagement.Administration", "Mail", "ManagedTenants")
+$Stopwatch = [system.diagnostics.stopwatch]::StartNew()
+[HashTable] $ModuleMapping = Get-Content $ModuleMappingConfigPath | ConvertFrom-Json -AsHashTable
+$ModuleMapping.Keys | ForEach-Object -Begin { $RequestCount = 0 } -End { Write-Debug "Requests: $RequestCount" } -Process {
+    $ModuleName = $_
+    if (-not ($v1Excludes -contains $ModuleName -and $GraphVersion -eq "v1.0")) {
+        $ForceRefresh = $false
+        # Check whether ForceRefresh is required, Only required for the First Request.
+        if ($RequestCount -eq 0 -and $SkipForceRefresh -eq $false) {
+            $ForceRefresh = $true
+        }
+
+        try {
+            # Omit beta version of DeviceManagement.Administration module for further troubleshooting
+            if (-not($betaExcludes -contains $ModuleName -and $GraphVersion -eq "beta")) {
+                # Download Kiota-compatible OpenAPI document for module.
+                & $DownloadOpenApiDocPS1 -ModuleName $ModuleName -ModuleRegex $ModuleMapping[$ModuleName] -OpenApiDocOutput $OpenApiDocOutput -GraphVersion $GraphVersion -ForceRefresh:$ForceRefresh -RequestCount $RequestCount
+            }
+        }
+        catch {
+            Write-Error $_.Exception
+        }
+        $RequestCount++
+    }
+}
+$stopwatch.Stop()
+Write-Debug "Downloaded $GraphVersion Kiota-compatible OpenAPI files in '$($Stopwatch.Elapsed.TotalMinutes)` minutes."
+Write-Host -ForegroundColor Green "-------------Done-------------"