Jose Arriaga Maldonado

This commit **updates the documentation** for the **`running-tests` skill**, specifically within the `.github/skills/running-tests/SKILL.md` file. The primary change is to guide users towards **preferring exact `NUnit.Where` expressions** for specifying tests, rather than relying on regular expressions, which can be less precise. This **documentation improvement** provides clearer instructions and new examples, aiming to enhance the accuracy and efficiency of test execution for users of this skill.

This commit introduces a **new `running-tests` agent skill** that provides comprehensive guidance on how to run, debug, and validate tests, detailing different test modes (Playback, Record, Live) and the process for requesting new recordings. Concurrently, it **refactors several GitHub workflows** (`live-test.yml`, `main.yml`, `record-test.yml`, `release.yml`) to consistently use the more robust `-- NUnit.Where` option for test filtering, replacing the `--filter` option. Additionally, the `spec-ingestion` skill was **renamed to `ingesting-spec`** for consistency. This work **enhances the agent's knowledge base** regarding testing procedures and **standardizes test execution practices** across the project.

This commit introduces a **new GitHub Actions workflow**, `record-test.yml`, designed to **automate the process of generating and updating test recordings**. This **maintenance chore** allows developers to manually trigger a workflow on any branch, which will then record new tests, validate them, and automatically create a pull request with the updated session recordings targeting the original branch. This significantly streamlines the workflow for incorporating new test data, particularly for tests generated by tools like AI coding agents, by reducing manual effort in the **testing infrastructure** and **CI/CD pipeline**. The new capability enhances developer experience by simplifying the management of test fixtures.

This commit **significantly improves the performance of the `ExportApi` build process** by enabling parallel execution across multiple target frameworks. Previously, the build was sequential due to MSBuild's batching behavior when target framework properties were directly embedded in the `<MSBuild>` task's `Properties` attribute. The **build system optimization** involves refactoring the build logic to pass per-TFM properties via `AdditionalProperties` metadata on `_ExportApiProject` items, allowing a single, parallelizable `<MSBuild>` task invocation. This change, coupled with adding the `-m` flag to the `Export-Api.ps1` script, ensures that `BuildInParallel="true"` can now effectively dispatch builds concurrently, leading to **reduced build times** for `ExportApi`.

