chore: import upstream snapshot with attribution

dotnet/src/Microsoft.Agents.AI.Anthropic/AnthropicBetaServiceExtensions.cs

@@ -0,0 +1,103 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Logging;
+using Microsoft.Shared.Diagnostics;
+
+namespace Anthropic.Services;
+
+/// <summary>
+/// Provides extension methods for the <see cref="IBetaService"/> class.
+/// </summary>
+public static class AnthropicBetaServiceExtensions
+{
+    /// <summary>
+    /// Specifies the default maximum number of tokens allowed for processing operations.
+    /// </summary>
+    public static int DefaultMaxTokens { get; set; } = 4096;
+
+    /// <summary>
+    /// Creates a new AI agent using the specified model and options.
+    /// </summary>
+    /// <param name="betaService">The Anthropic beta service.</param>
+    /// <param name="model">The model to use for chat completions.</param>
+    /// <param name="instructions">The instructions for the AI agent.</param>
+    /// <param name="name">The name of the AI agent.</param>
+    /// <param name="description">The description of the AI agent.</param>
+    /// <param name="tools">The tools available to the AI agent.</param>
+    /// <param name="defaultMaxTokens">The default maximum tokens for chat completions. Defaults to <see cref="DefaultMaxTokens"/> if not provided.</param>
+    /// <param name="clientFactory">Provides a way to customize the creation of the underlying <see cref="IChatClient"/> used by the agent.</param>
+    /// <param name="loggerFactory">Optional logger factory for enabling logging within the agent.</param>
+    /// <param name="services">An optional <see cref="IServiceProvider"/> to use for resolving services required by the <see cref="AIFunction"/> instances being invoked.</param>
+    /// <returns>The created <see cref="ChatClientAgent"/> AI agent.</returns>
+    public static ChatClientAgent AsAIAgent(
+        this IBetaService betaService,
+        string model,
+        string? instructions = null,
+        string? name = null,
+        string? description = null,
+        IList<AITool>? tools = null,
+        int? defaultMaxTokens = null,
+        Func<IChatClient, IChatClient>? clientFactory = null,
+        ILoggerFactory? loggerFactory = null,
+        IServiceProvider? services = null)
+    {
+        var options = new ChatClientAgentOptions
+        {
+            Name = name,
+            Description = description,
+        };
+
+        if (!string.IsNullOrWhiteSpace(instructions))
+        {
+            options.ChatOptions ??= new();
+            options.ChatOptions.Instructions = instructions;
+        }
+
+        if (tools is { Count: > 0 })
+        {
+            options.ChatOptions ??= new();
+            options.ChatOptions.Tools = tools;
+        }
+
+        var chatClient = betaService.AsIChatClient(model, defaultMaxTokens ?? DefaultMaxTokens);
+
+        if (clientFactory is not null)
+        {
+            chatClient = clientFactory(chatClient);
+        }
+
+        return new ChatClientAgent(chatClient, options, loggerFactory, services);
+    }
+
+    /// <summary>
+    /// Creates an AI agent from an <see cref="IBetaService"/> using the Anthropic Chat Completion API.
+    /// </summary>
+    /// <param name="betaService">The Anthropic <see cref="IBetaService"/> to use for the agent.</param>
+    /// <param name="options">Full set of options to configure the agent.</param>
+    /// <param name="clientFactory">Provides a way to customize the creation of the underlying <see cref="IChatClient"/> used by the agent.</param>
+    /// <param name="loggerFactory">Optional logger factory for enabling logging within the agent.</param>
+    /// <param name="services">An optional <see cref="IServiceProvider"/> to use for resolving services required by the <see cref="AIFunction"/> instances being invoked.</param>
+    /// <returns>An <see cref="ChatClientAgent"/> instance backed by the Anthropic Chat Completion service.</returns>
+    /// <exception cref="ArgumentNullException">Thrown when <paramref name="betaService"/> or <paramref name="options"/> is <see langword="null"/>.</exception>
+    public static ChatClientAgent AsAIAgent(
+        this IBetaService betaService,
+        ChatClientAgentOptions options,
+        Func<IChatClient, IChatClient>? clientFactory = null,
+        ILoggerFactory? loggerFactory = null,
+        IServiceProvider? services = null)
+    {
+        Throw.IfNull(betaService);
+        Throw.IfNull(options);
+
+        var chatClient = betaService.AsIChatClient();
+
+        if (clientFactory is not null)
+        {
+            chatClient = clientFactory(chatClient);
+        }
+
+        return new ChatClientAgent(chatClient, options, loggerFactory, services);
+    }
+}

dotnet/src/Microsoft.Agents.AI.Anthropic/AnthropicClientExtensions.cs

