SergeyMenshykh

This commit introduces a **new capability** to enhance the **security and control** of **OpenAPI plugins** by allowing validation of server URLs. It adds `RestApiOperationServerUrlValidationOptions` to `OpenApiFunctionExecutionParameters`, enabling developers to specify **allowed schemes and base URLs** for outbound requests made by the `RestApiOperationRunner`. This **opt-in mechanism** prevents OpenAPI plugins from calling arbitrary or unauthorized endpoints, ensuring that all runtime HTTP requests adhere to predefined security policies. The validation logic is integrated into `RestApiOperationRunner` and executed before any HTTP request is sent, providing a critical layer of protection.

This commit delivers a **bug fix** for the **.NET Handoff Orchestration** to ensure proper argument type retention. It resolves an issue where **MCP functions** called via Semantic Kernel would receive incorrectly formatted arguments, leading to type mismatches, especially for complex types like `List<string>`. The core change configures the `HandoffActor` within the **Handoff Orchestration** to **retain argument types** during the function choice behavior. This **enhances the reliability of function execution** in orchestrated scenarios by ensuring arguments are correctly interpreted and passed between different server environments.

This commit introduces **new overloads** for the `GetResponseAsync` and `GetResponseStreamingAsync` methods within the **`OpenAIResponseClient`**. These enhancements allow callers to pass a `RequestOptions` object, providing **more granular control** over the underlying OpenAI API requests. This **new feature** significantly improves the flexibility and configurability of API interactions within the `src/Custom/Responses` module. Developers can now specify custom headers, timeouts, and other request-specific settings when making OpenAI API calls.

This commit **updates the A2A library to version 0.3.1-preview**, primarily focusing on **protocol changes** within the **A2A communication subsystem**. It **refactors** the `A2AAgent` to utilize `AgentMessage` for internal message handling and updates the A2A server sample to expose a new `agent-card.json` endpoint, replacing the previous `agent.json` path. Furthermore, message payloads now consistently include a `kind` field, a change reflected across the sample application and unit tests. This ensures the A2A components are aligned with the latest library specifications, impacting how agents communicate and expose their capabilities.

This commit introduces a **new feature** to the **`.Net Functions.OpenApi` module**, enhancing the `OpenApiKernelPluginFactory` to embed parameter descriptions directly into their respective OpenAPI schemas. The `GetSchema` method now enriches parameter definitions with their descriptions, which is then integrated into the plugin creation process via `CreateFromOpenApiAsync`. This improvement aims to **provide more comprehensive and detailed information to AI models** consuming these OpenAPI specifications, facilitating better understanding and interaction with the exposed functions. Unit tests and updated OpenAPI test documents for versions 2.0, 3.0, and 3.1 validate the correct integration and functionality of this new capability.