Update tar to version 7.5.10 (#1007)

Prepare 2.9.1 release (#996)

This commit prepares for the **2.9.0 release** by performing essential **test maintenance** and **refactoring** across several modules. It updates the **API compatibility script** (`scripts/Test-ApiCompatibility.ps1`) to use `Directory.Build.props` for version extraction, streamlining the build process. Additionally, it refactors assertions in **Assistants API tests**, updates expected transcription text in **Audio Transcription tests**, and adjusts client retrieval logic in **Files Uploads tests**. A general client discovery test is also updated to exclude `RealtimeSessionClient`, ensuring the overall stability and correctness of the test suite for the upcoming release.

This commit **refactors** the **Images API** by updating the `GeneratedImageQuality` enumeration to offer more precise options for image generation. It renames the internal `HD` value to `High` and introduces new members such as `LowQuality`, `MediumQuality`, and `HighQuality`. This change **avoids a behavioral breaking change** by ensuring the existing `High` option continues to map to "hd" quality, while `HighQuality` now explicitly maps to "high". The **API definitions** across various .NET targets and associated **tests** have been updated to reflect these new and renamed quality settings, enhancing the clarity and granularity of image quality selection for users.

This commit **updates outdated test recordings** across the project's **test suite**. This **maintenance task** was necessary to align the expected test outputs with recent changes in application behavior or external dependencies, ensuring tests accurately reflect the current system state. By re-recording these tests, the project prevents false failures in the continuous integration pipeline and maintains the **reliability and accuracy of automated testing**.

This commit **refactors** the **engineering system's API generation workflow** by replacing the standalone `GenAPI` tool with the `GenAPI MSBuild task`. This **streamlines API surface generation** by automatically resolving assembly dependencies, eliminating the need for manual maintenance in `scripts/Export-Api.ps1`. The change also simplifies tool acquisition, as the `MSBuild task` is now restored from a public NuGet feed, removing the requirement to manually build `GenAPI` locally. To support this, `nuget.config` is updated with the new package source for `Microsoft.DotNet.GenAPI.Task`, and the `api/OpenAI.*.cs` files are regenerated as part of this improved process.

This commit introduces **implicit conversion operators** for the `McpToolCallApprovalPolicy` union type, enabling seamless assignment from `CustomMcpToolCallApprovalPolicy` and `GlobalMcpToolCallApprovalPolicy` instances. This **enhancement** significantly improves the usability of **tool call approval policies** within the **OpenAI.NET library's API**, reducing the need for explicit casting in consumer code. The changes affect both the `.NET 8.0` and `.NET Standard 2.0` API definitions, ensuring consistent behavior across target frameworks. Furthermore, a null argument assertion was added to the `McpToolCallApprovalPolicy` constructor, bolstering the robustness and type safety of the policy handling mechanism.

This commit performs a **maintenance** update to the **API compatibility testing script** (`scripts/Test-ApiCompatibility.ps1`). As part of **release preparation** for version 2.8.0, the baseline API compatibility version is advanced from 2.6.0 to 2.7.0. This ensures that subsequent API compatibility checks correctly validate against the immediate prior stable release, preventing erroneous reports for changes introduced between 2.7.0 and 2.8.0.

This commit **restores and centralizes the `Model` parameter** within the **`ResponsesClient`**, making it a core property that can be configured at the client level. It introduces new convenience overloads for `CreateResponse` and `CreateResponseStreaming` methods, allowing the model to be inferred from the client instance, thereby simplifying API calls. Additionally, it **refactors** `ResponseTokenUsage`, `ResponseInputTokenUsageDetails`, and `ResponseOutputTokenUsageDetails` to be **protocol models** by making their properties settable and constructors public. This is a significant **API enhancement and refactoring** that streamlines model specification for `ResponsesClient` operations and improves the internal consistency of token usage reporting across the SDK.

This commit **refactors** the **API models** by adding public setters to critical properties within the `ResponseItem` hierarchy. Specifically, the `Id` property of the base `ResponseItem` class and the `Status` property of various derived response item classes (e.g., `CodeInterpreterCallResponseItem`, `MessageResponseItem`, `FunctionCallResponseItem`) now have public setters. This change enhances the flexibility of these models, allowing them to be more easily manipulated when used as both input and output objects. The update applies to both the `.net8.0` and `.netstandard2.0` API definitions, ensuring consistency and improving the overall usability of the **response item architecture**.

This commit performs a **refactoring** by **renaming the `include` parameter to `includedProperties`** within the **OpenAI API client's convenience methods**. This change specifically impacts various overloads of `GetResponse` and `GetResponseStreaming` (and their async versions) in the `OpenAIResponseClient` across both `.net8.0` and `.netstandard2.0` API definitions. The parameter rename enhances the **clarity and explicitness** of the API, making its purpose more evident to developers. Users consuming these methods will need to update their code to reflect the new `includedProperties` parameter name, improving overall API readability and consistency.

This commit **resolves a critical security vulnerability** by updating and overriding the `glob` dependency across the project. It **updates the `c8` package** to `^10.1.3` in `codegen/package.json` and introduces an `overrides` section in the root `package.json` to **force `glob` to version `^11.1.0`**. This **dependency update** specifically addresses a vulnerability in `test-exclude` that was pulling in an outdated `glob` version. The change significantly **improves the project's overall security posture** by ensuring all transitive dependencies utilize a secure version of the `glob` package.

Add new changelog entry draft after release (#836)

This commit **fixes a critical serialization bug** affecting the `partial_image_b64` property within **streaming image generation responses**. The **fix** involves updating the TypeSpec definition in `specification/client/responses.client.tsp` to correctly generate serialization names and directly correcting the `Write` method in `StreamingResponseImageGenerationCallPartialImageUpdate.Serialization.cs`. This ensures that **client applications can correctly deserialize** partial image data, improving the reliability of the **image generation feature**. Additionally, it includes minor **refactorings** to remove unused `using` directives and updates relevant **tests** to reflect the corrected serialization behavior.

This commit performs **pipeline maintenance** and **test infrastructure adjustments** to improve CI/CD reliability. It introduces a `dotnet tool restore` step in both the `.github/workflows/live-test.yml` and `.github/workflows/release.yml` workflows, ensuring the **test-proxy** is correctly initialized for pipeline runs. Concurrently, it **temporarily filters out problematic MPFD tests** from execution within the pipelines to prevent failures. Additionally, this work refines **test categorization** across various `Chat` and `Responses` test suites, such as `ChatStoreTests.cs` and `ResponsesToolTests.cs`, for better organization and selective test execution.

This commit performs essential **release preparation** tasks for the upcoming **2.6.0 release**. It updates the **API compatibility baseline** in `scripts/Test-ApiCompatibility.ps1` from version 2.4.0 to 2.5.0, ensuring that future API changes are correctly validated against the previous stable version. Concurrently, it refreshes the recorded session data for multiple **batch operation tests**, including `CanRehydrateBatchOperation` and `CreateGetAndCancelBatchProtocol`, by updating timestamps, IDs, and user agent information. This **maintenance** work ensures the integrity and validity of integration tests that rely on recorded network interactions, preventing failures due to outdated session data.