444 Commits

• Fix PR review issues: retry off-by-one, URI encoding, docs, tests, build

  - Fix off-by-one in FoundryToolboxBearerTokenHandler retry loop (4 attempts → 3)
  - URI-encode version parameter in HostedMcpToolboxAITool.BuildAddress
  - Add XML doc clarifying version pinning is reserved for future use
  - Add comment clarifying AddHostedService deduplication safety
  - Fix DevTemporaryTokenCredential expiry to use DateTimeOffset.MaxValue
  - Fix AgentCard ambiguity in A2AServer sample with using alias
  - Add 18 new unit tests for retry handler and ReadMcpToolboxMarkers
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-20 12:10:53 -07:00
  bbbb78b8df
• Rename toolset to toolbox in user-facing API; rename ConsentAwareMcpClientTool to ConsentAwareMcpClientAIFunction
  Roger Barreto · 2026-04-17 23:21:56 +01:00
  1f4bcd6c88
• feat: Add Foundry Toolbox (MCP) support to AgentFrameworkResponseHandler

  Adds support for Foundry Toolsets MCP proxy integration in the hosted agent
  response handler. Toolsets connect at startup via IHostedService, gating the
  readiness probe per spec §3.1. MCP tools are injected into every request's
  ChatOptions and OAuth consent errors (-32006) are intercepted and surfaced as
  mcp_approval_request + incomplete SSE events.
  
  New files:
  - FoundryToolboxOptions.cs: configuration POCO for toolset names and API version
  - FoundryToolboxBearerTokenHandler.cs: DelegatingHandler with Azure Bearer token
    auth, Foundry-Features header injection, and 3x exponential backoff on 429/5xx
  - McpConsentContext.cs: AsyncLocal-based per-request consent state shared between
    the tool wrapper and the response handler
  - ConsentAwareMcpClientTool.cs: AIFunction wrapper that catches -32006 errors and
    signals consent via shared state and linked CancellationTokenSource
  - FoundryToolboxService.cs: IHostedService that creates McpClient per toolset at
    startup and exposes cached tools
  
  Modified files:
  - AgentFrameworkResponseHandler.cs: injects toolbox tools into ChatOptions, sets
    up linked CTS consent interception, emits mcp_approval_request on -32006
  - ServiceCollectionExtensions.cs: adds AddFoundryToolboxes(params string[]) extension
  - Microsoft.Agents.AI.Foundry.csproj: adds ModelContextProtocol and Azure.Identity
    dependencies under NETCoreApp condition
  
  Sample:
  - Hosted-Toolbox: minimal hosted agent sample using AddFoundryToolboxes

  Roger Barreto · 2026-04-17 23:21:56 +01:00
  9baf76ea77
• Add Dockerfiles, README, agent yamls and bearer token support to Hosted-Workflow-Handoff

  - Add Dockerfile and Dockerfile.contributor for Docker-based testing
  - Add agent.yaml and agent.manifest.yaml with triage-workflow as primary agent
  - Add README.md following sibling pattern, noting Azure OpenAI vs Foundry endpoint
  - Add DevTemporaryTokenCredential and ChainedTokenCredential for Docker auth
  - Register triage-workflow as non-keyed default so azd invoke works without model
  - Update .env.example with AZURE_BEARER_TOKEN sentinel
  - Add .gitignore to 04-hosting to suppress VS-generated launchSettings.json
  - Fix docker run image name in Hosted-Workflow-Simple README

  Roger Barreto · 2026-04-16 13:05:47 +01:00
  518e90e114
• Remove FoundryResponsesRepl and empty FoundryResponsesHosting directory
  Roger Barreto · 2026-04-16 12:44:41 +01:00
  7c9ed7f5d6
• Rename Hosted-Workflows to Hosted-Workflow-Simple, Hosted-WorkflowHandoff to Hosted-Workflow-Handoff
  Roger Barreto · 2026-04-16 12:43:03 +01:00
  77529dc3ea
• Move FoundryResponsesHosting to responses/Hosted-WorkflowHandoff, use GetResponsesClient
  Roger Barreto · 2026-04-16 12:38:29 +01:00
  e6dfdd46f2
• Use placeholder for AGENT_NAME in Hosted-FoundryAgent .env.example
  Roger Barreto · 2026-04-16 12:02:51 +01:00
  10077bdb13
