Repo sync for protected branch

.openpublishing.redirection.json

@@ -907,22 +907,32 @@
     },
     {
       "source_path": "agent-framework/tutorials/agents/structured-output.md",
-      "redirect_url": "/agent-framework/agents/structured-output",
+      "redirect_url": "/agent-framework/agents/structured-outputs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "agent-framework/agents/structured-output.md",
+      "redirect_url": "/agent-framework/agents/structured-outputs",
       "redirect_document_id": true
     },
     {
       "source_path": "agent-framework/tutorials/agents/images.md",
       "redirect_url": "/agent-framework/agents/multimodal",
       "redirect_document_id": true
     },
+    {
+      "source_path": "agent-framework/integrations/azure-functions.md",
+      "redirect_url": "/agent-framework/integrations/durable-extension",
+      "redirect_document_id": true
+    },
     {
       "source_path": "agent-framework/tutorials/agents/create-and-run-durable-agent.md",
-      "redirect_url": "/agent-framework/integrations/azure-functions",
+      "redirect_url": "/agent-framework/integrations/durable-extension",
       "redirect_document_id": true
     },
     {
       "source_path": "agent-framework/tutorials/agents/orchestrate-durable-agents.md",
-      "redirect_url": "/agent-framework/integrations/azure-functions",
+      "redirect_url": "/agent-framework/integrations/durable-extension",
       "redirect_document_id": false
     },
     {
@@ -1072,12 +1082,12 @@
     },
     {
       "source_path": "agent-framework/user-guide/agents/agent-types/durable-agent/create-durable-agent.md",
-      "redirect_url": "/agent-framework/integrations/azure-functions",
+      "redirect_url": "/agent-framework/integrations/durable-extension",
       "redirect_document_id": false
     },
     {
       "source_path": "agent-framework/user-guide/agents/agent-types/durable-agent/features.md",
-      "redirect_url": "/agent-framework/integrations/azure-functions",
+      "redirect_url": "/agent-framework/integrations/durable-extension",
       "redirect_document_id": false
     },
     {

agent-framework/AGENTS.md

@@ -27,7 +27,7 @@ agent-framework/
 ├── agents/                    # Deep-dive reference
 │   ├── index.md               # Agents overview & landing
 │   ├── running-agents.md
-│   ├── structured-output.md
+│   ├── structured-outputs.md
 │   ├── declarative.md
 │   ├── observability.md
 │   ├── rag.md
@@ -69,7 +69,7 @@ agent-framework/
 │   ├── ag-ui/                 # AG-UI Protocol (multi-page)
 │   │   ├── index.md
 │   │   └── ...
-│   ├── azure-functions.md
+│   ├── durable-extension.md
 │   ├── openai-endpoints.md
 │   ├── m365.md
 │   └── purview.md
@@ -162,7 +162,7 @@ title: "Page Title"
 description: "One-line description for SEO"
 zone_pivot_groups: programming-languages
 author: eavanvalkenburg
-ms.topic: conceptual        # or "tutorial" for get-started
+ms.topic: article           # or "tutorial" for get-started
 ms.date: MM/DD/YYYY
 ms.service: agent-framework
 ---
@@ -195,7 +195,7 @@ Every docs page maps to sample files in both repos:
 | `get-started/add-tools.md` | `01-get-started/02_add_tools.py` | `01-get-started/02_AddTools.cs` |
 | `get-started/multi-turn.md` | `01-get-started/03_multi_turn.py` | `01-get-started/03_MultiTurn.cs` |
 | `get-started/memory.md` | `01-get-started/04_memory.py` | `01-get-started/04_Memory.cs` |
-| `get-started/workflows.md` | `01-get-started/05_first_workflow.py` | `01-get-started/05_FirstWorkflow.cs` |
+| `get-started/workflows.md` | `01-get-started/07_first_graph_workflow.py` | `01-get-started/05_FirstWorkflow.cs` |
 | `get-started/hosting.md` | `04-hosting/azure_functions/01_single_agent/function_app.py` | `01-get-started/06_HostYourAgent.cs` |
 | `agents/tools/function-tools.md` | `02-agents/tools/function_tools.py` | `02-agents/tools/FunctionTools.cs` |
 | `agents/tools/web-search.md` | `02-agents/tools/web_search.py` | `02-agents/tools/WebSearch.cs` |
@@ -204,13 +204,16 @@ Every docs page maps to sample files in both repos:
 | `agents/tools/hosted-mcp-tools.md` | `02-agents/tools/hosted_mcp_tools.py` | `02-agents/tools/HostedMcpTools.cs` |
 | `agents/tools/local-mcp-tools.md` | `02-agents/tools/local_mcp_tools.py` | `02-agents/tools/LocalMcpTools.cs` |
 | `agents/tools/tool-approval.md` | `02-agents/tools/tool_approval.py` | `02-agents/tools/ToolApproval.cs` |
+| `agents/code_act.md` | `02-agents/context_providers/code_act/code_act.py` | `02-agents/AgentWithCodeAct/` |
+| `agents/harness.md` | `02-agents/harness/` | `02-agents/Harness/` |
 | `agents/middleware/*.md` | `02-agents/middleware/<matching>.py` | `02-agents/middleware/<matching>.cs` |
 | `agents/providers/foundry-local.md` | `02-agents/providers/foundry/foundry_local_agent.py` | N/A |
 | `agents/providers/*.md` | `02-agents/providers/<matching>.py` | `02-agents/providers/<matching>.cs` |
 | `agents/conversations/*.md` | `02-agents/conversations/<matching>.py` | `02-agents/conversations/<matching>.cs` |
 | `workflows/<pattern>.md` | `03-workflows/<pattern>/<matching>.py` | `03-workflows/<pattern>/<matching>.cs` |
+| `integrations/hyperlight.md` | `02-agents/context_providers/code_act/code_act.py` | `02-agents/AgentWithCodeAct/` |
 | `integrations/a2a.md` | `04-hosting/a2a/` | `04-hosting/a2a/` |
-| `integrations/azure-functions.md` | `04-hosting/azure-functions/` | `04-hosting/azure-functions/` |
+| `integrations/durable-extension.md` | `04-hosting/azure_functions/`, `04-hosting/durabletask/` | `04-hosting/DurableAgents/`, `04-hosting/DurableWorkflows/` |
 
 ## When adding a new docs page
 

agent-framework/TOC.yml

@@ -28,8 +28,8 @@ items:
     href: agents/agent-pipeline.md
   - name: Multimodal
     href: agents/multimodal.md
-  - name: Structured Output
-    href: agents/structured-output.md
+  - name: Structured Outputs
+    href: agents/structured-outputs.md
   - name: Background Responses
     href: agents/background-responses.md
   - name: RAG
@@ -38,16 +38,26 @@ items:
     href: agents/declarative.md
   - name: Observability
     href: agents/observability.md
+  - name: Evaluation
+    href: agents/evaluation.md
   - name: Agent Skills
     href: agents/skills.md
+  - name: Agent Harnesses
+    href: agents/harness.md
+  - name: CodeAct
+    href: agents/code_act.md
   - name: Agent Safety
     href: agents/safety.md
+  - name: Agent Security (FIDES)
+    href: agents/security.md
   - name: Tools
     items:
     - name: Overview
       href: agents/tools/index.md
     - name: Function Tools
       href: agents/tools/function-tools.md
+    - name: Controlling tool availability
+      href: agents/tools/controlling-tool-availability.md
     - name: Tool Approval
       href: agents/tools/tool-approval.md
     - name: Code Interpreter
@@ -112,68 +122,78 @@ items:
       href: agents/providers/github-copilot.md
     - name: Copilot Studio
       href: agents/providers/copilot-studio.md
+    - name: A2A
+      href: agents/providers/agent-to-agent.md
     - name: Custom Provider
       href: agents/providers/custom.md
 - name: Workflows
   items:
   - name: Overview
     href: workflows/index.md
-  - name: Executors
-    href: workflows/executors.md
-  - name: Edges
-    href: workflows/edges.md
-  - name: Events
-    href: workflows/events.md
-  - name: Workflow Builder & Execution
-    href: workflows/workflows.md
-  - name: Agents in Workflows
-    href: workflows/agents-in-workflows.md
-  - name: Human-in-the-Loop
-    href: workflows/human-in-the-loop.md
-  - name: State Management
-    href: workflows/state.md
-  - name: Checkpoints & Resuming
-    href: workflows/checkpoints.md
-  - name: Declarative Workflows
-    href: workflows/declarative.md
-  - name: Observability
-    href: workflows/observability.md
-  - name: Workflows as Agents
-    href: workflows/as-agents.md
-  - name: Visualization
-    href: workflows/visualization.md
-  - name: Orchestrations
+  - name: Functional
     items:
-    - name: Overview
-      href: workflows/orchestrations/index.md
-    - name: Sequential
-      href: workflows/orchestrations/sequential.md
-    - name: Concurrent
-      href: workflows/orchestrations/concurrent.md
-    - name: Handoff
-      href: workflows/orchestrations/handoff.md
-    - name: Group Chat
-      href: workflows/orchestrations/group-chat.md
-    - name: Magentic
-      href: workflows/orchestrations/magentic.md
-  - name: Advanced
+    - name: Functional Workflow API
+      href: workflows/functional.md
+  - name: Graph-based
     items:
-    - name: Agent Executor
-      href: workflows/advanced/agent-executor.md
-    - name: Execution Modes
-      href: workflows/advanced/execution-modes.md
-    - name: Resettable Executors
-      href: workflows/advanced/resettable-executors.md
-    - name: Sub-Workflows
-      href: workflows/advanced/sub-workflows.md
+    - name: Executors
+      href: workflows/executors.md
+    - name: Edges
+      href: workflows/edges.md
+    - name: Events
+      href: workflows/events.md
+    - name: Workflow Builder & Execution
+      href: workflows/workflows.md
+    - name: Agents in Workflows
+      href: workflows/agents-in-workflows.md
+    - name: Human-in-the-Loop
+      href: workflows/human-in-the-loop.md
+    - name: State Management
+      href: workflows/state.md
+    - name: Checkpoints & Resuming
+      href: workflows/checkpoints.md
+    - name: Declarative Workflows
+      href: workflows/declarative.md
+    - name: Observability
+      href: workflows/observability.md
+    - name: Workflows as Agents
+      href: workflows/as-agents.md
+    - name: Visualization
+      href: workflows/visualization.md
+    - name: Orchestrations
+      items:
+      - name: Overview
+        href: workflows/orchestrations/index.md
+      - name: Sequential
+        href: workflows/orchestrations/sequential.md
+      - name: Concurrent
+        href: workflows/orchestrations/concurrent.md
+      - name: Handoff
+        href: workflows/orchestrations/handoff.md
+      - name: Group Chat
+        href: workflows/orchestrations/group-chat.md
+      - name: Magentic
+        href: workflows/orchestrations/magentic.md
+    - name: Advanced
+      items:
+      - name: Agent Executor
+        href: workflows/advanced/agent-executor.md
+      - name: Execution Modes
+        href: workflows/advanced/execution-modes.md
+      - name: Resettable Executors
+        href: workflows/advanced/resettable-executors.md
+      - name: Sub-Workflows
+        href: workflows/advanced/sub-workflows.md
 - name: Integrations
   items:
   - name: Overview
     href: integrations/index.md
-  - name: Azure Functions (Durable)
-    href: integrations/azure-functions.md
+  - name: Durable Extension
+    href: integrations/durable-extension.md
   - name: OpenAI-Compatible Endpoints
     href: integrations/openai-endpoints.md
+  - name: Hyperlight CodeAct
+    href: integrations/hyperlight.md
   - name: Purview
     href: integrations/purview.md
   - name: M365
@@ -198,12 +218,44 @@ items:
       href: integrations/ag-ui/frontend-tools.md
     - name: Security Considerations
       href: integrations/ag-ui/security-considerations.md
+    - name: Workflows
+      href: integrations/ag-ui/workflows.md
     - name: Human-in-the-Loop
       href: integrations/ag-ui/human-in-the-loop.md
+    - name: MCP Apps Compatibility
+      href: integrations/ag-ui/mcp-apps.md
     - name: State Management
       href: integrations/ag-ui/state-management.md
     - name: Testing with Dojo
       href: integrations/ag-ui/testing-with-dojo.md
+- name: Hosting
+  items:
+  - name: Foundry Hosted Agents
+    href: hosting/foundry-hosted-agent.md
+  - name: A2A
+    href: hosting/agent-to-agent.md
+- name: The Agent Development Journey
+  items:
+  - name: Overview
+    href: journey/index.md
+  - name: LLM Fundamentals
+    href: journey/llm-fundamentals.md
+  - name: From LLMs to Agents
+    href: journey/from-llms-to-agents.md
+  - name: Adding Tools
+    href: journey/adding-tools.md
+  - name: Adding Skills
+    href: journey/adding-skills.md
+  - name: Adding Middleware
+    href: journey/adding-middleware.md
+  - name: Context Providers
+    href: journey/adding-context-providers.md
+  - name: Agents as Tools
+    href: journey/agents-as-tools.md
+  - name: "Agent-to-Agent (A2A)"
+    href: journey/agent-to-agent.md
+  - name: Workflows
+    href: journey/workflows.md
 - name: DevUI
   items:
   - name: Overview
@@ -232,6 +284,8 @@ items:
       href: migration-guide/from-semantic-kernel/index.md
     - name: Migration Samples
       href: migration-guide/from-semantic-kernel/samples.md
+  - name: A2A SDK v1
+    href: migration-guide/agent-to-agent-sdk-v1.md
 - name: API Reference
   items:
   - name: .NET API Reference

agent-framework/agents/agent-pipeline.md

@@ -3,7 +3,7 @@ title: Agent Pipeline Architecture
 description: Understand how agents build their internal pipeline of middleware, context providers, and chat clients.
 zone_pivot_groups: programming-languages
 author: eavanvalkenburg
-ms.topic: conceptual
+ms.topic: article
 ms.author: edvan
 ms.date: 04/02/2026
 ms.service: agent-framework