Release notes

Each stable version of MentorAgent has a page of its own. The page says what the version adds, changes and fixes, and why. It also gives the steps to upgrade to it, and the known issues that the version had at release. The defects that are still open in the current version are on the Known issues page. The five packages, Novior.MentorAgent, Novior.MentorAgent.Abstractions, Novior.MentorAgent.Blazor, Novior.MentorAgent.Declarative and Novior.MentorAgent.Server, are released together and share one version number.

A minor version adds features and fixes defects. A major version may break code built against the previous one. A patch version only fixes defects: when one ships, it gets a short page of its own in this list.

The pages tell the story of each version. The full list of changes is in CHANGELOG.md ↗ (external site), which every package contains. The release notes of a version on NuGet are its section of that file.

The policy is in the "Versioning and support" section of the MentorAgent README on NuGet ↗ (external site), and in SECURITY.md ↗ (external site).

• One version for the family. The five packages are released together, with one version number, and each one requires the others at exactly that version. Upgrade them together.
• Semantic Versioning 2.0.0, from 1.0.0. A breaking change to the public contract ships only in a new major version. Minor versions add features, and patch versions fix defects. A break that fixes a defect is listed under "Breaking changes" in the release notes of its version, as BUG-212 in 1.2.0, and marked Breaking in CHANGELOG.md.
• A check at pack time. Every package is checked against the public API of the previous published version. So a new version cannot break code built against it by accident.
• What the contract covers:
  • the public C# API of the five packages;
  • the hub methods, hub events, Server-Sent Events frames and HTTP endpoints documented in the Novior.MentorAgent.Server README;
  • the names of the tools that the library itself gives the model, such as route_to_specialist, navigate_to and load_skill;
  • the documented configuration keys.
• What it does not cover:
  • what the model says, or which tool it chooses on a given turn;
  • the wording of the prompts that the library builds;
  • log messages. The Novior.MentorAgent prefix of the log categories is stable, but the text after it is not.
• Dependencies. A minor version may move the Microsoft packages listed in Prerequisites, and ModelContextProtocol and A2A, to a newer compatible version, including packages with no stable release yet. How MentorAgent follows them, and the versions each release is tested with: see Dependencies. The packages of your model provider are not among them: you choose their versions.
• Support. MentorAgent supports .NET 10. The latest minor version gets every fix. When a new minor version is released, the previous one gets security fixes for 3 months more. When a new major version is released, the previous major version gets them for 6 months more, on its latest minor version. 1.1.x gets security fixes until 27 January 2027, and 1.0.x until 21 January 2027. Release candidates and previews get no fixes.
• Severity of a defect. Each defect has a stable identifier, BUG-nnn, from the maintainers' defect log, and a severity:
  • S1: data loss, a security hole or a crash;
  • S2: a documented feature that does not work, or documentation that leads to a broken result;
  • S3: wrong behavior in an edge case, or documentation that contradicts the code;
  • S4: cosmetic.
• Vulnerabilities. Report a vulnerability privately, by e-mail to security@mentoragent.net, and never in a public issue. The report is acknowledged within 5 working days, on a best-effort basis. A fix is announced as a GitHub Security Advisory and in the release notes of the version that fixes it.
• Questions, bugs and requests. Ask questions in Discussions ↗ (external site) on GitHub. Report bugs and feature requests as issues ↗ (external site). Getting help has the details.

MentorAgent is built on Microsoft Agent Framework, Microsoft.Extensions.AI and the MCP and A2A SDKs. 1.2.0 is tested with these versions, the same as in Requirements:

How MentorAgent follows them:

• Checked every day. These dependencies are checked every day for new versions.
• Taken in the next minor version. A new version of them comes with the next minor version of MentorAgent. No time is promised.
• Prereleases are allowed. A minor version may move them to a newer compatible line, including one with no stable release yet, as A2A and Microsoft.Agents.AI.Declarative are today.
• Newer versions in your application. Your application can take newer versions than the tested ones, and nothing is guaranteed for them. A newer version that breaks MentorAgent is fixed in the next version of MentorAgent. Until then it is listed under "Known issues" in CHANGELOG.md and on Known issues. For example: A2A preview3 with MentorAgent 1.1.0.
• The SDK of your model provider is yours. It is not a dependency of MentorAgent, and you choose its version: see the versions of the provider SDKs.

Before 1.0.0, MentorAgent was published as previews and release candidates, from 1.0.0-preview to 1.0.0-rc.15, under the MentorAgent.* package IDs. They get no fixes, and these pages do not describe them: their entries are in CHANGELOG.md ↗ (external site). To move from one of them, read Move to the Novior.MentorAgent packages.

MentorAgent succeeds the BlazorMentor ↗ (external site) package, published from 0.1.0-preview.1 to 0.5.0-preview. NuGet marks it as deprecated, with MentorAgent as its replacement.