microsoft.copilot.toolkit

0.1.3

Public/New-DeclarativeCopilot.ps1

                                <#

.SYNOPSIS

    Create a Declarative Agent app package.

.DESCRIPTION

    This cmdlet creates a Declarative Agent app package, which includes a Teams app with a Declarative Agent, you can sideload for yourself, or publish to your organization and share with more people. 

    You can learn more about Declarative Agent here (https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/overview-declarative-copilot).

.PARAMETER author

    The author of the Declarative Agent app. It is optional, if not specified, the author will be Ares Chen.

.PARAMETER name

    The name of the Declarative Agent.

.PARAMETER description

    The description of the Declarative Agent.

.PARAMETER instructions

    The instructions of the Declarative Agent, this is very important to guide the user to use the Declarative Agent. Think this as the system prompt when you interact with the ChatGPT or other AI models.

    You can specify the instructions as a string, or a file path which contains the instructions. If it is a file path, the content of the file will be used as the instructions. The file should be a UTF-8 encoded text file.

.PARAMETER outlineIcon192x192

    The path of the outline icon of the Declarative Agent, it should be a 192x192 png file. It is optional, if not specified, the default icon will be used.

.PARAMETER colorIcon32x32

    The path of the color icon of the Declarative Agent, it should be a 32x32 png file. It is optional, if not specified, the default icon will be used.

.PARAMETER starterPrompts

    The starter prompts of the Declarative Agent. Think this as templates of prompts you suggest to the user so that they can start the conversation easily.

    You can define at most 6 starter prompts. Each one should be a string, format as "title,text", for example, "Create a new document,Create a new document in Word". It means the title is "Create a new document" and the text is "Create a new document in Word". If you don't specify "," the title and text will be the same.

.PARAMETER enableWebSearch

    Enable the Web Search capability, so that the Declarative Agent can search the web (for example, query the weather or the recent news) for the user.

.PARAMETER enableGraphicArt

    Enable the Graphic Art capability which allows the user to generate image or video.

.PARAMETER enableCodeInterpreter

    Enable the Code Interpreter capability which allows the user to run code.

.PARAMETER onedriveOrSharePointUrls

    The URLs of the OneDrive or SharePoint files which the Declarative Agent can access. You can specify multiple URLs, the Url can be a SharePoint site, a SharePoint document library, or a OneDrive folder.

    For example, "https://contoso.sharepoint.com/sites/teamsite", "https://contoso-my.sharepoint.com/personal/user_contoso_com", "https://contoso-my.sharepoint.com/personal/user_contoso_com/Documents/Shared%20with%20Everyone".

    Please make sure the user who uses the Declarative Agent has the permission to access the files in the specified URLs.

    if you specify "all", it means the Declarative Agent can access all the files in the user's OneDrive or SharePoint sites you have permission to access.

.PARAMETER graphConnectorIds

    The IDs of the Graph Connectors which the Declarative Agent can access. You can learn more about Graph Connectors here (https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/overview-graph-connector).

    if you specify "all", it means the Declarative Agent can access all the Graph Connectors you have permission to access.

