Changed OpenApi spec for reflecting recent hybrid search

CHANGELOG.md

@@ -45,7 +45,7 @@ This section is for maintaining a changelog for all breaking changes for the cli
 ## [Unreleased 2.x]
 ### Added
 - Added `normalizer` to wildcard field ([#1489](https://github.com/opensearch-project/opensearch-java/pull/1489))
-
+- Added `paginationDepth` to `HybridQuery` ([#1490](https://github.com/opensearch-project/opensearch-java/pull/1490))
 ### Dependencies
 
 ### Changed

java-client/src/generated/java/org/opensearch/client/opensearch/_types/query_dsl/HybridQuery.java

@@ -59,13 +59,17 @@
 @Generated("org.opensearch.client.codegen.CodeGenerator")
 public class HybridQuery extends QueryBase implements QueryVariant, ToCopyableBuilder<HybridQuery.Builder, HybridQuery> {
 
+    @Nullable
+    private final Number paginationDepth;
+
     @Nonnull
     private final List<Query> queries;
 
     // ---------------------------------------------------------------------------------------------
 
     private HybridQuery(Builder builder) {
         super(builder);
+        this.paginationDepth = builder.paginationDepth;
         this.queries = ApiTypeHelper.unmodifiable(builder.queries);
     }
 
@@ -81,6 +85,14 @@ public Query.Kind _queryKind() {
         return Query.Kind.Hybrid;
     }
 
+    /**
+     * API name: {@code pagination_depth}
+     */
+    @Nullable
+    public final Number paginationDepth() {
+        return this.paginationDepth;
+    }
+
     /**
      * API name: {@code queries}
      */
@@ -91,6 +103,11 @@ public final List<Query> queries() {
 
     protected void serializeInternal(JsonGenerator generator, JsonpMapper mapper) {
         super.serializeInternal(generator, mapper);
+        if (this.paginationDepth != null) {
+            generator.writeKey("pagination_depth");
+            generator.write(this.paginationDepth.doubleValue());
+        }
+
         if (ApiTypeHelper.isDefined(this.queries)) {
             generator.writeKey("queries");
             generator.writeStartArray();
@@ -118,18 +135,22 @@ public static Builder builder() {
      * Builder for {@link HybridQuery}.
      */
     public static class Builder extends QueryBase.AbstractBuilder<Builder> implements CopyableBuilder<Builder, HybridQuery> {
+        @Nullable
+        private Number paginationDepth;
         @Nullable
         private List<Query> queries;
 
         public Builder() {}
 
         private Builder(HybridQuery o) {
             super(o);
+            this.paginationDepth = o.paginationDepth;
             this.queries = _listCopy(o.queries);
         }
 
         private Builder(Builder o) {
             super(o);
+            this.paginationDepth = o.paginationDepth;
             this.queries = _listCopy(o.queries);
         }
 
@@ -145,6 +166,15 @@ protected Builder self() {
             return this;
         }
 
+        /**
+         * API name: {@code pagination_depth}
+         */
+        @Nonnull
+        public final Builder paginationDepth(@Nullable Number value) {
+            this.paginationDepth = value;
+            return this;
+        }
+
         /**
          * API name: {@code queries}
          *
@@ -209,12 +239,14 @@ public HybridQuery build() {
 
     protected static void setupHybridQueryDeserializer(ObjectDeserializer<HybridQuery.Builder> op) {
         setupQueryBaseDeserializer(op);
+        op.add(Builder::paginationDepth, JsonpDeserializer.numberDeserializer(), "pagination_depth");
         op.add(Builder::queries, JsonpDeserializer.arrayDeserializer(Query._DESERIALIZER), "queries");
     }
 
     @Override
     public int hashCode() {
         int result = super.hashCode();
+        result = 31 * result + Objects.hashCode(this.paginationDepth);
         result = 31 * result + Objects.hashCode(this.queries);
         return result;
     }
@@ -227,6 +259,6 @@ public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || this.getClass() != o.getClass()) return false;
         HybridQuery other = (HybridQuery) o;
-        return Objects.equals(this.queries, other.queries);
+        return Objects.equals(this.paginationDepth, other.paginationDepth) && Objects.equals(this.queries, other.queries);
     }
 }

java-client/src/test/java/org/opensearch/client/opensearch/_types/query_dsl/HybridQueryTest.java

@@ -27,7 +27,7 @@ public void toBuilder() {
                     .toQuery(),
                 new KnnQuery.Builder().field("passage_embedding").vector(0.01f, 0.02f).k(2).build().toQuery()
             )
-        ).build();
+        ).paginationDepth(100).build();
         HybridQuery copied = origin.toBuilder().build();
 
         assertEquals(toJson(copied), toJson(origin));

java-codegen/opensearch-openapi.yaml

@@ -44296,6 +44296,8 @@ components:
               type: array
               items:
                 $ref: '#/components/schemas/_common.query_dsl___QueryContainer'
+            pagination_depth:
+              type: number
     _common.query_dsl___IdsQuery:
       allOf:
         - $ref: '#/components/schemas/_common.query_dsl___QueryBase'