.Net: Net: Version 1.62.0 (#12927)

This commit **enhances documentation quality** by refining the project's link checking process. It **updates the link checker configuration** (`.github/.linkspector.yml`) to exclude directories with persistent unreachable links and re-include files where previously broken links are now resolved. Specifically, this **maintenance** effort **corrects a broken link** to VSCode workspace documentation within the `python/DEV_SETUP.md` guide. This ensures more accurate link reporting and improves the reliability of development setup instructions for **Python contributors**.

This commit **updates the .NET A2A agent to align with the latest A2A .NET SDK**, primarily involving **refactoring** to adapt to API changes and ensure compatibility. It affects the **A2A agent core implementation** (`dotnet/src/Agents/A2A/`), **demo applications**, and **getting started samples**, along with their respective **unit tests**. Key changes include updating `A2AClient` and `A2ACardResolver` instantiations to pass the agent URI directly, and introducing `CancellationToken` to methods like `SendMessageAsync` and `ExecuteAgentTaskAsync`. Furthermore, `ExecuteAgentTaskAsync` and `GetAgentCard` are now asynchronous, and namespace imports are updated from `SharpA2A.Core` to `A2A`. This **maintenance** work ensures the A2A integration remains functional and leverages the most current SDK capabilities.

This commit **prepares** the codebase for a future update to the A2A .NET SDK and the official `System.Linq.AsyncEnumerable` NuGet package. It achieves this by **refactoring** numerous asynchronous enumerable operations across **Agents**, **InternalUtilities**, **Plugins**, and **VectorData** modules, specifically by removing all dependencies on the `System.Linq.Async` package. This **eliminates potential "ambiguous call" naming conflicts** that would arise from transitive dependencies and establishes a foundation for seamless adoption of the new `AsyncEnumerable` APIs. As a result, production code now relies on polyfills or in-place implementations for asynchronous enumeration, while test and sample code utilizes preview versions of `System.Linq.AsyncEnumerable`.

This commit introduces a **new capability** to the **.NET OpenAPI plugin system**, specifically enhancing the `OpenApiTypeConverter`. It **extends the supported input types for argument mapping** to include `JsonElement`, allowing for more flexible data handling. The `OpenApiTypeConverter.Convert` method can now correctly process `JsonElement` inputs when converting to array, integer, boolean, and number types. This **improves the robustness and adaptability of OpenAPI plugins** by enabling them to consume a wider range of JSON-based data structures, thereby **broadening the compatibility and usability of OpenAPI plugins** within the Semantic Kernel.

This commit **disables several Azure AI Agent integration tests** within the `.Net` project by commenting out their class definitions. Specifically, the `AzureAIAgentWithAIContextProviderTests`, `AzureAIAgentWithTextSearchProviderTests`, `AzureAIAgentInvokeTests`, and `AzureAIAgentInvokeStreamingTests` are affected. This **maintenance** change temporarily removes these conformance tests from the test suite, likely to address instability or failures. The scope is limited to preventing these specific **integration tests** from executing, impacting the overall test coverage for the `Agents` module by reducing the number of active tests.

This commit **updates the `mcp` package** to its latest available version within the **.Net project**. This is a **dependency update** aimed at incorporating the most recent improvements, bug fixes, and features provided by the `mcp` library. It ensures the **.Net application** remains current with its external dependencies, potentially improving overall stability, performance, or security by leveraging the latest upstream changes. The update affects all components and functionalities that rely on the `mcp` package, ensuring they benefit from the updated capabilities.

This commit performs **maintenance cleanup** by **removing obsolete jobs** from the **Dependabot configuration** specifically for the **.Net ecosystem**. This action streamlines the automated dependency update process, ensuring that only relevant and active checks are performed. The change improves the efficiency of dependency management workflows by eliminating unnecessary overhead without impacting application functionality or core logic.

This commit initiates a **cleanup of .Net project dependencies**, specifically targeting the removal of unnecessary or outdated packages. This **maintenance task** streamlines the project's build configuration, likely impacting `csproj` files and `NuGet` references. The effort aims to improve overall project health by potentially **reducing build times and deployment sizes**, enhancing maintainability and efficiency.

.Net: Update SK packages (#12600)

This commit **optimizes the Dependabot scheduling** within the project's automation configuration. It **updates the frequency for NuGet package dependency checks** from weekly to twice a week (Thursday and Sunday) and **reschedules GitHub Actions dependency checks** to Tuesday. This **maintenance chore** aims to **improve Dependabot reliability** by leveraging less busy infrastructure times, thereby reducing the number of dependencies processed at once and mitigating potential timeout issues. The changes in `.github/dependabot.yml` are expected to result in more consistent and efficient dependency updates across the project.

This commit **updates the Aspire.* NuGet packages** across the project, incorporating the latest features and improvements from the **.NET Aspire framework**. As part of this **maintenance** and **dependency update**, the **Azure OpenAI deployment configuration** within the `AgentFrameworkWithAspire` sample has been **refactored**. Specifically, the `AddAIServices` method in `Program.cs` now leverages the `WithProperties` fluent API for setting SKU details, ensuring compatibility and adopting the updated, more idiomatic API for resource configuration within the **Aspire ecosystem**.

.Net: Update OpenApi packages (#12599)

This commit **updates the .NET samples for the ModelContextProtocolClientServer** to reference the **latest Model Context Protocol (MCP) NuGet package**. It primarily involves a **refactoring** of content handling within the **MCPClient** and **MCPServer** components, transitioning from generic `Content` objects to more specific types such as `TextContentBlock`, `ImageContentBlock`, and `AudioContentBlock`. A new `ToKernelContent` extension method is introduced to convert `ContentBlock` objects, enhancing type safety and supporting a richer, more structured content hierarchy for multimedia messages. This ensures the samples correctly demonstrate the new capabilities and improved content model provided by the updated MCP dependency.

This commit **enables and relocates** the **API manifest kernel extensions tests** within the **.Net project**. The `ApiManifestKernelExtensionsTests` are moved from the unit test project to the integration test project, and their skip reason is removed to ensure they execute. This **test maintenance** also includes moving the `example-apimanifest-local.json` file to the integration test project and updating its internal API description URL path. The change significantly improves the **testing coverage and reliability** for the **API manifest integration** feature by validating its functionality within a broader system context.