@@ -0,0 +1,103 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.Agents.AI;
+using Microsoft.Extensions.AI;
+using Microsoft.Extensions.Logging;
+using Microsoft.Shared.Diagnostics;
+
+namespace Anthropic;
+
+/// <summary>
+/// Provides extension methods for the <see cref="IAnthropicClient"/> class.
+/// </summary>
+public static class AnthropicClientExtensions
+{
+    /// <summary>
+    /// Specifies the default maximum number of tokens allowed for processing operations.
+    /// </summary>
+    public static int DefaultMaxTokens { get; set; } = 4096;
+
+    /// <summary>
+    /// Creates a new AI agent using the specified model and options.
+    /// </summary>
+    /// <param name="client">An Anthropic <see cref="IAnthropicClient"/> to use with the agent..</param>
+    /// <param name="model">The model to use for chat completions.</param>
+    /// <param name="instructions">The instructions for the AI agent.</param>
+    /// <param name="name">The name of the AI agent.</param>
+    /// <param name="description">The description of the AI agent.</param>
+    /// <param name="tools">The tools available to the AI agent.</param>
+    /// <param name="defaultMaxTokens">The default maximum tokens for chat completions. Defaults to <see cref="DefaultMaxTokens"/> if not provided.</param>
+    /// <param name="clientFactory">Provides a way to customize the creation of the underlying <see cref="IChatClient"/> used by the agent.</param>
+    /// <param name="loggerFactory">Optional logger factory for enabling logging within the agent.</param>
+    /// <param name="services">An optional <see cref="IServiceProvider"/> to use for resolving services required by the <see cref="AIFunction"/> instances being invoked.</param>
+    /// <returns>The created <see cref="ChatClientAgent"/> AI agent.</returns>
+    public static ChatClientAgent AsAIAgent(
+        this IAnthropicClient client,
+        string model,
+        string? instructions = null,
+        string? name = null,
+        string? description = null,
+        IList<AITool>? tools = null,
+        int? defaultMaxTokens = null,
+        Func<IChatClient, IChatClient>? clientFactory = null,
+        ILoggerFactory? loggerFactory = null,
+        IServiceProvider? services = null)
+    {
+        var options = new ChatClientAgentOptions
+        {
+            Name = name,
+            Description = description,
+        };
+
+        if (!string.IsNullOrWhiteSpace(instructions))
+        {
+            options.ChatOptions ??= new();
+            options.ChatOptions.Instructions = instructions;
+        }
+
+        if (tools is { Count: > 0 })
+        {
+            options.ChatOptions ??= new();
+            options.ChatOptions.Tools = tools;
+        }
+
+        var chatClient = client.AsIChatClient(model, defaultMaxTokens ?? DefaultMaxTokens);
+
+        if (clientFactory is not null)
+        {
+            chatClient = clientFactory(chatClient);
+        }
+
+        return new ChatClientAgent(chatClient, options, loggerFactory, services);
+    }
+
+    /// <summary>
+    /// Creates an AI agent from an <see cref="IAnthropicClient"/> using the Anthropic Chat Completion API.
+    /// </summary>
+    /// <param name="client">An Anthropic <see cref="IAnthropicClient"/> to use with the agent..</param>
+    /// <param name="options">Full set of options to configure the agent.</param>
+    /// <param name="clientFactory">Provides a way to customize the creation of the underlying <see cref="IChatClient"/> used by the agent.</param>
+    /// <param name="loggerFactory">Optional logger factory for enabling logging within the agent.</param>
+    /// <param name="services">An optional <see cref="IServiceProvider"/> to use for resolving services required by the <see cref="AIFunction"/> instances being invoked.</param>
+    /// <returns>An <see cref="ChatClientAgent"/> instance backed by the Anthropic Chat Completion service.</returns>
+    /// <exception cref="ArgumentNullException">Thrown when <paramref name="client"/> or <paramref name="options"/> is <see langword="null"/>.</exception>
+    public static ChatClientAgent AsAIAgent(
+        this IAnthropicClient client,
+        ChatClientAgentOptions options,
+        Func<IChatClient, IChatClient>? clientFactory = null,
+        ILoggerFactory? loggerFactory = null,
+        IServiceProvider? services = null)
+    {
+        Throw.IfNull(client);
+        Throw.IfNull(options);
+
+        var chatClient = client.AsIChatClient();
+
+        if (clientFactory is not null)
+        {
+            chatClient = clientFactory(chatClient);
+        }
+
+        return new ChatClientAgent(chatClient, options, loggerFactory, services);
+    }
+}

dotnet/src/Microsoft.Agents.AI.Anthropic/AnthropicClientJsonContext.cs

@@ -0,0 +1,13 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+#pragma warning disable CA1812
+
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Microsoft.Agents.AI.Anthropic;
+
+[JsonSerializable(typeof(JsonElement))]
+[JsonSerializable(typeof(string))]
+[JsonSerializable(typeof(Dictionary<string, object?>))]
+internal sealed partial class AnthropicClientJsonContext : JsonSerializerContext;

dotnet/src/Microsoft.Agents.AI.Anthropic/Microsoft.Agents.AI.Anthropic.csproj

@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <IsReleaseCandidate>false</IsReleaseCandidate>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <InjectSharedThrow>true</InjectSharedThrow>
+  </PropertyGroup>
+
+  <Import Project="$(RepoRoot)/dotnet/nuget/nuget-package.props" />
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.AI" />
+    <PackageReference Include="Anthropic" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Microsoft.Agents.AI\Microsoft.Agents.AI.csproj" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <!-- NuGet Package Settings -->
+    <Title>Microsoft Agent Framework Anthropic Agents</Title>
+    <Description>Provides Microsoft Agent Framework support for Anthropic Agents.</Description>
+  </PropertyGroup>
+
+</Project>