[Search 2026-08-01-preview] java SDK codegen

[Copilot]

Regenerates azure-search-documents for the new preview API version 2026-08-01-preview from Azure/azure-rest-api-specs@c19e358, and reconciles the customization/test/sample surface with the spec's breaking changes.

Generation

• Bumped tsp-location.yaml to spec commit c19e358 and regenerated via tsp-client update. The spec's tspconfig.yaml pins the Java emitter to stable 2026-04-01, so generation was run with --emitter-options "api-version=2026-08-01-preview" to produce the requested preview. SearchServiceVersion.getLatest() now returns V2026_08_01_PREVIEW.

Hand-written wrapper reconciliation

• The generated offset-pagination overload listIndexesWithSelectedProperties(select, top, skip, count) no longer exists. The GA backward-compat wrapper listIndexesWithSelectedProperties(List<String> select) (sync + async) now applies $select directly via RequestOptions instead of delegating to the removed overload.

API-surface changes reflected in tests/samples

• listIndexStatsSummary: (top, skip, count) → (search, pageSize, ListingSearchType)
• KnowledgeBaseRetrievalClient.retrieve: (options, String) → (options, querySourceAuthorization, queryWorkIQSourceAuthorization)
• WorkIQKnowledgeSource(name, WorkIQKnowledgeSourceParameters) (params type moved to ...documents.models)
• McpServerTool inclusion mode replaced by setResultsProcessing(KnowledgeSourceResultsProcessing)
• Removed tests for dropped offset-pagination semantics; removed McpServerToolInclusionMode / WorkIQAttribution
• Added File knowledge-source file management (multipart upload/update) and knowledge-source query-hint/boost models

Misc

• Added a checkstyle suppression for the newly generated MultipartFormDataHelper (EnforceFinalFieldsCheck).
• Documented features and breaking changes under 12.1.0-beta.2 in CHANGELOG.md.

Follow-ups for reviewers

• Test recordings (assets.json) are unchanged; playback for new/changed operations likely needs re-recording with live access.
• Confirm whether the emitter api-version override should instead be persisted upstream in the spec's tspconfig.yaml for reproducible regeneration.

[azure-pipelines]

Azure Pipelines:
35 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.