Skip to content

[Search] SDK Updates - #47117

Merged
efrainretana merged 12 commits into
search/dp-2026-10-01from
efrainretana/search/dp-2026-10-01
Oct 15, 2026
Merged

efrainretana merged 12 commits into
search/dp-2026-10-01from
efrainretana/search/dp-2026-10-01

Conversation

@efrainretana

Copy link
Copy Markdown
Member

Update DP Spec with changes for SDK

efrainretana and others added 6 commits October 6, 2026 00:16
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Preserve existing SSE event payloads using data envelopes and enable union-extends.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Next Steps to Merge

Important checks have failed. As of today they are not blocking this PR, but in near future they may.
Addressing the following failures is highly recommended:
  • ⚠️ The check named Swagger BreakingChange has failed. To unblock this PR, follow the process at aka.ms/brch.
If you still want to proceed merging this PR without addressing the above failures, refer to step 4 in the PR workflow diagram.

Comment generated by summarize-checks workflow run.

@github-actions github-actions Bot added data-plane TypeSpec Authored with TypeSpec labels Oct 8, 2026
@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

API Change Check

APIView identified API level changes in this PR and created the following API reviews

Language API Review for Package
Python azure-search-documents
Java com.azure:azure-search-documents

Comment generated by After APIView workflow run.

efrainretana and others added 4 commits October 13, 2026 17:45
…1' into efrainretana/search/dp-2026-10-01

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@efrainretana
efrainretana merged commit ec0736c into search/dp-2026-10-01 Oct 15, 2026
54 of 58 checks passed
@efrainretana
efrainretana deleted the efrainretana/search/dp-2026-10-01 branch October 15, 2026 22:02
Yangyang Lu (yangylu91) added a commit that referenced this pull request Oct 16, 2026
* Sync Search DP 2026-10-01 tsp changes from ADO

* Apply versions to namespace in client.tsp

* Apply versions to namespace client  in client.tsp

* Sync tsp from ADO to GH

* Reference 2026-10-01 Search swagger in readme

Co-authored-by: yangylu91 <53235012+yangylu91@users.noreply.github.com>

* Sync tsp from ADO to GH

* Sync tsp from ADO to GH

* Refresh changlog for 2026-10-01

* Remove duplicate @removed(Versions.v2026_10_01) lines

* Remove redundant @removed(Versions.v2026_10_01) on LegacyIndexes list params

The \list\ and \listWithSelectedProperties\ operations are already
fully removed at v2026_08_01_preview, so the same decorator on their
\\\/\\\/\\\ parameters is dead weight. Found by the
local Data-Plane API Reviewer agent; verified no-op via tsp compile
(no swagger diff).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Revert unrelated targetIndexName example tweak in 2026-08-01-preview

This SearchServiceCreateOrUpdateIndexer.json change is a cosmetic
example rename unrelated to the GA (2026-10-01) work; removing it
keeps this PR scoped to GA-only changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Reorder shared Operation alias params (TParams last) to stop perpetual false breaking-change flags on param position

