189 Commits

• .NET: Add Foundry.Hosting.IntegrationTests (#5598)

  * Foundry.Hosting.IntegrationTests: scaffold project, fixtures, and 24 tests
  
  Add a new integration test project for Foundry hosted agents alongside the existing Foundry.IntegrationTests project. The project provisions a real Foundry hosted agent per scenario via AgentAdministrationClient.CreateAgentVersionAsync, points it at a single test container image (built and pushed out of band by scripts/it-build-image.ps1 in a follow up commit), and exercises the agent through AIProjectClient.AsAIAgent.
  
  Six scenario fixtures are introduced, each pointing at the same image but selecting behavior via the IT_SCENARIO environment variable on the HostedAgentDefinition:
  - HappyPathHostedAgentFixture (round trip, multi turn, stored=false flag)
  - ToolCallingHostedAgentFixture (server side AIFunctions)
  - ToolCallingApprovalHostedAgentFixture (approval flow)
  - ToolboxHostedAgentFixture (Foundry toolbox)
  - McpToolboxHostedAgentFixture (MCP backed toolbox)
  - CustomStorageHostedAgentFixture (custom storage provider)
  
  24 tests across 6 test classes are scaffolded. All are tagged Skip pending the test container build and the end to end smoke iteration in follow up commits. Once the container is in place the Skip annotations can be removed scenario by scenario.
  
  Adds an IT_HOSTED_AGENT_IMAGE constant to the shared TestSettings so every IT project agrees on the env var name the build script emits.
  
  * Foundry.Hosting.IntegrationTests: add TestContainer, build script, slnx, README
  
  Adds the rest of the integration test infrastructure on top of the previous scaffolding commit:
  
  * Foundry.Hosting.IntegrationTests.TestContainer csproj and Program.cs implementing the multi scenario container (one image, IT_SCENARIO env var dispatches between happy-path, tool-calling, tool-calling-approval, toolbox, mcp-toolbox, and custom-storage). The toolbox, mcp-toolbox, and custom-storage branches are placeholders pending API surface stabilization.
  * Dockerfile and dockerignore in the test container project, using the contributor pattern matching the investigation work (host side dotnet publish, container only does COPY out/).
  * scripts/it-build-image.ps1 with mandatory Registry parameter (no hardcoded ACR), content hashed tags so unchanged source results in a no op push, and emits IT_HOSTED_AGENT_IMAGE for shells and CI to consume.
  * slnx entry for both new projects.
  * README in the IT project covering env vars, image build, scenario table, and current placeholder status.
  
  Steps still pending: end to end smoke (step 5) and CI workflow integration (step 6) require a live Foundry deployment and ACR push, so they land in follow up commits.
  
  * Foundry.Hosting.IntegrationTests: address PR 5598 review feedback
  
  Fix issues raised by Copilot review:
  
  * it-build-image.ps1: hash file contents, not the path list, so any source edit produces a fresh tag. Normalize Registry input by stripping scheme and trailing slash before deriving the ACR short name. Validate the short name is non empty.
  * HostedAgentFixture: route GetAgentAsync through _adminClient (which has the FoundryFeaturesPolicy attached) instead of through _projectClient.AgentAdministrationClient (which does not).
  * HostedAgentFixture FoundryFeaturesPolicy: replace Headers.Add with Remove plus Add so retries cannot accumulate duplicate headers.
  * HappyPath, ToolCalling, ToolCallingApproval, CustomStorage tests: create the AgentSession before turn 1 and reuse it for both turns. The previous pattern created the session after turn 1 so turn 2 had no link to turn 1, defeating the multi turn assertion.
  
  * .NET: Foundry.Hosting.IntegrationTests: constrain to net10.0 + dotnet format autofix
  
  - Set <TargetFrameworks>net10.0</TargetFrameworks>: the project references both
    Microsoft.Agents.AI.Foundry.Hosting (net8/9/10 only) and AgentConformance.IntegrationTests
    (net10.0;net472 — inherits the tests-default TFM list). The intersection is net10.0;
    the previous $(TargetFrameworksCore) triple caused NU1702 + System.Text.Json version
    conflicts on the net8.0/net9.0 builds because AgentConformance had no matching asset.
  - Apply `dotnet format` autofix on the test files (IDE0005, IDE0009, IDE0032, IMPORTS).
  
  * .NET: Foundry.Hosting.IntegrationTests.TestContainer/Program.cs: add UTF-8 BOM
  
  CI's check-format requires charset=utf-8-bom per .editorconfig.
  
  * Foundry.Hosting IntegrationTests: wire end-to-end CI flow against hosted agents
  
  Make the integration tests usable end-to-end against a live Foundry deployment, including
  a per-run rebuild of the test container so framework code changes are exercised.
  
  Fixture (HostedAgentFixture.cs)
  
  * Switch from per-run unique agent names to stable scenario-keyed names (it-happy-path,
    it-tool-calling, ...). The agent's managed identity carries the Azure AI User role on
    the project scope, which is required for inbound inference; deleting the agent recycles
    the MI and breaks that role assignment, so we keep the agent across runs and only churn
    versions.
  * Add IT_RUN_ID env var to defeat Foundry's content-addressed version dedup; otherwise a
    rerun just receives the existing version and Dispose deletes it.
  * PATCH the per-agent endpoint with AgentEndpointConfig (Responses protocol, version
    selector at 100% to the new version). Without this, /agents/{name}/endpoint/protocols/
    openai/responses returns HTTP 400.
  * Build a per-agent ProjectOpenAIClient (not the cached projectClient.ProjectOpenAIClient,
    which is bound to the project-level URL); set AgentName in options so the URL routes
    through the agent endpoint, and add the Foundry-Features header to the inference
    pipeline.
  * Use Versions (which serializes to container_protocol_versions) instead of the
    deprecated ProtocolVersions; the server now rejects the legacy field.
  * On Dispose, delete only the version this fixture created. Never delete the agent.
  
  Tests
  
  * Tag every HostedAgentTests class with [Trait("Category", "FoundryHostedAgents")] so the
    CI workflow can route them to a separate Foundry project than the rest of the
    integration suite.
  
  CI workflow (.github/workflows/dotnet-build-and-test.yml)
  
  * Add a foundryHosting paths-filter covering Microsoft.Agents.AI.Foundry.Hosting and its
    in-repo dependency chain (Foundry, Agents.AI, Agents.AI.Abstractions), the test
    container, the test fixture, Directory.Packages.props, the build script, and this
    workflow file. Skip the costly hosted-agent steps when none of those changed.
  * Add "Build and push Foundry Hosted Agents test container" step that invokes
    scripts/it-build-image.ps1 against vars.IT_HOSTED_AGENT_REGISTRY and pipes the resulting
    IT_HOSTED_AGENT_IMAGE=<tag> into GITHUB_ENV.
  * Add "Run Foundry Hosted Agents Integration Tests" step that filters in only the new
    trait, with AZURE_AI_PROJECT_ENDPOINT/AZURE_AI_MODEL_DEPLOYMENT_NAME pointed at
    IT_HOSTED_AGENT_PROJECT_ENDPOINT/IT_HOSTED_AGENT_MODEL_DEPLOYMENT_NAME (Tao project,
    East US 2; the SK IT project's region does not yet support hosted agents preview).
  * Exclude the new trait from the existing "Run Integration Tests" step.
  * TEMP: drop the != 'pull_request' guard on the new steps and on Azure CLI Login when the
    paths-filter triggers, so PR #5598 can validate the wiring before promoting to merge
    queue only. Restore the original guard after one green PR run.
  
  Build script (scripts/it-build-image.ps1)
  
  * Hash now spans TestContainer source AND its referenced framework projects so any
    framework code change forces a fresh tag and a real docker push; the previous
    TestContainer-only hash silently reused stale images on framework edits.
  
  Bootstrap script (dotnet/tests/Foundry.Hosting.IntegrationTests/scripts/it-bootstrap-agents.ps1)
  
  * New idempotent script that creates the six stable scenario agents and grants Azure AI
    User on the project scope to each agent's MI. Run once per Foundry project. Includes
    AAD-graph propagation retries because newly created MIs take time to appear there.
  
  README (dotnet/tests/Foundry.Hosting.IntegrationTests/README.md)
  
  * Document the bootstrap prerequisite, the regional caveat (East US 2 is the only region
    we have validated; East US returned "Unsupported region" at the time of writing), the
    per-run image rebuild, and the CI wiring including the SP RBAC requirements.
  
  SDK pin (TEMP)
  
  * Bump Microsoft.Agents.AI.Foundry.Hosting's Azure.AI.Projects VersionOverride to
    2.1.0-alpha.20260505.1 from the azure-sdk public daily feed (added to nuget.config).
    This release is the first that builds the per-agent inference URL as
    /agents/{name}/endpoint/protocols/openai (the 2.1.0-beta.1 release builds
    .../openai/openai/v1, which the server rejects). Revert both the feed and the override
    once the URL fix lands in a stable Azure.AI.Projects release.
  
  * Foundry.Hosting IntegrationTests: revert alpha SDK pin; move endpoint PATCH to bootstrap
  
  The alpha SDK pin (Azure.AI.Projects 2.1.0-alpha.20260505.1 from the azure-sdk public
  daily feed) was needed only for the URL routing fix and the strongly-typed
  AgentEndpointConfig/PatchAgentOptions wrapper. We do not need either right now: the
  fixture stays compatible with the public 2.1.0-beta.1 by moving the one-time endpoint
  PATCH to the bootstrap script (it sets version_selector to FixedRatio @latest, so each
  new fixture run becomes the served version automatically without a per-run PATCH from
  the test code). The hosted-agent invocation path will start working end-to-end once the
  URL routing fix lands in a stable Azure.AI.Projects release; until then the tests stay
  [Fact(Skip = ...)] as documented.
  
  * Revert dotnet/nuget.config: drop the azure-sdk-for-net public feed.
  * Revert Microsoft.Agents.AI.Foundry.Hosting.csproj VersionOverride to 2.1.0-beta.1.
  * Revert Microsoft.Agents.AI.Foundry.UnitTests and Microsoft.Agents.AI.Foundry.Hosting.UnitTests
    Azure.AI.Projects pin (they had been bumped to align Azure.Core 1.54 transitive).
  * Drop the AgentEndpointConfig PATCH block from HostedAgentFixture.cs (the type is
    alpha-only). Replace with a comment pointing at the bootstrap script.
  * Bootstrap script (it-bootstrap-agents.ps1) now also PATCHes each agent's endpoint
    with version_selector=@latest if not already set. Idempotent.
  
  * Foundry.Hosting IntegrationTests: drop accidentally committed filtered.slnx
  
  * Foundry.Hosting IntegrationTests: revert TEMP PR override on Azure CLI Login + IT steps
  
  The previous attempt to validate the new hosted-agent IT wiring on PR #5598 failed
  because the PR is from a fork (rogerbarreto/agent-framework-public). GitHub never passes
  environment secrets to fork PRs regardless of event-name guards on individual steps,
  so 'azure/login@v2' fails with 'client-id and tenant-id are not supplied'. Restore the
  original github.event_name != 'pull_request' guard. The new steps will execute on
  push to main and on merge_group runs.
  
  * Foundry.Hosting IntegrationTests: invoke build-and-push script with absolute path
  
  The pwsh shell on the GitHub Actions runner couldn't resolve ./scripts/it-build-image.ps1
  when the step had no working-directory set; the step inherits the runner's PWD which is
  not always the repo root after preceding steps. Use github.workspace explicitly to remove
  the ambiguity.
  
  * Foundry.Hosting IntegrationTests: move it-build-image.ps1 inside the IT project tree
  
  The previous location at scripts/it-build-image.ps1 lived outside the sparse-checkout
  paths the workflow uses (.github, dotnet, python, declarative-agents), so the runner
  never had the file when the new step tried to invoke it. Move the script next to its
  sibling it-bootstrap-agents.ps1 inside the IT project tree, and anchor its relative
  paths to the repo root via  so callers can invoke it from any PWD.
  
  * Move scripts/it-build-image.ps1 -> dotnet/tests/Foundry.Hosting.IntegrationTests/scripts/it-build-image.ps1
  * Add Push-Location to the resolved repo root inside the script (Pop-Location in finally)
    so the existing relative paths (TestContainerProject, hashed src dirs) keep working
    no matter where the script is invoked from.
  * Update the workflow path filter and the step's invocation path to the new location.
  
  * Foundry.Hosting IntegrationTests: enable 5 HappyPath tests on the live Foundry endpoint
  
  The fixture already constructs ProjectOpenAIClient via the per-agent path that beta.1
  supports (new ProjectOpenAIClient(uri, cred, opts { AgentName })), so no SDK pin bump
  is required to run the smoke tests end-to-end. Un-skip the 5 tests that pass against
  the live test container.
  
  Tests un-skipped (verified passing locally against tao-foundry-prj):
  
  * RunAsync_ReturnsNonEmptyTextAsync
  * RunStreamingAsync_YieldsAtLeastOneUpdateAsync
  * MultiTurn_WithPreviousResponseId_PreservesContextAsync
  * StoredFalse_Baseline_DoesNotPersistResponseAsync
  * Instructions_FromContainerDefinition_AreObeyedAsync
  
  Tests still skipped with a more specific reason (4 of 9 in HappyPath plus all
  ToolCalling*, McpToolbox, Toolbox, CustomStorage) because the test container does not
  yet emit usable response_id / conversation_id chains, and the placeholder scenarios are
  not implemented in the test container's Program.cs. These are test container limitations,
  not infra bugs, and can be un-skipped as the container surfaces stabilize.
  
  * Foundry.Hosting IntegrationTests: extract hosted IT into parallel job, add Workflows dep
  
  Address Wesley's review feedback on PR #5598:
  
  1. Pull Foundry hosted-agent IT into its own dotnet-foundry-hosted-it job that runs in parallel to dotnet-build and dotnet-test. Same path-filter gate keeps it skipped on unrelated edits. Builds only the filtered solution containing Foundry.Hosting.IntegrationTests and src deps. dotnet-build-and-test-check now waits on it too.
  
  2. Add Microsoft.Agents.AI.Workflows to the foundryHosting paths-filter and to hashedDirs in it-build-image.ps1 since Foundry.Hosting transitively depends on it.
  
  TFM constraint on the IT csproj stays at net10.0 because AgentConformance.IntegrationTests targets net10/net472 and is consumed by ~12 other IT projects on net472.
  
  ---------
  
  Co-authored-by: Roger Barreto <rbarreto@microsoft.com>

  Roger Barreto · 2026-05-06 16:08:15 +00:00
  51ad460d5f
• .NET: Add hosted agent observability sample (#5660)

  * .Net: Add hosted agent observability sample
  
  Mirrors the Python sample added in #5608 for Foundry hosted agents. The
  .NET hosting library already wires OpenTelemetry automatically via
  Microsoft.Agents.AI.Foundry.Hosting (ApplyOpenTelemetry) plus
  Azure.AI.AgentServer.Core's AddAgentHostTelemetry, so no framework
  changes are needed. The sample is documentation plus a runnable artifact
  that produces an interesting span tree (invoke_agent / agent_invoke /
  chat / execute_tool).
  
  Adds Hosted-Observability under FoundryHostedAgents/responses with two
  small tools (GetCurrentLocation, GetWeather), agent.yaml /
  agent.manifest.yaml declaring OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT
  (the .NET equivalent of Python's ENABLE_SENSITIVE_DATA), Dockerfile +
  Dockerfile.contributor, .env.example and README explaining the .NET vs
  Python defaults. Project added to agent-framework-dotnet.slnx.
  
  * Address PR feedback: use Random.Shared and add .dockerignore

  Roger Barreto · 2026-05-06 08:33:16 +00:00
  705473c276
• fix: Add missing Workflows "Shared" sources to solution (#5656)
  Jacob Alber · 2026-05-05 15:45:49 +00:00
  6f86debb81
• .NET: Add Microsoft.Agents.AI.Hyperlight package for CodeAct integration (.NET) (#5329)

  * Add Microsoft.Agents.AI.Hyperlight package for CodeAct integration
  
  Introduces a new Microsoft.Agents.AI.Hyperlight package that enables CodeAct-style sandboxed code execution via Hyperlight (hyperlight-sandbox .NET SDK, PR #46) for .NET agents, following the docs/features/code_act/dotnet-implementation.md design and the Python agent_framework_hyperlight reference.
  
  Highlights:
  - HyperlightCodeActProvider (AIContextProvider): injects an execute_code tool and CodeAct guidance per invocation; single-instance-per-agent via a fixed StateKeys value; supports multiple provider-owned tools (exposed inside the sandbox via call_tool), file mounts, and an outbound domain allow-list; snapshot/restore per run.
  - HyperlightExecuteCodeFunction: standalone AIFunction for manual/static wiring when the sandbox configuration is fixed.
  - Approval model via CodeActApprovalMode (AlwaysRequire / NeverRequire) with propagation from ApprovalRequiredAIFunction-wrapped tools.
  - Unit tests (instruction builder, tool bridge, approval computation, provider CRUD, ProvideAIContextAsync snapshot isolation and approval wrapping).
  - Env-gated integration test (HYPERLIGHT_PYTHON_GUEST_PATH).
  - Three samples under samples/02-agents/AgentWithCodeAct (interpreter, tool-enabled, manual wiring).
  
  Build is not yet runnable: requires .NET SDK 10.0.200 and the not-yet-published HyperlightSandbox.Api 0.1.0-preview NuGet package. Package is marked IsPackable=false until the dependency is available.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR #5329 review feedback for Hyperlight CodeAct provider
  
  - A. Build-breakers: drop unused usings, override test TargetFrameworks
    off net472, drop redundant Microsoft.Extensions.AI.Abstractions PackageRef.
  - B. API: keep CRUD but rebuild sandbox when config fingerprint changes;
    add HyperlightCodeActProviderOptions.CreateForWasm/CreateForJavaScript
    factory methods (Backend/ModulePath now read-only); rename WorkspaceRoot
    to HostInputDirectory; convert AllowedDomain & FileMount from record to
    sealed class; drop ToolBridge.Unwrap (ApprovalRequiredAIFunction is
    invocable as-is).
  - C. ToolBridge: collapse SerializeResult switch; add comment explaining
    AOT-driven choice to keep JsonNode.Parse over typed Deserialize.
  - D. InstructionBuilder: drop language-specific 'Python code' phrasing;
    strip host filesystem paths from execute_code description.
  - E. Style polish: ternary expression-body for ComputeApprovalRequired,
    .Where(x is not null), .ToList() over .ToArray() in IReadOnlyList
    returns.
  - F. Samples: add guest-module / KVM-WHP build instructions to Step01;
    note future Excel-upload sample in Step02.
  
  Also adds SandboxExecutorTests covering the new RunSnapshot.ComputeFingerprint
  used for sandbox-rebuild detection.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Align Hyperlight package id and JS warm-up with merged upstream SDK
  
  The .NET SDK in hyperlight-dev/hyperlight-sandbox PR #46 has merged. The
  published package id is Hyperlight.HyperlightSandbox.Api (the bare
  HyperlightSandbox.Api remains the assembly/namespace) and the reference
  CodeExecutionTool uses 'void 0;' as the JavaScript warm-up no-op. Update
  the package reference, project comment, README, and SandboxExecutor warm-up
  accordingly.
  
  No functional change beyond that — all other public APIs we depend on
  (SandboxBuilder.With*, Sandbox.Run/RegisterToolAsync/AllowDomain/Snapshot/
  Restore, ExecutionResult, SandboxBackend) match the merged shape.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bump Hyperlight package to 0.4.0 and fix build/test issues
  
  Hyperlight.HyperlightSandbox.Api 0.4.0 is now published on nuget.org. Bump
  the version reference and address the analyzer/runtime issues that surfaced
  once restore could complete:
  
  - Add HyperlightJsonContext source-generated JsonSerializerContext for the
    execute_code result + tool error envelopes; route arbitrary AIFunction
    results through AIJsonUtilities.DefaultOptions to keep IsAotCompatible=true.
  - Replace explicit ObjectDisposedException throws with
    ObjectDisposedException.ThrowIf (CA1513).
  - Use HyperlightSandbox.Api.SandboxBackend in cref docs to disambiguate.
  - Update tests to match AIContext.Tools being IEnumerable<AITool>, drop
    ConfigureAwait(false) in xUnit test methods (xUnit1030), use collection
    expressions for AllowedDomain methods.
  - Add 'using OpenAI.Chat;' to all three samples so AsAIAgent resolves.
  - Verified: dotnet build of all four hyperlight projects + samples succeeds
    on net8/9/10; dotnet test for the unit tests passes 32/32 on net10.0.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CI check failures: file encoding (UTF-8 BOM + LF) and broken markdown link
  
  - Convert all new .cs/.csproj files to UTF-8 with BOM and LF line endings
    to satisfy the dotnet/.editorconfig charset/end_of_line settings
    enforced by check-format.
  - Drop unused System.Collections.Generic using in HyperlightCodeActProviderTests.
  - Add missing using Microsoft.Extensions.AI in CodeActApprovalMode.cs and
    shorten ApprovalRequiredAIFunction cref (IDE0001).
  - Fix broken README link to docs/decisions/0024-codeact-integration.md.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review: AIFunction inheritance, packaging, GetService approval check
  
  - HyperlightExecuteCodeFunction now inherits AIFunction directly. The
    AsAIFunction() indirection is gone; instances are accepted anywhere an
    AIFunction is. Approval requirement is surfaced via GetService<ApprovalRequiredAIFunction>()
    which lazily exposes a wrapping ApprovalRequiredAIFunction proxy when the
    effective ApprovalMode/tool stack requires it.
  - ComputeApprovalRequired now uses GetService<ApprovalRequiredAIFunction>() so
    approval-required tools nested anywhere in the AITool decorator stack are
    detected (not just the top-most class).
  - csproj: drop IsPackable=false (ready to release with the published
    Hyperlight.HyperlightSandbox.Api 0.4.0 dependency); add PackageReadmeFile
    and pack README.md at the package root, matching the pattern used by
    Aspire.Hosting.AgentFramework.DevUI / Microsoft.Agents.AI.DurableTask.
  - Update Step03 sample and README wording to reflect direct AIFunction usage.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-05-05 12:56:24 +00:00
  e7dc3b91f1
• .NET: Harness Feature branch (#5310)

  * .NET: Add a TODO AIContextProvider (#5233)
  
  * Add a TODO AIContextProvider
  
  * Add unit tests
  
  * Address PR comments
  
  * Address PR comments
  
  * Fix test after removing one tool
  
  * .NET: Add a ModeProvider for managing agent modes (#5247)
  
  * Add a ModeProvider for managing agent modes
  
  * Fix typo
  
  * Fix typo
  
  * Fix typo
  
  * Address PR comments
  
  * .NET: Add sample to show how to build a harness (#5268)
  
  * Add sample to show how to build a harness
  
  * Improve sample
  
  * Sample max output tokens and model
  
  * Fix encoding
  
  * Fix model name in readme
  
  * Address PR comments
  
  * .NET: Add context window size compaction strategy for harness (#5304)
  
  * Add context window size compaction strategy for harness
  
  * Apply suggestions from code review
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address PR comments
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * .NET: Add a file memory provider (#5315)
  
  * Add a file memory provider
  
  * Address PR comments
  
  * Fix review comments.
  
  * Add additional unit tests
  
  * Addressing PR comments.
  
  * .NET:  Harness: Improve prompts and add FileSystem store (#5365)
  
  * Harness: Improve prompts and add FileSystem store
  
  * Address PR comments
  
  * .NET: Harness: Improve path validation (#5404)
  
  * Harness: Improve path validation
  
  * Address PR comments
  
  * .NET: Add always approve helpers, improve sample and fix bug (#5451)
  
  * Add always approve helpers, improve sample and fix bug
  
  * Address PR comments
  
  * .NET: Make Todo, Mode and FileMemory providers more configurable (#5477)
  
  * Make Todo, Mode and FileMemory providers more configurable
  
  * Address PR comments.
  
  * .NET: Add subagents provider and sample (#5518)
  
  * Add subagents provider and sample
  
  * Addressing PR comments.
  
  * .NET: Harness filememory index plus instructions consistency (#5540)
  
  * Add FileMemoryProvider index and improve instruction consistency
  
  * Address PR comments.
  
  * Address PR comments
  
  * Address PR comments.
  
  * Apply suggestion from @rogerbarreto
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * .NET: Refactor harness console to be more extensible and easy to understand with better UX (#5573)
  
  * Refactor harness console to be more extensible and easy to understand with better UX.
  
  * Fix formatting issues.
  
  * Allow multiple clarifications in one response
  
  * Address PR comments
  
  * .NET: Add FileAccessProvdider and concurrency fix for FileMemoryProvider (#5583)
  
  * Add FileAccessProvdider and concurrency fix for FileMemoryProvider
  
  * Address PR comments
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

  westey · 2026-05-01 10:52:38 +00:00
  626b418622
• .NET: Add dedicated Foundry.Hosting UnitTest project (#5592)

  * Foundry.Hosting.UnitTests: extract project from Foundry.UnitTests
  
  Move all Hosting/* tests, three toolbox TestData JSONs, and the FakeAuthenticationTokenProvider/HttpHandlerAssert/TestDataUtil helpers (trimmed to toolbox getters) into a new Microsoft.Agents.AI.Foundry.Hosting.UnitTests project. Add it to the slnx and grant the new assembly InternalsVisibleTo from Microsoft.Agents.AI.Foundry and Microsoft.Agents.AI.Foundry.Hosting.
  
  * Foundry.Hosting.UnitTests: align namespaces to assembly name
  
  Rename namespaces from Microsoft.Agents.AI.Foundry.UnitTests(.Hosting) to Microsoft.Agents.AI.Foundry.Hosting.UnitTests across all moved tests, the duplicated helpers, and the trimmed TestDataUtil. Also fixes the prior namespace inconsistency in FoundryToolboxTests.
  
  * Foundry.Hosting.UnitTests: split WorkflowIntegrationTests by SUT
  
  Replace the WorkflowIntegrationTests file (an IT-named file inside a UT project) with two SUT-focused files plus a shared test-doubles file:
  
  - AgentFrameworkResponseHandlerWorkflowTests.cs - the 5 handler-driven tests that exercise AgentFrameworkResponseHandler with a real workflow agent.
  - OutputConverterWorkflowTests.cs - the 5 OutputConverter tests driven by hand-crafted update sequences mirroring real workflow patterns.
  - WorkflowTestAgents.cs - StreamingTextAgent and ThrowingStreamingAgent extracted as internal types used by both files.
  
  * Foundry.UnitTests: trim Hosting-related conditionals and dead testdata
  
  Now that Hosting tests live in their own project:
  - drop the Compile Remove guard for the Hosting subfolder,
  - drop the .NETCoreApp-only PackageReferences (Azure.AI.AgentServer.Responses, Microsoft.AspNetCore.TestHost, OpenTelemetry, OpenTelemetry.Exporter.InMemory),
  - drop the conditional ProjectReference to Microsoft.Agents.AI.Foundry.Hosting,
  - delete the three Toolbox JSON files and the matching Toolbox getters in TestDataUtil.
  
  * Foundry.Hosting.UnitTests: drop redundant 'using Microsoft.Agents.AI.Foundry.Hosting'
  
  The new project namespace is Microsoft.Agents.AI.Foundry.Hosting.UnitTests, which already brings the parent Microsoft.Agents.AI.Foundry.Hosting namespace into scope. The explicit using statement is therefore redundant (IDE0005). Caught by 'dotnet format --verify-no-changes' running on Linux against the .NET 10 SDK.
  
  * Foundry.Hosting: drop InternalsVisibleTo to Foundry.UnitTests
  
  The non-hosting Foundry.UnitTests project no longer holds any Hosting tests after the split, so it doesn't need access to internal types in Microsoft.Agents.AI.Foundry.Hosting. Only Microsoft.Agents.AI.Foundry.Hosting.UnitTests needs it.
  
  * Foundry.Hosting: rename DelegatingResponsesClient to UserAgentResponsesClient
  
  Address westey-m's review feedback on PR #5453: `Delegating*` is conventionally reserved for inheritable base classes (mirroring `DelegatingHandler`) where consumers override one or two members. This polyfill is sealed and only injects the User-Agent supplement, so the new name reflects its actual purpose.
  
  Renamed via `git mv` to preserve history:
  * `src/Microsoft.Agents.AI.Foundry.Hosting/DelegatingResponsesClient.cs` to `UserAgentResponsesClient.cs`
  * `tests/Microsoft.Agents.AI.Foundry.Hosting.UnitTests/DelegatingResponsesClientTests.cs` to `UserAgentResponsesClientTests.cs`
  
  Class, constructor, and all references updated across:
  * `src/.../UserAgentResponsesClient.cs` (class + constructor + internal log message)
  * `src/.../ServiceCollectionExtensions.cs` (cref + type check + instantiation)
  * `src/.../HostedAgentUserAgentPolicy.cs` (cref)
  * `tests/Foundry.UnitTests/RequestOptionsExtensionsTests.cs` (comment)
  * `tests/Foundry.Hosting.UnitTests/UserAgentResponsesClientTests.cs` (class + cref + instantiations)

  Roger Barreto · 2026-04-30 21:09:25 +00:00
  fb97e93a01
• .NET: Add declarative HttpRequestAction sample (#5572)

  * Add declarative HttpRequestAction support to workflows
  
  * Clean up response body for diagnostics  and fix tests.
  
  * Fix merge with main.
  
  * Remove redundant fallback for request content headers.
  
  * Add declarative InvokeHttpRequest sample
  
  * Fix solution file and update sample yaml comments
  
  * Add final newline to sample class to fix formatting failure

  Peter Ibekwe · 2026-04-29 19:19:31 +00:00
  6853f64de8
• .NET: dotnet: Add server-side Foundry Toolbox support and fix SDK beta.4 br… (#5450)

  * dotnet: Add server-side Foundry Toolbox support and fix SDK beta.4 breaking changes
  
  Add FoundryToolbox and AIProjectClient extensions to Microsoft.Agents.AI.Foundry.Hosting
  for server-side toolbox tool integration matching Python's FoundryChatClient.get_toolbox()
  pattern. Tools are fetched from the Foundry project SDK and passed as server-side tools
  in the Responses API request.
  
  New files:
  - FoundryToolbox.cs: Core implementation using AgentAdministrationClient SDK
  - AIProjectClientToolboxExtensions.cs: Extension methods on AIProjectClient
  - Agent_Step25_ToolboxServerSideTools sample with create helper and combine flow
  - 19 unit tests covering param validation, conversion, sanitization, and extensions
  
  SDK breaking changes (Azure.AI.AgentServer.Responses beta.3 -> beta.4):
  - FunctionToolCallOutputResource renamed to OutputItemFunctionToolCallOutput
  - AzureAIAgentServerResponsesModelFactory made internal, replaced with direct constructors
  - ResponseUsage constructor now requires non-null token details parameters
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: reuse endpoint variable in CreateSampleToolboxAsync
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: pass endpoint through static local functions to avoid capture
  
  Static local functions cannot capture top-level variables. Thread the
  endpoint parameter through Main, CombineToolboxes, and CreateSampleToolboxAsync.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * refactor: remove unused projectClient param from CreateSampleToolboxAsync
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/02-agents/AgentsWithFoundry/Agent_Step25_ToolboxServerSideTools/README.md
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/02-agents/AgentsWithFoundry/Agent_Step25_ToolboxServerSideTools/Program.cs
  
  Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>
  
  * Update dotnet/samples/02-agents/AgentsWithFoundry/Agent_Step25_ToolboxServerSideTools/Program.cs
  
  Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>
  
  * Removing GetToolbocVersion.
  
  * Removing tests for GetToolboxVersion
  
  * fix: map cached/reasoning token counts in ConvertUsage instead of hardcoding zeros
  
  Extract InputTokenDetails.CachedTokenCount and OutputTokenDetails.ReasoningTokenCount
  from UsageDetails.AdditionalCounts, matching the pattern in AgentResponseExtensions.
  Also accumulate detail counts when merging with existing usage.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

  Ben Thomas · 2026-04-23 18:52:03 +00:00
  5fe8941ff9
• .NET: Add dynamic tool expansion sample (#5425)

  * Add dynamic tool expansion sample
  
  * Address PR comments
  
  * Remove tool names from tool call response to avoid confusing LLM

  westey · 2026-04-23 15:10:57 +00:00
  6851a9cdc8
• .NET: Update Aspire package to be preview (#5444)

  * Update Aspire package to be preview
  
  * Also update readme file
  
  * Include README.md in pack

  westey · 2026-04-23 15:10:49 +00:00
  dfca81ff21
• .NET: [Breaking] Migrate A2A agent and hosting to A2A SDK v1 (#5423)

  * update a2a agent to the latest a2a sdk (#5257)
  
  * Move A2A samples from 04-hosting to 02-agents (#5267)
  
  Move the A2A sample projects (A2AAgent_AsFunctionTools and
  A2AAgent_PollingForTaskCompletion) from samples/04-hosting/A2A/ to
  samples/02-agents/A2A/ to better align with the sample directory
  structure. Update solution file and samples README accordingly.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Fix stream reconnection for A2AAgent (#5275)
  
  * Add SSE stream reconnection support to A2AAgent
  
  Implement automatic reconnection for SSE streams that disconnect mid-task,
  using the Last-Event-ID header to resume from where the stream left off.
  
  Changes:
  - Add InvokeStreamingWithReconnectAsync method to A2AAgent with configurable
    max retries and delay between attempts
  - Add new log messages for reconnection events
  - Add A2AAgent_StreamReconnection sample demonstrating the feature
  - Update existing polling sample to use simplified SendMessageAsync API
  - Add unit tests for stream reconnection logic
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * address comments
  
  * Address PR review feedback
  
  - Dispose SSE enumerator before GetTaskAsync fallback to release HTTP connection
  - Wrap StreamWriter in using blocks with leaveOpen:true and explicit UTF-8 encoding
  - Print update.Text instead of update object in stream reconnection sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Use IA2AClientFactory to create A2AClient (#5277)
  
  * Refactor A2A extensions to use IA2AClientFactory and add ProtocolSelection sample
  
  - Update A2AAgentCardExtensions to accept IA2AClientFactory instead of A2AClientOptions
  - Update A2ACardResolverExtensions to accept IA2AClientFactory
  - Update A2AClientExtensions to accept IA2AClientFactory
  - Update A2AAgent to use IA2AClientFactory for client creation
  - Add A2AAgent_ProtocolSelection sample demonstrating protocol selection
  - Add comprehensive unit tests for all changes
  - Update README files with new sample reference
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Reorder params: options before loggerFactory in A2A extensions
  
  Move A2AClientOptions parameter before ILoggerFactory in AsAIAgent
  and GetAIAgentAsync extension methods to follow the repo convention
  of keeping LoggerFactory and CancellationToken as the last parameters.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Migrate A2A hosting to A2A SDK v1 (#5363)
  
  * .NET: Migrate A2A hosting to A2A SDK v1
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * remove unused agent card
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Split A2A endpoint mapping into protocol-specific methods (#5413)
  
  * .NET: Refactor A2A hosting registration into A2AServerServiceCollectionExtensions
  
  - Rename A2AHostingOptions to A2AServerRegistrationOptions
  - Move server registration logic from A2AEndpointRouteBuilderExtensions
    and AIAgentExtensions into new A2AServerServiceCollectionExtensions
  - Remove A2AProtocolBinding and AIAgentExtensions (consolidated)
  - Update samples and tests to use the new registration API
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * address copilot comments
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove unnecessary using directive in AgentWebChat.AgentHost
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * restore AsyncEnumerable package version
  
  * address copilot initial feedback
  
  * address automated code review and formatting issues
  
  * fix formatting issues
  
  * Add DI wiring verification tests for AddA2AServer
  
  Add three tests to A2AServerServiceCollectionExtensionsTests that verify
  custom keyed services are actually wired through to the A2AServer, not
  just that the server resolves non-null:
  
  - Custom IAgentHandler: verifies the keyed handler is invoked when
    processing a SendMessageRequest instead of the default A2AAgentHandler.
  - Custom AgentSessionStore (no handler): verifies the keyed session
    store's GetSessionAsync is called during request processing when no
    custom handler is registered.
  - Default stores end-to-end: verifies the InMemoryAgentSessionStore and
    InMemoryTaskStore defaults successfully process a request. Uses a new
    CreateAgentMockForRequests helper that includes SerializeSessionCoreAsync
    setup needed by InMemoryAgentSessionStore.
  
  All tests call A2AServer.SendMessageAsync directly (no HTTP layer needed)
  and use CancellationToken timeouts to guard against hangs.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2026-04-23 07:53:00 +00:00
  66e02c10e3
• .NET [WIP] Foundry Hosted Agents Support (#5312)

  * 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>
  
  * Bump System.ClientModel to 1.10.0 for Azure.Core 1.52.0 compat
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Clean up tests and sample formatting
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update Azure.AI.AgentServer packages to 1.0.0-alpha.20260401.5
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add hosted package version suffix (0.9.0-hosted) to distinguish from mainline
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * 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>
  
  * Bump package version to 0.9.0-hosted.260402.2
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bump OpenTelemetry packages to fix NU1109 downgrade errors
  
  - OpenTelemetry/Api/Exporter.Console/Exporter.InMemory: 1.13.1 -> 1.15.0
  - OpenTelemetry.Exporter.OpenTelemetryProtocol: already 1.15.0
  - OpenTelemetry.Extensions.Hosting: already 1.14.0
  - OpenTelemetry.Instrumentation.AspNetCore/Http: already 1.14.0
  - OpenTelemetry.Instrumentation.Runtime: 1.13.0 -> 1.14.0
  - Azure.Monitor.OpenTelemetry.Exporter: 1.4.0 -> 1.5.0
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CA1873: guard LogWarning with IsEnabled check
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * 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>
  
  * 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>
  
  * 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>
  
  * Address breaking changes in 260408
  
  * Bump hosted internal package version
  
  * Add UserAgent middleware tests for Foundry hosting
  
  * Hosting Samples update
  
  * Hosting Samples update
  
  * Hosting Samples update
  
  * Hosting Samples update
  
  * ChatClientAgent working
  
  * Adding SessionStorage and SessionManagement, improving samples to align Consumption vs Hosting
  
  * Using updates
  
  * Update chat client agent for contributor and devs
  
  * Foundry Agent Hosting
  
  * Address text rag sample working
  
  * Version bump
  
  * Adding LocalTools + Workflow samples
  
  * Removing extra using samples
  
  * 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.
  
  * .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>
  
  * 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>
  
  * Bump System.ClientModel to 1.10.0 for Azure.Core 1.52.0 compat
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Clean up tests and sample formatting
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update Azure.AI.AgentServer packages to 1.0.0-alpha.20260401.5
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add hosted package version suffix (0.9.0-hosted) to distinguish from mainline
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * 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>
  
  * Bump package version to 0.9.0-hosted.260402.2
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bump OpenTelemetry packages to fix NU1109 downgrade errors
  
  - OpenTelemetry/Api/Exporter.Console/Exporter.InMemory: 1.13.1 -> 1.15.0
  - OpenTelemetry.Exporter.OpenTelemetryProtocol: already 1.15.0
  - OpenTelemetry.Extensions.Hosting: already 1.14.0
  - OpenTelemetry.Instrumentation.AspNetCore/Http: already 1.14.0
  - OpenTelemetry.Instrumentation.Runtime: 1.13.0 -> 1.14.0
  - Azure.Monitor.OpenTelemetry.Exporter: 1.4.0 -> 1.5.0
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CA1873: guard LogWarning with IsEnabled check
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * 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>
  
  * 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>
  
  * 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>
  
  * Address breaking changes in 260408
  
  * Bump hosted internal package version
  
  * Add UserAgent middleware tests for Foundry hosting
  
  * Hosting Samples update
  
  * Hosting Samples update
  
  * Hosting Samples update
  
  * Hosting Samples update
  
  * ChatClientAgent working
  
  * Adding SessionStorage and SessionManagement, improving samples to align Consumption vs Hosting
  
  * Using updates
  
  * Update chat client agent for contributor and devs
  
  * Foundry Agent Hosting
  
  * Address text rag sample working
  
  * Version bump
  
  * Adding LocalTools + Workflow samples
  
  * Removing extra using samples
  
  * 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.
  
  * 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.
  
  * Fix IDE0009: add 'this' qualification in DevTemporaryTokenCredential
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix IDE0009: add 'this' qualification in all HostedAgentsV2 samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CHARSET: add UTF-8 BOM to Hosted-LocalTools and Hosted-Workflows
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix dotnet format: add Async suffix to test methods (IDE1006), fix encoding and style
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Register AgentSessionStore in test DI setups
  
  Add InMemoryAgentSessionStore registration to all ServiceCollection
  setups in AgentFrameworkResponseHandlerTests and WorkflowIntegrationTests.
  This is needed after the AgentSessionStore infrastructure was introduced
  in the responses-hosting feature. Tests still have NotImplementedException
  stubs for CreateSessionCoreAsync which will be fixed when the session
  infrastructure is fully available.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * 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.
  
  * 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
  
  * 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
  
  * Use placeholder for AGENT_NAME in Hosted-FoundryAgent .env.example
  
  * Move FoundryResponsesHosting to responses/Hosted-WorkflowHandoff, use GetResponsesClient
  
  * Rename Hosted-Workflows to Hosted-Workflow-Simple, Hosted-WorkflowHandoff to Hosted-Workflow-Handoff
  
  * Remove FoundryResponsesRepl and empty FoundryResponsesHosting directory
  
  * 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
  
  * Fix AgentFrameworkResponseHandlerTests: implement session methods in test mock agents
  
  * .NET: Auto-instrument resolved AIAgents with OpenTelemetry for Foundry Hosted Agents (#5316)
  
  * Auto-instrument resolved AIAgents with OpenTelemetry using Core ResponsesSourceName
  
  * Add OTel telemetry capture tests for Foundry hosted agent handler
  
  * Net: Prepare Foundry Preview Release (#5336)
  
  * Prepare Foundry preview release 1.2.0-preview.*
  
  Bump VersionPrefix to 1.2.0 and update the preview stamp date. Invert packaging opt-in so only the Foundry preview set produces NuGet packages:
  
  - Microsoft.Agents.AI.Abstractions
  
  - Microsoft.Agents.AI
  
  - Microsoft.Agents.AI.Workflows
  
  - Microsoft.Agents.AI.Workflows.Generators
  
  - Microsoft.Agents.AI.Foundry
  
  Flip IsReleased=false on the preview set so they pick up the -preview.YYMMDD.N suffix. Gate GeneratePackageOnBuild on IsPackable=true. Remove the global IsPackable=true from nuget-package.props so the repo-level default (false) applies to everything else.
  
  * Lower preview VersionPrefix to 0.0.1
  
  Retroactive preview publish: bump VersionPrefix and GitTag from 1.2.0 to 0.0.1 so the 5 Foundry preview packages emit as 0.0.1-preview.260417.1.
  
  * Net: Publish all packages as 0.0.1-preview.260417.2 (#5341)
  
  Revises the Foundry pre-release approach to publish ALL normally packable src projects as preview packages stamped 0.0.1-preview.260417.2, including projects previously flagged IsReleased=true or with a non-default VersionSuffix (rc/alpha).
  
  nuget-package.props:
  
  - Collapse the four conditional PackageVersion expressions (IsReleaseCandidate, VersionSuffix, default preview, IsReleased stable) into a single unconditional 0.0.1-preview.260417.2. On this preview-only branch every package ships with the same pre-release stamp regardless of per-project flags.
  
  - Restore the global IsPackable=true default (offsetting the repo-wide IsPackable=false in Directory.Build.props). Projects that opt out (Mem0, Declarative) already set IsPackable=false AFTER importing this file so they remain non-packable.
  
  - Remove the IsReleased-gated EnablePackageValidation line. Package validation does not apply to a 0.0.1 preview.
  
  csproj reverts (Abstractions, Agents.AI, Workflows, Workflows.Generators, Foundry):
  
  - Revert the IsPackable=true opt-in block introduced in #5336 (now redundant since the props default is true again).
  
  - Restore IsReleased=true to its pre-PR value. The setting is now a no-op because the props no longer branches on it.
  
  * Bump preview version to 260420.1 and fix AgentServer package deps (#5367)
  
  - Bump PackageVersion to 0.0.1-preview.260420.1
  - Bump Azure.AI.AgentServer.Core beta.21 -> beta.22 (required by
    Azure.AI.AgentServer.Responses beta.3)
  - Replace AgentHostTelemetry.ResponsesSourceName with local constant
    (type made internal in AgentServer.Core beta.22)
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Hosted agents toolbox support (#5368)
  
  * 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
  
  * Rename toolset to toolbox in user-facing API; rename ConsentAwareMcpClientTool to ConsentAwareMcpClientAIFunction
  
  * Add HostedMcpToolboxAITool for client-selectable Foundry toolboxes
  
  Introduces HostedMcpToolboxAITool, a marker tool subclassing HostedMcpServerTool that rides the OpenAI Responses 'mcp' wire format to let clients request a specific Foundry toolbox per request.
  
  - New FoundryAITool.CreateHostedMcpToolbox(name, version?) factory.
  
  - FoundryToolboxOptions.StrictMode (default true) rejects unregistered toolboxes; set to false to allow lazy-open on first use.
  
  - FoundryToolboxService.GetToolboxToolsAsync(name, version?) resolves cached or lazy-opened MCP tools.
  
  - AgentFrameworkResponseHandler parses request.Tools for foundry-toolbox://name[?version=v] markers and injects resolved tools per request, merging with pre-registered ones.
  
  - Unit tests for marker parsing and strict-mode resolution.
  
  * Bump Azure.AI.Projects to 2.1.0-alpha; add ToolboxRecord/ToolboxVersion factory overloads + tests
  
  * 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>
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Hosted agent adapter (#5371)
  
  * Bump preview version to 260420.1 and fix AgentServer package deps
  
  - Bump PackageVersion to 0.0.1-preview.260420.1
  - Bump Azure.AI.AgentServer.Core beta.21 -> beta.22 (required by
    Azure.AI.AgentServer.Responses beta.3)
  - Replace AgentHostTelemetry.ResponsesSourceName with local constant
    (type made internal in AgentServer.Core beta.22)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CA1873: guard LogError with IsEnabled check in FoundryToolboxService
  
  Wrap the LogError call with an IsEnabled(LogLevel.Error) guard to satisfy
  the CA1873 analyzer rule which flags potentially expensive argument
  evaluation when logging is disabled.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Hosted agent adapter (#5374)
  
  * Bump preview version to 260420.1 and fix AgentServer package deps
  
  - Bump PackageVersion to 0.0.1-preview.260420.1
  - Bump Azure.AI.AgentServer.Core beta.21 -> beta.22 (required by
    Azure.AI.AgentServer.Responses beta.3)
  - Replace AgentHostTelemetry.ResponsesSourceName with local constant
    (type made internal in AgentServer.Core beta.22)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CA1873: guard LogError with IsEnabled check in FoundryToolboxService
  
  Wrap the LogError call with an IsEnabled(LogLevel.Error) guard to satisfy
  the CA1873 analyzer rule which flags potentially expensive argument
  evaluation when logging is disabled.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bumping NuGet version
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Hosted agent adapter (#5406)
  
  * Bump preview version to 260420.1 and fix AgentServer package deps
  
  - Bump PackageVersion to 0.0.1-preview.260420.1
  - Bump Azure.AI.AgentServer.Core beta.21 -> beta.22 (required by
    Azure.AI.AgentServer.Responses beta.3)
  - Replace AgentHostTelemetry.ResponsesSourceName with local constant
    (type made internal in AgentServer.Core beta.22)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CA1873: guard LogError with IsEnabled check in FoundryToolboxService
  
  Wrap the LogError call with an IsEnabled(LogLevel.Error) guard to satisfy
  the CA1873 analyzer rule which flags potentially expensive argument
  evaluation when logging is disabled.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bumping NuGet version
  
  * Restore conditional versioning, remove dev feed, bump Azure.AI.Projects to beta.1
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Hosted agent adapter (#5408)
  
  * Bump preview version to 260420.1 and fix AgentServer package deps
  
  - Bump PackageVersion to 0.0.1-preview.260420.1
  - Bump Azure.AI.AgentServer.Core beta.21 -> beta.22 (required by
    Azure.AI.AgentServer.Responses beta.3)
  - Replace AgentHostTelemetry.ResponsesSourceName with local constant
    (type made internal in AgentServer.Core beta.22)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CA1873: guard LogError with IsEnabled check in FoundryToolboxService
  
  Wrap the LogError call with an IsEnabled(LogLevel.Error) guard to satisfy
  the CA1873 analyzer rule which flags potentially expensive argument
  evaluation when logging is disabled.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bumping NuGet version
  
  * Restore conditional versioning, remove dev feed, bump Azure.AI.Projects to beta.1
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR #5312 review comments
  
  - Add comment explaining NU1903 suppression (Microsoft.Bcl.Memory transitive vuln)
  - Remove NU1903 from sample/test projects where not needed
  - Fix Dockerfile ENTRYPOINT mismatch in Hosted-Workflow-Simple
  - Align agent name to 'hosted-workflow-simple' in agent.yaml and README
  - Fix Hosted-McpTools README: replace GitHub PAT refs with Microsoft Learn
  - Fix session persistence: only persist when client provides conversation ID
  - Upgrade IsNullOrEmpty to IsNullOrWhiteSpace for session ID checks
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Split Foundry into stable V1 and preview Hosting package
  
  Extract hosted agent functionality from Microsoft.Agents.AI.Foundry into a
  new Microsoft.Agents.AI.Foundry.Hosting preview package. This resolves NU5104
  build errors caused by the stable Foundry package depending on prerelease
  Azure SDK packages (Azure.AI.AgentServer.Responses, Azure.AI.Projects beta).
  
  Changes:
  - Create Microsoft.Agents.AI.Foundry.Hosting with VersionSuffix=preview,
    targeting .NET Core only (net8.0/9.0/10.0)
  - Move all Hosting/ source files to the new project
  - Move ToolboxRecord/ToolboxVersion overloads to FoundryAIToolExtensions
  - Revert Azure.AI.Projects to 2.0.0 in Directory.Packages.props;
    Hosting uses VersionOverride for 2.1.0-beta.1
  - Clean V1 Foundry csproj: remove beta deps, ASP.NET Core ref, hosting conditionals
  - Update 8 hosted agent sample projects to reference Foundry.Hosting
  - Split unit tests: ToolboxRecord/ToolboxVersion tests moved to Hosting/
  - Add Foundry.Hosting to solution file
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review comments: experimental attrs, doc fixes, token propagation
  
  - Add [Experimental(OPENAI001)] to all 7 public Hosting types per reviewer request
  - Fix McpConsentContext XML doc: 'Thread-static' -> 'Async-local' (AsyncLocal
    flows with ExecutionContext, not thread-static)
  - Expand UserAgentMiddleware test regex to match prerelease versions (e.g. 1.0.0-rc.4)
  - Propagate CancellationToken in AgentFrameworkResponseHandler session save
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove unnecessary MEAI001 suppression from stable Foundry package
  
  MEAI001 was a leftover from when Hosting code lived in the same project.
  The stable V1 Foundry package builds clean without it, and suppressing
  experimental diagnostics in a released package can hide unintentional
  exposure of experimental APIs to consumers.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add Foundry.Hosting to release solution filter
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>

  Roger Barreto · 2026-04-21 20:25:10 +00:00
  f2b215a2f6
• .NET: Features/3768-devui-aspire-integration (#3771)

  * adds devui integration and samples
  
  * adds unit tests for devui integration
  
  * fix: correct formatting of copyright notice in unit test files
  
  * fixes formatting issues
  
  * fixes build for net8 target
  
  * fixes formatting errors on test apphost
  
  * adds copyright notice to multiple files and removes unnecessary using directives
  
  * Update dotnet/aspire-integration/Aspire.Hosting.AgentFramework.DevUI/DevUIAggregatorHostedService.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/aspire-integration/Aspire.Hosting.AgentFramework.DevUI/DevUIAggregatorHostedService.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/tests/Aspire.Hosting.AgentFramework.DevUI.UnitTests/Aspire.Hosting.AgentFramework.DevUI.UnitTests.csproj
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/DevUIIntegration/DevUIIntegration.AppHost/DevUIIntegration.AppHost.csproj
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/aspire-integration/Aspire.Hosting.AgentFramework.DevUI/DevUIAggregatorHostedService.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Refactor project files to use TargetFrameworks instead of TargetFramework for multi-targeting support; add optional port property to DevUIResource class.
  
  * Add unit tests for DevUIAggregatorHostedService; refactor project files for TargetFrameworks support
  
  * Refactor project files to use TargetFrameworks for multi-targeting support in DevUIIntegration samples
  
  * Remove unnecessary using directive for Aspire.Hosting in DevUIAggregatorHostedServiceTests
  
  * merge
  
  * fixes Conversation routing for non-first backends
  
  * add documentation for devui integration sample
  
  * update project references in solution file for improved integration
  
  * fixes package versions post merge
  
  * move Aspire.Hosting.AgentFramework.DevUI to dotnet/src
  
  Move the project from aspire-integration/ to src/ to be consistent
  with the location of all other projects in the repo.
  
  * move DevUI sample to samples/05-end-to-end/DevUIAspireIntegration
  
  Move the sample from samples/DevUIIntegration/ to
  samples/05-end-to-end/DevUIAspireIntegration/ to match the location
  of other end-to-end samples.
  
  * remove unnecessary net472 framework condition from sample csproj files
  
  These projects only target net10.0, so the
  Condition="'$(TargetFramework)' != 'net472'" on ItemGroup is unnecessary.
  
  * update sample model name from gpt-4.1 to gpt-5.4
  
  Use a more up-to-date model name in the DevUI integration samples.
  
  * Revert "remove unnecessary net472 framework condition from sample csproj files"
  
  This reverts commit 08cf41253b.
  
  * fix: use TargetFrameworks to override multi-targeting from Directory.Build.props
  
  The parent Directory.Build.props sets TargetFrameworks to net10.0;net472,
  which overrides the singular TargetFramework in each csproj. Use the plural
  TargetFrameworks property set to net10.0 only to properly override it, and
  remove the now-unnecessary net472 condition on ItemGroup.
  
  * fixes aspire config
  
  * fix: update Microsoft.Extensions packages to version 10.0.1
  
  * Address Copilot review feedback on DevUI Aspire integration
  
  - Fix request body dropping in ProxyConversationsAsync: always read the
    body when ContentLength > 0 before routing, then pass it through to
    all proxy calls (previously null was passed when backend was resolved
    from query param or conversation map)
  - Fix resource leak: dispose aggregator on startup failure in catch block
  - Fix XML docs: accurately describe embedded resource serving behavior
  - Remove reflection from DevUIResourceTests (InternalsVisibleTo already set)
  - Make sensitive telemetry conditional on Development environment in samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: update chat client version to gpt41 in both EditorAgent and WriterAgent
  
  ---------
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Tommaso Stocchi · 2026-04-20 11:12:54 +00:00
  60af59ba8b
• .NET: Add Code Interpreter container file download samples (#5014)

  * Add Code Interpreter container file download samples (#3081)
  
  - Add Agent_OpenAI_Step06_CodeInterpreterFileDownload (Public OpenAI)
  - Add Agent_Step24_CodeInterpreterFileDownload (Microsoft Foundry)
  - Both samples demonstrate downloading cfile_/cntr_ container files
    via ContainerClient instead of the standard Files API
  - Update solution file and parent READMEs
  
  * Address review feedback: flatten nested foreach loops using SelectMany
  
  Addresses https://github.com/microsoft/agent-framework/pull/5014#discussion_r3046908449 and https://github.com/microsoft/agent-framework/pull/5014#discussion_r3046920209
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: rogerbarreto <rogerbarreto@users.noreply.github.com>

  chetantoshniwal · 2026-04-17 16:55:03 +00:00
  52303a8d07
• .NET: Add Handoff sample (#5245)

  * feat: Add Handoff sample
  
  * docs: Add Handoff sample to readme

  Jacob Alber · 2026-04-16 20:02:31 +00:00
  101e07b061
• .NET: Foundry Evals integration for .NET (#4914)

  * Foundry Evals integration for .NET
  
  - Core evaluation framework: EvalItem, LocalEvaluator, FunctionEvaluator, EvalChecks
  - IAgentEvaluator interface with MeaiEvaluatorAdapter bridge
  - AgentEvaluationExtensions for agent.EvaluateAsync() overloads
  - FoundryEvals wrapping MEAI quality/safety evaluators
  - ConversationSplitters (LastTurn, Full) and IConversationSplitter
  - EvalItem.PerTurnItems() for multi-turn decomposition
  - HasImageContent for multimodal content detection
  - WorkflowEvaluationExtensions for per-agent workflow evaluation
  - 7 eval samples mirroring Python parity:
    02-agents/Evaluation: SimpleEval, ExpectedOutputs, Multimodal
    03-workflows/Evaluation: WorkflowEval
    05-end-to-end/Evaluation: FoundryQuality, MixedProviders, ConversationSplits
  - Comprehensive unit tests (1958 passing)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Rewrite FoundryEvals to use real Foundry Evals API
  
  Replace MEAI evaluator shim with actual OpenAI EvaluationClient protocol
  methods. FoundryEvals now creates eval definitions, submits runs, polls
  for completion, and fetches per-item results server-side.
  
  - New constructor: FoundryEvals(AIProjectClient, model, evaluators)
  - Add FoundryEvalConverter for MEAI ChatMessage -> Foundry JSON format
  - Add EvalId, RunId, ReportUrl to AgentEvaluationResults
  - All 20 built-in evaluator constants now work (agent, tool, quality, safety)
  - Remove Microsoft.Extensions.AI.Evaluation.Quality/Safety dependencies
  - Update all samples for new constructor (no more ChatConfiguration)
  - Replace BuildEvaluators tests with ResolveEvaluator tests
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add response output to CustomEvals and ExpectedOutputs samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address review: pagination, validation, error handling, tests
  
  FoundryEvals fixes:
  - Add pagination for output items (has_more/after cursor)
  - Add guard clauses for pollIntervalSeconds/timeoutSeconds <= 0
  - Fix double TryGetProperty for passed field parsing
  - Throw on all-tool-evaluators with no tool definitions
  - Fix XML doc (default 300s, not 180s)
  
  New tests (30 added, 1989 total):
  - EvalChecks: NonEmpty, ContainsExpected (pass/fail/skip/case),
    HasImageContent, ToolCallsPresent
  - FoundryEvalConverter: ConvertMessage (text, image, function call,
    function results fan-out, empty fallback, mixed content),
    ConvertEvalItem, BuildTestingCriteria (quality/agent/tool/groundedness
    data mappings), BuildItemSchema
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix review: null-refs, Data.ToString() bug, ContainsExpected, add tests
  
  - Fix NullReferenceException in sample Response display (pattern matching)
  - Fix WorkflowEvaluationExtensions Data?.ToString() producing type names
    instead of message text (pattern-match ChatMessage/AgentResponse/list)
  - Change EvalChecks.ContainsExpected to return Passed=false when no
    ExpectedOutput (was silently passing, masking misconfiguration)
  - Add EvalItem constructor tests with LastTurn/Full/null splitters
  - Add FoundryEvalConverter.ConvertMessage DataContent (base64 image) test
  - Add ExtractAgentData tests with ChatMessage, list, and AgentResponse data
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix review: conversation fidelity, eval caching, fallback tests
  
  - WorkflowEvaluationExtensions: preserve full response messages (tool calls,
    intermediate) instead of synthetic 2-message conversation. Cast completed
    Data to AgentResponse and use Messages when available, fallback to text.
  - FoundryEvals: cache evalId per schema shape (hasContext, hasTools) so
    subsequent EvaluateAsync calls create runs under the same eval definition.
  - MeaiEvaluatorAdapter: code already correctly passes queryMessages (not full
    conversation) to IEvaluator — no change needed, verified by inspection.
  - Add tests: AgentResponse full messages preservation, unknown object
    ToString() fallback for ExtractAgentData.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Rename AzureAI→Foundry: move eval files, update references
  
  - Move FoundryEvals.cs and FoundryEvalConverter.cs from
    Microsoft.Agents.AI.AzureAI to Microsoft.Agents.AI.Foundry
  - Update namespace from AzureAI to Foundry in both files
  - Add explicit usings required by Foundry project (no implicit usings)
  - Move FoundryEvalConverter tests to Foundry.UnitTests project
    (avoids ReplacingRedactor type conflict from dual project refs)
  - Update all sample csproj references and using statements
  - Remove Foundry project reference from AI UnitTests
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * PR review round 4: wire up tool extraction, remove eval cache, fix null safety
  
  - BuildEvalItem: extract tools from agent via GetService<ChatOptions>() into EvalItem.Tools (Python parity)
  - FoundryEvals: remove eval ID cache - each call creates fresh definition (matches Python behavior)
  - FoundryEvals: replace null-forgiving operators with descriptive InvalidOperationException
  - MixedProviders sample: remove unnecessary explicit PackageReferences (transitively provided)
  - FoundryEvalConverter: document that tool results take precedence over text content
  - Add LocalEvaluator zero-checks test documenting 0 metrics = failed behavior
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Python-dotnet parity: 9 feature gaps filled
  
  New checks:
  - ToolCallArgsMatch() — verify tool call names + argument subset match
  - ToolCalledCheck(ToolCalledMode.Any, ...) — match any of the specified tools
  - ToolCalledMode enum (All/Any)
  
  FoundryEvals enhancements:
  - Default evaluators now [Relevance, Coherence, TaskAdherence] (was Relevance, Coherence)
  - Auto-add ToolCallAccuracy when items have tool definitions
  - EvaluateTracesAsync — evaluate by response_ids, trace_ids, or agent_id
  - EvaluateFoundryTargetAsync — evaluate deployed Foundry targets
  
  Result type enrichment:
  - AgentEvaluationResults: added Status, Error, PerEvaluator, DetailedItems
  - New EvalItemResult/EvalScoreResult/PerEvaluatorResult types
  - FoundryEvals populates all new fields from API responses
  
  Workflow fix:
  - Skip internal executors (_*, input-conversation, end-conversation, end)
  
  Tests: 8 new tests covering ToolCallArgsMatch, ToolCalledMode.Any, internal executor filtering
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add MeaiEvaluatorAdapter and PerTurnItems edge case tests
  
  - 3 tests for MeaiEvaluatorAdapter: query message forwarding, synthetic
    response fallback, multiple items aggregation
  - 3 tests for EvalItem.PerTurnItems: empty conversation, no user messages,
    system+assistant only
  - StubEvaluator and StubChatClient test helpers
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Blocking link check for outdated package in DevUI.
  
  * Replace Dictionary<string, object> payloads with typed wire models
  
  Introduce internal FoundryEvalWireModels.cs with compile-time-safe types
  for the OpenAI Evals API wire format. The OpenAI .NET SDK (2.9.1) only
  provides protocol-level methods with BinaryContent/ClientResult — no
  typed request models. These internal models replace scattered dictionary
  literals with [JsonPropertyName]-annotated classes, giving:
  
  - Compile-time safety (typos become build errors)
  - Single point of change when the API evolves
  - IntelliSense discoverability
  - Cleaner serialization via JsonPolymorphic for content items
  
  Models: WireContentItem hierarchy (text, image, tool_call, tool_result),
  WireMessage, WireEvalItemPayload, WireTestingCriterion, WireItemSchema,
  WireCreateEvalRequest, WireCreateRunRequest, and data source variants.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Skip metric when Foundry returns neither score nor passed
  
  When an evaluator returns no score and no passed value, the previous
  code created BooleanMetric(name, false), which falsely failed items
  via ItemPassed. Now we skip the MEAI metric entirely for indeterminate
  results — the raw data remains available in DetailedItems for diagnostics.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR #4914 review comments: fix tool evaluator bug and add tests
  
  - Fix duplicate ToolCallAccuracy: resolve evaluator names before checking
    against ToolEvaluators set (Comment 2)
  - Make FilterToolEvaluators internal for testability; add tests for the
    ArgumentException edge case when all evaluators are tool-type (Comment 3)
  - Add CancellationToken test for LocalEvaluator (Comment 4)
  - Add EvaluateAsync integration test on Run with sequential workflow and
    per-agent SubResults verification (Comment 5)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address Peter's review comments on PR #4914
  
  - Add trailing newline to Evaluation_FoundryQuality.csproj (Comment 6)
  - Make evaluator name lookups case-insensitive: switch BuiltinEvaluators,
    ToolEvaluators, AgentEvaluators, and ResolveEvaluator's StartsWith check
    from Ordinal to OrdinalIgnoreCase (Comment 7)
  - Add Trace.TraceWarning when Foundry returns fewer results than submitted
    items, indicating expected vs actual count before padding (Comment 8)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add Microsoft.Extensions.AI.Evaluation packages to Directory.Packages.props
  
  These were removed in #5269 as unused, but are needed by the Foundry
  and core evaluation integration added in this PR.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Ben Thomas · 2026-04-16 19:40:07 +00:00
  aee1acbf8b
• .NET: skill as class (#5027)

  * add class-based skills
  
  * address formating issues
  
  * Remove generated filtered-unit.slnx and add to .gitignore
  
  The filtered solution file is generated dynamically by
  eng/scripts/New-FilteredSolution.ps1 during CI. Checking it in
  risks it becoming stale and out-of-sync with the real solution.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove generated filtered-unit.slnx and add to .gitignore
  
  The filtered solution file is generated dynamically by
  eng/scripts/New-FilteredSolution.ps1 during CI. Checking it in
  risks it becoming stale and out-of-sync with the real solution.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * consolidate DI samples into one
  
  * fix file encoding
  
  * suppress compatibility warning
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2026-04-03 11:27:36 +00:00
  3fc1d00026
• .NET: Remove OpenAIAssistantClientExtensions class (#5058)

  * Remove OpenAIAssistantClientExtensions class
  
  Remove the deprecated OpenAI Assistants API extension methods, along with
  their unit tests, integration tests, sample project, and related references.
  
  - Delete OpenAIAssistantClientExtensions.cs (source)
  - Delete OpenAIAssistantClientExtensionsTests.cs (unit + integration tests)
  - Delete Agent_With_OpenAIAssistants sample project
  - Remove sample from solution file, README, and verify-samples definitions
  - Remove AIOpenAIAssistants diagnostic ID constant
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * add removed extension methods to the suppression file
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2026-04-02 13:51:41 +00:00
  a356a16568
• Python: Move workflow-samples and agent-samples under declarative-agents directory (#5011)

  * Move workflow-samples and agent-samples under declarative-agents and update all references
  
  Agent-Logs-Url: https://github.com/microsoft/agent-framework/sessions/f70f7d19-9256-4eec-b7db-28007d74440c
  
  Co-authored-by: sphenry <6749825+sphenry@users.noreply.github.com>
  
  * Fix relative paths in README files inside moved directories
  
  Agent-Logs-Url: https://github.com/microsoft/agent-framework/sessions/f70f7d19-9256-4eec-b7db-28007d74440c
  
  Co-authored-by: sphenry <6749825+sphenry@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: sphenry <6749825+sphenry@users.noreply.github.com>
  Co-authored-by: Shawn Henry <shahen@microsoft.com>

  Copilot · 2026-04-02 09:34:33 +00:00
  fd253c0b0e
• .NET: Rename Microsoft.Agents.AI.AzureAI to Microsoft.Agents.AI.Foundry and consolidate FoundryMemory (#5042)

  * Update Foundry Responses as ChatClientAgent
  
  * Migrate obsolete AzureAI integration tests to versioned agent pattern
  
  Replace obsolete CreateAIAgentAsync/GetAIAgentAsync calls with
  Agents.CreateAgentVersionAsync() + AsAIAgent(AgentVersion) in all
  AzureAI integration tests.
  
  - Rename AIProjectClient* test files to FoundryVersionedAgent*
  - Register AIFunction tools in PromptAgentDefinition.Tools for
    server-side visibility via AsOpenAIResponseTool()
  - Skip structured output tests (AzureAIProjectChatClient clears
    ResponseFormat for versioned agents)
  - Remove all [Obsolete] attributes and #pragma warning disable CS0618
  
  * Merge FoundryMemory package into AzureAI under Memory/ folder
  
  Move all FoundryMemory source, unit tests, and integration tests into
  the Microsoft.Agents.AI.AzureAI package. Change namespace from
  Microsoft.Agents.AI.FoundryMemory to Microsoft.Agents.AI.AzureAI.
  
  - Add [Experimental] to FoundryMemoryProviderOptions and Scope
  - Rename internal AIProjectClientExtensions to MemoryStoreExtensions
  - Update AzureAI .csproj with Compliance.Abstractions, Redaction
  - Remove FoundryMemory from solution and release filter
  - Update sample to reference AzureAI instead of FoundryMemory
  - Delete old Microsoft.Agents.AI.FoundryMemory project and tests
  
  * Add EnsureMemoryStoreCreatedAsync and memory existence checks to integration tests
  
  - Ensure memory store is created before testing memory operations
  - Add AZURE_AI_EMBEDDING_DEPLOYMENT_NAME config setting
  - Assert memories exist in store via SearchMemoriesAsync before cleanup
  - Verify scope isolation with direct memory store queries
  
  * Fix and rename AzureAI unit tests for RAPI vs Versioned clarity
  
  - Rename AsAIAgentAsync_* to AsAIAgent_* (drop Async from method group)
  - Add _Rapi_ prefix to non-versioned (Responses API) tests
  - Add _Versioned_ prefix to versioned agent tests where needed
  - Fix RAPI tests: assert GetService<AIProjectClient>() is null
  - Fix Versioned tests: assert IsType<FoundryAgent> and
    GetService<AIProjectClient>() returns the client instance
  - Fix UserAgent header tests: proper HTTP handler routing
  - Fix ChatClient_UsesDefaultConversationIdAsync test setup
  - All 153 unit tests pass with 0 failures
  
  * Rename Microsoft.Agents.AI.AzureAI to Microsoft.Agents.AI.Foundry
  
  Rename the project, namespace, folder, and all references from
  Microsoft.Agents.AI.AzureAI to Microsoft.Agents.AI.Foundry.
  Also rename Workflows.Declarative.AzureAI to .Foundry.
  
  - Rename src, unit test, integration test, and workflow folders
  - Update namespaces in all source and test .cs files
  - Update ProjectReferences in ~47 sample and test .csproj files
  - Update solution files (.slnx, .slnf)
  - Update sample using statements
  - Update READMEs, SKILL.md, ADRs in docs/
  - Disable package validation baseline for renamed packages
  - Fix UTF-8 BOM encoding on all affected .cs files
  - AzureAI.Persistent left completely unchanged
  
  * Fix format: remove ImplicitUsings, add explicit usings, fix BOM encoding
  
  - Remove ImplicitUsings=enable from Foundry csproj to resolve IDE0005
    on shared ReplacingRedactor.cs
  - Add explicit System usings to all source files that relied on them
  - Sort usings alphabetically per editorconfig rules
  - Fix UTF-8 BOM on 12 sample Program.cs files
  - Rename Azure AI Foundry Agents to Microsoft Foundry Agents in docs

  Roger Barreto · 2026-04-02 01:25:24 +00:00
  628bb1af48
• .NET: Add a verify-samples tool and skill (#5005)

  * Add a verify-samples tool and skill
  
  * Address PR comments
  
  * Move verify-samples to eng folder and improve definitions

  westey · 2026-04-01 10:34:41 +00:00
  acaadc9c45
• Add Neo4j GraphRAG samples (#4994)

  * Add Neo4j GraphRAG samples
  
  * Fix sample CI issues
  
  * Address sample review feedback
  
  * Move Neo4j Python sample to end-to-end
  
  * Make Neo4j GraphRAG sample self-contained
  
  * Remove unused central package versions

  Christian Glessner · 2026-04-01 10:23:04 +00:00
  34329840e1
• .NET: Add inline skills API (#4951)

  * add inline skills
  
  * Fix IDE1006 and IDE0004 formatting errors in test files
  
  - Add 'Async' suffix to async test methods in FilteringAgentSkillsSourceTests,
    DeduplicatingAgentSkillsSourceTests, and AgentInMemorySkillsSourceTests
  - Use pragma to suppress false-positive IDE0004 on casts needed for overload
    disambiguation in AgentInlineSkillTests and AgentInlineSkillResourceTests
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * address issues
  
  * address comments
  
  * make inline skills script and resource model classes internal
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2026-03-30 16:23:04 +00:00
  ade295b122
• .NET: [Breaking] Update Foundry Agents for Responses API (#4502)

  * Stage
  
  * Add FoundryAgentClient, model param, chatClientFactory, and RAPI samples
  
  - Add model parameter to FoundryAgentClient simple constructor
  - Add chatClientFactory parameter to both constructors
  - Switch to OpenAI.GetProjectResponsesClientForModel for direct Responses API usage
  - Add FoundryAgents-RAPI samples (Step01 Basics, Step02 Multiturn, Step03 FunctionTools)
  - Add solution folder entry for FoundryAgents-RAPI samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add auto-discovery constructor and simplify RAPI samples
  
  - Add FoundryAgentClient constructor that reads AZURE_AI_PROJECT_ENDPOINT and
    AZURE_AI_MODEL_DEPLOYMENT_NAME from environment variables with DefaultAzureCredential
  - Simplify RAPI samples to use auto-discovery (no env var or credential code)
  - Remove Azure.Identity direct references from sample csproj files
  - Update READMEs to document environment variable requirements
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add remaining RAPI samples (Step04-Step12)
  
  - Step04: Function tools with human-in-the-loop approvals
  - Step05: Structured output with typed responses
  - Step06: Persisted conversations with session serialization
  - Step07: Observability with OpenTelemetry
  - Step08: Dependency injection with hosted service
  - Step10: Image multi-modality
  - Step11: Agent as function tool (agent composition)
  - Step12: Middleware (PII, guardrails, function logging, HITL approval)
  - Update solution file and folder README with all new samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add all RAPI samples (Step09-Step23) and switch to AzureCliCredential
  
  - Step09: MCP client as tools (GitHub server via stdio)
  - Step13: Plugins with dependency injection
  - Step14: Code Interpreter tool
  - Step15: Computer Use tool with screenshot simulation
  - Step16: File Search with vector stores
  - Step17: OpenAPI tools (REST Countries API)
  - Step18: Bing Custom Search
  - Step19: SharePoint grounding
  - Step20: Microsoft Fabric
  - Step21: Web Search with citations
  - Step22: Memory Search with multi-turn conversations
  - Step23: Local MCP via HTTP (Microsoft Learn)
  - Switch all samples (Step04-Step12) to use AzureCliCredential with env vars
  - Update solution file and README with all 23 samples
  - All 23 samples build successfully, tested Step05/06/11/13/21
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Switch Step01-03 samples to AzureCliCredential for consistency
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Clarify connection ID format in SharePoint and Fabric READMEs
  
  Document that SHAREPOINT_PROJECT_CONNECTION_ID and FABRIC_PROJECT_CONNECTION_ID
  should use the connection name (e.g., 'SharepointTestTool'), not the full ARM
  resource URI.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Normalize env vars, fix structured output, update READMEs with connection ID formats
  
  - Normalize AZURE_FOUNDRY_PROJECT_* env vars to AZURE_AI_PROJECT_ENDPOINT / AZURE_AI_MODEL_DEPLOYMENT_NAME across all samples (Steps 18-22 READMEs + Steps 19-20 Program.cs)
  - Fix RAPI Step05 StructuredOutput to use full constructor with ResponseFormat for streaming JSON
  - Update Deep Research sample to use AzureCliCredential
  - Enrich Bing Grounding README with full ARM resource URI format
  - Fix Bing Custom Search README env var mismatch (BING_CUSTOM_SEARCH_* -> AZURE_AI_CUSTOM_SEARCH_*)
  - Add finding instructions for connection ID and instance name in Bing Custom Search READMEs
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Refactor memory samples and switch to DefaultAzureCredential
  
  - Refactor RAPI Step22 MemorySearch: extract store setup to EnsureMemoryStoreAsync local function
  - Refactor non-RAPI Step22 MemorySearch: same pattern with explicit memory lifecycle
  - Set UpdateDelay=0 on MemoryUpdateOptions and MemorySearchPreviewTool for faster ingestion
  - Use WaitForMemoriesUpdateAsync with 500ms polling interval
  - Switch Step19 SharePoint, Step20 Fabric, Step22 MemorySearch (both) to DefaultAzureCredential
  - Remove SearchOptions from MemorySearchPreviewTool (causes unknown parameter error)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Switch all RAPI samples to DefaultAzureCredential and format
  
  - Replace AzureCliCredential with DefaultAzureCredential across all 20 RAPI samples
  - Run dotnet format on all RAPI and non-RAPI Foundry samples
  - AzureAI unit tests: 341 passed (net10.0 + net472)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Rename to Microsoft Foundry, add metadata, rename RAPI folder
  
  - Replace 'Azure AI Foundry' / 'Azure Foundry' with 'Microsoft Foundry' in all docs, comments, and XML docs
  - Update FoundryAgentClient metadata provider name to 'microsoft.foundry'
  - Rename FoundryAgents-RAPI folder to FoundryResponseAgents
  - Rewrite FoundryResponseAgents README with comparison table vs Foundry Agents
  - Update slnx and parent README with new folder references
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review: simplify sample comments and fix DeepResearch credential
  
  - Remove 'no server-side agent' and 'Responses API directly' phrasing from comments
  - Simplify to 'Create a FoundryAgentClient' per review feedback
  - Switch Agent_Step15_DeepResearch to DefaultAzureCredential
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Restore full DefaultAzureCredential warning comment in DeepResearch sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add ADR 0020: Foundry agent type naming convention
  
  Proposes naming options for a new MAF type wrapping versioned
  Foundry agents (Prompt, ContainerApp, Hosted, Workflow) to
  distinguish from the existing FoundryResponsesAgent (RAPI path).
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Simplify FoundryResponsesAgent samples with env-var constructors and rename folders
  
  - Add env-var constructors to FoundryResponsesAgent (simple + options-based)
  - Fix Constructor 1 model optionality (no longer throws on missing AZURE_AI_MODEL_DEPLOYMENT_NAME)
  - Add ApplyModelDeploymentFallback helper for options-based constructor
  - Update all 23 FoundryResponseAgents samples to remove Environment.GetEnvironmentVariable boilerplate
  - Condense 6 simple samples to one-liner constructor calls
  - Add XML doc remarks about auto-resolved parameters on all constructors
  - Rename FoundryAgents -> FoundryVersionedAgents (server-side, versioned)
  - Rename FoundryResponseAgents -> FoundryAgents (now the default path forward)
  - Update .slnx and README cross-references for new folder names
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add FoundryAITool factory, rename RAPI folders, and clean up references
  
  - Create FoundryAITool static factory class with 17 methods wrapping AgentTool.Create* and ResponseTool.Create* into AITool returns
  - Rename 23 FoundryAgentsRAPI_* subfolders to FoundryAgents_* (drop RAPI prefix)
  - Rename .csproj files and update .slnx references accordingly
  - Update 12 samples (6 FoundryAgents + 6 FoundryVersionedAgents) to use FoundryAITool
  - Replace all FoundryResponsesAgent references with FoundryAgent in comments and READMEs
  - Update sample READMEs to reference FoundryAITool methods
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Rename FoundryVersionedAgents subfolders from FoundryAgents_* to FoundryVersionedAgents_*
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add FoundryVersionedAgent class and refactor extension method internals
  
  - Create FoundryVersionedAgent with private ctor and async static factory methods
    (CreateAIAgentAsync/GetAIAgentAsync) with env-var and explicit endpoint tiers
  - Extract shared internal helpers from AzureAIProjectChatClientExtensions:
    CreateChatClientAgent, CreateAgentVersionFromOptionsAsync,
    CreateAgentVersionWithProtocolAsync (tools overload),
    CreateChatClientAgentOptions, GetAgentRecordByNameAsync, ThrowIfInvalidAgentName
  - Extension methods now delegate to shared internal helpers
  - All 49 existing samples continue to build successfully
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add CreateConversationSessionAsync, DeleteAIAgentAsync, auto-resolve model, simplify samples
  
  - Add CreateConversationSessionAsync to FoundryAgent and FoundryVersionedAgent
    (returns ChatClientAgentSession, creates server-side conversation + session in one call)
  - Add DeleteAIAgentAsync static method to FoundryVersionedAgent
  - Make model parameter optional in env-var factory overloads (auto-resolves from
    AZURE_AI_MODEL_DEPLOYMENT_NAME)
  - Update all FoundryVersionedAgents samples to use DeleteAIAgentAsync
  - Remove deploymentName env var from samples where only used for model parameter
  - Use CreateConversationSessionAsync in Step02_MultiturnConversation
  - Use explicit types instead of var for agent/session variables
  - All 49 samples build successfully
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove manual AIProjectClient construction from FoundryVersionedAgents samples
  
  - Replace manual AIProjectClient construction with GetService<AIProjectClient>()
    from the FoundryVersionedAgent in all dual-option and tool-specific samples
  - Remove AZURE_AI_PROJECT_ENDPOINT env var reads from updated samples
  - Remove Azure.Identity usings where no longer needed
  - Only Step01.1, Step01.2, Eval_Step01 retain manual construction (pedagogical samples)
  - All 49 samples build successfully
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Replace aiProjectClient extension calls with FoundryVersionedAgent factories in all samples
  
  - Replace aiProjectClient.CreateAIAgentAsync with FoundryVersionedAgent.CreateAIAgentAsync
    in Option 2 (Native SDK) paths across Steps 14-21
  - Replace aiProjectClient.Agents.DeleteAgentAsync with FoundryVersionedAgent.DeleteAIAgentAsync
  - Remove unused AIProjectClient variables and using directives
  - Only Step01.1, Step01.2, Eval_Step01 retain direct AIProjectClient usage (pedagogical)
  - Step16, Step22 use GetService<AIProjectClient>() for file/memory operations
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove unused using directives from Step01.2, Step09, Eval_Step02
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update ADR 0020 with accepted decision: Option 6
  
  - Add Option 6 detailing FoundryAgent, FoundryVersionedAgent, FoundryAITool,
    env-var auto-discovery, and self-contained factory patterns
  - Mark decision as accepted with rationale
  - Update current state and metadata sections
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update Step01 basics samples to use FoundryVersionedAgent factories
  
  - Step01.1: Replace manual AIProjectClient/AsAIAgent with FoundryVersionedAgent.CreateAIAgentAsync/GetAIAgentAsync/DeleteAIAgentAsync
  - Step01.2: Replace manual AIProjectClient with FoundryVersionedAgent.CreateAIAgentAsync/DeleteAIAgentAsync
  - Remove env var boilerplate and Azure.Identity dependency
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add DeleteAIAgentVersionAsync to FoundryVersionedAgent
  
  - DeleteAIAgentAsync: deletes the agent and all its versions (existing)
  - DeleteAIAgentVersionAsync: deletes only the specific version associated with the agent instance
  - Internally delegates to Agents.DeleteAgentAsync vs Agents.DeleteAgentVersionAsync
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix cleanup comments: DeleteAIAgentAsync deletes the agent and all its versions
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update all FoundryVersionedAgents READMEs for FoundryVersionedAgent and auto-discovery
  
  - Rewrite main README with FoundryVersionedAgent usage, auto-discovery table, code example
  - Fix sample table links from FoundryAgents_Step* to FoundryVersionedAgents_Step*
  - Add FoundryAITool references in tool-specific sample descriptions
  - Update individual READMEs: fix stale paths, add auto-discovery note after env var blocks
  - Update tool references: AgentTool/ResponseTool -> FoundryAITool
  - Update parent 02-agents/README.md with FoundryVersionedAgent description
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Revert unrelated AGUI and Hosting.OpenAI formatting changes to main
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove env-var auto-discovery, add AsAIAgent, mark extensions Obsolete
  
  - Remove 2 env-var constructors from FoundryAgent (keep explicit endpoint ctors)
  - Remove 5 env-var factory methods from FoundryVersionedAgent (keep explicit ones)
  - Add 3 AsAIAgent static methods to FoundryVersionedAgent (AgentVersion/AgentRecord/AgentReference)
  - Mark all 8 AIProjectClient extension methods as [Obsolete] pointing to FoundryVersionedAgent
  - Remove ApplyModelDeploymentFallback, env var constants, Azure.Identity usings from source
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update all samples to use explicit endpoint, credential, and model parameters
  
  - Add explicit Environment.GetEnvironmentVariable reads for AZURE_AI_PROJECT_ENDPOINT
    and AZURE_AI_MODEL_DEPLOYMENT_NAME to all 48 sample files
  - Pass new Uri(endpoint), new DefaultAzureCredential(), deploymentName to
    FoundryAgent constructors and FoundryVersionedAgent factory methods
  - Add using Azure.Identity where missing
  - Matches repo-wide pattern used by other non-Foundry samples
  - All 49 samples build successfully
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Migrate remaining samples and source from obsoleted extension methods
  
  - Migrate AgentProviders, AgentWithRAG, AgentWithMemory, HostedWorkflow samples to FoundryVersionedAgent
  - Migrate AzureAgentProvider.cs to FoundryVersionedAgent.AsAIAgent
  - Migrate AzureAIProjectChatClientTests.cs to FoundryVersionedAgent.GetAIAgentAsync
  - Remove pragma suppressions from migrated files
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add unit tests for FoundryAgent and FoundryVersionedAgent
  
  - FoundryAgentTests.cs: 14 tests covering constructors, validation,
    properties, metadata, GetService, chat client factory, user-agent header
  - FoundryVersionedAgentTests.cs: 31 tests covering CreateAIAgentAsync,
    GetAIAgentAsync, AsAIAgent (3 overloads), DeleteAIAgentAsync,
    DeleteAIAgentVersionAsync, validation, invalid names, metadata, GetService
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Finalize Foundry agent migration
  
  Align FoundryAgent and FoundryVersionedAgent samples, docs, and tests with the explicit configuration model, clean up stale README guidance, and fix AzureAI unit test validation/build issues.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Apply formatter cleanup after validation
  
  Capture the dotnet format follow-up changes produced during branch validation so the committed state matches the successfully built and tested branch.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add integration tests for FoundryAgent and FoundryVersionedAgent
  
  Mark old AIProjectClient extension-method integration tests as obsolete and add new integration test suites for both FoundryAgent (Responses API) and FoundryVersionedAgent (versioned agents). All 71 non-skipped tests pass against the live Foundry service.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update ADR 0020 with test coverage details
  
  Add integration test coverage note to the Current State section of ADR 0020.
  
  * Simplify Foundry agents and validate moved samples
  
  * Rename FoundryAgent integration tests to ResponsesAgent
  
  The test classes exercise the non-versioned Responses path via
  AIProjectClient.AsAIAgent(), not the removed FoundryAgent wrapper type.
  Rename files and class names to reflect the actual test surface.
  
  * Update documentation for ChatClientAgent usage
  
  Added example usage of ChatClientAgent with JokerAgent.
  
  * Refactor ChatClientAgent instantiation for clarity
  
  * Revise agent type naming and usage examples
  
  Updated documentation to reflect changes in agent creation methods and added examples for using `ChatClientAgent`.
  
  * Fix Azure SDK namespace migration after rebase
  
  Update Azure.AI.Projects.OpenAI references to Azure.AI.Projects.Agents
  and Azure.AI.Extensions.OpenAI to match Azure.AI.Projects 2.0.0-beta.2.
  
  - Replace deprecated namespace across samples, tests, and src
  - Fix renamed types: OpenAPIFunctionDefinition -> OpenApiFunctionDefinition,
    BingCustomSearchToolParameters -> BingCustomSearchToolOptions,
    BrowserAutomationToolParameters -> BrowserAutomationToolOptions
  - Fix API changes: AgentRecord.Versions -> GetLatestVersion(),
    ResponsesClient constructor, FunctionApprovalRequestContent ->
    ToolApprovalRequestContent
  - Apply dotnet format
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address merge markers
  
  * Replace obsolete GetAIAgentAsync with AsAIAgent in samples
  
  Switch Agent_Step07_AsMcpTool and A2AServer to use the non-obsolete
  PersistentAgentsClient.AsAIAgent(PersistentAgent) extension instead
  of the deprecated GetAIAgentAsync, fixing CS0618 build errors.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix broken markdown links in Responses sample READMEs
  
  Replace stale ChatClientAgents_Step* folder references with the
  correct Agent_Step* names across all Responses sample READMEs.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix format errors and address PR review comments
  
  - Fix charset and remove unused using in AzureAIProjectResponsesChatClient
  - Fix doc comment tags (code -> c) in FoundryAITool
  - Fix stray period in LocalMCP sample comment
  - Fix grammar in FoundryMemoryProvider xmldoc
  - Fix AIProjectClientAgentRunStreamingConversationTests base class
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Apply dotnet format fixes to PR-changed files
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix build errors from format pass and apply naming conventions
  
  - Fix static call to CreateSessionAsync in Step02 samples and extension tests
  - Use expression-bodied lambda in FoundryMemoryProvider (RCS1021)
  - Apply PascalCase naming to const fields in ResponsesAgentExtensionCreateTests (IDE1006)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Introduce FoundryAgent sealed type and update AsAIAgent extensions
  
  - Add FoundryAgent sealed class wrapping ChatClientAgent with:
    - Public ctors: (projectEndpoint, credential, model, instructions) and (agentEndpoint, credential)
    - Internal ctor: (AIProjectClient, ChatClientAgent) for extension use
    - CreateConversationSessionAsync() for server-side conversations
    - GetService<ChatClientAgent>() and GetService<AIProjectClient>()
    - MEAI user-agent policy on internally-created AIProjectClient
  - Change all AsAIAgent extension return types from ChatClientAgent to FoundryAgent
  - Update all samples and tests to use FoundryAgent type
  - Add 16 FoundryAgentTests covering ctors, GetService, UserAgent, RunAsync
  - Fix pre-existing Agent_Step12_Plugins build error
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Collapse sample folders and add FoundryAgent_Step01 sample
  
  - Move all Responses/* samples up to AgentsWithFoundry/ (flat structure)
  - Remove entire Versioned/ folder (26 samples)
  - Add FoundryAgent_Step01 sample showing direct FoundryAgent ctor usage
  - Update slnx to reflect flat folder structure
  - Fix csproj ProjectReference paths for new depth
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update READMEs for flat AgentsWithFoundry structure
  
  - Rewrite AgentsWithFoundry/README.md with FoundryAgent quick start
  - Fix cd commands and paths in 11 sample READMEs
  - Update 02-agents/README.md to single Foundry link
  - Update AGENTS.md tree to flat structure
  - Fix AgentWithMemory cross-reference
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix FoundryAgent_Step01 sample with full create/run/delete lifecycle
  
  Show the complete server-side agent lifecycle: create version with
  native SDK, wrap as FoundryAgent via AsAIAgent, run, then delete.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Revert RAPI samples to use AIAgent instead of FoundryAgent
  
  RAPI samples should not reference FoundryAgent directly. Restored
  original sample code with only ChatClientAgent -> AIAgent type change
  to accommodate the AsAIAgent return type.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Convert versioned-pattern samples to pure RAPI
  
  Step09, Step13, Step17, Step22 were using CreateAgentVersionAsync +
  PromptAgentDefinition which is the versioned pattern. Converted to
  use AsAIAgent(model, instructions, tools) which is the RAPI path.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix format issues from Docker CI check
  
  - FoundryAgent_Step01: CRLF -> LF
  - Agent_Step09: missing final newline
  - Agent_Step11_Middleware: add internal modifier, final newline
  - Agent_Step02: remove redundant cast (IDE0004)
  - Agent_Step08: simplify name (IDE0001)
  - FoundryAgentTests: s_ prefix, Async suffix naming conventions
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Switch Step09 MCP sample to Microsoft Learn HTTP endpoint
  
  Replace npx stdio GitHub MCP server with the public Microsoft Learn
  MCP endpoint (https://learn.microsoft.com/api/mcp) using HTTP transport.
  No external tooling required to run.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix missing final newline in Step09 MCP sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review: use DelegatingAIAgent, clean up Step01 sample
  
  - FoundryAgent now inherits DelegatingAIAgent instead of AIAgent,
    removing manual delegation boilerplate (westey-m feedback)
  - Simplified Agent_Step01_Basics to single agent creation path,
    moved composable IChatClient approach to README (westey-m feedback)
  - Fixed FoundryAgentTests param name assertion
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update sample using Project specialized type instead
  
  * Address PR review feedback: DefaultAzureCredential warnings, sample simplifications, format fixes
  
  - Add DefaultAzureCredential production warning comments to ~25 samples
  - Simplify Anthropic and OpenAI Step01 samples to single agent
  - Convert Step11 Middleware regex patterns to [GeneratedRegex]
  - Remove unnecessary cleanup comment from Step06
  - Fix Step09 README MCP transport description
  - Enhance FoundryAgent xmldoc with non-persistent agent comparison
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Split Step02, simplify RAG Step04, sharpen Step23 differentiation
  
  - Split Step02 into 02.1 (simple multi-turn via sessions) and 02.2 (server-side conversations via CreateConversationSessionAsync)
  - RAG Step04: replace HostedFileSearchTool + MEAI wrapping with native OpenAI FileSearchTool
  - Step23: clarify DelegatingAIFunction wrapping pattern vs Step09 basic MCP
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix Hosted MCP sample: use ResponseTool.CreateMcpTool and move tool to PromptAgentDefinition
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix broken README link after Step02 split
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address Sergey round 3 feedback: branding, README nav, sample rename
  
  - Replace 'Azure AI Foundry' with 'Microsoft Foundry' in ADR 0020
  - Fix 3 READMEs: 'ChatClientAgents' → 'AgentsWithFoundry' sample directory
  - Rename FoundryAgent_Step01 → Agent_Step00_FoundryAgentLifecycle for naming consistency
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-03-30 12:09:02 +00:00
  f45fc7d402
• .NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871)

  * initial commit
  
  * address comments
  
  * address comments
  
  * address comments
  
  * address  comments
  
  * rename executor to runner to align naming with python implementation
  
  * rename runner execute method to run method
  
  * remove poc leftovers and fix compilation issues
  
  * make script runner optional
  
  * remove unnecessary pragmas
  
  * make resources and scripts props virtual
  
  * address comments
  
  * update comment for name validation regex
  
  * address comments

  SergeyMenshykh · 2026-03-26 22:27:17 +00:00
  0fcbe7e105
• .NET: Expose workflows as MCP tools when hosting on Azure functions (#4768)

  * Expose workflow as MCP Tool
  
  * Expose workflow as MCP Tool
  
  * Cleanup
  
  * PR feedback fixes
  
  * update changelog to include PR numner
  
  * Improvements to error handling.
  
  * Adding a sample project demonstrating how to setup Agents and Workflows together.
  
  * Ensure duplicate agent registrations are properly handled.

  Shyju Krishnankutty · 2026-03-25 15:43:15 +00:00
  49d69b3bf5
• .NET: Persist messages during function call loop (#4762)

  * Persist messages during the Function Call Loop
  
  * Revert version reset
  
  * Fix bugs and improve sample
  
  * Fix formatting issues
  
  * Also updating conversation id during run
  
  * Update based on ADR feedback

  westey · 2026-03-25 11:53:45 +00:00
  87962e53c5
• .NET: Update AIContextProviders to use Microsoft.Extensions.Compliance.Redaction (#4854)

  * Update providers to use Microsoft.Extensions.Compliance.Redaction
  
  * Fix formatting.
  
  * Fix readme

  westey · 2026-03-24 18:12:55 +00:00
  2c000b032d
• .NET: Update Hosted Samples References to latest beta.11 (#4853)

  * Bump HostedAgents samples to AgentFramework beta.11 and pass credential to UseFoundryTools
  
  Update all 8 HostedAgents samples:
  - Azure.AI.AgentServer.AgentFramework -> 1.0.0-beta.11
  - Microsoft.Agents.AI.OpenAI -> 1.0.0-rc4
  - Microsoft.Agents.AI/AzureAI/Workflows -> 1.0.0-rc4
  - Azure.AI.Projects -> 2.0.0-beta.1
  - Fix Workflow.AsAgent() -> AsAIAgent() in FoundryMultiAgent
  - Pass credential to UseFoundryTools in AgentWithTools (resolves #56802)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove AgentWithTools sample (UseFoundryTools no longer supported)
  
  Remove the AgentWithTools hosted agent sample as the UseFoundryTools
  backend is no longer supported. Updated HostedAgents README and solution
  file to remove all references.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix AgentWithHostedMCP: downgrade Azure.AI.OpenAI to 2.8.0-beta.1 for rc4 compatibility
  
  Azure.AI.OpenAI 2.9.0-beta.1 has breaking changes (GetResponsesClient no
  longer accepts deployment name, ResponsesClient.Model removed) that are
  incompatible with Microsoft.Agents.AI.OpenAI rc4. Pin to 2.8.0-beta.1 and
  use GetResponsesClient(deploymentName).AsAIAgent() pattern.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-03-23 17:41:49 +00:00
  9a47620f64
• .NET: Add durable workflow support (#4436)

  * .NET: [Feature Branch] Add basic durable workflow support (#3648)
  
  * Add basic durable workflow support.
  
  * PR feedback fixes
  
  * Add conditional edge sample.
  
  * PR feedback fixes.
  
  * Minor cleanup.
  
  * Minor cleanup
  
  * Minor formatting improvements.
  
  * Improve comments/documentation on the execution flow.
  
  * .NET: [Feature Branch] Add Azure Functions hosting support for durable workflows (#3935)
  
  * Adding azure functions workflow support.
  
  * - PR feedback fixes.
  - Add example to demonstrate complex Object as payload.
  
  * rename instanceId to runId.
  
  * Use custom ITaskOrchestrator to run orchestrator function.
  
  * .NET: [Feature Branch] Adding support for events & shared state in durable workflows (#4020)
  
  * Adding support for events & shared state in durable workflows.
  
  * PR feedback fixes
  
  * PR feedback fixes.
  
  * Add YieldOutputAsync calls to 05_WorkflowEvents sample executors
  
  The integration test asserts that WorkflowOutputEvent is found in the
  stream, but the sample executors only used AddEventAsync for custom
  events and never called YieldOutputAsync. Since WorkflowOutputEvent is
  only emitted via explicit YieldOutputAsync calls, the assertion would
  fail. Added YieldOutputAsync to each executor to match the test
  expectation and demonstrate the API in the sample.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix deserialization to use shared serializer options.
  
  * PR feedback updates.
  
  * Sample cleanup
  
  * PR feedback fixes
  
  * Addressing PR review feedback for DurableStreamingWorkflowRun
  
     - Use -1 instead of 0 for taskId in TaskFailedException when task ID is not relevant.
     - Add [NotNullWhen(true)] to TryParseWorkflowResult out parameter following .NET TryXXX conventions.
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: [Feature Branch]  Add nested sub-workflow support for durable workflows (#4190)
  
  * .NET: [Feature Branch] Add nested sub-workflow support for durable workflows
  
  * fix readme path
  
  * Switch Orchestration output from string to DurableWorkflowResult.
  
  * PR feedback fixes
  
  * Minor cleanup based on PR feedback.
  
  * .NET: [Feature Branch] Add Human In the Loop support for durable workflows (#4358)
  
  * Add Azure Functions HITL workflow sample
  
  Add 06_WorkflowHITL Azure Functions sample demonstrating Human-in-the-Loop
  workflow support with HTTP endpoints for status checking and approval responses.
  
  The sample includes:
  - ExpenseReimbursement workflow with RequestPort for manager approval
  - Custom HTTP endpoint to check workflow status and pending approvals
  - Custom HTTP endpoint to send approval responses via RaiseEventAsync
  - demo.http file with step-by-step interaction examples
  
  * PR feedback fixes
  
  * Minor comment cleanup
  
  * Minor comment clReverted the `!context.IsReplaying` guards on `PendingEvents.Add`/`RemoveAll` and `SetCustomStatus` in `ExecuteRequestPortAsync`. The guards broke fan-out scenarios where parallel RequestPorts      need to be discoverable after replay. `SetCustomStatus` is idempotent metadata that doesn't affect replay determinism.eanup
  
  * fix  for PR feedback
  
  * PR feedback updates
  
  * Improvements to samples
  
  * Improvements to README
  
  * Update samples to use parallel request ports.
  
  * Unit tests
  
  * Introduce local variables to improve readability of Workflows.Workflows access patter
  
  * Use GitHub-style callouts and add PowerShell command variants in HITL sample README
  
  * Add changelog entries for durable workflow support (#4436)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bump Microsoft.DurableTask.Worker to 1.19.1 to fix version downgrade
  
  Microsoft.Azure.Functions.Worker.Extensions.DurableTask 1.13.1 requires
  Microsoft.DurableTask.Worker >= 1.19.1 via its transitive dependency on
  Microsoft.DurableTask.Worker.Grpc 1.19.1.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix broken markdown links in durable workflow sample READMEs
  
  - Create Workflow/README.md with environment setup docs
  - Fix ../README.md -> ../../README.md in ConsoleApps 01, 02, 03, 08
  - Fix SubWorkflows relative path (3 levels -> 4 levels up)
  - Fix dead Durable Task Scheduler URL
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix build errors from main merge: Throw conflict, ExecuteAsync rename, GetNewSessionAsync rename
  
  - Remove InjectSharedThrow from DurableTask csproj (uses Workflows' internal Throw via InternalsVisibleTo)
  - Update ExecuteAsync -> ExecuteCoreAsync with WorkflowTelemetryContext.Disabled
  - Update GetNewSessionAsync -> CreateSessionAsync
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Move durable workflow samples to 04-hosting/DurableWorkflows
  
  Aligns with main branch sample reorganization where durable samples
  live under 04-hosting/ (alongside DurableAgents/).
  
  - Move samples/Durable/Workflow/ -> samples/04-hosting/DurableWorkflows/
  - Add Directory.Build.props matching DurableAgents pattern
  - Update slnx project paths
  - Update integration test sample paths
  - Update README cd paths and cross-references
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix build errors: remove duplicate base class members, update renamed APIs
  
  - Remove duplicate OutputLog, WriteInputAsync, CreateTestTimeoutCts, etc. from
    ConsoleAppSamplesValidation (already in SamplesValidationBase)
  - Update AddFanInEdge -> AddFanInBarrierEdge in workflow samples
  - Update GetNewSessionAsync -> CreateSessionAsync in workflow samples
  - Update SourceId -> ExecutorId (obsolete) in workflow samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix dotnet format issues: add UTF-8 BOM and remove unused using
  
  - Add UTF-8 BOM to 20 .cs files across DurableTask, AzureFunctions,
    unit tests, and workflow samples
  - Remove unnecessary using directive in 07_SubWorkflows/Executors.cs
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix typo PaymentProcesser -> PaymentProcessor and garbled arrows in README
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix GetExecutorName to handle agent names with underscores
  
  Split on last underscore instead of first, and validate that the
  suffix is a 32-char hex string (sanitized GUID) before stripping it.
  This prevents truncation of agent names like 'my_agent' when the
  executor ID is 'my_agent_<guid>'.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Align DurableTask.Client.AzureManaged to 1.19.1
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bump DurableTask and Azure Functions extension package versions
  
  - DurableTask.* packages: 1.19.1 -> 1.22.0
  - Functions.Worker.Extensions.DurableTask: 1.13.1 -> 1.16.0
  - Functions.Worker.Extensions.DurableTask.AzureManaged: 1.0.1 -> 1.5.0 (telemetry bug fix)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Bump DurableTask SDK packages to 1.22.0
  
  - DurableTask.Client: 1.19.1 -> 1.22.0
  - DurableTask.Client.AzureManaged: 1.19.1 -> 1.22.0
  - DurableTask.Worker: 1.19.1 -> 1.22.0
  - DurableTask.Worker.AzureManaged: 1.19.1 -> 1.22.0
  - Azure Functions extensions kept at original versions (1.13.1/1.0.1) due to
    host-side DurableTask.Core 3.7.0 incompatibility with newer extensions
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update Microsoft.Azure.Functions.Worker.Extensions.DurableTask to "1.16.0"
  
  * Add the local.settings.json files to the sample which were previously ignored. This aligns with our other samples.
  
  * Increase timeout for tests as CI has them failing transiently.
  
  * increaset timeout value for azure functions integration tests.
  
  * Add YieldsOutput(string) to workflow shared state sample executors
  
  ValidateOrder and EnrichOrder call YieldOutputAsync with string messages,
  but only their TOutput (OrderDetails) was in the allowed yield types.
  This caused TargetInvocationException in the WorkflowSharedState sample
  validation integration test.
  
  * Downgrade the durable packages to 1.18.0
  
  * Downgrading Worker.Extensions.DurableTask to 1.12.1
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Shyju Krishnankutty · 2026-03-16 23:00:50 +00:00
  cbcdb2d29e
• .NET Compaction - Introducing compaction strategies and pipeline (#4533)

  * Checkpoint
  
  * Checkpoint
  
  * Stable
  
  * Strategies
  
  * Updated
  
  * Encoding
  
  * Formatting
  
  * Cleanup
  
  * Formatting
  
  * Tests
  
  * Tuning
  
  * Update tests
  
  * Test update
  
  * Remove working solution
  
  * Add sample to solution
  
  * Sample readyme
  
  * Experimental
  
  * Format
  
  * Formatting
  
  * Encoding
  
  * Support IChatReducer
  
  * Sample output formatting
  
  * Initial plan
  
  * Replace CompactingChatClient with MessageCompactionContextProvider
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Boundary condition
  
  * Fix encoding
  
  * Fix cast
  
  * Test coverage
  
  * Namespace
  
  * Improvements
  
  * Efficiency
  
  * Cleanup
  
  * Detect service managed conversation
  
  * Fix namespace
  
  * Fix merge
  
  * Fix test expectation
  
  * Update dotnet/src/Microsoft.Agents.AI.Abstractions/InMemoryChatHistoryProvider.cs
  
  Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>
  
  * Address PR comments (x1)
  
  * Update comment
  
  * Update comments
  
  * Clean-up
  
  * Format output
  
  * Sync sample comment
  
  * Fix condition
  
  * Adjust data-flow
  
  * Address comments (x2)
  
  * Direct compaction
  
  * Fix summarization content
  
  * Argument check / fix count calculation
  
  * Minor follow-up
  
  * Diagnostics
  
  * Minor updates
  
  * Fix state test
  
  * Fix sliding window perf
  
  * Stable state keys
  
  * Increase size computation
  
  * Formatting
  
  * Add README.md for Agent_Step18_CompactionPipeline sample (#4574)
  
  * Sample comments
  
  * Updated
  
  * Update dotnet/src/Microsoft.Agents.AI/Compaction/MessageIndex.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/tests/Microsoft.Agents.AI.UnitTests/Compaction/CompactionProviderTests.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/src/Microsoft.Agents.AI/Compaction/MessageIndex.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Address copilot comments
  
  * Fix namespace
  
  * Comments / convensions
  
  * Prefix `MessageGroup` and `MessageIndex`
  
  * Fix sliding window
  
  * Update dotnet/src/Microsoft.Agents.AI/Compaction/SummarizationCompactionStrategy.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/src/Microsoft.Agents.AI.Abstractions/InMemoryChatHistoryProvider.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Python alignment
  
  * Fix merge
  
  * Fix equality, readme, and sample
  
  * Readme update and ToolResult fix
  
  * Update dotnet/src/Microsoft.Agents.AI/Compaction/SummarizationCompactionStrategy.cs
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update dotnet/samples/02-agents/Agents/Agent_Step18_CompactionPipeline/README.md
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Simplify readme
  
  * Update dotnet/samples/02-agents/Agents/Agent_Step18_CompactionPipeline/README.md
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Remove example
  
  * Remove unused
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

  Chris · 2026-03-11 00:41:39 +00:00
  d3f0c33180
• .NET: Create a sample to show bounded chat history with overflow into chat history memory (#4136)

  * Create a sample to show bounded chat history with overflow into chat history memory
  
  * Address PR comments.
  
  * Address PR comment and fix bug

  westey · 2026-03-06 18:03:43 +00:00
  c8750cbe92
• .NET: Update HostedAgents samples to Azure.AI.AgentServer.AgentFramework 1.0.0-beta.9 and MEAI 10.3.0 (#4477)

  * Initial plan
  
  * Update HostedAgents samples to Azure.AI.AgentServer.AgentFramework 1.0.0-beta.9 and MEAI 10.3.0
  
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * Fix HostedAgents samples for Microsoft.Agents.AI 1.0.0-rc2 API changes
  
  - Rename CreateAIAgent -> AsAIAgent (AgentThreadAndHITL, AgentWithHostedMCP, AgentWithTextSearchRag)
  - Rename AsAgent -> AsAIAgent (AgentsInWorkflows)
  - Replace AIContextProviderFactory with AIContextProviders and simplified TextSearchProvider ctor (AgentWithTextSearchRag)
  - Update Microsoft.Agents.AI.OpenAI to 1.0.0-rc2 (AgentThreadAndHITL, AgentWithTextSearchRag, AgentWithTools)
  - Update Microsoft.Agents.AI.Workflows to 1.0.0-rc2 (AgentsInWorkflows)
  - Add Microsoft.Agents.AI 1.0.0-rc2 reference (AgentWithHostedMCP)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update HostedAgents samples for beta.9 API changes and add missing projects to slnx
  
  - Use DefaultAzureCredential consistently across all samples
  - Add AgentThreadAndHITL, AgentWithLocalTools, AgentWithTools to slnx
  - Apply dotnet format
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove unnecessary Microsoft.Agents.AI.* package references (transitive from AgentFramework)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add DefaultAzureCredential production warning comments to all HostedAgents samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update HostedAgents READMEs to reflect DefaultAzureCredential usage
  
  Replace AzureCliCredential references with DefaultAzureCredential in all
  HostedAgents README files to match the actual sample code.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Replace Microsoft.Extensions.AI.OpenAI with Microsoft.Agents.AI.OpenAI and remove AsIChatClient()
  
  Swap package references from Microsoft.Extensions.AI.OpenAI to
  Microsoft.Agents.AI.OpenAI across all 6 HostedAgents samples. This enables
  using the AsAIAgent() extension directly on ChatClient/ResponsesClient
  (from OpenAI.Chat/OpenAI.Responses namespaces), removing the intermediate
  AsIChatClient() call in 3 samples where it was unnecessary.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Use explicit types and AsAIAgent() extensions across all HostedAgents samples
  
  Replace var with explicit types for clarity in all 6 samples. Replace
  new ChatClientAgent() constructor calls with chatClient.AsAIAgent()
  extension method in AgentWithLocalTools and AgentsInWorkflows.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Copilot · 2026-03-06 12:15:10 +00:00
  7e98b0cd29
• .NET: CI Build time end to end improvement (#4208)

  * .NET: Upgrade to XUnit 3 and Microsoft Testing Platform (#4176)
  
  * Fix copilot studio integration tests failure (#4209)
  
  * Fix anthropic integration tests and skip reason (#4211)
  
  * Remove accidental add of code coverage for integration tests (#4219)
  
  * Add solution filtered parallel test run (#4226)
  
  * Fix build paths (#4228)
  
  * Fix coverage settings path and trait filter (#4229)
  
  * Add project name filter to solution (#4231)
  
  * Increase Integration Test Parallelism (#4241)
  
  * Increase integration tests threads to 4x (#4242)
  
  * Separate build and test into parallel jobs (#4243)
  
  * Filter src by framework for tests build (#4244)
  
  * Separate build and test into parallel jobs
  
  * Filter source projects by framework for tests build
  
  * Pre-build samples via tests to avoid timeouts (#4245)
  
  * Separate build from run for console sample validation (#4251)
  
  * Address PR comments (#4255)
  
  * Merge and move scripts (#4308)
  
  * .NET: Add Microsoft Fabric sample #3674 (#4230)
  
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  
  * Python: Phase 2: Embedding clients for Ollama, Bedrock, and Azure AI Inference (#4207)
  
  * Phase 2: Embedding clients for Ollama, Bedrock, and Azure AI Inference
  
  Add embedding client implementations to existing provider packages:
  
  - OllamaEmbeddingClient: Text embeddings via Ollama's embed API
  - BedrockEmbeddingClient: Text embeddings via Amazon Titan on Bedrock
  - AzureAIInferenceEmbeddingClient: Text and image embeddings via Azure AI
    Inference, supporting Content | str input with separate model IDs for
    text (AZURE_AI_INFERENCE_EMBEDDING_MODEL_ID) and image
    (AZURE_AI_INFERENCE_IMAGE_EMBEDDING_MODEL_ID) endpoints
  
  Additional changes:
  - Rename EmbeddingCoT -> EmbeddingT, EmbeddingOptionsCoT -> EmbeddingOptionsT
  - Add otel_provider_name passthrough to all embedding clients
  - Register integration pytest marker in all packages
  - Add lazy-loading namespace exports for Ollama and Bedrock embeddings
  - Add image embedding sample using Cohere-embed-v3-english
  - Add azure-ai-inference dependency to azure-ai package
  
  Part of #1188
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix mypy duplicate name and ruff lint issues
  
  - Rename second 'vector' variable to 'img_vector' in image embedding loop
  - Combine nested with statements in tests
  - Remove unused result assignments in tests
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * updates from feedback
  
  * Fix CI failures in embedding usage handling
  
  - Fix Azure AI embedding mypy issues by normalizing vectors to list[float],
    safely accumulating optional usage token fields, and filtering None entries
    before constructing GeneratedEmbeddings
  - Avoid Bandit false positive by initializing usage details as an empty dict
  - Update OpenAI embedding tests to assert canonical usage keys
    (input_token_count/total_token_count)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * [Purview] Mark responses as responses and fix epoch bug for python long overflow (#4225)
  
  * .NET: Support InvokeMcpTool for declarative workflows (#4204)
  
  * Initial implementation of InvokeMcpTool in declarative workflow
  
  * Cleaned up sample implementation
  
  * Updated sample comments.
  
  * Added missing executor routing attribute
  
  * Fix PR comments.
  
  * Updated based on PR comments.
  
  * Updated based on PR comments.
  
  * Removed unnecessary using statement.
  
  * Update Python package versions to rc2 (#4258)
  
  - Bump core and azure-ai to 1.0.0rc2
  - Bump preview packages to 1.0.0b260225
  - Update dependencies to >=1.0.0rc2
  - Add CHANGELOG entries for changes since rc1
  - Update uv.lock
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * .NET: Fixing issue where OpenTelemetry span is never exported in .NET in-process workflow execution (#4196)
  
  * 1. Add reproduction test for issue #4155: workflow.run Activity never stopped in streaming OffThread path
  
  The WorkflowRunActivity_IsStopped_Streaming_OffThread test demonstrates that
  the workflow.run OpenTelemetry Activity created in StreamingRunEventStream.RunLoopAsync
  is started but never stopped when using the OffThread/Default streaming execution.
  The background run loop keeps running after event consumption completes, so the
  using Activity? declaration never disposes until explicit StopAsync() is called.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  2. Fix workflow.run Activity never stopped in streaming OffThread execution (#4155)
  
  The workflow.run OpenTelemetry Activity in StreamingRunEventStream.RunLoopAsync
  was scoped to the method lifetime via 'using'. Since the run loop only exits on
  cancellation, the Activity was never stopped/exported until explicit disposal.
  
  Fix: Remove 'using' and explicitly dispose the Activity when the workflow reaches
  Idle status (all supersteps complete). A safety-net disposal in the finally block
  handles cancellation and error paths.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add root-level workflow.session activity spanning run loop lifetime\n\nImplements two-level telemetry hierarchy per PR feedback from lokitoth:\n- workflow.session: spans the entire run loop / stream lifetime\n- workflow_invoke: per input-to-halt cycle, nested within the session\n\nThis ensures the session activity stays open across multiple turns,\nwhile individual run activities are created and disposed per cycle.\n\nAlso fixes linkedSource CancellationTokenSource disposal leak in\nStreamingRunEventStream (added using declaration)."
  
  * Address Copilot review: fix Activity/CTS disposal, rename activity, add error tag\n\n1. LockstepRunEventStream: Remove 'using' from Activity in async iterator\n   and manually dispose in finally block (fixes #4155 pattern). Also dispose\n   linkedSource CTS in finally to prevent leak.\n2. Tags.cs: Add ErrorMessage (\"error.message\") tag for runtime errors,\n   distinct from BuildErrorMessage (\"build.error.message\").\n3. ActivityNames: Rename WorkflowRun from \"workflow_invoke\" to \"workflow.run\"\n   for cross-language consistency.\n4. WorkflowTelemetryContext: Fix XML doc to say \"outer/parent span\" instead\n   of \"root-level span\".\n5. ObservabilityTests: Assert WorkflowSession absence when DisableWorkflowRun\n   is true.\n6. WorkflowRunActivityStopTests: Fix streaming test race by disposing\n   StreamingRun before asserting activities are stopped.\n7. StreamingRunEventStream/LockstepRunEventStream: Use Tags.ErrorMessage\n   instead of Tags.BuildErrorMessage for runtime error events."
  
  * Review fixes: revert workflow_invoke rename, use 'using' for linkedSource, move SessionStarted earlier\n\n- Revert ActivityNames.WorkflowRun back to \"workflow_invoke\" (OTEL semantic convention contract)\n- Use 'using' declaration for linkedSource CTS in LockstepRunEventStream (no timing sensitivity)\n- Move SessionStarted event before WaitForInputAsync in StreamingRunEventStream to match Lockstep behavior"
  
  * Improve naming and comments in WorkflowRunActivityStopTests"
  
  * Prevent session Activity.Current leak in lockstep mode, add nesting test
  
  Save and restore Activity.Current in LockstepRunEventStream.Start() so the
  session activity doesn't leak into caller code via AsyncLocal. Re-establish
  Activity.Current = sessionActivity before creating the run activity in
  TakeEventStreamAsync to preserve parent-child nesting.
  
  Add test verifying app activities after RunAsync are not parented under the
  session, and that the workflow_invoke activity nests under the session."
  
  * Fix stale XML doc: WorkflowRun -> WorkflowInvoke in ObservabilityTests
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)
  
  * Python: .NET Samples - Restructure and Improve Samples (Feature Branch) (#4091)
  
  * Moved by agent (#4094)
  
  * Fix readme links
  
  * .NET Samples - Create `04-hosting` learning path step (#4098)
  
  * Agent move
  
  * Agent reorderd
  
  * Remove A2A section from README 
  
  Removed A2A section from the Getting Started README.
  
  * Agent fixed links
  
  * Fix broken sample links in durable-agents README (#4101)
  
  * Initial plan
  
  * Fix broken internal links in documentation
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Revert template link changes; keep only durable-agents README fix
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * .NET Samples - Create `03-workflows` learning path step (#4102)
  
  * Fix solution project path
  
  * Python: Fix broken markdown links to repo resources (outside /docs) (#4105)
  
  * Initial plan
  
  * Fix broken markdown links to repo resources
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Update README to rename .NET Workflows Samples section
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * .NET Samples - Create `02-agents` learning path step (#4107)
  
  * .NET: Fix broken relative link in GroupChatToolApproval README (#4108)
  
  * Initial plan
  
  * Fix broken link in GroupChatToolApproval README
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Update labeler configuration for workflow samples
  
  * .NET - Reorder Agents samples to start from Step01 instead of Step04 (#4110)
  
  * Fix solution
  
  * Resolve new sample paths
  
  * Move new AgentSkills and AgentWithMemory_Step04 samples
  
  * Fix link
  
  * Fix readme path
  
  * fix: update stale dotnet/samples/Durable path reference in AGENTS.md
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Moved new sample
  
  * Update solution
  
  * Resolve merge (new sample)
  
  * Sync to new sample - FoundryAgents_Step21_BingCustomSearch
  
  * Updated README
  
  * .NET Samples - Configuration Naming Update (#4149)
  
  * .NET: Restore AzureFunctions index parity with ConsoleApps under DurableAgents samples (#4221)
  
  * Clean-up `05_host_your_agent`
  
  * Config setting consistency
  
  * Refine samples
  
  * AGENTS.md
  
  * Move new samples
  
  * Re-order samples
  
  * Move new project and fixup solution
  
  * Fixup model config
  
  * Fix up new UT project
  
  ---------
  
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  
  * Python: Fix Bedrock embedding test stub missing meta attribute (#4287)
  
  * Fix Bedrock embedding test stub missing meta attribute
  
  * Increase test coverage so gate passes
  
  * Python: (ag-ui): fix approval payloads being re-processed on subsequent conversation turns (#4232)
  
  * Fix ag-ui tool call issue
  
  * Safe json fix
  
  * Python: Update workflow orchestration samples to use AzureOpenAIResponsesClient (#4285)
  
  * Update workflow orchestration samples to use AzureOpenAIResponsesClient
  
  * Fix broken link
  
  * Move scripts to scripts folder
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Rishabh Chawla <rishabhchawla1995@gmail.com>
  Co-authored-by: Peter Ibekwe <109177538+peibekwe@users.noreply.github.com>
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>
  
  * Fix encoding (#4309)
  
  * Disable Parallelization for WorkflowRunActivityStopTests (#4313)
  
  * Revert parallel disable (#4324)
  
  * .NET: Disable flakey Workflow Observability tests (#4416)
  
  * Disable flakey OffThread test
  
  * Disable additional OffThread test
  
  * Disable a further test
  
  * Disable all observability tests
  
  ---------
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
  Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Rishabh Chawla <rishabhchawla1995@gmail.com>
  Co-authored-by: Peter Ibekwe <109177538+peibekwe@users.noreply.github.com>
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

  westey · 2026-03-05 14:14:33 +00:00
  3fb90a501a
• .NET: Add foundry extension samples for python and dotnet (#4359)

  * Add foundry extension samples for python and dotnet
  
  * Align foundry extension samples with existing hosted agent patterns
  
  - Fix Python multiagent indentation bug (from_agent_framework ran in both modes)
  - Remove hardcoded personal endpoint from appsettings.Development.json
  - Rename .NET folders/projects to PascalCase (FoundryMultiAgent, FoundrySingleAgent)
  - Upgrade .NET multiagent from net9.0 to net10.0
  - Add ManagePackageVersionsCentrally=false and analyzer blocks to .csproj files
  - Replace wildcard package versions with fixed versions
  - Use alpine Docker images and standard build pattern
  - Align agent.yaml structure (template nesting, displayName, resources, authors)
  - Convert .NET multiagent from namespace/class to top-level statements
  - Add run-requests.http for multiagent sample
  - Fix Python requirements.txt (remove dev deps, add agent-framework)
  - Add proper copyright headers
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Align foundry samples: fix builds, upgrade AgentServer to beta.8
  
  - Fix TargetFrameworks (plural) to override inherited net472 from Directory.Build.props
  - Upgrade Azure.AI.AgentServer.AgentFramework to 1.0.0-beta.8 (latest)
  - Bump OpenTelemetry packages to 1.12.0 (required by beta.8)
  - Fix Roslynator/format errors (imports ordering, BOM, sealed record, target-typed new)
  - Verified with docker dotnet format (matching CI pipeline)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Refactor hosted samples to use AIProjectClient.CreateAIAgentAsync
  
  Replace PersistentAgentsClient and manual AzureOpenAIClient setup with
  AIProjectClient.CreateAIAgentAsync() from Microsoft.Agents.AI.AzureAI.
  
  - FoundryMultiAgent: Remove Azure.AI.Agents.Persistent, use CreateAIAgentAsync
    for Writer and Reviewer agents with cleanup in finally block
  - FoundrySingleAgent: Remove manual GetConnection/AzureOpenAIClient chain,
    use CreateAIAgentAsync with hotel search tool
  - Update csproj: add Microsoft.Agents.AI.AzureAI, remove unused packages
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update READMEs to reflect AIProjectClient.CreateAIAgentAsync usage
  
  - Reference Microsoft.Agents.AI.AzureAI and Microsoft.Agents.AI.Workflows packages
  - Add Azure AI Developer role requirement for agents/write data action
  - Replace PersistentAgentsClient references
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add HostedAgents READMEs and Foundry samples to solution
  
  - Create dotnet/samples/05-end-to-end/HostedAgents/README.md with sample index
  - Create python/samples/05-end-to-end/hosted_agents/README.md with sample index
  - Add FoundryMultiAgent and FoundrySingleAgent to agent-framework-dotnet.slnx
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix Python linting: reorder imports before load_dotenv, remove trailing whitespace
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Update uv.lock to match latest package versions
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix trailing whitespace in foundry_single_agent agent.yaml
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Exclude dotnet.microsoft.com from link checker
  
  This domain intermittently times out in CI, causing flaky markdown
  link check failures unrelated to PR changes.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Align env vars to AZURE_AI_PROJECT_ENDPOINT and default model to gpt-4o-mini
  
  Addresses PR review feedback:
  - Rename PROJECT_ENDPOINT to AZURE_AI_PROJECT_ENDPOINT across all
    Foundry samples (dotnet + python) to match existing samples
  - Change default model from gpt-4.1-mini to gpt-4o-mini consistently
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Skip flaky test CreatesWorkflowEndToEndActivities_WithCorrectName_DefaultAsync
  
  Tracked in #4398
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove Python foundry samples from PR scope
  
  Python hosted agent samples need further alignment with the azure-ai
  package conventions. Removing from this PR to ship .NET samples first.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Narrow linkspector exclusion to dotnet.microsoft.com/download only
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Leo Yao <leoyao@Leos-MacBook-Pro.local>
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Leo Yao · 2026-03-05 11:43:24 +00:00
  56bba795cb
• .NET: Increase credential timeout for Integration Tests (#4472)

  * Increase credential timeout for Integration Tests
  
  * Fix format error.
  
  * Update further tests
  
  * Fix comment
  
  * Rename credentials file and class.
  
  * Fix broken reference.

  westey · 2026-03-05 10:32:45 +00:00
  6dc65dbaa1
• .NET: AuthN & AuthZ sample with asp.net service and web client (#4354)

  * Add sample demonstrating authentication and user access in agent tools
  
  * Add fixes to enable running on windows
  
  * Add launchsettings, add docker-compose to slnx and fix formatting
  
  * Switch to Expenses rather than todo based sample and address PR comments
  
  * Rename sample
  
  * Fix formatting

  westey · 2026-03-02 18:41:14 +00:00
  f6b0610a6c
• Revert ".NET: Support hosted code interpreter for skill script execution (#4192)" (#4385)

  This reverts commit c9cd067be6.

  SergeyMenshykh · 2026-03-02 12:50:44 +00:00
  26cef555ce
• .NET: AgentThread serialization alternatives ADR (#3062)

  * AgentThread serialization alternatives ADR
  
  * Update decision drivers.
  
  * Address some Copilot PR comments.
  
  * Fix typo.
  
  * Add ChatClientAgentThread to sample code
  
  * Address comments, rename ADR and update SLNX.

  westey · 2026-02-26 14:19:42 +00:00
  b295a16c0e
• .NET: Support hosted code interpreter for skill script execution (#4192)

  * support script execution by code interpretor
  
  * improve the instruction prompt
  
  * Add DefaultAzureCredential production warning to AgentSkills samples
  
  Add the standard three-line WARNING comment about DefaultAzureCredential
  production considerations to both AgentSkills sample Program.cs files,
  matching the convention used in all other GettingStarted/Agents samples.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * address pr review comments
  
  * address feedback
  
  * rename Skill* types to FileAgentSkill* prefix for consistency
  
  - Rename SkillFrontmatter -> FileAgentSkillFrontmatter
  - Rename SkillScriptExecutor -> FileAgentSkillScriptExecutor
  - Add FileAgentSkillScriptExecutionContext and FileAgentSkillScriptExecutionDetails
  - Update sample, provider, loader, and tests accordingly
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * reorder usings
  
  * use set for props initialization instead of init
  
  * rename HostedCodeInterpreterSkillScriptExecutor
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2026-02-26 13:17:21 +00:00
  c9cd067be6
• Python / .NET Samples - Restructure and Improve Samples (Feature Branc… (#4092)

  * Python: .NET Samples - Restructure and Improve Samples (Feature Branch) (#4091)
  
  * Moved by agent (#4094)
  
  * Fix readme links
  
  * .NET Samples - Create `04-hosting` learning path step (#4098)
  
  * Agent move
  
  * Agent reorderd
  
  * Remove A2A section from README 
  
  Removed A2A section from the Getting Started README.
  
  * Agent fixed links
  
  * Fix broken sample links in durable-agents README (#4101)
  
  * Initial plan
  
  * Fix broken internal links in documentation
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Revert template link changes; keep only durable-agents README fix
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * .NET Samples - Create `03-workflows` learning path step (#4102)
  
  * Fix solution project path
  
  * Python: Fix broken markdown links to repo resources (outside /docs) (#4105)
  
  * Initial plan
  
  * Fix broken markdown links to repo resources
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Update README to rename .NET Workflows Samples section
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * .NET Samples - Create `02-agents` learning path step (#4107)
  
  * .NET: Fix broken relative link in GroupChatToolApproval README (#4108)
  
  * Initial plan
  
  * Fix broken link in GroupChatToolApproval README
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Update labeler configuration for workflow samples
  
  * .NET - Reorder Agents samples to start from Step01 instead of Step04 (#4110)
  
  * Fix solution
  
  * Resolve new sample paths
  
  * Move new AgentSkills and AgentWithMemory_Step04 samples
  
  * Fix link
  
  * Fix readme path
  
  * fix: update stale dotnet/samples/Durable path reference in AGENTS.md
  
  Co-authored-by: crickman <66376200+crickman@users.noreply.github.com>
  
  * Moved new sample
  
  * Update solution
  
  * Resolve merge (new sample)
  
  * Sync to new sample - FoundryAgents_Step21_BingCustomSearch
  
  * Updated README
  
  * .NET Samples - Configuration Naming Update (#4149)
  
  * .NET: Restore AzureFunctions index parity with ConsoleApps under DurableAgents samples (#4221)
  
  * Clean-up `05_host_your_agent`
  
  * Config setting consistency
  
  * Refine samples
  
  * AGENTS.md
  
  * Move new samples
  
  * Re-order samples
  
  * Move new project and fixup solution
  
  * Fixup model config
  
  * Fix up new UT project
  
  ---------
  
  Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>

  Chris · 2026-02-26 00:56:10 +00:00
  904a5b843e
• .NET: Support InvokeMcpTool for declarative workflows (#4204)

  * Initial implementation of InvokeMcpTool in declarative workflow
  
  * Cleaned up sample implementation
  
  * Updated sample comments.
  
  * Added missing executor routing attribute
  
  * Fix PR comments.
  
  * Updated based on PR comments.
  
  * Updated based on PR comments.
  
  * Removed unnecessary using statement.

  Peter Ibekwe · 2026-02-25 19:21:36 +00:00
  de9d886aba
• .NET: Add Microsoft Fabric sample #3674 (#4230)

  Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

  Roger Barreto · 2026-02-25 17:34:13 +00:00
  e3a5b915a6
• .NET: Add SharePoint sample #3674 (#4227)
  Roger Barreto · 2026-02-25 16:40:18 +00:00
  91675bde4f
• .NET: Add Foundry Agents Tool Sample - Bing Custom Search (#3701)

  * .NET: Add Bing Custom Search sample #3674
  
  * Apply format fixes
  
  * .NET: Improve Bing Custom Search sample with dual MEAI/Native SDK options
  
  - Add MEAI (Option 1) and Native SDK (Option 2) agent creation patterns
  - Add DefaultAzureCredential with standard WARNING comment
  - Add sample to solution file and FoundryAgents README index
  - Improve README with connection ID/instance name guidance
  - Fix missing newline at EOF in .csproj
  - Suppress CS8321 for unused local function pattern
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review comments for Bing Custom Search sample
  
  - Add Async suffix to CreateAgentWithMEAI and CreateAgentWithNativeSDK methods
  - Clarify comment to reference ResponseTool instead of BingCustomSearchTool
  - Update README Option 1 description to accurately reflect SDK usage
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-02-24 14:57:16 +00:00
  9a7d93909d
• .NET: Add Foundry Agents Tool Sample - Web Search (#4040)

  * .NET: Add Web Search sample #3674
  
  * .NET: Fix WebSearch sample to use Responses API built-in web search
  
  Remove incorrect Bing Grounding connection ID requirement from the
  WebSearch sample. The web search tool uses the OpenAI Responses API
  built-in capability and does not need a connection ID.
  
  - Remove AZURE_FOUNDRY_BING_CONNECTION_ID env var requirement
  - Use HostedWebSearchTool() without connectionId properties
  - Refactor creation options into local functions (MEAI + NativeSDK)
  - Switch from AzureCliCredential to DefaultAzureCredential
  - Update README to reflect correct prerequisites
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix README to align DefaultAzureCredential docs with code
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address review: add project to solution, README, simplify response text
  
  - Add FoundryAgents_Step25_WebSearch to agent-framework-dotnet.slnx
  - Add web search sample entry to parent FoundryAgents README.md
  - Simplify text response extraction to use response.Text directly
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix merge conflict in slnx solution file
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-02-23 17:15:02 +00:00
  8b69c2ea12
• .NET: Add Foundry Agents Tool Sample - Memory Search (#3700)

  * .NET: Add Memory Search sample #3674
  
  * Apply format fixes
  
  * Add MemorySearch sample to solution, FoundryAgents and AgentWithMemory READMEs
  
  - Add FoundryAgents_Step26_MemorySearch.csproj to agent-framework-dotnet.slnx
  - Add Memory Search entry to FoundryAgents/README.md samples table
  - Add cross-reference from AgentWithMemory/README.md to MemorySearch sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-02-23 14:54:05 +00:00
  6e4562e354
• .NET: Support Agent Skills (#4122)

  * support agent skills
  
  * make the new agent skill provider experimental
  
  * Fix file encoding: add UTF-8 BOM to .cs files
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix final newline and simplify new expressions
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix broken links in Agent Skills sample README
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add null check for skillPaths parameter
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Normalize references
  
  * normilize skill path
  
  * address comments regarding symlink check
  
  * address comments
  
  * fix failing test + regex improvements
  
  * small optimizations and improvments
  
  * address pr review comments
  
  * Update dotnet/src/Microsoft.Agents.AI/Skills/FileAgentSkillsProvider.cs
  
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
  
  * address pr review comments
  
  * address pr review comments
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

  SergeyMenshykh · 2026-02-20 21:05:56 +00:00
  7ba636d642
• .NET: Add Foundry Memory Context Provider (#3522)

  * Add Azure AI Foundry Memory Context Provider with unit tests
  
  * Add FoundryMemory integration tests and sample application
  
  * Fix ClearStoredMemoriesAsync to handle 404 gracefully and rename to EnsureStoredMemoriesDeletedAsync
  
  * Refactor FoundryMemory: simplify architecture and add memory store creation
  
  - Remove IFoundryMemoryOperations interface (was only for test mocking)
  - Remove AIProjectClientMemoryOperations wrapper class
  - Provider now directly uses AIProjectClient with internal extension methods
  - Extension methods return actual response models instead of extracted values
  - Remove WaitForUpdateCompletionAsync from provider (sample uses delay)
  - Simplify EnsureMemoryStoreCreatedAsync to return Task instead of Task<bool>
  - Add memory store creation with chat_model and embedding_model
  - Add UpdateMemoriesResponse with SupersededBy and Error fields
  - Simplify unit tests to focus on constructor validation and serialization
  - Update sample to use simple delay for memory processing wait
  
  * Add waiting operation for memory store updates
  
  * Fix UTF-8 BOM encoding for FoundryMemory csproj files
  
  * Update copilot instructions for UTF-8 BOM and fix sample API rename
  
  * Fix UTF-8 BOM encoding for TestableAIProjectClient.cs
  
  * Add missing response headers for TS
  
  * Changing default embedding
  
  * Using the SDK Models
  
  * Program update
  
  * Remove debugging code from sample
  
  * Adapt FoundryMemoryProvider to new AIContextProvider API and add UTF-8 BOM instruction
  
  - Override ProvideAIContextAsync/StoreAIContextAsync instead of removed virtual InvokingAsync/InvokedAsync
  - Use ProviderSessionState<State> for session-scoped state management (matching Mem0Provider pattern)
  - Replace constructor-based scope with stateInitializer delegate
  - Remove Serialize method (no longer on base class)
  - Add SearchInputMessageFilter, StorageInputMessageFilter, StateKey to options
  - Update sample to use AIContextProviders list instead of AIContextProviderFactory
  - Update unit and integration tests for new API
  - Add UTF-8 BOM encoding and --tl:off instructions to dotnet/AGENTS.md
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Use DefaultAzureCredential in Foundry Memory sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review comments for FoundryMemoryProvider
  
  - Move memoryStoreName from options to required constructor parameter
  - Make FoundryMemoryProviderScope require non-null/whitespace scope in constructor
  - Make Scope property read-only (getter only)
  - Replace ConcurrentQueue with single last update ID to fix memory leak
  - Only clear pending update ID after successful completion
  - Add delete success logging
  - Mark FoundryMemoryProvider with [Experimental] attribute
  - Update unit tests for new API signatures
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Use Throw.IfNullOrWhitespace for scope and memoryStoreName validation
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-02-20 11:25:06 +00:00
  0e2fcb1c7f
• .NET: Add Foundry Agents Tool Sample - OpenAPI Tools (#3702)

  * .NET: Add OpenAPI Tools sample #3674
  
  * Apply format fixes
  
  * Add MEAI and Native SDK creation options for OpenAPI Tools sample
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review: DefaultAzureCredential and CS8321 in NoWarn
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add project to slnx
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Roger Barreto · 2026-02-19 15:49:04 +00:00
  a54afd5e6c