• Remove launchSettings, use .env for port configuration

  - Delete all launchSettings.json files (port 8088 now comes from ASPNETCORE_URLS in .env)
  - Add DotNetEnv to Hosted-Invocations-EchoAgent so it loads .env like the responses samples
  - Create .env.example for EchoAgent with ASPNETCORE_URLS and ASPNETCORE_ENVIRONMENT
  - Add AGENT_NAME to ChatClientAgent and FoundryAgent .env.example (required by those samples)
  - Add AZURE_BEARER_TOKEN=DefaultAzureCredential to all .env.example files
  - Update DevTemporaryTokenCredential in all 6 samples to treat the sentinel value
    as unavailable, allowing ChainedTokenCredential to fall through to DefaultAzureCredential
  - Update EchoAgent README with Configuration section

  Roger Barreto · 2026-04-16 11:42:59 +01:00
  98d3a81ed4
• Restructure FoundryHostedAgents samples into invocations/ and responses/

  Align dotnet hosted agent samples with the Python side (PR #5281) by
  reorganizing the directory structure:
  
  - Remove HostedAgentsV1 entirely (old API pattern)
  - Split HostedAgentsV2 into invocations/ and responses/ based on protocol
  - Move Using-Samples accordingly (SimpleAgent to responses, SimpleInvocationsAgent to invocations)
  - Update slnx with new project paths and add previously missing invocations projects
  - Update README cd paths from HostedAgentsV2 to invocations or responses
  - Rename .env.local to .env.example to match Python naming convention
  - Fix format violations in newly included invocations projects

  Roger Barreto · 2026-04-16 11:21:51 +01:00
  d49d546bb4
• Merge branch 'feature/responses-hosting' of https://github.com/microsoft/agent-framework into hosted-agent-adapter

  # Conflicts:
  #	dotnet/nuget/nuget-package.props
  #	dotnet/samples/04-hosting/FoundryHostedAgents/HostedAgentsV2/Hosted-ChatClientAgent/Program.cs
  #	dotnet/samples/04-hosting/FoundryHostedAgents/HostedAgentsV2/Hosted-FoundryAgent/Program.cs
  #	dotnet/samples/04-hosting/FoundryHostedAgents/HostedAgentsV2/Hosted-LocalTools/Program.cs
  #	dotnet/samples/04-hosting/FoundryHostedAgents/HostedAgentsV2/Hosted-McpTools/Program.cs
  #	dotnet/samples/04-hosting/FoundryHostedAgents/HostedAgentsV2/Hosted-Workflows/Program.cs
  #	dotnet/samples/04-hosting/FoundryResponsesHosting/Program.cs
  #	dotnet/tests/Microsoft.Agents.AI.Foundry.UnitTests/Hosting/AgentFrameworkResponseHandlerTests.cs
  #	dotnet/tests/Microsoft.Agents.AI.Foundry.UnitTests/Hosting/InputConverterTests.cs
  #	dotnet/tests/Microsoft.Agents.AI.Foundry.UnitTests/Hosting/OutputConverterTests.cs
  #	dotnet/tests/Microsoft.Agents.AI.Foundry.UnitTests/Hosting/ServiceCollectionExtensionsTests.cs
  #	dotnet/tests/Microsoft.Agents.AI.Foundry.UnitTests/Hosting/WorkflowIntegrationTests.cs

  Roger Barreto · 2026-04-16 09:54:54 +01:00
  030ef3a115
• Add Invocations protocol samples (hosted echo agent + client) (#5278)

  Add Hosted-Invocations-EchoAgent: a minimal echo agent hosted via the
  Invocations protocol (POST /invocations) using AddInvocationsServer and
  MapInvocationsServer, bridged to an Agent Framework AIAgent through a
  custom InvocationHandler.
  
  Add SimpleInvocationsAgent: a console REPL client that wraps HttpClient
  calls to the /invocations endpoint in a custom InvocationsAIAgent,
  demonstrating programmatic consumption of the Invocations protocol.
  
  Both samples default to port 8088 for consistency with other hosted
  agent samples.

  Roger Barreto · 2026-04-16 09:43:13 +01:00
  53fec2a989
• Fix dotnet format: add Async suffix to test methods (IDE1006), fix encoding and style

  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 17:45:22 -07:00
  bc303d87f4
• Fix CHARSET: add UTF-8 BOM to Hosted-LocalTools and Hosted-Workflows

  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 17:20:15 -07:00
  8d30cadc83
• Fix IDE0009: add 'this' qualification in all HostedAgentsV2 samples

  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 17:14:01 -07:00
  c1ea834e1f
• Fix IDE0009: add 'this' qualification in DevTemporaryTokenCredential

  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 17:05:22 -07:00
  e751779da4
• Fixing small issues.
  alliscode · 2026-04-15 16:57:42 -07:00
  5af3d47062
• Add Hosted-McpTools sample with dual MCP pattern

  Demonstrates two MCP integration layers in a single hosted agent:
  - Client-side MCP: McpClient connects to Microsoft Learn, agent handles
    tool invocations locally (docs_search, code_sample_search, docs_fetch)
  - Server-side MCP: HostedMcpServerTool delegates tool discovery and
    invocation to the LLM provider (Responses API), no local connection
  
  Includes DevTemporaryTokenCredential for Docker local debugging,
  Dockerfile.contributor for ProjectReference builds, and the openai/v1
  route mapping for AIProjectClient compatibility in Development mode.

  Roger Barreto · 2026-04-15 16:49:25 -07:00
  930d47789a
• Removing extra using samples
  Roger Barreto · 2026-04-15 16:49:25 -07:00
  8b49a0a207
• Adding LocalTools + Workflow samples
  Roger Barreto · 2026-04-15 16:49:24 -07:00
  e70f20622a
• Address text rag sample working
  Roger Barreto · 2026-04-15 16:49:17 -07:00
  28f3d178e1
• Foundry Agent Hosting
  Roger Barreto · 2026-04-15 16:49:17 -07:00
  ebb3483a2c
• Update chat client agent for contributor and devs
  Roger Barreto · 2026-04-15 16:49:16 -07:00
  9e820aaad7
• Using updates
  Roger Barreto · 2026-04-15 16:49:15 -07:00
  a4519045a4
• Adding SessionStorage and SessionManagement, improving samples to align Consumption vs Hosting
  Roger Barreto · 2026-04-15 16:49:15 -07:00
  ac6a0e3d95
• ChatClientAgent working
  Roger Barreto · 2026-04-15 16:49:14 -07:00
  990330e198
• Hosting Samples update
  Roger Barreto · 2026-04-15 16:49:13 -07:00
  3ef5436537
• Hosting Samples update
  Roger Barreto · 2026-04-15 16:49:12 -07:00
  3984ef4ef1
• Hosting Samples update
  Roger Barreto · 2026-04-15 16:49:11 -07:00
  bf779f2029
• Hosting Samples update
  Roger Barreto · 2026-04-15 16:49:10 -07:00
  d0fc7499b7
• Renaming and merging hosting extensions. (#5091)

  * Rename AddAgentFrameworkHandler to AddFoundryResponses and add MapFoundryResponses
  
  - Rename extension methods: AddAgentFrameworkHandler -> AddFoundryResponses, MapAgentFrameworkHandler -> MapFoundryResponses
  - AddFoundryResponses now calls AddResponsesServer() internally
  - Add MapFoundryResponses() extension on IEndpointRouteBuilder
  - Update sample and tests to use new API names
  - Remove redundant AddResponsesServer() and /ready endpoint from sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fixing numbering in sample.
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Ben Thomas · 2026-04-15 16:45:52 -07:00
  6e834fcac2
• Catch agent errors and emit response.failed with real error message

  Previously, unhandled exceptions from agent execution would bubble up
  to the SDK orchestrator, which emits a generic 'An internal server
  error occurred.' message — hiding the actual cause (e.g., 401 auth
  failures, model not found, etc.).
  
  Now AgentFrameworkResponseHandler catches non-cancellation exceptions
  and emits a proper response.failed event containing the real error
  message, making it visible to clients and in logs.
  
  OperationCanceledException still propagates for proper cancellation
  handling by the SDK.
  
  Also bumps package version to 0.9.0-hosted.260403.2.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 16:45:46 -07:00
  a25502b7c8
• Fix model override bug and add client REPL sample

  - InputConverter: stop propagating request.Model to ChatOptions.ModelId
    Hosted agents use their own model; client-provided model values like
    'hosted-agent' were being passed through and causing server errors.
  - Add FoundryResponsesRepl sample: interactive CLI client that connects
    to a Foundry Responses endpoint using ResponsesClient.AsAIAgent()
  - Bump package version to 0.9.0-hosted.260403.1
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 16:43:07 -07:00
  afce5665e2
• Move Foundry Responses hosting into Microsoft.Agents.AI.Foundry package

  Move source and test files from the standalone Hosting.AzureAIResponses project
  into the Foundry package under a Hosting/ subfolder. This consolidates the
  Foundry-specific hosting adapter into the main Foundry package.
  
  - Source: Microsoft.Agents.AI.Foundry.Hosting namespace
  - Tests: merged into Foundry.UnitTests/Hosting/
  - Conditionally compiled for .NETCoreApp TFMs only (net8.0+)
  - Deleted standalone Hosting.AzureAIResponses project and test project
  - Updated sample and solution references
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 16:40:09 -07:00
  838fd7f4d0
• Clean up tests and sample formatting

  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 16:39:18 -07:00
  15e36efe39
• Add Azure AI Foundry Responses hosting adapter

  Implement Microsoft.Agents.AI.Hosting.AzureAIResponses to host agent-framework
  AIAgents and workflows within Azure Foundry as hosted agents via the
  Azure.AI.AgentServer.Responses SDK.
  
  - AgentFrameworkResponseHandler: bridges ResponseHandler to AIAgent execution
  - InputConverter: converts Responses API inputs/history to MEAI ChatMessage
  - OutputConverter: converts agent response updates to SSE event stream
  - ServiceCollectionExtensions: DI registration helpers
  - 336 unit tests across net8.0/net9.0/net10.0 (112 per TFM)
  - ResponseStreamValidator: SSE protocol validation tool for samples
  - FoundryResponsesHosting sample app
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  alliscode · 2026-04-15 16:39:17 -07:00
  12251b1e69
• .NET: Bump Azure.AI.AgentServer packages to 1.0.0-beta.1/beta.21 and fix br… (#5287)

  * Bump Azure.AI.AgentServer packages to 1.0.0-beta.1/beta.21 and fix breaking API changes
  
  - Azure.AI.AgentServer.Core: 1.0.0-beta.11 -> 1.0.0-beta.21
  - Azure.AI.AgentServer.Invocations: 1.0.0-alpha.20260408.4 -> 1.0.0-beta.1
  - Azure.AI.AgentServer.Responses: 1.0.0-alpha.20260408.4 -> 1.0.0-beta.1
  - Azure.Identity: 1.20.0 -> 1.21.0 (transitive requirement)
  - Azure.Core: 1.52.0 -> 1.53.0 (transitive requirement)
  - Remove azure-sdk-for-net dev feed (packages now on nuget.org)
  - Fix OutputConverter for new builder API (auto-tracked children, split EmitTextDone/EmitDone)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fixing small issues.
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Ben Thomas · 2026-04-15 16:34:28 -07:00
  548dfb10b6
• Add Hosted-McpTools sample with dual MCP pattern

  Demonstrates two MCP integration layers in a single hosted agent:
  - Client-side MCP: McpClient connects to Microsoft Learn, agent handles
    tool invocations locally (docs_search, code_sample_search, docs_fetch)
  - Server-side MCP: HostedMcpServerTool delegates tool discovery and
    invocation to the LLM provider (Responses API), no local connection
  
  Includes DevTemporaryTokenCredential for Docker local debugging,
  Dockerfile.contributor for ProjectReference builds, and the openai/v1
  route mapping for AIProjectClient compatibility in Development mode.

  Roger Barreto · 2026-04-15 15:11:05 +01:00
  5b16684930
• Removing extra using samples
  Roger Barreto · 2026-04-13 19:50:11 +01:00
  1584879edd
• .NET: Update AGUI service to support session storage (#5193)

  * Update AGUI service to support session storage
  
  * Apply suggestion from @Copilot
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address PR comments
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

  westey · 2026-04-13 18:03:51 +00:00
  b1fb63eb81
• Adding LocalTools + Workflow samples
  Roger Barreto · 2026-04-13 16:59:18 +01:00
  4b9d848541
• Address text rag sample working
  Roger Barreto · 2026-04-13 16:20:18 +01:00
  ad625602a3
• Foundry Agent Hosting
  Roger Barreto · 2026-04-13 15:29:36 +01:00
  340ec82623
• Update chat client agent for contributor and devs
  Roger Barreto · 2026-04-13 15:11:26 +01:00
  9e842e1821
• Using updates
  Roger Barreto · 2026-04-13 11:21:17 +01:00
  4895ad74e1
• Adding SessionStorage and SessionManagement, improving samples to align Consumption vs Hosting
  Roger Barreto · 2026-04-11 17:45:52 +01:00
  fcc96823a4
• ChatClientAgent working
  Roger Barreto · 2026-04-11 13:03:55 +01:00
  a82c1ede09
• Hosting Samples update
  Roger Barreto · 2026-04-11 12:05:44 +01:00
  eb7f8617c1
• Hosting Samples update
  Roger Barreto · 2026-04-11 11:36:00 +01:00
  026f71ac32
• Hosting Samples update
  Roger Barreto · 2026-04-11 11:35:53 +01:00
  4ab43734c6