Add specification for new sparse vector query; deprecate specification for text_expansion and weighted_tokens queries

output/openapi/elasticsearch-openapi.json

@@ -57225,6 +57225,9 @@
           "span_within": {
             "$ref": "#/components/schemas/_types.query_dsl:SpanWithinQuery"
           },
+          "sparse_vector": {
+            "$ref": "#/components/schemas/_types.query_dsl:SparseVectorQuery"
+          },
           "term": {
             "externalDocs": {
               "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-term-query.html"
@@ -57253,6 +57256,7 @@
             "maxProperties": 1
           },
           "text_expansion": {
+            "deprecated": true,
             "externalDocs": {
               "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-text-expansion-query.html"
             },
@@ -57265,6 +57269,7 @@
             "maxProperties": 1
           },
           "weighted_tokens": {
+            "deprecated": true,
             "description": "Supports returning text_expansion query results by sending in precomputed tokens with the query.",
             "type": "object",
             "additionalProperties": {
@@ -61163,6 +61168,73 @@
           }
         ]
       },
+      "_types.query_dsl:SparseVectorQuery": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/_types.query_dsl:QueryBase"
+          },
+          {
+            "allOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "$ref": "#/components/schemas/_types:Field"
+                  }
+                },
+                "required": [
+                  "field"
+                ]
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "query_vector": {
+                    "description": "Dictionary of precomputed sparse vectors and their associated weights.\nOnly one of inference_id or query_vector may be supplied in a request.",
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "number"
+                    }
+                  },
+                  "inference_id": {
+                    "$ref": "#/components/schemas/_types:Id"
+                  },
+                  "query": {
+                    "description": "The query text you want to use for search.\nIf inference_id is specified, query must also be specified.",
+                    "type": "string"
+                  },
+                  "prune": {
+                    "description": "Whether to perform pruning, omitting the non-significant tokens from the query to improve query performance.\nIf prune is true but the pruning_config is not specified, pruning will occur but default values will be used.\nDefault: false",
+                    "type": "boolean"
+                  },
+                  "pruning_config": {
+                    "$ref": "#/components/schemas/_types.query_dsl:TokenPruningConfig"
+                  }
+                },
+                "minProperties": 1,
+                "maxProperties": 1
+              }
+            ]
+          }
+        ]
+      },
+      "_types.query_dsl:TokenPruningConfig": {
+        "type": "object",
+        "properties": {
+          "tokens_freq_ratio_threshold": {
+            "description": "Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned.",
+            "type": "number"
+          },
+          "tokens_weight_threshold": {
+            "description": "Tokens whose weight is less than this threshold are considered nonsignificant and pruned.",
+            "type": "number"
+          },
+          "only_score_pruned_tokens": {
+            "description": "Whether to only score pruned tokens, vs only scoring kept tokens.",
+            "type": "boolean"
+          }
+        }
+      },
       "_types.query_dsl:TermQuery": {
         "allOf": [
           {
@@ -61250,23 +61322,6 @@
           }
         ]
       },
-      "_types.query_dsl:TokenPruningConfig": {
-        "type": "object",
-        "properties": {
-          "tokens_freq_ratio_threshold": {
-            "description": "Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned.",
-            "type": "number"
-          },
-          "tokens_weight_threshold": {
-            "description": "Tokens whose weight is less than this threshold are considered nonsignificant and pruned.",
-            "type": "number"
-          },
-          "only_score_pruned_tokens": {
-            "description": "Whether to only score pruned tokens, vs only scoring kept tokens.",
-            "type": "boolean"
-          }
-        }
-      },
       "_types.query_dsl:WeightedTokensQuery": {
         "allOf": [
           {