.NET: Add Run overloads to expose ChatClientAgentRunOptions in IntelliSense

[Copilot]

Motivation and Context

ChatClientAgentRunOptions provides specialized configuration for ChatClientAgent.RunAsync but is not discoverable through IntelliSense. Users must read documentation to learn they can pass it to methods accepting AgentRunOptions.

Related: #521

Description

Added extension methods on ChatClientAgent that explicitly accept ChatClientAgentRunOptions for improved API discoverability.

Implementation:

• New ChatClientAgentExtensions class with 12 extension methods covering all RunAsync, RunStreamingAsync, and generic RunAsync<T> overloads
• Each extension method casts ChatClientAgentRunOptions to AgentRunOptions and delegates to existing base methods
• No behavior changes—existing runtime type checking in ChatClientAgent already handles these options

Before:

// ChatClientAgentRunOptions not visible in IntelliSensevaroptions=newChatClientAgentRunOptions(newChatOptions{Temperature=0.7f});awaitagent.RunAsync("message",thread,options);// options typed as AgentRunOptions

After:

// Dedicated overload shows ChatClientAgentRunOptions in IntelliSensevaroptions=newChatClientAgentRunOptions(newChatOptions{Temperature=0.7f});awaitagent.RunAsync("message",thread,options);// options typed as ChatClientAgentRunOptions

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the Contribution Guidelines
• All unit tests pass, and I have added new tests where possible
• Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>.NET: Improve ChatClientAgentRunOptions discoverability</issue_title>
<issue_description>Documentation states that ChatClientAgent.RunAsync is able to handle specialized options. These options are currently not discoverable by just using the APIs i.e. browsing through intellisense.

It would be nice to have at least an overload that would accept ChatClientAgentRunOptions so users can find out about them without relying on the docs.

Related: #521 (comment)
https://learn.microsoft.com/en-us/agent-framework/user-guide/agents/running-agents?pivots=programming-language-csharp#agent-run-options

cc Stephen Toub (@stephentoub)westey (@westey-m)Tao Chen (@TaoChenOSU)Roger Barreto (@rogerbarreto) </issue_description>

<agent_instructions>We should add an extension method class for ChatClientAgent that adds an overload for each RunAsync and RunStreamingAsync variation that takes a ChatClientAgentRunOptions instead of an AgentRunOptions parameter.
Check both ChatClientAgent and AIAgent for all the RunAsync and RunStreamingAsync variations.
The new extension methods should just call into the existing methods, since they all already check if the provided options are of type ChatClientAgentRunOptions (which inherits from AgentRunOptions).
</agent_instructions>

Comments on the Issue (you are Copilot in this section)

• Fixes.NET: Improve ChatClientAgentRunOptions discoverability #1739

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[Copilot]

Pull request overview

This PR adds extension methods to improve IntelliSense discoverability of ChatClientAgentRunOptions when using ChatClientAgent. Previously, developers had to rely on documentation to know that ChatClientAgentRunOptions could be passed to methods accepting AgentRunOptions.

Key changes:

• Added ChatClientAgentExtensions class with 12 extension methods accepting ChatClientAgentRunOptions instead of the base AgentRunOptions
• Each extension method casts the specialized options to the base type and delegates to existing methods
• Added comprehensive unit tests covering 8 of the 12 extension methods (RunAsync and RunStreamingAsync variants)

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
dotnet/src/Microsoft.Agents.AI/ChatClient/ChatClientAgentExtensions.cs	New extension methods class providing 12 overloads for RunAsync, RunStreamingAsync, and generic RunAsync that explicitly accept ChatClientAgentRunOptions
dotnet/tests/Microsoft.Agents.AI.UnitTests/ChatClient/ChatClientAgentExtensionsTests.cs	New test file with unit tests for the extension methods, covering RunAsync and RunStreamingAsync variants but missing tests for the 4 generic RunAsync methods