v2.0.3

Full Changelog: v2.0.2...v2.0.3

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @Jonathan-Hickey, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @DominicSchell, @adalon, @Eule02, @torutek, @mccaffers, @SeikaLogiciel, @wizardness, @latonz.

Thanks 💜

v2.0.2

What's Changed

✨ Implemented enhancements

• Allow retrieving native client options from chat client by @kzu in #239

Full Changelog: v2.0.1...v2.0.2

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @Jonathan-Hickey, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @DominicSchell, @adalon, @Eule02, @torutek, @mccaffers, @SeikaLogiciel, @wizardness.

Thanks 💜

v2.0.1

What's Changed

✨ Implemented enhancements

• Add messages range support for Chat by @kzu in #233
• Improve debug rendering of Chat messages by @kzu in #234

Full Changelog: v2.0.0...v2.0.1

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @Jonathan-Hickey, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @DominicSchell, @adalon, @Eule02, @torutek, @mccaffers, @SeikaLogiciel, @wizardness.

Thanks 💜

v2.0.0

v2 is a significant release with breaking changes across the entire library. The changes focus on
improved extensibility for chat client creation, namespace reorganization of provider-specific
types, and removal of components that are no longer needed.

Breaking Changes

ExtendedChatOptions removed

ExtendedChatOptions (and its ReasoningEffort/Verbosity properties) has been removed from
Devlooped.Extensions.AI. Provider-specific options now live in their own namespaces.

Before:

using Devlooped.Extensions.AI;

options.ReasoningEffort = ReasoningEffort.High;
options.Verbosity = Verbosity.Medium;

After (OpenAI-specific):

using Devlooped.Extensions.AI.OpenAI;

options.Verbosity = Verbosity.Medium;
// using built-in MS.E.AI API for reasoning effort:
options.Reasoning = new ReasoningOptions { Effort = ReasoningEffort.High };

Verbosity moved to Devlooped.Extensions.AI.OpenAI, ReasoningEffort removed

Both types have been moved out of the root namespace and into Devlooped.Extensions.AI.OpenAI.
ReasoningEffort has been removed entirely. Verbosity is now an OpenAI-specific concept
surfaced via OpenAIChatOptions.

The official MS.E.AI API now exposes Reasoning options out of the box at the ChatOptions level.

ChatExtensions no longer exposes ReasoningEffort/Verbosity extension properties

Only Verbosity is now an extension property on ChatOptions exposed by OpenAIExtensions in
Devlooped.Extensions.AI.OpenAI.

OpenAIChatClient, AzureOpenAIChatClient, and AzureInferenceChatClient removed

The three concrete chat client wrapper classes in Devlooped.Extensions.AI.OpenAI have been
removed from the public API surface. Client creation is now handled by the new factory/provider
model (see below).

WebSearchTool moved to Devlooped.Extensions.AI.OpenAI

WebSearchTool has moved from Devlooped.Extensions.AI to Devlooped.Extensions.AI.OpenAI
and its constructor parameter is now optional (string? country = null). The City, Region,
TimeZone, and a new AllowedDomains property are now first-class properties on the type
instead of extension properties. OpenAIWebSearchToolExtensions has been removed.

Before:

using Devlooped.Extensions.AI;
using Devlooped.Extensions.AI.OpenAI;

var tool = new WebSearchTool("US");
tool.City = "Seattle";
tool.Region = "WA";

After:

using Devlooped.Extensions.AI.OpenAI;

var tool = new WebSearchTool("US")
{
    City = "Seattle",
    Region = "WA",
    AllowedDomains = ["example.com"]
};

JsonConsoleOptions, JsonConsoleLoggingExtensions, and related types removed

JsonConsoleOptions and the UseJsonConsoleLogging extensions (both for ChatClientBuilder and
ClientPipelineOptions) have been removed from the library into their own separate package
(Devlooped.Extensions.AI.Console).

ConfigurableChatClient.Options property removed; constructor changed

The object? Options property has been removed from ConfigurableChatClient. The constructor
now accepts an explicit configure callback parameter rather than deriving configuration from
the Options property.

AddChatClients gains a useDefaultProviders parameter

The AddChatClients extension methods on IServiceCollection and IHostApplicationBuilder now
have an additional bool useDefaultProviders = true parameter. This is a source-compatible
addition but callers passing arguments by position should verify their call sites.

---

New Features

Factory/Provider model for chat client creation (IChatClientFactory, IChatClientProvider, ChatClientFactory)

v2 introduces a first-class extensibility model for how IChatClient instances are resolved
from configuration. The three key types are:

