# Release notes

> Every stable MentorAgent version, newest first, with its date and what it brings; how versions are numbered and supported, and how dependencies are followed.

- URL: https://docs.mentoragent.net/release-notes
- Verified with: MentorAgent 1.2.0
- Last updated: 2026-11-08
- Packages: Novior.MentorAgent, Novior.MentorAgent.Abstractions, Novior.MentorAgent.Blazor, Novior.MentorAgent.Declarative, Novior.MentorAgent.Server

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](https://docs.mentoragent.net/reference/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.

| Version | Published (UTC) | Type | In short |
|---|---|---|---|
| [1.2.0](https://docs.mentoragent.net/release-notes/1-2-0) | 27 October 2026 | Minor | Only the actions the user may run reach the model, your own action policies, who confirmed each action, and a notice for AI-generated replies. |
| [1.1.0](https://docs.mentoragent.net/release-notes/1-1-0) | 21 October 2026 | Minor | Your own text in the confirmation box, rules per method, and a patched SignalR client. |
| [1.0.0](https://docs.mentoragent.net/release-notes/1-0-0) | 13 October 2026 | Major | The first stable version, published as `Novior.MentorAgent`. |

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](https://github.com/Novior-dev/MentorAgent/blob/main/CHANGELOG.md), which every package contains. The release notes of a version on NuGet are its section of that file.

## Versioning and support

The policy is in the "Versioning and support" section of the [MentorAgent README on NuGet](https://www.nuget.org/packages/Novior.MentorAgent#readme-body-tab), and in [SECURITY.md](https://github.com/Novior-dev/MentorAgent/blob/main/SECURITY.md).

- **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](https://docs.mentoragent.net/release-notes/1-2-0#breaking-changes), 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](https://docs.mentoragent.net/get-started/prerequisites#requirements), 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](https://docs.mentoragent.net/release-notes#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](mailto: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](https://github.com/Novior-dev/MentorAgent/discussions) on GitHub. Report bugs and feature requests as [issues](https://github.com/Novior-dev/MentorAgent/issues/new/choose). [Getting help](https://docs.mentoragent.net/get-started/troubleshooting#getting-help) has the details.

## Dependencies

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](https://docs.mentoragent.net/get-started/prerequisites#requirements):

| Dependency | Tested version | Release |
|---|---|---|
| `Microsoft.Agents.AI` and `Microsoft.Agents.AI.Workflows` | 1.26.0 | Stable |
| `Microsoft.Extensions.AI` | 10.11.0 | Stable |
| `ModelContextProtocol` and `ModelContextProtocol.AspNetCore` | 2.3.0 | Stable |
| `A2A` and `A2A.AspNetCore` | 1.0.0-preview3 | Prerelease |
| `Microsoft.Agents.AI.Declarative`, only for `Novior.MentorAgent.Declarative` | 1.26.0-rc1 | Prerelease |

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](https://docs.mentoragent.net/reference/known-issues). For example: [A2A preview3 with MentorAgent 1.1.0](https://docs.mentoragent.net/reference/known-issues#a2a-preview3-with-mentoragent-110).
- **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](https://docs.mentoragent.net/get-started/prerequisites#provider-package-versions).

## Preview and release candidate versions

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](https://github.com/Novior-dev/MentorAgent/blob/main/CHANGELOG.md). To move from one of them, read [Move to the Novior.MentorAgent packages](https://docs.mentoragent.net/release-notes/1-0-0#move-to-the-noviormentoragent-packages).

MentorAgent succeeds the [BlazorMentor](https://www.nuget.org/packages/BlazorMentor) package, published from 0.1.0-preview.1 to 0.5.0-preview. NuGet marks it as deprecated, with MentorAgent as its replacement.

---

- Previous: [TeamTerminationConditionAttribute class](https://docs.mentoragent.net/api/global/teamterminationconditionattribute.md)
- Next: [MentorAgent 1.2.0 release notes](https://docs.mentoragent.net/release-notes/1-2-0.md)