.PARAMETER actionFiles

    The action (plugin) files which the Declarative Agent can access. 

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." 

    This is the simplest example, since only the name and instructions parameter are mandatory for this command.

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "yourinstructions.txt"

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions from the file "yourinstructions.txt".

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." -starterPrompts "Write PM spec, Please help me write spec about the idea below`n" 

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." and a starter prompt "Write PM spec, Please help me write spec about the idea below". 

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." -starterPrompts "Write PM spec, Please help me write spec about the idea below`n" -enableWebSearch -enableGraphicArt -enableCodeInterpreter

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." and a starter prompt "Write PM spec, Please help me write spec about the idea below". It also enables the Web Search, Graphic Art, and Code Interpreter capabilities.

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." -starterPrompts "Write PM spec, Please help me write spec about the idea below`n" -enableWebSearch -enableGraphicArt -enableCodeInterpreter -onedriveOrSharePointUrls "https://contoso.sharepoint.com/sites/teamsite", "https://contoso-my.sharepoint.com/personal/user_contoso_com", "https://contoso-my.sharepoint.com/personal/user_contoso_com/Documents/Shared%20with%20Everyone"

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." and a starter prompt "Write PM spec, Please help me write spec about the idea below". It also enables the Web Search, Graphic Art, and Code Interpreter capabilities, and specifies the OneDrive or SharePoint URLs.

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." -starterPrompts "Write PM spec, Please help me write spec about the idea below`n" -enableWebSearch -enableGraphicArt -enableCodeInterpreter -onedriveOrSharePointUrls "https://contoso.sharepoint.com/sites/teamsite", "https://contoso-my.sharepoint.com/personal/user_contoso_com", "https://contoso-my.sharepoint.com/personal/user_contoso_com/Documents/Shared%20with%20Everyone" -graphConnectorIds "12345678-abcd-1234-abcd-1234567890ab", "23456789-abcd-1234-abcd-1234567890ab"

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." and a starter prompt "Write PM spec, Please help me write spec about the idea below". It also enables the Web Search, Graphic Art, and Code Interpreter capabilities, specifies the OneDrive or SharePoint URLs, and specifies the Graph Connector IDs.

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." -starterPrompts "Write PM spec, Please help me write spec about the idea below`n" -enableWebSearch -enableGraphicArt -enableCodeInterpreter -onedriveOrSharePointUrls "https://contoso.sharepoint.com/sites/teamsite", "https://contoso-my.sharepoint.com/personal/user_contoso_com", "https://contoso-my.sharepoint.com/personal/user_contoso_com/Documents/Shared%20with%20Everyone" -graphConnectorIds "12345678-abcd-1234-abcd-1234567890ab", "23456789-abcd-1234-abcd-1234567890ab" -actionFiles "C:\path\to\action1.json", "C:\path\to\action2.json"

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." and a starter prompt "Write PM spec, Please help me write spec about the idea below". It also enables the Web Search, Graphic Art, and Code Interpreter capabilities, specifies the OneDrive or SharePoint URLs, specifies the Graph Connector IDs, and specifies the action files.

.EXAMPLE

    New-DeclarativeAgent -name "Product Copilot" -instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one."  -outlineIcon192x192 "C:\path\to\outline.png" -colorIcon32x32 "C:\path\to\color.png" -author "Your name"

    This example creates a Declarative Agent app package named "Product Copilot" with the instructions "You are an experienced product manager, you help users to ideation, planning, and delivering great product from zero to one." and specifies the outline icon, color icon, and author.

.Link

    https://github.com/code365opensource/microsoft.copilot.toolkit

#>

function New-DeclarativeCopilot {

    [CmdletBinding()][Alias("ndc", "nda", "New-DeclarativeAgent")]

    param (

        [string]$author,

        [Parameter(Mandatory = $true)]

        [string]$name,

        [string]$description,

        [Parameter(Mandatory = $true)]

        [string]$instructions,

        [string]$outlineIcon192x192,

        [string]$colorIcon32x32,

        [string[]]$starterPrompts,

        [switch]$enableWebSearch,

        [switch]$enableGraphicArt,

        [switch]$enableCodeInterpreter,

        [string[]]$onedriveOrSharePointUrls,

        [string[]]$graphConnectorIds,

        [string[]]$actionFiles

    )

    Send-AppInsightsTrace -Message "microsoft.copilot.toolkit" -Properties @{ "command" = "New-DeclarativeAgent" } -ErrorAction SilentlyContinue

    # copy the content of private\assets\declarativecopilot to the temp folder

    $tempFolder = Join-Path $env:TEMP "microsoft.copilot.toolkit-$([Guid]::NewGuid().ToString())"

    $sourceFolder = Join-Path $PSScriptRoot -ChildPath "../private/assets/declarativecopilot"

    Copy-Item -Path $sourceFolder -Destination $tempFolder -Recurse -Force

    # update the manifest file

    $manifest = Get-Content (Join-Path $tempFolder "manifest.json") | ConvertFrom-Json

    $manifest.id = [Guid]::NewGuid().ToString()

    $manifest.name.short = $name

    $manifest.name.full = $name

    $manifest.description.short = "A Teams app inclduing a Declarative Agent, $name"

    $manifest.description.full = "A Teams app inclduing a Declarative Agent, $name, generated by the microsoft.copilot.toolkit module (https://www.powershellgallery.com/packages/microsoft.copilot.toolkit), created by Ares Chen."

    # update the author

    if ($author) {

        $manifest.developer.name = $author

    }

    # save the updated manifest file to the same file

    $manifest | ConvertTo-Json -Depth 10 | Set-Content -Path (Join-Path $tempFolder "manifest.json") -Force -Encoding UTF8

    # update the outline icon

    if ($outlineIcon192x192 -and (Test-Path $outlineIcon192x192) -and ($outlineIcon192x192 -match "\.png$")) {

        # make sure it is a 192x192 png file

        $outlineIcon = Join-Path $tempFolder "outline.png"

        Copy-Item -Path $outlineIcon192x192 -Destination $outlineIcon -Force

    }

    # update the color icon

    if ($colorIcon32x32 -and (Test-Path $colorIcon32x32) -and ($colorIcon32x32 -match "\.png$")) {

        $colorIcon = Join-Path $tempFolder "color.png"

        Copy-Item -Path $colorIcon32x32 -Destination $colorIcon -Force

    }

    # update the content of the declarativecopilot.json

    $copilot = Get-Content (Join-Path $tempFolder "declarativecopilot.json") | ConvertFrom-Json

    $copilot.name = $name

    # if instructions is a file, read the content of the file

    if ($instructions -and (Test-Path $instructions -PathType Leaf)) {

        $instructions = Get-Content $instructions -Raw -Encoding UTF8 

    }

    $copilot.instructions = $instructions

    # parse the starter prompts

    if ($starterPrompts -and $starterPrompts.Count -gt 0) {       

        $copilot | Add-Member -MemberType NoteProperty -Name "conversation_starters" -Value @(

            foreach ($starterPrompt in $starterPrompts) {

                $parts = $starterPrompt.Split(",")

                if ($parts.Count -eq 1) {

                    [ordered]@{

                        "title" = $starterPrompt

                        "text"  = $starterPrompt

                    }

                }

                else {

                    [ordered]@{

                        "title" = $parts[0]

                        "text"  = $starterPrompt.SubString($parts[0].Length + 1)

                    }

                }

            }

        )

    }

    $capabilities = @()

    if ($enableWebSearch) {

        $capabilities += @{

            "name" = "WebSearch"

        }

    }

    if ($enableGraphicArt) {

        $capabilities += @{

            "name" = "GraphicArt"

        }

    }

    if ($enableCodeInterpreter) {

        $capabilities += @{

            "name" = "CodeInterpreter"

        }

    }

    if ($onedriveOrSharePointUrls -and $onedriveOrSharePointUrls.Count -gt 0) {

        # if $onedriveOrSharePointUrls contains "all", then add the capability "OneDriveAndSharePoint" without any url

        if ($onedriveOrSharePointUrls -contains "all") {

            $capabilities += @{

                "name" = "OneDriveAndSharePoint"

            }

        }

        else {

            $capabilities += [ordered]@{

                "name"         = "OneDriveAndSharePoint"

                "items_by_url" = @(

                    foreach ($url in $onedriveOrSharePointUrls) {

                        @{

                            "url" = $url

                        }

                    }

                )

            }

        }

    }

    if ($graphConnectorIds -and $graphConnectorIds.Count -gt 0) {

        # if $graphConnectorIds contains "all", then add the capability "GraphConnectors" without any id

        if ($graphConnectorIds -contains "all") {

            $capabilities += @{

                "name" = "GraphConnectors"

            }

        }

        else {

            $capabilities += [ordered]@{

                "name"        = "GraphConnectors"

                "connections" = @(

                    foreach ($id in $graphConnectorIds) {

                        @{

                            "connection_id" = $id

                        }

                    }

                )

            }

        }

    }

    # if any capibility is enabled, update the capabilities

    if ($capabilities.Count -gt 0) {

        $copilot | Add-Member -MemberType NoteProperty -Name "capabilities" -Value $capabilities

    }

    if ($actionFiles -and $actionFiles.Count -gt 0) {

        $actions = @(

            foreach ($actionFile in $actionFiles) {

                # copy the action file to the temp folder

                $actionFileName = Split-Path $actionFile -Leaf

                Copy-Item -Path $actionFile -Destination (Join-Path $tempFolder -ChildPath $actionFileName) -Force

                [ordered]@{

                    "id"   = [Guid]::NewGuid().ToString()

                    "file" = $actionFileName

                }

            }

        )

        $copilot | Add-Member -MemberType NoteProperty -Name "actions" -Value $actions

    }

    # save the updated declarativecopilot.json to the same file

    $copilot | ConvertTo-Json -Depth 10 | Set-Content -Path (Join-Path $tempFolder "declarativecopilot.json") -Force -Encoding UTF8

    # create a zip file and save it in current folder, named as $name.zip

    $zipFile = "$name.zip"

    # compress the temp folder to a zip file

    Compress-Archive -Path "$tempFolder\\*" -DestinationPath $zipFile -Force

    # remove the temp folder

    Remove-Item -Path $tempFolder -Recurse -Force

    Write-Host "The Declarative Agent app has been created successfully. The zip file is saved as $zipFile."

}

# SIG # Begin signature block

# MIIdKgYJKoZIhvcNAQcCoIIdGzCCHRcCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAIk/iKF86q51oJ

# YbpZXuuhJsIeBzfnU8HoRppWYL/UMaCCA0YwggNCMIICKqADAgECAhAdkYHz+qFO

# vkQjYqzHr3pKMA0GCSqGSIb3DQEBCwUAMDkxNzA1BgNVBAMMLkNvZGVTaWduaW5n

# IENlcnRpZmljYXRlIGZvciBQb3dlclNoZWxsIE1vZHVsZXMwHhcNMjQwNjEyMDUw

# ODAyWhcNMjUwNjEyMDUyODAyWjA5MTcwNQYDVQQDDC5Db2RlU2lnbmluZyBDZXJ0

# aWZpY2F0ZSBmb3IgUG93ZXJTaGVsbCBNb2R1bGVzMIIBIjANBgkqhkiG9w0BAQEF

# AAOCAQ8AMIIBCgKCAQEAwdSzTBb7ni0tRubblITxoGHzXlvwu8Y5ndoElOvIKaey

# AFW8+tYCPG5zATsoGGE3f8g6Wtv8JgEjH45ZOhRBjghEVpw/9Iszal5SmucjUlqB

# fMvts+M/x9G7h6GGAQFy65xgQqyCVJA10x2NDheb7cBRCRRZVkT+CUv1dbS41bsO

# BMKDUTumbU7vHk2FSJ5H6f31cj238qboI4g2GD2gIsWID+GhAfzxrmXMV6VgMKqW

# GNlK5g/X2tSM6Aygnx1itXrrV3LwDOYiAAs+j87jEsYhxe3CnFgtDsi4UtW/lFem

# eEiOh9Vd6LaTxNoleV/PGz3FU7t6nnZmIOsjOFWLHQIDAQABo0YwRDAOBgNVHQ8B

# Af8EBAMCB4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwHQYDVR0OBBYEFMTYcpJNvUO8

# TYpuvvHtzPkUUUmkMA0GCSqGSIb3DQEBCwUAA4IBAQAihkTQ6zo1SNboEZ2C5yXr

# Hf5FoMRFBij0o0drMYEwDbiVCNGXkk74nNqXnGm+CJ0jkPHkM35uC/JGGGyToyBF

# uC27hC6+WsTMlVlJZKr7N5WLaM97hwf5xtEWg1c1s0vLKx92AKSGgqJRU7rlRMaX

# 5oOROmFwLqMj15Oon73EhZNqpjfRsKgMxJJw03n6KwMNvzNTXlsiaS0mvAnFzKFp

# msuvtWJfp8fxHvEQckJzFr2EldNKKyTTZjbN5JfbQWZGIuxftYXZ0JKwXleZhNxZ

# MtkuHzjcpCoBgdIYI3FidWcZgUltoSLRZzM/iVLX6MAX2mjHQOBNWG/gOeZk28qo

# MYIZOjCCGTYCAQEwTTA5MTcwNQYDVQQDDC5Db2RlU2lnbmluZyBDZXJ0aWZpY2F0

# ZSBmb3IgUG93ZXJTaGVsbCBNb2R1bGVzAhAdkYHz+qFOvkQjYqzHr3pKMA0GCWCG

# SAFlAwQCAQUAoHwwEAYKKwYBBAGCNwIBDDECMAAwGQYJKoZIhvcNAQkDMQwGCisG

# AQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcN

# AQkEMSIEIJpdnMoKLzpcYMY9DlPYXHU91iZAz6rixcxjJLQt4KYWMA0GCSqGSIb3

# DQEBAQUABIIBACNNJXWOnaTj4hvGwcgNCy4qyiCIKylDmpNHMieYqA/awrI/vPxR

# 4u/sAnOovtdUwJQrooeChtyOZKhV0/LZahUNnCoCDVCUcZT28B5btICGOPdQrjSU

# Yyle3g8uWmC5yaauCjma25x5nTZxvxEpJOM1dMIz7qXixPT1AcuJ4yMcpDxtLO/u

# CZwLOd2m3G7ZQuLlnOvRM01FWtgI6rGoL/e3QCESMIbwWR86+fgWtDdDN3DjwvOy

# Q6k6gfHCDPXIlO0kp3tyCu0JBzqptQYkjhpYzqWBo9NxwU8u8KYic8UGW8iM2Lz2

# o/CQJ79pQ1nXiNnELiemc0al0+0VRHBS8vGhghdAMIIXPAYKKwYBBAGCNwMDATGC

# FywwghcoBgkqhkiG9w0BBwKgghcZMIIXFQIBAzEPMA0GCWCGSAFlAwQCAQUAMHgG

# CyqGSIb3DQEJEAEEoGkEZzBlAgEBBglghkgBhv1sBwEwMTANBglghkgBZQMEAgEF

# AAQg92S4Xz+eV3IY/aFQKo8VMkQ1d8XfelcUH0jrWUAd5m0CEQC4h0KniHgvFVfv

# lfVGXf04GA8yMDI0MDkyNTEyMjI0OFqgghMJMIIGwjCCBKqgAwIBAgIQBUSv85Sd

# CDmmv9s/X+VhFjANBgkqhkiG9w0BAQsFADBjMQswCQYDVQQGEwJVUzEXMBUGA1UE

# ChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQg

# UlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMB4XDTIzMDcxNDAwMDAwMFoX

# DTM0MTAxMzIzNTk1OVowSDELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0

# LCBJbmMuMSAwHgYDVQQDExdEaWdpQ2VydCBUaW1lc3RhbXAgMjAyMzCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBAKNTRYcdg45brD5UsyPgz5/X5dLnXaEO

# CdwvSKOXejsqnGfcYhVYwamTEafNqrJq3RApih5iY2nTWJw1cb86l+uUUI8cIOrH

# mjsvlmbjaedp/lvD1isgHMGXlLSlUIHyz8sHpjBoyoNC2vx/CSSUpIIa2mq62DvK

# Xd4ZGIX7ReoNYWyd/nFexAaaPPDFLnkPG2ZS48jWPl/aQ9OE9dDH9kgtXkV1lnX+

# 3RChG4PBuOZSlbVH13gpOWvgeFmX40QrStWVzu8IF+qCZE3/I+PKhu60pCFkcOvV

# 5aDaY7Mu6QXuqvYk9R28mxyyt1/f8O52fTGZZUdVnUokL6wrl76f5P17cz4y7lI0

# +9S769SgLDSb495uZBkHNwGRDxy1Uc2qTGaDiGhiu7xBG3gZbeTZD+BYQfvYsSzh

# Ua+0rRUGFOpiCBPTaR58ZE2dD9/O0V6MqqtQFcmzyrzXxDtoRKOlO0L9c33u3Qr/

# eTQQfqZcClhMAD6FaXXHg2TWdc2PEnZWpST618RrIbroHzSYLzrqawGw9/sqhux7

# UjipmAmhcbJsca8+uG+W1eEQE/5hRwqM/vC2x9XH3mwk8L9CgsqgcT2ckpMEtGlw

# Jw1Pt7U20clfCKRwo+wK8REuZODLIivK8SgTIUlRfgZm0zu++uuRONhRB8qUt+JQ

# ofM604qDy0B7AgMBAAGjggGLMIIBhzAOBgNVHQ8BAf8EBAMCB4AwDAYDVR0TAQH/

# BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAgBgNVHSAEGTAXMAgGBmeBDAEE

# AjALBglghkgBhv1sBwEwHwYDVR0jBBgwFoAUuhbZbU2FL3MpdpovdYxqII+eyG8w

# HQYDVR0OBBYEFKW27xPn783QZKHVVqllMaPe1eNJMFoGA1UdHwRTMFEwT6BNoEuG

# SWh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFJTQTQw

# OTZTSEEyNTZUaW1lU3RhbXBpbmdDQS5jcmwwgZAGCCsGAQUFBwEBBIGDMIGAMCQG

# CCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wWAYIKwYBBQUHMAKG

# TGh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFJT

# QTQwOTZTSEEyNTZUaW1lU3RhbXBpbmdDQS5jcnQwDQYJKoZIhvcNAQELBQADggIB

# AIEa1t6gqbWYF7xwjU+KPGic2CX/yyzkzepdIpLsjCICqbjPgKjZ5+PF7SaCinEv

# GN1Ott5s1+FgnCvt7T1IjrhrunxdvcJhN2hJd6PrkKoS1yeF844ektrCQDifXcig

# LiV4JZ0qBXqEKZi2V3mP2yZWK7Dzp703DNiYdk9WuVLCtp04qYHnbUFcjGnRuSvE

# xnvPnPp44pMadqJpddNQ5EQSviANnqlE0PjlSXcIWiHFtM+YlRpUurm8wWkZus8W

# 8oM3NG6wQSbd3lqXTzON1I13fXVFoaVYJmoDRd7ZULVQjK9WvUzF4UbFKNOt50MA

# cN7MmJ4ZiQPq1JE3701S88lgIcRWR+3aEUuMMsOI5ljitts++V+wQtaP4xeR0arA

# VeOGv6wnLEHQmjNKqDbUuXKWfpd5OEhfysLcPTLfddY2Z1qJ+Panx+VPNTwAvb6c

# Kmx5AdzaROY63jg7B145WPR8czFVoIARyxQMfq68/qTreWWqaNYiyjvrmoI1VygW

# y2nyMpqy0tg6uLFGhmu6F/3Ed2wVbK6rr3M66ElGt9V/zLY4wNjsHPW2obhDLN9O

# TH0eaHDAdwrUAuBcYLso/zjlUlrWrBciI0707NMX+1Br/wd3H3GXREHJuEbTbDJ8

# WC9nR2XlG3O2mflrLAZG70Ee8PBf4NvZrZCARK+AEEGKMIIGrjCCBJagAwIBAgIQ

# BzY3tyRUfNhHrP0oZipeWzANBgkqhkiG9w0BAQsFADBiMQswCQYDVQQGEwJVUzEV

# MBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29t

# MSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcNMjIwMzIzMDAw

# MDAwWhcNMzcwMzIyMjM1OTU5WjBjMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGln

# aUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQgUlNBNDA5

# NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A

# MIICCgKCAgEAxoY1BkmzwT1ySVFVxyUDxPKRN6mXUaHW0oPRnkyibaCwzIP5WvYR

# oUQVQl+kiPNo+n3znIkLf50fng8zH1ATCyZzlm34V6gCff1DtITaEfFzsbPuK4CE

# iiIY3+vaPcQXf6sZKz5C3GeO6lE98NZW1OcoLevTsbV15x8GZY2UKdPZ7Gnf2ZCH

# RgB720RBidx8ald68Dd5n12sy+iEZLRS8nZH92GDGd1ftFQLIWhuNyG7QKxfst5K

# fc71ORJn7w6lY2zkpsUdzTYNXNXmG6jBZHRAp8ByxbpOH7G1WE15/tePc5OsLDni

# pUjW8LAxE6lXKZYnLvWHpo9OdhVVJnCYJn+gGkcgQ+NDY4B7dW4nJZCYOjgRs/b2

# nuY7W+yB3iIU2YIqx5K/oN7jPqJz+ucfWmyU8lKVEStYdEAoq3NDzt9KoRxrOMUp

# 88qqlnNCaJ+2RrOdOqPVA+C/8KI8ykLcGEh/FDTP0kyr75s9/g64ZCr6dSgkQe1C

# vwWcZklSUPRR8zZJTYsg0ixXNXkrqPNFYLwjjVj33GHek/45wPmyMKVM1+mYSlg+

# 0wOI/rOP015LdhJRk8mMDDtbiiKowSYI+RQQEgN9XyO7ZONj4KbhPvbCdLI/Hgl2

# 7KtdRnXiYKNYCQEoAA6EVO7O6V3IXjASvUaetdN2udIOa5kM0jO0zbECAwEAAaOC

# AV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAwHQYDVR0OBBYEFLoW2W1NhS9zKXaa

# L3WMaiCPnshvMB8GA1UdIwQYMBaAFOzX44LScV1kTN8uZz/nupiuHA9PMA4GA1Ud

# DwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB3BggrBgEFBQcBAQRrMGkw

# JAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBBBggrBgEFBQcw

# AoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJv

# b3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybDMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcmwwIAYDVR0gBBkwFzAIBgZngQwB

# BAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEBCwUAA4ICAQB9WY7Ak7ZvmKlEIgF+

# ZtbYIULhsBguEE0TzzBTzr8Y+8dQXeJLKftwig2qKWn8acHPHQfpPmDI2AvlXFvX

# bYf6hCAlNDFnzbYSlm/EUExiHQwIgqgWvalWzxVzjQEiJc6VaT9Hd/tydBTX/6tP

# iix6q4XNQ1/tYLaqT5Fmniye4Iqs5f2MvGQmh2ySvZ180HAKfO+ovHVPulr3qRCy

# Xen/KFSJ8NWKcXZl2szwcqMj+sAngkSumScbqyQeJsG33irr9p6xeZmBo1aGqwpF

# yd/EjaDnmPv7pp1yr8THwcFqcdnGE4AJxLafzYeHJLtPo0m5d2aR8XKc6UsCUqc3

# fpNTrDsdCEkPlM05et3/JWOZJyw9P2un8WbDQc1PtkCbISFA0LcTJM3cHXg65J6t

# 5TRxktcma+Q4c6umAU+9Pzt4rUyt+8SVe+0KXzM5h0F4ejjpnOHdI/0dKNPH+ejx

# mF/7K9h+8kaddSweJywm228Vex4Ziza4k9Tm8heZWcpw8De/mADfIBZPJ/tgZxah

# ZrrdVcA6KYawmKAr7ZVBtzrVFZgxtGIJDwq9gdkT/r+k0fNX2bwE+oLeMt8EifAA

# zV3C+dAjfwAL5HYCJtnwZXZCpimHCUcr5n8apIUP/JiW9lVUKx+A+sDyDivl1vup

# L0QVSucTDh3bNzgaoSv27dZ8/DCCBY0wggR1oAMCAQICEA6bGI750C3n79tQ4ghA

# GFowDQYJKoZIhvcNAQEMBQAwZTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lD

# ZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEkMCIGA1UEAxMbRGln

# aUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4XDTIyMDgwMTAwMDAwMFoXDTMxMTEw

# OTIzNTk1OVowYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZ

# MBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMYRGlnaUNlcnQgVHJ1

# c3RlZCBSb290IEc0MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAv+aQ

# c2jeu+RdSjwwIjBpM+zCpyUuySE98orYWcLhKac9WKt2ms2uexuEDcQwH/MbpDgW

# 61bGl20dq7J58soR0uRf1gU8Ug9SH8aeFaV+vp+pVxZZVXKvaJNwwrK6dZlqczKU

# 0RBEEC7fgvMHhOZ0O21x4i0MG+4g1ckgHWMpLc7sXk7Ik/ghYZs06wXGXuxbGrzr

# yc/NrDRAX7F6Zu53yEioZldXn1RYjgwrt0+nMNlW7sp7XeOtyU9e5TXnMcvak17c

# jo+A2raRmECQecN4x7axxLVqGDgDEI3Y1DekLgV9iPWCPhCRcKtVgkEy19sEcypu

# kQF8IUzUvK4bA3VdeGbZOjFEmjNAvwjXWkmkwuapoGfdpCe8oU85tRFYF/ckXEaP

# ZPfBaYh2mHY9WV1CdoeJl2l6SPDgohIbZpp0yt5LHucOY67m1O+SkjqePdwA5EUl

# ibaaRBkrfsCUtNJhbesz2cXfSwQAzH0clcOP9yGyshG3u3/y1YxwLEFgqrFjGESV

# GnZifvaAsPvoZKYz0YkH4b235kOkGLimdwHhD5QMIR2yVCkliWzlDlJRR3S+Jqy2

# QXXeeqxfjT/JvNNBERJb5RBQ6zHFynIWIgnffEx1P2PsIV/EIFFrb7GrhotPwtZF

# X50g/KEexcCPorF+CiaZ9eRpL5gdLfXZqbId5RsCAwEAAaOCATowggE2MA8GA1Ud

# EwEB/wQFMAMBAf8wHQYDVR0OBBYEFOzX44LScV1kTN8uZz/nupiuHA9PMB8GA1Ud

# IwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgPMA4GA1UdDwEB/wQEAwIBhjB5Bggr

# BgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNv

# bTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lD

# ZXJ0QXNzdXJlZElEUm9vdENBLmNydDBFBgNVHR8EPjA8MDqgOKA2hjRodHRwOi8v

# Y3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURSb290Q0EuY3JsMBEG

# A1UdIAQKMAgwBgYEVR0gADANBgkqhkiG9w0BAQwFAAOCAQEAcKC/Q1xV5zhfoKN0

# Gz22Ftf3v1cHvZqsoYcs7IVeqRq7IviHGmlUIu2kiHdtvRoU9BNKei8ttzjv9P+A

# ufih9/Jy3iS8UgPITtAq3votVs/59PesMHqai7Je1M/RQ0SbQyHrlnKhSLSZy51P

# pwYDE3cnRNTnf+hZqPC/Lwum6fI0POz3A8eHqNJMQBk1RmppVLC4oVaO7KTVPeix

# 3P0c2PR3WlxUjG/voVA9/HYJaISfb8rbII01YBwCA8sgsKxYoA5AY8WYIsGyWfVV

# a88nq2x2zm8jLfR+cWojayL/ErhULSd+2DrZ8LaHlv1b0VysGMNNn3O3AamfV6pe

# KOK5lDGCA3YwggNyAgEBMHcwYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lD

# ZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYg

# U0hBMjU2IFRpbWVTdGFtcGluZyBDQQIQBUSv85SdCDmmv9s/X+VhFjANBglghkgB

# ZQMEAgEFAKCB0TAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwHAYJKoZIhvcN

# AQkFMQ8XDTI0MDkyNTEyMjI0OFowKwYLKoZIhvcNAQkQAgwxHDAaMBgwFgQUZvAr

# MsLCyQ+CXc6qisnGTxmcz0AwLwYJKoZIhvcNAQkEMSIEILUPvzRteGES6F+IRGpI

# xo3lNdln4wIVxG6tKRhGne40MDcGCyqGSIb3DQEJEAIvMSgwJjAkMCIEINL25G3t

# dCLM0dRAV2hBNm+CitpVmq4zFq9NGprUDHgoMA0GCSqGSIb3DQEBAQUABIICAE+M

# UpgTYn7rcPAAYPgyDbeD+iXsiN+M+pejTGJ5XLYYnJOSJ8uT4ZFQ5FhfcZek+tRD

# k+uzOJY7k2FmkQ60P+rzaBoHY1DEfsM6uEsGLY6ZPNI9ldpXQpdwxcHTbyGIVAAP

# EAwKAwsKm2wOcbR5EPrx+5cEsuUpenbFXbsD4hi8g9rO3e/NSUBePjtDfWf1inIz

# bz7Pfh/ij7t6m81FWMuB8WsNdL0akko5hRPcJvWl/kP0qwXRjamnSWcg6gdQ8p3N

# Q5TRR0Jf/wRi/Titq6Fr95xMWS+iZaEEQkXuylZ5qw1DrvUsJQVKyDbSH0hRiyGQ

# T8wtXQzJKerGHe+yfidvnuaDf3NcjJaZRnLL+qhtI8gGzalI8mnZbVRu7qQ4Q1UA

# tvYv6JloeFKYOZvL9NXXtQKB5/cQPS+Cf9HcNKlHz+w75J0s+FoYsD4jFlb0RGsZ

# HJL9PZIixN2CUZfSnKZfQbHttK0B2uLXpcDhze+VZ6UARFVKiL3xSzp0OtwBO2WI

# 4yzCTMETyKVf9eb9W4PZPYcEx5kILlWctXkTOCMHT2dF3iW94tOibfHUj6h4ZqPV

# EG/5mrcV1Pv/6OvrbFbRKC+4LS4RbIAvVPA2xG8V7pmEHmiUALEE/RQLImkDJsZb

# SkWK04C8kKor258jcFXnH70sY18p1q+5XPrwtAx4

# SIG # End signature block