• IChatClientProvider — implement this to support a new AI provider. Exposes ProviderName,
  BaseUri, HostSuffix, and a Create(IConfigurationSection) method.
• IChatClientFactory — takes a collection of IChatClientProvider instances and resolves
  the right one for a given configuration section.
• ChatClientFactory — the default implementation. Override ResolveProvider or
  MatchesBaseUri to customise resolution logic. Use ChatClientFactory.CreateDefault() to
  get a factory pre-loaded with the built-in providers.

ChatClientFactoryExtensions — DI registration helpers

New extension methods on IServiceCollection and IHostApplicationBuilder for registering the
factory and providers:

// Register the factory (and built-in providers) in the DI container
builder.AddChatClientFactory();

// Register a custom provider by name (and optional base URI / host suffix)
services.AddChatClientProvider("myprovider", new Uri("https://api.myprovider.com"),
    section => new MyProviderChatClient(section["apiKey"]!, section["model"]!));

// Register a typed provider
services.AddChatClientProvider<MyTypedProvider>();

Chat static factory for ChatMessage

A new Chat class provides concise static factory methods for constructing ChatMessage objects:

using static Devlooped.Extensions.AI.Chat;

var messages = new[]
{
    System("You are a helpful assistant."),
    User("What is the weather in Seattle?"),
    Assistant("It is currently 58°F and cloudy."),
    Developer("Internal note: user is in PST."),
};

OpenAIChatOptions

A new OpenAIChatOptions class in Devlooped.Extensions.AI.OpenAI groups OpenAI-specific chat
options (currently Verbosity) in a single place, consistent with how options are structured
for other providers.

WebSearchTool.AllowedDomains

The moved WebSearchTool now exposes an AllowedDomains property (string[]?) for restricting
search results to specific domains.

What's Changed

✨ Implemented enhancements

• Update with latest reasoning features from GPT 5.2 by @kzu in #199
• Make it possible to construct the raw completion request from gRPC by @kzu in #201
• Add helper factory methods to Chat by @kzu in #204
• Refactor: introduce provider/factory model for chat clients by @kzu in #210
• Internalize IChatClient implementations and auto-configure RawRepresentationFactory by @Copilot in #214
• Refactor WebSearchTool and move to OpenAI namespace by @kzu in #215
• Refactor: update to new OpenAI SDK & provider model by @kzu in #228
• Add Developer factory to Chat by @kzu in #229

🔨 Other

• Run AI tests in CI too by @kzu in #198
• Remove unused upstream file by @kzu in #200
• Replace Extensions.Grok project with xAI nuget package by @Copilot in #212
• Remove Agents folder which is now in another repo by @kzu in #216
• Extract console logging into Devlooped.Extensions.AI.Console (JSON only) by @Copilot in #224

Full Changelog: v1.0.0...v2.0.0

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @Jonathan-Hickey, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @DominicSchell, @adalon, @Eule02, @torutek, @mccaffers, @SeikaLogiciel, @wizardness.

Thanks 💜

v1.0.0

What's Changed

✨ Implemented enhancements

• Add support for ReasoningEffort.None for latest GPT by @kzu in #192

🔨 Other

• Decouple from the agent framework (AF) by @kzu in #187
• Rename solution to match repo by @kzu in #193

Full Changelog: v0.9.1...v1.0.0

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @davidjenni, @Jonathan-Hickey, @akunzai, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @v-limo, @DominicSchell, @jwendl, @adalon, @Eule02, @torutek, @mccaffers, @christoh, @ADS-Fund.

Thanks 💜

v0.9.1

What's Changed

📝 Documentation updates

• Add proper readme to Grok package by @kzu in #178

Full Changelog: v0.9.0...v0.9.1

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @davidjenni, @Jonathan-Hickey, @akunzai, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @v-limo, @DominicSchell, @jwendl, @adalon, @Eule02, @torutek, @mccaffers, @christoh, @ADS-Fund.

Thanks 💜

v0.9.0

What's Changed

✨ Implemented enhancements

