Jesse Squire

This commit **fixes** an issue within the **`Embeddings` subsystem** where **JSON escape sequences** (e.g., `\/`) embedded in base64 encoded strings were not correctly unescaped prior to decoding. Specifically, the `ConvertFromBase64` method in `src/Custom/Embeddings/OpenAIEmbedding.cs` was updated to ensure proper handling of these sequences. This **bug fix** prevents deserialization errors and ensures accurate processing of base64 encoded data for the **`Embeddings` feature**. New test cases were also added to `tests/Embeddings/EmbeddingsMockTests.cs` to validate the correct deserialization of strings containing escaped solidus characters.

[Eng] Propagage package version metadata (#997)

This commit introduces a **new capability** by adding **`file_url` support to the `ResponseContentPart`** within the API, allowing responses to include content that references files via URLs. It involves updating the **API client definitions** (`OpenAI.net10.0.cs`, `OpenAI.net8.0.cs`, `OpenAI.netstandard2.0.cs`) and the core `ResponseContentPart` to expose an `InputFileUri` property and a `CreateInputFilePart` method. The underlying **TypeSpec definition** (`models.tsp`) and **internal/generated models** (`InternalItemContentInputFile.cs`) were extended to properly define, serialize, and deserialize this new `FileUrl` property. This enhancement significantly improves the **response content handling**, providing a more direct and flexible way for the API to communicate file-based content, with new tests validating its functionality.

This commit delivers a major **documentation update** for `README.md`, primarily reflecting the **new Responses API** and other library changes to ensure examples are current. It **extracts code examples into verifiable snippets**, introducing a new test file `tests/Snippets/ReadMeSnippets.cs` for compile-time verification of these examples and updating `README.md` with necessary snippet tags. The `scripts/Update-Snippets.ps1` is also adjusted to correctly resolve paths for snippet updates, supporting this new documentation workflow. This work significantly improves the accuracy and maintainability of the project's primary documentation, alongside minor dependency version updates.

This commit introduces significant **engineering system improvements** by **centralizing package management** and common build properties, laying the groundwork for future multi-package support. It **refactors** the repository's solution structure by converting `OpenAI.slnx` and `codegen/generator/OpenAI.Library.Plugin.slnx` to the more readable and maintainable **.NET 10 `.slnx` format**. Additionally, a minor **refactoring** adjusts a type cast in the `Visit` method within `codegen/generator/src/Visitors/ContentInnerCollectionDefinedVisitor.cs`. These changes enhance the project's **build system infrastructure** and overall maintainability.

This commit performs a **major engineering system upgrade**, migrating the repository to **.NET 10**. The core change involves updating the **target framework and SDK version** to `10.0.100` in `global.json`, which is reflected across all **CI/CD workflows** (`.github/workflows/*.yml`) to provision and utilize the new **.NET 10 SDK**. This **maintenance** effort also includes a **test file update** in `tests/Responses/ResponsesTests.cs` to leverage `await foreach` for improved asynchronous iteration. The overall impact is to modernize the project's build and test infrastructure, ensuring compatibility and enabling development with the latest .NET platform.

This commit **updates the `System.ClientModel` dependency** to its latest stable release, specifically addressing issue #803. This **maintenance** task ensures the project's **client model infrastructure** remains current and benefits from the latest features, bug fixes, and performance enhancements provided by the `System.ClientModel` library. By adopting the newest version, the project maintains compatibility and leverages improvements in its underlying client communication framework.

This commit **updates the required .NET SDK version** for the entire project from `9.0.205` to `9.0.306`. This is a **maintenance update** to the `global.json` file, ensuring that all developers and CI/CD pipelines use the specified SDK version. This change primarily affects the **build environment** and **development toolchain**, aligning the project with the latest SDK release for improved stability and access to new features.

This commit **updates the project changelog** to incorporate acknowledgements for recent community contributors. This is a **documentation update** focused on recognizing valuable external contributions to the codebase. The change specifically affects the **project's release notes** or `CHANGELOG.md` file, enhancing community engagement and transparency. It ensures that contributors are properly credited, improving the overall **project documentation** and fostering a more inclusive development environment.

[Samples] Fix async polling delay technique (#692)

This commit introduces a **new tooling capability** for automated code snippet management within the project. It integrates the `Azure.Sdk.Tools.SnippetGenerator` dotnet tool by configuring it in `.config/dotnet-tools.json` and adding the Azure SDK development feed to `nuget.config`. A new PowerShell script, `scripts/Update-Snippets.ps1`, is also added to facilitate the automated updating of snippets using this generator. This **tooling enhancement** streamlines the maintenance of code examples and improves consistency across the project by providing a dedicated, automated workflow.

This commit **fixes** an outdated **C# code sample** within the `README.md` file, specifically addressing the example for **response streaming**. The update ensures the documentation accurately reflects the **current API usage** for this feature, preventing potential confusion or errors for developers attempting to implement response streaming. This is a crucial **documentation maintenance** task that improves the accuracy and reliability of the project's primary introductory guide.

This commit primarily **updates the `System.ClientModel` dependency to version 1.5.1** to **absorb a critical fix for a concurrency bug** that could cause infinite loops during deserialization, specifically impacting applications on the **legacy .NET Framework**. Concurrently, it **enhances the `OpenAIContext` module** by adding `ModelReaderWriterBuildable` attributes to various OpenAI types, improving model reader/writer buildable functionality. This **dependency update and feature enhancement** also includes updating the context with a new attribute, adding an explicit `AsyncInterfaces` reference, and removing the `net6` target. The changes ensure greater stability for deserialization processes and improve the buildable capabilities of OpenAI models.

This commit **improves the disposal logic** within the **Realtime communication subsystem's** `AsyncWebsocketMessageEnumerator` component. It specifically **fixes a potential bug** by preventing multiple disposals of resources, ensuring more robust and thread-safe cleanup. The `DisposeAsync` method in `src/Custom/Realtime/Internal/AsyncWebsocketMessageEnumerator.cs` now utilizes `Interlocked.Exchange` for **thread-safe disposal of the receive buffer** and removes redundant direct WebSocket disposal. This **maintenance improvement** enhances the stability and reliability of asynchronous websocket message handling by preventing race conditions during resource release.

This commit **updates the GitHub release workflow** to ensure that release notes consistently point to the project's changelog. It **modifies the `.github/workflows/release.yml` file** to explicitly configure the GitHub release page to reference the official changelog, rather than generating default content. This **workflow improvement** standardizes the release information, providing a single source of truth for all changes and enhancing the clarity for users reviewing new releases.

This commit performs a **maintenance upgrade** by updating the **.NET SDK version** used across the repository from 8.x to **9.x**. Specifically, the `global.json` file is updated to require SDK version `9.0.205`, ensuring all projects within the repository build against this newer target. Concurrently, all **CI/CD workflows** including `live-test.yml`, `main.yml`, and `release.yml` are modified to set up and utilize .NET 9.x. This change ensures that all automated builds, tests, and releases leverage the latest platform features, performance improvements, and security updates provided by the updated SDK.

This commit introduces a **new GitHub Actions workflow** (`.github/workflows/needs-triage.yml`) to **automate issue management** within the repository. This **new capability** automatically applies the `needs-triage` label to newly opened issues, streamlining the initial review process. The automation intelligently skips issues created by collaborators with write permissions or those that already have existing labels, preventing redundant labeling. This enhancement significantly improves **issue triaging efficiency** by ensuring all new, unclassified issues are clearly marked for review, thereby optimizing the development workflow.

This commit **enhances the project's GitHub issue management system** by **updating issue templates and configuration**. A **new template for questions** (`01_question.yaml`) has been introduced to streamline support inquiries. Existing **bug report** (`02_bug_report.yaml`) and **feature request** (`03_feature_request.yaml`) templates were **refactored** to improve clarity and remove outdated fields like `service-kind` and `non_api` checkboxes. Additionally, the **issue template configuration** (`config.yml`) was updated to **enable blank issues**, providing more flexibility for contributors. This **maintenance and enhancement work** ultimately **improves the user experience for issue submission** and helps maintain a cleaner issue tracker.