Private/Tools/Resolve-AvmTool.ps1

function Resolve-AvmTool {
    <#
    .SYNOPSIS
        Resolve the on-disk path to a managed binary or PowerShell module.

    .DESCRIPTION
        Engine code calls this helper to obtain a usable path to bicep,
        terraform, tflint, etc. before invoking the binary. The resolution
        order mirrors Get-AvmTool's status logic:

          1. Cached + verified under <Tools>/<name>/<version>/<entry>[.exe].
          2. On PATH and reporting the lock-pinned version (-AllowPathFallback).

        On a cache miss the helper installs the pinned tool on demand
        through the verified Install-AvmToolFromPins pipeline (SHA256 +
        atomic rename + cross-process lock, honouring AVM_HOME), then
        re-resolves. This keeps `avm` self-sufficient: consumers never
        have to run `avm tool install` first, locally or in CI.

        Set AVM_NO_AUTO_INSTALL=1 (or pass -NoAutoInstall) to disable
        implicit installation for locked-down or air-gapped environments;
        resolution then hard-fails with a remediation hint pointing at
        `avm tool install <name>`.

    .PARAMETER Name
        The exact tool or PowerShell module name from avm.pins.jsonc.

    .PARAMETER PinsPath
        Override the bundled lock file. For tests.

    .PARAMETER ModuleRoot
        Repository context for .avm/tool-version-overrides.json.

    .PARAMETER AllowPathFallback
        When set, accept a PATH-resolved binary that self-reports the
        lock-pinned version. Defaults to off (engines should prefer the
        managed cache for reproducibility).

    .PARAMETER NoAutoInstall
        Disable on-demand installation of a missing pinned tool. Equivalent
        to AVM_NO_AUTO_INSTALL=1. Resolution then hard-fails instead of
        installing. For locked-down environments and tests.

    .PARAMETER AllowFileUrls
        Test-only escape hatch passed through to Read-AvmPins.

    .OUTPUTS
        pscustomobject with: Name, Version, Platform, Source, Path.
    #>

    [CmdletBinding()]
    [OutputType([pscustomobject])]
    param(
        [Parameter(Mandatory)]
        [string] $Name,

        [string] $PinsPath,

        [string] $ModuleRoot,

        [switch] $AllowPathFallback,

        [switch] $NoAutoInstall,

        [Parameter(DontShow)]
        [switch] $AllowFileUrls
    )

    Set-StrictMode -Version 3.0
    $ErrorActionPreference = 'Stop'

    $lock = if ($PinsPath) {
        Read-AvmPins -Path $PinsPath -ModuleRoot $ModuleRoot -AllowFileUrls:$AllowFileUrls
    }
    else {
        Read-AvmPins -ModuleRoot $ModuleRoot
    }

    $tool = Get-AvmToolDefinition -Pins $lock | Where-Object { $_.name -ceq $Name } | Select-Object -First 1
    if (-not $tool) {
        throw [System.ArgumentException]::new(
            "Unknown tool '$Name' (not in avm.pins).")
    }
    Write-AvmToolVersionOverride -Tool $tool
    $versionOverride = if ($tool.ContainsKey('versionOverride')) { [pscustomobject]$tool.versionOverride } else { $null }

    $platform = Get-AvmToolPlatform
    Write-AvmLog ("tool: resolving {0}/{1} for {2}" -f $tool.name, $tool.version, $platform) -Level Verbose | Out-Null

    if ($tool.ContainsKey('unsupportedPlatforms') -and (@($tool.unsupportedPlatforms) -ccontains $platform)) {
        throw [AvmToolException]::new(
            ("Tool '{0}' does not ship a release for '{1}'." -f $tool.name, $platform),
            'AVM1012')
    }

    $cache = Get-AvmToolCacheEntry -Tool $tool -Platform $platform
    $entrypoint = $cache.Path
    $isModule = $tool.ContainsKey('kind') -and $tool.kind -ceq 'powershell-module'
    $kind = if ($isModule) { 'powershell-module' } else { 'binary' }

    if ($cache.Cached) {
        Write-AvmLog ("tool: cache hit for {0} at {1}" -f $tool.name, $entrypoint) -Level Verbose | Out-Null
        return [pscustomobject][ordered]@{
            Name            = $tool.name
            Version         = $tool.version
            Platform        = $platform
            Source          = 'cache'
            Path            = $entrypoint
            Kind            = $kind
            VersionOverride = $versionOverride
        }
    }

    if ($isModule) {
        $installedModule = Find-AvmPowerShellModule -Name $tool.name -Version $tool.version
        if ($installedModule) {
            return [pscustomobject]@{
                Name = $tool.name; Version = $tool.version; Platform = $platform
                Source = 'module-path'; Path = Join-Path $installedModule.ModuleBase "$Name.psd1"; Kind = $kind
                VersionOverride = $versionOverride
            }
        }
    }
    elseif ($AllowPathFallback) {
        Write-AvmLog ("tool: checking PATH fallback for {0}" -f $tool.name) -Level Verbose | Out-Null
        $hit = Find-AvmToolOnPath -Entrypoint $tool.entrypoint -ExpectedVersion $tool.version
        if ($hit -and $hit.Matches) {
            Write-AvmLog ("tool: using PATH fallback for {0} at {1}" -f $tool.name, $hit.Path) -Level Verbose | Out-Null
            return [pscustomobject][ordered]@{
                Name            = $tool.name
                Version         = $tool.version
                Platform        = $platform
                Source          = 'path'
                Path            = $hit.Path
                Kind            = $kind
                VersionOverride = $versionOverride
            }
        }
    }

    if (Test-AvmAutoInstallDisabled -Explicit:$NoAutoInstall) {
        Write-AvmLog ("tool: automatic install disabled for {0}" -f $tool.name) -Level Verbose | Out-Null
        throw [AvmToolException]::new(
            ("Tool '{0}' (version {1}) is not installed and automatic installation is disabled (AVM_NO_AUTO_INSTALL). Run: avm tool install {0}" -f $tool.name, $tool.version),
            'AVM1014')
    }

    Write-AvmLog ("Installing {0} {1} ({2})..." -f $tool.name, $tool.version, $platform) -Level Install | Out-Null
    $installed = Install-AvmToolFromPins -Tool $tool -Platform $platform
    Write-AvmLog ("tool: install action for {0} = {1}" -f $tool.name, $installed.Action) -Level Verbose | Out-Null

    if (-not (Get-AvmToolCacheEntry -Tool $tool -Platform $platform).Cached) {
        throw [AvmToolException]::new(
            ("Tool '{0}' (version {1}) could not be installed automatically. Run: avm tool install {0}" -f $tool.name, $tool.version),
            'AVM1014')
    }

    $source = if ($installed -and $installed.Action -eq 'installed') { 'installed' } else { 'cache' }
    Write-AvmLog ("Installed {0} {1} at {2}" -f $tool.name, $tool.version, $entrypoint) -Level Install | Out-Null
    return [pscustomobject][ordered]@{
        Name            = $tool.name
        Version         = $tool.version
        Platform        = $platform
        Source          = $source
        Path            = $entrypoint
        Kind            = $kind
        VersionOverride = $versionOverride
    }
}