• Simplify X.AI provider name metadata to xai by @kzu in #107
• Add support for configuration-driven IChatClient registrations by @kzu in #108
• Restructure for upcoming Agents.AI extensions by @kzu in #111
• Add configurable support for Azure Inference and OpenAI by @kzu in #114
• Initial support for configurable AI agents by @kzu in #116
• Add service-driven AIContextProviderFactory for agents by @kzu in #117
• Add service-driven ChatMessageStoreFactory for agents by @kzu in #118
• Add support for setting reasoning effort and verbosity via config by @kzu in #119
• Allow setting Grok options via agent configuration too by @kzu in #121
• Add Grok search option to avoid citations by @kzu in #122
• Make sure we always have the AgentId in the ChatResponse by @kzu in #127
• Add automatic dedent of description and instructions by @kzu in #128
• Allow case-insensitive agents and clients resolution by @kzu in #129
• Expose configuration metadata from configurable agent/chat by @kzu in #130
• Add support for configurable and composable AI contexts by @kzu in #134
• Add support for configurable AI context and auto-wiring of tools by @kzu in #135
• Avoid writing nulls and default values to JSON logging by @kzu in #137
• Add support for instructions in markdown files with YAML front-matter by @kzu in #140
• Make markdown configuration compatible with VSC chat modes by @kzu in #142
• Allow extending agent with additional properties by @kzu in #144
• Remove requirement of matching .NET 10 SDK preview by @kzu in #145
• Allow aggregation of configured, static and dynamic contexts by @kzu in #146
• Avoid duplication of tool JSON settings with MEAI by @kzu in #147
• Add compatibility with MCP tools registrations by @kzu in #148
• Native Grok implementation package by @kzu in #174

🐛 Fixed bugs

• Make sure Grok client provides metadata for telemetry by @kzu in #105
• Make sure we provide compatible metadata for OpenAI by @kzu in #106
• Use the specified JSON options when adding tools by @kzu in #149

📝 Documentation updates

• Add docs and samples for both libraries by @kzu in #125
• Add comprehensive sample with both server and client by @kzu in #131
• Improve readme and sample server by @kzu in #138
• Document Grok agentic tools usage by @kzu in #177

🔨 Other

• Bump all dependencies to latest by @kzu in #104
• Fix and re-enable retrieval tests by @kzu in #176

Full Changelog: v0.8.3...v0.9.0

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @sandrock, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @davidjenni, @Jonathan-Hickey, @akunzai, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @v-limo, @DominicSchell, @jwendl, @adalon, @Eule02, @torutek, @mccaffers, @christoh, @ADS-Fund.

Thanks 💜

v0.9.0-rc.2

What's Changed

✨ Implemented enhancements

• Allow extending agent with additional properties by @kzu in #144
• Remove requirement of matching .NET 10 SDK preview by @kzu in #145
• Allow aggregation of configured, static and dynamic contexts by @kzu in #146
• Avoid duplication of tool JSON settings with MEAI by @kzu in #147
• Add compatibility with MCP tools registrations by @kzu in #148

🐛 Fixed bugs

• Use the specified JSON options when adding tools by @kzu in #149

Full Changelog: v0.9.0-rc.1...v0.9.0-rc.2

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @davidjenni, @Jonathan-Hickey, @akunzai, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @v-limo, @DominicSchell, @jwendl, @adalon, @Eule02, @henkmartijn, @torutek, @mccaffers.

Thanks 💜

v0.9.0-rc.1

What's Changed

✨ Implemented enhancements

• Avoid writing nulls and default values to JSON logging by @kzu in #137
• Add support for instructions in markdown files with YAML front-matter by @kzu in #140
• Make markdown configuration compatible with VSC chat modes by @kzu in #142

📝 Documentation updates

• Improve readme and sample server by @kzu in #138

Full Changelog: v0.9.0-rc...v0.9.0-rc.1

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @davidjenni, @Jonathan-Hickey, @akunzai, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @v-limo, @DominicSchell, @jwendl, @adalon, @Eule02, @henkmartijn, @torutek, @mccaffers.

Thanks 💜

v0.9.0-rc

What's Changed

✨ Implemented enhancements

• Make sure we always have the AgentId in the ChatResponse by @kzu in #127
• Add automatic dedent of description and instructions by @kzu in #128
• Allow case-insensitive agents and clients resolution by @kzu in #129
• Expose configuration metadata from configurable agent/chat by @kzu in #130
• Add support for configurable and composable AI contexts by @kzu in #134
• Add support for configurable AI context and auto-wiring of tools by @kzu in #135

📝 Documentation updates

• Add comprehensive sample with both server and client by @kzu in #131

Full Changelog: v0.9.0-beta...v0.9.0-rc

Sponsors

The following sponsors made this release possible: @clarius, @MFB-Technologies-Inc, @drivenet, @Keflon, @tbolon, @kfrancis, @unoplatform, @rbnswartz, @jfoshee, @Mrxx99, @eajhnsn1, @davidjenni, @Jonathan-Hickey, @akunzai, @KenBonny, @SimonCropp, @agileworks-eu, @arsdragonfly, @vezel-dev, @ChilliCream, @4OTC, @v-limo, @jordansjones, @DominicSchell, @jwendl, @adalon, @Eule02, @henkmartijn, @torutek, @mccaffers.

Thanks 💜