Fix PR microsoft#6485 pipeline failures

alliscode · alliscode · commit 4490ee2900f0 · 2026-06-11T13:59:47.000-07:00
- Fix dotnet solution project path casing for InvokeHttpRequest on Linux\n- Repair markdown links broken by structure/casing changes across root, dotnet, samples, docs, and declarative workflow docs\n- Update durable-agents docs links to current durable-agents paths\n\nCo-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/README.md b/README.md
@@ -40,15 +40,15 @@ Explore new MAF capabilities and real implementation patterns on the [official b
 - **Python and C#/.NET Support**: Full framework support for both Python and C#/.NET implementations with consistent APIs
   - [Python packages](./python/packages/) | [.NET source](./dotnet/src/)
 - **Multiple Agent Provider Support**: Support for various LLM providers with more being added continuously
-  - [Python examples](./python/samples/02-agents/providers/) | [.NET examples](./dotnet/samples/02-agents/AgentProviders/)
+  - [Python examples](./python/samples/02-agents/providers/) | [.NET examples](./dotnet/samples/02-agents/providers/README.md)
 - **Middleware**: Flexible middleware system for request/response processing, exception handling, and custom pipelines
-  - [Python middleware](./python/samples/02-agents/middleware/) | [.NET middleware](./dotnet/samples/02-agents/Agents/Agent_Step11_Middleware/)
+  - [Python middleware](./python/samples/02-agents/middleware/) | [.NET middleware](./dotnet/samples/02-agents/agents/Agent_Step11_Middleware/)
 - **Orchestration Patterns & Workflows**: Build multi-agent systems with graph-based workflows supporting sequential, concurrent, handoff, and group collaboration patterns; includes checkpointing, streaming, human-in-the-loop, and time-travel
   - [Python workflows](./python/samples/03-workflows/) | [.NET workflows](./dotnet/samples/03-workflows/)
 - **Foundry Hosted Agents (new)**: Deploy and host your agents to Foundry-hosted infrastructure with just 2 additional lines of code
   - [Python samples](./python/samples/04-hosting/foundry-hosted-agents/) | [.NET samples](./dotnet/samples/04-hosting/FoundryHostedAgents/)
 - **Observability**: Built-in OpenTelemetry integration for distributed tracing, monitoring, and debugging
-  - [Python observability](./python/samples/02-agents/observability/) | [.NET telemetry](./dotnet/samples/02-agents/AgentOpenTelemetry/)
+  - [Python observability](./python/samples/02-agents/observability/) | [.NET telemetry](./dotnet/samples/02-agents/observability/)
 - **Declarative Agents**: Define agents using YAML for faster setup and versioning
   - [Declarative agent samples](./declarative-agents/)
 - **Agent Skills**: Build domain-specific knowledge bases from multiple sources—files, inline code, class libraries—for agents to discover and use
@@ -171,7 +171,7 @@ Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Fram
 
 - [Getting Started](./dotnet/samples/01-get-started): progressive tutorial from hello agent to hosting
 - [Agent Concepts](./dotnet/samples/02-agents/Agents): basic agent creation and tool usage
-- [Agent Providers](./dotnet/samples/02-agents/AgentProviders): samples showing different agent providers
+- [Agent Providers](./dotnet/samples/02-agents/providers/README.md): samples showing different agent providers
 - [Workflows](./dotnet/samples/03-workflows): advanced multi-agent patterns and workflow orchestration
 - [Hosting](./dotnet/samples/04-hosting): A2A, Durable Agents, Durable Workflows
 - [End-to-End](./dotnet/samples/05-end-to-end): full applications and demos
diff --git a/declarative-agents/workflow-samples/README.md b/declarative-agents/workflow-samples/README.md
@@ -10,8 +10,8 @@ Workflow workflow = DeclarativeWorkflowBuilder.Build("Marketing.yaml", options);
 ```
 
 These example workflows may be executed by the workflow
-[Samples](../../dotnet/samples/03-workflows/Declarative)
+[Samples](../../dotnet/samples/03-workflows/declarative)
 that are present in this repository.
 
-> See the [README.md](../../dotnet/samples/03-workflows/Declarative/README.md) 
+> See the [README.md](../../dotnet/samples/03-workflows/declarative/README.md) 
  associated with the samples for configuration details.
diff --git a/docs/features/durable-agents/README.md b/docs/features/durable-agents/README.md
@@ -219,7 +219,7 @@ When using the [Durable Task Scheduler](https://learn.microsoft.com/azure/azure-
 
 ## Samples
 
-- **.NET** – [Console app samples](../../../dotnet/samples/04-hosting/DurableAgents/ConsoleApps/) and [Azure Functions samples](../../../dotnet/samples/04-hosting/DurableAgents/AzureFunctions/) covering single-agent, chaining, concurrency, conditionals, human-in-the-loop, long-running tools, MCP tool exposure, and reliable streaming.
+- **.NET** – [Console app samples](../../../dotnet/samples/04-hosting/durable-agents/ConsoleApps/) and [Azure Functions samples](../../../dotnet/samples/04-hosting/durable-agents/AzureFunctions/) covering single-agent, chaining, concurrency, conditionals, human-in-the-loop, long-running tools, MCP tool exposure, and reliable streaming.
 - **Python** – [Durable Task samples](../../../python/samples/04-hosting/durabletask/) covering single-agent, multi-agent, streaming, chaining, concurrency, conditionals, and human-in-the-loop.
 
 ## Packages
diff --git a/dotnet/README.md b/dotnet/README.md
@@ -23,7 +23,7 @@ Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Fram
 ## Examples & Samples
 
 - [Getting Started with Agents](./samples/02-agents/Agents): basic agent creation and tool usage
-- [Agent Provider Samples](./samples/02-agents/AgentProviders): samples showing different agent providers
+- [Agent Provider Samples](./samples/02-agents/providers/README.md): samples showing different agent providers
 - [Workflow Samples](./samples/03-workflows): advanced multi-agent patterns and workflow orchestration
 
 ## Agent Framework Documentation
@@ -33,4 +33,3 @@ Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Fram
 - [Design Documents](../docs/design)
 - [Architectural Decision Records](../docs/decisions)
 - [MSFT Learn Docs](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview)
-
diff --git a/dotnet/agent-framework-dotnet.slnx b/dotnet/agent-framework-dotnet.slnx
@@ -217,7 +217,7 @@
     <Project Path="samples/03-workflows/declarative/ExecuteCode/ExecuteCode.csproj" />
     <Project Path="samples/03-workflows/declarative/ExecuteWorkflow/ExecuteWorkflow.csproj" />
     <Project Path="samples/03-workflows/declarative/FunctionTools/FunctionTools.csproj" />
-    <Project Path="samples/03-workflows/declarative/InvokeHttpRequest/InvokeHttpRequest.csproj" />
+    <Project Path="samples/03-workflows/Declarative/InvokeHttpRequest/InvokeHttpRequest.csproj" />
     <Project Path="samples/03-workflows/declarative/HostedWorkflow/HostedWorkflow.csproj" />
     <Project Path="samples/03-workflows/declarative/InputArguments/InputArguments.csproj" />
     <Project Path="samples/03-workflows/declarative/InvokeFunctionTool/InvokeFunctionTool.csproj" />
diff --git a/dotnet/samples/02-agents/A2A/README.md b/dotnet/samples/02-agents/A2A/README.md
@@ -3,7 +3,7 @@
 These samples demonstrate how to work with Agent-to-Agent (A2A) specific features in the Agent Framework.
 
 For other samples that demonstrate how to use AIAgent instances,
-see the [Getting Started With Agents](../Agents/README.md) samples.
+see the [Getting Started With Agents](../agents/README.md) samples.
 
 ## Prerequisites
 
diff --git a/dotnet/samples/02-agents/README.md b/dotnet/samples/02-agents/README.md
@@ -13,6 +13,6 @@ The getting started samples demonstrate the fundamental concepts and functionali
 | [Agent Open Telemetry](./observability/README.md) | Getting started with OpenTelemetry for agents |
 | [Model Context Protocol](./mcp/README.md) | Getting started with Model Context Protocol |
 | [Agent Skills](./skills/README.md) | Getting started with Agent Skills |
-| [Declarative Agents](./declarative/README.md) | Loading and executing AI agents from YAML configuration files |
+| [Declarative Agents](./agents/Agent_Step16_Declarative/Program.cs) | Loading and executing AI agents from YAML configuration files |
 | [AG-UI](./ag-ui/README.md) | Getting started with AG-UI (Agent UI Protocol) servers and clients |
 | [Dev UI](./devui/README.md) | Interactive web interface for testing and debugging AI agents during development |
diff --git a/dotnet/samples/02-agents/agents/README.md b/dotnet/samples/02-agents/agents/README.md
@@ -46,7 +46,7 @@ Before you begin, ensure you have the following prerequisites:
 |[Providing additional AI Context to an agent using multiple AIContextProviders](./Agent_Step17_AdditionalAIContext/)|This sample demonstrates how to inject additional AI context into a ChatClientAgent using multiple custom AIContextProvider components that are attached to the agent.|
 |[Using compaction pipeline with an agent](./Agent_Step18_CompactionPipeline/)|This sample demonstrates how to use a compaction pipeline to efficiently limit the size of the conversation history for an agent.|
 |[In-function-loop checkpointing](./Agent_Step19_InFunctionLoopCheckpointing/)|This sample demonstrates how to persist chat history after each service call during a tool-calling loop, enabling crash recovery and mid-run observability.|
-|[Dynamic function tools](./Agent_Step20_DynamicFunctionTools/)|This sample demonstrates how to dynamically expand the set of function tools available to an agent during a function-calling loop using the ambient FunctionInvocationContext.|
+| [Dynamic function tools](../Agents/Agent_Step20_DynamicFunctionTools/README.md)|This sample demonstrates how to dynamically expand the set of function tools available to an agent during a function-calling loop using the ambient FunctionInvocationContext.|
 
 ## Running the samples from the console
 
diff --git a/dotnet/samples/02-agents/context-providers/README.md b/dotnet/samples/02-agents/context-providers/README.md
@@ -10,4 +10,4 @@ These samples show how to create an agent with the Agent Framework that uses Mem
 |[Memory with Microsoft Foundry](./AgentWithMemory_Step04_MemoryUsingFoundry/)|This sample demonstrates how to create and run an agent that uses Microsoft Foundry's managed memory service to extract and retrieve individual memories.|
 |[Bounded Chat History with Overflow](./AgentWithMemory_Step05_BoundedChatHistory/)|This sample demonstrates how to create a bounded chat history provider that overflows older messages to a vector store and recalls them as memories.|
 
-> **See also**: [Memory Search with Foundry Agents](../foundry/Agent_Step22_MemorySearch/) - demonstrates using the built-in Memory Search tool with Microsoft Foundry agents.
+> **See also**: [Memory Search with Foundry Agents](../providers/foundry/Agent_Step22_MemorySearch/) - demonstrates using the built-in Memory Search tool with Microsoft Foundry agents.
diff --git a/dotnet/samples/02-agents/evaluation/Evaluation_CustomEvals/README.md b/dotnet/samples/02-agents/evaluation/Evaluation_CustomEvals/README.md
@@ -33,4 +33,4 @@ dotnet run --project .\Evaluation_CustomEvals
 
 - [Evaluation_SimpleEval](../Evaluation_SimpleEval/) — Simplest evaluation using Foundry quality evaluators (Relevance, Coherence)
 - [Evaluation_ExpectedOutputs](../Evaluation_ExpectedOutputs/) — Evaluating against ground-truth expected outputs
-- [Evaluation_MixedProviders](../../../05-end-to-end/Evaluation/Evaluation_MixedProviders/) — Combining custom + Foundry evaluators in one call
+- [Evaluation_MixedProviders](../../../05-end-to-end/evaluation/Evaluation_MixedProviders/) — Combining custom + Foundry evaluators in one call
diff --git a/dotnet/samples/02-agents/evaluation/Evaluation_ExpectedOutputs/README.md b/dotnet/samples/02-agents/evaluation/Evaluation_ExpectedOutputs/README.md
@@ -30,4 +30,4 @@ dotnet run --project .\Evaluation_ExpectedOutputs
 ## See also
 
 - [Evaluation_SimpleEval](../Evaluation_SimpleEval/) — Simplest evaluation with built-in and custom checks
-- [Evaluation_FoundryQuality](../../../05-end-to-end/Evaluation/Evaluation_FoundryQuality/) — Cloud-based quality evaluation with Foundry evaluators
+- [Evaluation_FoundryQuality](../../../05-end-to-end/evaluation/Evaluation_FoundryQuality/) — Cloud-based quality evaluation with Foundry evaluators
diff --git a/dotnet/samples/02-agents/evaluation/Evaluation_Multimodal/README.md b/dotnet/samples/02-agents/evaluation/Evaluation_Multimodal/README.md
@@ -25,5 +25,5 @@ dotnet run --project .\Evaluation_Multimodal
 ## See also
 
 - [Evaluation_SimpleEval](../Evaluation_SimpleEval/) — Simplest evaluation with built-in checks and `agent.EvaluateAsync()`
-- [Evaluation_FoundryQuality](../../../05-end-to-end/Evaluation/Evaluation_FoundryQuality/) — Cloud-based quality evaluation with Foundry evaluators
-- [Evaluation_ConversationSplits](../../../05-end-to-end/Evaluation/Evaluation_ConversationSplits/) — Multi-turn conversation split strategies
+- [Evaluation_FoundryQuality](../../../05-end-to-end/evaluation/Evaluation_FoundryQuality/) — Cloud-based quality evaluation with Foundry evaluators
+- [Evaluation_ConversationSplits](../../../05-end-to-end/evaluation/Evaluation_ConversationSplits/) — Multi-turn conversation split strategies
diff --git a/dotnet/samples/02-agents/evaluation/Evaluation_SimpleEval/README.md b/dotnet/samples/02-agents/evaluation/Evaluation_SimpleEval/README.md
@@ -32,4 +32,4 @@ dotnet run --project .\Evaluation_SimpleEval
 
 - [Evaluation_CustomEvals](../Evaluation_CustomEvals/) — Writing custom domain-specific evaluation checks
 - [Evaluation_ExpectedOutputs](../Evaluation_ExpectedOutputs/) — Evaluating against ground-truth expected outputs
-- [Evaluation_MixedProviders](../../../05-end-to-end/Evaluation/Evaluation_MixedProviders/) — Combining local + Foundry evaluators in one call
+- [Evaluation_MixedProviders](../../../05-end-to-end/evaluation/Evaluation_MixedProviders/) — Combining local + Foundry evaluators in one call
diff --git a/dotnet/samples/02-agents/mcp/README.md b/dotnet/samples/02-agents/mcp/README.md
@@ -22,7 +22,7 @@ Before you begin, ensure you have the following prerequisites:
 |[Agent with MCP server tools](./Agent_MCP_Server/)|This sample demonstrates how to use MCP server tools with a simple agent|
 |[Agent with MCP server tools and authorization](./Agent_MCP_Server_Auth/)|This sample demonstrates how to use MCP Server tools from a protected MCP server with a simple agent|
 |[Responses Agent with Hosted MCP tool](./ResponseAgent_Hosted_MCP/)|This sample demonstrates how to use the Hosted MCP tool with the Responses Service, where the service invokes any MCP tools directly|
-|[Agent with long-running MCP task (transparent polling)](./Agent_MCP_LongRunningTask_Client/)|This sample demonstrates how an agent transparently drives a long-running MCP task (SEP-2663) to completion. The wrapper polls the task internally on both `RunAsync` and `RunStreamingAsync` invocations.|
+|[Agent with long-running MCP task (transparent polling)](../ModelContextProtocol/Agent_MCP_LongRunningTask_Client/README.md)|This sample demonstrates how an agent transparently drives a long-running MCP task (SEP-2663) to completion. The wrapper polls the task internally on both `RunAsync` and `RunStreamingAsync` invocations.|
 
 ## Running the samples from the console
 
diff --git a/dotnet/samples/02-agents/providers/anthropic/README.md b/dotnet/samples/02-agents/providers/anthropic/README.md
@@ -6,7 +6,7 @@ of single agents using Anthropic as the AI provider.
 These samples use Anthropic Claude models as the AI provider and use ChatCompletion as the type of service.
 
 For other samples that demonstrate how to create and configure each type of agent that come with the agent framework,
-see the [How to create an agent for each provider](../providers/README.md) samples.
+see the [How to create an agent for each provider](../README.md) samples.
 
 ## Getting started with agents using Anthropic prerequisites
 
@@ -20,7 +20,7 @@ Before you begin, ensure you have the following prerequisites:
 
 ## Using Anthropic with Microsoft Foundry
 
-To use Anthropic with Microsoft Foundry, you can check the sample [providers/Agent_With_Anthropic](../providers/Agent_With_Anthropic/README.md) for more details.
+To use Anthropic with Microsoft Foundry, you can check the sample [providers/Agent_With_Anthropic](./Agent_With_Anthropic/README.md) for more details.
 
 ## Samples
 
@@ -70,4 +70,3 @@ dotnet run
 Open the solution in Visual Studio and set the desired sample project as the startup project. Then, run the project using the built-in debugger or by pressing `F5`.
 
 You will be prompted for any required environment variables if they are not already set.
-
diff --git a/dotnet/samples/02-agents/providers/foundry/README.md b/dotnet/samples/02-agents/providers/foundry/README.md
@@ -73,8 +73,8 @@ Some samples require extra tool-specific environment variables. See each sample
 | [Memory search](./Agent_Step22_MemorySearch/) | Memory search tool |
 | [Local MCP](./Agent_Step23_LocalMCP/) | Local MCP client with HTTP transport |
 | [Code interpreter file download](./Agent_Step24_CodeInterpreterFileDownload/) | Download container files generated by code interpreter |
-| [Foundry toolbox via MCP](./Agent_Step25_FoundryToolboxMcp/) | Use a Foundry Toolbox from a non-hosted agent via its MCP endpoint |
-| [Foundry toolbox MCP skills](./Agent_Step26_FoundryToolboxMcpSkills/) | Use a Foundry Toolbox with MCP-based skills discovery (SEP-2640) via AIContextProviders |
+| [Foundry toolbox via MCP](../../AgentsWithFoundry/Agent_Step25_FoundryToolboxMcp/README.md) | Use a Foundry Toolbox from a non-hosted agent via its MCP endpoint |
+| [Foundry toolbox MCP skills](../../AgentsWithFoundry/Agent_Step26_FoundryToolboxMcpSkills/README.md) | Use a Foundry Toolbox with MCP-based skills discovery (SEP-2640) via AIContextProviders |
 
 ## Running the samples
 
diff --git a/dotnet/samples/02-agents/skills/README.md b/dotnet/samples/02-agents/skills/README.md
@@ -9,7 +9,7 @@ Samples demonstrating Agent Skills capabilities. Each sample shows a different w
 | [Agent_Step03_ClassBasedSkills](Agent_Step03_ClassBasedSkills/) | Define skills as C# classes using `AgentClassSkill`. |
 | [Agent_Step04_MixedSkills](Agent_Step04_MixedSkills/) | **(Advanced)** Combine file-based, code-defined, and class-based skills using `AgentSkillsProviderBuilder`. |
 | [Agent_Step05_SkillsWithDI](Agent_Step05_SkillsWithDI/) | Use Dependency Injection with both code-defined (`AgentInlineSkill`) and class-based (`AgentClassSkill`) skills. |
-| [Agent_Step06_McpBasedSkills](Agent_Step06_McpBasedSkills/) | Discover skills served over the [Model Context Protocol (MCP)](https://modelcontextprotocol.io) via `AgentMcpSkillsSource`. Spins up an in-process MCP server that exposes skills as resources (`skill://...`) and connects an `McpClient` to it. |
+| [Agent_Step06_McpBasedSkills](../AgentSkills/Agent_Step06_McpBasedSkills/README.md) | Discover skills served over the [Model Context Protocol (MCP)](https://modelcontextprotocol.io) via `AgentMcpSkillsSource`. Spins up an in-process MCP server that exposes skills as resources (`skill://...`) and connects an `McpClient` to it. |
 
 ## Key Concepts
 
diff --git a/dotnet/samples/03-workflows/Orchestration/Magentic/README.md b/dotnet/samples/03-workflows/Orchestration/Magentic/README.md
@@ -36,5 +36,5 @@ The sample prints:
 
 ## Related Samples
 
-- [Handoff Orchestration](../Handoff) - another multi-agent orchestration pattern in .NET workflows
+- [Handoff Orchestration](../../orchestrations/Handoff) - another multi-agent orchestration pattern in .NET workflows
 - [Python Magentic workflow sample](../../../../../python/samples/03-workflows/orchestrations/magentic.py) - the source scenario that this sample ports
diff --git a/dotnet/samples/03-workflows/agents/GroupChatToolApproval/README.md b/dotnet/samples/03-workflows/agents/GroupChatToolApproval/README.md
@@ -65,6 +65,6 @@ The sample will show:
 
 ## Related Samples
 
-- [Agent Function Tools with Approvals](../../../02-agents/Agents/Agent_Step01_UsingFunctionToolsWithApprovals) - Basic function approval pattern
+- [Agent Function Tools with Approvals](../../../02-agents/agents/Agent_Step01_UsingFunctionToolsWithApprovals) - Basic function approval pattern
 - [Agent Workflow Patterns](../../_start-here/03_AgentWorkflowPatterns) - Group chat without approvals
 - [Human-in-the-Loop Basic](../../human-in-the-loop/HumanInTheLoopBasic) - Workflow-level human interaction
diff --git a/dotnet/samples/04-hosting/FoundryHostedAgents/responses/Hosted-Files/README.md b/dotnet/samples/04-hosting/FoundryHostedAgents/responses/Hosted-Files/README.md
@@ -34,7 +34,7 @@ This is why the agent has four narrowly-scoped tools instead of a single `ReadFi
 
 ## Companion
 
-[`Using-Samples/SessionFilesClient`](../Using-Samples/SessionFilesClient/) — a thin chat REPL (same shape as [`SimpleAgent`](../Using-Samples/SimpleAgent/)) that points at the deployed Hosted-Files endpoint via `FoundryAgent` and lets you ask questions whose answers come from either file source.
+[`Using-Samples/SessionFilesClient`](../Using-Samples/SessionFilesClient/) — a thin chat REPL (same shape as [`SimpleAgent`](../../../foundry-hosted-agents/responses/Using-Samples/SimpleAgent/Program.cs)) that points at the deployed Hosted-Files endpoint via `FoundryAgent` and lets you ask questions whose answers come from either file source.
 
 ## Live proof of the session-files contract
 
diff --git a/dotnet/samples/04-hosting/FoundryHostedAgents/responses/Hosted-Toolbox-AuthPaths/README.md b/dotnet/samples/04-hosting/FoundryHostedAgents/responses/Hosted-Toolbox-AuthPaths/README.md
diff --git a/dotnet/samples/04-hosting/FoundryHostedAgents/responses/Using-Samples/SessionFilesClient/README.md b/dotnet/samples/04-hosting/FoundryHostedAgents/responses/Using-Samples/SessionFilesClient/README.md
diff --git a/dotnet/samples/04-hosting/a2a/README.md b/dotnet/samples/04-hosting/a2a/README.md
diff --git a/dotnet/samples/04-hosting/durable-workflows/README.md b/dotnet/samples/04-hosting/durable-workflows/README.md
diff --git a/dotnet/samples/04-hosting/foundry-hosted-agents/responses/Hosted-McpTools/README.md b/dotnet/samples/04-hosting/foundry-hosted-agents/responses/Hosted-McpTools/README.md
diff --git a/dotnet/samples/04-hosting/foundry-hosted-agents/responses/Hosted-Toolbox/README.md b/dotnet/samples/04-hosting/foundry-hosted-agents/responses/Hosted-Toolbox/README.md
diff --git a/dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/README.md b/dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/README.md
