Updated ES specification to support simplified retrievers

[mridula-s109]

This PR introduces the following optional fields to specification/_types/Retriever.ts:

• LinearRetriever:
  • query?: string: A query string for a text-based search.
  • fields?: string[]: The fields to run the query against.
  • normalizer?: ScoreNormalizer: The normalizer to use for scoring.
• RRFRetriever:
  • query?: string: A query string for a text-based search.
  • fields?: string[]: The fields to run the query against.

These additions allow users to specify a simple query string directly within the retriever, aligning it with recent changes made in the Kibana Dev Console (SEARCH-1091).

Validation

The specification was validated against the search API using make validate api=search branch=main.

[Copilot]

Pull Request Overview

This PR adds optional query parameters to the ES specification retrievers, enabling simplified text-based searches directly in the retriever definitions.

• Introduces query, fields, and normalizer to LinearRetriever
• Introduces query and fields to RRFRetriever
• Aligns the specification with recent Kibana Dev Console changes for simplified retrievers

Comments suppressed due to low confidence (6)

specification/_types/Retriever.ts:72

• Add a JSDoc comment for query to explain its purpose, e.g.: /** A query string for a text-based search. */

  query?: string

specification/_types/Retriever.ts:73

• Add a JSDoc comment for fields to describe which document fields are searched, e.g.: /** The fields to run the query against. */

  fields?: string[]

specification/_types/Retriever.ts:74

• Add a JSDoc comment for normalizer, e.g.: /** The normalizer to use for scoring. */, and verify that ScoreNormalizer is imported or defined above.

  normalizer?: ScoreNormalizer

specification/_types/Retriever.ts:142

• Add a JSDoc comment for query in RRFRetriever, e.g.: /** A query string for a text-based search. */

  query?: string

specification/_types/Retriever.ts:143

• Add a JSDoc comment for fields in RRFRetriever, e.g.: /** The fields to run the query against. */

  fields?: string[]

specification/_types/Retriever.ts:72

• No tests appear to cover the new query, fields, and normalizer properties; please add validation tests to ensure they are correctly serialized and validated in the API schema.

  query?: string

[github-actions]

Following you can find the validation changes against the target branch for the APIs.

No changes detected.

You can validate these APIs yourself by using the make validate target.

[Mikep86]

LGTM!