Merge remote-tracking branch 'origin/feature/foundry-release' into nichella-merge-main-conflicts-only

# Conflicts:
#	specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.json
#	specification/ai-foundry/data-plane/Foundry/openapi3/v1/microsoft-foundry-openapi3.yaml
#	specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.json
#	specification/ai-foundry/data-plane/Foundry/openapi3/virtual-public-preview/microsoft-foundry-openapi3.yaml
#	specification/ai-foundry/data-plane/Foundry/src/toolboxes/models.tsp

Author: NivedhaChellam

.github/.prettierignore

@@ -24,3 +24,6 @@ PULL_REQUEST_TEMPLATE
 
 # synced from external repos
 workflows/post-apiview.yml
+
+# synced GitHub skills
+.github/skills/azsdk-common-*

.github/CODEOWNERS

@@ -13,7 +13,7 @@
 /specification/schemaregistry/ @hmlam @nickghardwick @lmazuel @deyaaeldeen @JoshLove-msft @swathipil @conniey @minhanh-phan
 
 # PRLabel: %Cognitive Services
-/dev/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan
+/dev/cognitiveservices/data-plane/Language/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan
 
 # PRLabel: %Foundry  %Client
 /specification/ai-foundry/data-plane/Foundry @johanste @trrwilson @glecaros @balapv @dargilco @qubitron
@@ -42,7 +42,7 @@
 /specification/asazure/ @athipp
 
 # PRLabel: %Authorization
-/specification/authorization/ @darshanhs90
+/specification/authorization/ @jruttle @abaccin @denyspanov-public @chocomochiko
 
 # PRLabel: %Automation
 /specification/automation/ @vrdmr
@@ -71,19 +71,19 @@
 /specification/cognitiveservices/data-plane/FormRecognizer/ @bojunehsu @nizi1127 @johanste
 
 # PRLabel: %Cognitive - Language
-/specification/cognitiveservices/data-plane/LanguageAnalyzeConversations/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeConversations/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeConversationsAuthoring/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeConversationsAuthoring/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeDocuments/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeDocuments/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeText/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeText/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageAnalyzeTextAuthoring/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageAnalyzeTextAuthoring/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageQuestionAnswering/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageQuestionAnswering/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
-/specification/cognitiveservices/data-plane/LanguageQuestionAnsweringAuthoring/ @assafi @rokulka @ChongTang @annatisch @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
+/specification/cognitiveservices/data-plane/LanguageQuestionAnsweringAuthoring/ @assafi @rokulka @ChongTang @heaths @deyaaeldeen @joseharriaga @minhanh-phan @bidisha-c @mikaelsitruk @sarkar-rajarshi @quentinRobinson @ahmedaashour
 
 
 # PRLabel: %Compute
@@ -290,38 +290,41 @@
 ###########
 # Eng Sys
 ###########
-/.gitattributes     @weshaggard @mikeharder
-/.gitignore         @weshaggard @mikeharder
-/.prettierrc.json   @weshaggard @mikeharder
-/package-lock.json  @weshaggard @mikeharder
-/package.json       @weshaggard @mikeharder
-/tsconfig.json      @weshaggard @mikeharder
-/.azure-pipelines/  @weshaggard @mikeharder @benbp
-/.github/           @weshaggard @mikeharder @benbp
-/.vscode/           @weshaggard @mikeharder @benbp
-/dev/               @weshaggard @mikeharder @benbp
-/eng/               @weshaggard @mikeharder @benbp
+/.gitattributes     @mikeharder @benbp
+/.gitignore         @mikeharder @benbp
+/.prettierrc.json   @mikeharder @benbp
+/package-lock.json  @mikeharder @benbp
+/package.json       @mikeharder @benbp
+/tsconfig.json      @mikeharder @benbp
+/.azure-pipelines/  @mikeharder @benbp
+/.github/           @mikeharder @benbp
+/.vscode/           @mikeharder @benbp
+/dev/               @mikeharder @benbp
+/eng/               @mikeharder @benbp
 /eng/common/        @Azure/azure-sdk-eng
 /eng/tools/typespec-migration-validation @pshao25 @live1206
 /eng/tools/typespec-validation/**/sdk-tspconfig-validation*.ts @marygao @raych1 @maririos