# SIG # Begin signature block
# MIInTwYJKoZIhvcNAQcCoIInQDCCJzwCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCbBfGcmpe2PFu7
# 4a/yMtj0vb/xwTKbgCfB3kQgDWZxQaCCDMkwggYEMIID7KADAgECAhMzAAACHPrN
# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD
# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1
# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD
# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB
# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP
# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC
# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf
# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j
# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT
# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B
# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O
# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL
# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT
# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw
# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w
# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy
# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl
# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC
# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN
# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK
# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK
# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY
# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu
# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE
# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz
# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6
# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO
# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD
# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC
# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT
# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS
# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX
# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ
# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq
# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo
# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv
# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a
# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1
# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO
# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7
# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ
# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS
# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm
# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3
# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E
# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX
# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB
# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP
# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv
# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw
# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv
# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC
# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D
# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY
# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI
# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6
# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w
# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7
# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK
# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK
# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw
# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT
# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghncMIIZ2AIBATBu
# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc
# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG
# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIHstlvXLC4PL5tScS9MmJN1F+yVR
# sXkbD7L0ST73OMyyMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv
# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE
# ggEAXoTzcnbtMhha1rVokEVKldYQtN0Xq5HUrSvf3clvlBaGMjATpNFlnV/kAFSu
# 0laX4YlWuvfGIlTb4G5pD+8lVvMhTn7ZH0BxwLXOG7ppW6Bscf1mVBGB4Hj+hh/p
# NdaAIObwLjhySU9XENd4YONOQ7C0NLC5Y91oqD63YajEcuoqSJeaK23pN+DLB4XH
# 7ESgaxW0hayjbBtD+nI/NR/JpOqasRgIVeXDOlGIcqT8vDSValopq4EicgLnvC99
# aAAg+ZlYXBBYMm7gR73pSp4ljdoLn9MNqIiasWkg3evl5MjSZlZvft854GnMJx9h
# 03Yib50qb/41fQGf4nzX2QIbvaGCF6wwgheoBgorBgEEAYI3AwMBMYIXmDCCF5QG
# CSqGSIb3DQEHAqCCF4UwgheBAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsqhkiG
# 9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC
# AQUABCCKF5T6Rz9aq6vhoOxVhRlOVEERNNsrBJMpHzFscyaXdQIGavNsOtjxGBIy
# MDI2MTExOTE2MjQxMy4zM1owBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k
# IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjZG
# MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2
# aWNloIIR+zCCBygwggUQoAMCAQICEzMAAAIzEF+3NtqoQFIAAQAAAjMwDQYJKoZI
# hvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm
# MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjYxMDE1
# MTgzNzQwWhcNMjgwMTExMTgzNzQwWjCB0zELMAkGA1UEBhMCVVMxEzARBgNVBAgT
# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0
# aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NkYxQS0wNUUw
# LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi
# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC8l5hSmRcLNSX1OAtiblnbTOjV
# i3VdcPzuwTMCzmZwYGvqsze6jiLl8wB+WOSKMl/BjfKl+cG49fwhhL9IqrmTerRn
# YHOtXMwswtMDzU482BT8eykyP3B38DES7PsDTAfm+K8tBY6uJshpfkR+ng4W3e9L
# UVLZsM0vyiOG/W/7JUpFfRYCZw3WPWUYqX/uqA93Z8mdAkBsxVLo2MBbXqXuAsli
# sURP8P2CVA0C3Rmg2+02FZAfdPGg6+0eXdVUVmlul1ui1cx0tvTfX8NNcFVxXBwo
# T7Pb1nMq6X9lB/XHIFAVu+oRuyN4GmU6hjCUh+dmycTEK+nNreYYr0Xj1QiNHgWD
# 3wOQ4DLXjnGSJMb+U7UBZwGjmToiCeIp49J66zhNE4wQUOH39OsrtKHHg8W8tBhO
# w3Tzxa0gF3Wcz8BvRdY+UGmgok3a1UImz+3svu3uvRacd2GKo1wzsJ1QCBbCtwjJ
# EeE18cWhHy1mZcb4PVcNxUPzfbAupPF+ERkNl/ow5bIUz+nvmlV2lSMwrovsFG0u
# qarv7eyW0aBVO4LLbc5O8ozNnQyDPNIhDnv9chnLJSXpWloQFHy+PEiNV88KBJZQ
# hIr2M1q0sUdB5kmZDRhlsSaEE0UZtwcj6VJetNeJUlDrlT1V2krlD6IPgZa/NOg0
# 3duyOKpEZnVyfTPSBQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFDTcA1da+VN0e9H9
# +gL+81bOCZ6yMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud
# HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js
# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr
# BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv
# bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw
# MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw
# DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQBUF0lu8s2Eux08/MSG
# D79uQsl5EPEByxSD+em44YOrxILObuNdMKObxlMQ18DEf/aC7D+esFks57mQts+P
# eA8uBib2T0Y6wGGzAyLjyu2XpXSBvU45yRVBCQJJBfKPI6yMjMiCkh7Ge5999rA5
# 4MLm3ausyk6/HWa2pWd81kgYynKCmgaHmpsX8/vi6E25oznZQQDf5XFdR/11JQ/0
# uBjNjiQseucm6WRJDpAeLExrYiYY1iIY/t+2l7yTx2S+NsbNOi6iWOWoKoeImZiu
# M+XrzH2s+vf6SKUq56a9rDIu1DrNvRbO9IotK/ou8TwNua4B5ydtHwKMM3J4qJWq
# fJjthUqHzFwpca/bQxYVWJE2snAPrrZGYqM6uul8SL4vNNV99HsUH0hNGd+UwJuh
# GI8ibi6ce/vMoYUM/Z7tChbXt0DLRAYYF5HjRTH/MMVTZgJEwHzQ7FRgSCanqMfT
# p0hZ5Hrlv/ACbbJvaHSRrhuBJ7vsHkv95kVGLZbBjt/sEULfoen99eQwyjlDxccQ
# NB9C1QdZjfFEPWwKJFRPSD0m8D1Tb61GH9Rev6ucdb3UQhbbGqsTAsKfCtHpiqYf
# hUrgtJAnzn+a2sPMTTAo6EFxkI+ApIVjFhNcMheDmrXF4TfZjyLUFhircZ0bu5dT
# u1Oc0TdZwu0jaJ1wtN3IG1ehmjCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA
# AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg
# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl
# IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow
# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA
# A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX
# 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q
# UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d
# q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN
# pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k
# rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d
# Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS
# Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8
# QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm
# gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF
# ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID
# AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU
# KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1
# GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0
# bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA
# QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL
# j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p
# Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w
# Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3
# Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz
# LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU
# tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN
# 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU
# 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5
# KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy
# qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6
# 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE
# AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp
# AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd
# FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb
# atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd
# VTNYs6FwZvKhggNWMIICPgIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k
# IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjZG
# MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2
# aWNloiMKAQEwBwYFKw4DAhoDFQBbE8osOLFy7jKCPdFImKD+e14MFKCBgzCBgKR+
# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT
# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA
# 7qkeTjAiGA8yMDI2MTExOTA3MDU1MFoYDzIwMjYxMTIwMDcwNTUwWjB0MDoGCisG
# AQQBhFkKBAExLDAqMAoCBQDuqR5OAgEAMAcCAQACAiqJMAcCAQACAhLgMAoCBQDu
# qm/OAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMH
# oSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAAx2gPwsCJCJntJbFBnk
# dRF1iEEl7u2qPtM801jDZIEmZ6V2XvzkTzrKrCSt8zTWbujzukuuZtwosOEnCGyz
# umQruj9nXvlC3oSVtj3sFVdJ+yHc4JwU0c4LkPdgcWD7tfVPnSYrG9qV3rHObzEh
# Woomdt1Ug0E93LVaWA/1oUvnxdUkeaOr4HskyigPoCGB3Kc3VroCHAdtYNtPYqRg
# 9WlXTPah0tikB4mlKtsURUiVUTBVYUFwcwORV8nbCbpwmd5dQJi3EA6pycWT7eug
# veRa5niTp4lLZEWD2J2GD4DqldvYGSDsDcImhGc66V5Bof7AtWhZ26Nho6F2bdRP
# iZExggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT
# MwAAAjMQX7c22qhAUgABAAACMzANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcN
# AQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCDT0NvLbcUH51FuGNEg
# I5u1FjtGx/ai4DSswPc6gkqb+DCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0E
# IJa57mILS0hdZpTRBP9SncxQtlRvlT173qrjREHSDjmXMIGYMIGApH4wfDELMAkG
# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx
# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z
# b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIzEF+3NtqoQFIAAQAAAjMwIgQg
# P/J6jbVyCWpB2+GDIrKiONRVmLUwrtIRCTXukDKjxtkwDQYJKoZIhvcNAQELBQAE
# ggIAT2WeIhblsDoYrb5E2EFw9LjloS9ePNOQU9W5G/viomLkPixFxphbK1KjSB4F
# B8ZDCB2wRyjZKUbYC1/Stw7pZiGcnjHEV4u8UM5kZfC5FF29YZPsQ2JcxbdyFLcE
# PN+0OtA5cyHM9F/9eYeJCh81BuOfQIFGIcIJbbUimhI7zdQJUc2a5ROaAhIch1xs
# 1ahX3vJrHp31wzHa850zUD8cPDpvpuTaHTlgl6EiisJDUvWQwoQKluRzu/U0Mnd/
# HW+jpIXdP1HwmgXHugz79C759hITWCstmivJZdYIFqs65X0cBvk4R4v5+2hS9bQP
# APmbEhodyqDXD+JtFEvFXlxiyTmXPT6F2p6EJJLbLtdrY7BXsTZEvcVG/YQZHBwe
# qn9pQn4JOuY8/W1bpzouRgbNBJF9DS1Nj3dLogUIUMZ3n0xJlb9ZFUUWyOTsu2wC
# UE3+f/tHUynWEN1MGu2si1FZ3si7nkTa+9UvrSMFuA9af7KvhvTbh6Tbsh3XiOeo
# E9x3mahiUysdIEn5dsIaNaCS7P3UpRsjZ/Xsy2FQje2/VzIW9Peydi4p+N1/RwFh
# MTW54tt285b6wMYE3l1dKt/tYrCmAiYtU2w5cNo7tWE5o9mkhxRVc14DPBceuc3j
# Prz+FCbo6waQLqFbqlDKwUSB+XIeQ6JdZuECwGtg6irqr/E=
# SIG # End signature block