[jchable]

Problem

samples/acme-retail-agent does not build on dev:

error NU1605: Detected package downgrade: Microsoft.Agents.AI from 1.24.0 to 1.20.0.
  AcmeRetailAgent -> OKF4net.Agents -> Microsoft.Agents.AI (>= 1.24.0)
  AcmeRetailAgent -> Microsoft.Agents.AI (>= 1.20.0)

Cause

src/OKF4net.Agents was bumped to Microsoft.Agents.AI 1.24.0 (#190); the sample kept its own explicit pin at 1.20.0. Samples have their own solutions and are outside OKF4net.sln/CI, so nothing caught it.

Fix

Removed the redundant explicit Microsoft.Agents.AI PackageReference from the sample's csproj. The sample references OKF4net.Agents by ProjectReference, so the package (and the Microsoft.Agents.AI namespace used in Program.cs) flows transitively at the version the library requires, with no second pin to keep in sync. Microsoft.Extensions.AI.OpenAI stays (the sample uses OpenAI types directly). Added a ### Fixed entry under [Unreleased] (earlier sample fixes are listed there).

Built (dotnet build, 0 warnings, 0 errors)

• samples/acme-retail-agent: was failing, now OK
• samples/agents-quickstart: OK (unchanged)
• samples/attestation-containers-demo: OK (unchanged)
• samples/catalog-explorer: OK (unchanged)
• producers/OkfProducer.sln: OK (unchanged)
• OKF4net.sln: 0 warnings, 0 errors; dotnet format --verify-no-changes clean
• No sample has a test project; producer tests not run.

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

The existing project reference supplies the required dependency transitively, with no unresolved issues identified.

No open issues 🎉

What changed in this PR

Fixes the acme-retail-agent sample’s dependency downgrade error after the library update in #190.

Changes:

• Removes the stale Microsoft.Agents.AI pin so the sample inherits the library’s dependency transitively.
• Documents the fix under Unreleased.

File	Description
samples/​acme-retail-agent/​src/​AcmeRetailAgent/​AcmeRetailAgent.csproj	Removes the redundant package reference.
CHANGELOG.md	Records the sample build fix.

_{Review effort: Balanced}