-/scripts/           @weshaggard @mikeharder
-/specification/suppressions.yaml @weshaggard @mikeharder @benbp @raych1 @marygao @maririos @qiaozha
+/scripts/           @mikeharder @benbp
+/specification/suppressions.yaml @mikeharder @benbp @raych1 @marygao @maririos @qiaozha
 /.github/CODEOWNERS @Azure/azure-sdk-eng
 /.github/skills     @Azure/azure-sdk-eng @chunyu3 @lirenhe @ArthurMa1978 @haolingdong-msft
 
+## OpenAI TypeSpec Definitions (@azure-tools/openai-typespec)
+/.github/skills/openai-typespec-update/ @Azure/azure-sdk-eng @baywet @glecaros
+
 ## Copilot
 
-/.github/copilot-instructions.md @praveenkuttappan @maririos
-/.github/prompts/                @praveenkuttappan @maririos
-/.github/instructions/           @praveenkuttappan @maririos
-/.github/chatmodes/              @praveenkuttappan @maririos
+/.github/copilot-instructions.md         @praveenkuttappan @maririos
+/.github/copilot-review-instructions.md  @ravimeda @praveenkuttappan
+/.github/prompts/                        @praveenkuttappan @maririos
+/.github/instructions/                   @praveenkuttappan @maririos
+/.github/chatmodes/                      @praveenkuttappan @maririos
 
 ## ARM API Reviewer
 
-/.github/agents/*arm*.md                @raosuhas @ravimeda @laxmankumar12
-/.github/instructions/*arm*.md          @raosuhas @ravimeda @laxmankumar12
-/.github/skills/azure-api-review/       @raosuhas @ravimeda @laxmankumar12
-/documentation/api-reviewer-agent.md    @raosuhas @ravimeda @laxmankumar12
+/.github/**/*arm-*.md                  @raosuhas @ravimeda @laxmankumar12
+/.github/skills/azure-api-review/      @raosuhas @ravimeda @laxmankumar12
+/documentation/api-reviewer-agent.md   @raosuhas @ravimeda @laxmankumar12
 
 ## ARM API Modeling Reviewers
 

.github/agents/README.md

@@ -0,0 +1,29 @@
+# agents
+
+Custom Copilot Chat agents for this repo. Each `*.agent.md` at the top
+level is auto-registered by Visual Studio Code.
+
+## Agents
+
+| File                                                                 | Purpose                                                                          | User-invocable? |
+| -------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------- |
+| [`arm-api-reviewer.agent.md`](./arm-api-reviewer.agent.md)           | Reviews Azure REST API spec PRs; findings verified by the Critic before posting. | Yes             |
+| [`arm-api-review-critic.agent.md`](./arm-api-review-critic.agent.md) | Internal subagent invoked by the Reviewer at Step 7 to re-verify findings.       | No              |
+| [`hero-scenarios.agent.md`](./hero-scenarios.agent.md)               | Suggests hero scenarios from TypeSpec to seed SDK samples, docs, and tests.      | Yes             |
+
+## Shared protocols
+
+Multi-agent contracts live in [`protocols/`](./protocols/). The
+subdirectory keeps reference files out of Visual Studio Code's agent scan path.
+
+- [`protocols/arm-api-review-critic.protocol.md`](./protocols/arm-api-review-critic.protocol.md)
+  is the Reviewer-Critic wire contract (inputs, verdicts, sentinels, marker schemas).
+  Source of truth if either agent file disagrees.
+
+## Conventions
+
+- Filename: `<short-name>.agent.md`, lowercase-hyphenated.
+- Internal subagents: set `user-invocable: false` in frontmatter.
+- Extract shared schemas to `protocols/` to prevent drift.
+- Prefer explicit tool allowlists over `github/*` for read-only agents.
+- No emoji or non-ASCII chars except where required by agent output.