* Search DP 2026-10-01 GA: Late spec changes (#46824)

* Add SearchField.organizationAccessExpiration for SharePoint Org-wide Link

* Promote runtime and indexersRuntime to GA as optional properties

* Update example files for runtime/indexersRuntime

* Update client.tsp with namespace for KS and list

* Add Page Size to listingPaginationQuery (#47041)

* [Late Fix] Promote GPT-5.4+ knowledge retrieval models to 2026-10-01 GA

* Fix accidental-GA TypeSpec leaks from 2026-04-01 (#47169)

Port of AzureSearch ADO PR 2343313: removes/version-gates several
preview-only API elements that had accidentally leaked into GA swagger
for the 2026-04-01 (shipped) and/or 2026-10-01 (unshipped) API versions.

- KnowledgeBaseAgenticReasoningActivityRecord.retrievalReasoningEffort:
  removed from both 2026-04-01 and 2026-10-01 (never legitimate on this record)
- KnowledgeRetrievalReasoningEffort / KnowledgeRetrievalMinimalReasoningEffort:
  gated out of 2026-04-01 only; remain legit GA in 2026-10-01
- maxCumulativeIndexerRuntimeSeconds: removed from 2026-04-01 only;
  remains legit GA in 2026-10-01
- VectorFilterMode.strictPostFilter: removed from both versions
- VectorizableImageUrlQuery / VectorizableImageBinaryQuery (and their
  VectorQueryKind enum members): removed from both versions, gated at
  model level
- AMLVectorizer / AMLParameters: removed from both versions, gated at
  model level

Cleaned up 2026-04-01 example JSON files referencing removed fields
and regenerated stable/2026-04-01 and stable/2026-10-01 search.json via
tsp compile.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update example file: KnowledgeBaseRetrieve.json

* [Search] SDK Updates (#47117)

* Add Page Size to listingPaginationQuery

* Expose pagination gen

* csharp pagination

* Fix C# Search pagination naming precedence and access scopes

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Model Search retrieval SSE events with a common union base

Preserve existing SSE event payloads using data envelopes and enable union-extends.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Expose generated Search SSE event models for C#

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update namespaces

* cleanup

* fix CI

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove stale and preview-only examples

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: efrainretana <141282336+efrainretana@users.noreply.github.com>
Yangyang Lu (yangylu91) added a commit that referenced this pull request Nov 5, 2026
* Sync Search DP 2026-10-01 tsp changes from ADO

* Apply versions to namespace in client.tsp

* Apply versions to namespace client  in client.tsp

* Sync tsp from ADO to GH

* Reference 2026-10-01 Search swagger in readme

Co-authored-by: yangylu91 <53235012+yangylu91@users.noreply.github.com>

* Sync tsp from ADO to GH

* Sync tsp from ADO to GH

* Refresh changlog for 2026-10-01

* Remove duplicate @removed(Versions.v2026_10_01) lines

* Remove redundant @removed(Versions.v2026_10_01) on LegacyIndexes list params

The \list\ and \listWithSelectedProperties\ operations are already
fully removed at v2026_08_01_preview, so the same decorator on their
\\\/\\\/\\\ parameters is dead weight. Found by the
local Data-Plane API Reviewer agent; verified no-op via tsp compile
(no swagger diff).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Revert unrelated targetIndexName example tweak in 2026-08-01-preview

This SearchServiceCreateOrUpdateIndexer.json change is a cosmetic
example rename unrelated to the GA (2026-10-01) work; removing it
keeps this PR scoped to GA-only changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Reorder shared Operation alias params (TParams last) to stop perpetual false breaking-change flags on param position

* Search DP 2026-10-01 GA: Late spec changes (#46824)

* Add SearchField.organizationAccessExpiration for SharePoint Org-wide Link

* Promote runtime and indexersRuntime to GA as optional properties

* Update example files for runtime/indexersRuntime

* Update client.tsp with namespace for KS and list

* Add Page Size to listingPaginationQuery (#47041)

* [Late Fix] Promote GPT-5.4+ knowledge retrieval models to 2026-10-01 GA

* Fix accidental-GA TypeSpec leaks from 2026-04-01 (#47169)

Port of AzureSearch ADO PR 2343313: removes/version-gates several
preview-only API elements that had accidentally leaked into GA swagger
for the 2026-04-01 (shipped) and/or 2026-10-01 (unshipped) API versions.

- KnowledgeBaseAgenticReasoningActivityRecord.retrievalReasoningEffort:
  removed from both 2026-04-01 and 2026-10-01 (never legitimate on this record)
- KnowledgeRetrievalReasoningEffort / KnowledgeRetrievalMinimalReasoningEffort:
  gated out of 2026-04-01 only; remain legit GA in 2026-10-01
- maxCumulativeIndexerRuntimeSeconds: removed from 2026-04-01 only;
  remains legit GA in 2026-10-01
- VectorFilterMode.strictPostFilter: removed from both versions
- VectorizableImageUrlQuery / VectorizableImageBinaryQuery (and their
  VectorQueryKind enum members): removed from both versions, gated at
  model level
- AMLVectorizer / AMLParameters: removed from both versions, gated at
  model level

Cleaned up 2026-04-01 example JSON files referencing removed fields
and regenerated stable/2026-04-01 and stable/2026-10-01 search.json via
tsp compile.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update example file: KnowledgeBaseRetrieve.json

* Azure Search DP 2026-11-01-preview changes on top of 2026-10-01

* Fix tspconfig.yaml for tsp compiler 1.17.0

* Fix cspell error and examples

* Fix readme

* [Search] SDK Updates (#47117)

* Add Page Size to listingPaginationQuery

* Expose pagination gen

* csharp pagination

* Fix C# Search pagination naming precedence and access scopes

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Model Search retrieval SSE events with a common union base

Preserve existing SSE event payloads using data envelopes and enable union-extends.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Expose generated Search SSE event models for C#

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update namespaces

* cleanup

* fix CI

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Sync Azure Search data-plane spec from AzureSearch (tsp-sync/2026-11-01-preview@935d68cc938)

* Remove stale and preview-only examples

* Remove stale examples

* Fix nit; update swagger

* remove stale example

* Remove example updates of old version to keep this PR clean

* Fix SpellCheck in description

* Fix Swagger lint by naming graph provenance document schema without changing wire format

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Mark knowledge source cache connection string as secret and write-only

Sync AzureSearch merge commit 38d19b5f (PR 2367055). Keep create/update request support, remove the connection string from response examples, and regenerate November preview OpenAPI and example copies.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Mark query source authorization header as secret

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Keep GA multipart upload primary in generated Swagger

Reorder shared upload declarations without changing either operation contract; preserve preview binary upload as an x-ms-paths overload.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Refine GraphQueryDiagnostic properties with enum types; Set default kind of GraphGrounding; Update examples; Fix missing models in client.tsp

* Refine topic graph vector search and add filter-hint auto-configuration

- Add none, diverse, and balanced query variants, profile defaults, and candidate-pool settings.
- Share VectorSearchTopicGraphKind across index profiles and per-query options while preserving distinct model names.
- Add facet-based filter-hint auto-configuration with cache TTL and facet-count limits
- Update client.tsp, examples and swagger

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove duplicate namespace mappings in client.tsp

* Fix *VectorQueryTopicGraph models

* Refresh examples

* Only update description for minDiversityPoolSize and defaultMinDiversityPoolSize

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: efrainretana <141282336+efrainretana@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

data-plane Search TypeSpec Authored with TypeSpec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants